subharness 0.0.5 → 0.0.7

package/dist/runtime/sdk-observation.d.ts

@@ -0,0 +1,8 @@
+import type { CompleteResponse, SdkTaskSnapshot } from './snapshots.js';
+import { type Task } from './types.js';
+export interface TerminalCapture {
+    readonly snapshot: SdkTaskSnapshot;
+    readonly response?: CompleteResponse;
+}
+export declare function terminalInterval(task: Task, read: () => SdkTaskSnapshot, signal?: AbortSignal): Promise<TerminalCapture>;
+export declare function responseReplay(task: Task, start: number, signal?: AbortSignal): AsyncIterable<CompleteResponse>;

package/dist/runtime/sdk-observation.js

@@ -0,0 +1,75 @@
+import { AgentError } from '../errors.js';
+import { detached } from './snapshots.js';
+import { terminal } from './types.js';
+export function terminalInterval(task, read, signal) {
+    if (signal?.aborted)
+        return Promise.reject(closed());
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const cleanup = () => { task.watchers.delete(change); signal?.removeEventListener('abort', abort); };
+        const change = () => {
+            if (settled || !terminal(task.state))
+                return;
+            settled = true;
+            cleanup();
+            const response = task.responses.at(-1);
+            resolve({ snapshot: read(), ...(response ? { response: detached(response) } : {}) });
+        };
+        const abort = () => { if (!settled) {
+            settled = true;
+            cleanup();
+            reject(closed());
+        } };
+        task.watchers.add(change);
+        signal?.addEventListener('abort', abort, { once: true });
+        change();
+    });
+}
+export function responseReplay(task, start, signal) {
+    return {
+        [Symbol.asyncIterator]() {
+            let position = start, boundary, ended = false;
+            const wakes = new Set();
+            const wakeAll = () => { for (const wake of wakes)
+                wake(); wakes.clear(); };
+            const detach = () => { task.watchers.delete(changed); signal?.removeEventListener('abort', aborted); };
+            const changed = () => {
+                if (terminal(task.state) && boundary === undefined) {
+                    boundary = task.responses.length;
+                    detach();
+                }
+                wakeAll();
+            };
+            const cleanup = () => { ended = true; detach(); wakeAll(); };
+            const aborted = () => cleanup();
+            if (!signal?.aborted) {
+                task.watchers.add(changed);
+                signal?.addEventListener('abort', aborted, { once: true });
+                changed();
+            }
+            return {
+                async next() {
+                    for (;;) {
+                        if (signal?.aborted) {
+                            cleanup();
+                            throw closed();
+                        }
+                        if (ended)
+                            return { done: true, value: undefined };
+                        const limit = boundary ?? task.responses.length;
+                        if (position < limit)
+                            return { done: false, value: detached(task.responses[position++]) };
+                        if (boundary !== undefined || ended) {
+                            cleanup();
+                            return { done: true, value: undefined };
+                        }
+                        await new Promise(resolve => { wakes.add(resolve); });
+                    }
+                },
+                async return() { cleanup(); return { done: true, value: undefined }; },
+            };
+        },
+    };
+}
+const closed = () => new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.');
+//# sourceMappingURL=sdk-observation.js.map

