subharness 0.0.4 → 0.0.7

package/dist/runtime/capture.js

@@ -0,0 +1,320 @@
+import { fork } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+import { AgentError, errorInfo } from '../errors.js';
+import { createSessionLauncher } from './session-launcher.js';
+import { processExitDescription } from '../process-diagnostics.js';
+const shutdownTimeoutMs = 1_000;
+class GraphConnection {
+    child;
+    timeout;
+    nextId = 1;
+    pending = new Map();
+    approvals = new Map();
+    handlers = new Map();
+    exited = false;
+    leases = new Set();
+    abandonedLeases = new Set();
+    observedExit = '';
+    processExit;
+    markExited;
+    constructor(child, timeout) {
+        this.child = child;
+        this.timeout = timeout;
+        this.processExit = new Promise(resolve => { this.markExited = resolve; });
+        child.once('error', () => this.exit(undefined, undefined, true));
+        child.once('exit', (code, signal) => this.exit(code, signal));
+        child.on('message', (message) => this.message(message));
+    }
+    setApprovalHandler(leaseId, handler) { this.handlers.set(leaseId, handler); }
+    deleteApprovalHandler(leaseId) { this.handlers.delete(leaseId); }
+    retainLease(leaseId) { this.leases.add(leaseId); }
+    async releaseLease(leaseId) {
+        this.leases.delete(leaseId);
+        await this.retryAbandonedLeases();
+        const retained = [...this.leases].filter(id => !this.abandonedLeases.has(id));
+        if (retained.length !== 0)
+            return;
+        if (this.abandonedLeases.size) {
+            this.abandonedLeases.clear();
+            this.leases.clear();
+            await this.stop();
+            return;
+        }
+        if (await this.waitWithin(this.timeout))
+            return;
+        await this.stop();
+    }
+    async abandonLease(leaseId) {
+        if (!this.leases.has(leaseId))
+            return;
+        const siblings = [...this.leases].filter(id => id !== leaseId && !this.abandonedLeases.has(id));
+        if (siblings.length) {
+            this.abandonedLeases.add(leaseId);
+            return;
+        }
+        this.leases.delete(leaseId);
+        await this.stop();
+    }
+    async retryAbandonedLeases() {
+        for (const leaseId of [...this.abandonedLeases]) {
+            try {
+                await this.request('lease.close', { leaseId });
+                this.abandonedLeases.delete(leaseId);
+                this.leases.delete(leaseId);
+            }
+            catch { /* Retain ownership until the remaining graph leases close. */ }
+        }
+    }
+    request(method, extra = {}) {
+        return new Promise((resolve, reject) => {
+            if (this.exited) {
+                reject(new AgentError('HARNESS_FAILED', `The captured definition worker is unavailable while ${method} was pending${this.observedExit}.`));
+                return;
+            }
+            const id = this.nextId++;
+            this.pending.set(id, { operation: method, resolve, reject });
+            this.child.send({ id, method, ...extra }, error => {
+                if (!error)
+                    return;
+                setImmediate(() => {
+                    const waiting = this.pending.get(id);
+                    if (!waiting || this.exited)
+                        return;
+                    this.pending.delete(id);
+                    waiting.reject(new AgentError('HARNESS_FAILED', `Cannot reach the captured definition worker while ${method} was pending.`));
+                });
+            });
+        });
+    }
+    message(message) {
+        if ('event' in message) {
+            const key = `${message.leaseId}:${message.requestId}`;
+            if (message.event === 'approval.withdraw') {
+                this.approvals.get(key)?.abort();
+                this.approvals.delete(key);
+                return;
+            }
+            const controller = new AbortController();
+            this.approvals.set(key, controller);
+            void Promise.resolve().then(() => {
+                const handler = this.handlers.get(message.leaseId);
+                if (!handler)
+                    throw new AgentError('INPUT_REQUIRED', 'Native tool approval requires an observing caller.');
+                return handler(message.request, controller.signal);
+            }).then(content => { if (!controller.signal.aborted && !this.exited)
+                return this.request('approval.respond', { leaseId: message.leaseId, requestId: message.requestId, content }); }, error => { if (!controller.signal.aborted && !this.exited)
+                return this.request('approval.respond', { leaseId: message.leaseId, requestId: message.requestId, error: errorInfo(error) }); }).catch(error => {
+                if (!controller.signal.aborted && !this.exited)
+                    return this.request('approval.respond', { leaseId: message.leaseId, requestId: message.requestId, error: errorInfo(error) }).catch(() => { });
+            }).finally(() => this.approvals.delete(key));
+            return;
+        }
+        const waiting = this.pending.get(message.id);
+        if (!waiting)
+            return;
+        this.pending.delete(message.id);
+        if (message.error)
+            waiting.reject(new AgentError(message.error.code, message.error.message));
+        else
+            waiting.resolve(message.result);
+    }
+    exit(code, signal, spawnFailure = false) {
+        if (this.exited)
+            return;
+        this.exited = true;
+        this.observedExit = spawnFailure ? '' : processExitDescription(code, signal);
+        for (const controller of this.approvals.values())
+            controller.abort();
+        this.approvals.clear();
+        this.markExited();
+        for (const waiting of this.pending.values())
+            waiting.reject(new AgentError('HARNESS_FAILED', spawnFailure
+                ? `The captured definition worker process failed while ${waiting.operation} was pending.`
+                : `The captured definition worker exited while ${waiting.operation} was pending${this.observedExit}.`));
+        this.pending.clear();
+    }
+    async stop() {
+        if (this.exited)
+            return;
+        if (this.child.connected)
+            try {
+                this.child.disconnect();
+            }
+            catch { }
+        if (await this.waitWithin(this.timeout))
+            return;
+        this.child.kill('SIGTERM');
+        if (await this.waitWithin(this.timeout))
+            return;
+        this.child.kill('SIGKILL');
+        if (!await this.waitWithin(this.timeout))
+            throw new AgentError('HARNESS_FAILED', 'The captured definition worker did not confirm termination.');
+    }
+    waitWithin(timeout) {
+        return new Promise(resolve => {
+            const timer = setTimeout(() => resolve(false), timeout);
+            this.processExit.then(() => { clearTimeout(timer); resolve(true); });
+        });
+    }
+}
+class CaptureLease {
+    graph;
+    leaseId;
+    reference;
+    prepared;
+    children;
+    launcher;
+    nativeClosed = false;
+    released = false;
+    closing = false;
+    opening;
+    constructor(graph, leaseId, reference, children) {
+        this.graph = graph;
+        this.leaseId = leaseId;
+        this.reference = reference;
+        this.graph.retainLease(leaseId);
+        this.children = Object.freeze(children.map(child => Object.freeze({ ...child })));
+        this.prepared = { open: input => this.open(input), close: () => this.close() };
+    }
+    async child(name) {
+        if (this.released)
+            throw new AgentError('INVALID_PARENT', 'The captured parent context is closed.');
+        const result = await this.graph.request('child', { leaseId: this.leaseId, name });
+        return new CaptureLease(this.graph, result.leaseId, result.reference, result.children);
+    }
+    async open(input) {
+        if (this.released || this.closing || this.opening)
+            throw new AgentError('HARNESS_FAILED', 'Native session startup is unavailable.');
+        const opening = this.startOpen(input);
+        this.opening = opening;
+        return opening;
+    }
+    async startOpen(input) {
+        const state = input.env.AGENT_STATE_DIR;
+        if (typeof state !== 'string' || !state)
+            throw new AgentError('INVALID_CONFIG', 'AGENT_STATE_DIR must select the coordinator state directory.');
+        const launcher = await createSessionLauncher(state, input.token);
+        this.launcher = launcher;
+        if (this.closing) {
+            await launcher.close();
+            this.launcher = undefined;
+            throw new AgentError('COORDINATOR_UNAVAILABLE', 'The captured session closed during startup.');
+        }
+        const { onApproval, ...serializedInput } = input;
+        let selectedHarness;
+        try {
+            this.graph.setApprovalHandler(this.leaseId, onApproval);
+            selectedHarness = await this.graph.request('open', { leaseId: this.leaseId, input: serializedInput,
+                handlesApprovals: !!onApproval, launcherPath: launcher.path });
+        }
+        catch (error) {
+            this.graph.deleteApprovalHandler(this.leaseId);
+            this.launcher = undefined;
+            await launcher.close();
+            throw error;
+        }
+        const request = (method, extra = {}) => this.graph.request(method, { leaseId: this.leaseId, ...extra });
+        return {
+            selectedHarness,
+            turn: prompt => request('turn', { prompt }),
+            steer: async (prompt) => { await request('steer', { prompt }); },
+            interrupt: async () => { await request('interrupt'); },
+            resume: () => request('resume'),
+            close: async () => {
+                if (this.nativeClosed)
+                    return;
+                await request('native.close');
+                this.nativeClosed = true;
+                this.graph.deleteApprovalHandler(this.leaseId);
+            },
+        };
+    }
+    async close() {
+        this.closing = true;
+        if (!this.released) {
+            await this.graph.request('lease.close', { leaseId: this.leaseId });
+            this.released = true;
+            this.nativeClosed = true;
+            this.graph.deleteApprovalHandler(this.leaseId);
+        }
+        await this.opening?.catch(() => undefined);
+        if (this.launcher) {
+            await this.launcher.close();
+            this.launcher = undefined;
+        }
+        await this.graph.releaseLease(this.leaseId);
+    }
+    async abandonFailedCheck() {
+        this.closing = true;
+        this.released = true;
+        this.nativeClosed = true;
+        this.graph.deleteApprovalHandler(this.leaseId);
+        await this.opening?.catch(() => undefined);
+        if (this.launcher) {
+            await this.launcher.close().catch(() => { });
+            this.launcher = undefined;
+        }
+        await this.graph.abandonLease(this.leaseId);
+    }
+}
+export async function captureExecution(agent, input, options = {}) {
+    return captureRequest(input, options, { method: 'capture', agent });
+}
+/** Captures an already resolved private CLI reference without applying public connected validation. */
+export async function captureReference(reference, input, options = {}) {
+    if ('kind' in reference && reference.kind === 'inline')
+        throw new AgentError('INVALID_DEFINITION', 'Inline agent definitions cannot be loaded by native CLI workers.');
+    return captureRequest(input, options, { method: 'capture.reference', reference });
+}
+async function captureRequest(input, options, request) {
+    const { AGENT_PARENT_TOKEN: _parent, AGENT_CLI_PATH: _launcher, ...environment } = input.env;
+    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(workerModule), [], { cwd: input.cwd, env: environment, stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+            execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [] });
+    }
+    catch {
+        throw new AgentError('INVALID_DEFINITION', 'The captured definition worker could not be spawned.');
+    }
+    const graph = new GraphConnection(child, options.shutdownTimeoutMs ?? shutdownTimeoutMs);
+    try {
+        const { method, ...data } = request;
+        const result = await graph.request(method, data);
+        return new CaptureLease(graph, result.leaseId, result.reference, result.children);
+    }
+    catch (error) {
+        await graph.stop().catch(() => { });
+        throw error;
+    }
+}
+export async function checkCapturedExecution(captured, input) {
+    let native;
+    let failure;
+    try {
+        native = await captured.prepared.open({ reference: captured.reference, cwd: input.cwd, env: input.env,
+            token: randomUUID(), sessionId: `check_${randomUUID()}` });
+        await native.close();
+    }
+    catch (error) {
+        failure = error;
+    }
+    try {
+        await captured.prepared.close();
+    }
+    catch (error) {
+        failure ??= error;
+        try {
+            await captured.prepared.close();
+        }
+        catch {
+            if (captured instanceof CaptureLease)
+                await captured.abandonFailedCheck();
+        }
+    }
+    if (failure)
+        throw failure;
+}
+//# sourceMappingURL=capture.js.map

