subharness 0.0.5 → 0.0.7

package/dist/runtime/approval-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval-registry.js","sourceRoot":"","sources":["../../src/runtime/approval-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { isDeepStrictEqual } from 'node:util';\nimport { AgentError } from '../errors.js';\nimport { validateApprovalContent, validateApprovalSchema } from '../approvals/schema.js';\nimport type { ApprovalContent, NativeApprovalRequest } from '../approvals/types.js';\nimport type { ApprovalRequest } from './types.js';\n\ntype RequestIdentity = Pick<ApprovalRequest,'requestId'|'taskId'|'sessionId'>;\ninterface Continuation {\n  resolve(content: ApprovalContent): void;\n  reject(error: AgentError): void;\n  cleanup(): void;\n}\ninterface PendingEntry {\n  outcome: 'pending';\n  request: ApprovalRequest;\n  continuation: Continuation;\n}\ninterface AnsweredEntry { outcome: 'answered'; identity: RequestIdentity; answer: ApprovalContent }\ninterface WithdrawnEntry { outcome: 'withdrawn'; identity: RequestIdentity }\ntype SettledEntry = AnsweredEntry | WithdrawnEntry;\n\nconst MAX_SETTLED_REQUESTS = 1_024;\nconst expired = () => new AgentError('REQUEST_EXPIRED','The native permission request is no longer pending.');\nconst unknown = () => new AgentError('UNKNOWN_REQUEST','Permission request is unavailable in this coordinator.');\nconst identity = (request: ApprovalRequest): RequestIdentity => ({\n  requestId:request.requestId,taskId:request.taskId,sessionId:request.sessionId,\n});\n\n/** Retains pending requests and a bounded settlement-ordered outcome history. */\nexport class ApprovalRegistry {\n  private pending = new Map<string,PendingEntry>();\n  private settled = new Map<string,SettledEntry>();\n  constructor(private readonly changed: (taskId: string) => void) {}\n\n  async register(taskId: string, sessionId: string, request: NativeApprovalRequest, signal: AbortSignal): Promise<ApprovalContent> {\n    if (signal.aborted) throw expired();\n    if (this.pendingFor(taskId).length >= 32)\n      throw new AgentError('INPUT_REQUIRED','A task cannot wait on more than 32 permission requests.');\n    let copy: NativeApprovalRequest;\n    try {\n      const serialized = JSON.stringify(request);\n      if (Buffer.byteLength(serialized) > 64 * 1024) throw new Error();\n      copy = JSON.parse(serialized) as NativeApprovalRequest;\n    } catch { throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented within 64 KiB.'); }\n    if (copy.kind !== 'permission' || !['codex','claudeCode','fx','opencode','copilot','cursor'].includes(copy.harness) || typeof copy.message !== 'string')\n      throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented.');\n    validateApprovalSchema(copy.requestedSchema);\n    const requestId = `req_${randomUUID()}`;\n    const snapshot: ApprovalRequest = {...copy,requestId,taskId,sessionId};\n    if (Buffer.byteLength(JSON.stringify(snapshot)) > 64 * 1024)\n      throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented within 64 KiB.');\n    const answer = new Promise<ApprovalContent>((resolve,reject) => {\n      const abort = () => this.retire(requestId);\n      this.pending.set(requestId,{outcome:'pending',request:snapshot,\n        continuation:{resolve,reject,cleanup:() => signal.removeEventListener('abort',abort)}});\n      signal.addEventListener('abort',abort,{once:true});\n    });\n    this.changed(taskId);\n    return answer;\n  }\n\n  request(id: string): RequestIdentity {\n    const pending = this.pending.get(id);\n    if (pending) return identity(pending.request);\n    const settled = this.settled.get(id);\n    if (!settled) throw unknown();\n    return {...settled.identity};\n  }\n\n  respond(id: string, content: unknown) {\n    const pending = this.pending.get(id);\n    if (!pending) {\n      const settled = this.settled.get(id);\n      if (!settled) throw unknown();\n      if (settled.outcome === 'withdrawn') throw expired();\n      this.validateBoundedContent(content);\n      if (!isDeepStrictEqual(settled.answer,content))\n        throw new AgentError('INVALID_APPROVAL_RESPONSE','This permission request already has a different answer.');\n      return this.receipt(settled.identity);\n    }\n    this.validateBoundedContent(content);\n    const answer = validateApprovalContent(pending.request.requestedSchema,content);\n    const requestIdentity = identity(pending.request);\n    this.pending.delete(id);\n    pending.continuation.cleanup();\n    this.retain({outcome:'answered',identity:requestIdentity,answer:structuredClone(answer)});\n    pending.continuation.resolve(answer);\n    this.changed(requestIdentity.taskId);\n    return this.receipt(requestIdentity);\n  }\n\n  pendingFor(taskId: string): ApprovalRequest[] {\n    return [...this.pending.values()].filter(entry => entry.request.taskId === taskId)\n      .map(entry => structuredClone(entry.request));\n  }\n\n  retireTask(taskId: string) {\n    for (const [id,entry] of this.pending) if (entry.request.taskId === taskId) this.retire(id);\n  }\n\n  close() { for (const id of [...this.pending.keys()]) this.retire(id); }\n\n  private retire(id: string) {\n    const entry = this.pending.get(id);\n    if (!entry) return;\n    const requestIdentity = identity(entry.request);\n    this.pending.delete(id);\n    entry.continuation.cleanup();\n    this.retain({outcome:'withdrawn',identity:requestIdentity});\n    entry.continuation.reject(expired());\n    this.changed(requestIdentity.taskId);\n  }\n\n  private retain(entry: SettledEntry) {\n    this.settled.set(entry.identity.requestId,entry);\n    while (this.settled.size > MAX_SETTLED_REQUESTS) {\n      const oldest = this.settled.keys().next().value;\n      if (oldest !== undefined) this.settled.delete(oldest);\n    }\n  }\n\n  private validateBoundedContent(content: unknown) {\n    let serialized: string | undefined;\n    try { serialized = JSON.stringify(content); } catch { /* Report no submitted data. */ }\n    if (!serialized || Buffer.byteLength(serialized) > 16 * 1024)\n      throw new AgentError('INVALID_APPROVAL_RESPONSE','Approval content must be a JSON object within 16 KiB.');\n  }\n\n  private receipt(request: RequestIdentity) {\n    return {version:1 as const,type:'approval_answered' as const,requestId:request.requestId,\n      taskId:request.taskId,sessionId:request.sessionId};\n  }\n}\n"]}
+{"version":3,"file":"approval-registry.js","sourceRoot":"","sources":["../../src/runtime/approval-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAuBzF,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,iBAAiB,EAAC,qDAAqD,CAAC,CAAC;AAC9G,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,iBAAiB,EAAC,wDAAwD,CAAC,CAAC;AACjH,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAmB,EAAE,CAAC,CAAC;IAC/D,SAAS,EAAC,OAAO,CAAC,SAAS,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,EAAC,SAAS,EAAC,OAAO,CAAC,SAAS;CAC9E,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,OAAO,gBAAgB;IAGE,OAAO;IAF5B,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,YAA6B,OAAiC;uBAAjC,OAAO;IAA6B,CAAC;IAElE,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,SAAiB,EAAE,OAA8B,EAAE,MAAmB;QACnG,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,OAAO,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,EAAE;YACtC,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,yDAAyD,CAAC,CAAC;QACnG,IAAI,IAA2B,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI;gBAAE,MAAM,IAAI,KAAK,EAAE,CAAC;YACjE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAA0B,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,oEAAoE,CAAC,CAAC;QAAC,CAAC;QACxH,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,OAAO,EAAC,YAAY,EAAC,IAAI,EAAC,UAAU,EAAC,SAAS,EAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;YACrJ,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,sDAAsD,CAAC,CAAC;QAChG,sBAAsB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,OAAO,UAAU,EAAE,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAoB,EAAC,GAAG,IAAI,EAAC,SAAS,EAAC,MAAM,EAAC,SAAS,EAAC,CAAC;QACvE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI;YACzD,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,oEAAoE,CAAC,CAAC;QAC9G,IAAI,GAAiC,CAAC;QACtC,IAAI,OAAiC,CAAC;QACtC,IAAI,CAAC;YAAC,MAAM,UAAU,GAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAAC,GAAG,GAAC,UAAU,CAAC,OAAO,CAAC;YAAC,OAAO,GAAC,UAAU,CAAC,OAAO,CAAC;QAAC,CAAC;QACjG,OAAM,KAAK,EAAE,CAAC;YACZ,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;gBAAE,MAAM,KAAK,CAAC;YACnF,GAAG,GAAC,KAAK,CAAC;YAAC,OAAO,GAAC,IAAI,GAAG,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAC,MAAM,EAAE,EAAE;YAC7D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAC,EAAC,OAAO,EAAC,SAAS,EAAC,OAAO,EAAC,QAAQ,EAAC,GAAG,EAAC,OAAO;gBACxE,YAAY,EAAC,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAC,KAAK,CAAC,EAAC,EAAC,CAAC,CAAC;YAC1F,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAC,KAAK,EAAC,EAAC,IAAI,EAAC,IAAI,EAAC,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO;YAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,MAAM,OAAO,EAAE,CAAC;QAC9B,OAAO,EAAC,GAAG,OAAO,CAAC,QAAQ,EAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,OAAgB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO;gBAAE,MAAM,OAAO,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW;gBAAE,MAAM,OAAO,EAAE,CAAC;YACrD,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,MAAsB,CAAC;YAC3B,IAAI,CAAC;gBAAC,MAAM,GAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAC,OAAO,CAAC,CAAC,CAAC;YAAC,CAAC;YACjG,MAAM,CAAC;gBAAC,eAAe,EAAE,CAAC;YAAC,CAAC;YAC5B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAC,MAAM,CAAC;gBAC3C,MAAM,IAAI,UAAU,CAAC,2BAA2B,EAAC,yDAAyD,CAAC,CAAC;YAC9G,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAC,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAC,OAAO,CAAC,CAAC,CAAC;QACnI,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,EAAC,OAAO,EAAC,UAAU,EAAC,QAAQ,EAAC,eAAe,EAAC,MAAM,EAAC,eAAe,CAAC,MAAM,CAAC;YACrF,MAAM,EAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,EAAC,OAAO,EAAC,OAAO,CAAC,OAAO,EAAC,CAAC,CAAC;QACpF,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC;aAC/E,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,MAAc;QAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC;aAC/E,GAAG,CAAC,KAAK,CAAC,EAAE;YACX,IAAI,KAAK,CAAC,GAAG,YAAY,UAAU;gBAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5F,OAAO,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,UAAU,CAAC,EAAU,EAAE,QAAiB;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,MAAM,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW;YAAE,MAAM,OAAO,EAAE,CAAC;QACnD,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,EAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;eACzH,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ;YAAE,eAAe,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,eAAe,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,QAAuC,CAAC;QAC1D,IAAI,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;mBACtE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,CAAC,MAAM;mBACvH,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAAE,eAAe,EAAE,CAAC;YACzF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,EAAC,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAC,CAAC;QAC9E,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAC,QAAQ,CAAC;YAAE,eAAe,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,KAAK,MAAM,CAAC,EAAE,EAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,KAAK,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/D,MAAM,CAAC,EAAU;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAC,OAAO,EAAC,WAAW,EAAC,QAAQ,EAAC,eAAe,EAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAEO,MAAM,CAAC,KAAmB;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAC,KAAK,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAEO,sBAAsB,CAAC,OAAgB;QAC7C,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI;YAC1D,MAAM,IAAI,UAAU,CAAC,2BAA2B,EAAC,uDAAuD,CAAC,CAAC;IAC9G,CAAC;IAEO,OAAO,CAAC,OAAwB;QACtC,OAAO,EAAC,OAAO,EAAC,CAAU,EAAC,IAAI,EAAC,mBAA4B,EAAC,SAAS,EAAC,OAAO,CAAC,SAAS;YACtF,MAAM,EAAC,OAAO,CAAC,MAAM,EAAC,SAAS,EAAC,OAAO,CAAC,SAAS,EAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,eAAe;IACtB,MAAM,IAAI,UAAU,CAAC,2BAA2B,EAAC,6DAA6D,CAAC,CAAC;AAClH,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WACtE,CAAC,MAAM,CAAC,SAAS,EAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,OAAwB;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC;IAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC;IAC5D,IAAI,MAA8C,CAAC;IACnD,IAAI,WAAW,EAAE,IAAI,KAAK,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QAClH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAC,EAAE,EAAC,MAAM,CAAC,KAAK,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC;QACvF,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9D,MAAM,MAAM,GAAmB,EAAC,EAAE,EAAC,OAAO,UAAU,EAAE,EAAE,EAAC,KAAK,EAAC,kBAAkB,KAAK,EAAE,EAAC,QAAQ,EAAC,OAAO,EAAC,KAAK,EAAC,CAAC;YACjH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAC,EAAC,MAAM,EAAC,MAAM,EAAC,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK,EAAC,EAAC,MAAM,EAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAA,EAAE,CAAA,KAAK,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC7D,MAAM,OAAO,GAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ;YACvC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAA,EAAE,CAAA,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3F,IAAI,CAAC,OAAO,EAAE,MAAM;YAAE,aAAa,EAAE,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxD,MAAM,MAAM,GAAmB,QAAQ,CAAC,QAAQ,KAAK,QAAQ;gBAC3D,CAAC,CAAC,EAAC,EAAE,EAAC,OAAO,UAAU,EAAE,EAAE,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK,EAAC,QAAQ,EAAC,QAAQ,EAAC;gBACjE,CAAC,CAAC,EAAC,EAAE,EAAC,OAAO,UAAU,EAAE,EAAE,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK,EAAC,QAAQ,EAAC,QAAQ,CAAC,QAAQ,EAAC,KAAK,EAAC,QAAQ,CAAC,KAAK;oBAC1F,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,WAAW,EAAC,sCAAsC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC;YACrG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAC,EAAC,MAAM,EAAC,MAAM,EAAC,EAAC,QAAQ,EAAC,MAAM,CAAC,KAAK,EAAC,EAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,aAAa,EAAE,CAAC;IACnC,MAAM,MAAM,GAAC,IAAI,GAAG,EAA0B,CAAC;IAC/C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjH,MAAM,KAAK,GAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAC,KAAK,CAAC,CAAC;IAChF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;gBACvF,MAAM,MAAM,GAAC,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClH,OAAO,CAAC,MAAM,GAAC,EAAC,GAAG,OAAO,CAAC,MAAM,EAAC,WAAW,EAAC,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAC,CAAC;YACnI,CAAC;IACD,OAAO,EAAC,OAAO,EAAC,EAAC,EAAE,EAAC,OAAO,CAAC,SAAS,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,EAAC,SAAS,EAAC,OAAO,CAAC,SAAS,EAAC,OAAO,EAAC,OAAO,CAAC,OAAO;YAC7G,OAAO,EAAC,OAAO,CAAC,OAAO,EAAC,OAAO,EAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAA,EAAE,CAAA,KAAK,CAAC,MAAM,CAAC;YAC9E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,EAAC,OAAO,EAAC,CAAC;AACjH,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAC,sDAAsD,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAwB,EAAE,KAAa;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvF,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAC,QAAQ,EAAC,QAAQ,EAAC,CAAC;IAClD,IAAI,CAAC,kBAAkB,EAAC,eAAe,EAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAC,QAAQ,EAAC,OAAO,EAAC,KAAK,EAAC,SAAS,EAAC,CAAC;IAClH,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,EAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,EAAC,SAAS,EAAC,CAAC;IACvE,IAAI,CAAC,QAAQ,EAAC,OAAO,EAAC,YAAY,EAAC,MAAM,EAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAC,QAAQ,EAAC,OAAO,EAAC,KAAK,EAAC,MAAM,EAAC,CAAC;IACjH,IAAI,CAAC,SAAS,EAAC,MAAM,EAAC,QAAQ,EAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,CAAC;IACpG,aAAa,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB,EAAC,MAAsB;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,MAAM,KAAK,GAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;IACrC,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAA,EAAE,CAAA,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA,EAAE,CAAA,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7H,MAAM,QAAQ,GAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,EAAC,GAAG,MAAM,EAAC,MAAM,EAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAA,EAAE,CAAA,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAC,CAAC;AACrE,CAAC","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { isDeepStrictEqual } from 'node:util';\nimport { AgentError } from '../errors.js';\nimport { validateApprovalContent, validateApprovalSchema } from '../approvals/schema.js';\nimport type { ApprovalContent, ApprovalSchema, NativeApprovalRequest } from '../approvals/types.js';\nimport type { ApprovalRequest } from './types.js';\nimport type { ApprovalAction, ApprovalResponse, SdkApprovalRequest } from './task-data.js';\n\ntype RequestIdentity = Pick<ApprovalRequest,'requestId'|'taskId'|'sessionId'>;\ninterface Continuation {\n  resolve(content: ApprovalContent): void;\n  reject(error: AgentError): void;\n  cleanup(): void;\n}\ninterface PendingEntry {\n  outcome: 'pending';\n  request: ApprovalRequest;\n  continuation: Continuation;\n  sdk: SdkApprovalRequest | AgentError;\n  actions: Map<string, ActionMapping>;\n}\ninterface AnsweredEntry { outcome: 'answered'; identity: RequestIdentity; answer: ApprovalContent; schema: ApprovalSchema; actions: Map<string, ActionMapping> }\ninterface WithdrawnEntry { outcome: 'withdrawn'; identity: RequestIdentity }\ntype SettledEntry = AnsweredEntry | WithdrawnEntry;\ninterface ActionMapping { action: ApprovalAction; native: ApprovalContent; grants?: readonly string[] }\n\nconst MAX_SETTLED_REQUESTS = 1_024;\nconst expired = () => new AgentError('REQUEST_EXPIRED','The native permission request is no longer pending.');\nconst unknown = () => new AgentError('UNKNOWN_REQUEST','Permission request is unavailable in this coordinator.');\nconst identity = (request: ApprovalRequest): RequestIdentity => ({\n  requestId:request.requestId,taskId:request.taskId,sessionId:request.sessionId,\n});\n\n/** Retains pending requests and a bounded settlement-ordered outcome history. */\nexport class ApprovalRegistry {\n  private pending = new Map<string,PendingEntry>();\n  private settled = new Map<string,SettledEntry>();\n  constructor(private readonly changed: (taskId: string) => void) {}\n\n  async register(taskId: string, sessionId: string, request: NativeApprovalRequest, signal: AbortSignal): Promise<ApprovalContent> {\n    if (signal.aborted) throw expired();\n    if (this.pendingFor(taskId).length >= 32)\n      throw new AgentError('INPUT_REQUIRED','A task cannot wait on more than 32 permission requests.');\n    let copy: NativeApprovalRequest;\n    try {\n      const serialized = JSON.stringify(request);\n      if (Buffer.byteLength(serialized) > 64 * 1024) throw new Error();\n      copy = JSON.parse(serialized) as NativeApprovalRequest;\n    } catch { throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented within 64 KiB.'); }\n    if (copy.kind !== 'permission' || !['codex','claudeCode','fx','opencode','copilot','cursor'].includes(copy.harness) || typeof copy.message !== 'string')\n      throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented.');\n    validateApprovalSchema(copy.requestedSchema);\n    const requestId = `req_${randomUUID()}`;\n    const snapshot: ApprovalRequest = {...copy,requestId,taskId,sessionId};\n    if (Buffer.byteLength(JSON.stringify(snapshot)) > 64 * 1024)\n      throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented within 64 KiB.');\n    let sdk:SdkApprovalRequest|AgentError;\n    let actions:Map<string,ActionMapping>;\n    try { const normalized=normalize(snapshot); sdk=normalized.request; actions=normalized.actions; }\n    catch(error) {\n      if (!(error instanceof AgentError) || error.code !== 'INPUT_REQUIRED') throw error;\n      sdk=error; actions=new Map();\n    }\n    const answer = new Promise<ApprovalContent>((resolve,reject) => {\n      const abort = () => this.retire(requestId);\n      this.pending.set(requestId,{outcome:'pending',request:snapshot,sdk,actions,\n        continuation:{resolve,reject,cleanup:() => signal.removeEventListener('abort',abort)}});\n      signal.addEventListener('abort',abort,{once:true});\n    });\n    this.changed(taskId);\n    return answer;\n  }\n\n  request(id: string): RequestIdentity {\n    const pending = this.pending.get(id);\n    if (pending) return identity(pending.request);\n    const settled = this.settled.get(id);\n    if (!settled) throw unknown();\n    return {...settled.identity};\n  }\n\n  respond(id: string, content: unknown) {\n    const pending = this.pending.get(id);\n    if (!pending) {\n      const settled = this.settled.get(id);\n      if (!settled) throw unknown();\n      if (settled.outcome === 'withdrawn') throw expired();\n      this.validateBoundedContent(content);\n      let answer:ApprovalContent;\n      try { answer=canonicalBySchema(settled.schema,validateApprovalContent(settled.schema,content)); }\n      catch { invalidResponse(); }\n      if (!isDeepStrictEqual(settled.answer,answer))\n        throw new AgentError('INVALID_APPROVAL_RESPONSE','This permission request already has a different answer.');\n      return this.receipt(settled.identity);\n    }\n    this.validateBoundedContent(content);\n    const answer = canonicalBySchema(pending.request.requestedSchema,validateApprovalContent(pending.request.requestedSchema,content));\n    const requestIdentity = identity(pending.request);\n    this.pending.delete(id);\n    pending.continuation.cleanup();\n    this.retain({outcome:'answered',identity:requestIdentity,answer:structuredClone(answer),\n      schema:structuredClone(pending.request.requestedSchema),actions:pending.actions});\n    pending.continuation.resolve(answer);\n    this.changed(requestIdentity.taskId);\n    return this.receipt(requestIdentity);\n  }\n\n  pendingFor(taskId: string): ApprovalRequest[] {\n    return [...this.pending.values()].filter(entry => entry.request.taskId === taskId)\n      .map(entry => structuredClone(entry.request));\n  }\n\n  sdkPendingFor(taskId: string): SdkApprovalRequest[] {\n    return [...this.pending.values()].filter(entry => entry.request.taskId === taskId)\n      .map(entry => {\n        if (entry.sdk instanceof AgentError) throw new AgentError(entry.sdk.code,entry.sdk.message);\n        return structuredClone(entry.sdk);\n      });\n  }\n\n  respondSdk(id: string, response: unknown) {\n    const entry = this.pending.get(id) ?? this.settled.get(id);\n    if (!entry) throw unknown();\n    if (entry.outcome === 'withdrawn') throw expired();\n    this.validateBoundedContent(response);\n    if (!plain(response) || Reflect.ownKeys(response).some(key => typeof key !== 'string' || !['actionId','grants'].includes(key))\n      || typeof response.actionId !== 'string') invalidResponse();\n    const mapping = entry.actions.get(response.actionId);\n    if (!mapping) invalidResponse();\n    const submitted = response as unknown as ApprovalResponse;\n    let native = structuredClone(mapping.native);\n    if (mapping.grants) {\n      if (mapping.action.decision !== 'allow' || !Array.isArray(submitted.grants)\n        || submitted.grants.some(value => typeof value !== 'string') || new Set(submitted.grants).size !== submitted.grants.length\n        || submitted.grants.some(value => !mapping.grants!.includes(value))) invalidResponse();\n      const selected = new Set(submitted.grants);\n      native = {...native, grants: mapping.grants.filter(id => selected.has(id))};\n    } else if (Object.hasOwn(response,'grants')) invalidResponse();\n    return this.respond(id,native);\n  }\n\n  retireTask(taskId: string) {\n    for (const [id,entry] of this.pending) if (entry.request.taskId === taskId) this.retire(id);\n  }\n\n  close() { for (const id of [...this.pending.keys()]) this.retire(id); }\n\n  private retire(id: string) {\n    const entry = this.pending.get(id);\n    if (!entry) return;\n    const requestIdentity = identity(entry.request);\n    this.pending.delete(id);\n    entry.continuation.cleanup();\n    this.retain({outcome:'withdrawn',identity:requestIdentity});\n    entry.continuation.reject(expired());\n    this.changed(requestIdentity.taskId);\n  }\n\n  private retain(entry: SettledEntry) {\n    this.settled.set(entry.identity.requestId,entry);\n    while (this.settled.size > MAX_SETTLED_REQUESTS) {\n      const oldest = this.settled.keys().next().value;\n      if (oldest !== undefined) this.settled.delete(oldest);\n    }\n  }\n\n  private validateBoundedContent(content: unknown) {\n    let serialized: string | undefined;\n    try { serialized = JSON.stringify(content); } catch { /* Report no submitted data. */ }\n    if (!serialized || Buffer.byteLength(serialized) > 16 * 1024)\n      throw new AgentError('INVALID_APPROVAL_RESPONSE','Approval content must be a JSON object within 16 KiB.');\n  }\n\n  private receipt(request: RequestIdentity) {\n    return {version:1 as const,type:'approval_answered' as const,requestId:request.requestId,\n      taskId:request.taskId,sessionId:request.sessionId};\n  }\n}\n\nfunction invalidResponse(): never {\n  throw new AgentError('INVALID_APPROVAL_RESPONSE','The approval response does not match the requested actions.');\n}\n\nfunction plain(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n    && [Object.prototype,null].includes(Object.getPrototypeOf(value));\n}\n\nfunction normalize(request: ApprovalRequest): {request: SdkApprovalRequest; actions: Map<string,ActionMapping>} {\n  const actions = new Map<string,ActionMapping>();\n  const grantsField = request.requestedSchema.properties.grants;\n  const scopeField = request.requestedSchema.properties.scope;\n  let grants: {id:string;label:string}[] | undefined;\n  if (grantsField?.type === 'array' && grantsField.items.anyOf && scopeField?.type === 'string' && scopeField.oneOf) {\n    grants = grantsField.items.anyOf.map(choice => ({id:choice.const,label:choice.title}));\n    for (const choice of scopeField.oneOf) {\n      const scope = choice.const === 'session' ? 'session' : 'turn';\n      const action: ApprovalAction = {id:`act_${randomUUID()}`,label:`Allow for this ${scope}`,decision:'allow',scope};\n      actions.set(action.id,{action,native:{scope:choice.const},grants:grants.map(grant=>grant.id)});\n    }\n  } else {\n    const decision = request.requestedSchema.properties.decision;\n    const choices=decision?.type === 'string'\n      ? (decision.oneOf ?? decision.enum?.map(value=>({const:value,title:value}))) : undefined;\n    if (!choices?.length) invalidNative();\n    for (const choice of choices) {\n      const metadata = decisionMetadata(request,choice.const);\n      const action: ApprovalAction = metadata.decision === 'cancel'\n        ? {id:`act_${randomUUID()}`,label:choice.title,decision:'cancel'}\n        : {id:`act_${randomUUID()}`,label:choice.title,decision:metadata.decision,scope:metadata.scope,\n            ...(metadata.scope === 'session' ? {description:'Applies to this native conversation.'} : {})};\n      actions.set(action.id,{action,native:{decision:choice.const}});\n    }\n  }\n  if (!actions.size) invalidNative();\n  const groups=new Map<string,ActionMapping[]>();\n  for (const mapping of actions.values()) {\n    const key=mapping.action.decision === 'cancel' ? 'cancel' : `${mapping.action.decision}:${mapping.action.scope}`;\n    const group=groups.get(key) ?? []; group.push(mapping); groups.set(key,group);\n  }\n  for (const group of groups.values()) if (group.length > 1) for (const mapping of group) {\n    const native=typeof mapping.native.decision === 'string' ? mapping.native.decision : String(mapping.native.scope);\n    mapping.action={...mapping.action,description:[mapping.action.description,`Native option: ${native}`].filter(Boolean).join(' ')};\n  }\n  return {request:{id:request.requestId,taskId:request.taskId,sessionId:request.sessionId,harness:request.harness,\n    message:request.message,actions:[...actions.values()].map(value=>value.action),\n    ...(grants ? {grants} : {}),...(request.context ? {context:structuredClone(request.context)} : {})},actions};\n}\n\nfunction invalidNative(): never {\n  throw new AgentError('INPUT_REQUIRED','The native permission request cannot be represented.');\n}\n\nfunction decisionMetadata(request: ApprovalRequest, value: string): {decision:'allow'|'deny';scope:'once'|'session'} | {decision:'cancel'} {\n  const options = Array.isArray(request.context?.options) ? request.context.options : [];\n  const offered = options.find(option => plain(option) && (option.optionId === value));\n  const kind = plain(offered) && typeof offered.kind === 'string' ? offered.kind : value;\n  if (kind === 'cancel') return {decision:'cancel'};\n  if (['acceptForSession','allow_session','allow_always'].includes(kind)) return {decision:'allow',scope:'session'};\n  if (kind === 'reject_always') return {decision:'deny',scope:'session'};\n  if (['accept','allow','allow_once','once','approve-once'].includes(kind)) return {decision:'allow',scope:'once'};\n  if (['decline','deny','reject','reject_once'].includes(kind)) return {decision:'deny',scope:'once'};\n  invalidNative();\n}\n\nfunction canonicalBySchema(schema:ApprovalSchema,answer:ApprovalContent):ApprovalContent {\n  if (!Array.isArray(answer.grants)) return answer;\n  const field=schema.properties.grants;\n  if (field?.type !== 'array') return answer;\n  const order=(field.items.anyOf ?? field.items.enum?.map(value=>({const:value,title:value})) ?? []).map(choice=>choice.const);\n  const selected=new Set(answer.grants);\n  return {...answer,grants:order.filter(value=>selected.has(value))};\n}\n"]}

package/dist/runtime/capture.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessConfig } from '../sdk/types.js';
+import type { CatalogEnvironment } from './catalog.js';
+import type { ExecutionReference, PreparedExecution } from './types.js';
+export interface CapturedChild {
+    readonly name: string;
+    readonly description: string;
+}
+export interface CapturedExecution {
+    readonly reference: ExecutionReference;
+    readonly prepared: PreparedExecution;
+    readonly children: readonly CapturedChild[];
+    child(name: string): Promise<CapturedExecution>;
+}
+interface CaptureOptions {
+    workerModule?: URL;
+    shutdownTimeoutMs?: number;
+}
+export declare function captureExecution(agent: string | HarnessConfig, input: CatalogEnvironment, options?: CaptureOptions): Promise<CapturedExecution>;
+/** Captures an already resolved private CLI reference without applying public connected validation. */
+export declare function captureReference(reference: ExecutionReference, input: CatalogEnvironment, options?: CaptureOptions): Promise<CapturedExecution>;
+export declare function checkCapturedExecution(captured: CapturedExecution, input: CatalogEnvironment): Promise<void>;
+export {};

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