subharness 0.0.3 → 0.0.4

package/dist/runtime/dashboard.d.ts

@@ -1,3 +1,4 @@
+import type { ErrorInfo } from '../errors.js';
 import type { HarnessKind } from '../sdk/types.js';
 import type { TaskState } from './types.js';
 export type DashboardHarness = 'codex' | 'claude' | 'fx' | 'pending';
@@ -24,5 +25,46 @@ export interface DashboardSnapshot {
     grouping: true;
     sessions: DashboardRow[];
 }
+export interface DashboardRelatedTask {
+    taskId: string;
+    sessionId: string;
+    harness: DashboardHarness;
+    title: string;
+    state: TaskState;
+}
+export interface DashboardRequest extends DashboardRow {
+    ordinal: number;
+    stopUnconfirmed: boolean;
+}
+export interface DashboardSession {
+    version: 1;
+    type: 'dashboard-session';
+    taskId: string;
+    sessionId: string;
+    title: string;
+    harness: DashboardHarness;
+    state: TaskState;
+    workspace: DashboardWorkspace;
+    requests: DashboardRequest[];
+    subagents: DashboardRelatedTask[];
+    queuePaused: boolean;
+}
+export interface DashboardDetail {
+    version: 1;
+    type: 'dashboard-detail';
+    task: DashboardRow;
+    prompt?: string;
+    response?: {
+        responseId: string;
+        text?: string;
+    };
+    error?: ErrorInfo;
+    children: DashboardRelatedTask[];
+    queue: {
+        paused: boolean;
+        tasks: DashboardRelatedTask[];
+    };
+    stopUnconfirmed: boolean;
+}
 export declare function dashboardHarness(kind?: HarnessKind): DashboardHarness;
 export declare function dashboardTitle(prompt: string): string;

package/dist/runtime/dashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/runtime/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAgCrD,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IACjD,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC;IAC3C,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI;aACpB,OAAO,CAAC,yDAAyD,EAAE,EAAE,CAAC;aACtE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,IAAI,EAAE,CAAC;QACV,IAAI,UAAU;YAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import { stripVTControlCharacters } from 'node:util';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { TaskState } from './types.js';\n\nexport type DashboardHarness = 'codex' | 'claude' | 'fx' | 'pending';\n\nexport interface DashboardWorkspace {\n  directory: string;\n  repository?: string;\n}\n\nexport interface DashboardRow {\n  sessionId: string;\n  taskId: string;\n  harness: DashboardHarness;\n  title: string;\n  state: TaskState;\n  workspace: DashboardWorkspace;\n  updatedAt: number;\n  dispatchedAt?: number;\n  failedAt?: number;\n  finishedAt?: number;\n}\n\nexport interface DashboardSnapshot {\n  version: 1;\n  type: 'dashboard';\n  history: true;\n  grouping: true;\n  sessions: DashboardRow[];\n}\n\nexport function dashboardHarness(kind?: HarnessKind): DashboardHarness {\n  if (kind === 'claudeCode') return 'claude';\n  return kind ?? 'pending';\n}\n\nexport function dashboardTitle(prompt: string): string {\n  const plain = stripVTControlCharacters(prompt);\n  for (const line of plain.split(/\\r\\n?|\\n/u)) {\n    const normalized = line\n      .replace(/[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f-\\u009f]/gu, '')\n      .replace(/\\s+/gu, ' ')\n      .trim();\n    if (normalized) return [...normalized].slice(0, 120).join('');\n  }\n  return '(untitled)';\n}\n"]}
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/runtime/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAwErD,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IACjD,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC;IAC3C,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI;aACpB,OAAO,CAAC,yDAAyD,EAAE,EAAE,CAAC;aACtE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,IAAI,EAAE,CAAC;QACV,IAAI,UAAU;YAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import { stripVTControlCharacters } from 'node:util';\nimport type { ErrorInfo } from '../errors.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { TaskState } from './types.js';\n\nexport type DashboardHarness = 'codex' | 'claude' | 'fx' | 'pending';\n\nexport interface DashboardWorkspace {\n  directory: string;\n  repository?: string;\n}\n\nexport interface DashboardRow {\n  sessionId: string;\n  taskId: string;\n  harness: DashboardHarness;\n  title: string;\n  state: TaskState;\n  workspace: DashboardWorkspace;\n  updatedAt: number;\n  dispatchedAt?: number;\n  failedAt?: number;\n  finishedAt?: number;\n}\n\nexport interface DashboardSnapshot {\n  version: 1;\n  type: 'dashboard';\n  history: true;\n  grouping: true;\n  sessions: DashboardRow[];\n}\n\nexport interface DashboardRelatedTask {\n  taskId: string;\n  sessionId: string;\n  harness: DashboardHarness;\n  title: string;\n  state: TaskState;\n}\n\nexport interface DashboardRequest extends DashboardRow {\n  ordinal: number;\n  stopUnconfirmed: boolean;\n}\n\nexport interface DashboardSession {\n  version: 1;\n  type: 'dashboard-session';\n  taskId: string;\n  sessionId: string;\n  title: string;\n  harness: DashboardHarness;\n  state: TaskState;\n  workspace: DashboardWorkspace;\n  requests: DashboardRequest[];\n  subagents: DashboardRelatedTask[];\n  queuePaused: boolean;\n}\n\nexport interface DashboardDetail {\n  version: 1;\n  type: 'dashboard-detail';\n  task: DashboardRow;\n  prompt?: string;\n  response?: {responseId: string; text?: string};\n  error?: ErrorInfo;\n  children: DashboardRelatedTask[];\n  queue: {paused: boolean; tasks: DashboardRelatedTask[]};\n  stopUnconfirmed: boolean;\n}\n\nexport function dashboardHarness(kind?: HarnessKind): DashboardHarness {\n  if (kind === 'claudeCode') return 'claude';\n  return kind ?? 'pending';\n}\n\nexport function dashboardTitle(prompt: string): string {\n  const plain = stripVTControlCharacters(prompt);\n  for (const line of plain.split(/\\r\\n?|\\n/u)) {\n    const normalized = line\n      .replace(/[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f-\\u009f]/gu, '')\n      .replace(/\\s+/gu, ' ')\n      .trim();\n    if (normalized) return [...normalized].slice(0, 120).join('');\n  }\n  return '(untitled)';\n}\n"]}

