@gobing-ai/ts-ai-runner 0.4.67 → 0.4.68

package/README.md

@@ -314,12 +314,15 @@ interactive session (ADR-047).
 3. else → fresh open.
 
 **Capability query (R2):** consult `getAgentSessionCapability(agent)` rather than inventing per-agent
-argv. It reports `supportsResumeById` and `supportsSessionDir`.
+argv. It reports `supportsResumeById`, `supportsSessionDir`, `supportsPersistentStdin`,
+`supportsStructuredOutput`, the `verifiedAgainst` CLI version the row was probed on, and a `note`
+naming the reason for any `false` (including CLI flags that exist but are not shim-wired yet).
+Uninstalled CLIs carry `verifiedAgainst: 'unverified …'` — never a fabricated version.
 
 ```ts
 import { getAgentSessionCapability, getAgentShim } from '@gobing-ai/ts-ai-runner';
 
-const cap = getAgentSessionCapability('omp'); // { supportsResumeById: true, supportsSessionDir: true }
+const cap = getAgentSessionCapability('omp'); // { supportsResumeById: true, supportsSessionDir: true, supportsPersistentStdin: true, … }
 const { args } = getAgentShim('omp').getPromptCommand({
     input: '',
     sessionDir: '.spur/run/r1/agent-sessions/omp',
@@ -328,21 +331,31 @@ const { args } = getAgentShim('omp').getPromptCommand({
 // args: ['-p', '', '--session-dir', '.spur/run/r1/...', '-r', 'abc123', '--mode', 'text']
 ```
 
-**Shim / capability matrix:**
-
-| Agent | `supportsResumeById` | `supportsSessionDir` | sessionDir flag | sessionId resume flag | Legacy continue |
-| ----- | -------------------- | -------------------- | --------------- | --------------------- | --------------- |
-| omp | ✓ | ✓ | `--session-dir <dir>` | `-r <id>` | `-c` |
-| pi | ✓ | ✓ | `--session-dir <dir>` | `-r <id>` | `-c` |
-| claude | ✓ | ✗ (ignored) | — | `--resume <id>` | `--continue` |
-| codex | ✗ | ✗ (ignored) | — | degrade → fresh `exec` | `exec resume --last` |
-| agy | ✓ | ✗ (ignored) | — | `--conversation <id>` | `--continue` |
-| grok | ✓ | ✗ (ignored) | — | `--resume <id>` | `-c` |
-| deepseek | ✗ | ✗ (ignored) | — | degrade → fresh headless one-shot | degrade → fresh headless one-shot |
+**Shim / capability matrix** (probed 2026-09-18; `verifiedAgainst` per row in `getAgentSessionCapability`):
+
+| Agent | resumeById | sessionDir | sessionId resume flag | persistentStdin | structuredOutput |
+| ----- | ---------- | ---------- | --------------------- | --------------- | ---------------- |
+| omp | ✓ | ✓ | `-r <id>` | ✓ (`--mode rpc`) | ✓ (`--mode json`) |
+| pi | ✓ | ✓ | `-r <id>` | ✓ (`--mode rpc`) | ✓ (`--mode json`) |
+| claude | ✓ | ✗ (ignored) | `--resume <id>` | ✓ (`--input-format stream-json`; not shim-wired) | ✓ (`--output-format json`) |
+| codex | ✓ (0.154.0) | ✗ (ignored) | `exec resume <id> <prompt>` | ✗ | ✓ (`--json`) |
+| agy | ✓ | ✗ (ignored) | `--conversation <id>` | ✗ | ✗ (unverified) |
+| grok | ✓ | ✗ (ignored) | `--resume <id>` | ✗ | ✓ (`--output-format json`) |
+| gemini | ✗ (`-r` = latest/index) | ✗ | degrade → fresh `-p` | ✗ | ✓ (`-o json`) |
+| opencode | ✗ (CLI `-s <id>` unwired) | ✗ | degrade → fresh `run` | ✗ | ✓ (`--format json`) |
+| openclaw | ✗ (CLI `--session-id` unwired) | ✗ | degrade → fresh `agent` | ✗ | ✓ (CLI `--json`; unwired) |
+| hermes | ✗ (unverified) | ✗ | degrade → fresh `chat` | ✗ | ✗ (unverified) |
+| deepseek | ✗ | ✗ | degrade → fresh headless one-shot | ✗ | ✗ |
+
+**Claude session discovery:** claude has no session-dir flag and does not accept a caller-chosen
+session id at open; the headless run's session id is discovered from the process output after the
+run (the `discoverSessionId` contract consumers implement). The capability row encodes exactly
+that: `supportsResumeById: true` (resume later via `--resume <id>`), `supportsSessionDir: false`.
 
 **Degrade rule:** when `sessionDir`/`sessionId` is set and the agent lacks resume-by-id or a
 session-store flag, the shim opens **fresh in isolation** (or plain fresh) — never bare global