package/dist/runtime/sdk-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-observation.js","sourceRoot":"","sources":["../../src/runtime/sdk-observation.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport type { CompleteResponse, SdkTaskSnapshot } from './snapshots.js';\nimport { detached } from './snapshots.js';\nimport { terminal, type Task } from './types.js';\n\nexport interface TerminalCapture {\n  readonly snapshot: SdkTaskSnapshot;\n  readonly response?: CompleteResponse;\n}\n\nexport function terminalInterval(task: Task, read: () => SdkTaskSnapshot, signal?: AbortSignal): Promise<TerminalCapture> {\n  if (signal?.aborted) return Promise.reject(closed());\n  return new Promise((resolve,reject) => {\n    let settled = false;\n    const cleanup = () => { task.watchers.delete(change); signal?.removeEventListener('abort',abort); };\n    const change = () => {\n      if (settled || !terminal(task.state)) return;\n      settled=true; cleanup();\n      const response=task.responses.at(-1);\n      resolve({snapshot:read(),...(response ? {response:detached(response)} : {})});\n    };\n    const abort = () => { if (!settled) { settled=true; cleanup(); reject(closed()); } };\n    task.watchers.add(change);\n    signal?.addEventListener('abort',abort,{once:true});\n    change();\n  });\n}\n\nexport function responseReplay(task: Task, start: number, signal?: AbortSignal): AsyncIterable<CompleteResponse> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<CompleteResponse> {\n      let position=start, boundary:number|undefined, ended=false;\n      const wakes=new Set<()=>void>();\n      const wakeAll=()=>{ for (const wake of wakes) wake(); wakes.clear(); };\n      const detach=()=>{ task.watchers.delete(changed); signal?.removeEventListener('abort',aborted); };\n      const changed=()=>{\n        if (terminal(task.state) && boundary === undefined) { boundary=task.responses.length; detach(); }\n        wakeAll();\n      };\n      const cleanup=()=>{ ended=true; detach(); wakeAll(); };\n      const aborted=()=>cleanup();\n      if (!signal?.aborted) {\n        task.watchers.add(changed);\n        signal?.addEventListener('abort',aborted,{once:true});\n        changed();\n      }\n      return {\n        async next() {\n          for (;;) {\n            if (signal?.aborted) { cleanup(); throw closed(); }\n            if (ended) return {done:true,value:undefined};\n            const limit=boundary ?? task.responses.length;\n            if (position < limit) return {done:false,value:detached(task.responses[position++]!)};\n            if (boundary !== undefined || ended) { cleanup(); return {done:true,value:undefined}; }\n            await new Promise<void>(resolve=>{ wakes.add(resolve); });\n          }\n        },\n        async return() { cleanup(); return {done:true,value:undefined}; },\n      };\n    },\n  };\n}\n\nconst closed=()=>new AgentError('OBSERVATION_CLOSED','The observer disconnected.');\n"]}

package/dist/runtime/sdk-projection.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessKind } from '../sdk/types.js';
+import type { DashboardWorkspace } from './dashboard.js';
+import type { SdkApprovalRequest } from './task-data.js';
+import type { SdkSessionSummary, SdkTaskSnapshot, SdkTaskSummary } from './snapshots.js';
+import type { Session, Task } from './types.js';
+export declare function sdkTaskSummary(task: Task, selectedHarness?: HarnessKind): SdkTaskSummary;
+export declare function sdkTaskSnapshot(task: Task, summary: (task: Task) => SdkTaskSummary, lookup: (id: string) => Task, requests: readonly SdkApprovalRequest[]): SdkTaskSnapshot;
+export declare function sdkSessionSummary(session: Session, workspace: DashboardWorkspace, summary: (task: Task) => SdkTaskSummary, lookup: (id: string) => Task): SdkSessionSummary;

package/dist/runtime/sdk-projection.js

@@ -0,0 +1,19 @@
+export function sdkTaskSummary(task, selectedHarness) {
+    return { taskId: task.id, sessionId: task.sessionId, state: task.state,
+        ...(selectedHarness ? { selectedHarness } : {}), title: task.title, ordinal: task.ordinal, updatedAt: task.updatedAt,
+        ...(task.dispatchedAt === undefined ? {} : { dispatchedAt: task.dispatchedAt }),
+        ...(task.failedAt === undefined ? {} : { failedAt: task.failedAt }),
+        ...(task.finishedAt === undefined ? {} : { finishedAt: task.finishedAt }) };
+}
+export function sdkTaskSnapshot(task, summary, lookup, requests) {
+    const response = task.responses.at(-1);
+    return { ...summary(task), revision: task.revision, ...(task.parentId ? { parentTaskId: task.parentId } : {}),
+        children: [...task.children].map(id => summary(lookup(id))), requests,
+        ...(response ? { latestResponse: { responseId: response.responseId, text: response.text, state: response.state } } : {}),
+        ...(task.error ? { error: task.error } : {}), stopUnconfirmed: task.stopUnconfirmed ?? false };
+}
+export function sdkSessionSummary(session, workspace, summary, lookup) {
+    return { sessionId: session.id, state: session.state, paused: session.paused, cwd: session.input.cwd, workspace,
+        ...(session.active ? { active: summary(lookup(session.active)) } : {}) };
+}
+//# sourceMappingURL=sdk-projection.js.map

