subharness 0.0.4 → 0.0.7

package/dist/runtime/service.js

@@ -1,6 +1,35 @@
 import { createServer } from 'node:http';
+import { stat } from 'node:fs/promises';
+import { isAbsolute } from 'node:path';
 import { AgentError, errorInfo } from '../errors.js';
-export async function startService(engine, token, instanceId) {
+import { dispatchSdkRequest, isSdkCommand } from './sdk-service.js';
+import { captureExecution, captureReference, checkCapturedExecution } from './capture.js';
+import { checkAgent, listAgents } from './catalog.js';
+import { resolveStateDirectory } from './state.js';
+export async function startService(engine, token, instanceId, state, options = {}) {
+    const directory = resolveStateDirectory(state);
+    const captures = new Map(options.initialCaptures);
+    const captureOperations = { captureExecution, captureReference, checkCapturedExecution, ...options.capture };
+    const sdkOperations = {
+        listAgents: async (data) => listAgents(await catalogInput(data, directory)),
+        checkAgent: async (data) => {
+            const input = await catalogInput(data, directory);
+            await checkAgent(connectedAgent(data.agent), input);
+        },
+        createSession: async (data) => {
+            const input = await catalogInput(data, directory);
+            const captured = await captureOperations.captureExecution(connectedAgent(data.agent), input);
+            try {
+                const id = engine.createSession({ reference: captured.reference, cwd: input.cwd, env: input.env }, captured.prepared);
+                captures.set(id, captured);
+                return id;
+            }
+            catch (error) {
+                return releaseRejected(captured, error);
+            }
+        },
+        closeSession: async (id) => { await engine.closeSession(id); captures.delete(id); },
+    };
     const server = createServer(async (request, response) => {
         if (request.headers.authorization !== `Bearer ${token}`) {
             response.writeHead(401).end();
@@ -8,13 +37,23 @@ export async function startService(engine, token, instanceId) {
         }
         if (request.method === 'GET' && request.url === '/health') {
             response.setHeader('content-type', 'application/json');
-            response.end(JSON.stringify({ version: 1, type: 'coordinator-health', instanceId }));
+            response.end(JSON.stringify({
+                version: 1,
+                type: 'coordinator-health',
+                instanceId,
+                protocolVersion: 1,
+                capabilities: ['sdk-v1', 'cli-v1'],
+            }));
             return;
         }
         if (request.method !== 'POST' || request.url !== '/') {
             response.writeHead(404).end();
             return;
         }
+        if (request.headers['x-subharness-instance'] !== instanceId) {
+            response.writeHead(409).end();
+            return;
+        }
         response.setHeader('content-type', 'application/x-ndjson');
         const observer = new AbortController();
         // Keep long, quiet observations alive without exposing progress records to callers.
@@ -39,6 +78,13 @@ export async function startService(engine, token, instanceId) {
             }
             if (!data || typeof data !== 'object' || Array.isArray(data))
                 throw new AgentError('INVALID_ARGUMENT', 'Coordinator input must be a JSON object.');
+            if (isSdkCommand(data.command)) {
+                for await (const record of dispatchSdkRequest(engine, data, observer.signal, sdkOperations))
+                    write(record);
+                clearInterval(heartbeat);
+                response.end();
+                return;
+            }
             let receipt;
             switch (data.command) {
                 case 'dashboard':
@@ -59,6 +105,59 @@ export async function startService(engine, token, instanceId) {
                 case 'parent':
                     write(engine.parentContext(data.parentToken));
                     break;
+                case 'parent-catalog': {
+                    const { captured } = bindParent(engine, captures, data.parentToken);
+                    write({ version: 1, type: 'agents', agents: captured.children.map(child => ({
+                            id: `subagent:${child.name}`, name: child.name, description: child.description, scope: 'subagent',
+                        })) });
+                    break;
+                }
+                case 'parent-check': {
+                    const binding = bindParent(engine, captures, data.parentToken);
+                    const input = await catalogInput(data, directory);
+                    const captured = binding.captured;
+                    const child = await captured.child(childName(data.agent));
+                    try {
+                        validateParentBinding(engine, binding);
+                    }
+                    catch (error) {
+                        await releaseRejected(child, error);
+                    }
+                    await captureOperations.checkCapturedExecution(child, input);
+                    write({ version: 1, type: 'ack' });
+                    break;
+                }
+                case 'parent-run': {
+                    const binding = bindParent(engine, captures, data.parentToken);
+                    const input = await catalogInput(data, directory);
+                    const captured = binding.captured;
+                    const child = await captured.child(childName(data.agent));
+                    try {
+                        validateParentBinding(engine, binding);
+                        receipt = engine.run({ reference: child.reference, cwd: input.cwd, env: input.env,
+                            prompt: data.prompt, parentToken: binding.token }, child.prepared);
+                        captures.set(receipt.sessionId, child);
+                    }
+                    catch (error) {
+                        await releaseRejected(child, error);
+                    }
+                    break;
+                }
+                case 'cli-run': {
+                    const input = await catalogInput(data, directory);
+                    const captured = data.reference
+                        ? await captureOperations.captureReference(data.reference, input)
+                        : await captureOperations.captureExecution(connectedAgent(data.agent), input);
+                    try {
+                        receipt = engine.run({ reference: captured.reference, cwd: input.cwd, env: input.env,
+                            prompt: data.prompt, parentToken: data.parentToken }, captured.prepared);
+                        captures.set(receipt.sessionId, captured);
+                    }
+                    catch (error) {
+                        await releaseRejected(captured, error);
+                    }
+                    break;
+                }
                 case 'run':
                     receipt = engine.run(data.input);
                     break;
@@ -114,7 +213,83 @@ export async function startService(engine, token, instanceId) {
     });
     return {
         url: `http://127.0.0.1:${server.address().port}/`,
-        async close() { await engine.close(); server.closeAllConnections(); await new Promise(resolve => server.close(() => resolve())); },
+        async close() {
+            let failure;
+            try {
+                await engine.close();
+            }
+            catch (error) {
+                failure = error;
+            }
+            finally {
+                server.closeAllConnections();
+                await new Promise(resolve => server.close(() => resolve()));
+            }
+            if (failure)
+                throw failure;
+        },
     };
 }
+async function catalogInput(data, directory) {
+    const cwd = data.cwd;
+    if (typeof cwd !== 'string' || !isAbsolute(cwd))
+        throw new AgentError('INVALID_ARGUMENT', 'Execution cwd must be an existing absolute directory.');
+    try {
+        if (!(await stat(cwd)).isDirectory())
+            throw new Error();
+    }
+    catch {
+        throw new AgentError('INVALID_ARGUMENT', 'Execution cwd must be an existing absolute directory.');
+    }
+    const source = data.env;
+    if (!source || typeof source !== 'object' || Array.isArray(source))
+        throw new AgentError('INVALID_ARGUMENT', 'Connected environment must be an object.');
+    const env = {};
+    for (const key of Reflect.ownKeys(source)) {
+        if (typeof key !== 'string')
+            throw new AgentError('INVALID_ARGUMENT', 'Connected environment keys must be strings.');
+        const value = source[key];
+        if (value !== undefined && typeof value !== 'string')
+            throw new AgentError('INVALID_ARGUMENT', 'Connected environment values must be strings or undefined.');
+        if (typeof value === 'string')
+            env[key] = value;
+    }
+    delete env.AGENT_PARENT_TOKEN;
+    delete env.AGENT_CLI_PATH;
+    env.AGENT_STATE_DIR = directory;
+    return { cwd, env };
+}
+function connectedAgent(value) {
+    if (typeof value === 'string' || (value !== null && typeof value === 'object' && !Array.isArray(value)))
+        return value;
+    throw new AgentError('INVALID_ARGUMENT', 'Connected agent must be an ID or harness configuration.');
+}
+function bindParent(engine, captures, token) {
+    if (typeof token !== 'string' || !token)
+        throw new AgentError('INVALID_PARENT', 'The parent context is no longer active.');
+    const context = engine.parentContext(token);
+    const captured = captures.get(context.sessionId);
+    if (!captured)
+        throw new AgentError('INVALID_PARENT', 'The active parent does not own a captured definition graph.');
+    return { token, taskId: context.taskId, sessionId: context.sessionId, captured };
+}
+function validateParentBinding(engine, binding) {
+    const current = engine.parentContext(binding.token);
+    if (current.taskId !== binding.taskId || current.sessionId !== binding.sessionId)
+        throw new AgentError('INVALID_PARENT', 'The parent context is no longer active.');
+}
+function childName(value) {
+    if (typeof value !== 'string' || !value.startsWith('subagent:') || !value.slice(9))
+        throw new AgentError('INVALID_PARENT', 'This subagent is not available in the active parent context.');
+    return value.slice(9);
+}
+async function releaseRejected(captured, admissionError) {
+    try {
+        await captured.prepared.close();
+    }
+    catch {
+        throw new AgentError('HARNESS_FAILED', 'Captured execution cleanup failed after admission was rejected.');
+    }
+    throw admissionError;
+}
 //# sourceMappingURL=service.js.map

package/dist/runtime/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, Receipt, SessionInput } from './types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; detach?: boolean; parentToken?: string;\n  content?: unknown;\n  includePrompt?: boolean; knownResponseId?: string;\n}\n\nexport async function startService(engine: Coordinator, token: string, instanceId: string) {\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') {\n      response.setHeader('content-type','application/json');\n      response.end(JSON.stringify({version:1,type:'coordinator-health',instanceId}));\n      return;\n    }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      let data: Request;\n      try { data = JSON.parse(body) as Request; }\n      catch { throw new AgentError('INVALID_ARGUMENT','Coordinator input must be valid JSON.'); }\n      if (!data || typeof data !== 'object' || Array.isArray(data))\n        throw new AgentError('INVALID_ARGUMENT','Coordinator input must be a JSON object.');\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'dashboard': write(await engine.dashboard()); break;\n        case 'dashboard-session':\n          if (typeof data.id !== 'string')\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard session request fields.');\n          write(await engine.dashboardSession(data.id)); break;\n        case 'dashboard-detail':\n          if (typeof data.id !== 'string' ||\n            (data.includePrompt !== undefined && typeof data.includePrompt !== 'boolean') ||\n            (data.knownResponseId !== undefined && typeof data.knownResponseId !== 'string'))\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard detail request fields.');\n          write(await engine.dashboardDetail(data.id, data.includePrompt ?? true, data.knownResponseId)); break;\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send':\n          if (data.detach && data.delivery === 'steer') throw new AgentError('INVALID_ARGUMENT','--detach cannot be combined with --delivery steer.');\n          receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        case 'respond': write(engine.respond(data.id!,data.content,data.parentToken)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started' && !data.detach) {\n          write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n        }\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() { await engine.close(); server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())); },\n  };\n}\n"]}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { stat } from 'node:fs/promises';\nimport { isAbsolute } from 'node:path';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, ExecutionReference, Receipt, SessionInput } from './types.js';\nimport { dispatchSdkRequest, isSdkCommand } from './sdk-service.js';\nimport { captureExecution, captureReference, checkCapturedExecution, type CapturedExecution } from './capture.js';\nimport { checkAgent, listAgents, type CatalogEnvironment } from './catalog.js';\nimport { resolveStateDirectory } from './state.js';\nimport type { HarnessConfig } from '../sdk/types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; detach?: boolean; parentToken?: string;\n  content?: unknown;\n  includePrompt?: boolean; knownResponseId?: string;\n  agent?: unknown; cwd?: string; env?: NodeJS.ProcessEnv;\n  reference?: ExecutionReference;\n}\n\nexport interface ServiceCaptureOperations {\n  captureExecution:typeof captureExecution;\n  captureReference:typeof captureReference;\n  checkCapturedExecution:typeof checkCapturedExecution;\n}\nexport interface ServiceOptions {\n  readonly initialCaptures?:ReadonlyMap<string,CapturedExecution>;\n  readonly capture?:Partial<ServiceCaptureOperations>;\n}\n\nexport async function startService(engine: Coordinator, token: string, instanceId: string, state?:string,\n  options:ServiceOptions={}) {\n  const directory=resolveStateDirectory(state);\n  const captures=new Map<string,CapturedExecution>(options.initialCaptures);\n  const captureOperations:ServiceCaptureOperations={captureExecution,captureReference,checkCapturedExecution,...options.capture};\n  const sdkOperations={\n    listAgents:async(data:Record<string,unknown>)=>listAgents(await catalogInput(data,directory)),\n    checkAgent:async(data:Record<string,unknown>)=>{\n      const input=await catalogInput(data,directory); await checkAgent(connectedAgent(data.agent),input);\n    },\n    createSession:async(data:Record<string,unknown>):Promise<string>=>{\n      const input=await catalogInput(data,directory);\n      const captured=await captureOperations.captureExecution(connectedAgent(data.agent),input);\n      try {\n        const id=engine.createSession({reference:captured.reference,cwd:input.cwd,env:input.env},captured.prepared);\n        captures.set(id,captured); return id;\n      } catch(error) { return releaseRejected(captured,error); }\n    },\n    closeSession:async(id:string)=>{ await engine.closeSession(id); captures.delete(id); },\n  };\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') {\n      response.setHeader('content-type','application/json');\n      response.end(JSON.stringify({\n        version:1,\n        type:'coordinator-health',\n        instanceId,\n        protocolVersion:1,\n        capabilities:['sdk-v1','cli-v1'],\n      }));\n      return;\n    }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    if (request.headers['x-subharness-instance'] !== instanceId) { response.writeHead(409).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      let data: Request;\n      try { data = JSON.parse(body) as Request; }\n      catch { throw new AgentError('INVALID_ARGUMENT','Coordinator input must be valid JSON.'); }\n      if (!data || typeof data !== 'object' || Array.isArray(data))\n        throw new AgentError('INVALID_ARGUMENT','Coordinator input must be a JSON object.');\n      if (isSdkCommand(data.command)) {\n        for await (const record of dispatchSdkRequest(engine,data as unknown as Record<string,unknown>,observer.signal,sdkOperations)) write(record);\n        clearInterval(heartbeat);\n        response.end();\n        return;\n      }\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'dashboard': write(await engine.dashboard()); break;\n        case 'dashboard-session':\n          if (typeof data.id !== 'string')\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard session request fields.');\n          write(await engine.dashboardSession(data.id)); break;\n        case 'dashboard-detail':\n          if (typeof data.id !== 'string' ||\n            (data.includePrompt !== undefined && typeof data.includePrompt !== 'boolean') ||\n            (data.knownResponseId !== undefined && typeof data.knownResponseId !== 'string'))\n            throw new AgentError('INVALID_ARGUMENT', 'Invalid dashboard detail request fields.');\n          write(await engine.dashboardDetail(data.id, data.includePrompt ?? true, data.knownResponseId)); break;\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'parent-catalog': {\n          const {captured}=bindParent(engine,captures,data.parentToken);\n          write({version:1,type:'agents',agents:captured.children.map(child=>({\n            id:`subagent:${child.name}`,name:child.name,description:child.description,scope:'subagent',\n          }))});\n          break;\n        }\n        case 'parent-check': {\n          const binding=bindParent(engine,captures,data.parentToken);\n          const input=await catalogInput(data as unknown as Record<string,unknown>,directory);\n          const captured=binding.captured;\n          const child=await captured.child(childName(data.agent));\n          try { validateParentBinding(engine,binding); }\n          catch(error) { await releaseRejected(child,error); }\n          await captureOperations.checkCapturedExecution(child,input);\n          write({version:1,type:'ack'}); break;\n        }\n        case 'parent-run': {\n          const binding=bindParent(engine,captures,data.parentToken);\n          const input=await catalogInput(data as unknown as Record<string,unknown>,directory);\n          const captured=binding.captured;\n          const child=await captured.child(childName(data.agent));\n          try {\n            validateParentBinding(engine,binding);\n            receipt=engine.run({reference:child.reference,cwd:input.cwd,env:input.env,\n              prompt:data.prompt!,parentToken:binding.token},child.prepared);\n            captures.set(receipt.sessionId,child);\n          } catch(error) { await releaseRejected(child,error); }\n          break;\n        }\n        case 'cli-run': {\n          const input=await catalogInput(data as unknown as Record<string,unknown>,directory);\n          const captured=data.reference\n            ? await captureOperations.captureReference(data.reference,input)\n            : await captureOperations.captureExecution(connectedAgent(data.agent),input);\n          try {\n            receipt=engine.run({reference:captured.reference,cwd:input.cwd,env:input.env,\n              prompt:data.prompt!,parentToken:data.parentToken},captured.prepared);\n            captures.set(receipt.sessionId,captured);\n          } catch(error) { await releaseRejected(captured,error); }\n          break;\n        }\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send':\n          if (data.detach && data.delivery === 'steer') throw new AgentError('INVALID_ARGUMENT','--detach cannot be combined with --delivery steer.');\n          receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        case 'respond': write(engine.respond(data.id!,data.content,data.parentToken)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started' && !data.detach) {\n          write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n        }\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() {\n      let failure: unknown;\n      try { await engine.close(); }\n      catch (error) { failure = error; }\n      finally {\n        server.closeAllConnections();\n        await new Promise<void>(resolve => server.close(() => resolve()));\n      }\n      if (failure) throw failure;\n    },\n  };\n}\n\nasync function catalogInput(data:Record<string,unknown>,directory:string):Promise<CatalogEnvironment> {\n  const cwd=data.cwd;\n  if(typeof cwd!=='string'||!isAbsolute(cwd))throw new AgentError('INVALID_ARGUMENT','Execution cwd must be an existing absolute directory.');\n  try{if(!(await stat(cwd)).isDirectory())throw new Error();}\n  catch{throw new AgentError('INVALID_ARGUMENT','Execution cwd must be an existing absolute directory.');}\n  const source=data.env;\n  if(!source||typeof source!=='object'||Array.isArray(source))throw new AgentError('INVALID_ARGUMENT','Connected environment must be an object.');\n  const env:NodeJS.ProcessEnv={};\n  for(const key of Reflect.ownKeys(source)){\n    if(typeof key!=='string')throw new AgentError('INVALID_ARGUMENT','Connected environment keys must be strings.');\n    const value=(source as Record<string,unknown>)[key];\n    if(value!==undefined&&typeof value!=='string')throw new AgentError('INVALID_ARGUMENT','Connected environment values must be strings or undefined.');\n    if(typeof value==='string')env[key]=value;\n  }\n  delete env.AGENT_PARENT_TOKEN;delete env.AGENT_CLI_PATH;env.AGENT_STATE_DIR=directory;\n  return {cwd,env};\n}\n\nfunction connectedAgent(value:unknown):string|HarnessConfig {\n  if(typeof value==='string'||(value!==null&&typeof value==='object'&&!Array.isArray(value)))return value as string|HarnessConfig;\n  throw new AgentError('INVALID_ARGUMENT','Connected agent must be an ID or harness configuration.');\n}\n\ninterface ParentBinding {readonly token:string;readonly taskId:string;readonly sessionId:string;readonly captured:CapturedExecution}\n\nfunction bindParent(engine:Coordinator,captures:Map<string,CapturedExecution>,token:unknown):ParentBinding {\n  if(typeof token!=='string'||!token)throw new AgentError('INVALID_PARENT','The parent context is no longer active.');\n  const context=engine.parentContext(token);\n  const captured=captures.get(context.sessionId);\n  if(!captured)throw new AgentError('INVALID_PARENT','The active parent does not own a captured definition graph.');\n  return {token,taskId:context.taskId,sessionId:context.sessionId,captured};\n}\n\nfunction validateParentBinding(engine:Coordinator,binding:ParentBinding):void {\n  const current=engine.parentContext(binding.token);\n  if(current.taskId!==binding.taskId||current.sessionId!==binding.sessionId)\n    throw new AgentError('INVALID_PARENT','The parent context is no longer active.');\n}\n\nfunction childName(value:unknown):string {\n  if(typeof value!=='string'||!value.startsWith('subagent:')||!value.slice(9))\n    throw new AgentError('INVALID_PARENT','This subagent is not available in the active parent context.');\n  return value.slice(9);\n}\n\nasync function releaseRejected(captured:CapturedExecution,admissionError:unknown):Promise<never> {\n  try { await captured.prepared.close(); }\n  catch { throw new AgentError('HARNESS_FAILED','Captured execution cleanup failed after admission was rejected.'); }\n  throw admissionError;\n}\n"]}