package/dist/runtime/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/runtime/capture.ts"],"names":[],"mappings":"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","sourcesContent":["import { fork, type ChildProcess } from 'node:child_process';\nimport { fileURLToPath } from 'node:url';\nimport { randomUUID } from 'node:crypto';\nimport { AgentError, errorInfo, type ErrorInfo } from '../errors.js';\nimport type { ApprovalHandler } from '../approvals/types.js';\nimport type { HarnessConfig, HarnessKind } from '../sdk/types.js';\nimport type { CatalogEnvironment } from './catalog.js';\nimport type { DriverInput, ExecutionReference, ManagedNativeSession, PreparedExecution } from './types.js';\nimport type { ApprovalEvent } from './worker-approvals.js';\nimport { createSessionLauncher } from './session-launcher.js';\nimport { processExitDescription } from '../process-diagnostics.js';\n\nexport interface CapturedChild {\n  readonly name: string;\n  readonly description: string;\n}\n\nexport interface CapturedExecution {\n  readonly reference: ExecutionReference;\n  readonly prepared: PreparedExecution;\n  readonly children: readonly CapturedChild[];\n  child(name: string): Promise<CapturedExecution>;\n}\n\ninterface CaptureOptions { workerModule?: URL; shutdownTimeoutMs?: number }\ninterface CaptureResult {leaseId:number;reference:ExecutionReference;children:CapturedChild[]}\ntype WorkerReply = ApprovalEvent & {leaseId:number} | {id:number;result?:unknown;error?:ErrorInfo};\n\nconst shutdownTimeoutMs = 1_000;\n\nclass GraphConnection {\n  private nextId=1;\n  private pending=new Map<number,{operation:string;resolve(value:unknown):void;reject(error:Error):void}>();\n  private approvals=new Map<string,AbortController>();\n  private handlers=new Map<number,ApprovalHandler|undefined>();\n  private exited=false;\n  private leases=new Set<number>();\n  private abandonedLeases=new Set<number>();\n  private observedExit='';\n  private readonly processExit:Promise<void>;\n  private markExited!:()=>void;\n\n  constructor(private readonly child:ChildProcess,private readonly timeout:number) {\n    this.processExit=new Promise(resolve=>{this.markExited=resolve;});\n    child.once('error',()=>this.exit(undefined,undefined,true));\n    child.once('exit',(code,signal)=>this.exit(code,signal));\n    child.on('message',(message:WorkerReply)=>this.message(message));\n  }\n\n  setApprovalHandler(leaseId:number,handler:ApprovalHandler|undefined) { this.handlers.set(leaseId,handler); }\n  deleteApprovalHandler(leaseId:number) { this.handlers.delete(leaseId); }\n  retainLease(leaseId:number) { this.leases.add(leaseId); }\n  async releaseLease(leaseId:number) {\n    this.leases.delete(leaseId);\n    await this.retryAbandonedLeases();\n    const retained=[...this.leases].filter(id=>!this.abandonedLeases.has(id));\n    if(retained.length!==0)return;\n    if(this.abandonedLeases.size){this.abandonedLeases.clear();this.leases.clear();await this.stop();return;}\n    if(await this.waitWithin(this.timeout))return;\n    await this.stop();\n  }\n  async abandonLease(leaseId:number) {\n    if(!this.leases.has(leaseId))return;\n    const siblings=[...this.leases].filter(id=>id!==leaseId&&!this.abandonedLeases.has(id));\n    if(siblings.length){this.abandonedLeases.add(leaseId);return;}\n    this.leases.delete(leaseId);\n    await this.stop();\n  }\n\n  private async retryAbandonedLeases() {\n    for(const leaseId of [...this.abandonedLeases]){\n      try{\n        await this.request('lease.close',{leaseId});\n        this.abandonedLeases.delete(leaseId);this.leases.delete(leaseId);\n      }catch{/* Retain ownership until the remaining graph leases close. */}\n    }\n  }\n\n  request(method:string,extra:Record<string,unknown>={}):Promise<unknown> {\n    return new Promise((resolve,reject)=>{\n      if(this.exited){reject(new AgentError('HARNESS_FAILED',`The captured definition worker is unavailable while ${method} was pending${this.observedExit}.`));return;}\n      const id=this.nextId++;\n      this.pending.set(id,{operation:method,resolve,reject});\n      this.child.send({id,method,...extra},error=>{\n        if(!error)return;\n        setImmediate(()=>{\n          const waiting=this.pending.get(id);\n          if(!waiting||this.exited)return;\n          this.pending.delete(id);\n          waiting.reject(new AgentError('HARNESS_FAILED',`Cannot reach the captured definition worker while ${method} was pending.`));\n        });\n      });\n    });\n  }\n\n  private message(message:WorkerReply) {\n    if('event' in message){\n      const key=`${message.leaseId}:${message.requestId}`;\n      if(message.event==='approval.withdraw'){\n        this.approvals.get(key)?.abort();this.approvals.delete(key);return;\n      }\n      const controller=new AbortController();\n      this.approvals.set(key,controller);\n      void Promise.resolve().then(()=>{\n        const handler=this.handlers.get(message.leaseId);\n        if(!handler)throw new AgentError('INPUT_REQUIRED','Native tool approval requires an observing caller.');\n        return handler(message.request,controller.signal);\n      }).then(\n        content=>{if(!controller.signal.aborted&&!this.exited)return this.request('approval.respond',{leaseId:message.leaseId,requestId:message.requestId,content});},\n        error=>{if(!controller.signal.aborted&&!this.exited)return this.request('approval.respond',{leaseId:message.leaseId,requestId:message.requestId,error:errorInfo(error)});},\n      ).catch(error=>{\n        if(!controller.signal.aborted&&!this.exited)\n          return this.request('approval.respond',{leaseId:message.leaseId,requestId:message.requestId,error:errorInfo(error)}).catch(()=>{});\n      }).finally(()=>this.approvals.delete(key));\n      return;\n    }\n    const waiting=this.pending.get(message.id);\n    if(!waiting)return;\n    this.pending.delete(message.id);\n    if(message.error)waiting.reject(new AgentError(message.error.code,message.error.message));\n    else waiting.resolve(message.result);\n  }\n\n  private exit(code:unknown,signal:unknown,spawnFailure=false) {\n    if(this.exited)return;\n    this.exited=true;\n    this.observedExit=spawnFailure?'':processExitDescription(code,signal);\n    for(const controller of this.approvals.values())controller.abort();\n    this.approvals.clear();this.markExited();\n    for(const waiting of this.pending.values())waiting.reject(new AgentError('HARNESS_FAILED',spawnFailure\n      ?`The captured definition worker process failed while ${waiting.operation} was pending.`\n      :`The captured definition worker exited while ${waiting.operation} was pending${this.observedExit}.`));\n    this.pending.clear();\n  }\n\n  async stop() {\n    if(this.exited)return;\n    if(this.child.connected)try{this.child.disconnect();}catch{}\n    if(await this.waitWithin(this.timeout))return;\n    this.child.kill('SIGTERM');\n    if(await this.waitWithin(this.timeout))return;\n    this.child.kill('SIGKILL');\n    if(!await this.waitWithin(this.timeout))throw new AgentError('HARNESS_FAILED','The captured definition worker did not confirm termination.');\n  }\n\n  private waitWithin(timeout:number):Promise<boolean>{\n    return new Promise(resolve=>{\n      const timer=setTimeout(()=>resolve(false),timeout);\n      this.processExit.then(()=>{clearTimeout(timer);resolve(true);});\n    });\n  }\n}\n\nclass CaptureLease implements CapturedExecution {\n  readonly prepared:PreparedExecution;\n  readonly children:readonly CapturedChild[];\n  private launcher?:Awaited<ReturnType<typeof createSessionLauncher>>;\n  private nativeClosed=false;\n  private released=false;\n  private closing=false;\n  private opening?:Promise<ManagedNativeSession>;\n\n  constructor(\n    private readonly graph:GraphConnection,\n    private readonly leaseId:number,\n    readonly reference:ExecutionReference,\n    children:readonly CapturedChild[],\n  ) {\n    this.graph.retainLease(leaseId);\n    this.children=Object.freeze(children.map(child=>Object.freeze({...child})));\n    this.prepared={open:input=>this.open(input),close:()=>this.close()};\n  }\n\n  async child(name:string):Promise<CapturedExecution>{\n    if(this.released)throw new AgentError('INVALID_PARENT','The captured parent context is closed.');\n    const result=await this.graph.request('child',{leaseId:this.leaseId,name}) as CaptureResult;\n    return new CaptureLease(this.graph,result.leaseId,result.reference,result.children);\n  }\n\n  private async open(input:DriverInput):Promise<ManagedNativeSession>{\n    if(this.released||this.closing||this.opening)throw new AgentError('HARNESS_FAILED','Native session startup is unavailable.');\n    const opening=this.startOpen(input);\n    this.opening=opening;\n    return opening;\n  }\n\n  private async startOpen(input:DriverInput):Promise<ManagedNativeSession>{\n    const state=input.env.AGENT_STATE_DIR;\n    if(typeof state!=='string'||!state)throw new AgentError('INVALID_CONFIG','AGENT_STATE_DIR must select the coordinator state directory.');\n    const launcher=await createSessionLauncher(state,input.token);\n    this.launcher=launcher;\n    if(this.closing){\n      await launcher.close();this.launcher=undefined;\n      throw new AgentError('COORDINATOR_UNAVAILABLE','The captured session closed during startup.');\n    }\n    const {onApproval,...serializedInput}=input;\n    let selectedHarness:HarnessKind|undefined;\n    try{\n      this.graph.setApprovalHandler(this.leaseId,onApproval);\n      selectedHarness=await this.graph.request('open',{leaseId:this.leaseId,input:serializedInput,\n        handlesApprovals:!!onApproval,launcherPath:launcher.path}) as HarnessKind;\n    }catch(error){\n      this.graph.deleteApprovalHandler(this.leaseId);\n      this.launcher=undefined;\n      await launcher.close();\n      throw error;\n    }\n    const request=(method:string,extra:Record<string,unknown>={})=>this.graph.request(method,{leaseId:this.leaseId,...extra});\n    return {\n      selectedHarness,\n      turn:prompt=>request('turn',{prompt}) as Promise<string>,\n      steer:async prompt=>{await request('steer',{prompt});},\n      interrupt:async()=>{await request('interrupt');},\n      resume:()=>request('resume') as Promise<string>,\n      close:async()=>{\n        if(this.nativeClosed)return;\n        await request('native.close');\n        this.nativeClosed=true;\n        this.graph.deleteApprovalHandler(this.leaseId);\n      },\n    };\n  }\n\n  private async close():Promise<void>{\n    this.closing=true;\n    if(!this.released){\n      await this.graph.request('lease.close',{leaseId:this.leaseId});\n      this.released=true;\n      this.nativeClosed=true;\n      this.graph.deleteApprovalHandler(this.leaseId);\n    }\n    await this.opening?.catch(()=>undefined);\n    if(this.launcher){await this.launcher.close();this.launcher=undefined;}\n    await this.graph.releaseLease(this.leaseId);\n  }\n\n  async abandonFailedCheck():Promise<void>{\n    this.closing=true;this.released=true;this.nativeClosed=true;\n    this.graph.deleteApprovalHandler(this.leaseId);\n    await this.opening?.catch(()=>undefined);\n    if(this.launcher){await this.launcher.close().catch(()=>{});this.launcher=undefined;}\n    await this.graph.abandonLease(this.leaseId);\n  }\n}\n\nexport async function captureExecution(\n  agent:string|HarnessConfig,\n  input:CatalogEnvironment,\n  options:CaptureOptions={},\n):Promise<CapturedExecution>{\n  return captureRequest(input,options,{method:'capture',agent});\n}\n\n/** Captures an already resolved private CLI reference without applying public connected validation. */\nexport async function captureReference(\n  reference:ExecutionReference,\n  input:CatalogEnvironment,\n  options:CaptureOptions={},\n):Promise<CapturedExecution>{\n  if('kind' in reference&&reference.kind==='inline')\n    throw new AgentError('INVALID_DEFINITION','Inline agent definitions cannot be loaded by native CLI workers.');\n  return captureRequest(input,options,{method:'capture.reference',reference});\n}\n\nasync function captureRequest(\n  input:CatalogEnvironment,\n  options:CaptureOptions,\n  request:{method:'capture';agent:string|HarnessConfig}|{method:'capture.reference';reference:ExecutionReference},\n):Promise<CapturedExecution>{\n  const {AGENT_PARENT_TOKEN:_parent,AGENT_CLI_PATH:_launcher,...environment}=input.env;\n  const workerModule=options.workerModule??new URL(`./worker.${import.meta.url.endsWith('.ts')?'ts':'js'}`,import.meta.url);\n  const extension=workerModule.pathname.endsWith('.ts')?'ts':'js';\n  let child:ChildProcess;\n  try{\n    child=fork(fileURLToPath(workerModule),[],{cwd:input.cwd,env:environment,stdio:['ignore','ignore','ignore','ipc'],\n      execArgv:extension==='ts'?['--import',import.meta.resolve('tsx')]:[]});\n  }catch{throw new AgentError('INVALID_DEFINITION','The captured definition worker could not be spawned.');}\n  const graph=new GraphConnection(child,options.shutdownTimeoutMs??shutdownTimeoutMs);\n  try{\n    const {method,...data}=request;\n    const result=await graph.request(method,data) as CaptureResult;\n    return new CaptureLease(graph,result.leaseId,result.reference,result.children);\n  }catch(error){await graph.stop().catch(()=>{});throw error;}\n}\n\nexport async function checkCapturedExecution(captured:CapturedExecution,input:CatalogEnvironment):Promise<void>{\n  let native:ManagedNativeSession|undefined;\n  let failure:unknown;\n  try{\n    native=await captured.prepared.open({reference:captured.reference,cwd:input.cwd,env:input.env,\n      token:randomUUID(),sessionId:`check_${randomUUID()}`});\n    await native.close();\n  }catch(error){failure=error;}\n  try{await captured.prepared.close();}catch(error){\n    failure??=error;\n    try{await captured.prepared.close();}\n    catch{if(captured instanceof CaptureLease)await captured.abandonFailedCheck();}\n  }\n  if(failure)throw failure;\n}\n"]}

