Beer Can Labs
Staff / Secretary
Operations

Secretary

Keeper of the Notebook

Moves an agent’s notebook between object storage and the folder the agent works in. When an agent wakes the Secretary brings the files in; when it sleeps the Secretary puts them back. The agent only ever sees a local folder.

Design rules
The Safe (§6.6)
Contracts offered
1
Key flows
2

On the job

  • Pulls the agent’s prefix from object storage into $MEMORY_DIR on wake
  • Pushes $MEMORY_DIR back on sleep
  • Builds the platform environment the agent starts with, including the egress base URLs

Not my job

  • Decide what is worth remembering. That is the cartridge’s notebook.
  • Decide what a notebook contains or how it is organized. That is the cartridge’s.
Key product flows

What Secretary does, step by step

Flow

Bring the notebook in (wake)

Runs inside the agent’s container as part of the shim.

  1. The Landlord starts the container with the agent’s memory prefix and its mind store.

    Works with Landlord· contractpullMind / pushMind →The prefix is fixed at deploy.

  2. pullMind copies the prefix from the mind store to $MEMORY_DIR.

  3. platformEnv and the egress environment are set, so the agent finds its base URLs and never a cloud key.

  4. The agent starts and sees ordinary files.

Flow

Send the notebook out (sleep)

Runs when the turn ends or the container is told to stop.

  1. The agent finishes its turn.

  2. pushMind copies $MEMORY_DIR back to the same prefix in the mind store.

  3. The Landlord scales the agent to zero.

    Works with Landlord· contractpullMind / pushMind →

Contracts Secretary keeps 1 offered