subharness 0.0.4 → 0.0.7

package/dist/runtime/state.js

@@ -1,30 +1,99 @@
 import { homedir } from 'node:os';
-import { join, dirname } from 'node:path';
+import { isAbsolute, join, normalize } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
 import { mkdir, readFile, chmod } from 'node:fs/promises';
+import { AgentError } from '../errors.js';
+export function resolveStateDirectory(explicit, env = process.env) {
+    const selected = explicit ?? env.AGENT_STATE_DIR ?? join(homedir(), '.subharness', 'state', 'shared');
+    if (!selected || !isAbsolute(selected)) {
+        throw new AgentError('INVALID_CONFIG', 'Coordinator state directory must be a nonempty absolute local path.');
+    }
+    return normalize(selected);
+}
 export function stateDirectory() {
-    const installation = createHash('sha256').update(dirname(import.meta.url)).digest('hex').slice(0, 12);
-    return process.env.AGENT_STATE_DIR ?? join(homedir(), '.subharness', 'state', installation);
+    return resolveStateDirectory();
 }
 export async function privateDirectory(directory) {
     await mkdir(directory, { recursive: true, mode: 0o700 });
     await chmod(directory, 0o700);
 }
-export async function readEndpoint(directory) {
+export async function probeEndpoint(directory, options = {}) {
+    let source;
+    try {
+        source = await readFile(join(directory, 'coordinator.json'), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { kind: 'absent' };
+        return { kind: 'malformed' };
+    }
+    let candidate;
     try {
-        const endpoint = JSON.parse(await readFile(join(directory, 'coordinator.json'), 'utf8'));
-        if (!/^http:\/\/127\.0\.0\.1:\d+\/$/.test(endpoint.url) || typeof endpoint.token !== 'string'
-            || typeof endpoint.instanceId !== 'string' || endpoint.instanceId.length === 0)
-            return;
-        const response = await fetch(endpoint.url + 'health', { headers: { authorization: `Bearer ${endpoint.token}` }, signal: AbortSignal.timeout(500) });
-        if (!response.ok)
-            return;
-        const health = await response.json();
-        if (health.version === 1 && health.type === 'coordinator-health' && health.instanceId === endpoint.instanceId)
-            return endpoint;
-    }
-    catch { /* An unavailable endpoint never establishes an active coordinator. */ }
+        candidate = JSON.parse(source);
+    }
+    catch {
+        return { kind: 'malformed' };
+    }
+    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate))
+        return { kind: 'malformed' };
+    const endpoint = candidate;
+    if (!/^http:\/\/127\.0\.0\.1:\d+\/$/.test(String(endpoint.url))
+        || typeof endpoint.token !== 'string' || !endpoint.token
+        || !Number.isSafeInteger(endpoint.pid) || endpoint.pid <= 0
+        || typeof endpoint.instanceId !== 'string' || !endpoint.instanceId)
+        return { kind: 'malformed' };
+    const parsed = endpoint;
+    let response;
+    try {
+        const timeout = AbortSignal.timeout(Math.max(1, options.timeoutMs ?? 500));
+        response = await fetch(parsed.url + 'health', {
+            headers: { authorization: `Bearer ${parsed.token}` },
+            signal: options.signal ? AbortSignal.any([options.signal, timeout]) : timeout,
+        });
+    }
+    catch {
+        return { kind: 'unresponsive', endpoint: parsed, owner: (options.checkPid ?? processOwnerState)(parsed.pid) };
+    }
+    if (response.status === 401 || response.status === 403) {
+        void response.body?.cancel().catch(() => { });
+        return { kind: 'authentication-failed', endpoint: parsed };
+    }
+    if (!response.ok) {
+        void response.body?.cancel().catch(() => { });
+        return { kind: 'incompatible', endpoint: parsed };
+    }
+    let health;
+    try {
+        health = await response.json();
+    }
+    catch {
+        return { kind: 'incompatible', endpoint: parsed };
+    }
+    if (!health || typeof health !== 'object' || Array.isArray(health))
+        return { kind: 'incompatible', endpoint: parsed };
+    const record = health;
+    if (record.instanceId !== parsed.instanceId)
+        return { kind: 'instance-mismatch', endpoint: parsed };
+    if (record.version !== 1 || record.type !== 'coordinator-health' || record.protocolVersion !== 1
+        || !Array.isArray(record.capabilities) || !record.capabilities.every(item => typeof item === 'string')
+        || (options.capability && !record.capabilities.includes(options.capability))) {
+        return { kind: 'incompatible', endpoint: parsed };
+    }
+    return { kind: 'reachable', endpoint: parsed };
+}
+export function processOwnerState(pid) {
+    try {
+        process.kill(pid, 0);
+        return 'alive';
+    }
+    catch (error) {
+        const code = error.code;
+        return code === 'ESRCH' ? 'dead' : 'unknown';
+    }
+}
+export async function readEndpoint(directory) {
+    const probe = await probeEndpoint(directory, { capability: 'cli-v1' });
+    return probe.kind === 'reachable' ? probe.endpoint : undefined;
 }
 export function localProgram(name) {
     const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';

package/dist/runtime/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/runtime/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,UAAU,cAAc;IAC5B,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtG,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAC,aAAa,EAAC,OAAO,EAAC,YAAY,CAAC,CAAC;AAC3F,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,MAAM,KAAK,CAAC,SAAS,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,SAAS,EAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAC,kBAAkB,CAAC,EAAC,MAAM,CAAC,CAAa,CAAC;QACnG,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;eACxF,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACzF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,QAAQ,EAAE,EAAC,OAAO,EAAC,EAAC,aAAa,EAAC,UAAU,QAAQ,CAAC,KAAK,EAAE,EAAC,EAAC,MAAM,EAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAC,CAAC,CAAC;QAC5I,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO;QACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0D,CAAC;QAC7F,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;YAAE,OAAO,QAAQ,CAAC;IACjI,CAAC;IAAC,MAAM,CAAC,CAAC,sEAAsE,CAAC,CAAC;AACpF,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,OAAO,EAAE,IAAI,EAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,SAAS,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,QAAQ,EAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACjF,CAAC","sourcesContent":["import { homedir } from 'node:os';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { createHash } from 'node:crypto';\nimport { mkdir, readFile, chmod } from 'node:fs/promises';\n\nexport interface Endpoint { url: string; token: string; pid: number; instanceId: string }\nexport function stateDirectory() {\n  const installation = createHash('sha256').update(dirname(import.meta.url)).digest('hex').slice(0, 12);\n  return process.env.AGENT_STATE_DIR ?? join(homedir(),'.subharness','state',installation);\n}\nexport async function privateDirectory(directory: string) {\n  await mkdir(directory,{recursive:true,mode:0o700});\n  await chmod(directory,0o700);\n}\nexport async function readEndpoint(directory: string): Promise<Endpoint | undefined> {\n  try {\n    const endpoint = JSON.parse(await readFile(join(directory,'coordinator.json'),'utf8')) as Endpoint;\n    if (!/^http:\\/\\/127\\.0\\.0\\.1:\\d+\\/$/.test(endpoint.url) || typeof endpoint.token !== 'string'\n      || typeof endpoint.instanceId !== 'string' || endpoint.instanceId.length === 0) return;\n    const response = await fetch(endpoint.url + 'health', {headers:{authorization:`Bearer ${endpoint.token}`},signal:AbortSignal.timeout(500)});\n    if (!response.ok) return;\n    const health = await response.json() as {version?:unknown;type?:unknown;instanceId?:unknown};\n    if (health.version === 1 && health.type === 'coordinator-health' && health.instanceId === endpoint.instanceId) return endpoint;\n  } catch { /* An unavailable endpoint never establishes an active coordinator. */ }\n}\nexport function localProgram(name: string) {\n  const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';\n  return { file:fileURLToPath(new URL(`./${name}.${extension}`, import.meta.url)),\n    execArgv:extension === 'ts' ? ['--import',import.meta.resolve('tsx')] : [] };\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/runtime/state.ts"],"names":[],"mappings":"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","sourcesContent":["import { homedir } from 'node:os';\nimport { isAbsolute, join, normalize } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { mkdir, readFile, chmod } from 'node:fs/promises';\nimport { AgentError } from '../errors.js';\n\nexport interface Endpoint { url: string; token: string; pid: number; instanceId: string }\nexport type EndpointCapability = 'sdk-v1' | 'cli-v1';\nexport type OwnerState = 'alive' | 'dead' | 'unknown';\nexport type EndpointProbe =\n  | { readonly kind: 'absent' }\n  | { readonly kind: 'malformed' }\n  | { readonly kind: 'reachable'; readonly endpoint: Endpoint }\n  | { readonly kind: 'authentication-failed' | 'incompatible' | 'instance-mismatch'; readonly endpoint: Endpoint }\n  | { readonly kind: 'unresponsive'; readonly endpoint: Endpoint; readonly owner: OwnerState };\nexport interface EndpointProbeOptions {\n  readonly capability?: EndpointCapability;\n  readonly timeoutMs?: number;\n  readonly signal?: AbortSignal;\n  readonly checkPid?: (pid: number) => OwnerState;\n}\nexport function resolveStateDirectory(\n  explicit?: string,\n  env: Readonly<Record<string, string | undefined>> = process.env,\n): string {\n  const selected = explicit ?? env.AGENT_STATE_DIR ?? join(homedir(),'.subharness','state','shared');\n  if (!selected || !isAbsolute(selected)) {\n    throw new AgentError('INVALID_CONFIG','Coordinator state directory must be a nonempty absolute local path.');\n  }\n  return normalize(selected);\n}\nexport function stateDirectory() {\n  return resolveStateDirectory();\n}\nexport async function privateDirectory(directory: string) {\n  await mkdir(directory,{recursive:true,mode:0o700});\n  await chmod(directory,0o700);\n}\nexport async function probeEndpoint(directory: string, options: EndpointProbeOptions = {}): Promise<EndpointProbe> {\n  let source: string;\n  try { source = await readFile(join(directory,'coordinator.json'),'utf8'); }\n  catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return {kind:'absent'};\n    return {kind:'malformed'};\n  }\n  let candidate: unknown;\n  try { candidate = JSON.parse(source); }\n  catch { return {kind:'malformed'}; }\n  if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) return {kind:'malformed'};\n  const endpoint = candidate as Partial<Endpoint>;\n  if (!/^http:\\/\\/127\\.0\\.0\\.1:\\d+\\/$/.test(String(endpoint.url))\n    || typeof endpoint.token !== 'string' || !endpoint.token\n    || !Number.isSafeInteger(endpoint.pid) || endpoint.pid! <= 0\n    || typeof endpoint.instanceId !== 'string' || !endpoint.instanceId) return {kind:'malformed'};\n  const parsed = endpoint as Endpoint;\n  let response: Response;\n  try {\n    const timeout = AbortSignal.timeout(Math.max(1,options.timeoutMs ?? 500));\n    response = await fetch(parsed.url + 'health', {\n      headers:{authorization:`Bearer ${parsed.token}`},\n      signal:options.signal ? AbortSignal.any([options.signal,timeout]) : timeout,\n    });\n  } catch {\n    return {kind:'unresponsive',endpoint:parsed,owner:(options.checkPid ?? processOwnerState)(parsed.pid)};\n  }\n  if (response.status === 401 || response.status === 403) {\n    void response.body?.cancel().catch(()=>{});\n    return {kind:'authentication-failed',endpoint:parsed};\n  }\n  if (!response.ok) {\n    void response.body?.cancel().catch(()=>{});\n    return {kind:'incompatible',endpoint:parsed};\n  }\n  let health: unknown;\n  try { health = await response.json(); }\n  catch { return {kind:'incompatible',endpoint:parsed}; }\n  if (!health || typeof health !== 'object' || Array.isArray(health)) return {kind:'incompatible',endpoint:parsed};\n  const record = health as Record<string,unknown>;\n  if (record.instanceId !== parsed.instanceId) return {kind:'instance-mismatch',endpoint:parsed};\n  if (record.version !== 1 || record.type !== 'coordinator-health' || record.protocolVersion !== 1\n    || !Array.isArray(record.capabilities) || !record.capabilities.every(item => typeof item === 'string')\n    || (options.capability && !record.capabilities.includes(options.capability))) {\n    return {kind:'incompatible',endpoint:parsed};\n  }\n  return {kind:'reachable',endpoint:parsed};\n}\n\nexport function processOwnerState(pid: number): OwnerState {\n  try { process.kill(pid,0); return 'alive'; }\n  catch (error) {\n    const code = (error as NodeJS.ErrnoException).code;\n    return code === 'ESRCH' ? 'dead' : 'unknown';\n  }\n}\nexport async function readEndpoint(directory: string): Promise<Endpoint | undefined> {\n  const probe = await probeEndpoint(directory,{capability:'cli-v1'});\n  return probe.kind === 'reachable' ? probe.endpoint : undefined;\n}\nexport function localProgram(name: string) {\n  const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';\n  return { file:fileURLToPath(new URL(`./${name}.${extension}`, import.meta.url)),\n    execArgv:extension === 'ts' ? ['--import',import.meta.resolve('tsx')] : [] };\n}\n"]}

package/dist/runtime/task-data.d.ts

@@ -0,0 +1,38 @@
+import type { NativeApprovalRequest } from '../approvals/types.js';
+export type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
+export interface ApprovalRequest extends NativeApprovalRequest {
+    requestId: string;
+    taskId: string;
+    sessionId: string;
+}
+export type ApprovalScope = 'once' | 'turn' | 'session';
+export type ApprovalAction = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+} & ({
+    readonly decision: 'allow' | 'deny';
+    readonly scope: ApprovalScope;
+} | {
+    readonly decision: 'cancel';
+    readonly scope?: never;
+});
+export interface ApprovalGrant {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface SdkApprovalRequest {
+    readonly id: string;
+    readonly taskId: string;
+    readonly sessionId: string;
+    readonly harness: import('../sdk/types.js').HarnessKind;
+    readonly message: string;
+    readonly actions: readonly ApprovalAction[];
+    readonly grants?: readonly ApprovalGrant[];
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+export interface ApprovalResponse {
+    readonly actionId: string;
+    readonly grants?: readonly string[];
+}

package/dist/runtime/task-data.js

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

package/dist/runtime/task-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-data.js","sourceRoot":"","sources":["../../src/runtime/task-data.ts"],"names":[],"mappings":"","sourcesContent":["import type { NativeApprovalRequest } from '../approvals/types.js';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' |\n  'completed' | 'failed' | 'cancelled' | 'interrupted';\n\nexport interface ApprovalRequest extends NativeApprovalRequest {\n  requestId: string;\n  taskId: string;\n  sessionId: string;\n}\n\nexport type ApprovalScope = 'once' | 'turn' | 'session';\nexport type ApprovalAction = {\n  readonly id: string;\n  readonly label: string;\n  readonly description?: string;\n} & (\n  | { readonly decision: 'allow' | 'deny'; readonly scope: ApprovalScope }\n  | { readonly decision: 'cancel'; readonly scope?: never }\n);\nexport interface ApprovalGrant { readonly id: string; readonly label: string; readonly description?: string }\nexport interface SdkApprovalRequest {\n  readonly id: string;\n  readonly taskId: string;\n  readonly sessionId: string;\n  readonly harness: import('../sdk/types.js').HarnessKind;\n  readonly message: string;\n  readonly actions: readonly ApprovalAction[];\n  readonly grants?: readonly ApprovalGrant[];\n  readonly context?: Readonly<Record<string, unknown>>;\n}\nexport interface ApprovalResponse { readonly actionId: string; readonly grants?: readonly string[] }\n"]}

package/dist/runtime/transport.d.ts

@@ -0,0 +1,13 @@
+import type { Endpoint } from './state.js';
+export declare class CoordinatorTransport {
+    readonly endpoint: Endpoint;
+    private readonly closed;
+    constructor(endpoint: Endpoint);
+    disconnect(): void;
+    one<T>(body: unknown, signal?: AbortSignal): Promise<T>;
+    stream<T>(body: unknown, signal?: AbortSignal): AsyncIterable<T>;
+    records(body: unknown, signal?: AbortSignal, options?: {
+        allowFinalRecord?: boolean;
+    }): AsyncGenerator<unknown>;
+    private assertOpen;
+}

package/dist/runtime/transport.js

@@ -0,0 +1,166 @@
+import { AgentError } from '../errors.js';
+export class CoordinatorTransport {
+    endpoint;
+    closed = new AbortController();
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    disconnect() { this.closed.abort(); }
+    async one(body, signal) {
+        let value;
+        let count = 0;
+        for await (const record of this.records(body, signal)) {
+            throwRemote(record);
+            value = record;
+            count++;
+            if (count > 1)
+                throw unavailable('The coordinator returned too many records for one operation.');
+        }
+        if (count !== 1)
+            throw unavailable('The coordinator returned no record for the operation.');
+        return value;
+    }
+    stream(body, signal) {
+        const transport = this;
+        return { [Symbol.asyncIterator]() {
+                const lifetime = new AbortController();
+                const observerSignal = signal ? AbortSignal.any([signal, lifetime.signal]) : lifetime.signal;
+                const source = transport.records(body, observerSignal)[Symbol.asyncIterator]();
+                return {
+                    async next() {
+                        const result = await source.next();
+                        if (result.done)
+                            return { done: true, value: undefined };
+                        throwRemote(result.value);
+                        return { done: false, value: result.value };
+                    },
+                    async return() {
+                        lifetime.abort();
+                        try {
+                            await source.return?.(undefined);
+                        }
+                        catch { }
+                        return { done: true, value: undefined };
+                    },
+                    async throw(error) {
+                        lifetime.abort();
+                        if (source.throw)
+                            return source.throw(error);
+                        throw error;
+                    },
+                };
+            } };
+    }
+    async *records(body, signal, options = {}) {
+        this.assertOpen();
+        const operation = operationName(body);
+        const combined = signal
+            ? AbortSignal.any([this.closed.signal, signal])
+            : this.closed.signal;
+        let response;
+        try {
+            response = await fetch(this.endpoint.url, {
+                method: 'POST',
+                headers: { authorization: `Bearer ${this.endpoint.token}`, 'content-type': 'application/json',
+                    'x-subharness-instance': this.endpoint.instanceId },
+                body: JSON.stringify(body),
+                signal: combined,
+            });
+        }
+        catch {
+            if (signal?.aborted)
+                throw new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.');
+            throw unavailable('Connection to the local coordinator failed. The task was not automatically retried.');
+        }
+        if (!response.ok) {
+            void response.body?.cancel().catch(() => { });
+            if (response.status === 401)
+                throw new AgentError('COORDINATOR_AUTH_FAILED', 'The local coordinator rejected its private authentication token.');
+            throw unavailable(`The coordinator rejected ${operation ? `the ${operation} operation` : 'the request'} with HTTP status ${response.status}.`);
+        }
+        if (!response.body)
+            throw unavailable(`The coordinator returned a successful response with no body${operation ? ` for the ${operation} operation` : ''}.`);
+        let buffer = '';
+        const decoder = new TextDecoder();
+        const reader = response.body.getReader();
+        let complete = false;
+        try {
+            for (;;) {
+                const result = await reader.read();
+                if (result.done) {
+                    complete = true;
+                    break;
+                }
+                const chunk = result.value;
+                buffer += decoder.decode(chunk, { stream: true });
+                let newline;
+                while ((newline = buffer.indexOf('\n')) >= 0) {
+                    const line = buffer.slice(0, newline);
+                    buffer = buffer.slice(newline + 1);
+                    if (!line)
+                        continue;
+                    try {
+                        yield JSON.parse(line);
+                    }
+                    catch {
+                        throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+                    }
+                }
+            }
+            buffer += decoder.decode();
+            if (buffer.trim()) {
+                if (options.allowFinalRecord) {
+                    try {
+                        yield JSON.parse(buffer);
+                    }
+                    catch {
+                        throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+                    }
+                }
+                else
+                    throw unavailable(`The coordinator response ended with an incomplete final record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);
+            }
+        }
+        catch (error) {
+            if (error instanceof AgentError)
+                throw error;
+            if (signal?.aborted)
+                throw new AgentError('OBSERVATION_CLOSED', 'The observer disconnected.');
+            throw unavailable('The coordinator response stream was interrupted. The task was not automatically retried.');
+        }
+        finally {
+            if (!complete)
+                await reader.cancel().catch(() => { });
+            reader.releaseLock();
+        }
+    }
+    assertOpen() {
+        if (this.closed.signal.aborted)
+            throw unavailable('The coordinator client is disconnected.');
+    }
+}
+function throwRemote(value) {
+    if (!value || typeof value !== 'object' || value.type !== 'error')
+        return;
+    const record = value;
+    if (!record.error || typeof record.error.code !== 'string' || typeof record.error.message !== 'string')
+        throw unavailable('The coordinator returned a malformed error record.');
+    throw new AgentError(record.error.code, record.error.message);
+}
+function operationName(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return;
+    const command = body.command;
+    return typeof command === 'string' && operations.has(command) ? command : undefined;
+}
+const operations = new Set([
+    'dashboard', 'dashboard-session', 'dashboard-detail', 'parent', 'run', 'send', 'resume', 'wait', 'status', 'queue', 'cancel', 'respond',
+    'sdk-agent-list', 'sdk-agent-check',
+    'sdk-session-create', 'sdk-session-get', 'sdk-session-list', 'sdk-session-prompt', 'sdk-session-close',
+    'sdk-task-get', 'sdk-task-list', 'sdk-task-snapshot', 'sdk-task-inspect', 'sdk-task-result', 'sdk-task-watch',
+    'sdk-task-responses', 'sdk-task-cancel', 'sdk-approval-respond',
+]);
+function unavailable(message) {
+    return new AgentError('COORDINATOR_UNAVAILABLE', message);
+}
+//# sourceMappingURL=transport.js.map

package/dist/runtime/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/runtime/transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport type { Endpoint } from './state.js';\n\ninterface ErrorRecord {\n  readonly version: 1;\n  readonly type: 'error';\n  readonly error: {readonly code:string;readonly message:string};\n}\n\nexport class CoordinatorTransport {\n  private readonly closed = new AbortController();\n  constructor(readonly endpoint:Endpoint) {}\n\n  disconnect(): void { this.closed.abort(); }\n\n  async one<T>(body:unknown,signal?:AbortSignal):Promise<T> {\n    let value:T|undefined;\n    let count=0;\n    for await (const record of this.records(body,signal)) {\n      throwRemote(record);\n      value=record as T;\n      count++;\n      if (count > 1) throw unavailable('The coordinator returned too many records for one operation.');\n    }\n    if (count !== 1) throw unavailable('The coordinator returned no record for the operation.');\n    return value!;\n  }\n\n  stream<T>(body:unknown,signal?:AbortSignal):AsyncIterable<T> {\n    const transport=this;\n    return {[Symbol.asyncIterator]():AsyncIterator<T> {\n      const lifetime=new AbortController();\n      const observerSignal=signal ? AbortSignal.any([signal,lifetime.signal]) : lifetime.signal;\n      const source=transport.records(body,observerSignal)[Symbol.asyncIterator]();\n      return {\n        async next() {\n          const result=await source.next();\n          if(result.done)return {done:true,value:undefined};\n          throwRemote(result.value);\n          return {done:false,value:result.value as T};\n        },\n        async return() {\n          lifetime.abort();\n          try{await source.return?.(undefined);}catch{}\n          return {done:true,value:undefined};\n        },\n        async throw(error?:unknown) {\n          lifetime.abort();\n          if(source.throw)return source.throw(error) as Promise<IteratorResult<T>>;\n          throw error;\n        },\n      };\n    }};\n  }\n\n  async *records(body:unknown,signal?:AbortSignal,options:{allowFinalRecord?:boolean}={}):AsyncGenerator<unknown> {\n    this.assertOpen();\n    const operation=operationName(body);\n    const combined=signal\n      ? AbortSignal.any([this.closed.signal,signal])\n      : this.closed.signal;\n    let response:Response;\n    try {\n      response=await fetch(this.endpoint.url,{\n        method:'POST',\n        headers:{authorization:`Bearer ${this.endpoint.token}`,'content-type':'application/json',\n          'x-subharness-instance':this.endpoint.instanceId},\n        body:JSON.stringify(body),\n        signal:combined,\n      });\n    } catch {\n      if (signal?.aborted) throw new AgentError('OBSERVATION_CLOSED','The observer disconnected.');\n      throw unavailable('Connection to the local coordinator failed. The task was not automatically retried.');\n    }\n    if (!response.ok) {\n      void response.body?.cancel().catch(()=>{});\n      if (response.status === 401)\n        throw new AgentError('COORDINATOR_AUTH_FAILED','The local coordinator rejected its private authentication token.');\n      throw unavailable(`The coordinator rejected ${operation ? `the ${operation} operation` : 'the request'} with HTTP status ${response.status}.`);\n    }\n    if (!response.body) throw unavailable(\n      `The coordinator returned a successful response with no body${operation ? ` for the ${operation} operation` : ''}.`);\n    let buffer='';\n    const decoder=new TextDecoder();\n    const reader=response.body.getReader();\n    let complete=false;\n    try {\n      for (;;) {\n        const result=await reader.read();\n        if (result.done) { complete=true; break; }\n        const chunk=result.value;\n        buffer+=decoder.decode(chunk,{stream:true});\n        let newline:number;\n        while ((newline=buffer.indexOf('\\n')) >= 0) {\n          const line=buffer.slice(0,newline); buffer=buffer.slice(newline+1);\n          if (!line) continue;\n          try { yield JSON.parse(line) as unknown; }\n          catch { throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`); }\n        }\n      }\n      buffer+=decoder.decode();\n      if (buffer.trim()) {\n        if (options.allowFinalRecord) {\n          try { yield JSON.parse(buffer) as unknown; }\n          catch { throw unavailable(`The coordinator returned a malformed JSON record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`); }\n        } else throw unavailable(\n          `The coordinator response ended with an incomplete final record${operation ? ` for the ${operation} operation` : ''}. The task was not automatically retried.`);\n      }\n    } catch (error) {\n      if (error instanceof AgentError) throw error;\n      if (signal?.aborted) throw new AgentError('OBSERVATION_CLOSED','The observer disconnected.');\n      throw unavailable('The coordinator response stream was interrupted. The task was not automatically retried.');\n    } finally {\n      if (!complete) await reader.cancel().catch(()=>{});\n      reader.releaseLock();\n    }\n  }\n\n  private assertOpen():void {\n    if (this.closed.signal.aborted) throw unavailable('The coordinator client is disconnected.');\n  }\n}\n\nfunction throwRemote(value:unknown):void {\n  if (!value || typeof value !== 'object' || (value as {type?:unknown}).type !== 'error') return;\n  const record=value as Partial<ErrorRecord>;\n  if (!record.error || typeof record.error.code !== 'string' || typeof record.error.message !== 'string')\n    throw unavailable('The coordinator returned a malformed error record.');\n  throw new AgentError(record.error.code,record.error.message);\n}\n\nfunction operationName(body:unknown):string|undefined {\n  if (!body || typeof body !== 'object' || Array.isArray(body)) return;\n  const command=(body as {command?:unknown}).command;\n  return typeof command === 'string' && operations.has(command) ? command : undefined;\n}\n\nconst operations=new Set([\n  'dashboard','dashboard-session','dashboard-detail','parent','run','send','resume','wait','status','queue','cancel','respond',\n  'sdk-agent-list','sdk-agent-check',\n  'sdk-session-create','sdk-session-get','sdk-session-list','sdk-session-prompt','sdk-session-close',\n  'sdk-task-get','sdk-task-list','sdk-task-snapshot','sdk-task-inspect','sdk-task-result','sdk-task-watch',\n  'sdk-task-responses','sdk-task-cancel','sdk-approval-respond',\n]);\n\nfunction unavailable(message:string):AgentError {\n  return new AgentError('COORDINATOR_UNAVAILABLE',message);\n}\n"]}

