subharness 0.0.4 → 0.0.7

package/dist/runtime/client.js

@@ -1,50 +1,77 @@
 import { spawn } from 'node:child_process';
 import { setTimeout as delay } from 'node:timers/promises';
 import { AgentError } from '../errors.js';
-import { localProgram, privateDirectory, readEndpoint, stateDirectory } from './state.js';
+import { processExitDescription } from '../process-diagnostics.js';
+import { localProgram, privateDirectory, probeEndpoint, resolveStateDirectory, } from './state.js';
 import { startupOutcome, startupRetirementRequest } from './startup-protocol.js';
+import { CoordinatorTransport } from './transport.js';
 const retirementConfirmationMs = 1_000;
+const finalProbeMs = 250;
 export async function connect(start, options = {}) {
-    const directory = options.directory ?? stateDirectory();
-    const available = await readEndpoint(directory);
+    const deadline = Date.now() + (options.timeoutMs ?? 15_000);
+    const directory = resolveStateDirectory(options.directory);
+    const capability = options.capability ?? 'cli-v1';
+    const initial = await probeEndpoint(directory, { capability, timeoutMs: remaining(deadline) });
+    const available = usableEndpoint(initial, start);
     if (available)
         return available;
     if (!start)
-        throw new AgentError('UNKNOWN_SESSION', 'No coordinator is reachable from this environment. Its sessions may have ended, or native permissions may block access to its local endpoint.');
+        throw unavailable();
     await privateDirectory(directory);
-    const deadline = Date.now() + (options.timeoutMs ?? 15_000);
     let child;
     let candidate;
     try {
         if (Date.now() >= deadline)
             throw new AgentError('STARTUP_FAILED', 'Another command did not finish coordinator startup.');
         const program = options.program ?? localProgram('daemon');
-        child = spawn(process.execPath, [...program.execArgv, program.file, String(Math.max(1, deadline - Date.now()))], {
-            detached: true, stdio: ['ignore', 'ignore', 'ignore', 'ipc'], env: { ...process.env, AGENT_STATE_DIR: directory },
-        });
+        try {
+            child = spawn(process.execPath, [...program.execArgv, program.file, String(Math.max(1, deadline - Date.now()))], {
+                detached: true, stdio: ['ignore', 'ignore', 'ignore', 'ipc'], env: { ...process.env, AGENT_STATE_DIR: directory },
+            });
+        }
+        catch {
+            throw new AgentError('STARTUP_FAILED', 'The local coordinator could not be spawned.');
+        }
         candidate = observeCandidate(child);
         options.afterSpawn?.(child);
         child.unref();
         while (Date.now() < deadline && !candidate.current()) {
             await delay(50);
-            const endpoint = await readEndpoint(directory);
+            const probe = await probeEndpoint(directory, { capability, timeoutMs: remaining(deadline) });
+            const endpoint = usableEndpoint(probe, true);
             if (endpoint)
                 return endpoint;
         }
         const observed = candidate.current();
-        if (observed?.state === 'published')
-            return observed.endpoint;
+        if (observed?.state === 'published') {
+            const published = usableEndpoint(await probeEndpoint(directory, { capability, timeoutMs: finalProbeTimeout(deadline) }), true);
+            if (published)
+                return published;
+            throw unavailable();
+        }
         if (!observed) {
             await options.beforeRetirement?.(child);
             requestRetirement(child);
         }
         const outcome = observed ?? await within(candidate.outcome, retirementConfirmationMs);
-        if (outcome?.state === 'published')
-            return outcome.endpoint;
-        const replacement = await readEndpoint(directory);
+        if (outcome?.state === 'published') {
+            const published = usableEndpoint(await probeEndpoint(directory, { capability, timeoutMs: finalProbeTimeout(deadline) }), true);
+            if (published)
+                return published;
+            throw unavailable();
+        }
+        const replacement = usableEndpoint(await probeEndpoint(directory, { capability, timeoutMs: finalProbeTimeout(deadline) }), true);
         if (replacement)
             return replacement;
-        if (outcome?.state === 'retired' || outcome?.state === 'exited')
+        if (!observed && outcome)
+            throw new AgentError('STARTUP_FAILED', 'The local coordinator timed out before publishing an endpoint.');
+        if (observed?.state === 'spawn-failed')
+            throw new AgentError('STARTUP_FAILED', 'The local coordinator could not be spawned.');
+        if (observed?.state === 'exited')
+            throw new AgentError('STARTUP_FAILED', `The local coordinator exited before startup completed${processExitDescription(observed.code, observed.signal)}.`);
+        if (observed?.state === 'retired')
+            throw new AgentError('STARTUP_FAILED', 'The local coordinator retired before startup completed.');
+        if (outcome?.state === 'retired' || outcome?.state === 'exited' || outcome?.state === 'spawn-failed')
             throw new AgentError('STARTUP_FAILED', 'The local coordinator could not start.');
         throw new AgentError('STARTUP_FAILED', 'The local coordinator timed out, and its retirement could not be confirmed. It was left untouched because it may have published.');
     }
@@ -58,6 +85,31 @@ export async function connect(start, options = {}) {
         }
     }
 }