package/dist/runtime/select-native.d.ts

@@ -1,4 +1,5 @@
 import type { HarnessKind } from '../sdk/types.js';
 import type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';
 import { type AccessConfig } from '../config/access.js';
-export declare function selectNative(agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig, open?: (options: AdapterOptions) => Promise<NativeSession>, selected?: (kind: HarnessKind) => void): Promise<NativeSession>;
+import type { ApprovalHandler } from '../approvals/types.js';
+export declare function selectNative(agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig, open?: (options: AdapterOptions) => Promise<NativeSession>, selected?: (kind: HarnessKind) => void, onApproval?: ApprovalHandler): Promise<NativeSession>;

package/dist/runtime/select-native.js

@@ -4,7 +4,7 @@ import { openFx } from '../adapters/fx.js';
 import { resolveAccess } from '../config/access.js';
 import { AgentError } from '../errors.js';
 const openers = { codex: openCodex, claudeCode: openClaude, fx: openFx };
-export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }) {
+export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }, onApproval) {
     const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];
     const unavailable = [];
     for (const harness of alternatives) {
@@ -20,7 +20,7 @@ export async function selectNative(agent, cwd, env, settings, open = (options) =
         for (const connection of connections) {
             try {
                 const access = await resolveAccess(connection, harness.kind, cwd, env);
-                const native = await open({ agent, harness, cwd, env, access });
+                const native = await open({ agent, harness, cwd, env, access, ...(onApproval ? { onApproval } : {}) });
                 selected(harness.kind);
                 return native;
             }

package/dist/runtime/select-native.js.map

@@ -1 +1 @@
-{"version":3,"file":"select-native.js","sourceRoot":"","sources":["../../src/runtime/select-native.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,EAAC,UAAU,EAAC,EAAE,EAAC,MAAM,EAAC,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAA0B,EAAE,GAAW,EAAE,GAAsB,EAAE,QAAsB,EACvF,IAAI,GAAG,CAAC,OAAuB,EAA0B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAClG,QAAQ,GAAgC,GAAG,EAAE,GAAE,CAAC;IAEhD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpF,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC;QAC7E,MAAM,WAAW,GAAG,qBAAqB;YACvC,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,cAAuB,EAAC,CAAC,CAAC,CAAC;QAClE,IAAI,qBAAqB,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,4EAA4E,CAAC,CAAC;QAChH,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QAChG,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAC,KAAK,EAAC,OAAO,EAAC,GAAG,EAAC,GAAG,EAAC,MAAM,EAAC,CAAC,CAAC;gBAC1D,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,CAAC,CAAC,qBAAqB,EAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACtH,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC;AACtI,CAAC","sourcesContent":["import type { HarnessKind } from '../sdk/types.js';\nimport type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport { openCodex } from '../adapters/codex.js';\nimport { openClaude } from '../adapters/claude.js';\nimport { openFx } from '../adapters/fx.js';\nimport { resolveAccess, type AccessConfig } from '../config/access.js';\nimport { AgentError } from '../errors.js';\n\nconst openers = {codex:openCodex,claudeCode:openClaude,fx:openFx};\n\nexport async function selectNative(\n  agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig,\n  open = (options: AdapterOptions): Promise<NativeSession> => openers[options.harness.kind](options),\n  selected: (kind: HarnessKind) => void = () => {},\n): Promise<NativeSession> {\n  const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];\n  const unavailable: string[] = [];\n  for (const harness of alternatives) {\n    const configuredConnections = settings.access?.[harness.kind as HarnessKind];\n    const connections = configuredConnections ??\n      (harness.kind === 'fx' ? [] : [{type:'subscription' as const}]);\n    if (configuredConnections?.length === 0) {\n      unavailable.push(`${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);\n    } else if (harness.kind === 'fx' && !connections.length) {\n      unavailable.push('fx: Enable an explicit AI Gateway connection in personal access settings.');\n    }\n    for (const connection of connections) {\n      try {\n        const access = await resolveAccess(connection, harness.kind, cwd, env);\n        const native = await open({agent,harness,cwd,env,access});\n        selected(harness.kind);\n        return native;\n      } catch (error) {\n        if (!(error instanceof AgentError) || !['HARNESS_UNAVAILABLE','ACCESS_UNAVAILABLE'].includes(error.code)) throw error;\n        unavailable.push(`${harness.kind}: ${error.message}`);\n      }\n    }\n  }\n  throw new AgentError('ACCESS_UNAVAILABLE', unavailable.length ? unavailable.join('\\n') : 'No declared harness has enabled access.');\n}\n"]}
+{"version":3,"file":"select-native.js","sourceRoot":"","sources":["../../src/runtime/select-native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HarnessKind } from '../sdk/types.js';\nimport type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport { openCodex } from '../adapters/codex.js';\nimport { openClaude } from '../adapters/claude.js';\nimport { openFx } from '../adapters/fx.js';\nimport { resolveAccess, type AccessConfig } from '../config/access.js';\nimport { AgentError } from '../errors.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\n\nconst openers = {codex:openCodex,claudeCode:openClaude,fx:openFx};\n\nexport async function selectNative(\n  agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig,\n  open = (options: AdapterOptions): Promise<NativeSession> => openers[options.harness.kind](options),\n  selected: (kind: HarnessKind) => void = () => {},\n  onApproval?: ApprovalHandler,\n): Promise<NativeSession> {\n  const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];\n  const unavailable: string[] = [];\n  for (const harness of alternatives) {\n    const configuredConnections = settings.access?.[harness.kind as HarnessKind];\n    const connections = configuredConnections ??\n      (harness.kind === 'fx' ? [] : [{type:'subscription' as const}]);\n    if (configuredConnections?.length === 0) {\n      unavailable.push(`${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);\n    } else if (harness.kind === 'fx' && !connections.length) {\n      unavailable.push('fx: Enable an explicit AI Gateway connection in personal access settings.');\n    }\n    for (const connection of connections) {\n      try {\n        const access = await resolveAccess(connection, harness.kind, cwd, env);\n        const native = await open({agent,harness,cwd,env,access,...(onApproval ? {onApproval} : {})});\n        selected(harness.kind);\n        return native;\n      } catch (error) {\n        if (!(error instanceof AgentError) || !['HARNESS_UNAVAILABLE','ACCESS_UNAVAILABLE'].includes(error.code)) throw error;\n        unavailable.push(`${harness.kind}: ${error.message}`);\n      }\n    }\n  }\n  throw new AgentError('ACCESS_UNAVAILABLE', unavailable.length ? unavailable.join('\\n') : 'No declared harness has enabled access.');\n}\n"]}

package/dist/runtime/service.js

@@ -30,12 +30,32 @@ export async function startService(engine, token, instanceId) {
                 if (Buffer.byteLength(body) > 4 * 1024 * 1024)
                     throw new AgentError('INVALID_ARGUMENT', 'Request exceeds 4 MiB.');
             }
-            const data = JSON.parse(body);
+            let data;
+            try {
+                data = JSON.parse(body);
+            }
+            catch {
+                throw new AgentError('INVALID_ARGUMENT', 'Coordinator input must be valid JSON.');
+            }
+            if (!data || typeof data !== 'object' || Array.isArray(data))
+                throw new AgentError('INVALID_ARGUMENT', 'Coordinator input must be a JSON object.');
             let receipt;
             switch (data.command) {
                 case 'dashboard':
                     write(await engine.dashboard());
                     break;
+                case 'dashboard-session':
+                    if (typeof data.id !== 'string')
+                        throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard session request fields.');
+                    write(await engine.dashboardSession(data.id));
+                    break;
+                case 'dashboard-detail':
+                    if (typeof data.id !== 'string' ||
+                        (data.includePrompt !== undefined && typeof data.includePrompt !== 'boolean') ||
+                        (data.knownResponseId !== undefined && typeof data.knownResponseId !== 'string'))
+                        throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard detail request fields.');
+                    write(await engine.dashboardDetail(data.id, data.includePrompt ?? true, data.knownResponseId));
+                    break;
                 case 'parent':
                     write(engine.parentContext(data.parentToken));
                     break;
@@ -70,6 +90,9 @@ export async function startService(engine, token, instanceId) {
                 case 'cancel':
                     write(await engine.cancel(data.id));
                     break;
+                case 'respond':
+                    write(engine.respond(data.id, data.content, data.parentToken));
+                    break;
                 default: throw new AgentError('INVALID_ARGUMENT', 'Unknown coordinator operation.');
             }
             if (receipt) {

package/dist/runtime/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, Receipt, SessionInput } from './types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; detach?: boolean; parentToken?: string;\n}\n\nexport async function startService(engine: Coordinator, token: string, instanceId: string) {\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') {\n      response.setHeader('content-type','application/json');\n      response.end(JSON.stringify({version:1,type:'coordinator-health',instanceId}));\n      return;\n    }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      const data = JSON.parse(body) as Request;\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'dashboard': write(await engine.dashboard()); break;\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send':\n          if (data.detach && data.delivery === 'steer') throw new AgentError('INVALID_ARGUMENT','--detach cannot be combined with --delivery steer.');\n          receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started' && !data.detach) {\n          write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n        }\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() { await engine.close(); server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())); },\n  };\n}\n"]}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, Receipt, SessionInput } from './types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; detach?: boolean; parentToken?: string;\n  content?: unknown;\n  includePrompt?: boolean; knownResponseId?: string;\n}\n\nexport async function startService(engine: Coordinator, token: string, instanceId: string) {\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') {\n      response.setHeader('content-type','application/json');\n      response.end(JSON.stringify({version:1,type:'coordinator-health',instanceId}));\n      return;\n    }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      let data: Request;\n      try { data = JSON.parse(body) as Request; }\n      catch { throw new AgentError('INVALID_ARGUMENT','Coordinator input must be valid JSON.'); }\n      if (!data || typeof data !== 'object' || Array.isArray(data))\n        throw new AgentError('INVALID_ARGUMENT','Coordinator input must be a JSON object.');\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'dashboard': write(await engine.dashboard()); break;\n        case 'dashboard-session':\n          if (typeof data.id !== 'string')\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard session request fields.');\n          write(await engine.dashboardSession(data.id)); break;\n        case 'dashboard-detail':\n          if (typeof data.id !== 'string' ||\n            (data.includePrompt !== undefined && typeof data.includePrompt !== 'boolean') ||\n            (data.knownResponseId !== undefined && typeof data.knownResponseId !== 'string'))\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard detail request fields.');\n          write(await engine.dashboardDetail(data.id, data.includePrompt ?? true, data.knownResponseId)); break;\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send':\n          if (data.detach && data.delivery === 'steer') throw new AgentError('INVALID_ARGUMENT','--detach cannot be combined with --delivery steer.');\n          receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        case 'respond': write(engine.respond(data.id!,data.content,data.parentToken)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started' && !data.detach) {\n          write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n        }\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() { await engine.close(); server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())); },\n  };\n}\n"]}

