@gobing-ai/ts-ai-runner 0.3.19 → 0.3.21

package/dist/ai-runner.js

@@ -50,7 +50,9 @@ export class AiRunner {
     }
     /** Build an agent prompt command without executing it. */
     buildPromptCommand(agent, promptOptions, options = {}) {
-        return getAgentShim(agent).getPromptCommand(this.withIdentityPreamble(agent, promptOptions, options));
+        return buildAgentCommand(agent, promptOptions, {
+            workspace: options.cwd ?? this.defaultCwd ?? getProcessCwd(),
+        });
     }
     /** Run an agent authentication command, or return null when unsupported. */
     runAuthCommand(agent, options = {}) {
@@ -93,22 +95,6 @@ export class AiRunner {
             durationMs: result.durationMs,
         };
     }
-    withIdentityPreamble(agent, promptOptions, options) {
-        if (!hasIdentityOptions(promptOptions))
-            return promptOptions;
-        const workspace = options.cwd ?? this.defaultCwd ?? getProcessCwd();
-        const preamble = buildIdentityPreamble({
-            agentId: agent,
-            agentType: agent,
-            workspace,
-            purpose: promptOptions.purpose,
-            systemPrompt: promptOptions.systemPrompt,
-            taskId: promptOptions.taskId,
-            peers: promptOptions.peers,
-        });
-        const input = promptOptions.input === undefined ? preamble : `${preamble}\n${promptOptions.input}`;
-        return { ...promptOptions, input };
-    }
 }
 function hasIdentityOptions(options) {
     return (options.purpose !== undefined ||
@@ -116,3 +102,27 @@ function hasIdentityOptions(options) {
         options.taskId !== undefined ||
         (options.peers !== undefined && options.peers.length > 0));
 }
+/**
+ * Shared command-build seam: identity preamble + shim dispatch. Both the
+ * one-shot path (`AiRunner.buildPromptCommand`) and the team-mode path
+ * (`TeamOrchestrator.startAgent`) resolve argv through this single function
+ * so equivalent `PromptOptions` produce equivalent argv (R5 parity).
+ */
+export function buildAgentCommand(agent, promptOptions, context) {
+    return getAgentShim(agent).getPromptCommand(applyIdentityPreamble(agent, promptOptions, context));
+}
+function applyIdentityPreamble(agent, promptOptions, context) {
+    if (!hasIdentityOptions(promptOptions))
+        return promptOptions;
+    const preamble = buildIdentityPreamble({
+        agentId: agent,
+        agentType: agent,
+        workspace: context.workspace,
+        purpose: promptOptions.purpose,
+        systemPrompt: promptOptions.systemPrompt,
+        taskId: promptOptions.taskId,
+        peers: promptOptions.peers,
+    });
+    const input = promptOptions.input === undefined ? preamble : `${preamble}\n${promptOptions.input}`;
+    return { ...promptOptions, input };
+}

package/dist/doctor-runner.d.ts

@@ -1,5 +1,7 @@
 import { type Logger } from '@gobing-ai/ts-infra';
+import { type FileSystem } from '@gobing-ai/ts-runtime';
 import { AgentDetector } from './agent-detector';
+import { type AgentName } from './agents/shims';
 import { AiRunner } from './ai-runner';
 /** Health-check result for one coding agent. */
 export interface DoctorResult {
@@ -17,6 +19,10 @@ export interface DoctorResult {
     tier: 1 | 2;
     /** Agent-specific channels or models when available. */
     channels: string[];
+    /** True when the resolved canonical id is marked deprecated. */
+    deprecated?: boolean;
+    /** Canonical replacement when the resolved id is deprecated, if any. */
+    replacedBy?: AgentName;
     /** Probe error when unavailable. */
     error: string | null;
 }
@@ -32,6 +38,8 @@ export interface DoctorRunnerOptions {
     env?: Record<string, string | undefined>;
     /** Logger for health-check diagnostics. Defaults to `getLogger('doctor')`. */
     logger?: Logger;
+    /** Filesystem for auth-file checks. Defaults to `createNodeFileSystem()`; inject to test without disk. */
+    fileSystem?: FileSystem;
 }
 /** Runs installation and auth health checks for supported coding agents. */
 export declare class DoctorRunner {

package/dist/doctor-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAuB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAgCD,4EAA4E;AAC5E,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,mBAAwB;IAQ7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAkBvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAiBX,SAAS;YAWT,cAAc;YASd,gCAAgC;YAQhC,eAAe;IAY7B,yDAAyD;YAC3C,eAAe;CAKhC"}
+{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAwB,KAAK,UAAU,EAA2B,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAiD,MAAM,gBAAgB,CAAC;AAC/F,OAAO,EAAuB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;AAwCD,4EAA4E;AAC5E,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,mBAAwB;IAS7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAkBvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAmBX,SAAS;YAcT,cAAc;YASd,gCAAgC;YAQhC,eAAe;IAY7B,yDAAyD;YAC3C,eAAe;CAKhC"}

package/dist/doctor-runner.js

@@ -1,7 +1,7 @@
 import { getLogger } from '@gobing-ai/ts-infra';
-import { getProcessEnv, joinPath, NodeFileSystem } from '@gobing-ai/ts-runtime';
+import { createNodeFileSystem, getProcessEnv, joinPath } from '@gobing-ai/ts-runtime';
 import { AgentDetector } from './agent-detector.js';
-import { DISPLAY_ORDER, isAgentName, TIER2_AGENTS } from './agents/shims.js';
+import { DISPLAY_ORDER, resolveAgentName, TIER2_AGENTS } from './agents/shims.js';
 import { AiRunner } from './ai-runner.js';
 const DEFAULT_TIMEOUT_MS = 5_000;
 const AUTH_PATTERNS = {
@@ -25,6 +25,14 @@ const AUTH_PATTERNS = {
         positive: /\S/,
         negative: /not[\s_-]*authenticated|not[\s_-]*logged[\s_-]*in|unauthenticated|no[\s_-]+providers?/i,
     },
+    omp: {
+        positive: /\S/,
+        negative: /not[\s_-]*authenticated|not[\s_-]*logged[\s_-]*in|unauthenticated|no[\s_-]+providers?/i,
+    },
+    hermes: {
+        positive: /(^|[^a-z])ok([^a-z]|$)|healthy|configured|ready/i,
+        negative: /not[\s_-]*(configured|healthy|ok)|unhealthy|missing[\s_-]+dependenc|error|failed/i,
+    },
 };
 /** True when a value is a defined, non-blank string. */
 function isNonEmpty(value) {
@@ -36,13 +44,14 @@ export class DoctorRunner {
     runner;
     timeout;
     env;
-    fs = new NodeFileSystem();
+    fs;
     logger;
     constructor(options = {}) {
         this.runner = options.runner ?? new AiRunner();
         this.detector = options.agentDetector ?? new AgentDetector({ runner: this.runner });
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
         this.env = options.env ?? getProcessEnv();
+        this.fs = options.fileSystem ?? createNodeFileSystem();
         this.logger = options.logger ?? getLogger('doctor');
     }
     /** Run a health check on all supported agents. */
@@ -62,9 +71,10 @@ export class DoctorRunner {
         return this.buildResult(await this.detector.detectOne(agent));
     }
     async buildResult(detected) {
-        const tier = TIER2_AGENTS.has(detected.name) ? 2 : 1;
+        const canonical = resolveAgentName(detected.name) ?? null;
+        const tier = canonical !== null && TIER2_AGENTS.has(canonical) ? 2 : 1;
         this.logger.debug('checking agent', { agent: detected.name, installed: detected.installed, tier });
-        const authenticated = detected.installed && isAgentName(detected.name) ? await this.checkAuth(detected.name) : false;
+        const authenticated = detected.installed && canonical !== null ? await this.checkAuth(canonical) : false;
         return {
             agent: detected.name,
             installed: detected.installed,
@@ -73,6 +83,8 @@ export class DoctorRunner {
             usable: detected.installed && detected.version !== null && authenticated,
             tier,
             channels: detected.channels,
+            deprecated: detected.deprecated,
+            replacedBy: detected.replacedBy,
             error: detected.error,
         };
     }
@@ -82,9 +94,10 @@ export class DoctorRunner {
             return this.geminiSettingsContainCredentials(home);
         if (agent === 'codex')
             return this.checkCodexAuth(home);
-        // pi reads provider keys from the environment; require a non-empty value
-        // rather than mere presence (an empty export is not a usable credential).
-        if (agent === 'pi' && (isNonEmpty(this.env.GOOGLE_API_KEY) || isNonEmpty(this.env.ANTHROPIC_API_KEY)))
+        // pi and omp read provider keys from the environment; require a non-empty
+        // value rather than mere presence (an empty export is not a usable credential).
+        if ((agent === 'pi' || agent === 'omp') &&
+            (isNonEmpty(this.env.GOOGLE_API_KEY) || isNonEmpty(this.env.ANTHROPIC_API_KEY)))
             return true;
         return (await this.probeAuthOutput(agent)) === true;
     }

package/dist/slash-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../src/slash-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAShD,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB7E"}
+{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../src/slash-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAShD,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB7E"}

package/dist/slash-command.js

@@ -32,6 +32,7 @@ export function translateSlashCommand(agent, input) {
         case 'codex':
             return `$${plugin}-${command}${suffix}`;
         case 'pi':
+        case 'omp':
             return `/skill:${plugin}-${command}${suffix}`;
         default:
             return `/${plugin}-${command}${suffix}`;

package/dist/team-orchestrator.d.ts

@@ -21,15 +21,15 @@ export declare class TeamOrchestrator {
     private readonly processFactory;
     private readonly events;
     constructor(configDir: string, inbox: InboxMessageDao, options?: TeamOrchestratorOptions);
-    loadSpecs(): AgentSpec[];
-    getSpec(id: string): AgentSpec | undefined;
+    loadSpecs(): Promise<AgentSpec[]>;
+    getSpec(id: string): Promise<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[];
+    getAgentStatus(id: string): Promise<'running' | 'stopped' | 'errored' | 'unknown'>;
+    getPeerSpecs(workspace: string, excludeId?: string): Promise<AgentSpec[]>;
     stopAll(): Promise<void>;
     on<K extends keyof AgentEvents>(event: K, listener: AgentEvents[K]): () => void;
     private requireSpec;

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

@@ -1 +1 @@
-{"version":3,"file":"team-orchestrator.d.ts","sourceRoot":"","sources":["../src/team-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC;AAE5G,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAP1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EACvC,OAAO,GAAE,uBAA4B;IAMzC,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;IAsCjD,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,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAK/E,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,gBAAgB;YAKV,qBAAqB;YAIrB,UAAU;CAa3B"}
+{"version":3,"file":"team-orchestrator.d.ts","sourceRoot":"","sources":["../src/team-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC;AAE5G,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAP1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EACvC,OAAO,GAAE,uBAA4B;IAMnC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAKnD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiCjD,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;IAI3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAMlF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;YAKjE,WAAW;IAMzB,OAAO,CAAC,gBAAgB;YAMV,qBAAqB;YAIrB,UAAU;CAa3B"}

package/dist/team-orchestrator.js

@@ -1,7 +1,7 @@
 import { EventBus } from '@gobing-ai/ts-infra';
 import { loadAgentSpecs } from './agent-spec.js';
-import { getAgentShim, isAgentName } from './agents/shims.js';
-import { buildIdentityPreamble } from './identity.js';
+import { resolveAgentName } from './agents/shims.js';
+import { buildAgentCommand } from './ai-runner.js';
 import { formatMessage } from './messages.js';
 import { TeamAgentProcess } from './team-agent-process.js';
 /**
@@ -21,37 +21,28 @@ export class TeamOrchestrator {
         this.processFactory = options.processFactory ?? ((processOptions) => new TeamAgentProcess(processOptions));
         this.events = options.events ?? new EventBus();
     }
-    loadSpecs() {
-        this.specs = loadAgentSpecs(this.configDir);
+    async loadSpecs() {
+        this.specs = await loadAgentSpecs(this.configDir);
         return [...this.specs];
     }
-    getSpec(id) {
+    async getSpec(id) {
         if (this.specs.length === 0)
-            this.loadSpecs();
+            await this.loadSpecs();
         return this.specs.find((spec) => spec.id === id);
     }
     async startAgent(id) {
-        const spec = this.requireSpec(id);
+        const spec = await this.requireSpec(id);
         const agentType = this.requireAgentName(spec.type);
-        const peers = this.getPeerSpecs(spec.workspace, spec.id).map((peer) => ({
+        const peers = (await 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,
+        const command = buildAgentCommand(agentType, {
             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,
-        });
+        }, { workspace: spec.workspace });
         const process = this.processFactory({
             spec,
             command: [command.command, ...command.args],
@@ -89,15 +80,15 @@ export class TeamOrchestrator {
     getRunningAgents() {
         return new Map(this.running);
     }
-    getAgentStatus(id) {
+    async getAgentStatus(id) {
         const process = this.running.get(id);
         if (process === undefined)
-            return this.getSpec(id) === undefined ? 'unknown' : 'stopped';
+            return (await this.getSpec(id)) === undefined ? 'unknown' : 'stopped';
         return process.getStatus();
     }
-    getPeerSpecs(workspace, excludeId) {
+    async getPeerSpecs(workspace, excludeId) {
         if (this.specs.length === 0)
-            this.loadSpecs();
+            await this.loadSpecs();
         return this.specs.filter((spec) => spec.workspace === workspace && spec.id !== excludeId);
     }
     async stopAll() {
@@ -107,16 +98,17 @@ export class TeamOrchestrator {
         this.events.on(event, listener);
         return () => this.events.off(event, listener);
     }
-    requireSpec(id) {
-        const spec = this.getSpec(id);
+    async requireSpec(id) {
+        const spec = await this.getSpec(id);
         if (spec === undefined)
             throw new Error(`Agent spec not found: ${id}`);
         return spec;
     }
     requireAgentName(type) {
-        if (!isAgentName(type))
+        const canonical = resolveAgentName(type);
+        if (canonical === undefined)
             throw new Error(`Unsupported agent type: ${type}`);
-        return type;
+        return canonical;
     }
     async injectPendingMessages(process) {
         return this.flushInbox(process, 'startup stdin injection failed');

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-ai-runner",
-    "version": "0.3.19",
+    "version": "0.3.21",
     "description": "@gobing-ai/ts-ai-runner — Coding-agent shims, detection, doctor checks, and prompt execution.",
     "keywords": [
         "typescript",
@@ -47,9 +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-db": "^0.3.19",
-        "@gobing-ai/ts-infra": "^0.3.19",
-        "@gobing-ai/ts-runtime": "^0.3.19"
+        "@gobing-ai/ts-db": "^0.3.21",
+        "@gobing-ai/ts-infra": "^0.3.21",
+        "@gobing-ai/ts-runtime": "^0.3.21"
     },
     "devDependencies": {
         "@types/bun": "1.3.14"

package/src/agent-detector.ts

@@ -1,9 +1,9 @@
-import { type AgentName, DISPLAY_ORDER, getAgentShim, isAgentName } from './agents/shims';
+import { type AgentName, DISPLAY_ORDER, getAgentShim, resolveAgentName } from './agents/shims';
 import { type AgentRunResult, AiRunner } from './ai-runner';
 
 /** Installation/version probe result for one coding agent. */
 export interface DetectedAgent {
-    /** Agent identifier. */
+    /** Canonical agent identifier (alias input is resolved to its canonical id). */
     name: AgentName | string;
     /** Whether the agent CLI was found and returned a parseable version. */
     installed: boolean;
@@ -13,6 +13,10 @@ export interface DetectedAgent {
     channels: string[];
     /** Detection error when unavailable. */
     error: string | null;
+    /** True when the resolved canonical id is marked deprecated. */
+    deprecated?: boolean;
+    /** Canonical replacement when the resolved id is deprecated, if any. */
+    replacedBy?: AgentName;
 }
 
 /** Constructor options for AgentDetector. */
@@ -35,49 +39,56 @@ export class AgentDetector {
         this.runner = options.runner ?? new AiRunner();
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
     }
-
-    /** Probe all bundled agents in display order. */
+    /** Probe all bundled canonical agents in display order. */
     async detectAll(): Promise<DetectedAgent[]> {
         return await Promise.all(DISPLAY_ORDER.map((agent) => this.detectOne(agent)));
     }
 
-    /** Probe one agent by name. */
+    /** Probe one agent by canonical id or alias. */
     async detectOne(agent: string): Promise<DetectedAgent> {
-        if (!isAgentName(agent)) return unavailable(agent, `Unknown agent: ${agent}`);
+        const canonical = resolveAgentName(agent);
+        if (canonical === undefined) return unavailable(agent, `Unknown agent: ${agent}`);
         try {
-            return this.parseResult(agent, await this.runner.runVersionCommand(agent, { timeout: this.timeout }));
+            return this.parseResult(
+                canonical,
+                await this.runner.runVersionCommand(canonical, { timeout: this.timeout }),
+            );
         } catch (error) {
             return unavailable(agent, error instanceof Error ? error.message : String(error));
         }
     }
 
-    private parseResult(agent: AgentName, result: AgentRunResult): DetectedAgent {
-        const command = getAgentShim(agent).command;
+    private parseResult(canonical: AgentName, result: AgentRunResult): DetectedAgent {
+        const command = getAgentShim(canonical).command;
         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 unavailable(agent, `${command}: command not found`);
+            return unavailable(canonical, `${command}: command not found`);
         }
         if (result.signal !== undefined) {
-            return unavailable(agent, `Terminated by signal: ${result.signal}`);
+            return unavailable(canonical, `Terminated by signal: ${result.signal}`);
         }
         if (result.exitCode === null) {
-            return unavailable(agent, 'Process did not produce an exit code');
+            return unavailable(canonical, 'Process did not produce an exit code');
         }
         if (result.exitCode !== 0) {
-            return unavailable(agent, `Non-zero exit code: ${result.exitCode}. stderr: ${result.stderr.slice(0, 200)}`);
+            return unavailable(
+                canonical,
+                `Non-zero exit code: ${result.exitCode}. stderr: ${result.stderr.slice(0, 200)}`,
+            );
         }
         const match = VERSION_PATTERN.exec(output);
         if (match?.groups?.version === undefined) {
-            return unavailable(agent, 'Could not parse version output');
+            return unavailable(canonical, 'Could not parse version output');
         }
         const version = output.split('\n')[0]?.trim() || match.groups.version;
         return {
-            name: agent,
+            name: canonical,
             installed: true,
             version,
-            channels: this.detectChannels(agent, output),
+            channels: this.detectChannels(canonical, output),
             error: null,
+            ...deprecationOf(canonical),
         };
     }
 
@@ -86,8 +97,16 @@ export class AgentDetector {
         return [];
     }
 }
-
 /** 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 };
+    return { name, installed: false, version: null, channels: [], error, ...deprecationOf(name) };
+}
+
+/** Spread deprecation fields when the name resolves to a deprecated canonical id. */
+function deprecationOf(name: AgentName | string): Partial<DetectedAgent> {
+    const canonical = resolveAgentName(name);
+    if (canonical === undefined) return {};
+    const shim = getAgentShim(canonical);
+    if (shim.deprecated === undefined) return {};
+    return { deprecated: true, replacedBy: shim.deprecated.replacedBy };
 }

package/src/agent-spec.ts

@@ -1,9 +1,9 @@
 import {
     basenamePath,
+    createNodeFileSystem,
+    type FileSystem,
     joinPath,
-    NodeSyncFileSystem,
     parseYamlObject,
-    type SyncFileSystem,
     stringifyYamlObject,
 } from '@gobing-ai/ts-runtime';
 
@@ -36,11 +36,13 @@ export function validateAgentId(id: string): string {
 }
 
 /** Load and validate all YAML agent spec files from `configDir`. Throws `ValueError` on parse failures or duplicate IDs. */
-export function loadAgentSpecs(configDir: string, fs: SyncFileSystem = new NodeSyncFileSystem()): AgentSpec[] {
-    const entries = safeReadDir(configDir, fs)
+export async function loadAgentSpecs(configDir: string, fs: FileSystem = createNodeFileSystem()): Promise<AgentSpec[]> {
+    const entries = (await safeReadDir(configDir, fs))
         .filter((entry) => entry.endsWith('.yaml') || entry.endsWith('.yml'))
         .sort();
-    const specs = entries.map((entry) => parseAgentSpec(fs.readFile(joinPath(configDir, entry)), entry));
+    const specs = await Promise.all(
+        entries.map(async (entry) => parseAgentSpec(await fs.readFile(joinPath(configDir, entry)), entry)),
+    );
     const seen = new Set<string>();
     for (const spec of specs) {
         validateAgentId(spec.id);
@@ -54,26 +56,26 @@ export function loadAgentSpecs(configDir: string, fs: SyncFileSystem = new NodeS
 export async function saveAgentSpec(
     spec: AgentSpec,
     configDir: string,
-    fs: SyncFileSystem = new NodeSyncFileSystem(),
+    fs: FileSystem = createNodeFileSystem(),
 ): Promise<void> {
     validateAgentId(spec.id);
-    fs.mkdir(configDir);
-    fs.writeFile(joinPath(configDir, `${spec.id}.yaml`), serializeAgentSpec(spec));
+    await fs.ensureDir(configDir);
+    await fs.writeFile(joinPath(configDir, `${spec.id}.yaml`), serializeAgentSpec(spec));
 }
 
 /** Remove the YAML file for agent `id` from `configDir`. Does nothing if the file doesn't exist. */
 export async function deleteAgentSpec(
     id: string,
     configDir: string,
-    fs: SyncFileSystem = new NodeSyncFileSystem(),
+    fs: FileSystem = createNodeFileSystem(),
 ): Promise<void> {
     validateAgentId(id);
-    fs.unlink(joinPath(configDir, `${id}.yaml`));
+    await fs.deleteFile(joinPath(configDir, `${id}.yaml`));
 }
 
-function safeReadDir(configDir: string, fs: SyncFileSystem = new NodeSyncFileSystem()): string[] {
+async function safeReadDir(configDir: string, fs: FileSystem = createNodeFileSystem()): Promise<string[]> {
     try {
-        return fs.readDir(configDir);
+        return await fs.readDir(configDir);
     } catch (error) {
         if (error instanceof Error && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT') {
             return [];