+function remaining(deadline) {
+    return Math.max(1, deadline - Date.now());
+}
+function finalProbeTimeout(deadline) {
+    return Math.max(finalProbeMs, remaining(deadline));
+}
+function unavailable() {
+    return new AgentError('COORDINATOR_UNAVAILABLE', 'No compatible coordinator is reachable from the selected state directory.');
+}
+function usableEndpoint(probe, allowProvenAbsent) {
+    switch (probe.kind) {
+        case 'reachable': return probe.endpoint;
+        case 'absent': return;
+        case 'malformed': throw new AgentError('INVALID_CONFIG', 'Coordinator endpoint metadata is malformed.');
+        case 'authentication-failed':
+            throw new AgentError('COORDINATOR_AUTH_FAILED', 'The local coordinator rejected its private authentication token.');
+        case 'incompatible':
+            throw new AgentError('COORDINATOR_INCOMPATIBLE', 'The local coordinator does not support the required protocol capability.');
+        case 'instance-mismatch': throw unavailable();
+        case 'unresponsive':
+            if (allowProvenAbsent && probe.owner === 'dead')
+                return;
+            throw unavailable();
+    }
+}
 function observeCandidate(child) {
     let current;
     let settle;
@@ -73,16 +125,17 @@ function observeCandidate(child) {
         if (value)
             finish(value);
     };
-    const onExit = () => finish({ state: 'exited' });
+    const onError = () => finish({ state: 'spawn-failed' });
+    const onExit = (code, signal) => finish({ state: 'exited', code, signal });
     child.on('message', onMessage);
-    child.once('error', onExit);
+    child.once('error', onError);
     child.once('exit', onExit);
     return {
         outcome,
         current: () => current,
         close() {
             child.off('message', onMessage);
-            child.off('error', onExit);
+            child.off('error', onError);
             child.off('exit', onExit);
         },
     };
@@ -109,34 +162,8 @@ async function within(promise, timeoutMs) {
     }
 }
 export async function* request(endpoint, body) {
-    let response;
-    try {
-        response = await fetch(endpoint.url, { method: 'POST', headers: { authorization: `Bearer ${endpoint.token}`, 'content-type': 'application/json' }, body: JSON.stringify(body) });
-    }
-    catch {
-        throw new AgentError('COORDINATOR_UNAVAILABLE', 'Connection to the local coordinator failed. The task was not automatically retried.');
-    }
-    if (!response.ok || !response.body)
-        throw new AgentError('COORDINATOR_UNAVAILABLE', 'The coordinator rejected the request.');
-    let buffer = '';
-    const decoder = new TextDecoder();
-    try {
-        for await (const chunk of response.body) {
-            buffer += decoder.decode(chunk, { stream: true });
-            let newline;
-            while ((newline = buffer.indexOf('\n')) >= 0) {
-                const line = buffer.slice(0, newline);
-                buffer = buffer.slice(newline + 1);
-                if (line)
-                    yield JSON.parse(line);
-            }
-        }
-        buffer += decoder.decode();
-        if (buffer.trim())
-            throw new Error('Incomplete response record');
-    }
-    catch {
-        throw new AgentError('COORDINATOR_UNAVAILABLE', 'The coordinator response was interrupted or invalid. The task was not automatically retried.');
-    }
+    const transport = new CoordinatorTransport(endpoint);
+    for await (const record of transport.records(body))
+        yield record;
 }
 //# sourceMappingURL=client.js.map