-continue/last. codex, which has no one-shot resume-by-id, always degrades to a fresh `exec`.
+continue/last. codex pins via non-interactive `exec resume <id> <prompt>` (verified 0.154.0); a
+sessionDir-only request still degrades to a fresh `exec` (no session-dir flag).
 
 **Durable vs ephemeral (R4):** for omp/pi, setting `sessionDir` implies a durable session — the shim
 omits `--no-session` so a session file is written and discoverable. The legacy fresh path (no session

package/dist/agents/shims.d.ts

@@ -91,6 +91,14 @@ export interface AgentSessionCapability {
     readonly supportsResumeById: boolean;
     /** Can isolate session storage into a caller-supplied directory. */
     readonly supportsSessionDir: boolean;
+    /** Multi-turn conversation over stdin in one process (e.g. `--input-format stream-json`, `--mode rpc`). */
+    readonly supportsPersistentStdin: boolean;
+    /** Structured machine-readable output mode (json / stream-json). */
+    readonly supportsStructuredOutput: boolean;
+    /** Agent CLI version this row was last verified against; `'unverified …'` when the CLI was absent. */
+    readonly verifiedAgainst: string;
+    /** Recorded reason for any `false` — a CLI gap, or a CLI-supported flag the shim argv does not wire yet. */
+    readonly note?: string;
 }
 /** Query a bundled agent's session-affinity capability by canonical name. */
 export declare function getAgentSessionCapability(agent: AgentName): AgentSessionCapability;

package/dist/agents/shims.d.ts.map

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

package/dist/agents/shims.js

@@ -34,12 +34,19 @@ const codexShim = {
     getVersionCommand: () => ({ command: 'codex', args: ['--version'] }),
     getPromptCommand: (options) => {
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
-        // Session/pin path degrades to a fresh `exec` — codex has no reliable
-        // one-shot resume-by-id, so never `exec resume --last` (no global last).
         if (options.continue === true && !hasSession && options.input !== undefined) {
             throw new Error('Codex resume mode does not accept a new prompt');
         }
-        const args = options.continue === true && !hasSession ? ['exec', 'resume', '--last'] : ['exec', options.input ?? ''];
+        // Non-interactive resume-by-id (verified codex-cli 0.154.0): `exec resume
+        // <id> <prompt>` continues the recorded thread headlessly — the former
+        // interactive-picker-only gap is closed (feature B8 R3). sessionDir-only
+        // still degrades to fresh exec (no session-dir flag); bare `continue`
+        // stays `resume --last` (input omitted — resume-last rejects a prompt).
+        const args = hasSession && options.sessionId !== undefined
+            ? ['exec', 'resume', options.sessionId, options.input ?? '']
+            : options.continue === true && !hasSession
+                ? ['exec', 'resume', '--last']
+                : ['exec', options.input ?? ''];
         if (options.model !== undefined)
             args.push('-m', options.model);
         if ((options.mode ?? 'text') === 'json')
@@ -295,25 +302,108 @@ export const AGENT_SHIMS = {
  * `supportsResumeById` decides resume-by-id vs fresh-degrade, and
  * `supportsSessionDir` decides whether `sessionDir` is honored (ADR-047 R2).
  *
- * Agents not in the six-agent affinity matrix default to no resume-by-id and no
- * session-dir — they get the isolated-fresh / no-resume degrade.
+ * Each row records what the agent CLI verifiably supports at the version named
+ * in `verifiedAgainst` (probed via `<agent> --help` / documented flags; feature
+ * B8). Every `false` carries a `note` naming the gap — an unexplained `false`
+ * is a defect — and a CLI-supported flag the shim argv does not wire yet is
+ * called out in the note instead of being silently degraded or guessed `true`.
+ * CLIs that were absent on the probing host carry `verifiedAgainst:
+ * 'unverified …'`, never a fabricated version.
  */
 const AGENT_SESSION_CAPABILITY = {
-    omp: { supportsResumeById: true, supportsSessionDir: true },
-    pi: { supportsResumeById: true, supportsSessionDir: true },
-    claude: { supportsResumeById: true, supportsSessionDir: false },
-    // codex resume is interactive-only (`exec resume` picker); no one-shot
-    // resume-by-id and no session-dir — degrades to fresh exec.
-    codex: { supportsResumeById: false, supportsSessionDir: false },
-    'antigravity-cli': { supportsResumeById: true, supportsSessionDir: false },
-    grok: { supportsResumeById: true, supportsSessionDir: false },
-    // Non-matrix agents: conservative default (isolated-fresh / no-resume).
-    gemini: { supportsResumeById: false, supportsSessionDir: false },
-    opencode: { supportsResumeById: false, supportsSessionDir: false },
-    openclaw: { supportsResumeById: false, supportsSessionDir: false },
-    hermes: { supportsResumeById: false, supportsSessionDir: false },
+    omp: {
+        supportsResumeById: true,
+        supportsSessionDir: true,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '18.2.3',
+    },
+    pi: {
+        supportsResumeById: true,
+        supportsSessionDir: true,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.85.1',
+    },
+    claude: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '2.1.274',
+        // Verified `--input-format stream-json` (realtime streaming input) at CLI
+        // 2.1.274, but the shim has no persistent-stdin dispatch mode yet.
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate); persistent stdin (--input-format stream-json) is not yet shim-wired',
+    },
+    codex: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.154.0',
+        // R3 branch 2: `exec resume <id> <prompt>` is the working non-interactive
+        // resume (verified 0.154.0) — wired in getPromptCommand below.
+        note: 'no session-dir flag — sessionDir is ignored; `exec` carries one prompt arg (stdin `-` is one-shot), so no multi-turn stdin',
+    },
+    'antigravity-cli': {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: 'unverified (CLI not installed)',
+        // resume-by-id is provenance from the shim's own `--conversation <id>`
+        // argv, not a guess; agy itself was absent at verification (2026-09-18).
+        note: 'resume-by-id per the shim’s documented --conversation <id> argv; agy absent at verification (2026-09-18) — no session-dir, stdin, or structured-output flags documented',
+    },
+    grok: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '1.0.34',
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate); no multi-turn stdin input mode',
+    },
+    gemini: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.46.0',
+        note: '`-r/--resume` accepts `latest` or a `--list-sessions` index, not a session id; no session-dir flag; no stdin input mode',
+    },
+    opencode: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '1.17.15',
+        note: 'CLI `run -s/--session <id>` supports resume-by-id but the shim argv does not wire it yet (follow-up before declaring true); no session-dir flag; no stdin input mode',
+    },
+    openclaw: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '2026.6.11',
+        note: 'CLI `agent --session-id <id>` and `--json` are not yet shim-wired (follow-up before declaring resume-by-id true); gateway turns have no persistent stdin',
+    },
+    hermes: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: 'unverified (CLI not installed)',
+        note: 'CLI absent at verification (2026-09-18) — conservative defaults; `chat --continue` resumes the last session only, no session-dir/stdin/structured-output flags documented',
+    },
     // dsh headless has no resume/session flags — fresh-dispatch degrade.
