subharness 0.0.5 → 0.0.7

package/dist/runtime/transport.js

@@ -0,0 +1,166 @@
+import { AgentError } from '../errors.js';
+export class CoordinatorTransport {
+    endpoint;
+    closed = new AbortController();
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    disconnect() { this.closed.abort(); }
+    async one(body, signal) {
+        let value;
+        let count = 0;
+        for await (const record of this.records(body, signal)) {
+            throwRemote(record);
+            value = record;
+            count++;
+            if (count > 1)
+                throw unavailable('The coordinator returned too many records for one operation.');
+        }
+        if (count !== 1)
+            throw unavailable('The coordinator returned no record for the operation.');
+        return value;
+    }
+    stream(body, signal) {
+        const transport = this;
+        return { [Symbol.asyncIterator]() {
+                const lifetime = new AbortController();
+                const observerSignal = signal ? AbortSignal.any([signal, lifetime.signal]) : lifetime.signal;
+                const source = transport.records(body, observerSignal)[Symbol.asyncIterator]();
+                return {
+                    async next() {
+                        const result = await source.next();
+                        if (result.done)
+                            return { done: true, value: undefined };
+                        throwRemote(result.value);
+                        return { done: false, value: result.value };
+                    },
+                    async return() {
+                        lifetime.abort();
+                        try {
+                            await source.return?.(undefined);
+                        }
+                        catch { }
+                        return { done: true, value: undefined };
+                    },
+                    async throw(error) {
+                        lifetime.abort();
+                        if (source.throw)
+                            return source.throw(error);
+                        throw error;
+                    },
+                };
+            } };
+    }
+    async *records(body, signal, options = {}) {
+        this.assertOpen();
+        const operation = operationName(body);
+        const combined = signal
+            ? AbortSignal.any([this.closed.signal, signal])
+            : this.closed.signal;
+        let response;
+        try {
+            response = await fetch(this.endpoint.url, {
+                method: 'POST',
+                headers: { authorization: `Bearer ${this.endpoint.token}`, 'content-type': 'application/json',
+                    'x-subharness-instance': this.endpoint.instanceId },
+                body: JSON.stringify(body),
+                signal: combined,
+            });
+        }
+        catch {
+            if (signal?.aborted)
+                throw new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.');
+            throw unavailable('Connection to the local coordinator failed. The task was not automatically retried.');
+        }
+        if (!response.ok) {
+            void response.body?.cancel().catch(() => { });
+            if (response.status === 401)
+                throw new AgentError('COORDINATOR_AUTH_FAILED', 'The local coordinator rejected its private authentication token.');
+            throw unavailable(`The coordinator rejected ${operation ? `the ${operation} operation` : 'the request'} with HTTP status ${response.status}.`);
+        }
+        if (!response.body)
+            throw unavailable(`The coordinator returned a successful response with no body${operation ? ` for the ${operation} operation` : ''}.`);
+        let buffer = '';
+        const decoder = new TextDecoder();
+        const reader = response.body.getReader();
+        let complete = false;
+        try {
+            for (;;) {
+                const result = await reader.read();
+                if (result.done) {
+                    complete = true;
+                    break;
+                }
+                const chunk = result.value;
+                buffer += decoder.decode(chunk, { stream: true });
+                let newline;
+                while ((newline = buffer.indexOf('\n')) >= 0) {
+                    const line = buffer.slice(0, newline);
+                    buffer = buffer.slice(newline + 1);
+                    if (!line)
+                        continue;
+                    try {
+                        yield JSON.parse(line);
+                    }
+                    catch {
+                        throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+                    }
+                }
+            }
+            buffer += decoder.decode();
+            if (buffer.trim()) {
+                if (options.allowFinalRecord) {
+                    try {
+                        yield JSON.parse(buffer);
+                    }
+                    catch {
+                        throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+                    }
+                }
+                else
+                    throw unavailable(`The coordinator response ended with an incomplete final record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+            }
+        }
+        catch (error) {
+            if (error instanceof AgentError)
+                throw error;
+            if (signal?.aborted)
+                throw new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.');
+            throw unavailable('The coordinator response stream was interrupted. The task was not automatically retried.');
+        }
+        finally {
+            if (!complete)
+                await reader.cancel().catch(() => { });
+            reader.releaseLock();
+        }
+    }
+    assertOpen() {
+        if (this.closed.signal.aborted)
+            throw unavailable('The coordinator client is disconnected.');
+    }
+}
+function throwRemote(value) {
+    if (!value || typeof value !== 'object' || value.type !== 'error')
+        return;
+    const record = value;
+    if (!record.error || typeof record.error.code !== 'string' || typeof record.error.message !== 'string')
+        throw unavailable('The coordinator returned a malformed error record.');
+    throw new AgentError(record.error.code, record.error.message);
+}
+function operationName(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return;
+    const command = body.command;
+    return typeof command === 'string' && operations.has(command) ? command : undefined;
+}
+const operations = new Set([
+    'dashboard', 'dashboard-session', 'dashboard-detail', 'parent', 'run', 'send', 'resume', 'wait', 'status', 'queue', 'cancel', 'respond',
+    'sdk-agent-list', 'sdk-agent-check',
+    'sdk-session-create', 'sdk-session-get', 'sdk-session-list', 'sdk-session-prompt', 'sdk-session-close',
+    'sdk-task-get', 'sdk-task-list', 'sdk-task-snapshot', 'sdk-task-inspect', 'sdk-task-result', 'sdk-task-watch',
+    'sdk-task-responses', 'sdk-task-cancel', 'sdk-approval-respond',
+]);
+function unavailable(message) {
+    return new AgentError('COORDINATOR_UNAVAILABLE', message);
+}
+//# sourceMappingURL=transport.js.map

package/dist/runtime/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/runtime/transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport type { Endpoint } from './state.js';\n\ninterface ErrorRecord {\n  readonly version: 1;\n  readonly type: 'error';\n  readonly error: {readonly code:string;readonly message:string};\n}\n\nexport class CoordinatorTransport {\n  private readonly closed = new AbortController();\n  constructor(readonly endpoint:Endpoint) {}\n\n  disconnect(): void { this.closed.abort(); }\n\n  async one<T>(body:unknown,signal?:AbortSignal):Promise<T> {\n    let value:T|undefined;\n    let count=0;\n    for await (const record of this.records(body,signal)) {\n      throwRemote(record);\n      value=record as T;\n      count++;\n      if (count > 1) throw unavailable('The coordinator returned too many records for one operation.');\n    }\n    if (count !== 1) throw unavailable('The coordinator returned no record for the operation.');\n    return value!;\n  }\n\n  stream<T>(body:unknown,signal?:AbortSignal):AsyncIterable<T> {\n    const transport=this;\n    return {[Symbol.asyncIterator]():AsyncIterator<T> {\n      const lifetime=new AbortController();\n      const observerSignal=signal ? AbortSignal.any([signal,lifetime.signal]) : lifetime.signal;\n      const source=transport.records(body,observerSignal)[Symbol.asyncIterator]();\n      return {\n        async next() {\n          const result=await source.next();\n          if(result.done)return {done:true,value:undefined};\n          throwRemote(result.value);\n          return {done:false,value:result.value as T};\n        },\n        async return() {\n          lifetime.abort();\n          try{await source.return?.(undefined);}catch{}\n          return {done:true,value:undefined};\n        },\n        async throw(error?:unknown) {\n          lifetime.abort();\n          if(source.throw)return source.throw(error) as Promise<IteratorResult<T>>;\n          throw error;\n        },\n      };\n    }};\n  }\n\n  async *records(body:unknown,signal?:AbortSignal,options:{allowFinalRecord?:boolean}={}):AsyncGenerator<unknown> {\n    this.assertOpen();\n    const operation=operationName(body);\n    const combined=signal\n      ? AbortSignal.any([this.closed.signal,signal])\n      : this.closed.signal;\n    let response:Response;\n    try {\n      response=await fetch(this.endpoint.url,{\n        method:'POST',\n        headers:{authorization:`Bearer ${this.endpoint.token}`,'content-type':'application/json',\n          'x-subharness-instance':this.endpoint.instanceId},\n        body:JSON.stringify(body),\n        signal:combined,\n      });\n    } catch {\n      if (signal?.aborted) throw new AgentError('OBSERVATION_CLOSED','The observer disconnected.');\n      throw unavailable('Connection to the local coordinator failed. The task was not automatically retried.');\n    }\n    if (!response.ok) {\n      void response.body?.cancel().catch(()=>{});\n      if (response.status === 401)\n        throw new AgentError('COORDINATOR_AUTH_FAILED','The local coordinator rejected its private authentication token.');\n      throw unavailable(`The coordinator rejected ${operation ? `the ${operation} operation` : 'the request'} with HTTP status ${response.status}.`);\n    }\n    if (!response.body) throw unavailable(\n      `The coordinator returned a successful response with no body${operation ? ` for the ${operation} operation` : ''}.`);\n    let buffer='';\n    const decoder=new TextDecoder();\n    const reader=response.body.getReader();\n    let complete=false;\n    try {\n      for (;;) {\n        const result=await reader.read();\n        if (result.done) { complete=true; break; }\n        const chunk=result.value;\n        buffer+=decoder.decode(chunk,{stream:true});\n        let newline:number;\n        while ((newline=buffer.indexOf('\\n')) >= 0) {\n          const line=buffer.slice(0,newline); buffer=buffer.slice(newline+1);\n          if (!line) continue;\n          try { yield JSON.parse(line) as unknown; }\n          catch { throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`); }\n        }\n      }\n      buffer+=decoder.decode();\n      if (buffer.trim()) {\n        if (options.allowFinalRecord) {\n          try { yield JSON.parse(buffer) as unknown; }\n          catch { throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`); }\n        } else throw unavailable(\n          `The coordinator response ended with an incomplete final record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);\n      }\n    } catch (error) {\n      if (error instanceof AgentError) throw error;\n      if (signal?.aborted) throw new AgentError('OBSERVATION_CLOSED','The observer disconnected.');\n      throw unavailable('The coordinator response stream was interrupted. The task was not automatically retried.');\n    } finally {\n      if (!complete) await reader.cancel().catch(()=>{});\n      reader.releaseLock();\n    }\n  }\n\n  private assertOpen():void {\n    if (this.closed.signal.aborted) throw unavailable('The coordinator client is disconnected.');\n  }\n}\n\nfunction throwRemote(value:unknown):void {\n  if (!value || typeof value !== 'object' || (value as {type?:unknown}).type !== 'error') return;\n  const record=value as Partial<ErrorRecord>;\n  if (!record.error || typeof record.error.code !== 'string' || typeof record.error.message !== 'string')\n    throw unavailable('The coordinator returned a malformed error record.');\n  throw new AgentError(record.error.code,record.error.message);\n}\n\nfunction operationName(body:unknown):string|undefined {\n  if (!body || typeof body !== 'object' || Array.isArray(body)) return;\n  const command=(body as {command?:unknown}).command;\n  return typeof command === 'string' && operations.has(command) ? command : undefined;\n}\n\nconst operations=new Set([\n  'dashboard','dashboard-session','dashboard-detail','parent','run','send','resume','wait','status','queue','cancel','respond',\n  'sdk-agent-list','sdk-agent-check',\n  'sdk-session-create','sdk-session-get','sdk-session-list','sdk-session-prompt','sdk-session-close',\n  'sdk-task-get','sdk-task-list','sdk-task-snapshot','sdk-task-inspect','sdk-task-result','sdk-task-watch',\n  'sdk-task-responses','sdk-task-cancel','sdk-approval-respond',\n]);\n\nfunction unavailable(message:string):AgentError {\n  return new AgentError('COORDINATOR_UNAVAILABLE',message);\n}\n"]}