package/dist/runtime/sdk-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-projection.js","sourceRoot":"","sources":["../../src/runtime/sdk-projection.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAAC,IAAS,EAAC,eAA4B;IACnE,OAAO,EAAC,MAAM,EAAC,IAAI,CAAC,EAAE,EAAC,SAAS,EAAC,IAAI,CAAC,SAAS,EAAC,KAAK,EAAC,IAAI,CAAC,KAAK;QAC9D,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAC,eAAe,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,KAAK,EAAC,IAAI,CAAC,KAAK,EAAC,OAAO,EAAC,IAAI,CAAC,OAAO,EAAC,SAAS,EAAC,IAAI,CAAC,SAAS;QAC5G,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,YAAY,EAAC,IAAI,CAAC,YAAY,EAAC,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAC,IAAI,CAAC,QAAQ,EAAC,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAC,IAAI,CAAC,UAAU,EAAC,CAAC,EAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAS,EAAC,OAAmC,EAC3E,MAAwB,EAAC,QAAsC;IAC/D,MAAM,QAAQ,GAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,EAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAC,IAAI,CAAC,QAAQ,EAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAC,YAAY,EAAC,IAAI,CAAC,QAAQ,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,QAAQ,EAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA,EAAE,CAAA,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,QAAQ;QACjE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAC,cAAc,EAAC,EAAC,UAAU,EAAC,QAAQ,CAAC,UAAU,EAAC,IAAI,EAAC,QAAQ,CAAC,IAAI,EAAC,KAAK,EAAC,QAAQ,CAAC,KAAK,EAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9G,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAC,IAAI,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,eAAe,EAAC,IAAI,CAAC,eAAe,IAAI,KAAK,EAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAC,SAA4B,EAC5E,OAAmC,EAAC,MAAwB;IAC5D,OAAO,EAAC,SAAS,EAAC,OAAO,CAAC,EAAE,EAAC,KAAK,EAAC,OAAO,CAAC,KAAK,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,EAAC,GAAG,EAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAC,SAAS;QACpG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC;AACzE,CAAC","sourcesContent":["import type { HarnessKind } from '../sdk/types.js';\nimport type { DashboardWorkspace } from './dashboard.js';\nimport type { SdkApprovalRequest } from './task-data.js';\nimport type { SdkSessionSummary, SdkTaskSnapshot, SdkTaskSummary } from './snapshots.js';\nimport type { Session, Task } from './types.js';\n\nexport function sdkTaskSummary(task:Task,selectedHarness?:HarnessKind):SdkTaskSummary {\n  return {taskId:task.id,sessionId:task.sessionId,state:task.state,\n    ...(selectedHarness ? {selectedHarness} : {}),title:task.title,ordinal:task.ordinal,updatedAt:task.updatedAt,\n    ...(task.dispatchedAt === undefined ? {} : {dispatchedAt:task.dispatchedAt}),\n    ...(task.failedAt === undefined ? {} : {failedAt:task.failedAt}),\n    ...(task.finishedAt === undefined ? {} : {finishedAt:task.finishedAt})};\n}\n\nexport function sdkTaskSnapshot(task:Task,summary:(task:Task)=>SdkTaskSummary,\n  lookup:(id:string)=>Task,requests:readonly SdkApprovalRequest[]):SdkTaskSnapshot {\n  const response=task.responses.at(-1);\n  return {...summary(task),revision:task.revision,...(task.parentId ? {parentTaskId:task.parentId} : {}),\n    children:[...task.children].map(id=>summary(lookup(id))),requests,\n    ...(response ? {latestResponse:{responseId:response.responseId,text:response.text,state:response.state}} : {}),\n    ...(task.error ? {error:task.error} : {}),stopUnconfirmed:task.stopUnconfirmed ?? false};\n}\n\nexport function sdkSessionSummary(session:Session,workspace:DashboardWorkspace,\n  summary:(task:Task)=>SdkTaskSummary,lookup:(id:string)=>Task):SdkSessionSummary {\n  return {sessionId:session.id,state:session.state,paused:session.paused,cwd:session.input.cwd,workspace,\n    ...(session.active ? {active:summary(lookup(session.active))} : {})};\n}\n"]}