package/dist/runtime/catalog.d.ts

@@ -0,0 +1,39 @@
+import { type ErrorInfo } from '../errors.js';
+import type { HarnessConfig } from '../sdk/types.js';
+import type { ExecutionReference } from './types.js';
+export interface CatalogEnvironment {
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+}
+export interface CatalogAgent {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly scope: 'harness' | 'repo' | 'global';
+}
+export interface CatalogSnapshot {
+    entries: {
+        id: string;
+        name: string;
+        description: string;
+        scope: 'repo' | 'global';
+        file: string;
+    }[];
+    children: {
+        name: string;
+        description: string;
+    }[];
+}
+export type CatalogReply = {
+    result: CatalogSnapshot;
+    error?: never;
+} | {
+    result?: never;
+    error: ErrorInfo;
+};
+export declare function listAgents(input: CatalogEnvironment): Promise<{
+    readonly items: readonly CatalogAgent[];
+}>;
+export declare function resolveAgent(agent: string | HarnessConfig, input: CatalogEnvironment): Promise<ExecutionReference>;
+export declare function checkAgent(agent: string | HarnessConfig, input: CatalogEnvironment): Promise<void>;
+export declare function loadCatalogSnapshot(input: CatalogEnvironment, parent?: ExecutionReference, discover?: boolean): Promise<CatalogSnapshot>;

