agent-office 0.3.1 → 0.4.0

package/README.md

@@ -1,20 +1,20 @@
 # agent-office
 
-An office for your AI agents. Manage multiple [OpenCode](https://opencode.ai) coding sessions as named coworkers with inter-agent messaging, scheduled tasks, persistent memory, and a terminal UI for human oversight.
+An office for your AI agents. Manage multiple [OpenCode](https://opencode.ai) coding sessions as named coworkers with inter-agent messaging, scheduled tasks, and a terminal UI for human oversight.
 
 ## Overview
 
-`agent-office` sits between a human operator and one or more AI coding agents running on an OpenCode server. It wraps raw OpenCode sessions with named identities, a messaging system, cron-based scheduling, and per-agent memory -- creating an "office" where AI agents are coworkers that communicate, take direction, and operate autonomously.
+`agent-office` sits between a human operator and one or more AI coding agents running on an OpenCode server. It wraps raw OpenCode sessions with named identities, a messaging system, and cron-based scheduling -- creating an "office" where AI agents are coworkers that communicate, take direction, and operate autonomously.
 
 **For humans**, there are three interfaces:
 
-- **`serve`** -- an HTTP server that manages sessions, messages, cron jobs, and memory, backed by PostgreSQL and a running OpenCode server
+- **`serve`** -- an HTTP server that manages sessions, messages, and cron jobs, backed by PostgreSQL and a running OpenCode server
 - **`manage`** -- a full-screen terminal UI (React Ink) for creating coworkers, sending messages, browsing mail, managing cron jobs, and observing agent activity
 - **`communicator web`** -- a browser-based chat interface for conversing with a specific agent in real time
 
 **For AI agents**, there is a CLI:
 
-- **`worker`** -- subcommands that agents invoke from within their OpenCode sessions to clock in, message coworkers, set status, manage cron jobs, and store memories
+- **`worker`** -- subcommands that agents invoke from within their OpenCode sessions to clock in, message coworkers, set status, and manage cron jobs
 
 ```
                     +---------------------+
@@ -27,10 +27,10 @@ An office for your AI agents. Manage multiple [OpenCode](https://opencode.ai) co
 |  Ink/React   |    |      :7654           |    |              |
 +--------------+    |                      |    +--------------+
                     |   CronScheduler      |
-+--------------+    |   MemoryManager      |    +--------------+
-| Communicator |<-->|                      |<-->|  .memory/    |
-| Web (HTMX)   |    |                      |    |  SQLite DBs  |
-| :7655        |    +---------+-----------+    +--------------+
++--------------+    |                      |
+| Communicator |<-->|                      |
+| Web (HTMX)   |    |                      |
+| :7655        |    +---------+-----------+
 +--------------+              |
                               | /worker/* endpoints
                     +---------+-----------+
@@ -69,7 +69,7 @@ agent-office serve \
   --password mysecret
 ```
 
-The server runs migrations automatically on startup, initializes the cron scheduler, and warms up the embedding model for agent memory.
+The server runs migrations automatically on startup and initializes the cron scheduler.
 
 ### 2. Open the manager
 
@@ -84,7 +84,7 @@ From the TUI you can create coworkers, send them messages, browse mail, manage c
 ### 3. Chat with a coworker in the browser
 
 ```bash
-agent-office communicator web "Alice" --secret mysecret
+agent-office communicator web "Alice" --password mysecret
 ```
 
 Opens a web-based chat interface at `http://127.0.0.1:7655` for real-time conversation with the named coworker.
@@ -97,11 +97,11 @@ Opens a web-based chat interface at `http://127.0.0.1:7655` for real-time conver
 
 2. **Clock In** -- The AI agent sees the enrollment message in its session, runs `agent-office worker clock-in <token>`, and receives a welcome briefing with its name, the human manager's identity, all available CLI commands, and a privacy notice.
 
-3. **Work** -- The agent operates in its OpenCode session. It communicates with the human and other agents by running `agent-office worker send-message`. It can set its status, create cron jobs, and store persistent memories.
+3. **Work** - - The agent operates in its OpenCode session. It communicates with the human and other agents by running `agent-office worker send-message`. It can set its status and create cron jobs.
 
 4. **Message Delivery** -- Messages are stored in PostgreSQL and simultaneously injected as prompts into the recipient's OpenCode session. This means agents see messages immediately in their active session context.
 
-5. **Reset** -- A session can be reverted to its initial state (clearing all conversation history) and re-enrolled. Memories persist across resets since they are stored separately.
+5. **Reset** - - A session can be reverted to its initial state (clearing all conversation history) and re-enrolled.
 
 6. **Delete** -- Deleting a coworker removes both the OpenCode session and the database record.
 
@@ -139,7 +139,7 @@ cp .env.example .env
 
 ### `agent-office serve`
 
-Starts the HTTP server. Connects to PostgreSQL, runs migrations, initializes the cron scheduler, and warms up the embedding model.
+Starts the HTTP server. Connects to PostgreSQL, runs migrations, and initializes the cron scheduler.
 
 ```
 Options:
@@ -147,7 +147,6 @@ Options:
   --opencode-url <url>     OpenCode server URL (default: http://localhost:4096)
   --host <host>            Bind host (default: 127.0.0.1)
   --port <port>            Bind port (default: 7654)
-  --memory-path <path>     Directory for memory storage (default: ./.memory)
   --password <password>    REQUIRED. API password (env: AGENT_OFFICE_PASSWORD)
 ```
 
@@ -165,7 +164,7 @@ Options:
 
 | Screen | Description |
 |---|---|
-| **Coworkers** | Table of all agents showing name, status, mode, session ID, and masked agent code. Keyboard: `c` create, `d` delete, `r` reveal code, `g` regenerate code, `x` revert session, `X` revert all, `t` tail messages, `i` inject text, `m` coworker mail, `M` memories |
+| **Coworkers** | Table of all agents showing name, status, mode, session ID, and masked agent code. Keyboard: `c` create, `d` delete, `r` reveal code, `g` regenerate code, `x` revert session, `X` revert all, `t` tail messages, `i` inject text, `m` coworker mail |
 | **Send message** | Select a recipient and compose a message |
 | **My mail** | View received and sent messages. `r` reply, `m` mark read, `a` mark all read. Tab between received/sent |
 | **Cron jobs** | Table of scheduled tasks with name, coworker, schedule, next run, and status. Create, delete, enable/disable, view history |
@@ -183,7 +182,7 @@ Arguments:
 
 Options:
   --url <url>              Server URL (default: http://127.0.0.1:7654)
-  --secret <secret>        API password (env: AGENT_OFFICE_PASSWORD)
+  --password <password>    API password (env: AGENT_OFFICE_PASSWORD)
   --host <host>            Communicator bind host (default: 127.0.0.1)
   --port <port>            Communicator bind port (default: 7655)
 ```
@@ -217,11 +216,6 @@ agent-office worker cron enable <token> <id>
 agent-office worker cron disable <token> <id>
 agent-office worker cron history <token> <id>
 
-# Persistent memory (survives session resets)
-agent-office worker memory add --content "The auth module uses JWT with RS256" <token>
-agent-office worker memory search --query "authentication" <token>
-agent-office worker memory list <token>
-agent-office worker memory forget <token> <memory-id>
 ```
 
 ## REST API
@@ -251,12 +245,7 @@ agent-office worker memory forget <token> <memory-id>
 | `POST` | `/crons/:id/enable` | Enable a cron job |
 | `POST` | `/crons/:id/disable` | Disable a cron job |
 | `GET` | `/crons/:id/history` | Cron execution history. Query: `?limit=N` |
-| `GET` | `/sessions/:name/memories` | List memories. Query: `?limit=N` |
-| `POST` | `/sessions/:name/memories` | Add a memory. Body: `{ content, metadata? }` |
-| `GET` | `/sessions/:name/memories/:id` | Get a memory |
-| `PUT` | `/sessions/:name/memories/:id` | Update a memory. Body: `{ content, metadata? }` |
-| `DELETE` | `/sessions/:name/memories/:id` | Delete a memory |
-| `POST` | `/sessions/:name/memories/search` | Search memories. Body: `{ query, limit? }` |
+
 
 ### Worker Endpoints (agent code auth via `?code=<uuid>`)
 
@@ -272,10 +261,7 @@ agent-office worker memory forget <token> <memory-id>
 | `POST` | `/worker/crons/:id/enable` | Enable own cron job |
 | `POST` | `/worker/crons/:id/disable` | Disable own cron job |
 | `GET` | `/worker/crons/:id/history` | View own cron job history |
-| `POST` | `/worker/memory/add` | Add a memory |
-| `POST` | `/worker/memory/search` | Search memories |
-| `GET` | `/worker/memory/list` | List memories |
-| `DELETE` | `/worker/memory/:memoryId` | Delete a memory |
+
 
 ## Architecture
 
@@ -289,14 +275,6 @@ The server uses PostgreSQL with automatic migrations. Tables:
 - **`cron_jobs`** -- Scheduled tasks tied to sessions with cron expressions and timezone support
 - **`cron_history`** -- Execution log for cron jobs with success/failure tracking
 
-### Memory System
-
-Each agent gets a private SQLite database (via [fastmemory](https://github.com/nichochar/fastmemory)) stored in the `--memory-path` directory. Memories support:
-
-- **Hybrid search** -- BM25 full-text search combined with vector semantic search using Reciprocal Rank Fusion
-- **Persistence across resets** -- Memories are stored outside the OpenCode session, so they survive session reverts
-- **Quantized embeddings** -- Uses `q4` dtype for efficient storage
-
 ### Agentic Coding Server Abstraction
 
 The application does not depend on the OpenCode SDK directly. Instead, all OpenCode interactions go through an `AgenticCodingServer` interface (`src/lib/agentic-coding-server.ts`) with six methods:
@@ -330,7 +308,7 @@ npm run dev:serve -- --password secret
 npm run dev:manage -- --password secret
 
 # Run communicator (in another terminal)
-npm run dev:communicator -- "Alice" --secret secret
+npm run dev:communicator -- "Alice" --password secret
 
 # Build
 npm run build

package/dist/cli.js

@@ -13,10 +13,8 @@ program
     .option("--sqlite <path>", "SQLite database file path (alternative to PostgreSQL)", process.env.AGENT_OFFICE_SQLITE)
     .option("--host <host>", "Host to bind to", "127.0.0.1")
     .option("--port <port>", "Port to serve on", "7654")
-    .option("--memory-path <path>", "Directory for memory storage (default: ./.memory)", "./.memory")
     .option("--password <password>", "REQUIRED. API password", process.env.AGENT_OFFICE_PASSWORD)
     .option("--opencode-url <url>", "URL of the OpenCode server (default: http://127.0.0.1:4096)", process.env.OPENCODE_URL ?? "http://127.0.0.1:4096")
-    .option("--simple-memory", "Use lightweight SQLite+BM25 memory instead of the default fastmemory (no embeddings, no model download)")
     .action(async (options) => {
     const { serve } = await import("./commands/serve.js");
     await serve(options);
@@ -34,36 +32,39 @@ const appCmd = program
     .command("app")
     .description("[HUMAN ONLY] Interactive visual applications");
 appCmd
-    .command("coworker-chat-web")
-    .description("[HUMAN ONLY] Launch a web chat interface for a single coworker")
-    .argument("<coworker>", "Name of the coworker to chat with (e.g. 'Howard Roark')")
+    .command("chat")
+    .description("Web chat interface for human to chat to coworkers")
     .option("--url <url>", "URL of the agent-office serve endpoint (e.g. http://127.0.0.1:7654)", process.env.AGENT_OFFICE_URL ?? "http://127.0.0.1:7654")
-    .option("--secret <secret>", "API password for the agent-office server", process.env.AGENT_OFFICE_PASSWORD)
+    .option("--password <password>", "API password for the agent-office server", process.env.AGENT_OFFICE_PASSWORD ?? "secret")
     .option("--host <host>", "Host to bind the web server to", "127.0.0.1")
     .option("--port <port>", "Port to run the web server on", "7655")
-    .action(async (coworker, options) => {
-    if (!options.secret) {
-        console.error("Error: --secret is required (or set AGENT_OFFICE_PASSWORD)");
-        process.exit(1);
-    }
+    .action(async (options) => {
     const { appCoworkerChatWeb } = await import("./commands/communicator.js");
-    await appCoworkerChatWeb(coworker, options);
+    await appCoworkerChatWeb(options);
 });
-appCmd
-    .command("screensaver")
-    .description("[HUMAN ONLY] Launch a visualization of recent mail activity (live screensaver)")
+appCmd.command("screensaver")
+    .description("3D visualization of recent mail activity")
     .option("--url <url>", "URL of the agent-office serve endpoint (e.g. http://127.0.0.1:7654)", process.env.AGENT_OFFICE_URL ?? "http://127.0.0.1:7654")
-    .option("--secret <secret>", "API password for the agent-office server", process.env.AGENT_OFFICE_PASSWORD)
+    .option("--password <password>", "API password for the agent-office server", process.env.AGENT_OFFICE_PASSWORD ?? "secret")
     .option("--host <host>", "Host to bind the screensaver web server to", "127.0.0.1")
     .option("--port <port>", "Port to run the screensaver web server on", "7656")
     .action(async (options) => {
-    if (!options.secret) {
-        console.error("Error: --secret is required (or set AGENT_OFFICE_PASSWORD)");
-        process.exit(1);
-    }
     const { appScreensaver } = await import("./commands/screensaver.js");
     await appScreensaver(options);
 });
+appCmd
+    .command('notifier')
+    .description('Notify human by email when unread messages have been waiting over certain amount of time')
+    .option('--agent-office-url <url>', 'Agent Office server URL', process.env.AGENT_OFFICE_URL ?? 'http://127.0.0.1:7654')
+    .option('--password <pw>', 'API password', process.env.AGENT_OFFICE_PASSWORD)
+    .option('--to-email <email>', 'Recipient email address', process.env.TO_EMAIL)
+    .option('--resend-api-key <key>', 'Resend API key', process.env.RESEND_API_KEY)
+    .option('--domain <domain>', 'Sender domain (e.g. coworker.innercontext.com)', process.env.EMAIL_DOMAIN)
+    .option('--wait-minutes <minutes>', 'Minutes a message must be unread before notifying', '15')
+    .action(async (options) => {
+    const { notifier } = await import('./commands/notifier.js');
+    await notifier(options);
+});
 const workerCmd = program
     .command("worker")
     .description("Worker agent commands");
@@ -123,7 +124,8 @@ cronCmd
     .description("Create a new cron job")
     .requiredOption("--name <name>", "Cron job name")
     .requiredOption("--schedule <schedule>", "Cron expression (e.g., '0 9 * * *' for daily at 9am)")
-    .requiredOption("--message <message>", "Message to inject when job fires")
+    .requiredOption("--message <message>", "Action to perform when job fires")
+    .requiredOption("--respond-to <respondTo>", "Who to respond to when done")
     .option("--timezone <timezone>", "IANA timezone (e.g., 'America/New_York')")
     .action(async (token, options) => {
     const { createCron } = await import("./commands/worker.js");
@@ -186,47 +188,4 @@ cronCmd
     const { cronHistory } = await import("./commands/worker.js");
     await cronHistory(token, cronId);
 });
-// ── Worker Memory Commands (nested) ──────────────────────────────────────────
-const memoryCmd = workerCmd
-    .command("memory")
-    .description("Manage your persistent memories");
-memoryCmd
-    .command("add")
-    .argument("<token>", "Agent token in the format <agent_code>@<server-url>")
-    .description("Add a new memory")
-    .requiredOption("--content <content>", "Memory content to store")
-    .action(async (token, options) => {
-    const { memoryAdd } = await import("./commands/worker.js");
-    await memoryAdd(token, options.content);
-});
-memoryCmd
-    .command("search")
-    .argument("<token>", "Agent token in the format <agent_code>@<server-url>")
-    .description("Search memories using hybrid search (keyword + semantic)")
-    .requiredOption("--query <query>", "Search query")
-    .option("--limit <limit>", "Maximum results (default 10)", "10")
-    .action(async (token, options) => {
-    const limit = parseInt(options.limit ?? "10", 10);
-    const { memorySearch } = await import("./commands/worker.js");
-    await memorySearch(token, options.query, limit);
-});
-memoryCmd
-    .command("list")
-    .argument("<token>", "Agent token in the format <agent_code>@<server-url>")
-    .description("List all stored memories")
-    .option("--limit <limit>", "Maximum memories to list (default 50)", "50")
-    .action(async (token, options) => {
-    const limit = parseInt(options.limit ?? "50", 10);
-    const { memoryList } = await import("./commands/worker.js");
-    await memoryList(token, limit);
-});
-memoryCmd
-    .command("forget")
-    .argument("<token>", "Agent token in the format <agent_code>@<server-url>")
-    .argument("<memoryId>", "ID of the memory to forget")
-    .description("Delete a memory by ID")
-    .action(async (token, memoryId) => {
-    const { memoryForget } = await import("./commands/worker.js");
-    await memoryForget(token, memoryId);
-});
 program.parse();

package/dist/commands/communicator.d.ts

@@ -1,8 +1,8 @@
 interface CommunicatorOptions {
     url: string;
-    secret: string;
+    password: string;
     host: string;
     port: string;
 }
-export declare function appCoworkerChatWeb(coworker: string, options: CommunicatorOptions): Promise<void>;
+export declare function appCoworkerChatWeb(options: CommunicatorOptions): Promise<void>;
 export {};