subharness 0.0.4 → 0.0.7

package/dist/runtime/native-owner.js

@@ -15,10 +15,16 @@ export class NativeOwner {
         return native;
     }
     close() {
-        this.closing ??= (async () => {
+        if (this.closing)
+            return this.closing;
+        const attempt = (async () => {
             const native = await this.opening?.catch(() => undefined);
             await native?.close();
         })();
+        this.closing = attempt.catch(error => {
+            this.closing = undefined;
+            throw error;
+        });
         return this.closing;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"native-owner.js","sourceRoot":"","sources":["../../src/runtime/native-owner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,oFAAoF;AACpF,MAAM,OAAO,WAAW;IACd,OAAO,CAA0B;IACjC,OAAO,CAAiB;IAEhC,KAAK,CAAC,IAAI,CAAC,OAAqC;QAC9C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,wCAAwC,CAAC,CAAC;QAClH,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC;YACnB,MAAM,IAAI,UAAU,CAAC,yBAAyB,EAAC,8CAA8C,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF","sourcesContent":["import type { NativeSession } from '../adapters/types.js';\nimport { AgentError } from '../errors.js';\n\n/** Ensures startup cannot publish a session after its process owner disconnects. */\nexport class NativeOwner {\n  private opening?: Promise<NativeSession>;\n  private closing?: Promise<void>;\n\n  async open(factory: () => Promise<NativeSession>) {\n    if (this.closing || this.opening) throw new AgentError('HARNESS_FAILED','Native session startup is unavailable.');\n    this.opening = factory();\n    const native = await this.opening;\n    if (this.closing) {\n      await this.closing;\n      throw new AgentError('COORDINATOR_UNAVAILABLE','The coordinator disconnected during startup.');\n    }\n    return native;\n  }\n\n  close(): Promise<void> {\n    this.closing ??= (async () => {\n      const native = await this.opening?.catch(() => undefined);\n      await native?.close();\n    })();\n    return this.closing;\n  }\n}\n"]}
+{"version":3,"file":"native-owner.js","sourceRoot":"","sources":["../../src/runtime/native-owner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,oFAAoF;AACpF,MAAM,OAAO,WAAW;IACd,OAAO,CAA0B;IACjC,OAAO,CAAiB;IAEhC,KAAK,CAAC,IAAI,CAAC,OAAqC;QAC9C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,wCAAwC,CAAC,CAAC;QAClH,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC;YACnB,MAAM,IAAI,UAAU,CAAC,yBAAyB,EAAC,8CAA8C,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACnC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF","sourcesContent":["import type { NativeSession } from '../adapters/types.js';\nimport { AgentError } from '../errors.js';\n\n/** Ensures startup cannot publish a session after its process owner disconnects. */\nexport class NativeOwner {\n  private opening?: Promise<NativeSession>;\n  private closing?: Promise<void>;\n\n  async open(factory: () => Promise<NativeSession>) {\n    if (this.closing || this.opening) throw new AgentError('HARNESS_FAILED','Native session startup is unavailable.');\n    this.opening = factory();\n    const native = await this.opening;\n    if (this.closing) {\n      await this.closing;\n      throw new AgentError('COORDINATOR_UNAVAILABLE','The coordinator disconnected during startup.');\n    }\n    return native;\n  }\n\n  close(): Promise<void> {\n    if (this.closing) return this.closing;\n    const attempt = (async () => {\n      const native = await this.opening?.catch(() => undefined);\n      await native?.close();\n    })();\n    this.closing = attempt.catch(error => {\n      this.closing = undefined;\n      throw error;\n    });\n    return this.closing;\n  }\n}\n"]}

package/dist/runtime/pagination.d.ts

@@ -0,0 +1,9 @@
+import type { PageOptions } from './snapshots.js';
+export declare function paginate<T>(values: T[], options: PageOptions | undefined, binding: {
+    instance: string;
+    collection: string;
+    filter: string;
+}, membership: (value: T) => number): {
+    items: T[];
+    nextCursor?: string;
+};

package/dist/runtime/pagination.js

@@ -0,0 +1,36 @@
+import { AgentError } from '../errors.js';
+export function paginate(values, options, binding, membership) {
+    const limit = options?.limit ?? 100;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 1_000)
+        throw new AgentError('INVALID_ARGUMENT', 'Page limit must be an integer from 1 through 1000.');
+    const current = values.reduce((max, value) => Math.max(max, membership(value)), 0);
+    let watermark = current, after = 0;
+    if (options?.cursor !== undefined) {
+        if (typeof options.cursor !== 'string' || !options.cursor)
+            invalid();
+        let cursor;
+        try {
+            cursor = JSON.parse(Buffer.from(options.cursor, 'base64url').toString('utf8'));
+        }
+        catch {
+            invalid();
+        }
+        if (!cursor || typeof cursor !== 'object' || Array.isArray(cursor)
+            || Object.keys(cursor).sort().join(',') !== 'after,collection,filter,instance,v,watermark'
+            || cursor.v !== 1 || cursor.instance !== binding.instance || cursor.collection !== binding.collection
+            || cursor.filter !== binding.filter || !Number.isSafeInteger(cursor.watermark) || cursor.watermark < 0
+            || cursor.watermark > current || !Number.isSafeInteger(cursor.after) || cursor.after < 0
+            || cursor.after > cursor.watermark)
+            invalid();
+        watermark = cursor.watermark;
+        after = cursor.after;
+    }
+    const eligible = values.filter(value => membership(value) <= watermark && membership(value) > after);
+    const items = eligible.slice(0, limit);
+    if (eligible.length <= items.length)
+        return { items };
+    const cursor = { v: 1, ...binding, watermark, after: membership(items.at(-1)) };
+    return { items, nextCursor: Buffer.from(JSON.stringify(cursor)).toString('base64url') };
+}
+function invalid() { throw new AgentError('INVALID_CURSOR', 'The page cursor is invalid for this collection.'); }
+//# sourceMappingURL=pagination.js.map

package/dist/runtime/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/runtime/pagination.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport type { PageOptions } from './snapshots.js';\n\nexport function paginate<T>(values:T[], options:PageOptions|undefined, binding:{instance:string;collection:string;filter:string},\n  membership:(value:T)=>number): {items:T[];nextCursor?:string} {\n  const limit=options?.limit ?? 100;\n  if (!Number.isInteger(limit) || limit < 1 || limit > 1_000)\n    throw new AgentError('INVALID_ARGUMENT','Page limit must be an integer from 1 through 1000.');\n  const current=values.reduce((max,value)=>Math.max(max,membership(value)),0);\n  let watermark=current, after=0;\n  if (options?.cursor !== undefined) {\n    if (typeof options.cursor !== 'string' || !options.cursor) invalid();\n    let cursor: any;\n    try { cursor=JSON.parse(Buffer.from(options.cursor,'base64url').toString('utf8')); } catch { invalid(); }\n    if (!cursor || typeof cursor !== 'object' || Array.isArray(cursor)\n      || Object.keys(cursor).sort().join(',') !== 'after,collection,filter,instance,v,watermark'\n      || cursor.v !== 1 || cursor.instance !== binding.instance || cursor.collection !== binding.collection\n      || cursor.filter !== binding.filter || !Number.isSafeInteger(cursor.watermark) || cursor.watermark < 0\n      || cursor.watermark > current || !Number.isSafeInteger(cursor.after) || cursor.after < 0\n      || cursor.after > cursor.watermark) invalid();\n    watermark=cursor.watermark; after=cursor.after;\n  }\n  const eligible=values.filter(value=>membership(value)<=watermark && membership(value)>after);\n  const items=eligible.slice(0,limit);\n  if (eligible.length <= items.length) return {items};\n  const cursor={v:1,...binding,watermark,after:membership(items.at(-1)!)};\n  return {items,nextCursor:Buffer.from(JSON.stringify(cursor)).toString('base64url')};\n}\n\nfunction invalid():never { throw new AgentError('INVALID_CURSOR','The page cursor is invalid for this collection.'); }\n"]}

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,33 +1,48 @@
-import { openCodex } from '../adapters/codex.js';
-import { openClaude } from '../adapters/claude.js';
-import { openFx } from '../adapters/fx.js';
 import { resolveAccess } from '../config/access.js';
+import { accessAttemptContext } from '../config/access-provenance.js';
 import { AgentError } from '../errors.js';
-const openers = { codex: openCodex, claudeCode: openClaude, fx: openFx };
-export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }, onApproval) {
+import { withAccessContext, withSessionAccessContext } from './access-errors.js';
+const openers = {
+    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, diagnosticContext = { origin: 'cli' }) {
     const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];
     const unavailable = [];
     for (const harness of alternatives) {
         const configuredConnections = settings.access?.[harness.kind];
+        const explicitAccessRequired = ['fx', 'opencode', 'copilot', 'cursor'].includes(harness.kind);
         const connections = configuredConnections ??
-            (harness.kind === 'fx' ? [] : [{ type: 'subscription' }]);
+            (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 (harness.kind === 'fx' && !connections.length) {
-            unavailable.push('fx: Enable an explicit AI Gateway connection in personal access settings.');
+        else if (!connections.length && explicitAccessRequired) {
+            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 connection of connections) {
+        for (const [index, connection] of connections.entries()) {
+            const context = accessAttemptContext(settings, harness.kind, connection, index, connections.length);
             try {
                 const access = await resolveAccess(connection, harness.kind, cwd, env);
                 const native = await open({ agent, harness, cwd, env, access, ...(onApproval ? { onApproval } : {}) });
                 selected(harness.kind);
-                return native;
+                return withSessionAccessContext(native, context);
             }
             catch (error) {
-                if (!(error instanceof AgentError) || !['HARNESS_UNAVAILABLE', 'ACCESS_UNAVAILABLE'].includes(error.code))
+                if (!(error instanceof AgentError))
                     throw error;
-                unavailable.push(`${harness.kind}: ${error.message}`);
+                if (!['HARNESS_UNAVAILABLE', 'ACCESS_UNAVAILABLE'].includes(error.code))
+                    throw withAccessContext(error, context);
+                unavailable.push(`${harness.kind}: ${withAccessContext(error, context).message}`);
             }
         }
     }

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 { resolveAccess, type AccessConfig } from '../config/access.js';\nimport { AgentError } from '../errors.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\n\nconst openers = {codex:openCodex,claudeCode:openClaude,fx:openFx};\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 connections = configuredConnections ??\n      (harness.kind === 'fx' ? [] : [{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 (harness.kind === 'fx' && !connections.length) {\n      unavailable.push('fx: Enable an explicit AI Gateway connection in personal access settings.');\n    }\n    for (const connection of connections) {\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 native;\n      } catch (error) {\n        if (!(error instanceof AgentError) || !['HARNESS_UNAVAILABLE','ACCESS_UNAVAILABLE'].includes(error.code)) throw error;\n        unavailable.push(`${harness.kind}: ${error.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":"AAEA,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,OAAO,GAAG;IACd,KAAK,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;IACnG,UAAU,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1G,EAAE,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAC1F,QAAQ,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC;IAC5G,OAAO,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;IACzG,MAAM,EAAE,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;CACpB,CAAC;AAMrF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAA0B,EAAE,GAAW,EAAE,GAAsB,EAAE,QAAsB,EACvF,IAAI,GAAG,CAAC,OAAuB,EAA0B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAClG,QAAQ,GAAgC,GAAG,EAAE,GAAE,CAAC,EAChD,UAA4B,EAC5B,iBAAiB,GAAqC,EAAC,MAAM,EAAE,KAAK,EAAC;IAErE,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpF,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC;QAC7E,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAC,UAAU,EAAC,SAAS,EAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,WAAW,GAAG,qBAAqB;YACvC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,cAAuB,EAAC,CAAC,CAAC,CAAC;QACnE,IAAI,qBAAqB,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,KAAK,KAAK;gBACjD,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,4EAA4E;gBAC7F,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,4EAA4E,CAAC,CAAC;QACnG,CAAC;aAAM,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,0BAA0B,CAAC;YACzG,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gCAAgC;gBAC3E,CAAC,CAAC,mCAAmC,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,wBAAwB,QAAQ,kBAAkB,OAAO,GAAG,CAAC,CAAC;QAChG,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YACpG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAC,KAAK,EAAC,OAAO,EAAC,GAAG,EAAC,GAAG,EAAC,MAAM,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAC,UAAU,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC;gBAC9F,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;oBAAE,MAAM,KAAK,CAAC;gBAChD,IAAI,CAAC,CAAC,qBAAqB,EAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAChH,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC;AACtI,CAAC","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>;
 }>;