package/dist/runtime/session-launcher.js

@@ -8,7 +8,7 @@ export async function createSessionLauncher(state, parentToken) {
     const directory = await mkdtemp(join(root, 'session-'));
     const path = join(directory, 'agent');
     let closing;
-    const close = () => closing ??= rm(directory, { recursive: true, force: true });
+    const close = () => closing ??= rm(directory, { recursive: true, force: true }).catch(error => { closing = undefined; throw error; });
     try {
         const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';
         const registration = extension === 'ts'

package/dist/runtime/session-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-launcher.js","sourceRoot":"","sources":["../../src/runtime/session-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,WAAmB;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAC,UAAU,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAkC,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,SAAS,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,MAAM,YAAY,GAAG,SAAS,KAAK,IAAI;YACrC,CAAC,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,MAAM,OAAO,GAAG,EAAC,eAAe,EAAC,OAAO,CAAC,KAAK,CAAC,EAAC,kBAAkB,EAAC,WAAW,EAAC,cAAc,EAAC,IAAI,EAAC,CAAC;QACpG,MAAM,OAAO,GAAG,KAAK,OAAO,CAAC,QAAQ,KAAK,YAAY,EAAE;YACtD,6BAA6B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM;YAC1D,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,eAAe,SAAS,EAAE,EAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACjG,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAC,cAAc,CAAC,EAAC,mBAAmB,EAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;QACjF,MAAM,SAAS,CAAC,IAAI,EAAC,OAAO,EAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;QAC3C,OAAO,EAAC,IAAI,EAAC,SAAS,EAAC,KAAK,EAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AACjD,CAAC","sourcesContent":["import { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { privateDirectory } from './state.js';\n\n/** Keeps local delegation context outside model instructions and shell arguments. */\nexport async function createSessionLauncher(state: string, parentToken: string) {\n  const root = join(resolve(state),'launchers');\n  await privateDirectory(root);\n  const directory = await mkdtemp(join(root,'session-'));\n  const path = join(directory,'agent');\n  let closing: Promise<void> | undefined;\n  const close = () => closing ??= rm(directory,{recursive:true,force:true});\n  try {\n    const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';\n    const registration = extension === 'ts'\n      ? `import { register } from ${JSON.stringify(import.meta.resolve('tsx/esm/api'))}; register();\\n` : '';\n    const context = {AGENT_STATE_DIR:resolve(state),AGENT_PARENT_TOKEN:parentToken,AGENT_CLI_PATH:path};\n    const wrapper = `#!${process.execPath}\\n${registration}` +\n      `Object.assign(process.env,${JSON.stringify(context)});\\n` +\n      `await import(${JSON.stringify(new URL(`../cli/main.${extension}`,import.meta.url).href)});\\n`;\n    await writeFile(join(directory,'package.json'),'{\"type\":\"module\"}',{mode:0o600});\n    await writeFile(path,wrapper,{mode:0o700});\n    return {path,directory,close};\n  } catch (error) { await close(); throw error; }\n}\n"]}
+{"version":3,"file":"session-launcher.js","sourceRoot":"","sources":["../../src/runtime/session-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,WAAmB;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAC,UAAU,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAkC,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,SAAS,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA,EAAE,GAAC,OAAO,GAAC,SAAS,CAAC,CAAA,MAAM,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC;IACzH,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,MAAM,YAAY,GAAG,SAAS,KAAK,IAAI;YACrC,CAAC,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,MAAM,OAAO,GAAG,EAAC,eAAe,EAAC,OAAO,CAAC,KAAK,CAAC,EAAC,kBAAkB,EAAC,WAAW,EAAC,cAAc,EAAC,IAAI,EAAC,CAAC;QACpG,MAAM,OAAO,GAAG,KAAK,OAAO,CAAC,QAAQ,KAAK,YAAY,EAAE;YACtD,6BAA6B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM;YAC1D,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,eAAe,SAAS,EAAE,EAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACjG,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAC,cAAc,CAAC,EAAC,mBAAmB,EAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;QACjF,MAAM,SAAS,CAAC,IAAI,EAAC,OAAO,EAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;QAC3C,OAAO,EAAC,IAAI,EAAC,SAAS,EAAC,KAAK,EAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AACjD,CAAC","sourcesContent":["import { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { privateDirectory } from './state.js';\n\n/** Keeps local delegation context outside model instructions and shell arguments. */\nexport async function createSessionLauncher(state: string, parentToken: string) {\n  const root = join(resolve(state),'launchers');\n  await privateDirectory(root);\n  const directory = await mkdtemp(join(root,'session-'));\n  const path = join(directory,'agent');\n  let closing: Promise<void> | undefined;\n  const close = () => closing ??= rm(directory,{recursive:true,force:true}).catch(error=>{closing=undefined;throw error;});\n  try {\n    const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';\n    const registration = extension === 'ts'\n      ? `import { register } from ${JSON.stringify(import.meta.resolve('tsx/esm/api'))}; register();\\n` : '';\n    const context = {AGENT_STATE_DIR:resolve(state),AGENT_PARENT_TOKEN:parentToken,AGENT_CLI_PATH:path};\n    const wrapper = `#!${process.execPath}\\n${registration}` +\n      `Object.assign(process.env,${JSON.stringify(context)});\\n` +\n      `await import(${JSON.stringify(new URL(`../cli/main.${extension}`,import.meta.url).href)});\\n`;\n    await writeFile(join(directory,'package.json'),'{\"type\":\"module\"}',{mode:0o600});\n    await writeFile(path,wrapper,{mode:0o700});\n    return {path,directory,close};\n  } catch (error) { await close(); throw error; }\n}\n"]}

package/dist/runtime/snapshots.d.ts

@@ -0,0 +1,103 @@
+import type { ErrorInfo } from '../errors.js';
+import type { HarnessKind } from '../sdk/types.js';
+import type { ApprovalRequest, TaskState } from './task-data.js';
+export type TerminalState = 'completed' | 'failed' | 'cancelled' | 'interrupted';
+export interface TaskSummary {
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly state: TaskState;
+    readonly selectedHarness?: HarnessKind;
+}
+export interface SdkTaskSummary extends TaskSummary {
+    readonly title: string;
+    readonly ordinal: number;
+    readonly updatedAt: number;
+    readonly dispatchedAt?: number;
+    readonly failedAt?: number;
+    readonly finishedAt?: number;
+}
+export interface CompleteResponse {
+    readonly responseId: string;
+    readonly text: string;
+    readonly state: TaskState;
+}
+export interface TaskSnapshot extends TaskSummary {
+    readonly revision: number;
+    readonly parentTaskId?: string;
+    readonly children: readonly TaskSummary[];
+    readonly requests: readonly ApprovalRequest[];
+    readonly latestResponse?: CompleteResponse;
+    readonly error?: ErrorInfo;
+    readonly stopUnconfirmed: boolean;
+}
+export interface SessionSnapshot {
+    readonly sessionId: string;
+    readonly state: 'open' | 'closing' | 'closed';
+    readonly paused: boolean;
+    readonly active?: TaskSummary;
+    readonly queued: readonly TaskSummary[];
+}
+export interface WorkspaceInfo {
+    readonly directory: string;
+    readonly repository?: string;
+}
+export interface SdkSessionSummary {
+    readonly sessionId: string;
+    readonly state: 'open' | 'closing' | 'closed';
+    readonly paused: boolean;
+    readonly cwd: string;
+    readonly workspace: WorkspaceInfo;
+    readonly active?: SdkTaskSummary;
+}
+export interface SdkSessionSnapshot extends SdkSessionSummary {
+    readonly queued: readonly SdkTaskSummary[];
+}
+export interface SdkTaskSnapshot extends SdkTaskSummary {
+    readonly revision: number;
+    readonly parentTaskId?: string;
+    readonly children: readonly SdkTaskSummary[];
+    readonly requests: readonly import('./task-data.js').SdkApprovalRequest[];
+    readonly latestResponse?: CompleteResponse;
+    readonly error?: ErrorInfo;
+    readonly stopUnconfirmed: boolean;
+}
+export interface SdkTaskDetails extends SdkTaskSnapshot {
+    readonly prompt: string;
+}
+export interface TaskResult {
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly responseId: string;
+    readonly text: string;
+}
+export interface PageOptions {
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+export interface Page<T> {
+    readonly items: readonly T[];
+    readonly nextCursor?: string;
+}
+export type TaskObservation = {
+    readonly type: 'response';
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly response: CompleteResponse;
+} | {
+    readonly type: 'approval_required';
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly state: TaskState;
+    readonly requests: readonly ApprovalRequest[];
+} | {
+    readonly type: 'terminal';
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly state: TerminalState;
+    readonly error?: ErrorInfo;
+    readonly stopUnconfirmed: boolean;
+};
+export declare function detached<T>(value: T): T;
+export declare function createSnapshotWatch<T extends {
+    readonly state: TaskState;
+} = TaskSnapshot>(read: () => T, subscribe: (changed: () => void) => () => void, signal?: AbortSignal): AsyncIterable<T>;

package/dist/runtime/snapshots.js

@@ -0,0 +1,124 @@
+import { AgentError } from '../errors.js';
+export function detached(value) {
+    return structuredClone(value);
+}
+export function createSnapshotWatch(read, subscribe, signal) {
+    return {
+        [Symbol.asyncIterator]() {
+            let started = false;
+            let ended = false;
+            let buffered;
+            let unsubscribe;
+            const pending = [];
+            let failure;
+            let failed = false;
+            const done = () => ({ done: true, value: undefined });
+            const cleanup = () => {
+                unsubscribe?.();
+                unsubscribe = undefined;
+                signal?.removeEventListener('abort', abort);
+            };
+            const resolvePendingDone = () => {
+                for (const waiter of pending.splice(0))
+                    waiter.resolve(done());
+            };
+            const rejectPending = (error) => {
+                for (const waiter of pending.splice(0))
+                    waiter.reject(error);
+            };
+            const result = (value) => {
+                if (value.state === 'completed' || value.state === 'failed' ||
+                    value.state === 'cancelled' || value.state === 'interrupted') {
+                    ended = true;
+                    cleanup();
+                    resolvePendingDone();
+                }
+                return { done: false, value };
+            };
+            const changed = () => {
+                if (ended || failed)
+                    return;
+                let value;
+                try {
+                    value = read();
+                }
+                catch (error) {
+                    fail(error);
+                    return;
+                }
+                const waiter = pending.shift();
+                if (waiter)
+                    waiter.resolve(result(value));
+                else {
+                    buffered = value;
+                    if (value.state === 'completed' || value.state === 'failed' ||
+                        value.state === 'cancelled' || value.state === 'interrupted') {
+                        unsubscribe?.();
+                        unsubscribe = undefined;
+                    }
+                }
+            };
+            const fail = (error) => {
+                if (ended || failed)
+                    return;
+                failed = true;
+                failure = error;
+                buffered = undefined;
+                cleanup();
+                rejectPending(error);
+            };
+            const abort = () => {
+                fail(new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.'));
+            };
+            return {
+                next() {
+                    if (ended)
+                        return Promise.resolve(done());
+                    if (failed)
+                        return Promise.reject(failure);
+                    if (signal?.aborted) {
+                        abort();
+                        return Promise.reject(failure);
+                    }
+                    if (buffered) {
+                        const value = buffered;
+                        buffered = undefined;
+                        return Promise.resolve(result(value));
+                    }
+                    if (!started) {
+                        started = true;
+                        try {
+                            unsubscribe = subscribe(changed);
+                            signal?.addEventListener('abort', abort, { once: true });
+                            return Promise.resolve(result(read()));
+                        }
+                        catch (error) {
+                            fail(error);
+                            return Promise.reject(error);
+                        }
+                    }
+                    return new Promise((resolve, reject) => {
+                        pending.push({ resolve, reject });
+                    });
+                },
+                return() {
+                    buffered = undefined;
+                    if (!ended) {
+                        ended = true;
+                        cleanup();
+                        resolvePendingDone();
+                    }
+                    return Promise.resolve(done());
+                },
+                throw(error) {
+                    ended = true;
+                    buffered = undefined;
+                    cleanup();
+                    rejectPending(error);
+                    return Promise.reject(error);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/runtime/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../src/runtime/snapshots.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ErrorInfo } from '../errors.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { ApprovalRequest, TaskState } from './task-data.js';\nimport { AgentError } from '../errors.js';\n\nexport type TerminalState = 'completed' | 'failed' | 'cancelled' | 'interrupted';\n\nexport interface TaskSummary {\n  readonly taskId: string;\n  readonly sessionId: string;\n  readonly state: TaskState;\n  readonly selectedHarness?: HarnessKind;\n}\n\nexport interface SdkTaskSummary extends TaskSummary {\n  readonly title: string;\n  readonly ordinal: number;\n  readonly updatedAt: number;\n  readonly dispatchedAt?: number;\n  readonly failedAt?: number;\n  readonly finishedAt?: number;\n}\n\nexport interface CompleteResponse {\n  readonly responseId: string;\n  readonly text: string;\n  readonly state: TaskState;\n}\n\nexport interface TaskSnapshot extends TaskSummary {\n  readonly revision: number;\n  readonly parentTaskId?: string;\n  readonly children: readonly TaskSummary[];\n  readonly requests: readonly ApprovalRequest[];\n  readonly latestResponse?: CompleteResponse;\n  readonly error?: ErrorInfo;\n  readonly stopUnconfirmed: boolean;\n}\n\nexport interface SessionSnapshot {\n  readonly sessionId: string;\n  readonly state: 'open' | 'closing' | 'closed';\n  readonly paused: boolean;\n  readonly active?: TaskSummary;\n  readonly queued: readonly TaskSummary[];\n}\n\nexport interface WorkspaceInfo { readonly directory: string; readonly repository?: string }\nexport interface SdkSessionSummary {\n  readonly sessionId: string;\n  readonly state: 'open' | 'closing' | 'closed';\n  readonly paused: boolean;\n  readonly cwd: string;\n  readonly workspace: WorkspaceInfo;\n  readonly active?: SdkTaskSummary;\n}\nexport interface SdkSessionSnapshot extends SdkSessionSummary { readonly queued: readonly SdkTaskSummary[] }\nexport interface SdkTaskSnapshot extends SdkTaskSummary {\n  readonly revision: number;\n  readonly parentTaskId?: string;\n  readonly children: readonly SdkTaskSummary[];\n  readonly requests: readonly import('./task-data.js').SdkApprovalRequest[];\n  readonly latestResponse?: CompleteResponse;\n  readonly error?: ErrorInfo;\n  readonly stopUnconfirmed: boolean;\n}\nexport interface SdkTaskDetails extends SdkTaskSnapshot { readonly prompt: string }\nexport interface TaskResult {\n  readonly taskId: string;\n  readonly sessionId: string;\n  readonly responseId: string;\n  readonly text: string;\n}\nexport interface PageOptions { readonly limit?: number; readonly cursor?: string }\nexport interface Page<T> { readonly items: readonly T[]; readonly nextCursor?: string }\n\nexport type TaskObservation =\n  | { readonly type: 'response'; readonly taskId: string; readonly sessionId: string;\n      readonly response: CompleteResponse }\n  | { readonly type: 'approval_required'; readonly taskId: string; readonly sessionId: string;\n      readonly state: TaskState; readonly requests: readonly ApprovalRequest[] }\n  | { readonly type: 'terminal'; readonly taskId: string; readonly sessionId: string;\n      readonly state: TerminalState; readonly error?: ErrorInfo; readonly stopUnconfirmed: boolean };\n\nexport function detached<T>(value: T): T {\n  return structuredClone(value);\n}\n\nexport function createSnapshotWatch<T extends {readonly state:TaskState} = TaskSnapshot>(\n  read: () => T,\n  subscribe: (changed: () => void) => () => void,\n  signal?: AbortSignal,\n): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<T> {\n      let started = false;\n      let ended = false;\n      let buffered: T | undefined;\n      let unsubscribe: (() => void) | undefined;\n      const pending: {\n        resolve(result: IteratorResult<T>): void;\n        reject(error: unknown): void;\n      }[] = [];\n      let failure: unknown;\n      let failed = false;\n\n      const done = (): IteratorResult<T> => ({done: true, value: undefined});\n      const cleanup = () => {\n        unsubscribe?.();\n        unsubscribe = undefined;\n        signal?.removeEventListener('abort', abort);\n      };\n      const resolvePendingDone = () => {\n        for (const waiter of pending.splice(0)) waiter.resolve(done());\n      };\n      const rejectPending = (error: unknown) => {\n        for (const waiter of pending.splice(0)) waiter.reject(error);\n      };\n      const result = (value: T): IteratorResult<T> => {\n        if (value.state === 'completed' || value.state === 'failed' ||\n          value.state === 'cancelled' || value.state === 'interrupted') {\n          ended = true;\n          cleanup();\n          resolvePendingDone();\n        }\n        return {done: false, value};\n      };\n      const changed = () => {\n        if (ended || failed) return;\n        let value: T;\n        try { value = read(); }\n        catch (error) { fail(error); return; }\n        const waiter = pending.shift();\n        if (waiter) waiter.resolve(result(value));\n        else {\n          buffered = value;\n          if (value.state === 'completed' || value.state === 'failed' ||\n            value.state === 'cancelled' || value.state === 'interrupted') {\n            unsubscribe?.();\n            unsubscribe = undefined;\n          }\n        }\n      };\n      const fail = (error: unknown) => {\n        if (ended || failed) return;\n        failed = true;\n        failure = error;\n        buffered = undefined;\n        cleanup();\n        rejectPending(error);\n      };\n      const abort = () => {\n        fail(new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.'));\n      };\n\n      return {\n        next(): Promise<IteratorResult<T>> {\n          if (ended) return Promise.resolve(done());\n          if (failed) return Promise.reject(failure);\n          if (signal?.aborted) { abort(); return Promise.reject(failure); }\n          if (buffered) {\n            const value = buffered;\n            buffered = undefined;\n            return Promise.resolve(result(value));\n          }\n          if (!started) {\n            started = true;\n            try {\n              unsubscribe = subscribe(changed);\n              signal?.addEventListener('abort', abort, {once: true});\n              return Promise.resolve(result(read()));\n            } catch (error) {\n              fail(error);\n              return Promise.reject(error);\n            }\n          }\n          return new Promise<IteratorResult<T>>((resolve, reject) => {\n            pending.push({resolve, reject});\n          });\n        },\n        return(): Promise<IteratorResult<T>> {\n          buffered = undefined;\n          if (!ended) {\n            ended = true;\n            cleanup();\n            resolvePendingDone();\n          }\n          return Promise.resolve(done());\n        },\n        throw(error?: unknown): Promise<IteratorResult<T>> {\n          ended = true;\n          buffered = undefined;\n          cleanup();\n          rejectPending(error);\n          return Promise.reject(error);\n        },\n      };\n    },\n  };\n}\n"]}

package/dist/runtime/state.d.ts

@@ -4,8 +4,34 @@ export interface Endpoint {
     pid: number;
     instanceId: string;
 }
+export type EndpointCapability = 'sdk-v1' | 'cli-v1';
+export type OwnerState = 'alive' | 'dead' | 'unknown';
+export type EndpointProbe = {
+    readonly kind: 'absent';
+} | {
+    readonly kind: 'malformed';
+} | {
+    readonly kind: 'reachable';
+    readonly endpoint: Endpoint;
+} | {
+    readonly kind: 'authentication-failed' | 'incompatible' | 'instance-mismatch';
+    readonly endpoint: Endpoint;
+} | {
+    readonly kind: 'unresponsive';
+    readonly endpoint: Endpoint;
+    readonly owner: OwnerState;
+};
+export interface EndpointProbeOptions {
+    readonly capability?: EndpointCapability;
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+    readonly checkPid?: (pid: number) => OwnerState;
+}
+export declare function resolveStateDirectory(explicit?: string, env?: Readonly<Record<string, string | undefined>>): string;
 export declare function stateDirectory(): string;
 export declare function privateDirectory(directory: string): Promise<void>;
+export declare function probeEndpoint(directory: string, options?: EndpointProbeOptions): Promise<EndpointProbe>;
+export declare function processOwnerState(pid: number): OwnerState;
 export declare function readEndpoint(directory: string): Promise<Endpoint | undefined>;
 export declare function localProgram(name: string): {
     file: string;