package/dist/runtime/types.d.ts

@@ -2,8 +2,10 @@ import type { ErrorInfo } from '../errors.js';
 import type { HarnessRequest, NativeSession } from '../adapters/types.js';
 import type { HarnessKind } from '../sdk/types.js';
 import type { DashboardHarness, DashboardWorkspace } from './dashboard.js';
-import type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';
-export type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
+import type { ApprovalHandler } from '../approvals/types.js';
+import type { AgentDefinition } from '../sdk/types.js';
+import type { ApprovalRequest, TaskState } from './task-data.js';
+export type { ApprovalRequest, TaskState } from './task-data.js';
 export type Delivery = 'queue' | 'steer' | 'interrupt';
 export interface AgentReference {
     file: string;
@@ -13,7 +15,11 @@ export interface HarnessReference {
     kind: 'harness';
     harness: HarnessRequest;
 }
-export type ExecutionReference = AgentReference | HarnessReference;
+export interface InlineReference {
+    kind: 'inline';
+    definition: AgentDefinition;
+}
+export type ExecutionReference = AgentReference | HarnessReference | InlineReference;
 export interface SessionInput {
     reference: ExecutionReference;
     cwd: string;
@@ -21,6 +27,7 @@ export interface SessionInput {
     prompt: string;
     parentToken?: string;
 }
+export type SessionCreateInput = Omit<SessionInput, 'prompt' | 'parentToken'>;
 export interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> {
     token: string;
     sessionId: string;
@@ -30,6 +37,10 @@ export type ManagedNativeSession = NativeSession & {
     selectedHarness?: HarnessKind;
 };
 export type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;
+export interface PreparedExecution {
+    open(input: DriverInput): Promise<ManagedNativeSession>;
+    close(): Promise<void>;
+}
 export interface RecordBase {
     version: 1;
     type: string;
@@ -37,17 +48,13 @@ export interface RecordBase {
     taskId: string;
     state?: TaskState;
 }
-export interface ApprovalRequest extends NativeApprovalRequest {
-    requestId: string;
-    taskId: string;
-    sessionId: string;
-}
 export interface Observation extends RecordBase {
     state: TaskState;
     responseId?: string;
     text?: string;
     error?: ErrorInfo;
     requests?: ApprovalRequest[];
+    stopUnconfirmed?: boolean;
 }
 export interface Receipt extends RecordBase {
     delivery?: Delivery;
@@ -85,19 +92,31 @@ export interface Task {
     failedAt?: number;
     finishedAt?: number;
     updatedAt: number;
+    revision: number;
+    ordinal: number;
+    membership: number;
     changed: Set<() => void>;
+    watchers: Set<() => void>;
 }
 export interface Session {
     id: string;
     token: string;
-    input: SessionInput;
+    input: SessionCreateInput;
     driver?: Promise<ManagedNativeSession>;
+    prepared?: PreparedExecution;
+    preparedClosed?: boolean;
     tasks: string[];
     active?: string;
     paused: boolean;
     commands: Promise<unknown>;
     controls: number;
+    nextOrdinal: number;
+    membership: number;
     harness: DashboardHarness;
+    selectedHarness?: HarnessKind;
     workspace: Promise<DashboardWorkspace>;
+    state: 'open' | 'closing' | 'closed';
+    closePromise?: Promise<void>;
+    driverClosed?: boolean;
 }
 export declare const terminal: (state: TaskState) => boolean;

package/dist/runtime/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import type { ErrorInfo } from '../errors.js';\nimport type { HarnessRequest, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { DashboardHarness, DashboardWorkspace } from './dashboard.js';\nimport type { ApprovalHandler, NativeApprovalRequest } from '../approvals/types.js';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'interrupted';\nexport type Delivery = 'queue' | 'steer' | 'interrupt';\nexport interface AgentReference { file: string; subagents: string[] }\nexport interface HarnessReference { kind: 'harness'; harness: HarnessRequest }\nexport type ExecutionReference = AgentReference | HarnessReference;\nexport interface SessionInput { reference: ExecutionReference; cwd: string; env: NodeJS.ProcessEnv; prompt: string; parentToken?: string }\nexport interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> { token: string; sessionId: string; onApproval?: ApprovalHandler }\nexport type ManagedNativeSession = NativeSession & { selectedHarness?: HarnessKind };\nexport type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface ApprovalRequest extends NativeApprovalRequest { requestId: string; taskId: string; sessionId: string }\nexport interface Observation extends RecordBase { state: TaskState; responseId?: string; text?: string; error?: ErrorInfo; requests?: ApprovalRequest[] }\nexport interface Receipt extends RecordBase {\n  delivery?: Delivery; requestedDelivery?: Delivery; resumed?: boolean;\n  paused?: true; blockedByTaskId?: string;\n}\nexport interface Response extends Observation { type: 'response'; responseId: string; text: string }\nexport interface ChildResult { taskId: string; state: TaskState; text: string }\nexport interface Task {\n  id: string; sessionId: string; prompt: string; title: string; parentId?: string; state: TaskState;\n  responses: Response[]; children: Set<string>; inbox: ChildResult[]; nativeActive: boolean;\n  stopping: boolean; stopPromise?: Promise<void>; stopUnconfirmed?: boolean; error?: ErrorInfo;\n  dispatchedAt?: number; failedAt?: number; finishedAt?: number; updatedAt: number; changed: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionInput; driver?: Promise<ManagedNativeSession>;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\n  harness: DashboardHarness; workspace: Promise<DashboardWorkspace>;\n}\nexport const terminal = (state: TaskState) => ['completed', 'failed', 'cancelled', 'interrupted'].includes(state);\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import type { ErrorInfo } from '../errors.js';\nimport type { HarnessRequest, NativeSession } from '../adapters/types.js';\nimport type { HarnessKind } from '../sdk/types.js';\nimport type { DashboardHarness, DashboardWorkspace } from './dashboard.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\nimport type { AgentDefinition } from '../sdk/types.js';\nimport type { ApprovalRequest, TaskState } from './task-data.js';\n\nexport type { ApprovalRequest, TaskState } from './task-data.js';\n\nexport type Delivery = 'queue' | 'steer' | 'interrupt';\nexport interface AgentReference { file: string; subagents: string[] }\nexport interface HarnessReference { kind: 'harness'; harness: HarnessRequest }\nexport interface InlineReference { kind: 'inline'; definition: AgentDefinition }\nexport type ExecutionReference = AgentReference | HarnessReference | InlineReference;\nexport interface SessionInput { reference: ExecutionReference; cwd: string; env: NodeJS.ProcessEnv; prompt: string; parentToken?: string }\nexport type SessionCreateInput = Omit<SessionInput, 'prompt' | 'parentToken'>;\nexport interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'> { token: string; sessionId: string; onApproval?: ApprovalHandler }\nexport type ManagedNativeSession = NativeSession & { selectedHarness?: HarnessKind };\nexport type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;\nexport interface PreparedExecution {\n  open(input: DriverInput): Promise<ManagedNativeSession>;\n  close(): Promise<void>;\n}\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface Observation extends RecordBase {\n  state: TaskState; responseId?: string; text?: string; error?: ErrorInfo; requests?: ApprovalRequest[];\n  stopUnconfirmed?: boolean;\n}\nexport interface Receipt extends RecordBase {\n  delivery?: Delivery; requestedDelivery?: Delivery; resumed?: boolean;\n  paused?: true; blockedByTaskId?: string;\n}\nexport interface Response extends Observation { type: 'response'; responseId: string; text: string }\nexport interface ChildResult { taskId: string; state: TaskState; text: string }\nexport interface Task {\n  id: string; sessionId: string; prompt: string; title: string; parentId?: string; state: TaskState;\n  responses: Response[]; children: Set<string>; inbox: ChildResult[]; nativeActive: boolean;\n  stopping: boolean; stopPromise?: Promise<void>; stopUnconfirmed?: boolean; error?: ErrorInfo;\n  dispatchedAt?: number; failedAt?: number; finishedAt?: number; updatedAt: number; revision: number;\n  ordinal: number; membership: number;\n  changed: Set<() => void>; watchers: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionCreateInput; driver?: Promise<ManagedNativeSession>;\n  prepared?: PreparedExecution; preparedClosed?: boolean;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\n  nextOrdinal: number; membership: number;\n  harness: DashboardHarness; selectedHarness?: HarnessKind; workspace: Promise<DashboardWorkspace>;\n  state: 'open' | 'closing' | 'closed'; closePromise?: Promise<void>; driverClosed?: boolean;\n}\nexport const terminal = (state: TaskState) => ['completed', 'failed', 'cancelled', 'interrupted'].includes(state);\n"]}