awb-agent-manager 1.0.0

package/dist/lib/managed-agent-store.js

@@ -0,0 +1,160 @@
+import { promises as fsp } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { MANAGED_AGENTS_DIR } from './constants.js';
+import { resolveSelfCommand } from './self-path.js';
+export function managedAgentDir(agentId) {
+    return join(MANAGED_AGENTS_DIR, agentId);
+}
+export function configPathFor(agentId) {
+    return join(managedAgentDir(agentId), 'config.json');
+}
+export function apiKeyPathFor(agentId) {
+    return join(managedAgentDir(agentId), 'apikey');
+}
+export function mcpConfigPathFor(agentId) {
+    return join(managedAgentDir(agentId), 'mcp-config.json');
+}
+export function credentialPathFor(agentId) {
+    return join(managedAgentDir(agentId), 'credential.json');
+}
+export async function readAgentCredential(agentId) {
+    const path = credentialPathFor(agentId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        if (!raw || typeof raw !== 'object')
+            return null;
+        if (typeof raw.provider !== 'string' || !raw.provider)
+            return null;
+        return {
+            credential_id: typeof raw.credential_id === 'string' ? raw.credential_id : '',
+            provider: raw.provider,
+            fields: raw.fields && typeof raw.fields === 'object' ? raw.fields : {},
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeAgentCredential(agentId, credential) {
+    await ensureManagedAgentDir(agentId);
+    await fsp.writeFile(credentialPathFor(agentId), JSON.stringify(credential, null, 2), { mode: 0o600 });
+}
+export async function eraseAgentCredential(agentId) {
+    await fsp.unlink(credentialPathFor(agentId)).catch(() => undefined);
+}
+export function subagentLogPathFor(agentId) {
+    return join(managedAgentDir(agentId), 'subagent.log');
+}
+export function cliHomeDirFor(agentId) {
+    return join(managedAgentDir(agentId), 'cli-home');
+}
+export async function ensureCliHomeDir(agentId) {
+    const dir = cliHomeDirFor(agentId);
+    await fsp.mkdir(dir, { recursive: true, mode: 0o700 });
+    return dir;
+}
+export async function ensureManagedAgentDir(agentId) {
+    const dir = managedAgentDir(agentId);
+    await fsp.mkdir(dir, { recursive: true, mode: 0o700 });
+    return dir;
+}
+export async function readManagedAgentConfig(agentId) {
+    const path = configPathFor(agentId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        if (raw && typeof raw === 'object' && raw.agent_id === agentId) {
+            return raw;
+        }
+    }
+    catch {
+    }
+    return null;
+}
+export async function writeManagedAgentConfig(cfg) {
+    await ensureManagedAgentDir(cfg.agent_id);
+    await fsp.writeFile(configPathFor(cfg.agent_id), JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+export async function readApiKey(agentId) {
+    const path = apiKeyPathFor(agentId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, 'utf8').trim();
+        return raw || null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeApiKey(agentId, raw) {
+    await ensureManagedAgentDir(agentId);
+    await fsp.writeFile(apiKeyPathFor(agentId), raw, { mode: 0o600 });
+}
+export async function writeMcpConfig(agentId, awbUrl, rawApiKey) {
+    await ensureManagedAgentDir(agentId);
+    const path = mcpConfigPathFor(agentId);
+    const self = resolveSelfCommand();
+    const body = {
+        mcpServers: {
+            awb: {
+                type: 'http',
+                url: `${awbUrl.replace(/\/$/, '')}/mcp`,
+                headers: {
+                    Authorization: `Bearer ${rawApiKey}`,
+                    'X-AWB-Client-Type': 'managed-subagent',
+                },
+            },
+            host: {
+                type: 'stdio',
+                command: self.command,
+                args: [...self.prefixArgs, 'mcp-host'],
+            },
+        },
+    };
+    await fsp.writeFile(path, JSON.stringify(body, null, 2), { mode: 0o600 });
+    return path;
+}
+export async function eraseSecrets(agentId) {
+    await Promise.allSettled([
+        fsp.unlink(apiKeyPathFor(agentId)),
+        fsp.unlink(mcpConfigPathFor(agentId)),
+        fsp.unlink(credentialPathFor(agentId)),
+    ]);
+}
+export function maskKey(raw) {
+    if (!raw)
+        return '';
+    if (raw.length <= 12)
+        return raw.slice(0, 4) + '***';
+    return raw.slice(0, 8) + '***' + raw.slice(-4);
+}
+export async function listManagedAgentDirs() {
+    let entries;
+    try {
+        entries = await fsp.readdir(MANAGED_AGENTS_DIR);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of entries) {
+        const full = join(MANAGED_AGENTS_DIR, name);
+        try {
+            const stat = await fsp.stat(full);
+            if (!stat.isDirectory())
+                continue;
+            const cfg = configPathFor(name);
+            if (existsSync(cfg))
+                out.push(name);
+        }
+        catch {
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=managed-agent-store.js.map

package/dist/lib/managed-agent-store.js.map

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

package/dist/lib/managed-agents.d.ts

@@ -0,0 +1,24 @@
+export type ManagedAgentStatus = 'idle' | 'spawning' | 'running' | 'stopped' | 'error';
+export interface ManagedAgentRecord {
+    agent_id: string;
+    name: string;
+    cli: string;
+    working_dir: string;
+    status: ManagedAgentStatus;
+    pid: number | null;
+    spawned_at: string | null;
+    stopped_at: string | null;
+    last_error: string | null;
+}
+export declare class ManagedAgentRegistry {
+    #private;
+    list(): ManagedAgentRecord[];
+    get(agentId: string): ManagedAgentRecord | null;
+    upsert(rec: Pick<ManagedAgentRecord, 'agent_id' | 'name' | 'cli' | 'working_dir'>): ManagedAgentRecord;
+    setWorkingDir(agentId: string, workingDir: string): ManagedAgentRecord | null;
+    markRunning(agentId: string, pid: number): ManagedAgentRecord | null;
+    markStopped(agentId: string, reason?: string): ManagedAgentRecord | null;
+    markError(agentId: string, message: string): ManagedAgentRecord | null;
+    liveAgentIds(): string[];
+    workingDirs(): string[];
+}

package/dist/lib/managed-agents.js

@@ -0,0 +1,87 @@
+import { log } from './logging.js';
+export class ManagedAgentRegistry {
+    #byId = new Map();
+    list() {
+        return Array.from(this.#byId.values());
+    }
+    get(agentId) {
+        return this.#byId.get(agentId) ?? null;
+    }
+    upsert(rec) {
+        const existing = this.#byId.get(rec.agent_id);
+        if (existing) {
+            existing.name = rec.name || existing.name;
+            existing.cli = rec.cli || existing.cli;
+            existing.working_dir = rec.working_dir || existing.working_dir;
+            return existing;
+        }
+        const fresh = {
+            agent_id: rec.agent_id,
+            name: rec.name || rec.agent_id.slice(0, 8),
+            cli: rec.cli || 'claude',
+            working_dir: rec.working_dir || '',
+            status: 'idle',
+            pid: null,
+            spawned_at: null,
+            stopped_at: null,
+            last_error: null,
+        };
+        this.#byId.set(rec.agent_id, fresh);
+        return fresh;
+    }
+    setWorkingDir(agentId, workingDir) {
+        const rec = this.#byId.get(agentId);
+        if (!rec)
+            return null;
+        rec.working_dir = workingDir;
+        return rec;
+    }
+    markRunning(agentId, pid) {
+        const rec = this.#byId.get(agentId);
+        if (!rec)
+            return null;
+        rec.status = 'running';
+        rec.pid = pid;
+        rec.spawned_at = new Date().toISOString();
+        rec.stopped_at = null;
+        rec.last_error = null;
+        return rec;
+    }
+    markStopped(agentId, reason) {
+        const rec = this.#byId.get(agentId);
+        if (!rec)
+            return null;
+        rec.status = 'stopped';
+        rec.pid = null;
+        rec.stopped_at = new Date().toISOString();
+        if (reason)
+            rec.last_error = reason;
+        return rec;
+    }
+    markError(agentId, message) {
+        const rec = this.#byId.get(agentId);
+        if (!rec)
+            return null;
+        rec.status = 'error';
+        rec.last_error = message;
+        log(`[managed-agent ${agentId.slice(0, 8)}] error: ${message}`);
+        return rec;
+    }
+    liveAgentIds() {
+        const out = [];
+        for (const rec of this.#byId.values()) {
+            if (rec.status === 'running' || rec.status === 'spawning')
+                out.push(rec.agent_id);
+        }
+        return out;
+    }
+    workingDirs() {
+        const seen = new Set();
+        for (const rec of this.#byId.values()) {
+            if (rec.working_dir)
+                seen.add(rec.working_dir);
+        }
+        return Array.from(seen);
+    }
+}
+//# sourceMappingURL=managed-agents.js.map

package/dist/lib/managed-agents.js.map

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

package/dist/lib/mcp-client.d.ts

@@ -0,0 +1,8 @@
+import type { AwbConfig } from './rest.js';
+export interface McpCallOptions {
+    timeoutMs?: number;
+    clientName?: string;
+}
+export declare function callMcpTool(config: AwbConfig, toolName: string, toolArgs: Record<string, unknown> | undefined, opts?: McpCallOptions): Promise<any>;
+export declare function unwrapToolResult(rpcResponse: any): any;
+export declare function fireAndForgetTool(config: AwbConfig, toolName: string, toolArgs: Record<string, unknown> | undefined): Promise<void>;

package/dist/lib/mcp-client.js

@@ -0,0 +1,122 @@
+import { REQUEST_TIMEOUT_MS } from './constants.js';
+import { log } from './logging.js';
+export async function callMcpTool(config, toolName, toolArgs, opts = {}) {
+    const base = (config?.url ?? '').replace(/\/$/, '');
+    if (!base)
+        throw new Error('callMcpTool: config.url missing');
+    if (!config?.apiKey)
+        throw new Error('callMcpTool: config.apiKey missing');
+    const url = `${base}/mcp`;
+    const timeoutMs = opts.timeoutMs ?? REQUEST_TIMEOUT_MS;
+    const baseHeaders = {
+        Authorization: `Bearer ${config.apiKey}`,
+        'Content-Type': 'application/json',
+        Accept: 'application/json, text/event-stream',
+    };
+    const initResp = await fetch(url, {
+        method: 'POST',
+        headers: baseHeaders,
+        body: JSON.stringify({
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'initialize',
+            params: {
+                protocolVersion: '2025-03-26',
+                capabilities: { experimental: { 'awb/schemaVersion': { version: 2 } } },
+                clientInfo: { name: opts.clientName || 'awb-agent-manager-tool', version: '1.0.0' },
+            },
+        }),
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!initResp.ok) {
+        throw new Error(`initialize HTTP ${initResp.status}`);
+    }
+    const sid = initResp.headers.get('mcp-session-id');
+    if (!sid)
+        throw new Error('initialize did not return Mcp-Session-Id');
+    await initResp.text().catch(() => null);
+    const sessionHeaders = { ...baseHeaders, 'Mcp-Session-Id': sid };
+    await fetch(url, {
+        method: 'POST',
+        headers: sessionHeaders,
+        body: JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }),
+        signal: AbortSignal.timeout(timeoutMs),
+    }).then((r) => r.text().catch(() => null));
+    let result = null;
+    try {
+        const callResp = await fetch(url, {
+            method: 'POST',
+            headers: sessionHeaders,
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 2,
+                method: 'tools/call',
+                params: { name: toolName, arguments: toolArgs ?? {} },
+            }),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!callResp.ok) {
+            throw new Error(`tools/call ${toolName} HTTP ${callResp.status}`);
+        }
+        result = await parseStreamableResponse(callResp);
+    }
+    finally {
+        fetch(url, {
+            method: 'DELETE',
+            headers: sessionHeaders,
+            signal: AbortSignal.timeout(timeoutMs),
+        })
+            .then((r) => r.text().catch(() => null))
+            .catch(() => {
+        });
+    }
+    return result;
+}
+async function parseStreamableResponse(resp) {
+    const contentType = resp.headers.get('content-type') ?? '';
+    const text = await resp.text();
+    if (!text)
+        return null;
+    if (contentType.includes('text/event-stream')) {
+        for (const line of text.split('\n')) {
+            const m = /^data:\s*(.+)$/.exec(line);
+            if (m) {
+                try {
+                    return JSON.parse(m[1]);
+                }
+                catch {
+                }
+            }
+        }
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+export function unwrapToolResult(rpcResponse) {
+    const content = rpcResponse?.result?.content;
+    if (!Array.isArray(content) || content.length === 0)
+        return null;
+    const text = content[0]?.text;
+    if (typeof text !== 'string')
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export async function fireAndForgetTool(config, toolName, toolArgs) {
+    try {
+        await callMcpTool(config, toolName, toolArgs);
+    }
+    catch (err) {
+        log(`MCP tool ${toolName} failed (fire-and-forget): ${err?.message ?? err}`);
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/lib/mcp-client.js.map

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

package/dist/lib/orphan-cleanup.d.ts

@@ -0,0 +1,6 @@
+export interface CleanupResult {
+    scanned: number;
+    reaped: number;
+    skipped?: number;
+}
+export declare function cleanupOrphanSubagents(): Promise<CleanupResult>;

package/dist/lib/orphan-cleanup.js

@@ -0,0 +1,108 @@
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+import { SUBAGENTS_BASE_DIR } from './constants.js';
+import { log } from './logging.js';
+const KILL_BACKUP_DELAY_MS = 2000;
+async function readPid(pidPath) {
+    try {
+        const raw = await fsp.readFile(pidPath, 'utf8');
+        const pid = parseInt(raw.trim(), 10);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err?.code === 'EPERM';
+    }
+}
+async function readLiveCfgPathsFromProc() {
+    let procEntries;
+    try {
+        procEntries = await fsp.readdir('/proc');
+    }
+    catch {
+        return null;
+    }
+    const live = new Set();
+    for (const entry of procEntries) {
+        if (!/^\d+$/.test(entry))
+            continue;
+        try {
+            const cmdline = await fsp.readFile(`/proc/${entry}/cmdline`, 'utf8');
+            const parts = cmdline.split('\0');
+            const idx = parts.indexOf('--mcp-config');
+            if (idx >= 0 && parts[idx + 1])
+                live.add(parts[idx + 1]);
+        }
+        catch {
+        }
+    }
+    return live;
+}
+async function reapOne(dir, entry, liveCfgPaths) {
+    const pidPath = join(dir, entry);
+    const cfgPath = pidPath.replace(/\.pid$/, '.json');
+    if (liveCfgPaths && liveCfgPaths.has(cfgPath)) {
+        return { skipped: true };
+    }
+    const pid = await readPid(pidPath);
+    if (pid != null && isPidAlive(pid)) {
+        log(`[orphan-cleanup] killing stale subagent pid=${pid} (${entry})`);
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch {
+        }
+        const t = setTimeout(() => {
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch {
+            }
+        }, KILL_BACKUP_DELAY_MS);
+        if (typeof t.unref === 'function')
+            t.unref();
+    }
+    await fsp.unlink(pidPath).catch(() => { });
+    await fsp.unlink(cfgPath).catch(() => { });
+    return { skipped: false };
+}
+export async function cleanupOrphanSubagents() {
+    let entries;
+    try {
+        entries = await fsp.readdir(SUBAGENTS_BASE_DIR);
+    }
+    catch {
+        return { scanned: 0, reaped: 0 };
+    }
+    const pidFiles = entries.filter((e) => e.endsWith('.pid'));
+    if (pidFiles.length === 0) {
+        return { scanned: 0, reaped: 0 };
+    }
+    const liveCfgPaths = await readLiveCfgPathsFromProc();
+    log(`[orphan-cleanup] scanning ${pidFiles.length} pid sidecar(s) in ${SUBAGENTS_BASE_DIR} (live cfg paths in /proc: ${liveCfgPaths ? liveCfgPaths.size : 'unavailable'})`);
+    let reaped = 0;
+    let skipped = 0;
+    for (const entry of pidFiles) {
+        try {
+            const r = await reapOne(SUBAGENTS_BASE_DIR, entry, liveCfgPaths);
+            if (r.skipped)
+                skipped++;
+            else
+                reaped++;
+        }
+        catch (err) {
+            log(`[orphan-cleanup] skipping ${entry}: ${err?.message ?? err}`);
+        }
+    }
+    log(`[orphan-cleanup] reaped ${reaped}/${pidFiles.length} orphan subagents (${skipped} protected as live-sibling)`);
+    return { scanned: pidFiles.length, reaped, skipped };
+}
+//# sourceMappingURL=orphan-cleanup.js.map

package/dist/lib/orphan-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-cleanup.js","sourceRoot":"","sources":["../../src/lib/orphan-cleanup.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,KAAK,UAAU,OAAO,CAAC,OAAe;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC;IAC/B,CAAC;AACH,CAAC;AAOD,KAAK,UAAU,wBAAwB;IACrC,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC1C,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAMD,KAAK,UAAU,OAAO,CACpB,GAAW,EACX,KAAa,EACb,YAAgC;IAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAInD,IAAI,YAAY,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,IAAI,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,+CAA+C,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACH,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACzB,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU;YAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,wBAAwB,EAAE,CAAC;IACtD,GAAG,CACD,6BAA6B,QAAQ,CAAC,MAAM,sBAAsB,kBAAkB,8BAA8B,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,GAAG,CACtK,CAAC;IACF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YACjE,IAAI,CAAC,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;;gBACpB,MAAM,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,6BAA6B,KAAK,KAAK,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,GAAG,CACD,2BAA2B,MAAM,IAAI,QAAQ,CAAC,MAAM,sBAAsB,OAAO,6BAA6B,CAC/G,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACvD,CAAC"}

package/dist/lib/presence-heartbeat.d.ts

@@ -0,0 +1,8 @@
+import type { AwbConfig } from './rest.js';
+export declare class PresenceHeartbeat {
+    #private;
+    constructor(config: AwbConfig, agentId: string | null);
+    start(): void;
+    stop(): void;
+    pingNow(): Promise<void>;
+}

package/dist/lib/presence-heartbeat.js

@@ -0,0 +1,61 @@
+import { HEARTBEAT_INTERVAL_MS, REQUEST_TIMEOUT_MS } from './constants.js';
+import { log } from './logging.js';
+export class PresenceHeartbeat {
+    #config;
+    #agentId;
+    #timer = null;
+    #stopped = false;
+    constructor(config, agentId) {
+        this.#config = config;
+        this.#agentId = agentId;
+    }
+    start() {
+        if (!this.#agentId) {
+            log('Presence heartbeat skipped — agent_id not in agent.json (run pairing first)');
+            return;
+        }
+        this.#stopped = false;
+        this.#ping().catch((err) => log(`Presence ping (initial) failed: ${err?.message ?? err}`));
+        this.#timer = setInterval(() => {
+            this.#ping().catch((err) => log(`Presence ping failed: ${err?.message ?? err}`));
+        }, HEARTBEAT_INTERVAL_MS);
+        this.#timer.unref?.();
+        log(`Presence heartbeat started (agent=${this.#agentId.slice(0, 8)} interval=${HEARTBEAT_INTERVAL_MS / 1000}s)`);
+    }
+    stop() {
+        this.#stopped = true;
+        if (this.#timer) {
+            clearInterval(this.#timer);
+            this.#timer = null;
+        }
+    }
+    async pingNow() {
+        if (this.#stopped || !this.#agentId)
+            return;
+        try {
+            await this.#ping();
+        }
+        catch (err) {
+            log(`Presence ping (forced) failed: ${err?.message ?? err}`);
+        }
+    }
+    async #ping() {
+        if (this.#stopped)
+            return;
+        const url = `${this.#config.url.replace(/\/$/, '')}/api/agent/ping`;
+        const resp = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'X-Agent-Key': this.#config.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ agent_id: this.#agentId }),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            throw new Error(`POST /api/agent/ping HTTP ${resp.status}`);
+        }
+        await resp.text().catch(() => null);
+    }
+}
+//# sourceMappingURL=presence-heartbeat.js.map

package/dist/lib/presence-heartbeat.js.map

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

package/dist/lib/prompts.d.ts

@@ -0,0 +1,29 @@
+import type { ColumnPrompt, PromptComposer } from './event-dispatcher.js';
+import { type PreparedAttachment, type RawChatAttachment } from './chat-attachment-prep.js';
+interface MentionLike {
+    actor_name?: string;
+    mention_source?: string;
+    role_shortcut?: string;
+    ticket_id?: string;
+    content?: string;
+}
+interface ChatHistoryEntry {
+    sender_type?: string;
+    sender_name?: string;
+    sender_id?: string;
+    content?: string;
+    created_at?: string;
+    attachments?: RawChatAttachment[];
+    type?: string;
+}
+interface ChatRoomNewMessage {
+    content?: string;
+    sender_name?: string;
+    sender_id?: string;
+}
+export declare function composeTriggerPrompt(ticket: any, _rolePrompt: string, ticketPrompt: string, fallbackTicketId: string, columnPrompt: ColumnPrompt | null, extraInstructions?: string | null): string;
+export declare function composeChatPrompt(_rolePrompt: string, history: ChatHistoryEntry[], newMessage: string, roomId?: string, usesNativeMcp?: boolean): string;
+export declare function composeCommentMentionPrompt(ticket: any, _rolePrompt: string, mention: MentionLike, fallbackTicketId: string): string;
+export declare function composeChatRoomPrompt(roomId: string, history: ChatHistoryEntry[], newMessage: ChatRoomNewMessage, attachments?: PreparedAttachment[], usesNativeMcp?: boolean, historyAttachments?: Map<ChatHistoryEntry, PreparedAttachment[]>): string;
+export declare const promptComposer: PromptComposer;
+export {};