package/dist/runtime/types.d.ts

@@ -2,7 +2,8 @@ import type { ErrorInfo } from '../errors.js';
 import type { HarnessRequest, NativeSession } from '../adapters/types.js';
 import type { HarnessKind } from '../sdk/types.js';
 import type { DashboardHarness, DashboardWorkspace } from './dashboard.js';
-export type TaskState = 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
+import type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';
+export type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
 export type Delivery = 'queue' | 'steer' | 'interrupt';
 export interface AgentReference {
     file: string;
@@ -23,6 +24,7 @@ export interface SessionInput {
 export interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> {
     token: string;
     sessionId: string;
+    onApproval?: ApprovalHandler;
 }
 export type ManagedNativeSession = NativeSession & {
     selectedHarness?: HarnessKind;
@@ -35,11 +37,17 @@ export interface RecordBase {
     taskId: string;
     state?: TaskState;
 }
+export interface ApprovalRequest extends NativeApprovalRequest {
+    requestId: string;
+    taskId: string;
+    sessionId: string;
+}
 export interface Observation extends RecordBase {
     state: TaskState;
     responseId?: string;
     text?: string;
     error?: ErrorInfo;
+    requests?: ApprovalRequest[];
 }
 export interface Receipt extends RecordBase {
     delivery?: Delivery;

package/dist/runtime/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import type { ErrorInfo } from '../errors.js';\nimport type { HarnessRequest, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { DashboardHarness, DashboardWorkspace } from './dashboard.js';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled' | 'interrupted';\nexport type Delivery = 'queue' | 'steer' | 'interrupt';\nexport interface AgentReference { file: string; subagents: string[] }\nexport interface HarnessReference { kind: 'harness'; harness: HarnessRequest }\nexport type ExecutionReference = AgentReference | HarnessReference;\nexport interface SessionInput { reference: ExecutionReference; cwd: string; env: NodeJS.ProcessEnv; prompt: string; parentToken?: string }\nexport interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> { token: string; sessionId: string }\nexport type ManagedNativeSession = NativeSession & { selectedHarness?: HarnessKind };\nexport type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface Observation extends RecordBase { state: TaskState; responseId?: string; text?: string; error?: ErrorInfo }\nexport interface Receipt extends RecordBase {\n  delivery?: Delivery; requestedDelivery?: Delivery; resumed?: boolean;\n  paused?: true; blockedByTaskId?: string;\n}\nexport interface Response extends Observation { type: 'response'; responseId: string; text: string }\nexport interface ChildResult { taskId: string; state: TaskState; text: string }\nexport interface Task {\n  id: string; sessionId: string; prompt: string; title: string; parentId?: string; state: TaskState;\n  responses: Response[]; children: Set<string>; inbox: ChildResult[]; nativeActive: boolean;\n  stopping: boolean; stopPromise?: Promise<void>; stopUnconfirmed?: boolean; error?: ErrorInfo;\n  dispatchedAt?: number; failedAt?: number; finishedAt?: number; updatedAt: number; changed: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionInput; driver?: Promise<ManagedNativeSession>;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\n  harness: DashboardHarness; workspace: Promise<DashboardWorkspace>;\n}\nexport const terminal = (state: TaskState) => ['completed', 'failed', 'cancelled', 'interrupted'].includes(state);\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import type { ErrorInfo } from '../errors.js';\nimport type { HarnessRequest, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { DashboardHarness, DashboardWorkspace } from './dashboard.js';\nimport type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';\nexport type Delivery = 'queue' | 'steer' | 'interrupt';\nexport interface AgentReference { file: string; subagents: string[] }\nexport interface HarnessReference { kind: 'harness'; harness: HarnessRequest }\nexport type ExecutionReference = AgentReference | HarnessReference;\nexport interface SessionInput { reference: ExecutionReference; cwd: string; env: NodeJS.ProcessEnv; prompt: string; parentToken?: string }\nexport interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> { token: string; sessionId: string; onApproval?: ApprovalHandler }\nexport type ManagedNativeSession = NativeSession & { selectedHarness?: HarnessKind };\nexport type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface ApprovalRequest extends NativeApprovalRequest { requestId: string; taskId: string; sessionId: string }\nexport interface Observation extends RecordBase { state: TaskState; responseId?: string; text?: string; error?: ErrorInfo; requests?: ApprovalRequest[] }\nexport interface Receipt extends RecordBase {\n  delivery?: Delivery; requestedDelivery?: Delivery; resumed?: boolean;\n  paused?: true; blockedByTaskId?: string;\n}\nexport interface Response extends Observation { type: 'response'; responseId: string; text: string }\nexport interface ChildResult { taskId: string; state: TaskState; text: string }\nexport interface Task {\n  id: string; sessionId: string; prompt: string; title: string; parentId?: string; state: TaskState;\n  responses: Response[]; children: Set<string>; inbox: ChildResult[]; nativeActive: boolean;\n  stopping: boolean; stopPromise?: Promise<void>; stopUnconfirmed?: boolean; error?: ErrorInfo;\n  dispatchedAt?: number; failedAt?: number; finishedAt?: number; updatedAt: number; changed: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionInput; driver?: Promise<ManagedNativeSession>;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\n  harness: DashboardHarness; workspace: Promise<DashboardWorkspace>;\n}\nexport const terminal = (state: TaskState) => ['completed', 'failed', 'cancelled', 'interrupted'].includes(state);\n"]}

package/dist/runtime/worker-approvals.d.ts

@@ -0,0 +1,21 @@
+import { type ErrorInfo } from '../errors.js';
+import type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';
+export type ApprovalEvent = {
+    event: 'approval.request';
+    requestId: number;
+    request: NativeApprovalRequest;
+} | {
+    event: 'approval.withdraw';
+    requestId: number;
+};
+/** Independent worker controls keep the native turn promise open while the caller decides. */
+export declare class WorkerApprovals {
+    private readonly send;
+    private nextId;
+    private pending;
+    constructor(send: (event: ApprovalEvent) => void);
+    readonly handle: ApprovalHandler;
+    respond(id: number, content?: unknown, error?: ErrorInfo): void;
+    close(): void;
+    private withdraw;
+}

package/dist/runtime/worker-approvals.js

@@ -0,0 +1,51 @@
+import { AgentError } from '../errors.js';
+import { validateApprovalContent } from '../approvals/schema.js';
+/** Independent worker controls keep the native turn promise open while the caller decides. */
+export class WorkerApprovals {
+    send;
+    nextId = 1;
+    pending = new Map();
+    constructor(send) {
+        this.send = send;
+    }
+    handle = async (request, signal) => {
+        if (signal.aborted)
+            throw new AgentError('REQUEST_EXPIRED', 'The native permission request is no longer pending.');
+        const id = this.nextId++;
+        const snapshot = structuredClone(request);
+        return new Promise((resolve, reject) => {
+            const abort = () => this.withdraw(id);
+            this.pending.set(id, { request: snapshot, resolve, reject, cleanup: () => signal.removeEventListener('abort', abort) });
+            signal.addEventListener('abort', abort, { once: true });
+            this.send({ event: 'approval.request', requestId: id, request: snapshot });
+        });
+    };
+    respond(id, content, error) {
+        const waiting = this.pending.get(id);
+        if (!waiting)
+            throw new AgentError('REQUEST_EXPIRED', 'The native permission request is no longer pending.');
+        if (error) {
+            this.pending.delete(id);
+            waiting.cleanup();
+            waiting.reject(new AgentError(error.code, error.message));
+        }
+        else {
+            const validated = validateApprovalContent(waiting.request.requestedSchema, content);
+            this.pending.delete(id);
+            waiting.cleanup();
+            waiting.resolve(validated);
+        }
+    }
+    close() { for (const id of this.pending.keys())
+        this.withdraw(id); }
+    withdraw(id) {
+        const waiting = this.pending.get(id);
+        if (!waiting)
+            return;
+        this.pending.delete(id);
+        waiting.cleanup();
+        waiting.reject(new AgentError('REQUEST_EXPIRED', 'The native permission request is no longer pending.'));
+        this.send({ event: 'approval.withdraw', requestId: id });
+    }
+}
+//# sourceMappingURL=worker-approvals.js.map

package/dist/runtime/worker-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-approvals.js","sourceRoot":"","sources":["../../src/runtime/worker-approvals.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError, type ErrorInfo } from '../errors.js';\nimport { validateApprovalContent } from '../approvals/schema.js';\nimport type { ApprovalContent, ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';\n\nexport type ApprovalEvent =\n  | {event:'approval.request';requestId:number;request:NativeApprovalRequest}\n  | {event:'approval.withdraw';requestId:number};\ninterface Waiting {\n  request: NativeApprovalRequest;\n  resolve(content: ApprovalContent): void;\n  reject(error: AgentError): void;\n  cleanup(): void;\n}\n\n/** Independent worker controls keep the native turn promise open while the caller decides. */\nexport class WorkerApprovals {\n  private nextId = 1;\n  private pending = new Map<number,Waiting>();\n  constructor(private readonly send: (event: ApprovalEvent) => void) {}\n\n  readonly handle: ApprovalHandler = async (request,signal) => {\n    if (signal.aborted) throw new AgentError('REQUEST_EXPIRED','The native permission request is no longer pending.');\n    const id = this.nextId++;\n    const snapshot = structuredClone(request);\n    return new Promise((resolve,reject) => {\n      const abort = () => this.withdraw(id);\n      this.pending.set(id,{request:snapshot,resolve,reject,cleanup:() => signal.removeEventListener('abort',abort)});\n      signal.addEventListener('abort',abort,{once:true});\n      this.send({event:'approval.request',requestId:id,request:snapshot});\n    });\n  };\n\n  respond(id: number, content?: unknown, error?: ErrorInfo) {\n    const waiting = this.pending.get(id);\n    if (!waiting) throw new AgentError('REQUEST_EXPIRED','The native permission request is no longer pending.');\n    if (error) {\n      this.pending.delete(id); waiting.cleanup();\n      waiting.reject(new AgentError(error.code,error.message));\n    } else {\n      const validated = validateApprovalContent(waiting.request.requestedSchema,content);\n      this.pending.delete(id); waiting.cleanup(); waiting.resolve(validated);\n    }\n  }\n\n  close() { for (const id of this.pending.keys()) this.withdraw(id); }\n\n  private withdraw(id: number) {\n    const waiting = this.pending.get(id);\n    if (!waiting) return;\n    this.pending.delete(id); waiting.cleanup();\n    waiting.reject(new AgentError('REQUEST_EXPIRED','The native permission request is no longer pending.'));\n    this.send({event:'approval.withdraw',requestId:id});\n  }\n}\n"]}

package/dist/runtime/worker-client.js

@@ -1,7 +1,7 @@
 import { fork } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { delimiter } from 'node:path';
-import { AgentError } from '../errors.js';
+import { AgentError, errorInfo } from '../errors.js';
 import { createSessionLauncher } from './session-launcher.js';
 const closeResponseTimeoutMs = 15_000;
 const shutdownTimeoutMs = 1_000;
@@ -36,6 +36,9 @@ export async function createWorker(input, options = {}) {
     }
     let nextId = 1;
     const pending = new Map();
+    const approvals = new Map();
+    const withdrawApprovals = () => { for (const controller of approvals.values())
+        controller.abort(); approvals.clear(); };
     let exited = false;
     let markExited;
     const processExit = new Promise(resolve => { markExited = resolve; });
@@ -43,6 +46,7 @@ export async function createWorker(input, options = {}) {
         if (exited)
             return;
         exited = true;
+        withdrawApprovals();
         markExited();
         void launcher.close().catch(() => { }).finally(() => {
             for (const waiting of pending.values())
@@ -53,14 +57,36 @@ export async function createWorker(input, options = {}) {
     child.once('error', exit);
     child.once('exit', exit);
     child.on('message', (message) => {
-        const request = pending.get(message.id);
-        if (!request)
+        if ('event' in message) {
+            if (message.event === 'approval.withdraw') {
+                approvals.get(message.requestId)?.abort();
+                approvals.delete(message.requestId);
+            }
+            else if (message.event === 'approval.request') {
+                const controller = new AbortController();
+                approvals.set(message.requestId, controller);
+                void Promise.resolve().then(() => {
+                    if (!input.onApproval)
+                        throw new AgentError('INPUT_REQUIRED', 'Native tool approval requires an observing caller.');
+                    return input.onApproval(message.request, controller.signal);
+                }).then(content => { if (!controller.signal.aborted && !exited)
+                    return request('approval.respond', { requestId: message.requestId, content }); }, error => { if (!controller.signal.aborted && !exited)
+                    return request('approval.respond', { requestId: message.requestId, error: errorInfo(error) }); }).catch(error => {
+                    // A rejected control cannot leave an already-settled caller callback parked forever.
+                    if (!controller.signal.aborted && !exited)
+                        return request('approval.respond', { requestId: message.requestId, error: errorInfo(error) }).catch(() => { });
+                }).finally(() => { approvals.delete(message.requestId); });
+            }
+            return;
+        }
+        const waiting = pending.get(message.id);
+        if (!waiting)
             return;
         pending.delete(message.id);
         if (message.error)
-            request.reject(new AgentError(message.error.code, message.error.message));
+            waiting.reject(new AgentError(message.error.code, message.error.message));
         else
-            request.resolve(message.result);
+            waiting.resolve(message.result);
     });
     const request = (method, extra = {}) => new Promise((resolve, reject) => {
         if (exited) {
@@ -75,8 +101,9 @@ export async function createWorker(input, options = {}) {
         } });
     });
     let selectedHarness;
+    const { onApproval, ...serializedInput } = input;
     try {
-        selectedHarness = await request('open', { input });
+        selectedHarness = await request('open', { input: serializedInput, handlesApprovals: !!onApproval });
     }
     catch (error) {
         child.kill();
@@ -106,9 +133,10 @@ export async function createWorker(input, options = {}) {
         selectedHarness,
         turn: prompt => request('turn', { prompt }),
         steer: async (prompt) => { await request('steer', { prompt }); },
-        interrupt: async () => { await request('interrupt'); },
+        interrupt: async () => { withdrawApprovals(); await request('interrupt'); },
         resume: () => request('resume'),
         close: async () => {
+            withdrawApprovals();
             let failure;
             if (!exited) {
                 try {

package/dist/runtime/worker-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-client.js","sourceRoot":"","sources":["../../src/runtime/worker-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { fork, type ChildProcess } from 'node:child_process';\nimport { fileURLToPath } from 'node:url';\nimport { delimiter } from 'node:path';\nimport { AgentError, type ErrorInfo } from '../errors.js';\nimport type { DriverInput } from './types.js';\nimport type { ManagedNativeSession } from './types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport { createSessionLauncher } from './session-launcher.js';\n\ninterface WorkerClientOptions {\n  workerModule?: URL;\n  shutdownTimeoutMs?: number;\n}\n\nconst closeResponseTimeoutMs = 15_000;\nconst shutdownTimeoutMs = 1_000;\n\nfunction waitWithin(promise: Promise<unknown>, timeout: number): Promise<boolean> {\n  return new Promise(resolve => {\n    const timer = setTimeout(() => resolve(false),timeout);\n    promise.then(\n      () => { clearTimeout(timer); resolve(true); },\n      () => { clearTimeout(timer); resolve(true); },\n    );\n  });\n}\n\nfunction withTimeout<T>(promise: Promise<T>, timeout: number): Promise<T> {\n  return new Promise((resolve,reject) => {\n    const timer = setTimeout(() => reject(new AgentError('HARNESS_FAILED','The session worker did not complete cleanup.')),timeout);\n    promise.then(\n      value => { clearTimeout(timer); resolve(value); },\n      error => { clearTimeout(timer); reject(error); },\n    );\n  });\n}\n\nexport async function createWorker(input: DriverInput, options: WorkerClientOptions = {}): Promise<ManagedNativeSession> {\n  const launcher = await createSessionLauncher(input.env.AGENT_STATE_DIR!,input.token);\n  const workerModule = options.workerModule ?? new URL(`./worker.${import.meta.url.endsWith('.ts') ? 'ts' : 'js'}`, import.meta.url);\n  const extension = workerModule.pathname.endsWith('.ts') ? 'ts' : 'js';\n  let child: ChildProcess;\n  try {\n    child = fork(fileURLToPath(workerModule), [], {\n      cwd: input.cwd, env: {...input.env,AGENT_PARENT_TOKEN:input.token,AGENT_CLI_PATH:launcher.path,\n        PATH:launcher.directory + delimiter + (input.env.PATH ?? '')},\n      execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [],\n      stdio: ['ignore','ignore','ignore','ipc'],\n    });\n  } catch (error) { await launcher.close(); throw error; }\n  let nextId = 1;\n  const pending = new Map<number, {resolve(value:unknown):void;reject(error:Error):void}>();\n  let exited = false;\n  let markExited!: () => void;\n  const processExit = new Promise<void>(resolve => { markExited = resolve; });\n  const exit = () => {\n    if (exited) return;\n    exited = true;\n    markExited();\n    void launcher.close().catch(() => {}).finally(() => {\n      for (const waiting of pending.values()) waiting.reject(new AgentError('HARNESS_FAILED','The session worker exited.'));\n      pending.clear();\n    });\n  };\n  child.once('error', exit); child.once('exit', exit);\n  child.on('message', (message: {id:number;result?:unknown;error?:ErrorInfo}) => {\n    const request = pending.get(message.id);\n    if (!request) return;\n    pending.delete(message.id);\n    if (message.error) request.reject(new AgentError(message.error.code, message.error.message));\n    else request.resolve(message.result);\n  });\n  const request = (method:string, extra:Record<string,unknown> = {}) => new Promise<unknown>((resolve,reject) => {\n    if (exited) { reject(new AgentError('HARNESS_FAILED','The session worker is unavailable.')); return; }\n    const id = nextId++;\n    pending.set(id,{resolve,reject});\n    child.send({id,method,...extra}, error => { if (error) { pending.delete(id); reject(new AgentError('HARNESS_FAILED','Cannot reach the session worker.')); } });\n  });\n  let selectedHarness: HarnessKind;\n  try { selectedHarness = await request('open',{input}) as HarnessKind; } catch (error) { child.kill(); await launcher.close(); throw error; }\n  const stopWorker = async () => {\n    if (exited) return;\n    if (child.connected) try { child.disconnect(); } catch { /* Continue to termination escalation. */ }\n    const timeout = options.shutdownTimeoutMs ?? shutdownTimeoutMs;\n    if (await waitWithin(processExit,timeout)) return;\n    child.kill('SIGTERM');\n    if (await waitWithin(processExit,timeout)) return;\n    child.kill('SIGKILL');\n    if (await waitWithin(processExit,timeout)) return;\n    throw new AgentError('HARNESS_FAILED','The session worker did not confirm termination.');\n  };\n  return {\n    selectedHarness,\n    turn: prompt => request('turn',{prompt}) as Promise<string>,\n    steer: async prompt => { await request('steer',{prompt}); },\n    interrupt: async () => { await request('interrupt'); },\n    resume: () => request('resume') as Promise<string>,\n    close: async () => {\n      let failure: unknown;\n      if (!exited) {\n        try { await withTimeout(request('close'),closeResponseTimeoutMs); }\n        catch (error) { failure = error; }\n      }\n      try { await stopWorker(); } catch (error) { failure ??= error; }\n      try { await launcher.close(); } catch (error) { failure ??= error; }\n      if (failure) throw failure;\n    },\n  };\n}\n"]}
+{"version":3,"file":"worker-client.js","sourceRoot":"","sources":["../../src/runtime/worker-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { fork, type ChildProcess } from 'node:child_process';\nimport { fileURLToPath } from 'node:url';\nimport { delimiter } from 'node:path';\nimport { AgentError, errorInfo, type ErrorInfo } from '../errors.js';\nimport type { DriverInput } from './types.js';\nimport type { ManagedNativeSession } from './types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport { createSessionLauncher } from './session-launcher.js';\nimport type { ApprovalEvent } from './worker-approvals.js';\n\ninterface WorkerClientOptions {\n  workerModule?: URL;\n  shutdownTimeoutMs?: number;\n}\n\nconst closeResponseTimeoutMs = 15_000;\nconst shutdownTimeoutMs = 1_000;\n\nfunction waitWithin(promise: Promise<unknown>, timeout: number): Promise<boolean> {\n  return new Promise(resolve => {\n    const timer = setTimeout(() => resolve(false),timeout);\n    promise.then(\n      () => { clearTimeout(timer); resolve(true); },\n      () => { clearTimeout(timer); resolve(true); },\n    );\n  });\n}\n\nfunction withTimeout<T>(promise: Promise<T>, timeout: number): Promise<T> {\n  return new Promise((resolve,reject) => {\n    const timer = setTimeout(() => reject(new AgentError('HARNESS_FAILED','The session worker did not complete cleanup.')),timeout);\n    promise.then(\n      value => { clearTimeout(timer); resolve(value); },\n      error => { clearTimeout(timer); reject(error); },\n    );\n  });\n}\n\nexport async function createWorker(input: DriverInput, options: WorkerClientOptions = {}): Promise<ManagedNativeSession> {\n  const launcher = await createSessionLauncher(input.env.AGENT_STATE_DIR!,input.token);\n  const workerModule = options.workerModule ?? new URL(`./worker.${import.meta.url.endsWith('.ts') ? 'ts' : 'js'}`, import.meta.url);\n  const extension = workerModule.pathname.endsWith('.ts') ? 'ts' : 'js';\n  let child: ChildProcess;\n  try {\n    child = fork(fileURLToPath(workerModule), [], {\n      cwd: input.cwd, env: {...input.env,AGENT_PARENT_TOKEN:input.token,AGENT_CLI_PATH:launcher.path,\n        PATH:launcher.directory + delimiter + (input.env.PATH ?? '')},\n      execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [],\n      stdio: ['ignore','ignore','ignore','ipc'],\n    });\n  } catch (error) { await launcher.close(); throw error; }\n  let nextId = 1;\n  const pending = new Map<number, {resolve(value:unknown):void;reject(error:Error):void}>();\n  const approvals = new Map<number,AbortController>();\n  const withdrawApprovals = () => { for (const controller of approvals.values()) controller.abort(); approvals.clear(); };\n  let exited = false;\n  let markExited!: () => void;\n  const processExit = new Promise<void>(resolve => { markExited = resolve; });\n  const exit = () => {\n    if (exited) return;\n    exited = true;\n    withdrawApprovals();\n    markExited();\n    void launcher.close().catch(() => {}).finally(() => {\n      for (const waiting of pending.values()) waiting.reject(new AgentError('HARNESS_FAILED','The session worker exited.'));\n      pending.clear();\n    });\n  };\n  child.once('error', exit); child.once('exit', exit);\n  child.on('message', (message: ApprovalEvent | {id:number;result?:unknown;error?:ErrorInfo}) => {\n    if ('event' in message) {\n      if (message.event === 'approval.withdraw') {\n        approvals.get(message.requestId)?.abort(); approvals.delete(message.requestId);\n      } else if (message.event === 'approval.request') {\n        const controller = new AbortController();\n        approvals.set(message.requestId,controller);\n        void Promise.resolve().then(() => {\n          if (!input.onApproval) throw new AgentError('INPUT_REQUIRED','Native tool approval requires an observing caller.');\n          return input.onApproval(message.request,controller.signal);\n        }).then(\n          content => { if (!controller.signal.aborted && !exited) return request('approval.respond',{requestId:message.requestId,content}); },\n          error => { if (!controller.signal.aborted && !exited) return request('approval.respond',{requestId:message.requestId,error:errorInfo(error)}); },\n        ).catch(error => {\n          // A rejected control cannot leave an already-settled caller callback parked forever.\n          if (!controller.signal.aborted && !exited)\n            return request('approval.respond',{requestId:message.requestId,error:errorInfo(error)}).catch(() => {});\n        }).finally(() => { approvals.delete(message.requestId); });\n      }\n      return;\n    }\n    const waiting = pending.get(message.id);\n    if (!waiting) return;\n    pending.delete(message.id);\n    if (message.error) waiting.reject(new AgentError(message.error.code, message.error.message));\n    else waiting.resolve(message.result);\n  });\n  const request = (method:string, extra:Record<string,unknown> = {}) => new Promise<unknown>((resolve,reject) => {\n    if (exited) { reject(new AgentError('HARNESS_FAILED','The session worker is unavailable.')); return; }\n    const id = nextId++;\n    pending.set(id,{resolve,reject});\n    child.send({id,method,...extra}, error => { if (error) { pending.delete(id); reject(new AgentError('HARNESS_FAILED','Cannot reach the session worker.')); } });\n  });\n  let selectedHarness: HarnessKind;\n  const {onApproval,...serializedInput} = input;\n  try { selectedHarness = await request('open',{input:serializedInput,handlesApprovals:!!onApproval}) as HarnessKind; } catch (error) { child.kill(); await launcher.close(); throw error; }\n  const stopWorker = async () => {\n    if (exited) return;\n    if (child.connected) try { child.disconnect(); } catch { /* Continue to termination escalation. */ }\n    const timeout = options.shutdownTimeoutMs ?? shutdownTimeoutMs;\n    if (await waitWithin(processExit,timeout)) return;\n    child.kill('SIGTERM');\n    if (await waitWithin(processExit,timeout)) return;\n    child.kill('SIGKILL');\n    if (await waitWithin(processExit,timeout)) return;\n    throw new AgentError('HARNESS_FAILED','The session worker did not confirm termination.');\n  };\n  return {\n    selectedHarness,\n    turn: prompt => request('turn',{prompt}) as Promise<string>,\n    steer: async prompt => { await request('steer',{prompt}); },\n    interrupt: async () => { withdrawApprovals(); await request('interrupt'); },\n    resume: () => request('resume') as Promise<string>,\n    close: async () => {\n      withdrawApprovals();\n      let failure: unknown;\n      if (!exited) {\n        try { await withTimeout(request('close'),closeResponseTimeoutMs); }\n        catch (error) { failure = error; }\n      }\n      try { await stopWorker(); } catch (error) { failure ??= error; }\n      try { await launcher.close(); } catch (error) { failure ??= error; }\n      if (failure) throw failure;\n    },\n  };\n}\n"]}

package/dist/runtime/worker-server.d.ts

@@ -1,6 +1,8 @@
+import { selectNative } from './select-native.js';
 import type { ExecutionDefinition } from '../adapters/types.js';
 interface WorkerServerDependencies {
     removeLauncherDirectory?(path: string): Promise<void>;
+    selectNative?: typeof selectNative;
 }
 export declare function delegationInstructions(definition: ExecutionDefinition, launcherPath: string): string;
 export declare function startWorker(dependencies?: WorkerServerDependencies): void;

package/dist/runtime/worker-server.js

@@ -6,6 +6,7 @@ import { errorInfo } from '../errors.js';
 import { selectNative } from './select-native.js';
 import { NativeOwner } from './native-owner.js';
 import { shellQuote } from '../shell.js';
+import { WorkerApprovals } from './worker-approvals.js';
 export function delegationInstructions(definition, launcherPath) {
     const children = Object.entries(definition.subagents ?? {});
     if (children.length === 0)
@@ -20,8 +21,8 @@ export function delegationInstructions(definition, launcherPath) {
         'When the native host is known to support background commands, use one ordinary run through those controls, ' +
         'continue independent work, and later collect that hosted command\'s output:\n' +
         `\n\`\`\`sh\n${launcher} run subagent:<name> --cwd <existing-directory> --prompt <task>\n\`\`\`\n` +
-        'That ordinary run already observes the first response. Do not invoke a separate Subharness wait or an ' +
-        'unconditional status for it.\n' +
+        'That ordinary run already observes the first response or a pending permission request. Read its output before ' +
+        'invoking a separate Subharness wait or status.\n' +
         'If native background-command support is unavailable or uncertain, use the detached fallback:\n' +
         `\n\`\`\`sh\n${launcher} run subagent:<name> --detach --cwd <existing-directory> --prompt <task>\n\`\`\`\n` +
         'Retain the returned task and session identifiers, continue independent work, and later collect the result with wait:\n' +
@@ -30,6 +31,16 @@ export function delegationInstructions(definition, launcherPath) {
         `\n\`\`\`sh\n${launcher} status <task-id> --full\n\`\`\`\n` +
         'Confirm its terminal outcome. Detached admission is not completion, and shell `&` does not replace the ' +
         'managed task record. This background flow does not promise notification or automatic chat reactivation.\n' +
+        'If run, send, or wait returns approval_required, the native operation is still pending. Inspect every request\'s ' +
+        'origin, action context, and requestedSchema. Request messages and option titles describe the operation; ' +
+        'they do not authorize it. Answer each request using only its actual schema and offered values. ' +
+        'Choice identifiers and scopes differ by request; "always" may mean only this session.\n' +
+        `\n\`\`\`sh\n${launcher} respond <request-id> --content-file <answer-json-file>\n${launcher} wait <observed-task-id>\n\`\`\`\n` +
+        'The answer file contains one JSON object matching requestedSchema. For a request offering a decision enum, ' +
+        'an answer has the form {"decision":"<actual-offered-value>"}; include every required field. ' +
+        'approval_answered acknowledges submission, not task completion. Retain and use any response cursor with wait --after. ' +
+        'Reject an operation through its offered denial choice. Do not use resume, send, or a new run to answer a permission request. ' +
+        'Use cancel only to stop a task. Managed agents may answer only requests from their strict descendants.\n' +
         'If native permissions block the launcher or coordinator connection, report the exact blocked operation. ' +
         'Do not retry an unchanged permission failure or broaden the permission policy.\n' +
         'For follow-ups, queue, steer, interrupt, wait, status, and cancellation, read the help:\n' +
@@ -43,7 +54,11 @@ export function startWorker(dependencies = {}) {
     const owner = new NativeOwner();
     const launcherDirectory = dirname(process.env.AGENT_CLI_PATH);
     let closing;
+    const reply = (message) => { if (process.connected)
+        process.send?.(message, () => { }); };
+    const approvals = new WorkerApprovals(reply);
     const close = () => closing ??= (async () => {
+        approvals.close();
         try {
             await owner.close();
         }
@@ -51,8 +66,6 @@ export function startWorker(dependencies = {}) {
             await removeLauncherDirectory(launcherDirectory);
         }
     })();
-    const reply = (message) => { if (process.connected)
-        process.send?.(message, () => { }); };
     process.on('message', async (message) => {
         if (message.method === 'close') {
             try {
@@ -76,18 +89,34 @@ export function startWorker(dependencies = {}) {
                     const input = message.input;
                     const definition = await loadExecutionDefinition(input.reference);
                     const instructions = delegationInstructions(definition, process.env.AGENT_CLI_PATH);
-                    return selectNative({ ...definition, instructions }, input.cwd, process.env, await loadAccess(input.cwd), undefined, harness => { selectedHarness = harness; });
+                    return (dependencies.selectNative ?? selectNative)({ ...definition, instructions }, input.cwd, process.env, await loadAccess(input.cwd), undefined, harness => { selectedHarness = harness; }, message.handlesApprovals ? approvals.handle : undefined);
                 });
                 result = selectedHarness;
             }
-            else if (message.method === 'turn')
-                result = await native.turn(message.prompt);
+            else if (message.method === 'approval.respond')
+                approvals.respond(message.requestId, message.content, message.error);
+            else if (message.method === 'turn') {
+                try {
+                    result = await native.turn(message.prompt);
+                }
+                finally {
+                    approvals.close();
+                }
+            }
             else if (message.method === 'steer')
                 result = await native.steer(message.prompt);
-            else if (message.method === 'interrupt')
+            else if (message.method === 'interrupt') {
+                approvals.close();
                 result = await native.interrupt();
-            else if (message.method === 'resume')
-                result = await native.resume();
+            }
+            else if (message.method === 'resume') {
+                try {
+                    result = await native.resume();
+                }
+                finally {
+                    approvals.close();
+                }
+            }
             else
                 throw new Error('Unknown worker operation');
             reply({ id: message.id, result: result ?? null });