package/dist/runtime/sdk-service.d.ts

@@ -0,0 +1,11 @@
+import type { Coordinator } from './coordinator.js';
+type Request = Record<string, unknown>;
+export interface SdkServiceOperations {
+    listAgents(data: Request): Promise<unknown>;
+    checkAgent(data: Request): Promise<void>;
+    createSession(data: Request): Promise<string>;
+    closeSession(id: string): Promise<void>;
+}
+export declare function isSdkCommand(value: unknown): boolean;
+export declare function dispatchSdkRequest(engine: Coordinator, data: Request, signal: AbortSignal, operations?: SdkServiceOperations): AsyncGenerator<unknown>;
+export {};

package/dist/runtime/sdk-service.js

@@ -0,0 +1,109 @@
+import { AgentError } from '../errors.js';
+export function isSdkCommand(value) {
+    return typeof value === 'string' && value.startsWith('sdk-');
+}
+export async function* dispatchSdkRequest(engine, data, signal, operations) {
+    const command = text(data.command, 'SDK command');
+    switch (command) {
+        case 'sdk-agent-list':
+            if (!operations)
+                throw new AgentError('COORDINATOR_UNAVAILABLE', 'Connected agent discovery is unavailable.');
+            yield await operations.listAgents(data);
+            return;
+        case 'sdk-agent-check':
+            if (!operations)
+                throw new AgentError('COORDINATOR_UNAVAILABLE', 'Connected agent checks are unavailable.');
+            await operations.checkAgent(data);
+            yield { version: 1, type: 'ack' };
+            return;
+        case 'sdk-session-create': {
+            if (!operations)
+                throw new AgentError('COORDINATOR_UNAVAILABLE', 'Connected session creation is unavailable.');
+            const sessionId = await operations.createSession(data);
+            yield { version: 1, type: 'session-created', sessionId };
+            return;
+        }
+        case 'sdk-session-list':
+            yield await engine.listSessions(page(data));
+            return;
+        case 'sdk-session-get':
+            yield await engine.sdkSessionSnapshot(text(data.id, 'Session ID'));
+            return;
+        case 'sdk-session-prompt': {
+            const selected = delivery(data.delivery);
+            yield await engine.send(text(data.id, 'Session ID'), text(data.prompt, 'Prompt'), selected);
+            return;
+        }
+        case 'sdk-session-close':
+            if (operations)
+                await operations.closeSession(text(data.id, 'Session ID'));
+            else
+                await engine.closeSession(text(data.id, 'Session ID'));
+            yield { version: 1, type: 'ack' };
+            return;
+        case 'sdk-task-list':
+            yield engine.listTasks({ ...page(data), ...(data.sessionId === undefined ? {} : { sessionId: text(data.sessionId, 'Session ID') }) });
+            return;
+        case 'sdk-task-get':
+        case 'sdk-task-snapshot':
+            yield engine.sdkTaskSnapshot(text(data.id, 'Task ID'));
+            return;
+        case 'sdk-task-inspect':
+            yield engine.taskDetails(text(data.id, 'Task ID'));
+            return;
+        case 'sdk-task-result':
+            yield await engine.taskResult(text(data.id, 'Task ID'), signal);
+            return;
+        case 'sdk-task-watch':
+            for await (const snapshot of engine.watchTask(text(data.id, 'Task ID'), signal))
+                yield snapshot;
+            return;
+        case 'sdk-task-responses':
+            for await (const response of engine.taskResponses(text(data.id, 'Task ID'), optionalString(data.after, 'Response cursor'), signal))
+                yield response;
+            return;
+        case 'sdk-task-cancel': {
+            const id = text(data.id, 'Task ID');
+            await engine.cancel(id);
+            yield engine.sdkTaskSnapshot(id);
+            return;
+        }
+        case 'sdk-approval-respond':
+            engine.respondSdk(text(data.id, 'Approval ID'), data.response);
+            yield { version: 1, type: 'ack' };
+            return;
+        default: throw new AgentError('INVALID_ARGUMENT', 'Unknown SDK coordinator operation.');
+    }
+}
+function page(data) {
+    const result = {};
+    if (data.limit !== undefined) {
+        if (!Number.isSafeInteger(data.limit) || data.limit <= 0)
+            throw new AgentError('INVALID_ARGUMENT', 'Page limit must be a positive integer.');
+        result.limit = data.limit;
+    }
+    if (data.cursor !== undefined)
+        result.cursor = string(data.cursor, 'Page cursor');
+    return result;
+}
+function delivery(value) {
+    if (value === undefined)
+        return 'queue';
+    if (value !== 'queue' && value !== 'steer' && value !== 'interrupt')
+        throw new AgentError('INVALID_ARGUMENT', 'Unknown delivery mode.');
+    return value;
+}
+function text(value, label) {
+    if (typeof value !== 'string' || !value)
+        throw new AgentError('INVALID_ARGUMENT', `${label} must be a nonempty string.`);
+    return value;
+}
+function string(value, label) {
+    if (typeof value !== 'string')
+        throw new AgentError('INVALID_ARGUMENT', `${label} must be a string.`);
+    return value;
+}
+function optionalString(value, label) {
+    return value === undefined ? undefined : string(value, label);
+}
+//# sourceMappingURL=sdk-service.js.map