package/dist/runtime/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process';\nimport { setTimeout as delay } from 'node:timers/promises';\nimport { AgentError } from '../errors.js';\nimport type { OutputRecord } from '../cli/output.js';\nimport { type Endpoint, localProgram, privateDirectory, readEndpoint, stateDirectory } from './state.js';\nimport { startupOutcome, startupRetirementRequest, type StartupOutcome } from './startup-protocol.js';\n\ninterface ConnectionOptions {\n  directory?: string;\n  timeoutMs?: number;\n  afterSpawn?: (child: ChildProcess) => void;\n  beforeRetirement?: (child: ChildProcess) => void | Promise<void>;\n  program?: ReturnType<typeof localProgram>;\n}\n\ntype CandidateOutcome = StartupOutcome | {state:'exited'};\nconst retirementConfirmationMs = 1_000;\n\nexport async function connect(start: boolean, options: ConnectionOptions = {}): Promise<Endpoint> {\n  const directory = options.directory ?? stateDirectory();\n  const available = await readEndpoint(directory);\n  if (available) return available;\n  if (!start) throw new AgentError('UNKNOWN_SESSION','No coordinator is reachable from this environment. Its sessions may have ended, or native permissions may block access to its local endpoint.');\n  await privateDirectory(directory);\n  const deadline = Date.now() + (options.timeoutMs ?? 15_000);\n  let child: ChildProcess | undefined;\n  let candidate: ReturnType<typeof observeCandidate> | undefined;\n  try {\n    if (Date.now() >= deadline) throw new AgentError('STARTUP_FAILED','Another command did not finish coordinator startup.');\n    const program = options.program ?? localProgram('daemon');\n    child = spawn(process.execPath,[...program.execArgv,program.file,String(Math.max(1,deadline-Date.now()))],{\n      detached:true,stdio:['ignore','ignore','ignore','ipc'],env:{...process.env,AGENT_STATE_DIR:directory},\n    });\n    candidate = observeCandidate(child);\n    options.afterSpawn?.(child);\n    child.unref();\n    while (Date.now() < deadline && !candidate.current()) {\n      await delay(50);\n      const endpoint = await readEndpoint(directory);\n      if (endpoint) return endpoint;\n    }\n    const observed = candidate.current();\n    if (observed?.state === 'published') return observed.endpoint;\n    if (!observed) {\n      await options.beforeRetirement?.(child);\n      requestRetirement(child);\n    }\n    const outcome = observed ?? await within(candidate.outcome,retirementConfirmationMs);\n    if (outcome?.state === 'published') return outcome.endpoint;\n    const replacement = await readEndpoint(directory);\n    if (replacement) return replacement;\n    if (outcome?.state === 'retired' || outcome?.state === 'exited')\n      throw new AgentError('STARTUP_FAILED','The local coordinator could not start.');\n    throw new AgentError('STARTUP_FAILED','The local coordinator timed out, and its retirement could not be confirmed. It was left untouched because it may have published.');\n  } finally {\n    candidate?.close();\n    if (child?.connected) {\n      try { child.disconnect(); } catch { /* The candidate may have disconnected after retirement. */ }\n    }\n  }\n}\n\nfunction observeCandidate(child: ChildProcess) {\n  let current: CandidateOutcome | undefined;\n  let settle!: (outcome: CandidateOutcome) => void;\n  const outcome = new Promise<CandidateOutcome>(resolve => { settle = resolve; });\n  const finish = (value: CandidateOutcome) => {\n    if (current) return;\n    current = value;\n    settle(value);\n  };\n  const onMessage = (message: unknown) => {\n    const value = startupOutcome(message);\n    if (value) finish(value);\n  };\n  const onExit = () => finish({state:'exited'});\n  child.on('message',onMessage);\n  child.once('error',onExit);\n  child.once('exit',onExit);\n  return {\n    outcome,\n    current:() => current,\n    close() {\n      child.off('message',onMessage);\n      child.off('error',onExit);\n      child.off('exit',onExit);\n    },\n  };\n}\n\nfunction requestRetirement(child: ChildProcess) {\n  if (!child.connected) return;\n  try { child.send(startupRetirementRequest,()=>{}); }\n  catch { /* The bounded outcome wait reports an unconfirmed retirement. */ }\n}\n\nasync function within<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined> {\n  let timer: number | NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<undefined>(resolve => { timer = setTimeout(resolve,timeoutMs); }),\n    ]);\n  } finally { if (timer) clearTimeout(timer); }\n}\n\nexport async function* request(endpoint: Endpoint, body: unknown): AsyncGenerator<OutputRecord> {\n  let response: globalThis.Response;\n  try {\n    response = await fetch(endpoint.url,{method:'POST',headers:{authorization:`Bearer ${endpoint.token}`,'content-type':'application/json'},body:JSON.stringify(body)});\n  } catch { throw new AgentError('COORDINATOR_UNAVAILABLE','Connection to the local coordinator failed. The task was not automatically retried.'); }\n  if (!response.ok || !response.body) throw new AgentError('COORDINATOR_UNAVAILABLE','The coordinator rejected the request.');\n  let buffer = '';\n  const decoder = new TextDecoder();\n  try {\n    for await (const chunk of response.body) {\n      buffer += decoder.decode(chunk,{stream:true});\n      let newline;\n      while ((newline = buffer.indexOf('\\n')) >= 0) {\n        const line = buffer.slice(0,newline); buffer = buffer.slice(newline + 1);\n        if (line) yield JSON.parse(line) as OutputRecord;\n      }\n    }\n    buffer += decoder.decode();\n    if (buffer.trim()) throw new Error('Incomplete response record');\n  } catch {\n    throw new AgentError('COORDINATOR_UNAVAILABLE','The coordinator response was interrupted or invalid. The task was not automatically retried.');\n  }\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process';\nimport { setTimeout as delay } from 'node:timers/promises';\nimport { AgentError } from '../errors.js';\nimport { processExitDescription } from '../process-diagnostics.js';\nimport type { OutputRecord } from '../cli/output.js';\nimport {\n  type Endpoint,\n  type EndpointCapability,\n  type EndpointProbe,\n  localProgram,\n  privateDirectory,\n  probeEndpoint,\n  resolveStateDirectory,\n} from './state.js';\nimport { startupOutcome, startupRetirementRequest, type StartupOutcome } from './startup-protocol.js';\nimport { CoordinatorTransport } from './transport.js';\n\ninterface ConnectionOptions {\n  directory?: string;\n  timeoutMs?: number;\n  capability?: EndpointCapability;\n  afterSpawn?: (child: ChildProcess) => void;\n  beforeRetirement?: (child: ChildProcess) => void | Promise<void>;\n  program?: ReturnType<typeof localProgram>;\n}\n\ntype CandidateOutcome = StartupOutcome\n  | {state:'spawn-failed'}\n  | {state:'exited';code:unknown;signal:unknown};\nconst retirementConfirmationMs = 1_000;\nconst finalProbeMs = 250;\nexport async function connect(start: boolean, options: ConnectionOptions = {}): Promise<Endpoint> {\n  const deadline = Date.now() + (options.timeoutMs ?? 15_000);\n  const directory = resolveStateDirectory(options.directory);\n  const capability = options.capability ?? 'cli-v1';\n  const initial = await probeEndpoint(directory,{capability,timeoutMs:remaining(deadline)});\n  const available = usableEndpoint(initial,start);\n  if (available) return available;\n  if (!start) throw unavailable();\n  await privateDirectory(directory);\n  let child: ChildProcess | undefined;\n  let candidate: ReturnType<typeof observeCandidate> | undefined;\n  try {\n    if (Date.now() >= deadline) throw new AgentError('STARTUP_FAILED','Another command did not finish coordinator startup.');\n    const program = options.program ?? localProgram('daemon');\n    try {\n      child = spawn(process.execPath,[...program.execArgv,program.file,String(Math.max(1,deadline-Date.now()))],{\n        detached:true,stdio:['ignore','ignore','ignore','ipc'],env:{...process.env,AGENT_STATE_DIR:directory},\n      });\n    } catch {\n      throw new AgentError('STARTUP_FAILED','The local coordinator could not be spawned.');\n    }\n    candidate = observeCandidate(child);\n    options.afterSpawn?.(child);\n    child.unref();\n    while (Date.now() < deadline && !candidate.current()) {\n      await delay(50);\n      const probe = await probeEndpoint(directory,{capability,timeoutMs:remaining(deadline)});\n      const endpoint = usableEndpoint(probe,true);\n      if (endpoint) return endpoint;\n    }\n    const observed = candidate.current();\n    if (observed?.state === 'published') {\n      const published = usableEndpoint(await probeEndpoint(directory,{capability,timeoutMs:finalProbeTimeout(deadline)}),true);\n      if (published) return published;\n      throw unavailable();\n    }\n    if (!observed) {\n      await options.beforeRetirement?.(child);\n      requestRetirement(child);\n    }\n    const outcome = observed ?? await within(candidate.outcome,retirementConfirmationMs);\n    if (outcome?.state === 'published') {\n      const published = usableEndpoint(await probeEndpoint(directory,{capability,timeoutMs:finalProbeTimeout(deadline)}),true);\n      if (published) return published;\n      throw unavailable();\n    }\n    const replacement = usableEndpoint(await probeEndpoint(directory,{capability,timeoutMs:finalProbeTimeout(deadline)}),true);\n    if (replacement) return replacement;\n    if (!observed && outcome)\n      throw new AgentError('STARTUP_FAILED','The local coordinator timed out before publishing an endpoint.');\n    if (observed?.state === 'spawn-failed')\n      throw new AgentError('STARTUP_FAILED','The local coordinator could not be spawned.');\n    if (observed?.state === 'exited')\n      throw new AgentError('STARTUP_FAILED',\n        `The local coordinator exited before startup completed${processExitDescription(observed.code, observed.signal)}.`);\n    if (observed?.state === 'retired')\n      throw new AgentError('STARTUP_FAILED','The local coordinator retired before startup completed.');\n    if (outcome?.state === 'retired' || outcome?.state === 'exited' || outcome?.state === 'spawn-failed')\n      throw new AgentError('STARTUP_FAILED','The local coordinator could not start.');\n    throw new AgentError('STARTUP_FAILED','The local coordinator timed out, and its retirement could not be confirmed. It was left untouched because it may have published.');\n  } finally {\n    candidate?.close();\n    if (child?.connected) {\n      try { child.disconnect(); } catch { /* The candidate may have disconnected after retirement. */ }\n    }\n  }\n}\n\nfunction remaining(deadline: number): number {\n  return Math.max(1,deadline-Date.now());\n}\n\nfunction finalProbeTimeout(deadline:number):number {\n  return Math.max(finalProbeMs,remaining(deadline));\n}\n\nfunction unavailable(): AgentError {\n  return new AgentError('COORDINATOR_UNAVAILABLE','No compatible coordinator is reachable from the selected state directory.');\n}\n\nfunction usableEndpoint(probe: EndpointProbe, allowProvenAbsent: boolean): Endpoint | undefined {\n  switch (probe.kind) {\n    case 'reachable': return probe.endpoint;\n    case 'absent': return;\n    case 'malformed': throw new AgentError('INVALID_CONFIG','Coordinator endpoint metadata is malformed.');\n    case 'authentication-failed':\n      throw new AgentError('COORDINATOR_AUTH_FAILED','The local coordinator rejected its private authentication token.');\n    case 'incompatible':\n      throw new AgentError('COORDINATOR_INCOMPATIBLE','The local coordinator does not support the required protocol capability.');\n    case 'instance-mismatch': throw unavailable();\n    case 'unresponsive':\n      if (allowProvenAbsent && probe.owner === 'dead') return;\n      throw unavailable();\n  }\n}\n\nfunction observeCandidate(child: ChildProcess) {\n  let current: CandidateOutcome | undefined;\n  let settle!: (outcome: CandidateOutcome) => void;\n  const outcome = new Promise<CandidateOutcome>(resolve => { settle = resolve; });\n  const finish = (value: CandidateOutcome) => {\n    if (current) return;\n    current = value;\n    settle(value);\n  };\n  const onMessage = (message: unknown) => {\n    const value = startupOutcome(message);\n    if (value) finish(value);\n  };\n  const onError = () => finish({state:'spawn-failed'});\n  const onExit = (code: unknown, signal: unknown) => finish({state:'exited',code,signal});\n  child.on('message',onMessage);\n  child.once('error',onError);\n  child.once('exit',onExit);\n  return {\n    outcome,\n    current:() => current,\n    close() {\n      child.off('message',onMessage);\n      child.off('error',onError);\n      child.off('exit',onExit);\n    },\n  };\n}\n\nfunction requestRetirement(child: ChildProcess) {\n  if (!child.connected) return;\n  try { child.send(startupRetirementRequest,()=>{}); }\n  catch { /* The bounded outcome wait reports an unconfirmed retirement. */ }\n}\n\nasync function within<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined> {\n  let timer: number | NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<undefined>(resolve => { timer = setTimeout(resolve,timeoutMs); }),\n    ]);\n  } finally { if (timer) clearTimeout(timer); }\n}\n\nexport async function* request(endpoint: Endpoint, body: unknown): AsyncGenerator<OutputRecord> {\n  const transport=new CoordinatorTransport(endpoint);\n  for await (const record of transport.records(body)) yield record as OutputRecord;\n}\n"]}

