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

package/dist/agents/shims.d.ts

@@ -54,7 +54,21 @@ export interface PromptOptions {
         type: string;
         purpose?: string;
     }>;
+    /**
+     * Request the agent's persistent-stdin dispatch: argv starts a long-lived
+     * process that reads framed prompts from stdin (one per line) instead of
+     * consuming a one-shot `-p <input>` and exiting. Only shims exposing a
+     * `persistentStdinProtocol` accept this — callers must consult
+     * {@link getAgentSessionCapability}.`supportsPersistentStdin` first. In
+     * persistent mode the shim omits `input` from argv entirely; the caller
+     * writes the identity preamble / prompts via the shim's `frame` (see
+     * `TeamAgentProcess` `stdinFramer`). rpc/stream-json modes supersede
+     * `mode` (the structured-output flag rides inside the protocol).
+     */
+    persistentStdin?: boolean;
 }
+/** Frames one user prompt as a single stdin line for a persistent-stdin dispatch. */
+export type StdinFrame = (input: string) => string;
 /** Deprecation metadata attached to a retired or superseded agent shim. */
 export interface AgentDeprecation {
     /** Release date (ISO) when the id was marked deprecated. */
@@ -82,6 +96,15 @@ export interface AgentShim {
     getPromptCommand(options: PromptOptions): ShimCommand;
     /** Build an auth-status command, or null when unsupported. */
     getAuthCommand(): ShimCommand | null;
+    /**
+     * Persistent-stdin framing contract; present iff the shim wires a
+     * stdin-listener dispatch (mirrors `supportsPersistentStdin`). Callers
+     * frame every prompt (including the identity preamble) through it before
+     * writing to the process stdin.
+     */
+    readonly persistentStdinProtocol?: {
+        readonly frame: StdinFrame;
+    };
 }
 /** All bundled agent shims keyed by canonical agent name. */
 export declare const AGENT_SHIMS: Readonly<Record<AgentName, AgentShim>>;

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

@@ -1,4 +1,8 @@
 import { getLogger } from '@gobing-ai/ts-infra';
+/** pi-family rpc dialect (pi docs/rpc.md): one JSON object per line. */
+const piRpcFrame = (input) => `${JSON.stringify({ type: 'prompt', message: input })}\n`;
+/** claude stream-json input dialect: one user-message JSONL envelope per line. */
+const claudeStreamJsonFrame = (input) => `${JSON.stringify({ type: 'user', message: { role: 'user', content: [{ type: 'text', text: input }] } })}\n`;
 const claudeShim = {
     name: 'claude',
     command: 'claude',
@@ -8,7 +12,22 @@ const claudeShim = {
     getPromptCommand: (options) => {
         // Headless dispatch cannot answer edit approval prompts. Keep the grant
         // scoped to file edits; shell and broader tools remain gated.
-        const args = ['-p', options.input ?? '', '--permission-mode', 'acceptEdits', '--allowedTools', 'Write', 'Edit'];
+        // Persistent stdin rides the print path: `--input-format` only works
+        // with --print, and stream-json input keeps the process alive reading
+        // JSONL envelopes until stdin closes (verified --help, CLI 2.1.274).
+        const persistent = options.persistentStdin === true;
+        const args = persistent
+            ? [
+                '-p',
+                '--input-format',
+                'stream-json',
+                '--permission-mode',
+                'acceptEdits',
+                '--allowedTools',
+                'Write',
+                'Edit',
+            ]
+            : ['-p', options.input ?? '', '--permission-mode', 'acceptEdits', '--allowedTools', 'Write', 'Edit'];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
         if (hasSession) {
             // Session/pin path — never emit --continue. Claude has no session-dir
@@ -21,10 +40,13 @@ const claudeShim = {
         }
         if (options.model !== undefined)
             args.push('--model', options.model);
-        args.push('--output-format', options.mode ?? 'text');
+        // stream-json output is part of the persistent protocol (the framing
+        // assumes JSONL stdout); one-shot keeps the caller-requested mode.
+        args.push('--output-format', persistent ? 'stream-json' : (options.mode ?? 'text'));
         return { command: 'claude', args };
     },
     getAuthCommand: () => ({ command: 'claude', args: ['auth', 'status'] }),
+    persistentStdinProtocol: { frame: claudeStreamJsonFrame },
 };
 const codexShim = {
     name: 'codex',
@@ -82,11 +104,16 @@ const piShim = {
     getPromptCommand: (options) => {
         const args = [];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
+        const persistent = options.persistentStdin === true;
         // Session/pin path: durable — never ephemeral --no-session, never global -c.
-        if (!hasSession && options.continue !== true)
+        if (!hasSession && !persistent && options.continue !== true)
             args.push('--no-session');
-        args.push('-p', options.input ?? '');
-        if (!hasSession && options.continue === true)
+        // Persistent stdin: no -p positional (prompts arrive framed over stdin);
+        // rpc mode is the long-lived listener (verified headless probe + pi
+        // docs/rpc.md). It supersedes any text/json output mode.
+        if (!persistent)
+            args.push('-p', options.input ?? '');
+        if (!hasSession && !persistent && options.continue === true)
             args.push('-c');
         if (options.sessionDir !== undefined)
             args.push('--session-dir', options.sessionDir);
@@ -94,10 +121,11 @@ const piShim = {
             args.push('-r', options.sessionId);
         if (options.model !== undefined)
             args.push('--model', options.model);
-        args.push('--mode', options.mode ?? 'text');
+        args.push('--mode', persistent ? 'rpc' : (options.mode ?? 'text'));
         return { command: 'pi', args };
     },
     getAuthCommand: () => ({ command: 'pi', args: ['--list-models'] }),
+    persistentStdinProtocol: { frame: piRpcFrame },
 };
 const opencodeShim = {
     name: 'opencode',
@@ -206,11 +234,15 @@ const ompShim = {
     getPromptCommand: (options) => {
         const args = [];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
+        const persistent = options.persistentStdin === true;
         // Session/pin path: durable — never ephemeral --no-session, never global -c.
-        if (!hasSession && options.continue !== true)
+        if (!hasSession && !persistent && options.continue !== true)
             args.push('--no-session');
-        args.push('-p', options.input ?? '');
-        if (!hasSession && options.continue === true)
+        // Persistent stdin mirrors pi (omp is a pi fork; same rpc dialect) —
+        // verified `--mode rpc` in `omp --help` at the pi-compatible surface.
+        if (!persistent)
+            args.push('-p', options.input ?? '');
+        if (!hasSession && !persistent && options.continue === true)
             args.push('-c');
         if (options.sessionDir !== undefined)
             args.push('--session-dir', options.sessionDir);
@@ -218,10 +250,11 @@ const ompShim = {
             args.push('-r', options.sessionId);
         if (options.model !== undefined)
             args.push('--model', options.model);
-        args.push('--mode', options.mode ?? 'text');
+        args.push('--mode', persistent ? 'rpc' : (options.mode ?? 'text'));
         return { command: 'omp', args };
     },
     getAuthCommand: () => ({ command: 'omp', args: ['--list-models'] }),
+    persistentStdinProtocol: { frame: piRpcFrame },
 };
 /**
  * Grok Build CLI (`grok`) — xAI coding agent. Headless one-shot via `-p`/`--single`;
@@ -331,9 +364,10 @@ const AGENT_SESSION_CAPABILITY = {
         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',
+        // Persistent stdin is shim-wired: `-p --input-format stream-json --output-format
+        // stream-json` keeps the process alive reading JSONL envelopes (verified --help;
+        // --input-format only works with --print).
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate)',
     },
     codex: {
         supportsResumeById: true,

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

@@ -2,6 +2,7 @@ import { Buffer } from 'node:buffer';
 import { type EventBus, type Logger } from '@gobing-ai/ts-infra';
 import { type ProcessExecutor } from '@gobing-ai/ts-runtime';
 import type { AgentSpec } from './agent-spec';
+import type { StdinFrame } from './agents/shims';
 import type { AgentEvents } from './events';
 import { type QuotaAttribution } from './quota';
 /** Options for spawning a team agent subprocess. */
@@ -16,6 +17,11 @@ export interface AgentProcessOptions {
     events?: EventBus<AgentEvents>;
     /** Optional exact quota attribution; absent fields stay absent on observations — never inferred. */
     quotaContext?: QuotaAttribution;
+    /**
+     * Frames each sent prompt for the agent's persistent-stdin dialect (from
+     * the shim's `persistentStdinProtocol.frame`); absent = raw text + newline.
+     */
+    stdinFramer?: StdinFrame;
 }
 type ProcessStatus = 'running' | 'stopped' | 'errored';
 /**
@@ -38,6 +44,7 @@ export declare class TeamAgentProcess {
     private readonly quotaProducer;
     private readonly spec;
     private readonly quotaContext;
+    private readonly stdinFramer;
     constructor(options: AgentProcessOptions);
     start(): Promise<void>;
     stop(): Promise<void>;

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

@@ -1 +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,EAAE,KAAK,QAAQ,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAIH,KAAK,gBAAgB,EAExB,MAAM,SAAS,CAAC;AAEjB,oDAAoD;AACpD,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,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sHAAsH;IACtH,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,oGAAoG;IACpG,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,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,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,kGAAkG;IAClG,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,OAAO,EAAE,mBAAmB;IAYlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAerD,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;IAkBlB,sHAAsH;IACtH,OAAO,CAAC,gBAAgB;IAIxB,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,IAAI;CAOf"}
+{"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,EAAE,KAAK,QAAQ,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAIH,KAAK,gBAAgB,EAExB,MAAM,SAAS,CAAC;AAEjB,oDAAoD;AACpD,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,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sHAAsH;IACtH,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,oGAAoG;IACpG,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,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,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,kGAAkG;IAClG,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;gBAEzC,OAAO,EAAE,mBAAmB;IAalC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAerD,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;IAkBlB,sHAAsH;IACtH,OAAO,CAAC,gBAAgB;IAIxB,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,IAAI;CAOf"}

package/dist/team-agent-process.js

@@ -22,6 +22,7 @@ export class TeamAgentProcess {
     quotaProducer;
     spec;
     quotaContext;
+    stdinFramer;
     constructor(options) {
         this.agentId = options.spec.id;
         this.command = options.command;
@@ -32,6 +33,7 @@ export class TeamAgentProcess {
         this.quotaProducer = new QuotaObservationProducer(options.events);
         this.spec = options.spec;
         this.quotaContext = options.quotaContext;
+        this.stdinFramer = options.stdinFramer;
     }
     async start() {
         if (this.status === 'running')
@@ -95,7 +97,7 @@ export class TeamAgentProcess {
             return { ok: false };
         }
         try {
-            this.subprocess.writeStdin(`${message}\n`);
+            this.subprocess.writeStdin(this.stdinFramer !== undefined ? this.stdinFramer(message) : `${message}\n`);
             return { ok: true };
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-ai-runner",
-    "version": "0.4.68",
+    "version": "0.5.0",
     "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.68",
-        "@gobing-ai/ts-runtime": "^0.4.68"
+        "@gobing-ai/ts-infra": "^0.5.0",
+        "@gobing-ai/ts-runtime": "^0.5.0"
     },
     "devDependencies": {
         "@types/bun": "1.3.14",
-        "@gobing-ai/ts-db": "^0.4.68"
+        "@gobing-ai/ts-db": "^0.5.0"
     },
     "publishConfig": {
         "access": "public"

package/src/agents/shims.ts

@@ -66,8 +66,30 @@ export interface PromptOptions {
     taskId?: string;
     /** Peer agents included in the identity preamble. */
     peers?: Array<{ id: string; type: string; purpose?: string }>;
+    /**
+     * Request the agent's persistent-stdin dispatch: argv starts a long-lived
+     * process that reads framed prompts from stdin (one per line) instead of
+     * consuming a one-shot `-p <input>` and exiting. Only shims exposing a
+     * `persistentStdinProtocol` accept this — callers must consult
+     * {@link getAgentSessionCapability}.`supportsPersistentStdin` first. In
+     * persistent mode the shim omits `input` from argv entirely; the caller
+     * writes the identity preamble / prompts via the shim's `frame` (see
+     * `TeamAgentProcess` `stdinFramer`). rpc/stream-json modes supersede
+     * `mode` (the structured-output flag rides inside the protocol).
+     */
+    persistentStdin?: boolean;
 }
 
+/** Frames one user prompt as a single stdin line for a persistent-stdin dispatch. */
+export type StdinFrame = (input: string) => string;
+
+/** pi-family rpc dialect (pi docs/rpc.md): one JSON object per line. */
+const piRpcFrame: StdinFrame = (input) => `${JSON.stringify({ type: 'prompt', message: input })}\n`;
+
+/** claude stream-json input dialect: one user-message JSONL envelope per line. */
+const claudeStreamJsonFrame: StdinFrame = (input) =>
+    `${JSON.stringify({ type: 'user', message: { role: 'user', content: [{ type: 'text', text: input }] } })}\n`;
+
 /** Deprecation metadata attached to a retired or superseded agent shim. */
 export interface AgentDeprecation {
     /** Release date (ISO) when the id was marked deprecated. */
@@ -96,6 +118,13 @@ export interface AgentShim {
     getPromptCommand(options: PromptOptions): ShimCommand;
     /** Build an auth-status command, or null when unsupported. */
     getAuthCommand(): ShimCommand | null;
+    /**
+     * Persistent-stdin framing contract; present iff the shim wires a
+     * stdin-listener dispatch (mirrors `supportsPersistentStdin`). Callers
+     * frame every prompt (including the identity preamble) through it before
+     * writing to the process stdin.
+     */
+    readonly persistentStdinProtocol?: { readonly frame: StdinFrame };
 }
 
 const claudeShim: AgentShim = {
@@ -107,7 +136,22 @@ const claudeShim: AgentShim = {
     getPromptCommand: (options) => {
         // Headless dispatch cannot answer edit approval prompts. Keep the grant
         // scoped to file edits; shell and broader tools remain gated.
-        const args = ['-p', options.input ?? '', '--permission-mode', 'acceptEdits', '--allowedTools', 'Write', 'Edit'];
+        // Persistent stdin rides the print path: `--input-format` only works
+        // with --print, and stream-json input keeps the process alive reading
+        // JSONL envelopes until stdin closes (verified --help, CLI 2.1.274).
+        const persistent = options.persistentStdin === true;
+        const args = persistent
+            ? [
+                  '-p',
+                  '--input-format',
+                  'stream-json',
+                  '--permission-mode',
+                  'acceptEdits',
+                  '--allowedTools',
+                  'Write',
+                  'Edit',
+              ]
+            : ['-p', options.input ?? '', '--permission-mode', 'acceptEdits', '--allowedTools', 'Write', 'Edit'];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
         if (hasSession) {
             // Session/pin path — never emit --continue. Claude has no session-dir
@@ -117,10 +161,13 @@ const claudeShim: AgentShim = {
             args.push('--continue');
         }
         if (options.model !== undefined) args.push('--model', options.model);
-        args.push('--output-format', options.mode ?? 'text');
+        // stream-json output is part of the persistent protocol (the framing
+        // assumes JSONL stdout); one-shot keeps the caller-requested mode.
+        args.push('--output-format', persistent ? 'stream-json' : (options.mode ?? 'text'));
         return { command: 'claude', args };
     },
     getAuthCommand: () => ({ command: 'claude', args: ['auth', 'status'] }),
+    persistentStdinProtocol: { frame: claudeStreamJsonFrame },
 };
 
 const codexShim: AgentShim = {
@@ -178,17 +225,22 @@ const piShim: AgentShim = {
     getPromptCommand: (options) => {
         const args: string[] = [];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
+        const persistent = options.persistentStdin === true;
         // Session/pin path: durable — never ephemeral --no-session, never global -c.
-        if (!hasSession && options.continue !== true) args.push('--no-session');
-        args.push('-p', options.input ?? '');
-        if (!hasSession && options.continue === true) args.push('-c');
+        if (!hasSession && !persistent && options.continue !== true) args.push('--no-session');
+        // Persistent stdin: no -p positional (prompts arrive framed over stdin);
+        // rpc mode is the long-lived listener (verified headless probe + pi
+        // docs/rpc.md). It supersedes any text/json output mode.
+        if (!persistent) args.push('-p', options.input ?? '');
+        if (!hasSession && !persistent && options.continue === true) args.push('-c');
         if (options.sessionDir !== undefined) args.push('--session-dir', options.sessionDir);
         if (options.sessionId !== undefined) args.push('-r', options.sessionId);
         if (options.model !== undefined) args.push('--model', options.model);
-        args.push('--mode', options.mode ?? 'text');
+        args.push('--mode', persistent ? 'rpc' : (options.mode ?? 'text'));
         return { command: 'pi', args };
     },
     getAuthCommand: () => ({ command: 'pi', args: ['--list-models'] }),
+    persistentStdinProtocol: { frame: piRpcFrame },
 };
 
 const opencodeShim: AgentShim = {
@@ -292,17 +344,21 @@ const ompShim: AgentShim = {
     getPromptCommand: (options) => {
         const args: string[] = [];
         const hasSession = options.sessionId !== undefined || options.sessionDir !== undefined;
+        const persistent = options.persistentStdin === true;
         // Session/pin path: durable — never ephemeral --no-session, never global -c.
-        if (!hasSession && options.continue !== true) args.push('--no-session');
-        args.push('-p', options.input ?? '');
-        if (!hasSession && options.continue === true) args.push('-c');
+        if (!hasSession && !persistent && options.continue !== true) args.push('--no-session');
+        // Persistent stdin mirrors pi (omp is a pi fork; same rpc dialect) —
+        // verified `--mode rpc` in `omp --help` at the pi-compatible surface.
+        if (!persistent) args.push('-p', options.input ?? '');
+        if (!hasSession && !persistent && options.continue === true) args.push('-c');
         if (options.sessionDir !== undefined) args.push('--session-dir', options.sessionDir);
         if (options.sessionId !== undefined) args.push('-r', options.sessionId);
         if (options.model !== undefined) args.push('--model', options.model);
-        args.push('--mode', options.mode ?? 'text');
+        args.push('--mode', persistent ? 'rpc' : (options.mode ?? 'text'));
         return { command: 'omp', args };
     },
     getAuthCommand: () => ({ command: 'omp', args: ['--list-models'] }),
+    persistentStdinProtocol: { frame: piRpcFrame },
 };
 
 /**
@@ -429,9 +485,10 @@ const AGENT_SESSION_CAPABILITY: Readonly<Record<AgentName, AgentSessionCapabilit
         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',
+        // Persistent stdin is shim-wired: `-p --input-format stream-json --output-format
+        // stream-json` keeps the process alive reading JSONL envelopes (verified --help;
+        // --input-format only works with --print).
+        note: 'no session-dir flag — sessionDir is ignored (best-effort isolate)',
     },
     codex: {
         supportsResumeById: true,

package/src/team-agent-process.ts

@@ -2,6 +2,7 @@ import { Buffer } from 'node:buffer';
 import { type EventBus, getLogger, type Logger } from '@gobing-ai/ts-infra';
 import { nodeBunFactory, type PipeProcess, type ProcessExecutor } from '@gobing-ai/ts-runtime';
 import type { AgentSpec } from './agent-spec';
+import type { StdinFrame } from './agents/shims';
 import type { AgentEvents } from './events';
 import {
     buildQuotaObservation,
@@ -23,6 +24,11 @@ export interface AgentProcessOptions {
     events?: EventBus<AgentEvents>;
     /** Optional exact quota attribution; absent fields stay absent on observations — never inferred. */
     quotaContext?: QuotaAttribution;
+    /**
+     * Frames each sent prompt for the agent's persistent-stdin dialect (from
+     * the shim's `persistentStdinProtocol.frame`); absent = raw text + newline.
+     */
+    stdinFramer?: StdinFrame;
 }
 
 type ProcessStatus = 'running' | 'stopped' | 'errored';
@@ -47,6 +53,7 @@ export class TeamAgentProcess {
     private readonly quotaProducer: QuotaObservationProducer;
     private readonly spec: AgentSpec;
     private readonly quotaContext: QuotaAttribution | undefined;
+    private readonly stdinFramer: StdinFrame | undefined;
 
     constructor(options: AgentProcessOptions) {
         this.agentId = options.spec.id;
@@ -58,6 +65,7 @@ export class TeamAgentProcess {
         this.quotaProducer = new QuotaObservationProducer(options.events);
         this.spec = options.spec;
         this.quotaContext = options.quotaContext;
+        this.stdinFramer = options.stdinFramer;
     }
 
     async start(): Promise<void> {
@@ -117,7 +125,7 @@ export class TeamAgentProcess {
             return { ok: false };
         }
         try {
-            this.subprocess.writeStdin(`${message}\n`);
+            this.subprocess.writeStdin(this.stdinFramer !== undefined ? this.stdinFramer(message) : `${message}\n`);
             return { ok: true };
         } catch (error) {
             this.warn('stdin write failed', 'send.writeStdin', error);