awb-agent-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 parnmanas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,246 @@
+# awb-agent-manager
+
+Standalone subagent runner for [AI Workflow Board](../../README.md). Connects to
+an AWB server over SSE + REST, spawns CLI-driven agents (Claude, Codex, Antigravity,
+or any custom binary that speaks MCP), and reports liveness back to the AWB
+admin dashboard.
+
+This package replaces the daemon that used to live inside the
+`@parnmanas/awb` Claude plugin. The plugin (in
+[`submodules/claude-plugins/ai-workflow-board/`](../../../claude-plugins/ai-workflow-board/))
+is now a pure stdio↔HTTP MCP forwarder. agent-manager owns everything else:
+SSE event delivery, persistent ticket/chat sessions, subagent supervision, fs
+browser, instance heartbeats, and CLI lifecycle management.
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  AWB server (NestJS)                                            │
+│   ├── /api/agent-manager/*    pairing, agent identity RPC       │
+│   ├── /api/admin/agent-manager/*    instance dashboard, command │
+│   └── SSE event stream  ─────────────┐                          │
+└─────────────────────────────────────┬─┘                          │
+                                      │ HTTP (Bearer key)          │
+                                      ▼                            │
+┌─────────────────────────────────────────────────────────────────┐│
+│  awb-agent-manager  (this package)                              ││
+│   ├── EventStream       SSE consumer + reconnect                ││
+│   ├── EventDispatcher   route → ticket / chat / fs / command    ││
+│   ├── ManagedAgents     spawn / stop / restart CLI children     ││
+│   └── InstanceHeartbeat per-process registry ping ──────────────┘
+└─────────────────────────────────────────────────────────────────┘
+       │ stdio
+       ▼
+   claude / codex / antigravity / custom CLI
+```
+
+## Install
+
+### npm (recommended)
+
+```bash
+npm i -g @awb/agent-manager
+awb-agent-manager --version
+```
+
+> The package is not yet published to the public npm registry. Until it ships,
+> install from a local checkout (see "Development").
+
+### Docker
+
+```bash
+docker run --rm -it \
+  -v "$HOME/.config/awb-agent-manager:/data" \
+  -e AWB_AGENT_MANAGER_HOME=/data \
+  ghcr.io/parnmanas/awb-agent-manager:latest
+```
+
+The image bundles `node:22-alpine` plus the manager binary. Mount a host
+directory for `AWB_AGENT_MANAGER_HOME` so config + lockfile survive container
+restarts. Bind-mount each agent's working directory the same way (e.g.
+`-v $HOME/repos:/repos`) and configure those paths inside AWB.
+
+## First run — pairing with an AWB server
+
+The manager bootstraps from a one-time pairing token minted by an AWB admin.
+After redeeming, the manager stores its API key and agent identity in
+`$AWB_AGENT_MANAGER_HOME/config.json` (default
+`~/.config/awb-agent-manager/config.json`).
+
+1. **Mint** — In the AWB admin UI: _Admin → Agent Manager → Pair manager…_.
+   The dialog returns a raw token (long-form) and a 6-char display code; copy
+   either. Both are shown only once. TTL 10 minutes, single-use.
+2. **Run the wizard** — On the host that will run the manager:
+
+   ```bash
+   awb-agent-manager setup
+   ```
+
+   You'll be prompted for:
+   - AWB server URL (e.g. `https://awb.example.com:7700`)
+   - Pairing token (paste from step 1)
+   - CLI to drive (`claude` / `codex` / `antigravity`, default `claude`)
+
+   The wizard calls `/api/agent-manager/pair/redeem`, then writes
+   `~/.config/awb-agent-manager/config.json` with mode 0600. Output:
+
+   ```
+     ✓ paired
+       agent_id     <uuid>
+       workspace_id <uuid>
+       apiKey       awb_abcd***xyz9
+     ✓ wrote ~/.config/awb-agent-manager/config.json (mode 0600)
+
+     Next: run `awb-agent-manager` to start the manager.
+   ```
+
+   Non-interactive form (CI / Ansible — fails fast on missing fields):
+
+   ```bash
+   awb-agent-manager setup \
+     --url https://awb.example.com:7700 \
+     --token ABCXYZ123 \
+     --cli claude \
+     --non-interactive
+   ```
+
+   `instance_id` defaults to `<hostname>-<rand6>` — pass `--instance-id <id>`
+   for a stable label across re-pairings on the same box. `--force`
+   overwrites an existing config.json.
+
+3. **Start** — `awb-agent-manager`. The process registers with the AWB
+   instance dashboard and starts listening for `agent_manager_command` SSE
+   events.
+
+4. **Add managed agents** — Back in AWB, _Agent Manager → Managed Agents →
+   Create_. Pick the CLI (`claude` / `codex` / `antigravity` / `custom`), point at
+   a working directory, and leave _Spawn on this manager after create_ on for
+   one-click setup. The manager provisions a per-agent apiKey, writes its
+   on-disk config + mcp-config.json, and starts routing matching ticket /
+   chat / mention events to subagents that run under that agent's identity.
+
+   On manager restart, agents previously spawned this way auto-rehydrate
+   from disk — no need to re-click Spawn.
+
+## Run as a background service
+
+`awb-agent-manager service install` registers the manager so it starts on
+boot/logon and auto-restarts on crash. The installer detects your host's
+service manager and dispatches accordingly:
+
+| Host                         | Backend                | Default unit path                                  |
+|------------------------------|------------------------|----------------------------------------------------|
+| Linux + systemd              | systemd unit           | `~/.config/systemd/user/awb-agent-manager.service` |
+| Linux + Synology DSM         | rc.d boot script       | `/usr/local/etc/rc.d/awb-agent-manager.sh`         |
+| Linux without systemd        | sysvinit               | `/etc/init.d/awb-agent-manager`                    |
+| macOS                        | launchd                | `~/Library/LaunchAgents/com.awb.agent-manager.plist` |
+| Windows                      | Task Scheduler         | task `awb-agent-manager` (logon trigger)           |
+
+```bash
+# user scope (no admin/sudo) — runs at logon, recommended for laptops
+awb-agent-manager service install
+
+# system scope — runs at boot, requires sudo / Administrator shell
+awb-agent-manager service install --system
+
+# preview without writing or running registrar
+awb-agent-manager service install --dry-run
+
+# force a specific backend (e.g. testing sysvinit on a systemd host)
+awb-agent-manager service install --platform sysvinit
+
+# remove
+awb-agent-manager service uninstall [--system]
+```
+
+Notes:
+- Linux user-mode systemd services stop at logout. Run
+  `sudo loginctl enable-linger $USER` to keep the manager running after the
+  installing user logs out.
+- Synology DSM and bare sysvinit always install at system scope (the boot
+  directories are root-owned). The `--system` flag is implied.
+- Windows user-mode tasks fire at logon only. Re-run with `--system` from
+  an elevated PowerShell for a boot-time task running as `LocalSystem`.
+- macOS uses `launchctl bootstrap` on modern macOS and falls back to
+  `launchctl load -w` on older releases. Logs land in `/tmp/awb-agent-manager.log`.
+
+## Migration from the claude-plugin daemon (≤ v0.39)
+
+The plugin daemon is gone as of plugin v0.40.0. Everything it owned moved
+here. Migration is opt-in but easy:
+
+- agent-manager auto-imports `~/.claude/channels/awb/{config,agent}.json` on
+  first run if `~/.config/awb-agent-manager/config.json` is missing. A
+  `MIGRATED-TO-AGENT-MANAGER.txt` marker is dropped next to the legacy files;
+  subsequent starts skip the import. Legacy files are never deleted — the
+  plugin's stdio MCP proxy still reads them.
+- The first run will refuse to start while the legacy daemon's
+  `~/.claude/channels/awb/agent.lock` is owned by a live PID. Stop the old
+  Claude session (or `kill` the daemon) first, then start
+  `awb-agent-manager`. Pass `--force` to take over a stale lock owned by a
+  dead PID.
+
+## Configuration
+
+| Source                                           | Precedence       |
+|--------------------------------------------------|------------------|
+| `--config <path>` flag                           | 1 (highest)      |
+| `$AWB_AGENT_MANAGER_HOME/config.json`            | 2                |
+| `$XDG_CONFIG_HOME/awb-agent-manager/config.json` | 3 (Linux)        |
+| `%APPDATA%\awb-agent-manager\config.json`        | 3 (Windows)      |
+| `~/.config/awb-agent-manager/config.json`        | 4 (fallback)     |
+
+Schema (`config.json`):
+
+```json
+{
+  "url": "https://awb.example.com",
+  "apiKey": "<bearer key from pairing>",
+  "workspace_id": "<workspace uuid>",
+  "agent_id": "<manager agent uuid>",
+  "cli": "claude",
+  "delegation": {
+    "enabled": true,
+    "max_concurrent_subagents": 4
+  }
+}
+```
+
+CLI flags (`awb-agent-manager --help`):
+
+| Flag                    | Meaning                                                 |
+|-------------------------|---------------------------------------------------------|
+| `-c, --config <path>`   | Override config.json path                               |
+| `-w, --workspace <id>`  | Override `workspace_id` from config                     |
+| `-f, --force`           | Take over a lockfile owned by a stale or live owner     |
+| `--dry-run`             | Load config, log what would happen, exit                |
+| `-h, --help`            | Show full usage                                         |
+| `-v, --version`         | Print version                                           |
+
+Signals:
+
+| Signal       | Behavior                                                  |
+|--------------|-----------------------------------------------------------|
+| `SIGTERM`/`SIGINT` | Graceful drain (stop subagents, release lock)       |
+| `SIGHUP`     | Re-read `config.json` (delegation tunables hot-reload)    |
+| `SIGUSR1`    | Self-update hook (currently a stub — upgrade via npm)     |
+
+## Development
+
+```bash
+# from this directory
+npm install            # workspace install at the repo root also works
+npm run build          # tsc → dist/
+npm run dev            # tsx watch src/main.ts
+node dist/main.js -h
+```
+
+The full AWB workspace builds via turbo from the repo root:
+
+```bash
+cd ../..               # submodules/ai-workflow-board
+npm install
+npm run build          # builds agent-manager + client + server
+```
+
+For deep reference (config schema, SSE event types, security model, internals)
+see [`docs/agent-manager.md`](../../docs/agent-manager.md).

package/dist/lib/agent-lockfile.d.ts

@@ -0,0 +1,37 @@
+export declare const LOCK_PATH: string;
+export type LockRole = 'manager';
+export interface LockPayload {
+    pid: number;
+    role: LockRole;
+    version: string;
+    started_at: string;
+}
+export interface LockHandle {
+    release(): void;
+    path: string;
+    payload: LockPayload;
+}
+interface ParsedLock {
+    pid: number;
+    role?: string;
+    started_at?: string;
+    version?: string;
+}
+interface AcquireOptions {
+    role: LockRole;
+    version: string;
+    force?: boolean;
+}
+export declare function acquireAgentLock(opts: AcquireOptions): LockHandle;
+export declare function inspectAgentLock(): ParsedLock | null;
+export interface LegacyLockState {
+    present: boolean;
+    alive: boolean;
+    pid: number | null;
+    role?: string;
+    version?: string;
+    started_at?: string;
+    path: string;
+}
+export declare function inspectLegacyAgentLock(): LegacyLockState;
+export {};

package/dist/lib/agent-lockfile.js

@@ -0,0 +1,205 @@
+import { writeFileSync, readFileSync, unlinkSync, mkdirSync, existsSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { AGENT_MANAGER_HOME, LEGACY_LOCK_PATH } from './constants.js';
+import { join } from 'node:path';
+import { log } from './logging.js';
+export const LOCK_PATH = join(AGENT_MANAGER_HOME, 'agent.lock');
+const FORCE_KILL_GRACE_MS = 1500;
+function readLock() {
+    try {
+        const raw = readFileSync(LOCK_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        const pid = Number.isFinite(parsed?.pid) ? parsed.pid : 0;
+        return pid > 0
+            ? {
+                pid,
+                role: parsed.role,
+                started_at: parsed.started_at,
+                version: parsed.version,
+            }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isPidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err?.code === 'EPERM';
+    }
+}
+function writeLockAtomic(payload) {
+    try {
+        mkdirSync(dirname(LOCK_PATH), { recursive: true });
+    }
+    catch {
+    }
+    writeFileSync(LOCK_PATH, JSON.stringify(payload, null, 2) + '\n', { flag: 'wx' });
+}
+function writeLockOverwrite(payload) {
+    try {
+        mkdirSync(dirname(LOCK_PATH), { recursive: true });
+    }
+    catch {
+    }
+    writeFileSync(LOCK_PATH, JSON.stringify(payload, null, 2) + '\n');
+}
+export function acquireAgentLock(opts) {
+    const role = opts?.role;
+    const version = opts?.version || 'unknown';
+    const force = opts?.force === true;
+    if (role !== 'manager') {
+        throw new Error(`acquireAgentLock: invalid role ${JSON.stringify(role)}`);
+    }
+    const payload = {
+        pid: process.pid,
+        role,
+        version,
+        started_at: new Date().toISOString(),
+    };
+    try {
+        writeLockAtomic(payload);
+        log(`[lockfile] acquired ${LOCK_PATH} (role=${role} pid=${process.pid})`);
+        return makeReleaseHandle(payload);
+    }
+    catch (err) {
+        if (err?.code !== 'EEXIST')
+            throw err;
+    }
+    const existing = readLock();
+    if (!existing) {
+        log(`[lockfile] removing unparseable lockfile at ${LOCK_PATH}`);
+        try {
+            unlinkSync(LOCK_PATH);
+        }
+        catch {
+        }
+        writeLockAtomic(payload);
+        log(`[lockfile] acquired after stale-cleanup (role=${role} pid=${process.pid})`);
+        return makeReleaseHandle(payload);
+    }
+    if (!isPidAlive(existing.pid)) {
+        log(`[lockfile] reusing stale lock (previous owner pid=${existing.pid} role=${existing.role || '?'} dead)`);
+        try {
+            unlinkSync(LOCK_PATH);
+        }
+        catch {
+        }
+        writeLockAtomic(payload);
+        log(`[lockfile] acquired after stale-cleanup (role=${role} pid=${process.pid})`);
+        return makeReleaseHandle(payload);
+    }
+    if (!force) {
+        const e = new Error(`AWB agent-manager lockfile held by pid=${existing.pid} role=${existing.role || '?'} ` +
+            `version=${existing.version || '?'} since ${existing.started_at || '?'}. ` +
+            `Stop it first, or pass --force to take over.`);
+        e.code = 'EAGENTLOCKED';
+        throw e;
+    }
+    log(`[lockfile] --force: SIGTERM previous owner pid=${existing.pid} role=${existing.role || '?'}`);
+    try {
+        process.kill(existing.pid, 'SIGTERM');
+    }
+    catch {
+    }
+    return forceTakeover(payload, existing.pid);
+}
+async function forceTakeoverAsync(payload, prevPid) {
+    const start = Date.now();
+    while (Date.now() - start < FORCE_KILL_GRACE_MS) {
+        if (!isPidAlive(prevPid))
+            break;
+        await delay(100);
+    }
+    try {
+        writeLockAtomic(payload);
+    }
+    catch (err) {
+        if (err?.code !== 'EEXIST')
+            throw err;
+        writeLockOverwrite(payload);
+    }
+    log(`[lockfile] --force: acquired by overwrite (role=${payload.role} pid=${process.pid})`);
+}
+function forceTakeover(payload, prevPid) {
+    try {
+        writeLockOverwrite(payload);
+    }
+    catch (err) {
+        log(`[lockfile] --force overwrite failed: ${err?.message ?? err}`);
+        throw err;
+    }
+    forceTakeoverAsync(payload, prevPid).catch((err) => log(`[lockfile] takeover poll: ${err?.message ?? err}`));
+    return makeReleaseHandle(payload);
+}
+function makeReleaseHandle(payload) {
+    let released = false;
+    process.on('exit', () => {
+        if (released)
+            return;
+        safeUnlinkOwn(payload.pid);
+    });
+    return {
+        release() {
+            if (released)
+                return;
+            released = true;
+            safeUnlinkOwn(payload.pid);
+        },
+        path: LOCK_PATH,
+        payload,
+    };
+}
+function safeUnlinkOwn(myPid) {
+    try {
+        const raw = readFileSync(LOCK_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed?.pid !== myPid)
+            return;
+    }
+    catch {
+        return;
+    }
+    try {
+        unlinkSync(LOCK_PATH);
+        log(`[lockfile] released ${LOCK_PATH}`);
+    }
+    catch {
+    }
+}
+export function inspectAgentLock() {
+    return readLock();
+}
+export function inspectLegacyAgentLock() {
+    if (!existsSync(LEGACY_LOCK_PATH)) {
+        return { present: false, alive: false, pid: null, path: LEGACY_LOCK_PATH };
+    }
+    try {
+        const raw = readFileSync(LEGACY_LOCK_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        const pid = Number.isFinite(parsed?.pid) ? parsed.pid : 0;
+        if (pid <= 0) {
+            return { present: true, alive: false, pid: null, path: LEGACY_LOCK_PATH };
+        }
+        return {
+            present: true,
+            alive: isPidAlive(pid),
+            pid,
+            role: parsed.role,
+            version: parsed.version,
+            started_at: parsed.started_at,
+            path: LEGACY_LOCK_PATH,
+        };
+    }
+    catch {
+        return { present: true, alive: false, pid: null, path: LEGACY_LOCK_PATH };
+    }
+}
+//# sourceMappingURL=agent-lockfile.js.map

package/dist/lib/agent-lockfile.js.map

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

package/dist/lib/agent-manager-commands.d.ts

@@ -0,0 +1,34 @@
+import { type AwbConfig } from './rest.js';
+import type { ManagedAgentRegistry } from './managed-agents.js';
+import type { ManagedAgentContextRegistry } from './managed-agent-context.js';
+import type { BaseSessionManager } from './base-session-manager.js';
+import type { SubagentManager } from './subagent-manager.js';
+import type { CircuitBreaker } from './circuit-breaker.js';
+type CommandKind = 'spawn_agent' | 'stop_agent' | 'restart_agent' | 'restart_all_agents' | 'set_working_dir' | 'reload_config' | 'update_plugins' | 'refresh_mcp_config' | 'pull_working_dir' | 'update_manager' | 'restart_manager';
+export interface AgentManagerCommandPayload {
+    command_id: string;
+    instance_id: string;
+    agent_id?: string;
+    command: CommandKind | string;
+    args?: Record<string, any>;
+    issued_by?: string;
+    issued_at?: string;
+    timestamp?: string;
+}
+export interface CommandHandlerDeps {
+    getInstanceId(): string | null;
+    registry: ManagedAgentRegistry;
+    contextRegistry?: ManagedAgentContextRegistry | null;
+    chatSessionManager?: Pick<BaseSessionManager, 'stopForAgent'> | null;
+    ticketSessionManager?: Pick<BaseSessionManager, 'stopForAgent'> | null;
+    subagentManager?: Pick<SubagentManager, 'stopForAgent'> | null;
+    circuitBreaker?: CircuitBreaker | null;
+    reloadConfig?: () => Promise<string> | string;
+    requestStreamReconnect?: () => Promise<void> | void;
+}
+export declare class AgentManagerCommandHandler {
+    #private;
+    constructor(config: AwbConfig, deps: CommandHandlerDeps);
+    handle(raw: string): Promise<void>;
+}
+export {};