package/dist/runtime/coordinator.d.ts

@@ -1,20 +1,28 @@
-import { type DriverFactory, type Observation, type Receipt, type SessionInput, type Delivery } from './types.js';
+import { type DriverFactory, type Observation, type Receipt, type SessionInput, type SessionCreateInput, type Delivery, type PreparedExecution } from './types.js';
 import { type DashboardDetail, type DashboardSession, type DashboardSnapshot } from './dashboard.js';
+import { type SessionSnapshot, type TaskSnapshot, type SdkSessionSnapshot, type SdkSessionSummary, type SdkTaskDetails, type SdkTaskSnapshot, type SdkTaskSummary, type TaskResult, type CompleteResponse, type Page, type PageOptions } from './snapshots.js';
+import type { ApprovalResponse } from './task-data.js';
 export declare class Coordinator {
     private readonly factory;
     private readonly now;
+    private readonly instanceId;
     private sessions;
     private tasks;
     private dashboardHistory?;
     private closed;
+    private closeComplete;
+    private closePromise?;
+    private membership;
     private approvals;
-    constructor(factory: DriverFactory, now?: () => number);
+    constructor(factory: DriverFactory, now?: () => number, instanceId?: string);
     parentContext(token: string): {
         taskId: string;
+        sessionId: string;
         reference: import("./types.js").ExecutionReference;
         cwd: string;
     };
-    run(input: SessionInput): Receipt;
+    createSession(input: SessionCreateInput, prepared?: PreparedExecution): string;
+    run(input: SessionInput, prepared?: PreparedExecution): Receipt;
     send(id: string, prompt: string, delivery: Delivery, parentToken?: string): Promise<Receipt>;
     observe(id: string, after?: string, readerToken?: string, signal?: AbortSignal): Promise<Observation>;
     private acknowledge;
@@ -23,8 +31,8 @@ export declare class Coordinator {
         type: string;
         taskId: string;
         sessionId: string;
-        state: import("./types.js").TaskState;
-        requests?: import("./types.js").ApprovalRequest[] | undefined;
+        state: import("./task-data.js").TaskState;
+        requests?: import("./task-data.js").ApprovalRequest[] | undefined;
         error?: import("../errors.js").ErrorInfo | undefined;
         response?: {
             responseId: string;
@@ -32,6 +40,26 @@ export declare class Coordinator {
             truncated: boolean;
         } | undefined;
     };
+    snapshot(id: string): TaskSnapshot;
+    sessionSnapshot(id: string): SessionSnapshot;
+    sdkTaskSnapshot(id: string): SdkTaskSnapshot;
+    sdkSessionSnapshot(id: string): Promise<SdkSessionSnapshot>;
+    taskDetails(id: string): SdkTaskDetails;
+    taskResult(id: string, signal?: AbortSignal): Promise<TaskResult>;
+    taskResponses(id: string, after?: string, signal?: AbortSignal): AsyncIterable<CompleteResponse>;
+    watchTask(id: string, signal?: AbortSignal): AsyncIterable<SdkTaskSnapshot>;
+    listSessions(options?: PageOptions): Promise<Page<SdkSessionSummary>>;
+    listTasks(options?: PageOptions & {
+        readonly sessionId?: string;
+    }): Page<SdkTaskSummary>;
+    respondSdk(id: string, response: ApprovalResponse): {
+        version: 1;
+        type: 'approval_answered';
+        requestId: string;
+        taskId: string;
+        sessionId: string;
+    };
+    watch(id: string, signal?: AbortSignal): AsyncIterable<TaskSnapshot>;
     respond(id: string, content: unknown, parentToken?: string): {
         version: 1;
         type: 'approval_answered';
@@ -52,17 +80,20 @@ export declare class Coordinator {
         paused: boolean;
         active?: {
             taskId: string;
-            state: import("./types.js").TaskState;
+            state: import("./task-data.js").TaskState;
             description: string;
         } | undefined;
         tasks: {
             taskId: string;
-            state: import("./types.js").TaskState;
+            state: import("./task-data.js").TaskState;
             description: string;
         }[];
     };
     resume(id: string): Promise<Receipt>;
     close(): Promise<void>;
+    closeSession(id: string): Promise<void>;
+    private cleanupSession;
+    private cleanupErrors;
     cancel(id: string): Promise<Receipt>;
     private command;
     private stop;
@@ -74,7 +105,13 @@ export declare class Coordinator {
     private pending;
     private deliver;
     private continueParent;
+    private summary;
+    private sdkSummary;
+    private sdkSessionSummary;
+    private sdkSessionSummaryResolved;
+    private sdkPendingApprovals;
     private touch;
+    private publish;
     private pendingApprovals;
     private approvalChanged;
     private notify;