subharness 0.0.4 → 0.0.7

package/dist/runtime/worker-client.js

@@ -3,8 +3,18 @@ import { fileURLToPath } from 'node:url';
 import { delimiter } from 'node:path';
 import { AgentError, errorInfo } from '../errors.js';
 import { createSessionLauncher } from './session-launcher.js';
+import { processExitDescription } from '../process-diagnostics.js';
 const closeResponseTimeoutMs = 15_000;
 const shutdownTimeoutMs = 1_000;
+const workerOperationLabels = {
+    open: 'startup',
+    turn: 'turn submission',
+    steer: 'steering',
+    interrupt: 'interruption',
+    resume: 'recovery',
+    close: 'closing',
+    'approval.respond': 'approval response',
+};
 function waitWithin(promise, timeout) {
     return new Promise(resolve => {
         const timer = setTimeout(() => resolve(false), timeout);
@@ -18,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';
@@ -30,9 +42,9 @@ export async function createWorker(input, options = {}) {
             stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
         });
     }
-    catch (error) {
+    catch {
         await launcher.close();
-        throw error;
+        throw new AgentError('HARNESS_FAILED', 'The session worker could not be spawned during startup.');
     }
     let nextId = 1;
     const pending = new Map();
@@ -40,22 +52,28 @@ export async function createWorker(input, options = {}) {
     const withdrawApprovals = () => { for (const controller of approvals.values())
         controller.abort(); approvals.clear(); };
     let exited = false;
+    let closing = false;
+    let observedExit = '';
     let markExited;
     const processExit = new Promise(resolve => { markExited = resolve; });
-    const exit = () => {
+    const exit = (code, signal, spawnFailure = false) => {
         if (exited)
             return;
         exited = true;
+        observedExit = spawnFailure || closing ? '' : processExitDescription(code, signal);
         withdrawApprovals();
         markExited();
         void launcher.close().catch(() => { }).finally(() => {
-            for (const waiting of pending.values())
-                waiting.reject(new AgentError('HARNESS_FAILED', 'The session worker exited.'));
+            for (const waiting of pending.values()) {
+                waiting.reject(new AgentError('HARNESS_FAILED', spawnFailure
+                    ? `The session worker process failed while ${waiting.operation} was pending.`
+                    : `The session worker exited while ${waiting.operation} was pending${observedExit}.`));
+            }
             pending.clear();
         });
     };
-    child.once('error', exit);
-    child.once('exit', exit);
+    child.once('error', () => exit(undefined, undefined, true));
+    child.once('exit', (code, signal) => exit(code, signal));
     child.on('message', (message) => {
         if ('event' in message) {
             if (message.event === 'approval.withdraw') {
@@ -89,16 +107,24 @@ export async function createWorker(input, options = {}) {
             waiting.resolve(message.result);
     });
     const request = (method, extra = {}) => new Promise((resolve, reject) => {
+        const operation = workerOperationLabels[method] ?? 'native operation';
         if (exited) {
-            reject(new AgentError('HARNESS_FAILED', 'The session worker is unavailable.'));
+            reject(new AgentError('HARNESS_FAILED', `The session worker is unavailable while ${operation} was pending${observedExit}.`));
             return;
         }
         const id = nextId++;
-        pending.set(id, { resolve, reject });
-        child.send({ id, method, ...extra }, error => { if (error) {
-            pending.delete(id);
-            reject(new AgentError('HARNESS_FAILED', 'Cannot reach the session worker.'));
-        } });
+        pending.set(id, { operation, resolve, reject });
+        child.send({ id, method, ...extra }, error => {
+            if (!error)
+                return;
+            setImmediate(() => {
+                const waiting = pending.get(id);
+                if (!waiting || exited)
+                    return;
+                pending.delete(id);
+                waiting.reject(new AgentError('HARNESS_FAILED', `Cannot reach the session worker while ${operation} was pending.`));
+            });
+        });
     });
     let selectedHarness;
     const { onApproval, ...serializedInput } = input;
@@ -136,6 +162,7 @@ export async function createWorker(input, options = {}) {
         interrupt: async () => { withdrawApprovals(); await request('interrupt'); },
         resume: () => request('resume'),
         close: async () => {
+            closing = true;
             withdrawApprovals();
             let failure;
             if (!exited) {

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';\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"]}
+{"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) });

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

@@ -1 +1 @@
-{"version":3,"file":"worker-server.js","sourceRoot":"","sources":["../../src/runtime/worker-server.ts"],"names":[],"mappings":"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","sourcesContent":["import { dirname } from 'node:path';\nimport { rm } from 'node:fs/promises';\nimport { loadExecutionDefinition } from './definition.js';\nimport { loadAccess } from '../config/access.js';\nimport { errorInfo, type ErrorInfo } from '../errors.js';\nimport { selectNative } from './select-native.js';\nimport { NativeOwner } from './native-owner.js';\nimport type { DriverInput } from './types.js';\nimport type { ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport { shellQuote } from '../shell.js';\nimport { WorkerApprovals } from './worker-approvals.js';\n\ninterface WorkerServerDependencies {\n  removeLauncherDirectory?(path: string): Promise<void>;\n  selectNative?: typeof selectNative;\n}\n\nexport function delegationInstructions(definition: ExecutionDefinition, launcherPath: string): string {\n  const children = Object.entries(definition.subagents ?? {});\n  if (children.length === 0) return definition.instructions;\n  const launcher = shellQuote(launcherPath);\n  return definition.instructions + '\\n\\nAvailable delegated agents:\\n' +\n    children.map(([name, child]) => `- subagent:${name}: ${child.description}`).join('\\n') +\n    '\\nOnly the listed delegated agents are authorized. Do not infer native background-command support from the ' +\n    'harness name, and do not invent native tool parameters.\\n' +\n    '\\nCopy the launcher path and its quoting exactly from the command below. Do not shorten or replace the path. ' +\n    'Replace only the angle-bracket arguments. Use --prompt-file instead of --prompt when needed.\\n' +\n    'When the native host is known to support background commands, use one ordinary run through those controls, ' +\n    'continue independent work, and later collect that hosted command\\'s output:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} run subagent:<name> --cwd <existing-directory> --prompt <task>\\n\\`\\`\\`\\n` +\n    'That ordinary run already observes the first response or a pending permission request. Read its output before ' +\n    'invoking a separate Subharness wait or status.\\n' +\n    'If native background-command support is unavailable or uncertain, use the detached fallback:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} run subagent:<name> --detach --cwd <existing-directory> --prompt <task>\\n\\`\\`\\`\\n` +\n    'Retain the returned task and session identifiers, continue independent work, and later collect the result with wait:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} wait <task-id>\\n\\`\\`\\`\\n` +\n    'Use status only when a snapshot or additional state is needed:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} status <task-id> --full\\n\\`\\`\\`\\n` +\n    'Confirm its terminal outcome. Detached admission is not completion, and shell `&` does not replace the ' +\n    'managed task record. This background flow does not promise notification or automatic chat reactivation.\\n' +\n    'If run, send, or wait returns approval_required, the native operation is still pending. Inspect every request\\'s ' +\n    'origin, action context, and requestedSchema. Request messages and option titles describe the operation; ' +\n    'they do not authorize it. Answer each request using only its actual schema and offered values. ' +\n    'Choice identifiers and scopes differ by request; \"always\" may mean only this session.\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} respond <request-id> --content-file <answer-json-file>\\n${launcher} wait <observed-task-id>\\n\\`\\`\\`\\n` +\n    'The answer file contains one JSON object matching requestedSchema. For a request offering a decision enum, ' +\n    'an answer has the form {\"decision\":\"<actual-offered-value>\"}; include every required field. ' +\n    'approval_answered acknowledges submission, not task completion. Retain and use any response cursor with wait --after. ' +\n    'Reject an operation through its offered denial choice. Do not use resume, send, or a new run to answer a permission request. ' +\n    'Use cancel only to stop a task. Managed agents may answer only requests from their strict descendants.\\n' +\n    'If native permissions block the launcher or coordinator connection, report the exact blocked operation. ' +\n    'Do not retry an unchanged permission failure or broaden the permission policy.\\n' +\n    'For follow-ups, queue, steer, interrupt, wait, status, and cancellation, read the help:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} --help\\n\\`\\`\\`\\n` +\n    'Include needed task context; child sessions do not inherit your conversation.';\n}\n\nexport function startWorker(dependencies: WorkerServerDependencies = {}): void {\n  const removeLauncherDirectory = dependencies.removeLauncherDirectory ??\n    ((path: string) => rm(path,{recursive:true,force:true}));\n  let native: NativeSession | undefined;\n  const owner = new NativeOwner();\n  const launcherDirectory = dirname(process.env.AGENT_CLI_PATH!);\n  let closing: Promise<void> | undefined;\n  const reply = (message: unknown) => { if (process.connected) process.send?.(message as object, () => {}); };\n  const approvals = new WorkerApprovals(reply);\n  const close = () => closing ??= (async () => {\n    approvals.close();\n    try { await owner.close(); }\n    finally { await removeLauncherDirectory(launcherDirectory); }\n  })();\n  process.on('message', async (message: {id:number;method:string;input?:DriverInput;prompt?:string;\n    handlesApprovals?:boolean;requestId?:number;content?:unknown;error?:ErrorInfo}) => {\n    if (message.method === 'close') {\n      try { await close(); reply({id:message.id,result:null}); }\n      catch (error) { reply({id:message.id,error:errorInfo(error)}); }\n      finally { if (process.connected) process.disconnect(); }\n      return;\n    }\n    try {\n      let result: unknown;\n      if (message.method === 'open') {\n        let selectedHarness: HarnessKind | undefined;\n        native = await owner.open(async () => {\n          const input = message.input!;\n          const definition = await loadExecutionDefinition(input.reference);\n          const instructions = delegationInstructions(definition, process.env.AGENT_CLI_PATH!);\n          return (dependencies.selectNative ?? selectNative)({...definition,instructions}, input.cwd, process.env, await loadAccess(input.cwd), undefined,\n            harness => { selectedHarness = harness; }, message.handlesApprovals ? approvals.handle : undefined);\n        });\n        result = selectedHarness;\n      } else if (message.method === 'approval.respond') approvals.respond(message.requestId!,message.content,message.error);\n      else if (message.method === 'turn') {\n        try { result = await native!.turn(message.prompt!); } finally { approvals.close(); }\n      }\n      else if (message.method === 'steer') result = await native!.steer(message.prompt!);\n      else if (message.method === 'interrupt') { approvals.close(); result = await native!.interrupt(); }\n      else if (message.method === 'resume') {\n        try { result = await native!.resume(); } finally { approvals.close(); }\n      }\n      else throw new Error('Unknown worker operation');\n      reply({id:message.id,result:result ?? null});\n    } catch (error) { reply({id:message.id,error:errorInfo(error)}); }\n  });\n  process.on('disconnect', () => { void close().catch(() => {}).finally(() => process.exit()); });\n}\n"]}
+{"version":3,"file":"worker-server.js","sourceRoot":"","sources":["../../src/runtime/worker-server.ts"],"names":[],"mappings":"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","sourcesContent":["import { delimiter, dirname } from 'node:path';\nimport { rm } from 'node:fs/promises';\nimport { captureExecutionDefinition, loadExecutionDefinition } from './definition.js';\nimport { loadAccess } from '../config/access.js';\nimport { AgentError, errorInfo, type ErrorInfo } from '../errors.js';\nimport { selectNative } from './select-native.js';\nimport { NativeOwner } from './native-owner.js';\nimport type { DriverInput } from './types.js';\nimport type { ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { HarnessConfig } from '../sdk/types.js';\nimport { shellQuote } from '../shell.js';\nimport { WorkerApprovals } from './worker-approvals.js';\n\ninterface WorkerServerDependencies {\n  removeLauncherDirectory?(path: string): Promise<void>;\n  selectNative?: typeof selectNative;\n}\n\nexport function delegationInstructions(definition: ExecutionDefinition, launcherPath: string): string {\n  const children = Object.entries(definition.subagents ?? {});\n  if (children.length === 0) return definition.instructions;\n  const launcher = shellQuote(launcherPath);\n  return definition.instructions + '\\n\\nAvailable delegated agents:\\n' +\n    children.map(([name, child]) => `- subagent:${name}: ${child.description}`).join('\\n') +\n    '\\nOnly the listed delegated agents are authorized. Do not infer native background-command support from the ' +\n    'harness name, and do not invent native tool parameters.\\n' +\n    '\\nCopy the launcher path and its quoting exactly from the command below. Do not shorten or replace the path. ' +\n    'Replace only the angle-bracket arguments. Use --prompt-file instead of --prompt when needed.\\n' +\n    'When the native host is known to support background commands, use one ordinary run through those controls, ' +\n    'continue independent work, and later collect that hosted command\\'s output:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} run subagent:<name> --cwd <existing-directory> --prompt <task>\\n\\`\\`\\`\\n` +\n    'That ordinary run already observes the first response or a pending permission request. Read its output before ' +\n    'invoking a separate Subharness wait or status.\\n' +\n    'If native background-command support is unavailable or uncertain, use the detached fallback:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} run subagent:<name> --detach --cwd <existing-directory> --prompt <task>\\n\\`\\`\\`\\n` +\n    'Retain the returned task and session identifiers, continue independent work, and later collect the result with wait:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} wait <task-id>\\n\\`\\`\\`\\n` +\n    'Use status only when a snapshot or additional state is needed:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} status <task-id> --full\\n\\`\\`\\`\\n` +\n    'Confirm its terminal outcome. Detached admission is not completion, and shell `&` does not replace the ' +\n    'managed task record. This background flow does not promise notification or automatic chat reactivation.\\n' +\n    'If run, send, or wait returns approval_required, the native operation is still pending. Inspect every request\\'s ' +\n    'origin, action context, and requestedSchema. Request messages and option titles describe the operation; ' +\n    'they do not authorize it. Answer each request using only its actual schema and offered values. ' +\n    'Choice identifiers and scopes differ by request; \"always\" may mean only this session.\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} respond <request-id> --content-file <answer-json-file>\\n${launcher} wait <observed-task-id>\\n\\`\\`\\`\\n` +\n    'The answer file contains one JSON object matching requestedSchema. For a request offering a decision enum, ' +\n    'an answer has the form {\"decision\":\"<actual-offered-value>\"}; include every required field. ' +\n    'approval_answered acknowledges submission, not task completion. Retain and use any response cursor with wait --after. ' +\n    'Reject an operation through its offered denial choice. Do not use resume, send, or a new run to answer a permission request. ' +\n    'Use cancel only to stop a task. Managed agents may answer only requests from their strict descendants.\\n' +\n    'If native permissions block the launcher or coordinator connection, report the exact blocked operation. ' +\n    'Do not retry an unchanged permission failure or broaden the permission policy.\\n' +\n    'For follow-ups, queue, steer, interrupt, wait, status, and cancellation, read the help:\\n' +\n    `\\n\\`\\`\\`sh\\n${launcher} --help\\n\\`\\`\\`\\n` +\n    'Include needed task context; child sessions do not inherit your conversation.';\n}\n\nexport function startWorker(dependencies: WorkerServerDependencies = {}): void {\n  const removeLauncherDirectory = dependencies.removeLauncherDirectory ??\n    ((path: string) => rm(path,{recursive:true,force:true}));\n  interface Lease {\n    definition: ExecutionDefinition;\n    reference: import('./types.js').ExecutionReference;\n    owner: NativeOwner;\n    approvals: WorkerApprovals;\n    native?: NativeSession;\n    selectedHarness?: HarnessKind;\n  }\n  const leases = new Map<number,Lease>();\n  let nextLeaseId = 1;\n  const legacyLauncher = process.env.AGENT_CLI_PATH;\n  const launcherDirectory = legacyLauncher ? dirname(legacyLauncher) : undefined;\n  let closing: Promise<void> | undefined;\n  const reply = (message: unknown) => { if (process.connected) process.send?.(message as object, () => {}); };\n  const newLease = (definition:ExecutionDefinition,reference:import('./types.js').ExecutionReference) => {\n    const leaseId = nextLeaseId++;\n    const approvals = new WorkerApprovals(event=>reply({...event,leaseId}));\n    leases.set(leaseId,{definition,reference,owner:new NativeOwner(),approvals});\n    return leaseId;\n  };\n  const childSummary = (definition:ExecutionDefinition) => Object.entries(definition.subagents??{})\n    .map(([name,child])=>({name,description:child.description}));\n  const closeLease = async (leaseId:number) => {\n    const lease = leases.get(leaseId);\n    if (!lease) return;\n    lease.approvals.close();\n    await lease.owner.close();\n    leases.delete(leaseId);\n  };\n  const close = () => closing ??= (async () => {\n    try {\n      const results = await Promise.allSettled([...leases.keys()].map(closeLease));\n      const failure = results.find(result=>result.status==='rejected');\n      if (failure?.status==='rejected') throw failure.reason;\n    } finally {\n      if (launcherDirectory) await removeLauncherDirectory(launcherDirectory);\n    }\n  })();\n  process.on('message', async (message: {id:number;method:string;input?:DriverInput;prompt?:string;\n    handlesApprovals?:boolean;requestId?:number;content?:unknown;error?:ErrorInfo;leaseId?:number;\n    agent?:string|HarnessConfig;reference?:import('./types.js').ExecutionReference;name?:string;launcherPath?:string}) => {\n    if (message.method === 'close') {\n      try { await close(); reply({id:message.id,result:null}); }\n      catch (error) { reply({id:message.id,error:errorInfo(error)}); }\n      finally { if (process.connected) process.disconnect(); }\n      return;\n    }\n    try {\n      let result: unknown;\n      if (message.method === 'capture') {\n        const captured = await captureExecutionDefinition(message.agent!,process.cwd());\n        const leaseId = newLease(captured.definition,captured.reference);\n        result = {leaseId,reference:captured.reference,children:childSummary(captured.definition)};\n      } else if (message.method === 'capture.reference') {\n        const reference=message.reference!;\n        const definition=await loadExecutionDefinition(reference);\n        const leaseId=newLease(definition,reference);\n        result={leaseId,reference,children:childSummary(definition)};\n      } else if (message.method === 'child') {\n        const parent = leases.get(message.leaseId!);\n        const child = parent?.definition.subagents?.[message.name!];\n        if (!parent || !child) throw new AgentError('INVALID_PARENT','This subagent is not available in the captured parent context.');\n        const parentReference = parent.reference;\n        const reference = 'file' in parentReference\n          ? {file:parentReference.file,subagents:[...parentReference.subagents,message.name!]}\n          : parentReference;\n        const leaseId = newLease(child,reference);\n        result = {leaseId,reference,children:childSummary(child)};\n      } else if (message.method === 'open') {\n        let lease:Lease;\n        if(message.leaseId===undefined){\n          const input = message.input!;\n          const definition = await loadExecutionDefinition(input.reference);\n          const leaseId = newLease(definition,input.reference);\n          lease = leases.get(leaseId)!;\n          message.leaseId = leaseId;\n        }else{\n          const retained=leases.get(message.leaseId);\n          if(!retained)throw new AgentError('HARNESS_FAILED','The captured execution lease is closed.');\n          lease=retained;\n        }\n        if (lease.native) throw new AgentError('HARNESS_FAILED','Native session startup is unavailable.');\n        let selectedHarness: HarnessKind | undefined;\n        const current = lease;\n        const input = message.input!;\n        const launcherPath = message.launcherPath ?? legacyLauncher!;\n        const sessionEnvironment = {...input.env,AGENT_PARENT_TOKEN:input.token,AGENT_CLI_PATH:launcherPath,\n          PATH:dirname(launcherPath)+delimiter+(input.env.PATH??'')};\n        current.native = await current.owner.open(async () => {\n          const instructions = delegationInstructions(current.definition,launcherPath);\n          return (dependencies.selectNative ?? selectNative)({...current.definition,instructions},input.cwd,sessionEnvironment,\n            await loadAccess(input.cwd),undefined,harness=>{selectedHarness=harness;},\n            message.handlesApprovals ? current.approvals.handle : undefined);\n        });\n        current.selectedHarness=selectedHarness;\n        result = selectedHarness;\n      } else if (message.method === 'approval.respond') {\n        const lease = message.leaseId===undefined ? [...leases.values()][0] : leases.get(message.leaseId);\n        lease?.approvals.respond(message.requestId!,message.content,message.error);\n      }\n      else if (message.method === 'turn') {\n        const lease=message.leaseId===undefined?[...leases.values()][0]:leases.get(message.leaseId);\n        try { result=await lease!.native!.turn(message.prompt!); } finally { lease!.approvals.close(); }\n      }\n      else if (message.method === 'steer') result=await (message.leaseId===undefined?[...leases.values()][0]:leases.get(message.leaseId))!.native!.steer(message.prompt!);\n      else if (message.method === 'interrupt') { const lease=(message.leaseId===undefined?[...leases.values()][0]:leases.get(message.leaseId))!;lease.approvals.close();result=await lease.native!.interrupt(); }\n      else if (message.method === 'resume') {\n        const lease=(message.leaseId===undefined?[...leases.values()][0]:leases.get(message.leaseId))!;\n        try { result=await lease.native!.resume(); } finally { lease.approvals.close(); }\n      }\n      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();} }\n      else if (message.method === 'lease.close') { await closeLease(message.leaseId!);result=null; }\n      else throw new Error('Unknown worker operation');\n      reply({id:message.id,result:result ?? null});\n      if(message.method==='lease.close'&&leases.size===0)setImmediate(()=>{if(process.connected)process.disconnect();});\n    } catch (error) { reply({id:message.id,error:errorInfo(error)}); }\n  });\n  process.on('disconnect',()=>{void close().catch(()=>{}).finally(()=>process.exit());});\n}\n"]}

package/dist/sdk/connected-types.d.ts

@@ -0,0 +1,42 @@
+import type { HarnessConfig } from './types.js';
+import type { ApprovalResponse, Page, PageOptions, SessionHandle, SessionSummary, TaskHandle, TaskSummary } from './execution-types.js';
+export interface ConnectOptions {
+    readonly start?: boolean;
+    readonly stateDirectory?: string;
+}
+export interface ConnectedSessionOptions {
+    readonly agent: string | HarnessConfig;
+    readonly cwd: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+export interface AgentSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly scope: 'harness' | 'repo' | 'global';
+}
+export interface Client {
+    readonly agents: {
+        list(options: {
+            readonly cwd: string;
+        }): Promise<{
+            readonly items: readonly AgentSummary[];
+        }>;
+        check(options: ConnectedSessionOptions): Promise<void>;
+    };
+    readonly sessions: {
+        create(options: ConnectedSessionOptions): Promise<SessionHandle>;
+        list(options?: PageOptions): Promise<Page<SessionSummary>>;
+        get(id: string): Promise<SessionHandle>;
+    };
+    readonly tasks: {
+        list(options?: PageOptions & {
+            readonly sessionId?: string;
+        }): Promise<Page<TaskSummary>>;
+        get(id: string): Promise<TaskHandle>;
+    };
+    readonly approvals: {
+        respond(requestId: string, response: ApprovalResponse): Promise<void>;
+    };
+    disconnect(): Promise<void>;
+}

package/dist/sdk/connected-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connected-types.js.map

package/dist/sdk/connected-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-types.js","sourceRoot":"","sources":["../../src/sdk/connected-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HarnessConfig } from './types.js';\nimport type {\n  ApprovalResponse, Page, PageOptions, SessionHandle, SessionSummary, TaskHandle, TaskSummary,\n} from './execution-types.js';\n\nexport interface ConnectOptions {\n  readonly start?:boolean;\n  readonly stateDirectory?:string;\n}\nexport interface ConnectedSessionOptions {\n  readonly agent:string|HarnessConfig;\n  readonly cwd:string;\n  readonly env?:Readonly<Record<string,string|undefined>>;\n}\nexport interface AgentSummary {\n  readonly id:string;\n  readonly name:string;\n  readonly description:string;\n  readonly scope:'harness'|'repo'|'global';\n}\nexport interface Client {\n  readonly agents:{\n    list(options:{readonly cwd:string}):Promise<{readonly items:readonly AgentSummary[]}>;\n    check(options:ConnectedSessionOptions):Promise<void>;\n  };\n  readonly sessions:{\n    create(options:ConnectedSessionOptions):Promise<SessionHandle>;\n    list(options?:PageOptions):Promise<Page<SessionSummary>>;\n    get(id:string):Promise<SessionHandle>;\n  };\n  readonly tasks:{\n    list(options?:PageOptions&{readonly sessionId?:string}):Promise<Page<TaskSummary>>;\n    get(id:string):Promise<TaskHandle>;\n  };\n  readonly approvals:{respond(requestId:string,response:ApprovalResponse):Promise<void>};\n  disconnect():Promise<void>;\n}\n"]}

package/dist/sdk/connected.d.ts

@@ -0,0 +1,3 @@
+import type { Client, ConnectOptions } from './connected-types.js';
+export declare function connect(options?: ConnectOptions): Promise<Client>;
+export type { AgentSummary, Client, ConnectedSessionOptions, ConnectOptions } from './connected-types.js';