@gobing-ai/ts-ai-runner 0.2.7 → 0.2.9

package/dist/identity.js

@@ -0,0 +1,50 @@
+import { BunSyncProcessExecutor } from '@gobing-ai/ts-runtime';
+export function buildIdentityPreamble(ctx) {
+    const sections = [
+        `You are agent \`${ctx.agentId}\` (${ctx.agentType}) in workspace \`${ctx.workspace}\`.`,
+    ];
+    if (ctx.taskId !== undefined) {
+        const title = ctx.taskTitle === undefined ? '' : ` — ${ctx.taskTitle}`;
+        sections.push(`Your current task: #${ctx.taskId}${title}.`);
+    }
+    if (ctx.purpose !== undefined && ctx.purpose.trim() !== '')
+        sections.push(`Your purpose: ${ctx.purpose}.`);
+    if (ctx.systemPrompt !== undefined && ctx.systemPrompt.trim() !== '')
+        sections.push(ctx.systemPrompt);
+    if ((ctx.peers?.length ?? 0) > 0) {
+        sections.push([
+            'Peer agents in this workspace:',
+            ...(ctx.peers ?? []).map((peer) => `- \`${peer.id}\` (${peer.type}) — ${peer.purpose ?? '(no purpose set)'}`),
+        ].join('\n'));
+    }
+    sections.push([
+        'Communication:',
+        '- Send a message with: spur message send --to <agent-id> "<message>"',
+        '- Reply to a message with: spur message reply <msg-id> "<response>"',
+        '- Read pending messages with: spur message inbox',
+    ].join('\n'));
+    if (ctx.gitBranch !== undefined) {
+        sections.push(['Git context:', `branch: ${ctx.gitBranch}`, `dirty: ${ctx.gitDirty === true ? 'true' : 'false'}`].join('\n'));
+    }
+    if ((ctx.guardrails?.length ?? 0) > 0) {
+        sections.push(['Guardrails:', ...(ctx.guardrails ?? []).map((guardrail) => `- ${guardrail}`)].join('\n'));
+    }
+    return `${sections.join('\n\n')}\n`;
+}
+export function getGitContext(workspacePath, executor = new BunSyncProcessExecutor()) {
+    const git = Bun.which('git');
+    if (git === null)
+        return null;
+    const branch = runGit(executor, git, ['-C', workspacePath, 'branch', '--show-current']);
+    if (branch === null || branch === '')
+        return null;
+    const status = runGit(executor, git, ['-C', workspacePath, 'status', '--porcelain']);
+    const dirtyCount = status === null || status === '' ? 0 : status.split('\n').filter(Boolean).length;
+    return ['Git context:', `branch: ${branch}`, `dirty: ${dirtyCount === 0 ? 'false' : `${dirtyCount} files`}`].join('\n');
+}
+function runGit(executor, command, args) {
+    const result = executor.runSync({ command, args, rejectOnError: false, forceBuffered: true });
+    if (result.exitCode !== 0)
+        return null;
+    return result.stdout.trim();
+}

package/dist/index.d.ts

@@ -1,6 +1,11 @@
 export * from './agent-detector';
+export * from './agent-spec';
 export * from './agents/shims';
 export * from './ai-runner';
 export * from './doctor-runner';
+export * from './identity';
+export * from './message-service';
 export * from './slash-command';
+export * from './team-agent-process';
+export * from './team-orchestrator';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,5 +1,10 @@
 export * from './agent-detector.js';
+export * from './agent-spec.js';
 export * from './agents/shims.js';
 export * from './ai-runner.js';
 export * from './doctor-runner.js';
+export * from './identity.js';
+export * from './message-service.js';
 export * from './slash-command.js';
+export * from './team-agent-process.js';
+export * from './team-orchestrator.js';

package/dist/message-service.d.ts

@@ -0,0 +1,13 @@
+import type { InboxMessage, InboxMessageDao } from '@gobing-ai/ts-db/inbox';
+export declare class MessageService {
+    private readonly dao;
+    constructor(dao: InboxMessageDao);
+    enqueue(fromId: string | null, toId: string, body: string, inReplyTo?: string): Promise<string>;
+    drain(toId: string): Promise<InboxMessage[]>;
+    deliver(msgId: string): Promise<void>;
+    fail(msgId: string, error: string): Promise<void>;
+    inbox(toId: string, limit?: number, offset?: number): Promise<InboxMessage[]>;
+    countPending(toId: string): Promise<number>;
+    static formatMessage(msg: InboxMessage): string;
+}
+//# sourceMappingURL=message-service.d.ts.map