-    deepseek: { supportsResumeById: false, supportsSessionDir: false },
+    deepseek: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: '0.1.5-rc.1',
+        note: 'headless app takes only the task positional and -h at 0.1.5-rc.1 — no resume/session/mode flags; fresh-dispatch degrade',
+    },
 };
 /** Query a bundled agent's session-affinity capability by canonical name. */
 export function getAgentSessionCapability(agent) {

package/package.json

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

package/src/agents/shims.ts

@@ -131,13 +131,20 @@ const codexShim: AgentShim = {
     getVersionCommand: () => ({ command: 'codex', args: ['--version'] }),
     getPromptCommand: (options) => {
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
-        // Session/pin path degrades to a fresh `exec` — codex has no reliable
-        // one-shot resume-by-id, so never `exec resume --last` (no global last).
         if (options.continue === true && !hasSession && options.input !== undefined) {
             throw new Error('Codex resume mode does not accept a new prompt');
         }
+        // Non-interactive resume-by-id (verified codex-cli 0.154.0): `exec resume
+        // <id> <prompt>` continues the recorded thread headlessly — the former
+        // interactive-picker-only gap is closed (feature B8 R3). sessionDir-only
+        // still degrades to fresh exec (no session-dir flag); bare `continue`
+        // stays `resume --last` (input omitted — resume-last rejects a prompt).
         const args =
-            options.continue === true && !hasSession ? ['exec', 'resume', '--last'] : ['exec', options.input ?? ''];
+            hasSession && options.sessionId !== undefined
+                ? ['exec', 'resume', options.sessionId, options.input ?? '']
+                : options.continue === true && !hasSession
+                  ? ['exec', 'resume', '--last']
+                  : ['exec', options.input ?? ''];
         if (options.model !== undefined) args.push('-m', options.model);
         if ((options.mode ?? 'text') === 'json') args.push('--json');
         return { command: 'codex', args };
@@ -377,6 +384,14 @@ export interface AgentSessionCapability {
     readonly supportsResumeById: boolean;
     /** Can isolate session storage into a caller-supplied directory. */
     readonly supportsSessionDir: boolean;
+    /** Multi-turn conversation over stdin in one process (e.g. `--input-format stream-json`, `--mode rpc`). */
+    readonly supportsPersistentStdin: boolean;
+    /** Structured machine-readable output mode (json / stream-json). */
+    readonly supportsStructuredOutput: boolean;
+    /** Agent CLI version this row was last verified against; `'unverified …'` when the CLI was absent. */
+    readonly verifiedAgainst: string;
+    /** Recorded reason for any `false` — a CLI gap, or a CLI-supported flag the shim argv does not wire yet. */
+    readonly note?: string;
 }
 
 /**
@@ -385,25 +400,108 @@ export interface AgentSessionCapability {
  * `supportsResumeById` decides resume-by-id vs fresh-degrade, and
  * `supportsSessionDir` decides whether `sessionDir` is honored (ADR-047 R2).
  *
- * Agents not in the six-agent affinity matrix default to no resume-by-id and no
- * session-dir — they get the isolated-fresh / no-resume degrade.
+ * Each row records what the agent CLI verifiably supports at the version named
+ * in `verifiedAgainst` (probed via `<agent> --help` / documented flags; feature
+ * B8). Every `false` carries a `note` naming the gap — an unexplained `false`
+ * is a defect — and a CLI-supported flag the shim argv does not wire yet is
+ * called out in the note instead of being silently degraded or guessed `true`.
+ * CLIs that were absent on the probing host carry `verifiedAgainst:
+ * 'unverified …'`, never a fabricated version.
  */
 const AGENT_SESSION_CAPABILITY: Readonly<Record<AgentName, AgentSessionCapability>> = {
-    omp: { supportsResumeById: true, supportsSessionDir: true },
-    pi: { supportsResumeById: true, supportsSessionDir: true },
-    claude: { supportsResumeById: true, supportsSessionDir: false },
-    // codex resume is interactive-only (`exec resume` picker); no one-shot
-    // resume-by-id and no session-dir — degrades to fresh exec.
-    codex: { supportsResumeById: false, supportsSessionDir: false },
-    'antigravity-cli': { supportsResumeById: true, supportsSessionDir: false },
-    grok: { supportsResumeById: true, supportsSessionDir: false },
-    // Non-matrix agents: conservative default (isolated-fresh / no-resume).
-    gemini: { supportsResumeById: false, supportsSessionDir: false },
-    opencode: { supportsResumeById: false, supportsSessionDir: false },
-    openclaw: { supportsResumeById: false, supportsSessionDir: false },
-    hermes: { supportsResumeById: false, supportsSessionDir: false },
+    omp: {
+        supportsResumeById: true,
+        supportsSessionDir: true,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '18.2.3',
+    },
+    pi: {
+        supportsResumeById: true,
+        supportsSessionDir: true,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.85.1',
+    },
+    claude: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: true,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '2.1.274',
+        // Verified `--input-format stream-json` (realtime streaming input) at CLI
+        // 2.1.274, but the shim has no persistent-stdin dispatch mode yet.
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate); persistent stdin (--input-format stream-json) is not yet shim-wired',
+    },
+    codex: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.154.0',
+        // R3 branch 2: `exec resume <id> <prompt>` is the working non-interactive
+        // resume (verified 0.154.0) — wired in getPromptCommand below.
+        note: 'no session-dir flag — sessionDir is ignored; `exec` carries one prompt arg (stdin `-` is one-shot), so no multi-turn stdin',
+    },
+    'antigravity-cli': {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: 'unverified (CLI not installed)',
+        // resume-by-id is provenance from the shim's own `--conversation <id>`
+        // argv, not a guess; agy itself was absent at verification (2026-09-18).
+        note: 'resume-by-id per the shim’s documented --conversation <id> argv; agy absent at verification (2026-09-18) — no session-dir, stdin, or structured-output flags documented',
+    },
+    grok: {
+        supportsResumeById: true,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '1.0.34',
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate); no multi-turn stdin input mode',
+    },
+    gemini: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '0.46.0',
+        note: '`-r/--resume` accepts `latest` or a `--list-sessions` index, not a session id; no session-dir flag; no stdin input mode',
+    },
+    opencode: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '1.17.15',
+        note: 'CLI `run -s/--session <id>` supports resume-by-id but the shim argv does not wire it yet (follow-up before declaring true); no session-dir flag; no stdin input mode',
+    },
+    openclaw: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: true,
+        verifiedAgainst: '2026.6.11',
+        note: 'CLI `agent --session-id <id>` and `--json` are not yet shim-wired (follow-up before declaring resume-by-id true); gateway turns have no persistent stdin',
+    },
+    hermes: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: 'unverified (CLI not installed)',
+        note: 'CLI absent at verification (2026-09-18) — conservative defaults; `chat --continue` resumes the last session only, no session-dir/stdin/structured-output flags documented',
+    },
     // dsh headless has no resume/session flags — fresh-dispatch degrade.
-    deepseek: { supportsResumeById: false, supportsSessionDir: false },
+    deepseek: {
+        supportsResumeById: false,
+        supportsSessionDir: false,
+        supportsPersistentStdin: false,
+        supportsStructuredOutput: false,
+        verifiedAgainst: '0.1.5-rc.1',
+        note: 'headless app takes only the task positional and -h at 0.1.5-rc.1 — no resume/session/mode flags; fresh-dispatch degrade',
+    },
 };
 
 /** Query a bundled agent's session-affinity capability by canonical name. */