package/dist/runtime/sdk-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-service.js","sourceRoot":"","sources":["../../src/runtime/sdk-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport type { Coordinator } from './coordinator.js';\nimport type { Delivery } from './types.js';\n\ntype Request=Record<string,unknown>;\nexport interface SdkServiceOperations {\n  listAgents(data:Request):Promise<unknown>;\n  checkAgent(data:Request):Promise<void>;\n  createSession(data:Request):Promise<string>;\n  closeSession(id:string):Promise<void>;\n}\n\nexport function isSdkCommand(value:unknown):boolean {\n  return typeof value === 'string' && value.startsWith('sdk-');\n}\n\nexport async function* dispatchSdkRequest(\n  engine:Coordinator,\n  data:Request,\n  signal:AbortSignal,\n  operations?:SdkServiceOperations,\n):AsyncGenerator<unknown> {\n  const command=text(data.command,'SDK command');\n  switch(command) {\n    case 'sdk-agent-list':\n      if (!operations) throw new AgentError('COORDINATOR_UNAVAILABLE','Connected agent discovery is unavailable.');\n      yield await operations.listAgents(data); return;\n    case 'sdk-agent-check':\n      if (!operations) throw new AgentError('COORDINATOR_UNAVAILABLE','Connected agent checks are unavailable.');\n      await operations.checkAgent(data); yield {version:1,type:'ack'}; return;\n    case 'sdk-session-create': {\n      if (!operations) throw new AgentError('COORDINATOR_UNAVAILABLE','Connected session creation is unavailable.');\n      const sessionId=await operations.createSession(data);\n      yield {version:1,type:'session-created',sessionId}; return;\n    }\n    case 'sdk-session-list':\n      yield await engine.listSessions(page(data)); return;\n    case 'sdk-session-get':\n      yield await engine.sdkSessionSnapshot(text(data.id,'Session ID')); return;\n    case 'sdk-session-prompt': {\n      const selected=delivery(data.delivery);\n      yield await engine.send(text(data.id,'Session ID'),text(data.prompt,'Prompt'),selected); return;\n    }\n    case 'sdk-session-close':\n      if (operations) await operations.closeSession(text(data.id,'Session ID'));\n      else await engine.closeSession(text(data.id,'Session ID'));\n      yield {version:1,type:'ack'}; return;\n    case 'sdk-task-list':\n      yield engine.listTasks({...page(data),...(data.sessionId === undefined ? {} : {sessionId:text(data.sessionId,'Session ID')})}); return;\n    case 'sdk-task-get':\n    case 'sdk-task-snapshot':\n      yield engine.sdkTaskSnapshot(text(data.id,'Task ID')); return;\n    case 'sdk-task-inspect':\n      yield engine.taskDetails(text(data.id,'Task ID')); return;\n    case 'sdk-task-result':\n      yield await engine.taskResult(text(data.id,'Task ID'),signal); return;\n    case 'sdk-task-watch':\n      for await (const snapshot of engine.watchTask(text(data.id,'Task ID'),signal)) yield snapshot;\n      return;\n    case 'sdk-task-responses':\n      for await (const response of engine.taskResponses(text(data.id,'Task ID'),optionalString(data.after,'Response cursor'),signal)) yield response;\n      return;\n    case 'sdk-task-cancel': {\n      const id=text(data.id,'Task ID');\n      await engine.cancel(id); yield engine.sdkTaskSnapshot(id); return;\n    }\n    case 'sdk-approval-respond':\n      engine.respondSdk(text(data.id,'Approval ID'),data.response as never);\n      yield {version:1,type:'ack'}; return;\n    default: throw new AgentError('INVALID_ARGUMENT','Unknown SDK coordinator operation.');\n  }\n}\n\nfunction page(data:Request):{limit?:number;cursor?:string} {\n  const result:{limit?:number;cursor?:string}={};\n  if (data.limit !== undefined) {\n    if (!Number.isSafeInteger(data.limit) || (data.limit as number) <= 0)\n      throw new AgentError('INVALID_ARGUMENT','Page limit must be a positive integer.');\n    result.limit=data.limit as number;\n  }\n  if (data.cursor !== undefined) result.cursor=string(data.cursor,'Page cursor');\n  return result;\n}\n\nfunction delivery(value:unknown):Delivery {\n  if (value === undefined) return 'queue';\n  if (value !== 'queue' && value !== 'steer' && value !== 'interrupt')\n    throw new AgentError('INVALID_ARGUMENT','Unknown delivery mode.');\n  return value;\n}\n\nfunction text(value:unknown,label:string):string {\n  if (typeof value !== 'string' || !value) throw new AgentError('INVALID_ARGUMENT',`${label} must be a nonempty string.`);\n  return value;\n}\nfunction string(value:unknown,label:string):string {\n  if (typeof value !== 'string') throw new AgentError('INVALID_ARGUMENT',`${label} must be a string.`);\n  return value;\n}\nfunction optionalString(value:unknown,label:string):string|undefined {\n  return value === undefined ? undefined : string(value,label);\n}\n"]}

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

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