package/dist/runtime/types.d.ts

@@ -2,8 +2,10 @@ 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';
-import type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';
-export type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
+import type { ApprovalHandler } from '../approvals/types.js';
+import type { AgentDefinition } from '../sdk/types.js';
+import type { ApprovalRequest, TaskState } from './task-data.js';
+export type { ApprovalRequest, TaskState } from './task-data.js';
 export type Delivery = 'queue' | 'steer' | 'interrupt';
 export interface AgentReference {
     file: string;
@@ -13,7 +15,11 @@ export interface HarnessReference {
     kind: 'harness';
     harness: HarnessRequest;
 }
-export type ExecutionReference = AgentReference | HarnessReference;
+export interface InlineReference {
+    kind: 'inline';
+    definition: AgentDefinition;
+}
+export type ExecutionReference = AgentReference | HarnessReference | InlineReference;
 export interface SessionInput {
     reference: ExecutionReference;
     cwd: string;
@@ -21,6 +27,7 @@ export interface SessionInput {
     prompt: string;
     parentToken?: string;
 }
+export type SessionCreateInput = Omit<SessionInput, 'prompt' | 'parentToken'>;
 export interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> {
     token: string;
     sessionId: string;
@@ -30,6 +37,10 @@ export type ManagedNativeSession = NativeSession & {
     selectedHarness?: HarnessKind;
 };
 export type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;
+export interface PreparedExecution {
+    open(input: DriverInput): Promise<ManagedNativeSession>;
+    close(): Promise<void>;
+}
 export interface RecordBase {
     version: 1;
     type: string;
@@ -37,17 +48,13 @@ 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[];
+    stopUnconfirmed?: boolean;
 }
 export interface Receipt extends RecordBase {
     delivery?: Delivery;
@@ -85,19 +92,31 @@ export interface Task {
     failedAt?: number;
     finishedAt?: number;
     updatedAt: number;
+    revision: number;
+    ordinal: number;
+    membership: number;
     changed: Set<() => void>;
+    watchers: Set<() => void>;
 }
 export interface Session {
     id: string;
     token: string;
-    input: SessionInput;
+    input: SessionCreateInput;
     driver?: Promise<ManagedNativeSession>;
+    prepared?: PreparedExecution;
+    preparedClosed?: boolean;
     tasks: string[];
     active?: string;
     paused: boolean;
     commands: Promise<unknown>;
     controls: number;
+    nextOrdinal: number;
+    membership: number;
     harness: DashboardHarness;
+    selectedHarness?: HarnessKind;
     workspace: Promise<DashboardWorkspace>;
+    state: 'open' | 'closing' | 'closed';
+    closePromise?: Promise<void>;
+    driverClosed?: boolean;
 }
 export declare const terminal: (state: TaskState) => boolean;

package/dist/runtime/types.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAmDA,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 } from '../approvals/types.js';\nimport type { AgentDefinition } from '../sdk/types.js';\nimport type { ApprovalRequest, TaskState } from './task-data.js';\n\nexport type { ApprovalRequest, TaskState } from './task-data.js';\n\nexport type Delivery = 'queue' | 'steer' | 'interrupt';\nexport interface AgentReference { file: string; subagents: string[] }\nexport interface HarnessReference { kind: 'harness'; harness: HarnessRequest }\nexport interface InlineReference { kind: 'inline'; definition: AgentDefinition }\nexport type ExecutionReference = AgentReference | HarnessReference | InlineReference;\nexport interface SessionInput { reference: ExecutionReference; cwd: string; env: NodeJS.ProcessEnv; prompt: string; parentToken?: string }\nexport type SessionCreateInput = Omit<SessionInput, 'prompt' | 'parentToken'>;\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 PreparedExecution {\n  open(input: DriverInput): Promise<ManagedNativeSession>;\n  close(): Promise<void>;\n}\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface Observation extends RecordBase {\n  state: TaskState; responseId?: string; text?: string; error?: ErrorInfo; requests?: ApprovalRequest[];\n  stopUnconfirmed?: boolean;\n}\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; revision: number;\n  ordinal: number; membership: number;\n  changed: Set<() => void>; watchers: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionCreateInput; driver?: Promise<ManagedNativeSession>;\n  prepared?: PreparedExecution; preparedClosed?: boolean;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\n  nextOrdinal: number; membership: number;\n  harness: DashboardHarness; selectedHarness?: HarnessKind; workspace: Promise<DashboardWorkspace>;\n  state: 'open' | 'closing' | 'closed'; closePromise?: Promise<void>; driverClosed?: boolean;\n}\nexport const terminal = (state: TaskState) => ['completed', 'failed', 'cancelled', 'interrupted'].includes(state);\n"]}

package/dist/runtime/worker-client.js

@@ -28,6 +28,8 @@ function withTimeout(promise, timeout) {
     });
 }
 export async function createWorker(input, options = {}) {
+    if ('kind' in input.reference && input.reference.kind === 'inline')
+        throw new AgentError('INVALID_DEFINITION', 'Inline agent definitions cannot be loaded by native CLI workers.');
     const launcher = await createSessionLauncher(input.env.AGENT_STATE_DIR, input.token);
     const workerModule = options.workerModule ?? new URL(`./worker.${import.meta.url.endsWith('.ts') ? 'ts' : 'js'}`, import.meta.url);
     const extension = workerModule.pathname.endsWith('.ts') ? 'ts' : 'js';

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, 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';\nimport { processExitDescription } from '../process-diagnostics.js';\n\ninterface WorkerClientOptions {\n  workerModule?: URL;\n  shutdownTimeoutMs?: number;\n}\n\nconst closeResponseTimeoutMs = 15_000;\nconst shutdownTimeoutMs = 1_000;\n\nconst workerOperationLabels: Record<string,string> = {\n  open:'startup',\n  turn:'turn submission',\n  steer:'steering',\n  interrupt:'interruption',\n  resume:'recovery',\n  close:'closing',\n  'approval.respond':'approval response',\n};\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 { await launcher.close(); throw new AgentError('HARNESS_FAILED','The session worker could not be spawned during startup.'); }\n  let nextId = 1;\n  const pending = new Map<number, {operation:string;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 closing = false;\n  let observedExit = '';\n  let markExited!: () => void;\n  const processExit = new Promise<void>(resolve => { markExited = resolve; });\n  const exit = (code: unknown, signal: unknown, spawnFailure = false) => {\n    if (exited) return;\n    exited = true;\n    observedExit = spawnFailure || closing ? '' : processExitDescription(code,signal);\n    withdrawApprovals();\n    markExited();\n    void launcher.close().catch(() => {}).finally(() => {\n      for (const waiting of pending.values()) {\n        waiting.reject(new AgentError('HARNESS_FAILED', spawnFailure\n          ? `The session worker process failed while ${waiting.operation} was pending.`\n          : `The session worker exited while ${waiting.operation} was pending${observedExit}.`));\n      }\n      pending.clear();\n    });\n  };\n  child.once('error', () => exit(undefined,undefined,true));\n  child.once('exit', (code,signal) => exit(code,signal));\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    const operation = workerOperationLabels[method] ?? 'native operation';\n    if (exited) {\n      reject(new AgentError('HARNESS_FAILED',`The session worker is unavailable while ${operation} was pending${observedExit}.`));\n      return;\n    }\n    const id = nextId++;\n    pending.set(id,{operation,resolve,reject});\n    child.send({id,method,...extra}, error => {\n      if (!error) return;\n      setImmediate(() => {\n        const waiting = pending.get(id);\n        if (!waiting || exited) return;\n        pending.delete(id);\n        waiting.reject(new AgentError('HARNESS_FAILED',`Cannot reach the session worker while ${operation} was pending.`));\n      });\n    });\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      closing = true;\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"]}
+{"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';\nimport { processExitDescription } from '../process-diagnostics.js';\n\ninterface WorkerClientOptions {\n  workerModule?: URL;\n  shutdownTimeoutMs?: number;\n}\n\nconst closeResponseTimeoutMs = 15_000;\nconst shutdownTimeoutMs = 1_000;\n\nconst workerOperationLabels: Record<string,string> = {\n  open:'startup',\n  turn:'turn submission',\n  steer:'steering',\n  interrupt:'interruption',\n  resume:'recovery',\n  close:'closing',\n  'approval.respond':'approval response',\n};\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  if ('kind' in input.reference && input.reference.kind === 'inline')\n    throw new AgentError('INVALID_DEFINITION', 'Inline agent definitions cannot be loaded by native CLI workers.');\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 { await launcher.close(); throw new AgentError('HARNESS_FAILED','The session worker could not be spawned during startup.'); }\n  let nextId = 1;\n  const pending = new Map<number, {operation:string;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 closing = false;\n  let observedExit = '';\n  let markExited!: () => void;\n  const processExit = new Promise<void>(resolve => { markExited = resolve; });\n  const exit = (code: unknown, signal: unknown, spawnFailure = false) => {\n    if (exited) return;\n    exited = true;\n    observedExit = spawnFailure || closing ? '' : processExitDescription(code,signal);\n    withdrawApprovals();\n    markExited();\n    void launcher.close().catch(() => {}).finally(() => {\n      for (const waiting of pending.values()) {\n        waiting.reject(new AgentError('HARNESS_FAILED', spawnFailure\n          ? `The session worker process failed while ${waiting.operation} was pending.`\n          : `The session worker exited while ${waiting.operation} was pending${observedExit}.`));\n      }\n      pending.clear();\n    });\n  };\n  child.once('error', () => exit(undefined,undefined,true));\n  child.once('exit', (code,signal) => exit(code,signal));\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    const operation = workerOperationLabels[method] ?? 'native operation';\n    if (exited) {\n      reject(new AgentError('HARNESS_FAILED',`The session worker is unavailable while ${operation} was pending${observedExit}.`));\n      return;\n    }\n    const id = nextId++;\n    pending.set(id,{operation,resolve,reject});\n    child.send({id,method,...extra}, error => {\n      if (!error) return;\n      setImmediate(() => {\n        const waiting = pending.get(id);\n        if (!waiting || exited) return;\n        pending.delete(id);\n        waiting.reject(new AgentError('HARNESS_FAILED',`Cannot reach the session worker while ${operation} was pending.`));\n      });\n    });\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      closing = true;\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.js

@@ -1,8 +1,8 @@
-import { dirname } from 'node:path';
+import { delimiter, dirname } from 'node:path';
 import { rm } from 'node:fs/promises';
-import { loadExecutionDefinition } from './definition.js';
+import { captureExecutionDefinition, loadExecutionDefinition } from './definition.js';
 import { loadAccess } from '../config/access.js';
-import { errorInfo } from '../errors.js';
+import { AgentError, errorInfo } from '../errors.js';
 import { selectNative } from './select-native.js';
 import { NativeOwner } from './native-owner.js';
 import { shellQuote } from '../shell.js';
@@ -50,20 +50,39 @@ export function delegationInstructions(definition, launcherPath) {
 export function startWorker(dependencies = {}) {
     const removeLauncherDirectory = dependencies.removeLauncherDirectory ??
         ((path) => rm(path, { recursive: true, force: true }));
-    let native;
-    const owner = new NativeOwner();
-    const launcherDirectory = dirname(process.env.AGENT_CLI_PATH);
+    const leases = new Map();
+    let nextLeaseId = 1;
+    const legacyLauncher = process.env.AGENT_CLI_PATH;
+    const launcherDirectory = legacyLauncher ? dirname(legacyLauncher) : undefined;
     let closing;
     const reply = (message) => { if (process.connected)
         process.send?.(message, () => { }); };
-    const approvals = new WorkerApprovals(reply);
+    const newLease = (definition, reference) => {
+        const leaseId = nextLeaseId++;
+        const approvals = new WorkerApprovals(event => reply({ ...event, leaseId }));
+        leases.set(leaseId, { definition, reference, owner: new NativeOwner(), approvals });
+        return leaseId;
+    };
+    const childSummary = (definition) => Object.entries(definition.subagents ?? {})
+        .map(([name, child]) => ({ name, description: child.description }));
+    const closeLease = async (leaseId) => {
+        const lease = leases.get(leaseId);
+        if (!lease)
+            return;
+        lease.approvals.close();
+        await lease.owner.close();
+        leases.delete(leaseId);
+    };
     const close = () => closing ??= (async () => {
-        approvals.close();
         try {
-            await owner.close();
+            const results = await Promise.allSettled([...leases.keys()].map(closeLease));
+            const failure = results.find(result => result.status === 'rejected');
+            if (failure?.status === 'rejected')
+                throw failure.reason;
         }
         finally {
-            await removeLauncherDirectory(launcherDirectory);
+            if (launcherDirectory)
+                await removeLauncherDirectory(launcherDirectory);
         }
     })();
     process.on('message', async (message) => {
@@ -83,43 +102,105 @@ export function startWorker(dependencies = {}) {
         }
         try {
             let result;
-            if (message.method === 'open') {
-                let selectedHarness;
-                native = await owner.open(async () => {
+            if (message.method === 'capture') {
+                const captured = await captureExecutionDefinition(message.agent, process.cwd());
+                const leaseId = newLease(captured.definition, captured.reference);
+                result = { leaseId, reference: captured.reference, children: childSummary(captured.definition) };
+            }
+            else if (message.method === 'capture.reference') {
+                const reference = message.reference;
+                const definition = await loadExecutionDefinition(reference);
+                const leaseId = newLease(definition, reference);
+                result = { leaseId, reference, children: childSummary(definition) };
+            }
+            else if (message.method === 'child') {
+                const parent = leases.get(message.leaseId);
+                const child = parent?.definition.subagents?.[message.name];
+                if (!parent || !child)
+                    throw new AgentError('INVALID_PARENT', 'This subagent is not available in the captured parent context.');
+                const parentReference = parent.reference;
+                const reference = 'file' in parentReference
+                    ? { file: parentReference.file, subagents: [...parentReference.subagents, message.name] }
+                    : parentReference;
+                const leaseId = newLease(child, reference);
+                result = { leaseId, reference, children: childSummary(child) };
+            }
+            else if (message.method === 'open') {
+                let lease;
+                if (message.leaseId === undefined) {
                     const input = message.input;
                     const definition = await loadExecutionDefinition(input.reference);
-                    const instructions = delegationInstructions(definition, process.env.AGENT_CLI_PATH);
-                    return (dependencies.selectNative ?? selectNative)({ ...definition, instructions }, input.cwd, process.env, await loadAccess(input.cwd), undefined, harness => { selectedHarness = harness; }, message.handlesApprovals ? approvals.handle : undefined);
+                    const leaseId = newLease(definition, input.reference);
+                    lease = leases.get(leaseId);
+                    message.leaseId = leaseId;
+                }
+                else {
+                    const retained = leases.get(message.leaseId);
+                    if (!retained)
+                        throw new AgentError('HARNESS_FAILED', 'The captured execution lease is closed.');
+                    lease = retained;
+                }
+                if (lease.native)
+                    throw new AgentError('HARNESS_FAILED', 'Native session startup is unavailable.');
+                let selectedHarness;
+                const current = lease;
+                const input = message.input;
+                const launcherPath = message.launcherPath ?? legacyLauncher;
+                const sessionEnvironment = { ...input.env, AGENT_PARENT_TOKEN: input.token, AGENT_CLI_PATH: launcherPath,
+                    PATH: dirname(launcherPath) + delimiter + (input.env.PATH ?? '') };
+                current.native = await current.owner.open(async () => {
+                    const instructions = delegationInstructions(current.definition, launcherPath);
+                    return (dependencies.selectNative ?? selectNative)({ ...current.definition, instructions }, input.cwd, sessionEnvironment, await loadAccess(input.cwd), undefined, harness => { selectedHarness = harness; }, message.handlesApprovals ? current.approvals.handle : undefined);
                 });
+                current.selectedHarness = selectedHarness;
                 result = selectedHarness;
             }
-            else if (message.method === 'approval.respond')
-                approvals.respond(message.requestId, message.content, message.error);
+            else if (message.method === 'approval.respond') {
+                const lease = message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId);
+                lease?.approvals.respond(message.requestId, message.content, message.error);
+            }
             else if (message.method === 'turn') {
+                const lease = message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId);
                 try {
-                    result = await native.turn(message.prompt);
+                    result = await lease.native.turn(message.prompt);
                 }
                 finally {
-                    approvals.close();
+                    lease.approvals.close();
                 }
             }
             else if (message.method === 'steer')
-                result = await native.steer(message.prompt);
+                result = await (message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId)).native.steer(message.prompt);
             else if (message.method === 'interrupt') {
-                approvals.close();
-                result = await native.interrupt();
+                const lease = (message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId));
+                lease.approvals.close();
+                result = await lease.native.interrupt();
             }
             else if (message.method === 'resume') {
+                const lease = (message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId));
                 try {
-                    result = await native.resume();
+                    result = await lease.native.resume();
                 }
                 finally {
-                    approvals.close();
+                    lease.approvals.close();
                 }
             }
+            else if (message.method === 'native.close') {
+                const lease = message.leaseId === undefined ? [...leases.values()][0] : leases.get(message.leaseId);
+                if (lease) {
+                    lease.approvals.close();
+                    await lease.owner.close();
+                }
+            }
+            else if (message.method === 'lease.close') {
+                await closeLease(message.leaseId);
+                result = null;
+            }
             else
                 throw new Error('Unknown worker operation');
             reply({ id: message.id, result: result ?? null });
+            if (message.method === 'lease.close' && leases.size === 0)
+                setImmediate(() => { if (process.connected)
+                    process.disconnect(); });
         }
         catch (error) {
             reply({ id: message.id, error: errorInfo(error) });