subharness 0.0.1 → 0.0.3

package/dist/runtime/readiness.js

@@ -0,0 +1,17 @@
+import { randomUUID } from 'node:crypto';
+import { createWorker } from './worker-client.js';
+import { stateDirectory } from './state.js';
+export async function closeStartupSession(open) {
+    const native = await open();
+    await native.close();
+}
+export async function checkReadiness(reference, cwd, env) {
+    await closeStartupSession(() => createWorker({
+        reference,
+        cwd,
+        env: { ...env, AGENT_STATE_DIR: stateDirectory() },
+        token: randomUUID(),
+        sessionId: `check_${randomUUID()}`,
+    }));
+}
+//# sourceMappingURL=readiness.js.map

package/dist/runtime/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/runtime/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAkC;IAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAA6B,EAAE,GAAW,EAAE,GAAsB;IACrG,MAAM,mBAAmB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC;QAC3C,SAAS;QACT,GAAG;QACH,GAAG,EAAE,EAAC,GAAG,GAAG,EAAE,eAAe,EAAE,cAAc,EAAE,EAAC;QAChD,KAAK,EAAE,UAAU,EAAE;QACnB,SAAS,EAAE,SAAS,UAAU,EAAE,EAAE;KACnC,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { ExecutionReference } from './types.js';\nimport { createWorker } from './worker-client.js';\nimport { stateDirectory } from './state.js';\nimport type { NativeSession } from '../adapters/types.js';\n\nexport async function closeStartupSession(open: () => Promise<NativeSession>): Promise<void> {\n  const native = await open();\n  await native.close();\n}\n\nexport async function checkReadiness(reference: ExecutionReference, cwd: string, env: NodeJS.ProcessEnv): Promise<void> {\n  await closeStartupSession(() => createWorker({\n    reference,\n    cwd,\n    env: {...env, AGENT_STATE_DIR: stateDirectory()},\n    token: randomUUID(),\n    sessionId: `check_${randomUUID()}`,\n  }));\n}\n"]}

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

@@ -1,3 +1,4 @@
+import type { HarnessKind } from '../sdk/types.js';
 import type { AdapterOptions, ExecutionDefinition, NativeSession } from '../adapters/types.js';
 import { type AccessConfig } from '../config/access.js';
-export declare function selectNative(agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig, open?: (options: AdapterOptions) => Promise<NativeSession>): Promise<NativeSession>;
+export declare function selectNative(agent: ExecutionDefinition, cwd: string, env: NodeJS.ProcessEnv, settings: AccessConfig, open?: (options: AdapterOptions) => Promise<NativeSession>, selected?: (kind: HarnessKind) => void): Promise<NativeSession>;

package/dist/runtime/select-native.js

@@ -4,7 +4,7 @@ import { openFx } from '../adapters/fx.js';
 import { resolveAccess } from '../config/access.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)) {