package/dist/runtime/select-native.js

@@ -1,22 +1,16 @@
-import { openCodex } from '../adapters/codex.js';
-import { openClaude } from '../adapters/claude.js';
-import { openFx } from '../adapters/fx.js';
-import { openOpencode } from '../adapters/opencode.js';
-import { openCopilot } from '../adapters/copilot.js';
-import { openCursor } from '../adapters/cursor.js';
 import { resolveAccess } from '../config/access.js';
 import { accessAttemptContext } from '../config/access-provenance.js';
 import { AgentError } from '../errors.js';
 import { withAccessContext, withSessionAccessContext } from './access-errors.js';
 const openers = {
-    codex: openCodex,
-    claudeCode: openClaude,
-    fx: openFx,
-    opencode: openOpencode,
-    copilot: openCopilot,
-    cursor: openCursor,
+    codex: async (options) => (await import('../adapters/codex.js')).openCodex(options),
+    claudeCode: async (options) => (await import('../adapters/claude.js')).openClaude(options),
+    fx: async (options) => (await import('../adapters/fx.js')).openFx(options),
+    opencode: async (options) => (await import('../adapters/opencode.js')).openOpencode(options),
+    copilot: async (options) => (await import('../adapters/copilot.js')).openCopilot(options),
+    cursor: async (options) => (await import('../adapters/cursor.js')).openCursor(options),
 };