package/dist/message-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-service.d.ts","sourceRoot":"","sources":["../src/message-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE5E,qBAAa,cAAc;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,eAAe;IAEjD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/F,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI5C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;CAGlD"}

package/dist/message-service.js

@@ -0,0 +1,27 @@
+export class MessageService {
+    dao;
+    constructor(dao) {
+        this.dao = dao;
+    }
+    enqueue(fromId, toId, body, inReplyTo) {
+        return this.dao.enqueue(fromId, toId, body, inReplyTo);
+    }
+    drain(toId) {
+        return this.dao.drainPending(toId);
+    }
+    deliver(msgId) {
+        return this.dao.markDelivered(msgId);
+    }
+    fail(msgId, error) {
+        return this.dao.markFailed(msgId, error);
+    }
+    inbox(toId, limit, offset) {
+        return this.dao.inbox(toId, limit, offset);
+    }
+    countPending(toId) {
+        return this.dao.countPending(toId);
+    }
+    static formatMessage(msg) {
+        return `[task from=${msg.fromId ?? 'operator'} id=${msg.id}] ${msg.body}`;
+    }
+}

package/dist/team-agent-process.d.ts

@@ -0,0 +1,36 @@
+import { Buffer } from 'node:buffer';
+import { type PipeProcessSpawner } from '@gobing-ai/ts-runtime';
+import type { AgentSpec } from './agent-spec';
+export interface AgentProcessOptions {
+    spec: AgentSpec;
+    command: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    processSpawner?: PipeProcessSpawner;
+}
+type ProcessStatus = 'running' | 'stopped' | 'errored';
+export declare class TeamAgentProcess {
+    readonly agentId: string;
+    readonly identityPreamble: string;
+    private readonly command;
+    private readonly env;
+    private readonly cwd;
+    private readonly processSpawner;
+    private subprocess;
+    private status;
+    private exitCode;
+    private readonly subscribers;
+    constructor(options: AgentProcessOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(message: string): Promise<{
+        ok: boolean;
+    }>;
+    subscribe(callback: (data: Buffer) => void): () => void;
+    getStatus(): ProcessStatus;
+    getPid(): number | null;
+    getExitCode(): number | null;
+    private pipe;
+}
+export {};
+//# sourceMappingURL=team-agent-process.d.ts.map

package/dist/team-agent-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-agent-process.d.ts","sourceRoot":"","sources":["../src/team-agent-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAA2C,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAErD,OAAO,EAAE,mBAAmB;IAgBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAWrD,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOvD,SAAS,IAAI,aAAa;IAI1B,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,WAAW,IAAI,MAAM,GAAG,IAAI;YAId,IAAI;CAerB"}

package/dist/team-agent-process.js

@@ -0,0 +1,125 @@
+import { Buffer } from 'node:buffer';
+import { BunPipeProcessSpawner } from '@gobing-ai/ts-runtime';
+import { buildIdentityPreamble } from './identity.js';
+export class TeamAgentProcess {
+    agentId;
+    identityPreamble;
+    command;
+    env;
+    cwd;
+    processSpawner;
+    subprocess = null;
+    status = 'stopped';
+    exitCode = null;
+    subscribers = new Set();
+    constructor(options) {
+        this.agentId = options.spec.id;
+        this.identityPreamble = buildIdentityPreamble({
+            agentId: options.spec.id,
+            agentType: options.spec.type,
+            workspace: options.spec.workspace,
+            purpose: options.spec.purpose,
+            systemPrompt: typeof options.spec.config.systemPrompt === 'string' ? options.spec.config.systemPrompt : undefined,
+        });
+        this.command = options.command;
+        this.env = options.env;
+        this.cwd = options.cwd ?? options.spec.workspace;
+        this.processSpawner = options.processSpawner ?? new BunPipeProcessSpawner();
+    }
+    async start() {
+        if (this.status === 'running')
+            return;
+        const [command, ...args] = this.command;
+        if (command === undefined)
+            throw new Error(`${this.agentId}: command must not be empty`);
+        this.subprocess = this.processSpawner.spawn({
+            command,
+            args,
+            ...(this.cwd !== undefined ? { cwd: this.cwd } : {}),
+            ...(this.env !== undefined ? { env: this.env } : {}),
+        });
+        this.status = 'running';
+        this.exitCode = null;
+        if (this.subprocess.stdout !== null)
+            this.pipe(this.subprocess.stdout);
+        if (this.subprocess.stderr !== null)
+            this.pipe(this.subprocess.stderr);
+        void this.subprocess.exited.then((code) => {
+            this.exitCode = code;
+            if (this.status === 'running')
+                this.status = code === 0 ? 'stopped' : 'errored';
+        });
+    }
+    async stop() {
+        const process = this.subprocess;
+        if (process === null) {
+            this.status = 'stopped';
+            return;
+        }
+        try {
+            process.endStdin();
+        }
+        catch {
+            // Process may have already closed stdin.
+        }
+        process.kill('SIGTERM');
+        const timeout = Bun.sleep(5000).then(() => 'timeout');
+        const result = await Promise.race([process.exited, timeout]);
+        if (result === 'timeout') {
+            process.kill('SIGKILL');
+            this.exitCode = await process.exited;
+        }
+        else {
+            this.exitCode = result;
+        }
+        this.status = 'stopped';
+        this.subprocess = null;
+    }
+    async send(message) {
+        if (this.status !== 'running' || this.subprocess === null)
+            return { ok: false };
+        try {
+            this.subprocess.writeStdin(`${message}\n`);
+            return { ok: true };
+        }
+        catch {
+            this.status = 'errored';
+            return { ok: false };
+        }
+    }
+    subscribe(callback) {
+        this.subscribers.add(callback);
+        return () => {
+            this.subscribers.delete(callback);
+        };
+    }
+    getStatus() {
+        return this.status;
+    }
+    getPid() {
+        return this.subprocess?.pid ?? null;
+    }
+    getExitCode() {
+        return this.exitCode;
+    }
+    async pipe(stream) {
+        const reader = stream.getReader();
+        try {
+            while (true) {
+                const chunk = await reader.read();
+                if (chunk.done)
+                    break;
+                const buffer = Buffer.from(chunk.value);
+                for (const subscriber of this.subscribers)
+                    subscriber(buffer);
+            }
+        }
+        catch {
+            if (this.status === 'running')
+                this.status = 'errored';
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}

package/dist/team-orchestrator.d.ts

@@ -0,0 +1,36 @@
+import type { AgentSpec } from './agent-spec';
+import { MessageService } from './message-service';
+import { TeamAgentProcess } from './team-agent-process';
+type TeamEvent = 'agent.started' | 'agent.stopped' | 'message.sent';
+type TeamListener = (payload: unknown) => void;
+type AgentProcessFactory = (options: ConstructorParameters<typeof TeamAgentProcess>[0]) => TeamAgentProcess;
+export interface TeamOrchestratorOptions {
+    processFactory?: AgentProcessFactory;
+}
+export declare class TeamOrchestrator {
+    private readonly configDir;
+    private readonly messageService;
+    private specs;
+    private readonly running;
+    private readonly listeners;
+    private readonly processFactory;
+    constructor(configDir: string, messageService: MessageService, options?: TeamOrchestratorOptions);
+    loadSpecs(): AgentSpec[];
+    getSpec(id: string): AgentSpec | undefined;
+    startAgent(id: string): Promise<TeamAgentProcess>;
+    stopAgent(id: string): Promise<void>;
+    restartAgent(id: string): Promise<TeamAgentProcess>;
+    sendMessage(fromId: string | null, toId: string, body: string, inReplyTo?: string): Promise<string>;
+    getRunningAgents(): Map<string, TeamAgentProcess>;
+    getAgentStatus(id: string): 'running' | 'stopped' | 'errored' | 'unknown';
+    getPeerSpecs(workspace: string, excludeId?: string): AgentSpec[];
+    stopAll(): Promise<void>;
+    on(event: TeamEvent, listener: TeamListener): () => void;
+    private requireSpec;
+    private requireAgentName;
+    private injectPendingMessages;
+    private flushInbox;
+    private emit;
+}
+export {};
+//# sourceMappingURL=team-orchestrator.d.ts.map

package/dist/team-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-orchestrator.d.ts","sourceRoot":"","sources":["../src/team-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,CAAC;AACpE,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAC/C,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC;AAE5G,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,qBAAa,gBAAgB;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAPnC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;gBAGhC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC/C,OAAO,GAAE,uBAA4B;IAKzC,SAAS,IAAI,SAAS,EAAE;IAKxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkCjD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKnD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzG,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS;IAMzE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAK1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,IAAI;IAOxD,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,qBAAqB;YAIf,UAAU;IASxB,OAAO,CAAC,IAAI;CAGf"}

package/dist/team-orchestrator.js

@@ -0,0 +1,131 @@
+import { loadAgentSpecs } from './agent-spec.js';
+import { getAgentShim, isAgentName } from './agents/shims.js';
+import { buildIdentityPreamble } from './identity.js';
+import { MessageService } from './message-service.js';
+import { TeamAgentProcess } from './team-agent-process.js';
+export class TeamOrchestrator {
+    configDir;
+    messageService;
+    specs = [];
+    running = new Map();
+    listeners = new Map();
+    processFactory;
+    constructor(configDir, messageService, options = {}) {
+        this.configDir = configDir;
+        this.messageService = messageService;
+        this.processFactory = options.processFactory ?? ((processOptions) => new TeamAgentProcess(processOptions));
+    }
+    loadSpecs() {
+        this.specs = loadAgentSpecs(this.configDir);
+        return [...this.specs];
+    }
+    getSpec(id) {
+        if (this.specs.length === 0)
+            this.loadSpecs();
+        return this.specs.find((spec) => spec.id === id);
+    }
+    async startAgent(id) {
+        const spec = this.requireSpec(id);
+        const agentType = this.requireAgentName(spec.type);
+        const peers = this.getPeerSpecs(spec.workspace, spec.id).map((peer) => ({
+            id: peer.id,
+            type: peer.type,
+            purpose: peer.purpose,
+        }));
+        const identityPreamble = buildIdentityPreamble({
+            agentId: spec.id,
+            agentType: spec.type,
+            workspace: spec.workspace,
+            purpose: spec.purpose,
+            systemPrompt: typeof spec.config.systemPrompt === 'string' ? spec.config.systemPrompt : undefined,
+            peers,
+        });
+        const command = getAgentShim(agentType).getPromptCommand({
+            input: identityPreamble,
+            purpose: spec.purpose,
+            systemPrompt: typeof spec.config.systemPrompt === 'string' ? spec.config.systemPrompt : undefined,
+            peers,
+        });
+        const process = this.processFactory({
+            spec,
+            command: [command.command, ...command.args],
+            cwd: spec.workspace,
+        });
+        await process.start();
+        this.running.set(id, process);
+        await this.injectPendingMessages(process);
+        this.emit('agent.started', { id });
+        return process;
+    }
+    async stopAgent(id) {
+        const process = this.running.get(id);
+        if (process === undefined)
+            return;
+        await process.stop();
+        this.running.delete(id);
+        this.emit('agent.stopped', { id });
+    }
+    async restartAgent(id) {
+        await this.stopAgent(id);
+        return this.startAgent(id);
+    }
+    async sendMessage(fromId, toId, body, inReplyTo) {
+        const msgId = await this.messageService.enqueue(fromId, toId, body, inReplyTo);
+        const process = this.running.get(toId);
+        if (process !== undefined)
+            await this.flushInbox(process, 'live stdin injection failed');
+        this.emit('message.sent', { id: msgId, fromId, toId });
+        return msgId;
+    }
+    getRunningAgents() {
+        return new Map(this.running);
+    }
+    getAgentStatus(id) {
+        const process = this.running.get(id);
+        if (process === undefined)
+            return this.getSpec(id) === undefined ? 'unknown' : 'stopped';
+        return process.getStatus();
+    }
+    getPeerSpecs(workspace, excludeId) {
+        if (this.specs.length === 0)
+            this.loadSpecs();
+        return this.specs.filter((spec) => spec.workspace === workspace && spec.id !== excludeId);
+    }
+    async stopAll() {
+        await Promise.all([...this.running.keys()].map((id) => this.stopAgent(id)));
+    }
+    on(event, listener) {
+        const listeners = this.listeners.get(event) ?? new Set();
+        listeners.add(listener);
+        this.listeners.set(event, listeners);
+        return () => listeners.delete(listener);
+    }
+    requireSpec(id) {
+        const spec = this.getSpec(id);
+        if (spec === undefined)
+            throw new Error(`Agent spec not found: ${id}`);
+        return spec;
+    }
+    requireAgentName(type) {
+        if (!isAgentName(type))
+            throw new Error(`Unsupported agent type: ${type}`);
+        return type;
+    }
+    injectPendingMessages(process) {
+        return this.flushInbox(process, 'startup stdin injection failed');
+    }
+    async flushInbox(process, failLabel) {
+        const messages = await this.messageService.drain(process.agentId);
+        for (const message of messages) {
+            const result = await process.send(MessageService.formatMessage(message));
+            if (result.ok)
+                await this.messageService.deliver(message.id);
+            else
+                await this.messageService.fail(message.id, failLabel);
+        }
+    }
+    emit(event, payload) {
+        for (const listener of this.listeners.get(event) ?? [])
+            listener(payload);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-ai-runner",
-    "version": "0.2.7",
+    "version": "0.2.9",
     "description": "@gobing-ai/ts-ai-runner — Coding-agent shims, detection, doctor checks, and prompt execution.",
     "keywords": [
         "typescript",
@@ -47,7 +47,9 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-ai-runner-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-runtime": "^0.2.7"
+        "@gobing-ai/ts-db": "^0.2.9",
+        "@gobing-ai/ts-runtime": "^0.2.9",
+        "@gobing-ai/ts-utils": "^0.2.9"
     },
     "devDependencies": {
         "@types/bun": "1.3.14"

package/src/agent-detector.ts

@@ -43,19 +43,11 @@ export class AgentDetector {
 
     /** Probe one agent by name. */
     async detectOne(agent: string): Promise<DetectedAgent> {
-        if (!isAgentName(agent)) {
-            return { name: agent, installed: false, version: null, channels: [], error: `Unknown agent: ${agent}` };
-        }
+        if (!isAgentName(agent)) return unavailable(agent, `Unknown agent: ${agent}`);
         try {
             return this.parseResult(agent, await this.runner.runVersionCommand(agent, { timeout: this.timeout }));
         } catch (error) {
-            return {
-                name: agent,
-                installed: false,
-                version: null,
-                channels: [],
-                error: error instanceof Error ? error.message : String(error),
-            };
+            return unavailable(agent, error instanceof Error ? error.message : String(error));
         }
     }
 
@@ -64,41 +56,17 @@ export class AgentDetector {
         const output = `${result.stdout}\n${result.stderr}`.trim();
         const lower = output.toLowerCase();
         if (lower.includes('command not found') || lower.includes('enoent') || lower.includes('not recognized')) {
-            return {
-                name: agent,
-                installed: false,
-                version: null,
-                channels: [],
-                error: `${command}: command not found`,
-            };
+            return unavailable(agent, `${command}: command not found`);
         }
         if (result.signal !== undefined || result.exitCode === null) {
-            return {
-                name: agent,
-                installed: false,
-                version: null,
-                channels: [],
-                error: result.signal ?? 'Process timed out',
-            };
+            return unavailable(agent, result.signal ?? 'Process timed out');
         }
         if (result.exitCode !== 0) {
-            return {
-                name: agent,
-                installed: false,
-                version: null,
-                channels: [],
-                error: `Non-zero exit code ${result.exitCode}: ${result.stderr.slice(0, 200)}`,
-            };
+            return unavailable(agent, `Non-zero exit code ${result.exitCode}: ${result.stderr.slice(0, 200)}`);
         }
         const match = VERSION_PATTERN.exec(output);
         if (match?.groups?.version === undefined) {
-            return {
-                name: agent,
-                installed: false,
-                version: null,
-                channels: [],
-                error: 'Could not parse version output',
-            };
+            return unavailable(agent, 'Could not parse version output');
         }
         return {
             name: agent,
@@ -109,3 +77,8 @@ export class AgentDetector {
         };
     }
 }
+
+/** Build an "unavailable" detection result for an agent with the given error. */
+function unavailable(name: AgentName | string, error: string): DetectedAgent {
+    return { name, installed: false, version: null, channels: [], error };
+}