+export async function selectNative(agent, cwd, env, settings, open = (options) => openers[options.harness.kind](options), selected = () => { }) {
     const alternatives = Array.isArray(agent.harness) ? agent.harness : [agent.harness];
     const unavailable = [];
     for (const harness of alternatives) {
@@ -12,7 +12,7 @@ export async function selectNative(agent, cwd, env, settings, open = (options) =
         const connections = configuredConnections ??
             (harness.kind === 'fx' ? [] : [{ type: 'subscription' }]);
         if (configuredConnections?.length === 0) {
-            unavailable.push(`${harness.kind}: Access is disabled in the main checkout's .agents/agents.local.json.`);
+            unavailable.push(`${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.');
@@ -20,7 +20,9 @@ export async function selectNative(agent, cwd, env, settings, open = (options) =
         for (const connection of connections) {
             try {
                 const access = await resolveAccess(connection, harness.kind, cwd, env);
-                return await open({ agent, harness, cwd, env, access });
+                const native = await open({ agent, harness, cwd, env, access });
+                selected(harness.kind);
+                return native;
             }
             catch (error) {
                 if (!(error instanceof AgentError) || !['HARNESS_UNAVAILABLE', 'ACCESS_UNAVAILABLE'].includes(error.code))

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

@@ -1 +1 @@
-{"version":3,"file":"select-native.js","sourceRoot":"","sources":["../../src/runtime/select-native.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,EAAC,UAAU,EAAC,EAAE,EAAC,MAAM,EAAC,CAAC;AAElE,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;IAElG,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,WAAW,GAAG,qBAAqB;YACvC,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,cAAuB,EAAC,CAAC,CAAC,CAAC;QAClE,IAAI,qBAAqB,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,wEAAwE,CAAC,CAAC;QAC5G,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QAChG,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvE,OAAO,MAAM,IAAI,CAAC,EAAC,KAAK,EAAC,OAAO,EAAC,GAAG,EAAC,GAAG,EAAC,MAAM,EAAC,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,CAAC,CAAC,qBAAqB,EAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACtH,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,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 { 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';\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): 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 .agents/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        return await open({agent,harness,cwd,env,access});\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,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,EAAC,UAAU,EAAC,EAAE,EAAC,MAAM,EAAC,CAAC;AAElE,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;IAEhD,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,WAAW,GAAG,qBAAqB;YACvC,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,cAAuB,EAAC,CAAC,CAAC,CAAC;QAClE,IAAI,qBAAqB,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,4EAA4E,CAAC,CAAC;QAChH,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QAChG,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,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,CAAC,CAAC;gBAC1D,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,CAAC,CAAC,qBAAqB,EAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACtH,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,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 { 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';\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): 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});\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"]}

package/dist/runtime/service.d.ts

@@ -1,5 +1,5 @@
 import { Coordinator } from './coordinator.js';
-export declare function startService(engine: Coordinator, token: string): Promise<{
+export declare function startService(engine: Coordinator, token: string, instanceId: string): Promise<{
     url: string;
     close(): Promise<void>;
 }>;

package/dist/runtime/service.js

@@ -1,13 +1,14 @@
 import { createServer } from 'node:http';
 import { AgentError, errorInfo } from '../errors.js';
-export async function startService(engine, token) {
+export async function startService(engine, token, instanceId) {
     const server = createServer(async (request, response) => {
         if (request.headers.authorization !== `Bearer ${token}`) {
             response.writeHead(401).end();
             return;
         }
         if (request.method === 'GET' && request.url === '/health') {
-            response.end('ok');
+            response.setHeader('content-type', 'application/json');
+            response.end(JSON.stringify({ version: 1, type: 'coordinator-health', instanceId }));
             return;
         }
         if (request.method !== 'POST' || request.url !== '/') {
@@ -32,6 +33,9 @@ export async function startService(engine, token) {
             const data = JSON.parse(body);
             let receipt;
             switch (data.command) {
+                case 'dashboard':
+                    write(await engine.dashboard());
+                    break;
                 case 'parent':
                     write(engine.parentContext(data.parentToken));
                     break;
@@ -39,6 +43,8 @@ export async function startService(engine, token) {
                     receipt = engine.run(data.input);
                     break;
                 case 'send':
+                    if (data.detach && data.delivery === 'steer')
+                        throw new AgentError('INVALID_ARGUMENT', '--detach cannot be combined with --delivery steer.');
                     receipt = await engine.send(data.id, data.prompt, data.delivery ?? 'queue', data.parentToken);
                     break;
                 case 'resume': {
@@ -68,8 +74,9 @@ export async function startService(engine, token) {
             }
             if (receipt) {
                 write(receipt);
-                if (receipt.type === 'started')
+                if (receipt.type === 'started' && !data.detach) {
                     write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));
+                }
             }
         }
         catch (error) {

package/dist/runtime/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, Receipt, SessionInput } from './types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; parentToken?: string;\n}\n\nexport async function startService(engine: Coordinator, token: string) {\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') { response.end('ok'); return; }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      const data = JSON.parse(body) as Request;\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send': receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started') write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() { await engine.close(); server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())); },\n  };\n}\n"]}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/runtime/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer } from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { AgentError, errorInfo } from '../errors.js';\nimport { Coordinator } from './coordinator.js';\nimport type { Delivery, Receipt, SessionInput } from './types.js';\n\ninterface Request {\n  command: string; input?: SessionInput; id?: string; after?: string;\n  prompt?: string; delivery?: Delivery; full?: boolean; detach?: boolean; parentToken?: string;\n}\n\nexport async function startService(engine: Coordinator, token: string, instanceId: string) {\n  const server = createServer(async (request, response) => {\n    if (request.headers.authorization !== `Bearer ${token}`) { response.writeHead(401).end(); return; }\n    if (request.method === 'GET' && request.url === '/health') {\n      response.setHeader('content-type','application/json');\n      response.end(JSON.stringify({version:1,type:'coordinator-health',instanceId}));\n      return;\n    }\n    if (request.method !== 'POST' || request.url !== '/') { response.writeHead(404).end(); return; }\n    response.setHeader('content-type', 'application/x-ndjson');\n    const observer = new AbortController();\n    // Keep long, quiet observations alive without exposing progress records to callers.\n    const heartbeat = setInterval(() => { if (!response.destroyed) response.write('\\n'); }, 15_000);\n    response.once('close', () => { clearInterval(heartbeat); observer.abort(); });\n    const write = (record: unknown) => { if (!response.destroyed) response.write(JSON.stringify(record) + '\\n'); };\n    try {\n      let body = '';\n      for await (const chunk of request) {\n        body += chunk;\n        if (Buffer.byteLength(body) > 4 * 1024 * 1024) throw new AgentError('INVALID_ARGUMENT','Request exceeds 4 MiB.');\n      }\n      const data = JSON.parse(body) as Request;\n      let receipt: Receipt | undefined;\n      switch (data.command) {\n        case 'dashboard': write(await engine.dashboard()); break;\n        case 'parent': write(engine.parentContext(data.parentToken!)); break;\n        case 'run': receipt = engine.run(data.input!); break;\n        case 'send':\n          if (data.detach && data.delivery === 'steer') throw new AgentError('INVALID_ARGUMENT','--detach cannot be combined with --delivery steer.');\n          receipt = await engine.send(data.id!, data.prompt!, data.delivery ?? 'queue', data.parentToken); break;\n        case 'resume': {\n          const active = engine.queue(data.id!).active;\n          if (!active || active.state !== 'failed') throw new AgentError('NOT_FAILED','This session has no failed task to resume.');\n          const after = engine.status(active.taskId).response?.responseId;\n          receipt = await engine.resume(data.id!);\n          write(receipt); write(await engine.observe(receipt.taskId, after, data.parentToken, observer.signal));\n          receipt = undefined; break;\n        }\n        case 'wait': write(await engine.observe(data.id!, data.after, data.parentToken, observer.signal)); break;\n        case 'status': write(engine.status(data.id!, data.full)); break;\n        case 'queue': write(engine.queue(data.id!)); break;\n        case 'cancel': write(await engine.cancel(data.id!)); break;\n        default: throw new AgentError('INVALID_ARGUMENT','Unknown coordinator operation.');\n      }\n      if (receipt) {\n        write(receipt);\n        if (receipt.type === 'started' && !data.detach) {\n          write(await engine.observe(receipt.taskId, undefined, data.parentToken ?? data.input?.parentToken, observer.signal));\n        }\n      }\n    } catch (error) { write({version:1,type:'error',error:errorInfo(error)}); }\n    clearInterval(heartbeat);\n    response.end();\n  });\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', reject);\n    server.listen(0, '127.0.0.1', resolve);\n  });\n  return {\n    url: `http://127.0.0.1:${(server.address() as AddressInfo).port}/`,\n    async close() { await engine.close(); server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())); },\n  };\n}\n"]}

package/dist/runtime/startup-lock.d.ts

@@ -0,0 +1,5 @@
+export interface StartupOwnership {
+    isHeld(): boolean;
+    release(): void;
+}
+export declare function acquireStartupOwnership(directory: string, timeoutMs: number): StartupOwnership;

package/dist/runtime/startup-lock.js

@@ -0,0 +1,37 @@
+import { chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { AgentError } from '../errors.js';
+export function acquireStartupOwnership(directory, timeoutMs) {
+    const timeout = Number.isFinite(timeoutMs) ? Math.max(0, Math.ceil(timeoutMs)) : 0;
+    let database;
+    try {
+        const path = join(directory, 'startup.sqlite');
+        database = new DatabaseSync(path, { timeout });
+        chmodSync(path, 0o600);
+        database.exec('BEGIN IMMEDIATE');
+    }
+    catch {
+        try {
+            database?.close();
+        }
+        catch { /* Process exit also releases SQLite ownership. */ }
+        throw new AgentError('STARTUP_FAILED', 'Another command did not finish coordinator startup.');
+    }
+    let held = true;
+    return {
+        isHeld: () => held,
+        release() {
+            if (!held)
+                return;
+            held = false;
+            try {
+                database.exec('ROLLBACK');
+            }
+            finally {
+                database.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=startup-lock.js.map

package/dist/runtime/startup-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-lock.js","sourceRoot":"","sources":["../../src/runtime/startup-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,SAAiB;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,IAAI,QAAkC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAC,gBAAgB,CAAC,CAAC;QAC9C,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,EAAC,EAAC,OAAO,EAAC,CAAC,CAAC;QAC5C,SAAS,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QACvF,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,qDAAqD,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO;QACL,MAAM,EAAC,GAAG,EAAE,CAAC,IAAI;QACjB,OAAO;YACL,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,IAAI,GAAG,KAAK,CAAC;YACb,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;oBAC1B,CAAC;gBAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { chmodSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { DatabaseSync } from 'node:sqlite';\nimport { AgentError } from '../errors.js';\n\nexport interface StartupOwnership {\n  isHeld(): boolean;\n  release(): void;\n}\n\nexport function acquireStartupOwnership(directory: string, timeoutMs: number): StartupOwnership {\n  const timeout = Number.isFinite(timeoutMs) ? Math.max(0,Math.ceil(timeoutMs)) : 0;\n  let database: DatabaseSync | undefined;\n  try {\n    const path = join(directory,'startup.sqlite');\n    database = new DatabaseSync(path,{timeout});\n    chmodSync(path,0o600);\n    database.exec('BEGIN IMMEDIATE');\n  } catch {\n    try { database?.close(); } catch { /* Process exit also releases SQLite ownership. */ }\n    throw new AgentError('STARTUP_FAILED','Another command did not finish coordinator startup.');\n  }\n\n  let held = true;\n  return {\n    isHeld:() => held,\n    release() {\n      if (!held) return;\n      held = false;\n      try { database.exec('ROLLBACK'); }\n      finally { database.close(); }\n    },\n  };\n}\n"]}

package/dist/runtime/startup-protocol.d.ts

@@ -0,0 +1,17 @@
+import type { Endpoint } from './state.js';
+export declare const startupRetirementRequest: {
+    readonly version: 1;
+    readonly type: 'startup-retire';
+};
+export type StartupOutcome = {
+    version: 1;
+    type: 'startup-outcome';
+    state: 'retired';
+} | {
+    version: 1;
+    type: 'startup-outcome';
+    state: 'published';
+    endpoint: Endpoint;
+};
+export declare function isStartupRetirementRequest(message: unknown): boolean;
+export declare function startupOutcome(message: unknown): StartupOutcome | undefined;

package/dist/runtime/startup-protocol.js

@@ -0,0 +1,23 @@
+export const startupRetirementRequest = { version: 1, type: 'startup-retire' };
+export function isStartupRetirementRequest(message) {
+    return typeof message === 'object' && message !== null
+        && message.version === 1
+        && message.type === 'startup-retire';
+}
+export function startupOutcome(message) {
+    if (typeof message !== 'object' || message === null
+        || message.version !== 1
+        || message.type !== 'startup-outcome')
+        return;
+    const candidate = message;
+    if (candidate.state === 'retired')
+        return { version: 1, type: 'startup-outcome', state: 'retired' };
+    if (candidate.state !== 'published' || typeof candidate.endpoint !== 'object' || candidate.endpoint === null)
+        return;
+    const endpoint = candidate.endpoint;
+    if (typeof endpoint.url !== 'string' || typeof endpoint.token !== 'string'
+        || typeof endpoint.pid !== 'number' || typeof endpoint.instanceId !== 'string')
+        return;
+    return { version: 1, type: 'startup-outcome', state: 'published', endpoint: endpoint };
+}
+//# sourceMappingURL=startup-protocol.js.map

package/dist/runtime/startup-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-protocol.js","sourceRoot":"","sources":["../../src/runtime/startup-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,gBAAgB,EAAU,CAAC;AAMnF,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;WAChD,OAA8B,CAAC,OAAO,KAAK,CAAC;WAC5C,OAA2B,CAAC,IAAI,KAAK,gBAAgB,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;WAC7C,OAA8B,CAAC,OAAO,KAAK,CAAC;WAC5C,OAA2B,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO;IACrE,MAAM,SAAS,GAAG,OAAuE,CAAC;IAC1F,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,iBAAiB,EAAC,KAAK,EAAC,SAAS,EAAC,CAAC;IAC7F,IAAI,SAAS,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACrH,MAAM,QAAQ,GAAG,SAAS,CAAC,QAA6B,CAAC;IACzD,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;WACrE,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO;IACzF,OAAO,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,iBAAiB,EAAC,KAAK,EAAC,WAAW,EAAC,QAAQ,EAAC,QAAoB,EAAC,CAAC;AAC5F,CAAC","sourcesContent":["import type { Endpoint } from './state.js';\n\nexport const startupRetirementRequest = {version:1,type:'startup-retire'} as const;\n\nexport type StartupOutcome =\n  | {version:1;type:'startup-outcome';state:'retired'}\n  | {version:1;type:'startup-outcome';state:'published';endpoint:Endpoint};\n\nexport function isStartupRetirementRequest(message: unknown): boolean {\n  return typeof message === 'object' && message !== null\n    && (message as {version?:unknown}).version === 1\n    && (message as {type?:unknown}).type === 'startup-retire';\n}\n\nexport function startupOutcome(message: unknown): StartupOutcome | undefined {\n  if (typeof message !== 'object' || message === null\n    || (message as {version?:unknown}).version !== 1\n    || (message as {type?:unknown}).type !== 'startup-outcome') return;\n  const candidate = message as Partial<StartupOutcome> & {state?:unknown;endpoint?:unknown};\n  if (candidate.state === 'retired') return {version:1,type:'startup-outcome',state:'retired'};\n  if (candidate.state !== 'published' || typeof candidate.endpoint !== 'object' || candidate.endpoint === null) return;\n  const endpoint = candidate.endpoint as Partial<Endpoint>;\n  if (typeof endpoint.url !== 'string' || typeof endpoint.token !== 'string'\n    || typeof endpoint.pid !== 'number' || typeof endpoint.instanceId !== 'string') return;\n  return {version:1,type:'startup-outcome',state:'published',endpoint:endpoint as Endpoint};\n}\n"]}

package/dist/runtime/state.d.ts

@@ -2,6 +2,7 @@ export interface Endpoint {
     url: string;
     token: string;
     pid: number;
+    instanceId: string;
 }
 export declare function stateDirectory(): string;
 export declare function privateDirectory(directory: string): Promise<void>;
@@ -10,5 +11,3 @@ export declare function localProgram(name: string): {
     file: string;
     execArgv: string[];
 };
-/** An incomplete PID write gets a grace period; live or inaccessible owners are never reclaimed. */
-export declare function removeStaleStartupLock(path: string): Promise<boolean>;

package/dist/runtime/state.js

@@ -2,10 +2,10 @@ import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createHash } from 'node:crypto';
-import { mkdir, readFile, chmod, lstat, unlink } from 'node:fs/promises';
+import { mkdir, readFile, chmod } from 'node:fs/promises';
 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(), '.agents', 'state', installation);
+    return process.env.AGENT_STATE_DIR ?? join(homedir(), '.subharness', 'state', installation);
 }
 export async function privateDirectory(directory) {
     await mkdir(directory, { recursive: true, mode: 0o700 });
@@ -14,10 +14,14 @@ export async function privateDirectory(directory) {
 export async function readEndpoint(directory) {
     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')
+        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)
+        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. */ }
@@ -27,43 +31,4 @@ export function localProgram(name) {
     return { file: fileURLToPath(new URL(`./${name}.${extension}`, import.meta.url)),
         execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [] };
 }
-/** An incomplete PID write gets a grace period; live or inaccessible owners are never reclaimed. */
-export async function removeStaleStartupLock(path) {
-    try {
-        const before = await lstat(path);
-        if (!before.isFile() || Date.now() - before.mtimeMs < 5_000)
-            return false;
-        const contents = await readFile(path, "utf8");
-        const owner = lockOwner(contents);
-        if (owner !== undefined && !processAbsent(owner))
-            return false;
-        const current = await lstat(path);
-        if (before.dev !== current.dev || before.ino !== current.ino || before.size !== current.size
-            || before.mtimeMs !== current.mtimeMs || before.ctimeMs !== current.ctimeMs)
-            return false;
-        if (await readFile(path, "utf8") !== contents)
-            return false;
-        if (owner !== undefined && !processAbsent(owner))
-            return false;
-        await unlink(path);
-        return true;
-    }
-    catch {
-        return false;
-    } // Startup contenders can replace or remove the file while it is inspected.
-}
-function lockOwner(contents) {
-    const text = contents.trim();
-    const pid = Number(text);
-    return /^[1-9][0-9]*$/.test(text) && Number.isSafeInteger(pid) && pid <= 2_147_483_647 ? pid : undefined;
-}
-function processAbsent(pid) {
-    try {
-        process.kill(pid, 0);
-        return false;
-    }
-    catch (error) {
-        return error.code === "ESRCH";
-    }
-}
 //# sourceMappingURL=state.js.map

package/dist/runtime/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/runtime/state.ts"],"names":[],"mappings":"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","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, lstat, unlink } from 'node:fs/promises';\n\nexport interface Endpoint { url: string; token: string; pid: number }\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(),'.agents','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') return;\n    const response = await fetch(endpoint.url + 'health', {headers:{authorization:`Bearer ${endpoint.token}`},signal:AbortSignal.timeout(500)});\n    if (response.ok) 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\n\n/** An incomplete PID write gets a grace period; live or inaccessible owners are never reclaimed. */\nexport async function removeStaleStartupLock(path: string): Promise<boolean> {\n  try {\n    const before = await lstat(path);\n    if (!before.isFile() || Date.now() - before.mtimeMs < 5_000) return false;\n    const contents = await readFile(path, \"utf8\");\n    const owner = lockOwner(contents);\n    if (owner !== undefined && !processAbsent(owner)) return false;\n    const current = await lstat(path);\n    if (before.dev !== current.dev || before.ino !== current.ino || before.size !== current.size\n      || before.mtimeMs !== current.mtimeMs || before.ctimeMs !== current.ctimeMs) return false;\n    if (await readFile(path, \"utf8\") !== contents) return false;\n    if (owner !== undefined && !processAbsent(owner)) return false;\n    await unlink(path);\n    return true;\n  } catch { return false; } // Startup contenders can replace or remove the file while it is inspected.\n}\n\nfunction lockOwner(contents: string): number | undefined {\n  const text = contents.trim();\n  const pid = Number(text);\n  return /^[1-9][0-9]*$/.test(text) && Number.isSafeInteger(pid) && pid <= 2_147_483_647 ? pid : undefined;\n}\n\nfunction processAbsent(pid: number): boolean {\n  try { process.kill(pid, 0); return false; }\n  catch (error) { return (error as NodeJS.ErrnoException).code === \"ESRCH\"; }\n}\n"]}
+{"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"]}

package/dist/runtime/types.d.ts

@@ -1,5 +1,7 @@
 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';
 export type TaskState = 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
 export type Delivery = 'queue' | 'steer' | 'interrupt';
 export interface AgentReference {
@@ -22,7 +24,10 @@ export interface DriverInput extends Omit<SessionInput, 'prompt' | 'parentToken'
     token: string;
     sessionId: string;
 }
-export type DriverFactory = (input: DriverInput) => Promise<NativeSession>;
+export type ManagedNativeSession = NativeSession & {
+    selectedHarness?: HarnessKind;
+};
+export type DriverFactory = (input: DriverInput) => Promise<ManagedNativeSession>;
 export interface RecordBase {
     version: 1;
     type: string;
@@ -40,6 +45,8 @@ export interface Receipt extends RecordBase {
     delivery?: Delivery;
     requestedDelivery?: Delivery;
     resumed?: boolean;
+    paused?: true;
+    blockedByTaskId?: string;
 }
 export interface Response extends Observation {
     type: 'response';
@@ -55,6 +62,7 @@ export interface Task {
     id: string;
     sessionId: string;
     prompt: string;
+    title: string;
     parentId?: string;
     state: TaskState;
     responses: Response[];
@@ -65,17 +73,23 @@ export interface Task {
     stopPromise?: Promise<void>;
     stopUnconfirmed?: boolean;
     error?: ErrorInfo;
+    dispatchedAt?: number;
+    failedAt?: number;
+    finishedAt?: number;
+    updatedAt: number;
     changed: Set<() => void>;
 }
 export interface Session {
     id: string;
     token: string;
     input: SessionInput;
-    driver?: Promise<NativeSession>;
+    driver?: Promise<ManagedNativeSession>;
     tasks: string[];
     active?: string;
     paused: boolean;
     commands: Promise<unknown>;
     controls: number;
+    harness: DashboardHarness;
+    workspace: Promise<DashboardWorkspace>;
 }
 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":"AAyBA,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';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | '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 }\nexport type DriverFactory = (input: DriverInput) => Promise<NativeSession>;\nexport interface RecordBase { version: 1; type: string; sessionId: string; taskId: string; state?: TaskState }\nexport interface Observation extends RecordBase { state: TaskState; responseId?: string; text?: string; error?: ErrorInfo }\nexport interface Receipt extends RecordBase { delivery?: Delivery; requestedDelivery?: Delivery; resumed?: boolean }\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; parentId?: string; state: TaskState;\n  responses: Response[]; children: Set<string>; inbox: ChildResult[]; nativeActive: boolean;\n  stopping: boolean; stopPromise?: Promise<void>; stopUnconfirmed?: boolean; error?: ErrorInfo; changed: Set<() => void>;\n}\nexport interface Session {\n  id: string; token: string; input: SessionInput; driver?: Promise<NativeSession>;\n  tasks: string[]; active?: string; paused: boolean; commands: Promise<unknown>; controls: number;\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":"AAiCA,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';\n\nexport type TaskState = 'queued' | 'running' | 'waiting' | '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 }\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 Observation extends RecordBase { state: TaskState; responseId?: string; text?: string; error?: ErrorInfo }\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"]}

package/dist/runtime/worker-client.d.ts

@@ -1,3 +1,8 @@
-import type { NativeSession } from '../adapters/types.js';
 import type { DriverInput } from './types.js';
-export declare function createWorker(input: DriverInput): Promise<NativeSession>;
+import type { ManagedNativeSession } from './types.js';
+interface WorkerClientOptions {
+    workerModule?: URL;
+    shutdownTimeoutMs?: number;
+}
+export declare function createWorker(input: DriverInput, options?: WorkerClientOptions): Promise<ManagedNativeSession>;
+export {};

package/dist/runtime/worker-client.js

@@ -3,12 +3,27 @@ import { fileURLToPath } from 'node:url';
 import { delimiter } from 'node:path';
 import { AgentError } from '../errors.js';
 import { createSessionLauncher } from './session-launcher.js';
-export async function createWorker(input) {
+const closeResponseTimeoutMs = 15_000;
+const shutdownTimeoutMs = 1_000;
+function waitWithin(promise, timeout) {
+    return new Promise(resolve => {
+        const timer = setTimeout(() => resolve(false), timeout);
+        promise.then(() => { clearTimeout(timer); resolve(true); }, () => { clearTimeout(timer); resolve(true); });
+    });
+}
+function withTimeout(promise, timeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new AgentError('HARNESS_FAILED', 'The session worker did not complete cleanup.')), timeout);
+        promise.then(value => { clearTimeout(timer); resolve(value); }, error => { clearTimeout(timer); reject(error); });
+    });
+}
+export async function createWorker(input, options = {}) {
     const launcher = await createSessionLauncher(input.env.AGENT_STATE_DIR, input.token);
-    const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';
+    const workerModule = options.workerModule ?? new URL(`./worker.${import.meta.url.endsWith('.ts') ? 'ts' : 'js'}`, import.meta.url);
+    const extension = workerModule.pathname.endsWith('.ts') ? 'ts' : 'js';
     let child;
     try {
-        child = fork(fileURLToPath(new URL(`./worker.${extension}`, import.meta.url)), [], {
+        child = fork(fileURLToPath(workerModule), [], {
             cwd: input.cwd, env: { ...input.env, AGENT_PARENT_TOKEN: input.token, AGENT_CLI_PATH: launcher.path,
                 PATH: launcher.directory + delimiter + (input.env.PATH ?? '') },
             execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [],
@@ -22,11 +37,14 @@ export async function createWorker(input) {
     let nextId = 1;
     const pending = new Map();
     let exited = false;
+    let markExited;
+    const processExit = new Promise(resolve => { markExited = resolve; });
     const exit = () => {
         if (exited)
             return;
         exited = true;
-        void launcher.close().catch(() => { }).then(() => {
+        markExited();
+        void launcher.close().catch(() => { }).finally(() => {
             for (const waiting of pending.values())
                 waiting.reject(new AgentError('HARNESS_FAILED', 'The session worker exited.'));
             pending.clear();
@@ -56,26 +74,65 @@ export async function createWorker(input) {
             reject(new AgentError('HARNESS_FAILED', 'Cannot reach the session worker.'));
         } });
     });
+    let selectedHarness;
     try {
-        await request('open', { input });
+        selectedHarness = await request('open', { input });
     }
     catch (error) {
         child.kill();
         await launcher.close();
         throw error;
     }
+    const stopWorker = async () => {
+        if (exited)
+            return;
+        if (child.connected)
+            try {
+                child.disconnect();
+            }
+            catch { /* Continue to termination escalation. */ }
+        const timeout = options.shutdownTimeoutMs ?? shutdownTimeoutMs;
+        if (await waitWithin(processExit, timeout))
+            return;
+        child.kill('SIGTERM');
+        if (await waitWithin(processExit, timeout))
+            return;
+        child.kill('SIGKILL');
+        if (await waitWithin(processExit, timeout))
+            return;
+        throw new AgentError('HARNESS_FAILED', 'The session worker did not confirm termination.');
+    };
     return {
+        selectedHarness,
         turn: prompt => request('turn', { prompt }),
         steer: async (prompt) => { await request('steer', { prompt }); },
         interrupt: async () => { await request('interrupt'); },
         resume: () => request('resume'),
-        close: async () => { try {
-            if (!exited)
-                await request('close');
-        }
-        finally {
-            await launcher.close();
-        } },
+        close: async () => {
+            let failure;
+            if (!exited) {
+                try {
+                    await withTimeout(request('close'), closeResponseTimeoutMs);
+                }
+                catch (error) {
+                    failure = error;
+                }
+            }
+            try {
+                await stopWorker();
+            }
+            catch (error) {
+                failure ??= error;
+            }
+            try {
+                await launcher.close();
+            }
+            catch (error) {
+                failure ??= error;
+            }
+            if (failure)
+                throw failure;
+        },
     };
 }
 //# sourceMappingURL=worker-client.js.map