teamshare-bridge 0.1.0

package/README.md

@@ -0,0 +1,343 @@
+# teamshare-bridge
+
+The local bridge that lets AI agents work TeamShare tasks from your machine.
+
+TeamShare is the **coordination hub**: agents are registered in the app
+(identity, capabilities, task assignments, run history). The AI itself runs
+here — on your computer — connected to TeamShare through three methods, all
+provided by this package:
+
+| Method | Binary | Trigger | Requirements |
+|---|---|---|---|
+| **Terminal session** | `teamshare-agent` | You paste a command (or click "Copy run command" in the app) | Node 18+, no daemon |
+| **Auto-wake daemon** | `teamshare-bridge start` | A task is assigned to your agent (or it is @mentioned) → the daemon spawns a session automatically | The daemon must be running (`autostart on` keeps it alive across reboots) |
+| **Run button (deep link)** | `teamshare-bridge register` + `serve` | The TeamShare website's "Run agent" button hands off via `teamshare://` | One-time registration; OS cold-launches the bridge |
+
+All three share the same core: fetch a task brief (task, comments, project
+files), drive a working session (opencode / Claude / built-in headless LLM
+loop), and report back through the TeamShare API.
+
+---
+
+## Install
+
+Requires **Node.js 18+**. One shot (Windows):
+
+```powershell
+irm https://raw.githubusercontent.com/dominionbanjo/teamshare-bridge/main/scripts/install.ps1 | iex
+```
+
+One shot (macOS/Linux):
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/dominionbanjo/teamshare-bridge/main/scripts/install.sh | bash
+```
+
+Or install directly from npm (global):
+
+```sh
+npm i -g teamshare-bridge        # published package
+npm i -g .                       # from this repo
+```
+
+You now have two commands:
+
+```sh
+teamshare-agent    # CLI session runner (methods 1)
+teamshare-bridge   # daemon + protocol handler (methods 2 and 3)
+```
+
+## Run
+
+```sh
+teamshare-bridge start           # daemon in the background (pid file + ~/.teamshare/daemon.log)
+teamshare-bridge stop            # stop it
+teamshare-bridge restart         # stop + start
+teamshare-bridge status          # pid/log/autostart + per-agent busy/idle
+teamshare-bridge daemon          # foreground (debugging)
+teamshare-bridge autostart on    # start at login: Task Scheduler (admin) or Startup-folder launcher (no admin)
+teamshare-bridge autostart off   # remove it
+```
+
+## Quick start
+
+```sh
+# 1. Save your agent's key (from the app: Agents → your agent → Launch Console)
+teamshare-agent connect --agent <agent-id> --key ts_...
+
+# 2a. Work one task explicitly
+teamshare-agent run --task <task-id> --agent <agent-id> --key ts_...
+
+# 2b. Or let the agent pick up its next assigned task (priority first, then oldest)
+teamshare-agent run --agent <agent-id> --key ts_...
+
+# 2c. Auto-wake: keep the daemon running, sessions spawn on assignment
+teamshare-bridge start
+teamshare-bridge autostart on   # ...and it comes back after a reboot
+
+# 3. Run button on the website (registers the teamshare:// scheme)
+teamshare-bridge register
+```
+
+### Headless mode (no harness, no opencode/Claude — just an LLM API key)
+
+```sh
+LLM_BASE_URL=https://openrouter.ai/api/v1 \
+LLM_API_KEY=sk-... \
+LLM_MODEL=deepseek/deepseek-chat \
+  teamshare-agent run --task <task-id> --agent <agent-id> --key ts_... --self
+```
+
+The headless loop is an OpenAI-compatible **function-calling** loop: the model
+gets the task brief plus tools (`get_task`, `list_tasks`, `create_task`,
+`update_task`, `add_comment`, `list_documents`, `read_document`, `search`,
+`ask_human`, `wait_for_answer`, `list_subtasks`, `create_subtask`,
+`update_subtask`). It is instructed to break the task into 3-8 real
+subtasks (`create_subtask`) and check each off (`update_subtask done: true`)
+as work progresses — the human sees the live breakdown in the app. It posts
+milestone comments and finishes by moving the task to `in_review` /
+`resolved`. Any OpenAI-compatible endpoint works (OpenAI, DeepSeek, OpenRouter,
+Together, local vLLM/Ollama…).
+
+**One session per agent:** `run`/`chat`/`doc` acquire a per-agent lock
+(`~/.teamshare/locks/<agentId>.lock`, auto-released on exit, stale locks
+reclaimed) and wait for a busy agent instead of starting a second session.
+The daemon queues wakes for a busy agent and spawns them when it frees up;
+`teamshare-bridge status` shows `BUSY` per agent.
+
+---
+
+## How a session works
+
+1. **Heartbeat** — the agent's status flips to `working` in the app.
+2. **Brief** — the CLI fetches the task (description, comment thread, project
+   name) and downloads project files (text files truncated to ~20k chars;
+   links return their URL). The brief is written to
+   `<temp>/teamshare-task-<taskId>.md` and printed as a preview.
+3. **Work** — either a harness is spawned (`opencode run "…"`, `claude -p "…"`,
+   auto-detected in that order) or the `--self` LLM loop runs.
+4. **Report** — a closing summary comment is posted (skip with `--no-report`).
+5. **Watch** — the CLI polls the task status every 15s (up to 20 min) until it
+   leaves `open`/`in_progress`, then heartbeats back to `online`.
+
+## Command reference
+
+### `teamshare-agent`
+
+```
+teamshare-agent connect --agent <id> --key <ts_...>
+    Test the connection and save the agent key in ~/.teamshare/config.json.
+
+teamshare-agent run --task <taskId> --agent <id> --key <ts_...> [options]
+    Work a specific task. Without --task, picks the agent's next assigned task
+    from its inbox (urgent > high > medium > low, then oldest; skips
+    in_review/resolved/closed).
+
+teamshare-agent chat --project <projectId> --agent <id> --key <ts_...> [--mention <token>]
+    Reply to every project-chat message that @mentions the agent. Replies
+    stream token-by-token into the channel when the provider supports it
+    (Phase C); the final message is still posted via the API.
+
+teamshare-agent doc --document <documentId> --agent <id> --key <ts_...> [--mention <token>]
+    Document assistant (Phase F): read the document (Word/PPT/Excel/PDF text
+    via GET /documents/:id/extract) and reply to every comment that @mentions
+    the agent in its thread.
+
+teamshare-agent continue --task <taskId> --agent <id> --key <ts_...> [--self]
+    Resume a previous --self session for a task (Phase E continuation).
+
+    --harness auto|opencode|claude|none   session driver (default: config or auto)
+    --self                                headless LLM loop (needs LLM_API_KEY)
+    --no-report                           skip the closing summary comment
+    --session <id>                        live-console session id (default: auto)
+    --model <provider:model>              model override (catalog id, e.g. gemini:gemini-3.1-flash-lite)
+    --temperature <0-2>                   sampling temperature override
+    --max-tokens <n>                      token budget override
+    --system-prompt <text> | --system-prompt-file <path>
+    --ask-timeout <sec>                   ask_human wait limit (env TEAMSHARE_ASK_TIMEOUT)
+    --continue                            resume a previous --self session
+    --api-url <url>                       TeamShare API base override
+
+teamshare-agent --help
+```
+
+Model precedence: **CLI flag > agent settings (set in the app, delivered via
+deep link or auto-wake) > env (`LLM_MODEL`/`LLM_TEMPERATURE`/`LLM_MAX_TOKENS`)
+> defaults**. Model ids use the curated `<provider>:<model>` catalog
+(`docs/agent-models.md`) — the provider's OpenAI-compatible base URL is
+resolved automatically; `LLM_BASE_URL` always wins when set.
+
+### `teamshare-bridge`
+
+```
+teamshare-bridge daemon [--port N]
+    Auto-wake listener: keeps a WebSocket to TeamShare per configured agent
+    and spawns a session on wake events (task assigned, @mention in a comment
+    or chat). Also serves the localhost probe the website detects.
+
+teamshare-bridge register
+    Registers the teamshare:// URI scheme (per-user; Windows registry /
+    macOS app bundle / Linux .desktop). No admin rights needed.
+
+teamshare-bridge serve "<teamshare://agent/run?runToken=...&task=...>"
+    OS-invoked: redeems the run token and spawns the session.
+
+teamshare-bridge add-agent --agent <id> --key <ts_...>
+    Saves an agent key without testing the connection.
+
+teamshare-bridge status [--port N]
+    Shows config path, port, per-agent BUSY/idle (stale locks flagged),
+    harness, quiet hours, scheme.
+
+teamshare-bridge clear-lock --agent <id>
+    Force-removes a stale session lock. Crashed sessions (dead PID) and
+    locks older than 8h are auto-reclaimed; this is the manual override.
+
+teamshare-bridge probe [--port N]
+    Starts just the localhost probe server (for testing).
+```
+
+## Configuration
+
+`~/.teamshare/config.json` — created on first run with defaults:
+
+```json
+{
+  "agents": [{ "agentId": "...", "apiKey": "ts_..." }],
+  "port": 48242,
+  "harness": "auto",
+  "quietHours": null,
+  "wakeRules": null
+}
+```
+
+| Key | Meaning |
+|---|---|
+| `agents` | Agent id + API key pairs the daemon listens for (`teamshare-agent connect` / `teamshare-bridge add-agent` populate this) |
+| `port` | Localhost probe port. Picked at **random** from `[48231, 48242, 48253, 48264, 48275, 48286, 48297]` on first run; the website probes all candidates, so any pick is discoverable. Override with `--port`. |
+| `harness` | Preferred session driver: `auto`, `opencode`, `claude`, `none` |
+| `quietHours` | `{ "start": "22:00", "end": "07:00" }` — wake events are ignored during this window |
+| `wakeRules` | `{ "priorities": ["high", "urgent"] }` — only wake for tasks matching these priorities |
+
+## Environment variables
+
+| Variable | Default | Used by |
+|---|---|---|
+| `TEAMSHARE_API_URL` | `http://localhost:4000/api` | all commands |
+| `TEAMSHARE_WS_URL` | `ws://localhost:4000` | daemon + live console + streaming |
+| `LLM_BASE_URL` | (catalog per model) | `--self`, chat/doc replies |
+| `LLM_API_KEY` | — (required for `--self`) | `--self`, chat/doc replies |
+| `LLM_MODEL` | `deepseek-chat` | `--self` (catalog ids resolve the base URL) |
+| `LLM_TEMPERATURE` | `0.2` | `--self`, chat/doc replies |
+| `LLM_MAX_TOKENS` | — (provider default) | `--self`, chat/doc replies |
+| `TEAMSHARE_ASK_TIMEOUT` | `900` (seconds) | `ask_human` wait limit |
+| `TS_CHAT_ECHO` | — | Debug: post canned acknowledgments (deterministic E2E) |
+
+## Live console & streaming
+
+- Every session (`run`/`chat`/`doc`) opens its own `/agents` socket and emits
+  `session:start` / `session:output` (batched ~200ms) / `session:end` — the
+  app's **Live console** on the agent detail page shows the output in real
+  time, and a capped transcript is persisted server-side at the end.
+- Local mirror + continuation history: `~/.teamshare/sessions/`
+  (`<sessionId>.json` transcripts, `task-<taskId>.json` for `--continue`).
+- Chat replies additionally stream into the project channel as
+  `message:partial` frames over a `/chat` socket (apiKey auth) — the web UI
+  renders a live draft bubble that is swapped for the persisted message.
+
+## The localhost probe
+
+The website detects the bridge by calling `GET http://localhost:<port>/ping`
+with permissive CORS (the browser can reach it from the web app):
+
+```json
+{ "ok": true, "version": "0.1.0", "agents": ["<agent-id>"] }
+```
+
+When the probe answers, the app shows "Bridge detected on this computer" and
+enables the **Run agent** button; otherwise it degrades gracefully to the
+copy-paste command.
+
+## Security model
+
+- **Agent API keys** (`ts_...`) are minted by TeamShare with scopes derived
+  from the agent's capabilities and can never exceed them; the raw key is
+  shown only once in the app. Store it via `connect` — it lives in
+  `~/.teamshare/config.json` (chmod 600 on unix).
+- **Run tokens** in `teamshare://` deep links are short-lived (10 min),
+  single-use, and exchanged server-side for a session credential — the
+  long-lived key never appears in a URL.
+- The bridge never sees environment-variable values; TeamShare's viewer-denied
+  rule extends to agents automatically.
+- The probe server binds to `127.0.0.1` only.
+
+## Platform notes
+
+| Platform | Terminal spawn | Protocol registration |
+|---|---|---|
+| Windows | `cmd /c start cmd /k …` (detached window, stays open) | `HKCU\Software\Classes\teamshare` via `reg.exe`, per-user |
+| macOS | Terminal.app via `osascript` (always present, no installs) | `~/Applications/TeamShareBridge.app` (CFBundleURLTypes); open the bundle once |
+| Linux (desktop) | `xdg-terminal-exec` → `gnome-terminal` → `konsole` → `xterm` (first found on PATH) | `~/.local/share/applications/teamshare-bridge.desktop` (`x-scheme-handler/teamshare`) |
+| Linux (server/SSH) | Headless fallback — no window; watch via the web live console | n/a |
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `EADDRINUSE` on probe | `--port <candidate>` or delete the `port` key from config; the website probes all candidates |
+| "Agent not configured locally" on a deep link | Run `teamshare-agent connect --agent <id> --key ts_...` |
+| Run button disabled with a connect hint | The agent's key isn't saved on this PC - run `connect`; keys are shown once (lost key = delete + recreate the agent) |
+| Deep-link window flashes shut | The `serve` handler failed (usually a missing local key) - the error is now kept on screen via a 30s pause |
+| No harness found on `run` | Install opencode or Claude, or use `--self` |
+| Wake events never arrive | `teamshare-bridge status`; the daemon must be running and the key saved in config |
+| Wakes queued but never spawn | Stale lock from a crashed session - `teamshare-bridge status` flags it, `clear-lock --agent <id>` removes it (dead locks auto-reclaim within seconds) |
+| Session opens but exits instantly | Run `teamshare-agent run …` manually to see the error; check the API URL and key scopes; output is captured in `~/.teamshare/sessions/spawn-*.log` |
+
+## Development
+
+```sh
+npm install
+npm run build        # tsc -> dist/
+npm run typecheck    # tsc --noEmit
+npm run dev          # watch mode
+```
+
+Runtime dependency: `socket.io-client` only — everything else is Node
+built-ins (fetch, http, crypto, child_process). Tests for the full loop run
+against a live TeamShare API (see `docs/agent-setup.md`).
+
+## Project layout
+
+```
+src/
+├── lib/
+│   ├── config.ts      # ~/.teamshare/config.json (port candidates, wake rules)
+│   ├── api.ts         # typed REST client (envelope-aware, retries, timeouts)
+│   ├── brief.ts       # task brief fetcher + heartbeat/report helpers
+│   ├── llm.ts         # --self headless function-calling loop (+ SSE streaming)
+│   ├── models.ts      # curated <provider>:<model> catalog -> base URL resolution
+│   ├── chat-reply.ts  # chat reply loop (mention-driven, streaming)
+│   ├── doc-reply.ts   # Phase F document assistant reply loop
+│   ├── session-stream.ts # live-console streaming over /agents + local transcripts
+│   ├── partial-stream.ts # Phase C message:partial draft streaming over /chat
+│   └── lock.ts        # per-agent session lock (~/.teamshare/locks/<agentId>.lock)
+├── cli/
+│   └── index.ts       # teamshare-agent (connect / run / chat / doc / continue)
+└── bridge/
+    ├── index.ts       # teamshare-bridge CLI (daemon/register/serve/status/probe)
+    ├── daemon.ts      # WS auto-wake listener + wake rules + busy-queueing
+    ├── local-server.ts# 127.0.0.1 probe server (/ping, /status)
+    ├── spawn.ts       # detached terminal session spawner (+ output capture)
+    └── protocol.ts    # teamshare:// registration + deep-link dispatch
+```
+
+## Related docs
+
+- `docs/agent-setup.md` — plain-language setup guide (mirrors the app's
+  Launch Console)
+- `docs/agent-tasks/agent-hub-connection.md` (repo root) — the full agent
+  contract: REST endpoints, MCP tools, WS events, capabilities
+- `docs/agent-models.md` (repo root) — curated model catalog + update process
+- `docs/agent-capabilities.md` (repo root) — provider matrix + feature menu
+- `docs/agent-roadmap-verification.md` (repo root) — step-by-step E2E playbook
+- `AGENTS.md` (repo root) — project conventions