package/dist/runtime/catalog.js

@@ -0,0 +1,84 @@
+import { fork } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { AgentError } from '../errors.js';
+import { validateAgent } from '../sdk/definitions.js';
+import { harnessReference } from './definition.js';
+const nativeAgents = [
+    { id: 'codex', name: 'codex', description: 'Run the native Codex harness.', scope: 'harness' },
+    { id: 'claude', name: 'claude', description: 'Run the native Claude Code harness.', scope: 'harness' },
+    { id: 'fx', name: 'fx', description: 'Run the native fx harness through AI Gateway.', scope: 'harness' },
+    { id: 'opencode', name: 'opencode', description: 'Run the native OpenCode harness through AI Gateway.', scope: 'harness' },
+    { id: 'copilot', name: 'copilot', description: 'Run the native GitHub Copilot harness through AI Gateway.', scope: 'harness' },
+    { id: 'cursor', name: 'cursor', description: 'Run the native Cursor harness.', scope: 'harness' },
+];
+export async function listAgents(input) {
+    const snapshot = await loadCatalogSnapshot(input);
+    return { items: [...nativeAgents, ...snapshot.entries.map(({ id, name, description, scope }) => ({ id, name, description, scope }))] };
+}
+export async function resolveAgent(agent, input) {
+    if (typeof agent !== 'string') {
+        validateAgent({ name: 'direct', description: 'Direct native harness.', instructions: 'Run.', harness: agent });
+        return { kind: 'harness', harness: agent };
+    }
+    if (agent === 'codex')
+        return harnessReference('codex');
+    if (agent === 'claude')
+        return harnessReference('claudeCode');
+    if (agent === 'fx')
+        return harnessReference('fx');
+    if (agent === 'opencode' || agent === 'copilot' || agent === 'cursor')
+        throw new AgentError('INVALID_CONFIG', `${agent} requires an explicit model configuration.`);
+    if (agent.startsWith('subagent:'))
+        throw new AgentError('UNKNOWN_AGENT', 'Managed subagents require an active parent context.');
+    const { entries } = await loadCatalogSnapshot(input);
+    const matches = entries.filter(entry => entry.id === agent || entry.name === agent);
+    if (matches.length !== 1)
+        throw new AgentError(matches.length ? 'AMBIGUOUS_AGENT' : 'UNKNOWN_AGENT', matches.length ? `Choose ${matches.map(entry => entry.id).join(' or ')}.` : 'Agent not found.');
+    return { file: matches[0].file, subagents: [] };
+}
+export async function checkAgent(agent, input) {
+    const { captureExecution, checkCapturedExecution } = await import('./capture.js');
+    const captured = await captureExecution(agent, input);
+    await checkCapturedExecution(captured, input);
+}
+export function loadCatalogSnapshot(input, parent, discover = true) {
+    if (parent && 'kind' in parent && parent.kind === 'inline')
+        return Promise.reject(new AgentError('INVALID_PARENT', 'Inline SDK definitions are unavailable to the CLI catalog.'));
+    return new Promise((resolve, reject) => {
+        const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';
+        const child = fork(fileURLToPath(new URL(`../cli/catalog-worker.${extension}`, import.meta.url)), [], {
+            cwd: input.cwd, env: input.env, stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+            execArgv: extension === 'ts' ? ['--import', import.meta.resolve('tsx')] : [],
+        });
+        let reply;
+        let settled = false;
+        const fail = () => {
+            if (settled)
+                return;
+            settled = true;
+            reject(new AgentError('INVALID_DEFINITION', 'The agent catalog worker exited before returning its catalog.'));
+        };
+        child.once('error', fail);
+        child.once('exit', () => {
+            if (!reply)
+                fail();
+            else if (!settled) {
+                settled = true;
+                if (reply.error)
+                    reject(new AgentError(reply.error.code, reply.error.message));
+                else
+                    resolve(reply.result);
+            }
+        });
+        child.once('message', (message) => {
+            reply = message;
+            child.send({ received: true }, error => { if (error)
+                child.kill(); });
+        });
+        child.send({ cwd: input.cwd, parent, discover }, error => { if (error) {
+            child.kill();
+            fail();
+        } });
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/runtime/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/runtime/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import { fork } from 'node:child_process';\nimport { fileURLToPath } from 'node:url';\nimport { AgentError, type ErrorInfo } from '../errors.js';\nimport { validateAgent } from '../sdk/definitions.js';\nimport type { HarnessConfig } from '../sdk/types.js';\nimport { harnessReference } from './definition.js';\nimport type { ExecutionReference } from './types.js';\n\nexport interface CatalogEnvironment {\n  readonly cwd: string;\n  readonly env: NodeJS.ProcessEnv;\n}\n\nexport interface CatalogAgent {\n  readonly id: string;\n  readonly name: string;\n  readonly description: string;\n  readonly scope: 'harness' | 'repo' | 'global';\n}\n\nexport interface CatalogSnapshot {\n  entries: {id:string;name:string;description:string;scope:'repo'|'global';file:string}[];\n  children: {name:string;description:string}[];\n}\n\nexport type CatalogReply = {result:CatalogSnapshot;error?:never}|{result?:never;error:ErrorInfo};\n\nconst nativeAgents: readonly CatalogAgent[] = [\n  {id:'codex',name:'codex',description:'Run the native Codex harness.',scope:'harness'},\n  {id:'claude',name:'claude',description:'Run the native Claude Code harness.',scope:'harness'},\n  {id:'fx',name:'fx',description:'Run the native fx harness through AI Gateway.',scope:'harness'},\n  {id:'opencode',name:'opencode',description:'Run the native OpenCode harness through AI Gateway.',scope:'harness'},\n  {id:'copilot',name:'copilot',description:'Run the native GitHub Copilot harness through AI Gateway.',scope:'harness'},\n  {id:'cursor',name:'cursor',description:'Run the native Cursor harness.',scope:'harness'},\n];\n\nexport async function listAgents(input: CatalogEnvironment): Promise<{readonly items:readonly CatalogAgent[]}> {\n  const snapshot = await loadCatalogSnapshot(input);\n  return {items:[...nativeAgents,...snapshot.entries.map(({id,name,description,scope})=>({id,name,description,scope}))]};\n}\n\nexport async function resolveAgent(agent: string | HarnessConfig, input: CatalogEnvironment): Promise<ExecutionReference> {\n  if (typeof agent !== 'string') {\n    validateAgent({name:'direct',description:'Direct native harness.',instructions:'Run.',harness:agent});\n    return {kind:'harness',harness:agent};\n  }\n  if (agent === 'codex') return harnessReference('codex');\n  if (agent === 'claude') return harnessReference('claudeCode');\n  if (agent === 'fx') return harnessReference('fx');\n  if (agent === 'opencode' || agent === 'copilot' || agent === 'cursor')\n    throw new AgentError('INVALID_CONFIG', `${agent} requires an explicit model configuration.`);\n  if (agent.startsWith('subagent:'))\n    throw new AgentError('UNKNOWN_AGENT', 'Managed subagents require an active parent context.');\n  const {entries} = await loadCatalogSnapshot(input);\n  const matches = entries.filter(entry => entry.id === agent || entry.name === agent);\n  if (matches.length !== 1) throw new AgentError(matches.length ? 'AMBIGUOUS_AGENT' : 'UNKNOWN_AGENT',\n    matches.length ? `Choose ${matches.map(entry=>entry.id).join(' or ')}.` : 'Agent not found.');\n  return {file:matches[0]!.file,subagents:[]};\n}\n\nexport async function checkAgent(agent:string|HarnessConfig,input:CatalogEnvironment):Promise<void>{\n  const {captureExecution,checkCapturedExecution}=await import('./capture.js');\n  const captured=await captureExecution(agent,input);\n  await checkCapturedExecution(captured,input);\n}\n\nexport function loadCatalogSnapshot(\n  input: CatalogEnvironment,\n  parent?: ExecutionReference,\n  discover = true,\n): Promise<CatalogSnapshot> {\n  if (parent && 'kind' in parent && parent.kind === 'inline')\n    return Promise.reject(new AgentError('INVALID_PARENT','Inline SDK definitions are unavailable to the CLI catalog.'));\n  return new Promise((resolve,reject) => {\n    const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';\n    const child = fork(fileURLToPath(new URL(`../cli/catalog-worker.${extension}`,import.meta.url)),[],{\n      cwd:input.cwd,env:input.env,stdio:['ignore','ignore','ignore','ipc'],\n      execArgv:extension === 'ts' ? ['--import',import.meta.resolve('tsx')] : [],\n    });\n    let reply: CatalogReply | undefined;\n    let settled = false;\n    const fail = () => {\n      if (settled) return;\n      settled = true;\n      reject(new AgentError('INVALID_DEFINITION','The agent catalog worker exited before returning its catalog.'));\n    };\n    child.once('error',fail);\n    child.once('exit',()=>{\n      if (!reply) fail();\n      else if (!settled) {\n        settled = true;\n        if (reply.error) reject(new AgentError(reply.error.code,reply.error.message));\n        else resolve(reply.result);\n      }\n    });\n    child.once('message',(message:CatalogReply)=>{\n      reply=message;\n      child.send({received:true},error=>{if(error)child.kill();});\n    });\n    child.send({cwd:input.cwd,parent,discover},error=>{if(error){child.kill();fail();}});\n  });\n}\n"]}

package/dist/runtime/client.d.ts

@@ -1,9 +1,10 @@
 import { type ChildProcess } from 'node:child_process';
 import type { OutputRecord } from '../cli/output.js';
-import { type Endpoint, localProgram } from './state.js';
+import { type Endpoint, type EndpointCapability, localProgram } from './state.js';
 interface ConnectionOptions {
     directory?: string;
     timeoutMs?: number;
+    capability?: EndpointCapability;
     afterSpawn?: (child: ChildProcess) => void;
     beforeRetirement?: (child: ChildProcess) => void | Promise<void>;
     program?: ReturnType<typeof localProgram>;