@gobing-ai/ts-ai-runner 0.2.3 → 0.2.5

package/dist/agent-detector.js

@@ -76,7 +76,7 @@ export class AgentDetector {
         return {
             name: agent,
             installed: true,
-            version: output.split('\n')[0] ?? match.groups.version,
+            version: match.groups.version,
             channels: [],
             error: null,
         };

package/dist/doctor-runner.d.ts

@@ -44,5 +44,7 @@ export declare class DoctorRunner {
     runOne(agent: string): Promise<DoctorResult>;
     private buildResult;
     private checkAuth;
+    /** True when the path exists and has a non-zero size. */
+    private hasNonEmptyFile;
 }
 //# sourceMappingURL=doctor-runner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,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;CAC5C;AAID,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;gBAE/B,OAAO,GAAE,mBAAwB;IAO7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAgBX,SAAS;CAa1B"}
+{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,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;CAC5C;AASD,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;gBAE/B,OAAO,GAAE,mBAAwB;IAO7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAgBX,SAAS;IAmBvB,yDAAyD;YAC3C,eAAe;CAKhC"}

package/dist/doctor-runner.js

@@ -5,6 +5,10 @@ import { AgentDetector } from './agent-detector.js';
 import { isAgentName, TIER2_AGENTS } from './agents/shims.js';
 import { AiRunner } from './ai-runner.js';
 const DEFAULT_TIMEOUT_MS = 5_000;
+/** True when a value is a defined, non-blank string. */
+function isNonEmpty(value) {
+    return value !== undefined && value.trim().length > 0;
+}
 /** Runs installation and auth health checks for supported coding agents. */
 export class DoctorRunner {
     detector;
@@ -42,11 +46,16 @@ export class DoctorRunner {
         };
     }
     async checkAuth(agent) {
+        // gemini/codex expose no auth-status command; treat a non-empty credential
+        // file as authenticated. An empty/zero-byte file is a stale-credential
+        // false positive, so existence alone is insufficient.
         if (agent === 'gemini')
-            return this.fs.exists(join(homedir(), '.gemini', 'settings.json'));
-        if (agent === 'codex' && (await this.fs.exists(join(homedir(), '.codex', 'auth.json'))))
+            return this.hasNonEmptyFile(join(homedir(), '.gemini', 'settings.json'));
+        if (agent === 'codex' && (await this.hasNonEmptyFile(join(homedir(), '.codex', 'auth.json'))))
             return true;
-        if (agent === 'pi' && (this.env.GOOGLE_API_KEY !== undefined || this.env.ANTHROPIC_API_KEY !== undefined))
+        // 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)))
             return true;
         const command = this.runner.runAuthCommand(agent, { timeout: this.timeout });
         if (command === null)
@@ -55,4 +64,11 @@ export class DoctorRunner {
         return (result.exitCode === 0 &&
             !/not authenticated|not logged|unauthenticated/i.test(`${result.stdout}\n${result.stderr}`));
     }
+    /** True when the path exists and has a non-zero size. */
+    async hasNonEmptyFile(path) {
+        const stat = await this.fs.stat(path);
+        if (stat === null)
+            return false;
+        return stat.isFile() && stat.size > 0;
+    }
 }

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export * from './agent-detector';
 export * from './agents/shims';
 export * from './ai-runner';
 export * from './doctor-runner';
+export * from './slash-command';
 //# 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"}
+{"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"}

package/dist/index.js

@@ -2,3 +2,4 @@ export * from './agent-detector.js';
 export * from './agents/shims.js';
 export * from './ai-runner.js';
 export * from './doctor-runner.js';
+export * from './slash-command.js';

package/dist/slash-command.d.ts

@@ -0,0 +1,16 @@
+import type { AgentName } from './agents/shims';
+/** Whether the input is a Claude-style `/plugin:command` slash command. */
+export declare function isClaudeStyleSlashCommand(input: string): boolean;
+/**
+ * Translate a Claude-style `/plugin:command args` into the target agent's
+ * slash-command dialect. Non-slash-command input is returned unchanged.
+ *
+ * | Agent      | `/plugin:command args` becomes        |
+ * |------------|---------------------------------------|
+ * | claude     | `/plugin:command args` (pass-through) |
+ * | codex      | `$plugin-command args`                |
+ * | pi         | `/skill:plugin-command args`          |
+ * | all others | `/plugin-command args`                |
+ */
+export declare function translateSlashCommand(agent: AgentName, input: string): string;
+//# sourceMappingURL=slash-command.d.ts.map

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

@@ -0,0 +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"}

package/dist/slash-command.js

@@ -0,0 +1,39 @@
+/**
+ * Matches a Claude-style slash command: `/plugin:command [args]`.
+ *
+ * Captures the plugin namespace, the command, and any trailing argument text.
+ */
+const SLASH_COMMAND_RE = /^\/([a-zA-Z0-9._-]+):([a-zA-Z0-9._-]+)(\s.*)?$/;
+/** Whether the input is a Claude-style `/plugin:command` slash command. */
+export function isClaudeStyleSlashCommand(input) {
+    return SLASH_COMMAND_RE.test(input);
+}
+/**
+ * Translate a Claude-style `/plugin:command args` into the target agent's
+ * slash-command dialect. Non-slash-command input is returned unchanged.
+ *
+ * | Agent      | `/plugin:command args` becomes        |
+ * |------------|---------------------------------------|
+ * | claude     | `/plugin:command args` (pass-through) |
+ * | codex      | `$plugin-command args`                |
+ * | pi         | `/skill:plugin-command args`          |
+ * | all others | `/plugin-command args`                |
+ */
+export function translateSlashCommand(agent, input) {
+    const match = SLASH_COMMAND_RE.exec(input);
+    if (!match)
+        return input;
+    const [, plugin, command, rest = ''] = match;
+    const args = rest.trimStart();
+    const suffix = args.length > 0 ? ` ${args}` : '';
+    switch (agent) {
+        case 'claude':
+            return `/${plugin}:${command}${suffix}`;
+        case 'codex':
+            return `$${plugin}-${command}${suffix}`;
+        case 'pi':
+            return `/skill:${plugin}-${command}${suffix}`;
+        default:
+            return `/${plugin}-${command}${suffix}`;
+    }
+}

package/package.json

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

package/src/agent-detector.ts

@@ -103,7 +103,7 @@ export class AgentDetector {
         return {
             name: agent,
             installed: true,
-            version: output.split('\n')[0] ?? match.groups.version,
+            version: match.groups.version,
             channels: [],
             error: null,
         };

package/src/doctor-runner.ts

@@ -39,6 +39,11 @@ export interface DoctorRunnerOptions {
 
 const DEFAULT_TIMEOUT_MS = 5_000;
 
+/** True when a value is a defined, non-blank string. */
+function isNonEmpty(value: string | undefined): boolean {
+    return value !== undefined && value.trim().length > 0;
+}
+
 /** Runs installation and auth health checks for supported coding agents. */
 export class DoctorRunner {
     private readonly detector: AgentDetector;
@@ -82,9 +87,14 @@ export class DoctorRunner {
     }
 
     private async checkAuth(agent: AgentName): Promise<boolean> {
-        if (agent === 'gemini') return this.fs.exists(join(homedir(), '.gemini', 'settings.json'));
-        if (agent === 'codex' && (await this.fs.exists(join(homedir(), '.codex', 'auth.json')))) return true;
-        if (agent === 'pi' && (this.env.GOOGLE_API_KEY !== undefined || this.env.ANTHROPIC_API_KEY !== undefined))
+        // gemini/codex expose no auth-status command; treat a non-empty credential
+        // file as authenticated. An empty/zero-byte file is a stale-credential
+        // false positive, so existence alone is insufficient.
+        if (agent === 'gemini') return this.hasNonEmptyFile(join(homedir(), '.gemini', 'settings.json'));
+        if (agent === 'codex' && (await this.hasNonEmptyFile(join(homedir(), '.codex', 'auth.json')))) return true;
+        // 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)))
             return true;
         const command = this.runner.runAuthCommand(agent, { timeout: this.timeout });
         if (command === null) return false;
@@ -94,4 +104,11 @@ export class DoctorRunner {
             !/not authenticated|not logged|unauthenticated/i.test(`${result.stdout}\n${result.stderr}`)
         );
     }
+
+    /** True when the path exists and has a non-zero size. */
+    private async hasNonEmptyFile(path: string): Promise<boolean> {
+        const stat = await this.fs.stat(path);
+        if (stat === null) return false;
+        return stat.isFile() && stat.size > 0;
+    }
 }

package/src/index.ts

@@ -2,3 +2,4 @@ export * from './agent-detector';
 export * from './agents/shims';
 export * from './ai-runner';
 export * from './doctor-runner';
+export * from './slash-command';

package/src/slash-command.ts

@@ -0,0 +1,42 @@
+import type { AgentName } from './agents/shims';
+
+/**
+ * Matches a Claude-style slash command: `/plugin:command [args]`.
+ *
+ * Captures the plugin namespace, the command, and any trailing argument text.
+ */
+const SLASH_COMMAND_RE = /^\/([a-zA-Z0-9._-]+):([a-zA-Z0-9._-]+)(\s.*)?$/;
+
+/** Whether the input is a Claude-style `/plugin:command` slash command. */
+export function isClaudeStyleSlashCommand(input: string): boolean {
+    return SLASH_COMMAND_RE.test(input);
+}
+
+/**
+ * Translate a Claude-style `/plugin:command args` into the target agent's
+ * slash-command dialect. Non-slash-command input is returned unchanged.
+ *
+ * | Agent      | `/plugin:command args` becomes        |
+ * |------------|---------------------------------------|
+ * | claude     | `/plugin:command args` (pass-through) |
+ * | codex      | `$plugin-command args`                |
+ * | pi         | `/skill:plugin-command args`          |
+ * | all others | `/plugin-command args`                |
+ */
+export function translateSlashCommand(agent: AgentName, input: string): string {
+    const match = SLASH_COMMAND_RE.exec(input);
+    if (!match) return input;
+    const [, plugin, command, rest = ''] = match;
+    const args = rest.trimStart();
+    const suffix = args.length > 0 ? ` ${args}` : '';
+    switch (agent) {
+        case 'claude':
+            return `/${plugin}:${command}${suffix}`;
+        case 'codex':
+            return `$${plugin}-${command}${suffix}`;
+        case 'pi':
+            return `/skill:${plugin}-${command}${suffix}`;
+        default:
+            return `/${plugin}-${command}${suffix}`;
+    }
+}