package/dist/bridge/daemon.d.ts

@@ -0,0 +1 @@
+export declare function runDaemon(portOverride?: number): Promise<void>;

package/dist/bridge/daemon.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDaemon = runDaemon;
+/**
+ * `teamshare-bridge daemon` - keeps a WebSocket to TeamShare per configured
+ * agent and spawns a session when a `wake` event arrives (contract section 4).
+ * Also serves the localhost probe so the website can detect it.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const socket_io_client_1 = require("socket.io-client");
+const api_1 = require("../lib/api");
+const config_1 = require("../lib/config");
+const lock_1 = require("../lib/lock");
+const local_server_1 = require("./local-server");
+const spawn_1 = require("./spawn");
+const WS_DEFAULT = 'ws://localhost:4000';
+const LOG_PATH = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'daemon.log');
+function log(line) {
+    const stamp = new Date().toISOString();
+    const text = `[${stamp}] ${line}`;
+    console.log(text);
+    try {
+        (0, node_fs_1.appendFileSync)(LOG_PATH, text + '\n');
+    }
+    catch {
+        /* log file best-effort */
+    }
+}
+function inQuietHours(config) {
+    if (!config.quietHours)
+        return false;
+    const now = new Date();
+    const mins = now.getHours() * 60 + now.getMinutes();
+    const parse = (t) => {
+        const [h, m] = t.split(':').map(Number);
+        return h * 60 + (Number.isFinite(m) ? m : 0);
+    };
+    const start = parse(config.quietHours.start);
+    const end = parse(config.quietHours.end);
+    return start <= end ? mins >= start && mins < end : mins >= start || mins < end;
+}
+async function runDaemon(portOverride) {
+    const config = (0, config_1.loadConfig)();
+    const port = portOverride ?? config.port;
+    const apiBase = process.env.TEAMSHARE_API_URL ?? api_1.DEFAULT_API_URL;
+    const wsBase = (process.env.TEAMSHARE_WS_URL ?? WS_DEFAULT).replace(/\/$/, '');
+    /** agentId -> queued wakes waiting for the session lock to free up. */
+    const wakeQueue = new Map();
+    /** agentId -> ISO timestamp of the last wake event (probe/status). */
+    const lastWakeByAgent = new Map();
+    const getStatus = () => ({
+        configPath: (0, config_1.configPath)(),
+        agents: config.agents.map((a) => {
+            const lock = (0, lock_1.readLock)(a.agentId);
+            const base = {
+                agentId: a.agentId,
+                lastWake: lastWakeByAgent.get(a.agentId),
+                queued: wakeQueue.get(a.agentId)?.length ?? 0,
+            };
+            if ((0, lock_1.isLockBusy)(a.agentId) && lock) {
+                base.busy = true;
+                base.since = lock.startedAt;
+                base.kind = lock.kind;
+                base.taskId = lock.taskId;
+                base.projectId = lock.projectId;
+                base.documentId = lock.documentId;
+            }
+            else {
+                base.busy = false;
+            }
+            return base;
+        }),
+        registeredSchemes: false,
+    });
+    const { server, port: boundPort } = await (0, local_server_1.startProbeServer)(port, getStatus);
+    log(`probe server listening on http://localhost:${boundPort}/ping`);
+    if (config.agents.length === 0) {
+        log('no agents configured - run: teamshare-agent connect --agent <id> --key ts_...');
+    }
+    const sockets = [];
+    const timers = [];
+    /** agentId -> Phase D settings snapshot (refreshed on every reconnect). */
+    const settingsByAgent = new Map();
+    for (const agent of config.agents) {
+        const api = api_1.TeamshareApi.forAgent(apiBase, agent);
+        /** Keeps the agent marked online; errors are surfaced, never swallowed. */
+        const heartbeat = () => {
+            api
+                .heartbeat(agent.agentId, 'online')
+                .then(() => log(`agent ${agent.agentId}: heartbeat online`))
+                .catch((err) => log(`agent ${agent.agentId}: heartbeat failed: ${(0, config_1.msg)(err)}`));
+        };
+        const socket = (0, socket_io_client_1.io)(`${wsBase}/agents`, {
+            transports: ['websocket'],
+            auth: { apiKey: agent.apiKey },
+            reconnection: true,
+            reconnectionDelay: 2_000,
+            reconnectionDelayMax: 30_000,
+        });
+        socket.on('connect', () => {
+            log(`agent ${agent.agentId}: connected to /agents`);
+            // The gateway authenticates asynchronously after the socket connects -
+            // retry the join until the ack confirms client.agentId is set (which
+            // also carries the Phase D settings snapshot).
+            const joinUntilReady = (attempt) => {
+                socket.emit('join', { ack: true }, (res) => {
+                    if (res?.success) {
+                        const settings = res.data?.settings ?? null;
+                        settingsByAgent.set(agent.agentId, settings);
+                        if (settings) {
+                            log(`agent ${agent.agentId}: settings ${JSON.stringify({
+                                model: settings.model ?? null,
+                                temperature: settings.temperature ?? null,
+                                maxTokens: settings.maxTokens ?? null,
+                            })}`);
+                        }
+                    }
+                    else if (attempt < 10) {
+                        setTimeout(() => joinUntilReady(attempt + 1), 1000);
+                    }
+                    else {
+                        log(`agent ${agent.agentId}: join ack failed after retries`);
+                    }
+                });
+            };
+            joinUntilReady(0);
+            heartbeat();
+            timers.push(setInterval(heartbeat, 60_000));
+        });
+        socket.on('disconnect', (reason) => {
+            log(`agent ${agent.agentId}: disconnected (${reason})`);
+        });
+        socket.on('connect_error', (err) => {
+            log(`agent ${agent.agentId}: connect_error ${(0, config_1.msg)(err)}`);
+        });
+        socket.on('wake', (event) => {
+            lastWakeByAgent.set(agent.agentId, new Date().toISOString());
+            void handleWake(api, agent.agentId, agent.apiKey, event, config, {
+                settings: settingsByAgent.get(agent.agentId),
+                wakeQueue,
+            }).catch((err) => log(`agent ${agent.agentId}: wake failed: ${(0, config_1.msg)(err)}`));
+        });
+        sockets.push(socket);
+        wakeQueue.set(agent.agentId, []);
+    }
+    // Queue flush: spawn queued wakes once the agent's session lock frees up
+    // (staleness-aware - a crashed session's dead-pid lock is treated as free).
+    const flushInterval = setInterval(() => {
+        for (const [agentId, queue] of wakeQueue) {
+            if (queue.length === 0)
+                continue;
+            if ((0, lock_1.isLockBusy)(agentId))
+                continue; // still busy - keep waiting
+            const agent = config.agents.find((a) => a.agentId === agentId);
+            const event = queue.shift();
+            if (!agent || !event)
+                continue;
+            void spawnWake(api_1.TeamshareApi.forAgent(apiBase, agent), agentId, agent.apiKey, event, config, { settings: settingsByAgent.get(agentId) }).catch((err) => log(`agent ${agentId}: queued wake failed: ${(0, config_1.msg)(err)}`));
+            log(`agent ${agentId}: spawned queued wake ${event.type}`);
+        }
+    }, lock_1.LOCK_POLL_MS);
+    timers.push(flushInterval);
+    const shutdown = () => {
+        log('shutting down');
+        for (const t of timers)
+            clearInterval(t);
+        for (const s of sockets)
+            s.close();
+        server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+async function handleWake(api, agentId, apiKey, event, config, extra) {
+    const { wakeQueue, settings } = extra;
+    if (inQuietHours(config)) {
+        log(`agent ${agentId}: wake ${event.type} skipped (quiet hours)`);
+        return;
+    }
+    if (event.taskId && config.wakeRules?.priorities?.length) {
+        try {
+            const task = await api.getTask(event.taskId);
+            if (!config.wakeRules.priorities.includes(task.priority)) {
+                log(`agent ${agentId}: wake ${event.type} skipped (priority ${task.priority})`);
+                return;
+            }
+        }
+        catch {
+            /* fetch failed - proceed anyway */
+        }
+    }
+    const lock = (0, lock_1.readLock)(agentId);
+    if ((0, lock_1.isLockBusy)(agentId) && lock) {
+        // The agent is busy with a live session (daemon-spawned or manual
+        // terminal) - queue this wake; the flush interval spawns it once the
+        // lock frees up (dead-pid locks are treated as free immediately).
+        const queue = wakeQueue.get(agentId) ?? [];
+        queue.push(event);
+        wakeQueue.set(agentId, queue);
+        log(`agent ${agentId}: wake ${event.type} queued (busy since ${lock.startedAt}, ${lock.kind}) - ${queue.length} waiting`);
+        return;
+    }
+    await spawnWake(api, agentId, apiKey, event, config, { settings });
+}
+async function spawnWake(api, agentId, apiKey, event, config, extra = {}) {
+    log(`agent ${agentId}: wake ${event.type}${event.taskId ? ` task=${event.taskId}` : ''} - spawning session`);
+    if (event.type === 'chat.mention') {
+        if (!event.projectId) {
+            log(`agent ${agentId}: chat.mention without projectId - skipping`);
+            return;
+        }
+        // Chat mentions spawn a chat-reply loop (no task context).
+        (0, spawn_1.spawnChatSession)(agentId, apiKey, event.projectId, event.mention ?? '', extra.settings);
+        return;
+    }
+    if (event.type === 'document.mention') {
+        if (!event.documentId) {
+            log(`agent ${agentId}: document.mention without documentId - skipping`);
+            return;
+        }
+        // Document mentions spawn the document assistant loop (Phase F).
+        (0, spawn_1.spawnDocumentSession)(agentId, apiKey, event.documentId, event.mention ?? '', extra.settings);
+        return;
+    }
+    (0, spawn_1.spawnAgentSession)(agentId, apiKey, event.taskId ?? '', extra.settings);
+}
+//# sourceMappingURL=daemon.js.map

package/dist/bridge/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/bridge/daemon.ts"],"names":[],"mappings":"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"}

package/dist/bridge/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};