-export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }, onApproval) {
+export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }, onApproval, diagnosticContext = { origin: 'cli' }) {
     const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];
     const unavailable = [];
     for (const harness of alternatives) {
@@ -25,12 +19,15 @@ export async function selectNative(agent, cwd, env, settings, open = (options) =
         const connections = configuredConnections ??
             (explicitAccessRequired ? [] : [{ type: 'subscription' }]);
         if (configuredConnections?.length === 0) {
-            unavailable.push(`${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);
+            unavailable.push(diagnosticContext.origin === 'sdk'
+                ? `${harness.kind}: Access is disabled by the empty connection list in RunnerOptions.access.`
+                : `${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);
         }
         else if (!connections.length && explicitAccessRequired) {
-            unavailable.push(harness.kind === 'cursor'
-                ? 'cursor: Enable an explicit Cursor subscription or API-key connection in personal access settings.'
-                : `${harness.kind}: Enable an explicit native login, API-key, or Gateway connection in personal access settings.`);
+            const setting = diagnosticContext.origin === 'sdk' ? 'RunnerOptions.access' : 'personal access settings';
+            const guidance = harness.kind === 'cursor' ? 'Cursor subscription or API-key'
+                : 'native login, API-key, or Gateway';
+            unavailable.push(`${harness.kind}: Enable an explicit ${guidance} connection in ${setting}.`);
         }
         for (const [index, connection] of connections.entries()) {
             const context = accessAttemptContext(settings, harness.kind, connection, index, connections.length);

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

@@ -1 +1 @@
-{"version":3,"file":"select-native.js","sourceRoot":"","sources":["../../src/runtime/select-native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HarnessKind } from '../sdk/types.js';\nimport type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport { openCodex } from '../adapters/codex.js';\nimport { openClaude } from '../adapters/claude.js';\nimport { openFx } from '../adapters/fx.js';\nimport { openOpencode } from '../adapters/opencode.js';\nimport { openCopilot } from '../adapters/copilot.js';\nimport { openCursor } from '../adapters/cursor.js';\nimport { resolveAccess, type AccessConfig } from '../config/access.js';\nimport { accessAttemptContext } from '../config/access-provenance.js';\nimport { AgentError } from '../errors.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\nimport { withAccessContext, withSessionAccessContext } from './access-errors.js';\n\nconst openers = {\n  codex:openCodex,\n  claudeCode:openClaude,\n  fx:openFx,\n  opencode:openOpencode,\n  copilot:openCopilot,\n  cursor:openCursor,\n} satisfies Record<HarnessKind, (options: AdapterOptions) => Promise<NativeSession>>;\n\nexport async function selectNative(\n  agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig,\n  open = (options: AdapterOptions): Promise<NativeSession> => openers[options.harness.kind](options),\n  selected: (kind: HarnessKind) => void = () => {},\n  onApproval?: ApprovalHandler,\n): Promise<NativeSession> {\n  const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];\n  const unavailable: string[] = [];\n  for (const harness of alternatives) {\n    const configuredConnections = settings.access?.[harness.kind as HarnessKind];\n    const explicitAccessRequired = ['fx','opencode','copilot','cursor'].includes(harness.kind);\n    const connections = configuredConnections ??\n      (explicitAccessRequired ? [] : [{type:'subscription' as const}]);\n    if (configuredConnections?.length === 0) {\n      unavailable.push(`${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);\n    } else if (!connections.length && explicitAccessRequired) {\n      unavailable.push(harness.kind === 'cursor'\n        ? 'cursor: Enable an explicit Cursor subscription or API-key connection in personal access settings.'\n        : `${harness.kind}: Enable an explicit native login, API-key, or Gateway connection in personal access settings.`);\n    }\n    for (const [index, connection] of connections.entries()) {\n      const context = accessAttemptContext(settings, harness.kind, connection, index, connections.length);\n      try {\n        const access = await resolveAccess(connection, harness.kind, cwd, env);\n        const native = await open({agent,harness,cwd,env,access,...(onApproval ? {onApproval} : {})});\n        selected(harness.kind);\n        return withSessionAccessContext(native, context);\n      } catch (error) {\n        if (!(error instanceof AgentError)) throw error;\n        if (!['HARNESS_UNAVAILABLE','ACCESS_UNAVAILABLE'].includes(error.code)) throw withAccessContext(error, context);\n        unavailable.push(`${harness.kind}: ${withAccessContext(error, context).message}`);\n      }\n    }\n  }\n  throw new AgentError('ACCESS_UNAVAILABLE', unavailable.length ? unavailable.join('\\n') : 'No declared harness has enabled access.');\n}\n"]}
+{"version":3,"file":"select-native.js","sourceRoot":"","sources":["../../src/runtime/select-native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HarnessKind } from '../sdk/types.js';\nimport type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';\nimport { resolveAccess, type AccessConfig } from '../config/access.js';\nimport { accessAttemptContext } from '../config/access-provenance.js';\nimport { AgentError } from '../errors.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\nimport { withAccessContext, withSessionAccessContext } from './access-errors.js';\n\nconst openers = {\n  codex: async (options: AdapterOptions) => (await import('../adapters/codex.js')).openCodex(options),\n  claudeCode: async (options: AdapterOptions) => (await import('../adapters/claude.js')).openClaude(options),\n  fx: async (options: AdapterOptions) => (await import('../adapters/fx.js')).openFx(options),\n  opencode: async (options: AdapterOptions) => (await import('../adapters/opencode.js')).openOpencode(options),\n  copilot: async (options: AdapterOptions) => (await import('../adapters/copilot.js')).openCopilot(options),\n  cursor: async (options: AdapterOptions) => (await import('../adapters/cursor.js')).openCursor(options),\n} satisfies Record<HarnessKind, (options: AdapterOptions) => Promise<NativeSession>>;\n\nexport interface NativeSelectionDiagnosticContext {\n  readonly origin: 'cli' | 'sdk';\n}\n\nexport async function selectNative(\n  agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig,\n  open = (options: AdapterOptions): Promise<NativeSession> => openers[options.harness.kind](options),\n  selected: (kind: HarnessKind) => void = () => {},\n  onApproval?: ApprovalHandler,\n  diagnosticContext: NativeSelectionDiagnosticContext = {origin: 'cli'},\n): Promise<NativeSession> {\n  const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];\n  const unavailable: string[] = [];\n  for (const harness of alternatives) {\n    const configuredConnections = settings.access?.[harness.kind as HarnessKind];\n    const explicitAccessRequired = ['fx','opencode','copilot','cursor'].includes(harness.kind);\n    const connections = configuredConnections ??\n      (explicitAccessRequired ? [] : [{type:'subscription' as const}]);\n    if (configuredConnections?.length === 0) {\n      unavailable.push(diagnosticContext.origin === 'sdk'\n        ? `${harness.kind}: Access is disabled by the empty connection list in RunnerOptions.access.`\n        : `${harness.kind}: Access is disabled in the main checkout's .subharness/agents.local.json.`);\n    } else if (!connections.length && explicitAccessRequired) {\n      const setting = diagnosticContext.origin === 'sdk' ? 'RunnerOptions.access' : 'personal access settings';\n      const guidance = harness.kind === 'cursor' ? 'Cursor subscription or API-key'\n        : 'native login, API-key, or Gateway';\n      unavailable.push(`${harness.kind}: Enable an explicit ${guidance} connection in ${setting}.`);\n    }\n    for (const [index, connection] of connections.entries()) {\n      const context = accessAttemptContext(settings, harness.kind, connection, index, connections.length);\n      try {\n        const access = await resolveAccess(connection, harness.kind, cwd, env);\n        const native = await open({agent,harness,cwd,env,access,...(onApproval ? {onApproval} : {})});\n        selected(harness.kind);\n        return withSessionAccessContext(native, context);\n      } catch (error) {\n        if (!(error instanceof AgentError)) throw error;\n        if (!['HARNESS_UNAVAILABLE','ACCESS_UNAVAILABLE'].includes(error.code)) throw withAccessContext(error, context);\n        unavailable.push(`${harness.kind}: ${withAccessContext(error, context).message}`);\n      }\n    }\n  }\n  throw new AgentError('ACCESS_UNAVAILABLE', unavailable.length ? unavailable.join('\\n') : 'No declared harness has enabled access.');\n}\n"]}

package/dist/runtime/service.d.ts

@@ -1,5 +1,15 @@
 import { Coordinator } from './coordinator.js';
-export declare function startService(engine: Coordinator, token: string, instanceId: string): Promise<{
+import { captureExecution, captureReference, checkCapturedExecution, type CapturedExecution } from './capture.js';
+export interface ServiceCaptureOperations {
+    captureExecution: typeof captureExecution;
+    captureReference: typeof captureReference;
+    checkCapturedExecution: typeof checkCapturedExecution;
+}
+export interface ServiceOptions {
+    readonly initialCaptures?: ReadonlyMap<string, CapturedExecution>;
+    readonly capture?: Partial<ServiceCaptureOperations>;
+}
+export declare function startService(engine: Coordinator, token: string, instanceId: string, state?: string, options?: ServiceOptions): Promise<{
     url: string;
     close(): Promise<void>;
 }>;

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