subharness 0.0.3 → 0.0.4

package/dist/cli/dashboard.js

@@ -1,8 +1,8 @@
-import { setTimeout as delay } from 'node:timers/promises';
 import { AgentError } from '../errors.js';
 import { resolveDashboardWorkspace } from '../runtime/dashboard-workspace.js';
 import { readEndpoint, stateDirectory } from '../runtime/state.js';
-import { fetchDashboardSnapshot } from './dashboard-client.js';
+import { fetchDashboardDetail, fetchDashboardSession, fetchDashboardSnapshot } from './dashboard-client.js';
+import { DashboardKeyDecoder } from './dashboard-input.js';
 import { DashboardRenderer } from './dashboard-renderer.js';
 export async function runDashboard(options = {}) {
     const output = options.output ?? process.stdout;
@@ -16,21 +16,106 @@ export async function runDashboard(options = {}) {
     const signals = options.signals ?? process;
     const discover = options.discover ?? (() => readEndpoint(stateDirectory()));
     const snapshot = options.snapshot ?? fetchDashboardSnapshot;
+    const detail = options.detail ?? fetchDashboardDetail;
+    const session = options.session ?? fetchDashboardSession;
     const interval = options.intervalMs ?? 1_000;
     const abort = new AbortController();
-    const renderer = new DashboardRenderer(output, await resolveDashboardWorkspace(options.cwd ?? process.cwd()));
+    const workspace = await resolveDashboardWorkspace(options.cwd ?? process.cwd());
     let rows = [];
     let endpoint;
     let exitCode = 0;
     let outputError;
-    const interrupt = () => { exitCode = 130; abort.abort(); };
-    const terminate = () => { exitCode = 143; abort.abort(); };
-    const keys = (chunk) => {
-        if (typeof chunk === 'string' ? chunk.includes('\u0003') : chunk.includes(3))
+    let detailAbort;
+    let wake;
+    const stop = (code) => {
+        exitCode = code;
+        detailAbort?.abort();
+        abort.abort();
+        wake?.();
+    };
+    const failedOutput = (error) => {
+        outputError ??= error;
+        detailAbort?.abort();
+        abort.abort();
+        wake?.();
+    };
+    // Event listeners and the decoder's Escape timer run outside the polling try/finally.
+    const guarded = (callback) => (...args) => {
+        if (abort.signal.aborted)
+            return;
+        try {
+            callback(...args);
+        }
+        catch (error) {
+            failedOutput(error);
+        }
+    };
+    const renderer = new DashboardRenderer(output, workspace, !process.env.NO_COLOR, failedOutput);
+    const interrupt = () => stop(130);
+    const terminate = () => stop(143);
+    const key = (pressed) => {
+        if (pressed === 'interrupt') {
             interrupt();
+            return;
+        }
+        if (pressed === 'escape') {
+            if (renderer.leaveDetail()) {
+                detailAbort?.abort();
+                detailAbort = undefined;
+                wake?.();
+            }
+            return;
+        }
+        if (pressed === 'enter') {
+            if (renderer.inspecting ? renderer.toggleExpansion() : renderer.openDetail()) {
+                detailAbort?.abort();
+                detailAbort = new AbortController();
+                wake?.();
+            }
+            return;
+        }
+        if (pressed === 'up' || pressed === 'down') {
+            if (renderer.inspecting) {
+                const expanded = renderer.expandedTaskId;
+                renderer.scrollDetail(pressed);
+                if (expanded !== renderer.expandedTaskId) {
+                    detailAbort?.abort();
+                    detailAbort = new AbortController();
+                    wake?.();
+                }
+            }
+            else
+                renderer.moveSelection(pressed === 'up' ? -1 : 1);
+            return;
+        }
+        if (renderer.inspecting)
+            renderer.scrollDetail(pressed);
+    };
+    const decoder = new DashboardKeyDecoder(guarded(key));
+    const keys = guarded((chunk) => decoder.push(chunk));
+    const resize = guarded(() => renderer.render(rows, Date.now()));
+    const waitForRefresh = (milliseconds) => {
+        if (abort.signal.aborted)
+            return Promise.resolve();
+        return new Promise(resolve => {
+            let timer;
+            const done = () => {
+                if (timer)
+                    clearTimeout(timer);
+                abort.signal.removeEventListener('abort', done);
+                if (wake === done)
+                    wake = undefined;
+                resolve();
+            };
+            abort.signal.addEventListener('abort', done, { once: true });
+            if (abort.signal.aborted) {
+                done();
+                return;
+            }
+            timer = setTimeout(done, milliseconds);
+            wake = done;
+        });
     };
-    const resize = () => renderer.render(rows, Date.now());
-    const failedOutput = (error) => { outputError = error; abort.abort(); };
     signals.on('SIGINT', interrupt);
     signals.on('SIGTERM', terminate);
     output.on('resize', resize);
@@ -48,12 +133,35 @@ export async function runDashboard(options = {}) {
             endpoint ??= await discover();
             if (abort.signal.aborted)
                 break;
-            if (endpoint)
+            if (endpoint && !renderer.inspecting)
                 rows = (await snapshot(endpoint, abort.signal)).sessions;
             if (abort.signal.aborted)
                 break;
             renderer.render(rows, Date.now());
-            await delay(Math.max(0, next - Date.now()), undefined, { signal: abort.signal });
+            const inspectionId = renderer.inspectedTaskId;
+            const inspectionAbort = detailAbort;
+            if (endpoint && inspectionId && inspectionAbort) {
+                try {
+                    const signal = AbortSignal.any([abort.signal, inspectionAbort.signal]);
+                    const history = await session(endpoint, inspectionId, signal);
+                    if (abort.signal.aborted || detailAbort !== inspectionAbort || renderer.inspectedTaskId !== inspectionId)
+                        continue;
+                    renderer.updateSession(history);
+                    const expandedId = renderer.expandedTaskId;
+                    if (expandedId) {
+                        const record = await detail(endpoint, expandedId, signal, !renderer.detailLoaded, renderer.knownResponseId);
+                        if (!abort.signal.aborted && detailAbort === inspectionAbort && renderer.expandedTaskId === expandedId) {
+                            renderer.updateDetail(record);
+                        }
+                    }
+                }
+                catch (error) {
+                    if (detailAbort !== inspectionAbort || renderer.inspectedTaskId !== inspectionId)
+                        continue;
+                    throw error;
+                }
+            }
+            await waitForRefresh(Math.max(0, next - Date.now()));
         }
     }
     catch (error) {
@@ -62,7 +170,14 @@ export async function runDashboard(options = {}) {
     }
     finally {
         abort.abort();
-        renderer.close();
+        detailAbort?.abort();
+        decoder.close();
+        try {
+            renderer.close();
+        }
+        catch (error) {
+            outputError ??= error;
+        }
         if (inputEnabled) {
             input.off('data', keys);
             input.setRawMode(wasRaw);

package/dist/cli/dashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/cli/dashboard.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventEmitter } from 'node:events';\nimport { setTimeout as delay } from 'node:timers/promises';\nimport { AgentError } from '../errors.js';\nimport type { DashboardRow, DashboardSnapshot } from '../runtime/dashboard.js';\nimport { resolveDashboardWorkspace } from '../runtime/dashboard-workspace.js';\nimport { readEndpoint, stateDirectory, type Endpoint } from '../runtime/state.js';\nimport { fetchDashboardSnapshot } from './dashboard-client.js';\nimport { DashboardRenderer, type DashboardOutput } from './dashboard-renderer.js';\n\ninterface Terminal extends DashboardOutput {\n  isTTY?: boolean;\n  on(event: 'drain' | 'resize' | 'error', listener: (...args: any[]) => void): unknown;\n  off(event: 'drain' | 'resize' | 'error', listener: (...args: any[]) => void): unknown;\n}\ninterface Keyboard {\n  isTTY?: boolean;\n  isRaw?: boolean;\n  readableFlowing: boolean | null;\n  setRawMode(enabled: boolean): unknown;\n  resume(): unknown;\n  pause(): unknown;\n  on(event: 'data', listener: (chunk: Buffer | string) => void): unknown;\n  off(event: 'data', listener: (chunk: Buffer | string) => void): unknown;\n}\ninterface DashboardOptions {\n  cwd?: string;\n  output?: Terminal;\n  input?: Keyboard;\n  signals?: Pick<EventEmitter, 'on' | 'off'>;\n  term?: string;\n  intervalMs?: number;\n  discover?: () => Promise<Endpoint | undefined>;\n  snapshot?: (endpoint: Endpoint, signal: AbortSignal) => Promise<DashboardSnapshot>;\n}\n\nexport async function runDashboard(options: DashboardOptions = {}): Promise<number> {\n  const output = options.output ?? process.stdout;\n  if (!output.isTTY || (options.term ?? process.env.TERM) === 'dumb') {\n    throw new AgentError('INVALID_ARGUMENT', 'The dashboard requires terminal stdout with cursor control.');\n  }\n  const input = options.input ?? process.stdin;\n  const wasRaw = input.isRaw ?? false;\n  const wasFlowing = input.readableFlowing === true;\n  let inputEnabled = false;\n  const signals = options.signals ?? process;\n  const discover = options.discover ?? (() => readEndpoint(stateDirectory()));\n  const snapshot = options.snapshot ?? fetchDashboardSnapshot;\n  const interval = options.intervalMs ?? 1_000;\n  const abort = new AbortController();\n  const renderer = new DashboardRenderer(output, await resolveDashboardWorkspace(options.cwd ?? process.cwd()));\n  let rows: DashboardRow[] = [];\n  let endpoint: Endpoint | undefined;\n  let exitCode = 0;\n  let outputError: unknown;\n  const interrupt = () => { exitCode = 130; abort.abort(); };\n  const terminate = () => { exitCode = 143; abort.abort(); };\n  const keys = (chunk: Buffer | string) => {\n    if (typeof chunk === 'string' ? chunk.includes('\\u0003') : chunk.includes(3)) interrupt();\n  };\n  const resize = () => renderer.render(rows, Date.now());\n  const failedOutput = (error: unknown) => { outputError = error; abort.abort(); };\n  signals.on('SIGINT', interrupt);\n  signals.on('SIGTERM', terminate);\n  output.on('resize', resize);\n  output.on('error', failedOutput);\n  try {\n    if (input.isTTY) {\n      input.setRawMode(true);\n      inputEnabled = true;\n      input.on('data', keys);\n      input.resume();\n    }\n    renderer.start();\n    while (!abort.signal.aborted) {\n      const next = Date.now() + interval;\n      endpoint ??= await discover();\n      if (abort.signal.aborted) break;\n      if (endpoint) rows = (await snapshot(endpoint, abort.signal)).sessions;\n      if (abort.signal.aborted) break;\n      renderer.render(rows, Date.now());\n      await delay(Math.max(0, next - Date.now()), undefined, {signal: abort.signal});\n    }\n  } catch (error) {\n    if (!abort.signal.aborted) throw error;\n  } finally {\n    abort.abort();\n    renderer.close();\n    if (inputEnabled) {\n      input.off('data', keys);\n      input.setRawMode(wasRaw);\n      if (!wasFlowing) input.pause();\n    }\n    signals.off('SIGINT', interrupt);\n    signals.off('SIGTERM', terminate);\n    output.off('resize', resize);\n    output.off('error', failedOutput);\n  }\n  if (outputError) throw new AgentError('INTERNAL', 'The dashboard terminal output failed.');\n  return exitCode;\n}\n"]}
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/cli/dashboard.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventEmitter } from 'node:events';\nimport { AgentError } from '../errors.js';\nimport type { DashboardDetail, DashboardRow, DashboardSession, DashboardSnapshot } from '../runtime/dashboard.js';\nimport { resolveDashboardWorkspace } from '../runtime/dashboard-workspace.js';\nimport { readEndpoint, stateDirectory, type Endpoint } from '../runtime/state.js';\nimport { fetchDashboardDetail, fetchDashboardSession, fetchDashboardSnapshot } from './dashboard-client.js';\nimport { DashboardKeyDecoder, type DashboardKey } from './dashboard-input.js';\nimport { DashboardRenderer, type DashboardOutput } from './dashboard-renderer.js';\n\ninterface Terminal extends DashboardOutput {\n  isTTY?: boolean;\n  on(event: 'drain' | 'resize' | 'error', listener: (...args: any[]) => void): unknown;\n  off(event: 'drain' | 'resize' | 'error', listener: (...args: any[]) => void): unknown;\n}\ninterface Keyboard {\n  isTTY?: boolean;\n  isRaw?: boolean;\n  readableFlowing: boolean | null;\n  setRawMode(enabled: boolean): unknown;\n  resume(): unknown;\n  pause(): unknown;\n  on(event: 'data', listener: (chunk: Buffer | string) => void): unknown;\n  off(event: 'data', listener: (chunk: Buffer | string) => void): unknown;\n}\ninterface DashboardOptions {\n  cwd?: string;\n  output?: Terminal;\n  input?: Keyboard;\n  signals?: Pick<EventEmitter, 'on' | 'off'>;\n  term?: string;\n  intervalMs?: number;\n  discover?: () => Promise<Endpoint | undefined>;\n  snapshot?: (endpoint: Endpoint, signal: AbortSignal) => Promise<DashboardSnapshot>;\n  session?: (endpoint: Endpoint, id: string, signal: AbortSignal) => Promise<DashboardSession>;\n  detail?: (\n    endpoint: Endpoint,\n    id: string,\n    signal: AbortSignal,\n    includePrompt?: boolean,\n    knownResponseId?: string,\n  ) => Promise<DashboardDetail>;\n}\n\nexport async function runDashboard(options: DashboardOptions = {}): Promise<number> {\n  const output = options.output ?? process.stdout;\n  if (!output.isTTY || (options.term ?? process.env.TERM) === 'dumb') {\n    throw new AgentError('INVALID_ARGUMENT', 'The dashboard requires terminal stdout with cursor control.');\n  }\n  const input = options.input ?? process.stdin;\n  const wasRaw = input.isRaw ?? false;\n  const wasFlowing = input.readableFlowing === true;\n  let inputEnabled = false;\n  const signals = options.signals ?? process;\n  const discover = options.discover ?? (() => readEndpoint(stateDirectory()));\n  const snapshot = options.snapshot ?? fetchDashboardSnapshot;\n  const detail = options.detail ?? fetchDashboardDetail;\n  const session = options.session ?? fetchDashboardSession;\n  const interval = options.intervalMs ?? 1_000;\n  const abort = new AbortController();\n  const workspace = await resolveDashboardWorkspace(options.cwd ?? process.cwd());\n  let rows: DashboardRow[] = [];\n  let endpoint: Endpoint | undefined;\n  let exitCode = 0;\n  let outputError: unknown;\n  let detailAbort: AbortController | undefined;\n  let wake: (() => void) | undefined;\n  const stop = (code: number) => {\n    exitCode = code;\n    detailAbort?.abort();\n    abort.abort();\n    wake?.();\n  };\n  const failedOutput = (error: unknown) => {\n    outputError ??= error;\n    detailAbort?.abort();\n    abort.abort();\n    wake?.();\n  };\n  // Event listeners and the decoder's Escape timer run outside the polling try/finally.\n  const guarded = <Arguments extends unknown[]>(callback: (...args: Arguments) => void) => (...args: Arguments) => {\n    if (abort.signal.aborted) return;\n    try { callback(...args); } catch (error) { failedOutput(error); }\n  };\n  const renderer = new DashboardRenderer(output, workspace, !process.env.NO_COLOR, failedOutput);\n  const interrupt = () => stop(130);\n  const terminate = () => stop(143);\n  const key = (pressed: DashboardKey) => {\n    if (pressed === 'interrupt') { interrupt(); return; }\n    if (pressed === 'escape') {\n      if (renderer.leaveDetail()) {\n        detailAbort?.abort();\n        detailAbort = undefined;\n        wake?.();\n      }\n      return;\n    }\n    if (pressed === 'enter') {\n      if (renderer.inspecting ? renderer.toggleExpansion() : renderer.openDetail()) {\n        detailAbort?.abort();\n        detailAbort = new AbortController();\n        wake?.();\n      }\n      return;\n    }\n    if (pressed === 'up' || pressed === 'down') {\n      if (renderer.inspecting) {\n        const expanded = renderer.expandedTaskId;\n        renderer.scrollDetail(pressed);\n        if (expanded !== renderer.expandedTaskId) {\n          detailAbort?.abort(); detailAbort = new AbortController(); wake?.();\n        }\n      }\n      else renderer.moveSelection(pressed === 'up' ? -1 : 1);\n      return;\n    }\n    if (renderer.inspecting) renderer.scrollDetail(pressed);\n  };\n  const decoder = new DashboardKeyDecoder(guarded(key));\n  const keys = guarded((chunk: Buffer | string) => decoder.push(chunk));\n  const resize = guarded(() => renderer.render(rows, Date.now()));\n  const waitForRefresh = (milliseconds: number): Promise<void> => {\n    if (abort.signal.aborted) return Promise.resolve();\n    return new Promise<void>(resolve => {\n      let timer: NodeJS.Timeout | undefined;\n      const done = () => {\n        if (timer) clearTimeout(timer);\n        abort.signal.removeEventListener('abort', done);\n        if (wake === done) wake = undefined;\n        resolve();\n      };\n      abort.signal.addEventListener('abort', done, {once: true});\n      if (abort.signal.aborted) { done(); return; }\n      timer = setTimeout(done, milliseconds);\n      wake = done;\n    });\n  };\n  signals.on('SIGINT', interrupt);\n  signals.on('SIGTERM', terminate);\n  output.on('resize', resize);\n  output.on('error', failedOutput);\n  try {\n    if (input.isTTY) {\n      input.setRawMode(true);\n      inputEnabled = true;\n      input.on('data', keys);\n      input.resume();\n    }\n    renderer.start();\n    while (!abort.signal.aborted) {\n      const next = Date.now() + interval;\n      endpoint ??= await discover();\n      if (abort.signal.aborted) break;\n      if (endpoint && !renderer.inspecting) rows = (await snapshot(endpoint, abort.signal)).sessions;\n      if (abort.signal.aborted) break;\n      renderer.render(rows, Date.now());\n      const inspectionId = renderer.inspectedTaskId;\n      const inspectionAbort = detailAbort;\n      if (endpoint && inspectionId && inspectionAbort) {\n        try {\n          const signal = AbortSignal.any([abort.signal, inspectionAbort.signal]);\n          const history = await session(endpoint, inspectionId, signal);\n          if (abort.signal.aborted || detailAbort !== inspectionAbort || renderer.inspectedTaskId !== inspectionId) continue;\n          renderer.updateSession(history);\n          const expandedId = renderer.expandedTaskId;\n          if (expandedId) {\n            const record = await detail(endpoint, expandedId, signal, !renderer.detailLoaded, renderer.knownResponseId);\n            if (!abort.signal.aborted && detailAbort === inspectionAbort && renderer.expandedTaskId === expandedId) {\n              renderer.updateDetail(record);\n            }\n          }\n        } catch (error) {\n          if (detailAbort !== inspectionAbort || renderer.inspectedTaskId !== inspectionId) continue;\n          throw error;\n        }\n      }\n      await waitForRefresh(Math.max(0, next - Date.now()));\n    }\n  } catch (error) {\n    if (!abort.signal.aborted) throw error;\n  } finally {\n    abort.abort();\n    detailAbort?.abort();\n    decoder.close();\n    try { renderer.close(); } catch (error) { outputError ??= error; }\n    if (inputEnabled) {\n      input.off('data', keys);\n      input.setRawMode(wasRaw);\n      if (!wasFlowing) input.pause();\n    }\n    signals.off('SIGINT', interrupt);\n    signals.off('SIGTERM', terminate);\n    output.off('resize', resize);\n    output.off('error', failedOutput);\n  }\n  if (outputError) throw new AgentError('INTERNAL', 'The dashboard terminal output failed.');\n  return exitCode;\n}\n"]}

package/dist/cli/help.js

@@ -16,6 +16,8 @@ Usage:
   subharness queue <session-id>
   subharness cancel <task-id>
   subharness resume <session-id>
+  subharness respond <request-id> --content <json>
+  subharness respond <request-id> --content-file <path|->
 
 Direct harness targets: codex, claude, fx. These bare names are reserved; same-named specialists require repo: or global:.
 Specialist targets: repo:<name>, global:<name>, or an unambiguous bare name.
@@ -24,6 +26,11 @@ Run "subharness run <harness> --help" or "subharness check <harness> --help" for
 Execution commands accept --format text|jsonl; text is the default.
 Omit --after to wait for the first retained response; supply it to wait for the next response.
 Detach after admission with --detach, then use wait or status; steering cannot be detached.
+Permission requests return approval_required with a request-specific schema. Inspect the action and scope,
+respond with one JSON object matching that schema (at most 16 KiB), then wait on the same task.
+Each request offers its own choices; never invent a universal allow/deny value or assume "always" is permanent.
+Denial uses an offered rejection choice. Use cancel to stop the task; resume does not answer permissions.
+Approval content files resolve from the caller's working directory; - reads standard input.
 Dashboard is a terminal-only read-only view and accepts no options.
 --help and --version do not start a coordinator or native harness.
 Use -- to pass a positional prompt beginning with a dash.

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnB,CAAC;AAEF,MAAM,OAAO,GAA0E;IACrF,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,wEAAwE;QAChF,MAAM,EAAE,mGAAmG;KAC5G;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,8EAA8E;QACtF,MAAM,EAAE,yDAAyD;KAClE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,oEAAoE;QAC5E,MAAM,EAAE,gGAAgG;KACzG;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAuB,EAAE,OAAO,GAAoB,KAAK;IAClF,IAAI,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,oBAAoB,MAAM,CAAC,IAAI,mBAAmB,MAAM,CAAC,IAAI;;;qBAG1E,MAAM,CAAC,IAAI;;;;;;;;;;;EAW9B,MAAM,CAAC,MAAM;EACb,MAAM,CAAC,MAAM;;CAEd,CAAC;IACA,OAAO,kBAAkB,MAAM,CAAC,IAAI,qBAAqB,MAAM,CAAC,IAAI;;;mBAGnD,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;;;;;;;;;;;;EAY5B,MAAM,CAAC,MAAM;EACb,MAAM,CAAC,MAAM;;CAEd,CAAC;AACF,CAAC","sourcesContent":["type DirectHarness = 'codex' | 'claudeCode' | 'fx';\n\nconst GLOBAL_HELP = `subharness — coordinate external coding agents\n\nUsage:\n  subharness list [--cwd <directory>]\n  subharness dashboard\n  subharness check <target> [--cwd <directory>] [--format text|jsonl]\n  subharness check <harness> [--cwd <directory>] [--model <model>] [--effort <effort>] [--format text|jsonl]\n  subharness run <target> [options] [--detach] <prompt>\n  subharness run <target> [options] [--detach] --prompt <text>\n  subharness run <target> [options] [--detach] --prompt-file <path|->\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] <prompt>\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] --prompt <text>\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] --prompt-file <path|->\n  subharness wait <task-id> [--after <response-id>]\n  subharness status <task-id> [--full]\n  subharness queue <session-id>\n  subharness cancel <task-id>\n  subharness resume <session-id>\n\nDirect harness targets: codex, claude, fx. These bare names are reserved; same-named specialists require repo: or global:.\nSpecialist targets: repo:<name>, global:<name>, or an unambiguous bare name.\nDeclared child targets: subagent:<name>, resolved only from the active managed parent's declarations.\nRun \"subharness run <harness> --help\" or \"subharness check <harness> --help\" for harness-specific options.\nExecution commands accept --format text|jsonl; text is the default.\nOmit --after to wait for the first retained response; supply it to wait for the next response.\nDetach after admission with --detach, then use wait or status; steering cannot be detached.\nDashboard is a terminal-only read-only view and accepts no options.\n--help and --version do not start a coordinator or native harness.\nUse -- to pass a positional prompt beginning with a dash.\nagent is an identical compatibility alias for subharness.\n`;\n\nconst details: Record<DirectHarness, {name: string; access: string; effort: string}> = {\n  codex: {\n    name: 'codex',\n    access: 'Requires an installed Codex executable and eligible configured access.',\n    effort: 'Codex accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n  claudeCode: {\n    name: 'claude',\n    access: 'Requires an installed Claude Code executable and eligible configured access.',\n    effort: 'Claude effort must be low, medium, high, xhigh, or max.',\n  },\n  fx: {\n    name: 'fx',\n    access: 'Requires an installed fx executable and configured Gateway access.',\n    effort: 'fx accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n};\n\nexport function renderHelp(harness?: DirectHarness, command: 'run' | 'check' = 'run'): string {\n  if (!harness) return GLOBAL_HELP;\n  const target = details[harness];\n  if (command === 'check') return `subharness check ${target.name} — check direct ${target.name} startup readiness\n\nUsage:\n  subharness check ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] [--format text|jsonl]\n\nOptions:\n  --cwd <directory>    Execution directory for the startup check\n  --model <model>      Native model identifier\n  --effort <effort>    Native effort identifier\n  --format text|jsonl  Output format (text by default)\n\nThe check opens and closes an isolated native session without submitting a turn.\nReadiness covers startup at that moment, not quota, task success, native permissions, or continued availability.\nOmitting --model or --effort uses the verifiable native default for the selected access route.\n${target.effort}\n${target.access}\nNative harness flags are not forwarded; unsupported options are errors.\n`;\n  return `subharness run ${target.name} — start a direct ${target.name} session\n\nUsage:\n  subharness run ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] <prompt>\n  subharness run ${target.name} [options] --prompt <text>\n  subharness run ${target.name} [options] --prompt-file <path|->\n\nOptions:\n  --cwd <directory>       Execution directory for the new session\n  --model <model>         Native model identifier\n  --effort <effort>       Native effort identifier\n  --prompt <text>         Prompt text\n  --prompt-file <path|->  Read the prompt from a UTF-8 file or stdin\n  --detach                Return after admission without observing a response\n  --format text|jsonl     Output format (text by default)\n\nOmitting --model or --effort uses the verifiable native default for the selected access route.\n${target.effort}\n${target.access}\nNative harness flags are not forwarded; unsupported options are errors.\n`;\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnB,CAAC;AAEF,MAAM,OAAO,GAA0E;IACrF,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,wEAAwE;QAChF,MAAM,EAAE,mGAAmG;KAC5G;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,8EAA8E;QACtF,MAAM,EAAE,yDAAyD;KAClE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,oEAAoE;QAC5E,MAAM,EAAE,gGAAgG;KACzG;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAuB,EAAE,OAAO,GAAoB,KAAK;IAClF,IAAI,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,oBAAoB,MAAM,CAAC,IAAI,mBAAmB,MAAM,CAAC,IAAI;;;qBAG1E,MAAM,CAAC,IAAI;;;;;;;;;;;EAW9B,MAAM,CAAC,MAAM;EACb,MAAM,CAAC,MAAM;;CAEd,CAAC;IACA,OAAO,kBAAkB,MAAM,CAAC,IAAI,qBAAqB,MAAM,CAAC,IAAI;;;mBAGnD,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;;;;;;;;;;;;EAY5B,MAAM,CAAC,MAAM;EACb,MAAM,CAAC,MAAM;;CAEd,CAAC;AACF,CAAC","sourcesContent":["type DirectHarness = 'codex' | 'claudeCode' | 'fx';\n\nconst GLOBAL_HELP = `subharness — coordinate external coding agents\n\nUsage:\n  subharness list [--cwd <directory>]\n  subharness dashboard\n  subharness check <target> [--cwd <directory>] [--format text|jsonl]\n  subharness check <harness> [--cwd <directory>] [--model <model>] [--effort <effort>] [--format text|jsonl]\n  subharness run <target> [options] [--detach] <prompt>\n  subharness run <target> [options] [--detach] --prompt <text>\n  subharness run <target> [options] [--detach] --prompt-file <path|->\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] <prompt>\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] --prompt <text>\n  subharness send <session-id> [--delivery queue|steer|interrupt] [--detach] --prompt-file <path|->\n  subharness wait <task-id> [--after <response-id>]\n  subharness status <task-id> [--full]\n  subharness queue <session-id>\n  subharness cancel <task-id>\n  subharness resume <session-id>\n  subharness respond <request-id> --content <json>\n  subharness respond <request-id> --content-file <path|->\n\nDirect harness targets: codex, claude, fx. These bare names are reserved; same-named specialists require repo: or global:.\nSpecialist targets: repo:<name>, global:<name>, or an unambiguous bare name.\nDeclared child targets: subagent:<name>, resolved only from the active managed parent's declarations.\nRun \"subharness run <harness> --help\" or \"subharness check <harness> --help\" for harness-specific options.\nExecution commands accept --format text|jsonl; text is the default.\nOmit --after to wait for the first retained response; supply it to wait for the next response.\nDetach after admission with --detach, then use wait or status; steering cannot be detached.\nPermission requests return approval_required with a request-specific schema. Inspect the action and scope,\nrespond with one JSON object matching that schema (at most 16 KiB), then wait on the same task.\nEach request offers its own choices; never invent a universal allow/deny value or assume \"always\" is permanent.\nDenial uses an offered rejection choice. Use cancel to stop the task; resume does not answer permissions.\nApproval content files resolve from the caller's working directory; - reads standard input.\nDashboard is a terminal-only read-only view and accepts no options.\n--help and --version do not start a coordinator or native harness.\nUse -- to pass a positional prompt beginning with a dash.\nagent is an identical compatibility alias for subharness.\n`;\n\nconst details: Record<DirectHarness, {name: string; access: string; effort: string}> = {\n  codex: {\n    name: 'codex',\n    access: 'Requires an installed Codex executable and eligible configured access.',\n    effort: 'Codex accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n  claudeCode: {\n    name: 'claude',\n    access: 'Requires an installed Claude Code executable and eligible configured access.',\n    effort: 'Claude effort must be low, medium, high, xhigh, or max.',\n  },\n  fx: {\n    name: 'fx',\n    access: 'Requires an installed fx executable and configured Gateway access.',\n    effort: 'fx accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n};\n\nexport function renderHelp(harness?: DirectHarness, command: 'run' | 'check' = 'run'): string {\n  if (!harness) return GLOBAL_HELP;\n  const target = details[harness];\n  if (command === 'check') return `subharness check ${target.name} — check direct ${target.name} startup readiness\n\nUsage:\n  subharness check ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] [--format text|jsonl]\n\nOptions:\n  --cwd <directory>    Execution directory for the startup check\n  --model <model>      Native model identifier\n  --effort <effort>    Native effort identifier\n  --format text|jsonl  Output format (text by default)\n\nThe check opens and closes an isolated native session without submitting a turn.\nReadiness covers startup at that moment, not quota, task success, native permissions, or continued availability.\nOmitting --model or --effort uses the verifiable native default for the selected access route.\n${target.effort}\n${target.access}\nNative harness flags are not forwarded; unsupported options are errors.\n`;\n  return `subharness run ${target.name} — start a direct ${target.name} session\n\nUsage:\n  subharness run ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] <prompt>\n  subharness run ${target.name} [options] --prompt <text>\n  subharness run ${target.name} [options] --prompt-file <path|->\n\nOptions:\n  --cwd <directory>       Execution directory for the new session\n  --model <model>         Native model identifier\n  --effort <effort>       Native effort identifier\n  --prompt <text>         Prompt text\n  --prompt-file <path|->  Read the prompt from a UTF-8 file or stdin\n  --detach                Return after admission without observing a response\n  --format text|jsonl     Output format (text by default)\n\nOmitting --model or --effort uses the verifiable native default for the selected access route.\n${target.effort}\n${target.access}\nNative harness flags are not forwarded; unsupported options are errors.\n`;\n}\n"]}

package/dist/cli/input.d.ts

@@ -3,3 +3,4 @@ export type PromptStream = AsyncIterable<Uint8Array | string> & {
     isTTY?: boolean;
 };
 export declare function readPromptInput(source: string, cwd: string, stdin?: PromptStream): Promise<string>;
+export declare function readApprovalInput(source: string, cwd: string, stdin?: PromptStream): Promise<string>;

package/dist/cli/input.js

@@ -3,58 +3,59 @@ import { resolve } from 'node:path';
 import { AgentError } from '../errors.js';
 export const MAX_PROMPT_BYTES = 1024 * 1024;
 const invalid = (message) => { throw new AgentError('INVALID_ARGUMENT', message); };
-function decode(chunks, bytes, source) {
-    if (bytes > MAX_PROMPT_BYTES)
-        invalid('Prompt exceeds 1 MiB.');
+const tooLarge = (limit) => invalid(`${limit.noun[0].toUpperCase()}${limit.noun.slice(1)} exceeds ${limit.size}.`);
+function decode(chunks, bytes, source, limit) {
+    if (bytes > limit.bytes)
+        tooLarge(limit);
     try {
         return new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks, bytes));
     }
     catch {
-        return invalid(`Cannot read UTF-8 prompt ${source}.`);
+        return invalid(`Cannot read UTF-8 ${limit.noun} ${source}.`);
     }
 }
-async function readStdin(stdin) {
+async function readStdin(stdin, limit) {
     if (stdin.isTTY)
-        invalid('Cannot read a prompt from interactive terminal stdin.');
+        invalid(`Cannot read ${limit.noun} from interactive terminal stdin.`);
     const chunks = [];
     let bytes = 0;
     try {
         for await (const value of stdin) {
             const chunk = Buffer.from(value);
             bytes += chunk.byteLength;
-            if (bytes > MAX_PROMPT_BYTES)
-                invalid('Prompt exceeds 1 MiB.');
+            if (bytes > limit.bytes)
+                tooLarge(limit);
             chunks.push(chunk);
         }
     }
     catch (error) {
         if (error instanceof AgentError)
             throw error;
-        invalid('Cannot read prompt from stdin.');
+        invalid(`Cannot read ${limit.noun} from stdin.`);
     }
-    return decode(chunks, bytes, 'from stdin');
+    return decode(chunks, bytes, 'from stdin', limit);
 }
-async function readFileBounded(path) {
+async function readFileBounded(path, limit) {
     let file;
     try {
         file = await open(path, 'r');
         const chunks = [];
         let bytes = 0;
         while (true) {
-            const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_PROMPT_BYTES + 1 - bytes));
+            const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, limit.bytes + 1 - bytes));
             const { bytesRead } = await file.read(buffer, 0, buffer.byteLength, null);
             if (!bytesRead)
-                return decode(chunks, bytes, `file: ${path}`);
+                return decode(chunks, bytes, `file: ${path}`, limit);
             bytes += bytesRead;
-            if (bytes > MAX_PROMPT_BYTES)
-                invalid('Prompt exceeds 1 MiB.');
+            if (bytes > limit.bytes)
+                tooLarge(limit);
             chunks.push(buffer.subarray(0, bytesRead));
         }
     }
     catch (error) {
         if (error instanceof AgentError)
             throw error;
-        return invalid(`Cannot read prompt file: ${path}`);
+        return invalid(`Cannot read ${limit.noun} file: ${path}`);
     }
     finally {
         try {
@@ -64,6 +65,11 @@ async function readFileBounded(path) {
     }
 }
 export function readPromptInput(source, cwd, stdin = process.stdin) {
-    return source === '-' ? readStdin(stdin) : readFileBounded(resolve(cwd, source));
+    const limit = { bytes: MAX_PROMPT_BYTES, noun: 'prompt', size: '1 MiB' };
+    return source === '-' ? readStdin(stdin, limit) : readFileBounded(resolve(cwd, source), limit);
+}
+export function readApprovalInput(source, cwd, stdin = process.stdin) {
+    const limit = { bytes: 16 * 1024, noun: 'approval content', size: '16 KiB' };
+    return source === '-' ? readStdin(stdin, limit) : readFileBounded(resolve(cwd, source), limit);
 }
 //# sourceMappingURL=input.js.map

package/dist/cli/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/cli/input.ts"],"names":[],"mappings":"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","sourcesContent":["import { open } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { AgentError } from '../errors.js';\n\nexport const MAX_PROMPT_BYTES = 1024 * 1024;\n\nexport type PromptStream = AsyncIterable<Uint8Array | string> & {isTTY?: boolean};\n\nconst invalid = (message: string): never => { throw new AgentError('INVALID_ARGUMENT', message); };\n\nfunction decode(chunks: Uint8Array[], bytes: number, source: string): string {\n  if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n  try {\n    return new TextDecoder('utf-8', {fatal: true}).decode(Buffer.concat(chunks, bytes));\n  } catch {\n    return invalid(`Cannot read UTF-8 prompt ${source}.`);\n  }\n}\n\nasync function readStdin(stdin: PromptStream): Promise<string> {\n  if (stdin.isTTY) invalid('Cannot read a prompt from interactive terminal stdin.');\n  const chunks: Uint8Array[] = [];\n  let bytes = 0;\n  try {\n    for await (const value of stdin) {\n      const chunk = Buffer.from(value);\n      bytes += chunk.byteLength;\n      if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n      chunks.push(chunk);\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    invalid('Cannot read prompt from stdin.');\n  }\n  return decode(chunks, bytes, 'from stdin');\n}\n\nasync function readFileBounded(path: string): Promise<string> {\n  let file;\n  try {\n    file = await open(path, 'r');\n    const chunks: Uint8Array[] = [];\n    let bytes = 0;\n    while (true) {\n      const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_PROMPT_BYTES + 1 - bytes));\n      const {bytesRead} = await file.read(buffer, 0, buffer.byteLength, null);\n      if (!bytesRead) return decode(chunks, bytes, `file: ${path}`);\n      bytes += bytesRead;\n      if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n      chunks.push(buffer.subarray(0, bytesRead));\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    return invalid(`Cannot read prompt file: ${path}`);\n  } finally {\n    try { await file?.close(); } catch {}\n  }\n}\n\nexport function readPromptInput(source: string, cwd: string, stdin: PromptStream = process.stdin): Promise<string> {\n  return source === '-' ? readStdin(stdin) : readFileBounded(resolve(cwd, source));\n}\n"]}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/cli/input.ts"],"names":[],"mappings":"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","sourcesContent":["import { open } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { AgentError } from '../errors.js';\n\nexport const MAX_PROMPT_BYTES = 1024 * 1024;\n\nexport type PromptStream = AsyncIterable<Uint8Array | string> & {isTTY?: boolean};\n\nconst invalid = (message: string): never => { throw new AgentError('INVALID_ARGUMENT', message); };\n\ninterface InputLimit { bytes: number; noun: string; size: string }\nconst tooLarge = (limit: InputLimit): never => invalid(`${limit.noun[0]!.toUpperCase()}${limit.noun.slice(1)} exceeds ${limit.size}.`);\n\nfunction decode(chunks: Uint8Array[], bytes: number, source: string, limit: InputLimit): string {\n  if (bytes > limit.bytes) tooLarge(limit);\n  try {\n    return new TextDecoder('utf-8', {fatal: true}).decode(Buffer.concat(chunks, bytes));\n  } catch {\n    return invalid(`Cannot read UTF-8 ${limit.noun} ${source}.`);\n  }\n}\n\nasync function readStdin(stdin: PromptStream, limit: InputLimit): Promise<string> {\n  if (stdin.isTTY) invalid(`Cannot read ${limit.noun} from interactive terminal stdin.`);\n  const chunks: Uint8Array[] = [];\n  let bytes = 0;\n  try {\n    for await (const value of stdin) {\n      const chunk = Buffer.from(value);\n      bytes += chunk.byteLength;\n      if (bytes > limit.bytes) tooLarge(limit);\n      chunks.push(chunk);\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    invalid(`Cannot read ${limit.noun} from stdin.`);\n  }\n  return decode(chunks, bytes, 'from stdin',limit);\n}\n\nasync function readFileBounded(path: string, limit: InputLimit): Promise<string> {\n  let file;\n  try {\n    file = await open(path, 'r');\n    const chunks: Uint8Array[] = [];\n    let bytes = 0;\n    while (true) {\n      const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, limit.bytes + 1 - bytes));\n      const {bytesRead} = await file.read(buffer, 0, buffer.byteLength, null);\n      if (!bytesRead) return decode(chunks, bytes, `file: ${path}`,limit);\n      bytes += bytesRead;\n      if (bytes > limit.bytes) tooLarge(limit);\n      chunks.push(buffer.subarray(0, bytesRead));\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    return invalid(`Cannot read ${limit.noun} file: ${path}`);\n  } finally {\n    try { await file?.close(); } catch {}\n  }\n}\n\nexport function readPromptInput(source: string, cwd: string, stdin: PromptStream = process.stdin): Promise<string> {\n  const limit = {bytes:MAX_PROMPT_BYTES,noun:'prompt',size:'1 MiB'};\n  return source === '-' ? readStdin(stdin,limit) : readFileBounded(resolve(cwd, source),limit);\n}\n\nexport function readApprovalInput(source: string, cwd: string, stdin: PromptStream = process.stdin): Promise<string> {\n  const limit = {bytes:16 * 1024,noun:'approval content',size:'16 KiB'};\n  return source === '-' ? readStdin(stdin,limit) : readFileBounded(resolve(cwd,source),limit);\n}\n"]}

package/dist/cli/main.js

@@ -8,7 +8,7 @@ import { AgentError, errorInfo } from '../errors.js';
 import { connect, request } from '../runtime/client.js';
 import { harnessReference } from '../runtime/definition.js';
 import { checkReadiness } from '../runtime/readiness.js';
-const valueOptions = new Set(['cwd', 'prompt', 'prompt-file', 'model', 'effort', 'delivery', 'after']);
+const valueOptions = new Set(['cwd', 'prompt', 'prompt-file', 'content', 'content-file', 'model', 'effort', 'delivery', 'after']);
 function parseErrorFormat(argv) {
     for (let index = 1; index < argv.length; index++) {
         const argument = argv[index];

package/dist/cli/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { readFile, realpath, stat } from 'node:fs/promises';\nimport { parseArgs } from './args.js';\nimport { renderHelp } from './help.js';\nimport { renderText, exitCode, type OutputRecord } from './output.js';\nimport { loadCatalog, loadDeclaredChildren } from './catalog.js';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { connect, request } from '../runtime/client.js';\nimport type { ExecutionReference } from '../runtime/types.js';\nimport { harnessReference } from '../runtime/definition.js';\nimport { checkReadiness } from '../runtime/readiness.js';\n\nconst valueOptions = new Set(['cwd', 'prompt', 'prompt-file', 'model', 'effort', 'delivery', 'after']);\n\nfunction parseErrorFormat(argv: string[]): 'text' | 'jsonl' {\n  for (let index = 1; index < argv.length; index++) {\n    const argument = argv[index]!;\n    if (argument === '--') break;\n    if (argument === '--format') return argv[index + 1] === 'jsonl' ? 'jsonl' : 'text';\n    if (argument.startsWith('--') && valueOptions.has(argument.slice(2))) index++;\n  }\n  return 'text';\n}\n\nasync function main() {\n  let format = process.argv[2] === 'dashboard' ? 'text' : parseErrorFormat(process.argv.slice(2));\n  const emit = (record: OutputRecord) => {\n    const text = format === 'jsonl' ? JSON.stringify(record) : renderText(record);\n    (record.type === 'error' && format === 'text' ? process.stderr : process.stdout).write(text + '\\n');\n    process.exitCode = exitCode(record);\n  };\n  try {\n    const args = await parseArgs(process.argv.slice(2)); format = args.format;\n    if (args.command === 'help') { process.stdout.write(renderHelp(args.harness, args.helpCommand)); return; }\n    if (args.command === 'version') {\n      const manifest = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8')) as { version: string };\n      process.stdout.write(`${manifest.version}\\n`);\n      return;\n    }\n    if (args.command === 'dashboard') {\n      const { runDashboard } = await import('./dashboard.js');\n      process.exitCode = await runDashboard();\n      return;\n    }\n    const parentToken = process.env.AGENT_PARENT_TOKEN;\n    let reference: ExecutionReference | undefined;\n    if (args.command === 'list' || args.command === 'run' || args.command === 'check') {\n      const requestedCwd = args.cwd;\n      try {\n        args.cwd = await realpath(requestedCwd);\n        if (!(await stat(args.cwd)).isDirectory()) throw new Error();\n      } catch {\n        throw new AgentError('INVALID_CONFIG', `Execution directory is not accessible: ${requestedCwd}`);\n      }\n      if ((args.command === 'run' || args.command === 'check') && args.harness) {\n        reference = harnessReference(args.harness, args.model, args.effort);\n      } else {\n        let parent: {reference:ExecutionReference}|undefined;\n        if (parentToken) {\n          const endpoint = await connect(false);\n          for await (const record of request(endpoint,{command:'parent',parentToken})) {\n            if (record.type === 'error') throw new AgentError((record.error as any).code,(record.error as any).message);\n            parent = record as unknown as {reference:ExecutionReference};\n          }\n        }\n        if ((args.command === 'run' || args.command === 'check') && args.id!.startsWith('subagent:')) {\n          const name = args.id!.slice(9);\n          if (!parent || !('file' in parent.reference)) throw new AgentError('INVALID_PARENT','This subagent is not available in the active parent context.');\n          const children = await loadDeclaredChildren(args.cwd, parent.reference);\n          if (!children.some(child => child.name === name)) throw new AgentError('INVALID_PARENT','This subagent is not available in the active parent context.');\n          reference = {file:parent.reference.file,subagents:[...parent.reference.subagents,name]};\n        } else {\n          const { entries, children } = await loadCatalog(args.cwd, parent?.reference);\n          if (args.command === 'list') {\n            emit({version:1,type:'agents',agents:[\n              {id:'codex',name:'codex',description:'Run the native Codex harness.',scope:'harness'},\n              {id:'claude',name:'claude',description:'Run the native Claude Code harness.',scope:'harness'},\n              {id:'fx',name:'fx',description:'Run the native fx harness through AI Gateway.',scope:'harness'},\n              ...entries.map(({id,name,description,scope})=>({id,name,description,scope})),\n              ...children.map(({name,description})=>({id:`subagent:${name}`,name,description,scope:'subagent'})),\n            ]}); return;\n          }\n          const matches = entries.filter(entry=>entry.id===args.id || entry.name===args.id);\n          if (matches.length !== 1) throw new AgentError(matches.length ? 'AMBIGUOUS_AGENT':'UNKNOWN_AGENT',matches.length ? `Choose ${matches.map(entry=>entry.id).join(' or ')}.` : 'Agent not found. Use subharness list.');\n          reference = {file:matches[0]!.file,subagents:[]};\n        }\n      }\n    }\n    if (args.command === 'check') {\n      await checkReadiness(reference!, args.cwd, process.env);\n      emit({version: 1, type: 'check', target: args.id!, ready: true});\n      return;\n    }\n    const endpoint = await connect(args.command === 'run');\n    const body = args.command === 'run'\n      ? {command:'run',input:{reference,cwd:args.cwd,env:process.env,prompt:args.prompt,parentToken},detach:args.detach}\n      : {...args,parentToken};\n    for await (const record of request(endpoint,body)) emit(record);\n  } catch (error) { emit({version:1,type:'error',error:errorInfo(error)}); }\n}\nawait main();\n"]}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { readFile, realpath, stat } from 'node:fs/promises';\nimport { parseArgs } from './args.js';\nimport { renderHelp } from './help.js';\nimport { renderText, exitCode, type OutputRecord } from './output.js';\nimport { loadCatalog, loadDeclaredChildren } from './catalog.js';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { connect, request } from '../runtime/client.js';\nimport type { ExecutionReference } from '../runtime/types.js';\nimport { harnessReference } from '../runtime/definition.js';\nimport { checkReadiness } from '../runtime/readiness.js';\n\nconst valueOptions = new Set(['cwd', 'prompt', 'prompt-file', 'content', 'content-file', 'model', 'effort', 'delivery', 'after']);\n\nfunction parseErrorFormat(argv: string[]): 'text' | 'jsonl' {\n  for (let index = 1; index < argv.length; index++) {\n    const argument = argv[index]!;\n    if (argument === '--') break;\n    if (argument === '--format') return argv[index + 1] === 'jsonl' ? 'jsonl' : 'text';\n    if (argument.startsWith('--') && valueOptions.has(argument.slice(2))) index++;\n  }\n  return 'text';\n}\n\nasync function main() {\n  let format = process.argv[2] === 'dashboard' ? 'text' : parseErrorFormat(process.argv.slice(2));\n  const emit = (record: OutputRecord) => {\n    const text = format === 'jsonl' ? JSON.stringify(record) : renderText(record);\n    (record.type === 'error' && format === 'text' ? process.stderr : process.stdout).write(text + '\\n');\n    process.exitCode = exitCode(record);\n  };\n  try {\n    const args = await parseArgs(process.argv.slice(2)); format = args.format;\n    if (args.command === 'help') { process.stdout.write(renderHelp(args.harness, args.helpCommand)); return; }\n    if (args.command === 'version') {\n      const manifest = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8')) as { version: string };\n      process.stdout.write(`${manifest.version}\\n`);\n      return;\n    }\n    if (args.command === 'dashboard') {\n      const { runDashboard } = await import('./dashboard.js');\n      process.exitCode = await runDashboard();\n      return;\n    }\n    const parentToken = process.env.AGENT_PARENT_TOKEN;\n    let reference: ExecutionReference | undefined;\n    if (args.command === 'list' || args.command === 'run' || args.command === 'check') {\n      const requestedCwd = args.cwd;\n      try {\n        args.cwd = await realpath(requestedCwd);\n        if (!(await stat(args.cwd)).isDirectory()) throw new Error();\n      } catch {\n        throw new AgentError('INVALID_CONFIG', `Execution directory is not accessible: ${requestedCwd}`);\n      }\n      if ((args.command === 'run' || args.command === 'check') && args.harness) {\n        reference = harnessReference(args.harness, args.model, args.effort);\n      } else {\n        let parent: {reference:ExecutionReference}|undefined;\n        if (parentToken) {\n          const endpoint = await connect(false);\n          for await (const record of request(endpoint,{command:'parent',parentToken})) {\n            if (record.type === 'error') throw new AgentError((record.error as any).code,(record.error as any).message);\n            parent = record as unknown as {reference:ExecutionReference};\n          }\n        }\n        if ((args.command === 'run' || args.command === 'check') && args.id!.startsWith('subagent:')) {\n          const name = args.id!.slice(9);\n          if (!parent || !('file' in parent.reference)) throw new AgentError('INVALID_PARENT','This subagent is not available in the active parent context.');\n          const children = await loadDeclaredChildren(args.cwd, parent.reference);\n          if (!children.some(child => child.name === name)) throw new AgentError('INVALID_PARENT','This subagent is not available in the active parent context.');\n          reference = {file:parent.reference.file,subagents:[...parent.reference.subagents,name]};\n        } else {\n          const { entries, children } = await loadCatalog(args.cwd, parent?.reference);\n          if (args.command === 'list') {\n            emit({version:1,type:'agents',agents:[\n              {id:'codex',name:'codex',description:'Run the native Codex harness.',scope:'harness'},\n              {id:'claude',name:'claude',description:'Run the native Claude Code harness.',scope:'harness'},\n              {id:'fx',name:'fx',description:'Run the native fx harness through AI Gateway.',scope:'harness'},\n              ...entries.map(({id,name,description,scope})=>({id,name,description,scope})),\n              ...children.map(({name,description})=>({id:`subagent:${name}`,name,description,scope:'subagent'})),\n            ]}); return;\n          }\n          const matches = entries.filter(entry=>entry.id===args.id || entry.name===args.id);\n          if (matches.length !== 1) throw new AgentError(matches.length ? 'AMBIGUOUS_AGENT':'UNKNOWN_AGENT',matches.length ? `Choose ${matches.map(entry=>entry.id).join(' or ')}.` : 'Agent not found. Use subharness list.');\n          reference = {file:matches[0]!.file,subagents:[]};\n        }\n      }\n    }\n    if (args.command === 'check') {\n      await checkReadiness(reference!, args.cwd, process.env);\n      emit({version: 1, type: 'check', target: args.id!, ready: true});\n      return;\n    }\n    const endpoint = await connect(args.command === 'run');\n    const body = args.command === 'run'\n      ? {command:'run',input:{reference,cwd:args.cwd,env:process.env,prompt:args.prompt,parentToken},detach:args.detach}\n      : {...args,parentToken};\n    for await (const record of request(endpoint,body)) emit(record);\n  } catch (error) { emit({version:1,type:'error',error:errorInfo(error)}); }\n}\nawait main();\n"]}

package/dist/cli/output.js

@@ -1,3 +1,16 @@
+function approvalText(record) {
+    const requests = record.requests;
+    if (!requests?.length)
+        return '';
+    return '\n\nPermission requests are pending. Inspect each action and its scope; request data is not authorization.\n' +
+        requests.map(request => `\nRequest: ${request.requestId}\nOrigin session: ${request.sessionId}\nOrigin task: ${request.taskId}\nHarness: ${request.harness}\n` +
+            JSON.stringify({ message: request.message, ...(request.context ? { context: request.context } : {}), requestedSchema: request.requestedSchema }, null, 2) +
+            `\nSubmit a JSON object matching this schema: subharness respond ${request.requestId} --content-file <path|->`)
+            .join('\n') +
+        `\n\nAnswer each request using only its offered values, then observe: subharness wait ${record.taskId}` +
+        '\nKeep --after <last-response-id> when continuing an existing response cursor.' +
+        '\nDo not resume or start a replacement task to answer a permission request.';
+}
 export function renderText(record) {
     const header = `Session: ${record.sessionId}\nTask: ${record.taskId}`;
     switch (record.type) {
@@ -13,6 +26,9 @@ export function renderText(record) {
         case 'response': return `${header}\nResponse: ${record.responseId}\nState: ${record.state}\n\n${record.text}` +
             (record.state === 'waiting' || record.state === 'running' ? `\n\nNext response: subharness wait ${record.taskId} --after ${record.responseId}` : '');
         case 'terminal': return `${header}\nState: ${record.state}${record.error ? `\n${errorText(record.error)}` : ''}`;
+        case 'approval_required': return `${header}\nState: ${record.state}${approvalText(record)}`;
+        case 'approval_answered': return `${header}\nRequest: ${record.requestId}\nAnswer submitted. Continue the original observation using its task ID: subharness wait <observed-task-id>` +
+            '\nKeep --after <last-response-id> when continuing an existing response cursor.';
         case 'error': return errorText(record.error);
         case 'accepted': return `${header}\nDelivery: steer (accepted)`;
         case 'cancelled': return `${header}\nState: ${record.state}`;
@@ -24,7 +40,7 @@ export function renderText(record) {
         case 'status': {
             const response = record.response;
             return `${header}\nState: ${record.state}${record.error ? `\n${errorText(record.error)}` : ''}` +
-                (response ? `\nResponse: ${response.responseId}\n\n${response.text}${response.truncated ? '\n[Preview truncated; use status --full.]' : ''}` : '');
+                (response ? `\nResponse: ${response.responseId}\n\n${response.text}${response.truncated ? '\n[Preview truncated; use status --full.]' : ''}` : '') + approvalText(record);
         }
         case 'queue': {
             const active = record.active;

package/dist/cli/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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","sourcesContent":["export type OutputRecord = {version: number; type: string; [key: string]: unknown};\n\nexport function renderText(record: OutputRecord): string {\n  const header = `Session: ${record.sessionId}\\nTask: ${record.taskId}`;\n  switch (record.type) {\n    case 'started': {\n      const started = `${header}\\nState: ${record.state}${record.delivery ? `\\nDelivery: ${record.delivery}` : ''}`;\n      if (record.paused !== true || typeof record.blockedByTaskId !== 'string') return started;\n      return `${started}\\n\\nTask accepted, but it cannot dispatch while the session queue is paused by failed task ${record.blockedByTaskId}.` +\n        `\\nInspect the failure: subharness status ${record.blockedByTaskId} --full` +\n        `\\nCancel the failed task: subharness cancel ${record.blockedByTaskId}` +\n        '\\nCancellation must succeed before queue dispatch resumes.';\n    }\n    case 'response': return `${header}\\nResponse: ${record.responseId}\\nState: ${record.state}\\n\\n${record.text}` +\n      (record.state === 'waiting' || record.state === 'running' ? `\\n\\nNext response: subharness wait ${record.taskId} --after ${record.responseId}` : '');\n    case 'terminal': return `${header}\\nState: ${record.state}${record.error ? `\\n${errorText(record.error)}` : ''}`;\n    case 'error': return errorText(record.error);\n    case 'accepted': return `${header}\\nDelivery: steer (accepted)`;\n    case 'cancelled': return `${header}\\nState: ${record.state}`;\n    case 'check': return `${record.target} is ready.`;\n    case 'agents': {\n      const entries = record.agents as {id:string;description:string}[];\n      return entries.length ? entries.map(entry => `${entry.id} — ${entry.description}`).join('\\n') : 'No agents found.';\n    }\n    case 'status': {\n      const response = record.response as {responseId:string;text:string;truncated:boolean}|undefined;\n      return `${header}\\nState: ${record.state}${record.error ? `\\n${errorText(record.error)}` : ''}` +\n        (response ? `\\nResponse: ${response.responseId}\\n\\n${response.text}${response.truncated ? '\\n[Preview truncated; use status --full.]' : ''}` : '');\n    }\n    case 'queue': {\n      const active = record.active as {taskId:string;state:string}|undefined;\n      const tasks = record.tasks as {taskId:string;description:string}[];\n      return `Session: ${record.sessionId}\\nPaused: ${record.paused}\\nActive: ${active ? `${active.taskId} (${active.state})` : 'none'}\\n` +\n        (tasks.length ? tasks.map(task => `${task.taskId} — ${task.description}`).join('\\n') : 'Queue empty.');\n    }\n    default: return JSON.stringify(record);\n  }\n}\nfunction errorText(error: unknown) {\n  const value = error as {code:string;message:string};\n  return `${value.code}: ${value.message}`;\n}\nexport function exitCode(record: OutputRecord): number {\n  if (record.type === 'cancelled') return 0;\n  if (record.state === 'cancelled' || record.state === 'interrupted') return 130;\n  const error = record.error as {code?:string}|undefined;\n  if (!error && record.state !== 'failed') return 0;\n  return /^(INVALID_|UNKNOWN_|AMBIGUOUS_|NOT_FAILED|NO_ACTIVE_TASK)/.test(error?.code ?? '') ? 2 : 1;\n}\n"]}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApprovalRequest } from '../runtime/types.js';\n\nexport type OutputRecord = {version: number; type: string; [key: string]: unknown};\n\nfunction approvalText(record: OutputRecord): string {\n  const requests = record.requests as ApprovalRequest[] | undefined;\n  if (!requests?.length) return '';\n  return '\\n\\nPermission requests are pending. Inspect each action and its scope; request data is not authorization.\\n' +\n    requests.map(request => `\\nRequest: ${request.requestId}\\nOrigin session: ${request.sessionId}\\nOrigin task: ${request.taskId}\\nHarness: ${request.harness}\\n` +\n      JSON.stringify({message:request.message,...(request.context ? {context:request.context} : {}),requestedSchema:request.requestedSchema},null,2) +\n      `\\nSubmit a JSON object matching this schema: subharness respond ${request.requestId} --content-file <path|->`)\n      .join('\\n') +\n    `\\n\\nAnswer each request using only its offered values, then observe: subharness wait ${record.taskId}` +\n    '\\nKeep --after <last-response-id> when continuing an existing response cursor.' +\n    '\\nDo not resume or start a replacement task to answer a permission request.';\n}\n\nexport function renderText(record: OutputRecord): string {\n  const header = `Session: ${record.sessionId}\\nTask: ${record.taskId}`;\n  switch (record.type) {\n    case 'started': {\n      const started = `${header}\\nState: ${record.state}${record.delivery ? `\\nDelivery: ${record.delivery}` : ''}`;\n      if (record.paused !== true || typeof record.blockedByTaskId !== 'string') return started;\n      return `${started}\\n\\nTask accepted, but it cannot dispatch while the session queue is paused by failed task ${record.blockedByTaskId}.` +\n        `\\nInspect the failure: subharness status ${record.blockedByTaskId} --full` +\n        `\\nCancel the failed task: subharness cancel ${record.blockedByTaskId}` +\n        '\\nCancellation must succeed before queue dispatch resumes.';\n    }\n    case 'response': return `${header}\\nResponse: ${record.responseId}\\nState: ${record.state}\\n\\n${record.text}` +\n      (record.state === 'waiting' || record.state === 'running' ? `\\n\\nNext response: subharness wait ${record.taskId} --after ${record.responseId}` : '');\n    case 'terminal': return `${header}\\nState: ${record.state}${record.error ? `\\n${errorText(record.error)}` : ''}`;\n    case 'approval_required': return `${header}\\nState: ${record.state}${approvalText(record)}`;\n    case 'approval_answered': return `${header}\\nRequest: ${record.requestId}\\nAnswer submitted. Continue the original observation using its task ID: subharness wait <observed-task-id>` +\n      '\\nKeep --after <last-response-id> when continuing an existing response cursor.';\n    case 'error': return errorText(record.error);\n    case 'accepted': return `${header}\\nDelivery: steer (accepted)`;\n    case 'cancelled': return `${header}\\nState: ${record.state}`;\n    case 'check': return `${record.target} is ready.`;\n    case 'agents': {\n      const entries = record.agents as {id:string;description:string}[];\n      return entries.length ? entries.map(entry => `${entry.id} — ${entry.description}`).join('\\n') : 'No agents found.';\n    }\n    case 'status': {\n      const response = record.response as {responseId:string;text:string;truncated:boolean}|undefined;\n      return `${header}\\nState: ${record.state}${record.error ? `\\n${errorText(record.error)}` : ''}` +\n        (response ? `\\nResponse: ${response.responseId}\\n\\n${response.text}${response.truncated ? '\\n[Preview truncated; use status --full.]' : ''}` : '') + approvalText(record);\n    }\n    case 'queue': {\n      const active = record.active as {taskId:string;state:string}|undefined;\n      const tasks = record.tasks as {taskId:string;description:string}[];\n      return `Session: ${record.sessionId}\\nPaused: ${record.paused}\\nActive: ${active ? `${active.taskId} (${active.state})` : 'none'}\\n` +\n        (tasks.length ? tasks.map(task => `${task.taskId} — ${task.description}`).join('\\n') : 'Queue empty.');\n    }\n    default: return JSON.stringify(record);\n  }\n}\nfunction errorText(error: unknown) {\n  const value = error as {code:string;message:string};\n  return `${value.code}: ${value.message}`;\n}\nexport function exitCode(record: OutputRecord): number {\n  if (record.type === 'cancelled') return 0;\n  if (record.state === 'cancelled' || record.state === 'interrupted') return 130;\n  const error = record.error as {code?:string}|undefined;\n  if (!error && record.state !== 'failed') return 0;\n  return /^(INVALID_|UNKNOWN_|AMBIGUOUS_|NOT_FAILED|NO_ACTIVE_TASK)/.test(error?.code ?? '') ? 2 : 1;\n}\n"]}

package/dist/runtime/approval-registry.d.ts

@@ -0,0 +1,27 @@
+import type { ApprovalContent, NativeApprovalRequest } from '../approvals/types.js';
+import type { ApprovalRequest } from './types.js';
+type RequestIdentity = Pick<ApprovalRequest, 'requestId' | 'taskId' | 'sessionId'>;
+/** Retains pending requests and a bounded settlement-ordered outcome history. */
+export declare class ApprovalRegistry {
+    private readonly changed;
+    private pending;
+    private settled;
+    constructor(changed: (taskId: string) => void);
+    register(taskId: string, sessionId: string, request: NativeApprovalRequest, signal: AbortSignal): Promise<ApprovalContent>;
+    request(id: string): RequestIdentity;
+    respond(id: string, content: unknown): {
+        version: 1;
+        type: 'approval_answered';
+        requestId: string;
+        taskId: string;
+        sessionId: string;
+    };
+    pendingFor(taskId: string): ApprovalRequest[];
+    retireTask(taskId: string): void;
+    close(): void;
+    private retire;
+    private retain;
+    private validateBoundedContent;
+    private receipt;
+}
+export {};