@ai-agent-forge/agent-forge 0.85.0

package/dist/core/embedded-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-sdk.d.ts","sourceRoot":"","sources":["../../src/core/embedded-sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype AgentCapabilityContractV1,\n\ttype AgentDefinitionSnapshotV1,\n\ttype AgentInstanceSnapshotV1,\n\tbuildAgentCapabilityContractV1,\n\tbuildAgentDefinitionSnapshotV1,\n\tbuildAgentInstanceSnapshotV1,\n\tbuildErrorEnvelopeV1,\n\tbuildEventEnvelopeV1,\n\tbuildOperationSnapshotV1,\n\tbuildSessionSnapshotV1,\n\ttype ErrorEnvelopeV1,\n\ttype EventEnvelopeV1,\n\ttype HostContextV1,\n\ttype JsonValue,\n\ttype OperationSnapshotV1,\n\ttype SessionRevisionV1,\n\ttype SessionSnapshotV1,\n} from \"./agent-capability-contract.ts\";\nimport { createAgentCompositionRuntime } from \"./extensions/agent-composition.ts\";\nimport {\n\tOPERATION_CANCEL_EVENT_ID,\n\tOPERATION_END_EVENT_ID,\n\tOPERATION_START_EVENT_ID,\n\tvalidateOperationCancelEventDataV1,\n\tvalidateOperationEndEventDataV1,\n\tvalidateOperationStartEventDataV1,\n} from \"./extensions/lifecycle-catalog.ts\";\nimport type {\n\tAgentCompositionAPI,\n\tAgentCompositionDefinitionBinding,\n\tAgentContextCommitRequestV1,\n\tAgentContextFacadeV1,\n\tAgentControllerLease,\n\tAgentDefinition,\n\tAgentInstance,\n\tAgentInstanceResult,\n\tOperationHandle,\n\tPromptOutcome,\n\tSessionAPI,\n} from \"./extensions/public-api.ts\";\n\n/**\n * An in-process binding over AgentComposition. It intentionally excludes the\n * transitional AgentSession command surface and every remote transport concern.\n */\nexport interface EmbeddedSdkBindingV1 {\n\treadonly version: 1;\n\treadonly contract: AgentCapabilityContractV1;\n\treadonly hostContext: HostContextV1;\n\t/** Optional session-backed facade supplied by an in-process host. */\n\treadonly session?: EmbeddedSessionBindingV1;\n\tdefine<TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: AgentDefinition<TInput, TResult>,\n\t): EmbeddedAgentDefinitionV1<TInput, TResult>;\n\tcreate<TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t\toptions?: { readonly id?: string; readonly parentInstanceId?: string },\n\t): EmbeddedAgentInstanceV1<TInput, TResult>;\n\tlistInstances(): readonly AgentInstanceSnapshotV1[];\n\tsubscribe(listener: EmbeddedSdkEventListenerV1): EmbeddedSdkSubscriptionV1;\n\tdispose(): Promise<void>;\n}\n\nexport interface EmbeddedSdkOptionsV1 {\n\treadonly composition?: AgentCompositionAPI;\n\t/** Optional host session to expose through the stable in-process facade. */\n\treadonly session?: SessionAPI;\n\t/** Whether this binding owns and may remove definitions from the supplied composition. */\n\treadonly ownsComposition?: boolean;\n\treadonly mode?: HostContextV1[\"mode\"];\n\treadonly features?: readonly string[];\n\treadonly clock?: () => number;\n\treadonly idFactory?: (kind: \"event\" | \"delivery\", sequence: number) => string;\n}\n\n/** Stable, detached session projection used by embedded and future service bindings. */\nexport interface EmbeddedSessionBindingV1 {\n\treadonly version: 1;\n\tgetSessionId(): string;\n\tgetRevision(): SessionRevisionV1;\n\tsnapshot(): SessionSnapshotV1;\n\tgetMessages(): readonly unknown[];\n\tgetBranchEntries(): readonly unknown[];\n\tisIdle(): boolean;\n\tprompt(text: string): Promise<PromptOutcome>;\n\tsteer(text: string): Promise<void>;\n\tabort(): Promise<void>;\n\twaitForIdle(): Promise<void>;\n\treadonly context?: AgentContextFacadeV1;\n}\n\nexport interface EmbeddedAgentDefinitionV1<_TInput extends JsonValue, _TResult extends JsonValue> {\n\treadonly snapshot: AgentDefinitionSnapshotV1;\n}\n\nexport interface EmbeddedControllerLeaseV1 {\n\treadonly id: string;\n\treadonly instanceId: string;\n\treadonly owner: string;\n\treadonly revision: number;\n\tisActive(): boolean;\n\trelease(): Promise<void>;\n}\n\nexport interface EmbeddedOperationHandleV1<TResult extends JsonValue> {\n\treadonly id: string;\n\treadonly result: Promise<TResult>;\n\tsnapshot(): OperationSnapshotV1;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface EmbeddedAgentInstanceV1<TInput extends JsonValue, TResult extends JsonValue> {\n\treadonly id: string;\n\tsnapshot(): AgentInstanceSnapshotV1;\n\tacquireControllerLease(owner?: string): Promise<EmbeddedControllerLeaseV1>;\n\trun(\n\t\tinput: TInput,\n\t\toptions: { readonly lease: EmbeddedControllerLeaseV1; readonly signal?: AbortSignal },\n\t): EmbeddedOperationHandleV1<TResult>;\n\twait(): Promise<EmbeddedAgentResultV1<TResult>>;\n\tcancel(reason?: string): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nexport type EmbeddedAgentResultV1<TResult extends JsonValue> =\n\t| { readonly status: \"succeeded\"; readonly output: TResult; readonly revision: number }\n\t| {\n\t\t\treadonly status: \"failed\" | \"cancelled\" | \"disposed\";\n\t\t\treadonly error?: ErrorEnvelopeV1;\n\t\t\treadonly revision: number;\n\t  };\n\nexport type EmbeddedSdkEventListenerV1 = (event: EventEnvelopeV1) => void;\n\nexport interface EmbeddedSdkSubscriptionV1 {\n\treadonly id: string;\n\tdispose(): void;\n}\n\nfunction detachedFreeze<T>(value: T, seen = new WeakMap<object, unknown>()): T {\n\tif (value === null || typeof value !== \"object\") return value;\n\tconst existing = seen.get(value);\n\tif (existing !== undefined) return existing as T;\n\tif (Array.isArray(value)) {\n\t\tconst copy: unknown[] = [];\n\t\tseen.set(value, copy);\n\t\tfor (const child of value) copy.push(detachedFreeze(child, seen));\n\t\treturn Object.freeze(copy) as T;\n\t}\n\tconst copy: Record<string, unknown> = Object.create(null) as Record<string, unknown>;\n\tseen.set(value, copy);\n\tfor (const [key, child] of Object.entries(value as Record<string, unknown>)) copy[key] = detachedFreeze(child, seen);\n\treturn Object.freeze(copy) as T;\n}\n\nfunction assertActive(disposed: boolean, label: string): void {\n\tif (disposed) throw new Error(`Embedded SDK binding is disposed: ${label}`);\n}\n\nfunction errorEnvelope(error: unknown, code: string): ErrorEnvelopeV1 {\n\tconst message = error instanceof Error ? error.message : String(error);\n\treturn buildErrorEnvelopeV1({\n\t\tversion: 1,\n\t\tcode,\n\t\tmessage,\n\t\tretryable: false,\n\t\t...(error instanceof Error ? { name: error.name } : {}),\n\t});\n}\n\nfunction agentDefinitionSnapshot<TInput extends JsonValue, TResult extends JsonValue>(\n\tdefinition: AgentDefinition<TInput, TResult>,\n): AgentDefinitionSnapshotV1 {\n\treturn buildAgentDefinitionSnapshotV1({\n\t\tversion: 1,\n\t\tid: definition.id,\n\t\tdefinitionVersion: definition.version,\n\t\trole: definition.role,\n\t\tcapabilities: [],\n\t\t...(definition.owner === undefined ? {} : { owner: definition.owner }),\n\t});\n}\n\nfunction agentInstanceSnapshot(\n\tsnapshot: ReturnType<AgentInstance<unknown, unknown>[\"snapshot\"]>,\n): AgentInstanceSnapshotV1 {\n\treturn buildAgentInstanceSnapshotV1({\n\t\tversion: 1,\n\t\tid: snapshot.id,\n\t\tdefinitionId: snapshot.definitionId,\n\t\tdefinitionVersion: snapshot.definitionVersion,\n\t\trole: snapshot.role,\n\t\tstatus: snapshot.status,\n\t\trevision: snapshot.revision,\n\t\t...(snapshot.parentInstanceId === undefined ? {} : { parentInstanceId: snapshot.parentInstanceId }),\n\t\t...(snapshot.leaseOwner === undefined ? {} : { leaseOwner: snapshot.leaseOwner }),\n\t});\n}\n\nfunction operationStatus(status: ReturnType<OperationHandle<unknown>[\"status\"]>): OperationSnapshotV1[\"status\"] {\n\treturn status;\n}\n\nfunction resultSnapshot<TResult extends JsonValue>(\n\tresult: AgentInstanceResult<TResult>,\n): EmbeddedAgentResultV1<TResult> {\n\tif (result.status === \"succeeded\") {\n\t\treturn detachedFreeze({\n\t\t\tstatus: \"succeeded\" as const,\n\t\t\toutput: canonicalOutput(result.output as TResult, `wait:${result.revision}`),\n\t\t\trevision: result.revision,\n\t\t});\n\t}\n\treturn detachedFreeze({\n\t\tstatus: result.status,\n\t\trevision: result.revision,\n\t\t...(result.error === undefined ? {} : { error: errorEnvelope(result.error, `agent_${result.status}`) }),\n\t});\n}\n\nfunction canonicalOutput<TResult extends JsonValue>(value: TResult, operationId: string): TResult {\n\tbuildOperationSnapshotV1({\n\t\tversion: 1,\n\t\toperationId,\n\t\tkind: \"agent.run\",\n\t\tstatus: \"succeeded\",\n\t\tterminal: { version: 1, status: \"succeeded\", result: value },\n\t});\n\treturn detachedFreeze(value);\n}\n\nfunction canonicalInput<TInput extends JsonValue>(value: TInput): TInput {\n\tif (value === undefined) throw new Error(\"Embedded SDK run input must be JSON-compatible\");\n\tbuildOperationSnapshotV1({\n\t\tversion: 1,\n\t\toperationId: \"embedded-sdk:input\",\n\t\tkind: \"agent.run\",\n\t\tstatus: \"succeeded\",\n\t\tterminal: { version: 1, status: \"succeeded\", result: value },\n\t});\n\treturn detachedFreeze(value);\n}\n\nfunction createEmbeddedSessionBindingV1(session: SessionAPI): EmbeddedSessionBindingV1 {\n\tif (!session.getRevision) throw new Error(\"Embedded SDK session requires revision support\");\n\tconst getRevision = (): SessionRevisionV1 => detachedFreeze(session.getRevision!());\n\tconst context =\n\t\tsession.getContextSnapshot && session.commitContext\n\t\t\t? Object.freeze({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tget: <TValue = unknown>() => detachedFreeze(session.getContextSnapshot!<TValue>()),\n\t\t\t\t\tcommit: <TValue = unknown>(request: AgentContextCommitRequestV1<TValue>) =>\n\t\t\t\t\t\tsession.commitContext!(request),\n\t\t\t\t})\n\t\t\t: undefined;\n\treturn Object.freeze({\n\t\tversion: 1 as const,\n\t\tgetSessionId: () => session.getSessionId(),\n\t\tgetRevision,\n\t\tsnapshot: () =>\n\t\t\tbuildSessionSnapshotV1({ version: 1, sessionId: session.getSessionId(), revision: getRevision() }),\n\t\tgetMessages: () => detachedFreeze(session.getMessages()),\n\t\tgetBranchEntries: () => detachedFreeze(session.getBranchEntries()),\n\t\tisIdle: () => session.isIdle(),\n\t\tprompt: (text: string) => session.prompt(text),\n\t\tsteer: (text: string) =>\n\t\t\tsession.steer ? session.steer(text) : Promise.reject(new Error(\"Embedded SDK session does not support steer\")),\n\t\tabort: () => session.abort(),\n\t\twaitForIdle: () => session.waitForIdle(),\n\t\t...(context === undefined ? {} : { context }),\n\t});\n}\n\nexport function createEmbeddedSdkBindingV1(options: EmbeddedSdkOptionsV1 = {}): EmbeddedSdkBindingV1 {\n\tconst composition = options.composition ?? createAgentCompositionRuntime();\n\tconst ownsComposition = options.ownsComposition ?? options.composition === undefined;\n\tconst defaultFeatures = [\n\t\t\"agent-composition-v1\",\n\t\t...(options.session === undefined ? [] : [\"session\", \"session-revision-v1\", \"context\"]),\n\t];\n\tconst hostContext = detachedFreeze({\n\t\tmode: options.mode ?? \"full-control\",\n\t\tfeatures: [...(options.features ?? defaultFeatures)].sort(),\n\t\ttransports: [\"in-process\"] as const,\n\t}) as HostContextV1;\n\tconst session = options.session === undefined ? undefined : createEmbeddedSessionBindingV1(options.session);\n\tconst contract = buildAgentCapabilityContractV1({\n\t\tcontractId: \"agent-forge/agent-capability-contract\",\n\t\tcapabilities: [],\n\t\thostContext,\n\t});\n\tconst definitions = new Map<string, AgentDefinition<JsonValue, JsonValue>>();\n\tconst instances = new Map<string, EmbeddedAgentInstanceV1<JsonValue, JsonValue>>();\n\tconst listeners = new Map<string, EmbeddedSdkEventListenerV1>();\n\tlet sequence = 0;\n\tlet disposePromise: Promise<void> | undefined;\n\tlet disposed = false;\n\n\tconst nextId = (kind: \"event\" | \"delivery\"): string => {\n\t\tsequence += 1;\n\t\treturn options.idFactory?.(kind, sequence) ?? `embedded-sdk:${kind}:${sequence}`;\n\t};\n\tconst emit = (type: string, data: JsonValue, operationId?: string): void => {\n\t\tconst event = buildEventEnvelopeV1({\n\t\t\tid: nextId(\"event\"),\n\t\t\tdeliveryId: nextId(\"delivery\"),\n\t\t\ttype,\n\t\t\tsource: \"embedded-sdk\",\n\t\t\ttimestamp: options.clock?.() ?? 0,\n\t\t\tcategory:\n\t\t\t\ttype === OPERATION_START_EVENT_ID || type === OPERATION_CANCEL_EVENT_ID || type === OPERATION_END_EVENT_ID\n\t\t\t\t\t? \"authoritative\"\n\t\t\t\t\t: \"observation\",\n\t\t\tdeliveryGuarantee: \"best-effort\",\n\t\t\tdata,\n\t\t\t...(operationId === undefined ? {} : { operationId, correlationId: operationId }),\n\t\t});\n\t\tfor (const listener of listeners.values()) {\n\t\t\ttry {\n\t\t\t\tlistener(event);\n\t\t\t} catch {\n\t\t\t\t// Observers must not affect an Agent operation.\n\t\t\t}\n\t\t}\n\t};\n\tconst resolveDefinition = <TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t): AgentDefinition<TInput, TResult> => {\n\t\tconst snapshot = \"snapshot\" in definition ? definition.snapshot : definition;\n\t\tconst definitionVersion = (\n\t\t\t\"definitionVersion\" in snapshot ? snapshot.definitionVersion : snapshot.version\n\t\t) as number;\n\t\tconst resolved = definitions.get(`${snapshot.id}@${definitionVersion}`);\n\t\tif (resolved) return resolved as AgentDefinition<TInput, TResult>;\n\t\tif (options.composition !== undefined) {\n\t\t\treturn composition.get<TInput, TResult>(snapshot.id, definitionVersion);\n\t\t}\n\t\tthrow new Error(`Embedded SDK has no defined Agent: ${snapshot.id}@${definitionVersion}`);\n\t};\n\n\tconst binding: EmbeddedSdkBindingV1 = {\n\t\tversion: 1,\n\t\tcontract,\n\t\thostContext,\n\t\t...(session === undefined ? {} : { session }),\n\t\tdefine<TInput extends JsonValue, TResult extends JsonValue>(definition: AgentDefinition<TInput, TResult>) {\n\t\t\tassertActive(disposed, \"define\");\n\t\t\tconst registered = composition.define(definition);\n\t\t\tdefinitions.set(`${registered.id}@${registered.version}`, registered as AgentDefinition<JsonValue, JsonValue>);\n\t\t\treturn detachedFreeze({ snapshot: agentDefinitionSnapshot(registered) });\n\t\t},\n\t\tcreate<TInput extends JsonValue, TResult extends JsonValue>(\n\t\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t\t\tinstanceOptions: { readonly id?: string; readonly parentInstanceId?: string } = {},\n\t\t) {\n\t\t\tassertActive(disposed, \"create\");\n\t\t\tconst raw = composition.create(resolveDefinition(definition), instanceOptions);\n\t\t\tlet instanceDisposed = false;\n\t\t\tlet instanceDisposePromise: Promise<void> | undefined;\n\t\t\tconst leases = new WeakMap<EmbeddedControllerLeaseV1, AgentControllerLease>();\n\t\t\tconst wrapper: EmbeddedAgentInstanceV1<TInput, TResult> = {\n\t\t\t\tid: raw.id,\n\t\t\t\tsnapshot: () => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\treturn agentInstanceSnapshot(raw.snapshot());\n\t\t\t\t},\n\t\t\t\tacquireControllerLease: async (owner?: string) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tconst lease = await raw.acquireControllerLease(owner);\n\t\t\t\t\tconst projected: EmbeddedControllerLeaseV1 = Object.freeze({\n\t\t\t\t\t\tid: lease.id,\n\t\t\t\t\t\tinstanceId: lease.instanceId,\n\t\t\t\t\t\towner: lease.owner,\n\t\t\t\t\t\trevision: lease.revision,\n\t\t\t\t\t\tisActive: () => !disposed && !instanceDisposed && lease.isActive(),\n\t\t\t\t\t\trelease: async () => {\n\t\t\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\t\t\tawait lease.release();\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\tleases.set(projected, lease);\n\t\t\t\t\treturn projected;\n\t\t\t\t},\n\t\t\t\trun: (input, runOptions) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tconst lease = leases.get(runOptions.lease);\n\t\t\t\t\tif (!lease) throw new Error(`Embedded SDK lease does not belong to Agent instance: ${raw.id}`);\n\t\t\t\t\tconst operation = raw.run(canonicalInput(input), { lease, signal: runOptions.signal });\n\t\t\t\t\tlet terminal: OperationSnapshotV1[\"terminal\"];\n\t\t\t\t\tlet cancelEmitted = false;\n\t\t\t\t\tconst reportCancel = () => {\n\t\t\t\t\t\tif (cancelEmitted) return;\n\t\t\t\t\t\tcancelEmitted = true;\n\t\t\t\t\t\temit(\n\t\t\t\t\t\t\tOPERATION_CANCEL_EVENT_ID,\n\t\t\t\t\t\t\tvalidateOperationCancelEventDataV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t);\n\t\t\t\t\t};\n\t\t\t\t\toperation.signal.addEventListener(\"abort\", reportCancel, { once: true });\n\t\t\t\t\tif (operation.signal.aborted) reportCancel();\n\t\t\t\t\tif (!runOptions.signal?.aborted) {\n\t\t\t\t\t\temit(\n\t\t\t\t\t\t\tOPERATION_START_EVENT_ID,\n\t\t\t\t\t\t\tvalidateOperationStartEventDataV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst result = operation.result.then(\n\t\t\t\t\t\t(value: TResult) => {\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tconst output = canonicalOutput(value, operation.id);\n\t\t\t\t\t\t\t\tterminal = { version: 1, status: \"succeeded\", result: output };\n\t\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\t\tstatus: \"succeeded\",\n\t\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn output;\n\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\tterminal = {\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\t\terror: errorEnvelope(error, \"agent_invalid_result\"),\n\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t\t(error: unknown) => {\n\t\t\t\t\t\t\tconst status = operation.status() === \"cancelled\" ? \"cancelled\" : \"failed\";\n\t\t\t\t\t\t\tterminal = { version: 1, status, error: errorEnvelope(error, `agent_${status}`) };\n\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\tstatus,\n\t\t\t\t\t\t\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t},\n\t\t\t\t\t);\n\t\t\t\t\treturn Object.freeze({\n\t\t\t\t\t\tid: operation.id,\n\t\t\t\t\t\tresult,\n\t\t\t\t\t\tsnapshot: () =>\n\t\t\t\t\t\t\tbuildOperationSnapshotV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\tkind: \"agent.run\",\n\t\t\t\t\t\t\t\tstatus: terminal?.status ?? operationStatus(operation.status()),\n\t\t\t\t\t\t\t\t...(terminal === undefined && operation.status() === \"cancelled\"\n\t\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\t\tterminal: {\n\t\t\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\t\t\tstatus: \"cancelled\",\n\t\t\t\t\t\t\t\t\t\t\t\terror: errorEnvelope(new Error(\"Operation cancelled\"), \"agent_cancelled\"),\n\t\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t: terminal === undefined\n\t\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t\t: { terminal }),\n\t\t\t\t\t\t\t\tinstanceId: raw.id,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\tcancel: async (reason?: string) => {\n\t\t\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\t\t\tif (operation.status() !== \"queued\" && operation.status() !== \"running\") return;\n\t\t\t\t\t\t\tawait operation.cancel(reason);\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\twait: async () => detachedFreeze(resultSnapshot(await raw.wait())),\n\t\t\t\tcancel: async (reason?: string) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tawait raw.cancel(reason);\n\t\t\t\t},\n\t\t\t\tdispose: async () => {\n\t\t\t\t\tinstanceDisposePromise ??= (async () => {\n\t\t\t\t\t\tif (!instanceDisposed) {\n\t\t\t\t\t\t\tinstanceDisposed = true;\n\t\t\t\t\t\t\tawait raw.dispose();\n\t\t\t\t\t\t\tinstances.delete(raw.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t})();\n\t\t\t\t\treturn instanceDisposePromise;\n\t\t\t\t},\n\t\t\t};\n\t\t\tinstances.set(raw.id, wrapper as EmbeddedAgentInstanceV1<JsonValue, JsonValue>);\n\t\t\treturn Object.freeze(wrapper);\n\t\t},\n\t\tlistInstances: () =>\n\t\t\tObject.freeze(\n\t\t\t\t[...instances.values()]\n\t\t\t\t\t.map((instance) => instance.snapshot())\n\t\t\t\t\t.sort((left, right) => left.id.localeCompare(right.id)),\n\t\t\t),\n\t\tsubscribe(listener: EmbeddedSdkEventListenerV1) {\n\t\t\tassertActive(disposed, \"subscribe\");\n\t\t\tconst id = `embedded-sdk:subscription:${++sequence}`;\n\t\t\tlet released = false;\n\t\t\tlisteners.set(id, listener);\n\t\t\treturn Object.freeze({\n\t\t\t\tid,\n\t\t\t\tdispose: () => {\n\t\t\t\t\tif (released) return;\n\t\t\t\t\treleased = true;\n\t\t\t\t\tlisteners.delete(id);\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tif (disposed) return;\n\t\t\t\tdisposed = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\tfor (const instance of [...instances.values()]) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait instance.dispose();\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlisteners.clear();\n\t\t\t\tif (ownsComposition && \"disposeDefinitions\" in composition) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\t(composition as AgentCompositionDefinitionBinding).disposeDefinitions([...definitions.values()]);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tdefinitions.clear();\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Embedded SDK disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n\treturn Object.freeze(binding);\n}\n\nexport const createEmbeddedSdkBinding = createEmbeddedSdkBindingV1;\n"]}

package/dist/core/embedded-sdk.js

@@ -0,0 +1,395 @@
+import { buildAgentCapabilityContractV1, buildAgentDefinitionSnapshotV1, buildAgentInstanceSnapshotV1, buildErrorEnvelopeV1, buildEventEnvelopeV1, buildOperationSnapshotV1, buildSessionSnapshotV1, } from "./agent-capability-contract.js";
+import { createAgentCompositionRuntime } from "./extensions/agent-composition.js";
+import { OPERATION_CANCEL_EVENT_ID, OPERATION_END_EVENT_ID, OPERATION_START_EVENT_ID, validateOperationCancelEventDataV1, validateOperationEndEventDataV1, validateOperationStartEventDataV1, } from "./extensions/lifecycle-catalog.js";
+function detachedFreeze(value, seen = new WeakMap()) {
+    if (value === null || typeof value !== "object")
+        return value;
+    const existing = seen.get(value);
+    if (existing !== undefined)
+        return existing;
+    if (Array.isArray(value)) {
+        const copy = [];
+        seen.set(value, copy);
+        for (const child of value)
+            copy.push(detachedFreeze(child, seen));
+        return Object.freeze(copy);
+    }
+    const copy = Object.create(null);
+    seen.set(value, copy);
+    for (const [key, child] of Object.entries(value))
+        copy[key] = detachedFreeze(child, seen);
+    return Object.freeze(copy);
+}
+function assertActive(disposed, label) {
+    if (disposed)
+        throw new Error(`Embedded SDK binding is disposed: ${label}`);
+}
+function errorEnvelope(error, code) {
+    const message = error instanceof Error ? error.message : String(error);
+    return buildErrorEnvelopeV1({
+        version: 1,
+        code,
+        message,
+        retryable: false,
+        ...(error instanceof Error ? { name: error.name } : {}),
+    });
+}
+function agentDefinitionSnapshot(definition) {
+    return buildAgentDefinitionSnapshotV1({
+        version: 1,
+        id: definition.id,
+        definitionVersion: definition.version,
+        role: definition.role,
+        capabilities: [],
+        ...(definition.owner === undefined ? {} : { owner: definition.owner }),
+    });
+}
+function agentInstanceSnapshot(snapshot) {
+    return buildAgentInstanceSnapshotV1({
+        version: 1,
+        id: snapshot.id,
+        definitionId: snapshot.definitionId,
+        definitionVersion: snapshot.definitionVersion,
+        role: snapshot.role,
+        status: snapshot.status,
+        revision: snapshot.revision,
+        ...(snapshot.parentInstanceId === undefined ? {} : { parentInstanceId: snapshot.parentInstanceId }),
+        ...(snapshot.leaseOwner === undefined ? {} : { leaseOwner: snapshot.leaseOwner }),
+    });
+}
+function operationStatus(status) {
+    return status;
+}
+function resultSnapshot(result) {
+    if (result.status === "succeeded") {
+        return detachedFreeze({
+            status: "succeeded",
+            output: canonicalOutput(result.output, `wait:${result.revision}`),
+            revision: result.revision,
+        });
+    }
+    return detachedFreeze({
+        status: result.status,
+        revision: result.revision,
+        ...(result.error === undefined ? {} : { error: errorEnvelope(result.error, `agent_${result.status}`) }),
+    });
+}
+function canonicalOutput(value, operationId) {
+    buildOperationSnapshotV1({
+        version: 1,
+        operationId,
+        kind: "agent.run",
+        status: "succeeded",
+        terminal: { version: 1, status: "succeeded", result: value },
+    });
+    return detachedFreeze(value);
+}
+function canonicalInput(value) {
+    if (value === undefined)
+        throw new Error("Embedded SDK run input must be JSON-compatible");
+    buildOperationSnapshotV1({
+        version: 1,
+        operationId: "embedded-sdk:input",
+        kind: "agent.run",
+        status: "succeeded",
+        terminal: { version: 1, status: "succeeded", result: value },
+    });
+    return detachedFreeze(value);
+}
+function createEmbeddedSessionBindingV1(session) {
+    if (!session.getRevision)
+        throw new Error("Embedded SDK session requires revision support");
+    const getRevision = () => detachedFreeze(session.getRevision());
+    const context = session.getContextSnapshot && session.commitContext
+        ? Object.freeze({
+            version: 1,
+            get: () => detachedFreeze(session.getContextSnapshot()),
+            commit: (request) => session.commitContext(request),
+        })
+        : undefined;
+    return Object.freeze({
+        version: 1,
+        getSessionId: () => session.getSessionId(),
+        getRevision,
+        snapshot: () => buildSessionSnapshotV1({ version: 1, sessionId: session.getSessionId(), revision: getRevision() }),
+        getMessages: () => detachedFreeze(session.getMessages()),
+        getBranchEntries: () => detachedFreeze(session.getBranchEntries()),
+        isIdle: () => session.isIdle(),
+        prompt: (text) => session.prompt(text),
+        steer: (text) => session.steer ? session.steer(text) : Promise.reject(new Error("Embedded SDK session does not support steer")),
+        abort: () => session.abort(),
+        waitForIdle: () => session.waitForIdle(),
+        ...(context === undefined ? {} : { context }),
+    });
+}
+export function createEmbeddedSdkBindingV1(options = {}) {
+    const composition = options.composition ?? createAgentCompositionRuntime();
+    const ownsComposition = options.ownsComposition ?? options.composition === undefined;
+    const defaultFeatures = [
+        "agent-composition-v1",
+        ...(options.session === undefined ? [] : ["session", "session-revision-v1", "context"]),
+    ];
+    const hostContext = detachedFreeze({
+        mode: options.mode ?? "full-control",
+        features: [...(options.features ?? defaultFeatures)].sort(),
+        transports: ["in-process"],
+    });
+    const session = options.session === undefined ? undefined : createEmbeddedSessionBindingV1(options.session);
+    const contract = buildAgentCapabilityContractV1({
+        contractId: "agent-forge/agent-capability-contract",
+        capabilities: [],
+        hostContext,
+    });
+    const definitions = new Map();
+    const instances = new Map();
+    const listeners = new Map();
+    let sequence = 0;
+    let disposePromise;
+    let disposed = false;
+    const nextId = (kind) => {
+        sequence += 1;
+        return options.idFactory?.(kind, sequence) ?? `embedded-sdk:${kind}:${sequence}`;
+    };
+    const emit = (type, data, operationId) => {
+        const event = buildEventEnvelopeV1({
+            id: nextId("event"),
+            deliveryId: nextId("delivery"),
+            type,
+            source: "embedded-sdk",
+            timestamp: options.clock?.() ?? 0,
+            category: type === OPERATION_START_EVENT_ID || type === OPERATION_CANCEL_EVENT_ID || type === OPERATION_END_EVENT_ID
+                ? "authoritative"
+                : "observation",
+            deliveryGuarantee: "best-effort",
+            data,
+            ...(operationId === undefined ? {} : { operationId, correlationId: operationId }),
+        });
+        for (const listener of listeners.values()) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Observers must not affect an Agent operation.
+            }
+        }
+    };
+    const resolveDefinition = (definition) => {
+        const snapshot = "snapshot" in definition ? definition.snapshot : definition;
+        const definitionVersion = ("definitionVersion" in snapshot ? snapshot.definitionVersion : snapshot.version);
+        const resolved = definitions.get(`${snapshot.id}@${definitionVersion}`);
+        if (resolved)
+            return resolved;
+        if (options.composition !== undefined) {
+            return composition.get(snapshot.id, definitionVersion);
+        }
+        throw new Error(`Embedded SDK has no defined Agent: ${snapshot.id}@${definitionVersion}`);
+    };
+    const binding = {
+        version: 1,
+        contract,
+        hostContext,
+        ...(session === undefined ? {} : { session }),
+        define(definition) {
+            assertActive(disposed, "define");
+            const registered = composition.define(definition);
+            definitions.set(`${registered.id}@${registered.version}`, registered);
+            return detachedFreeze({ snapshot: agentDefinitionSnapshot(registered) });
+        },
+        create(definition, instanceOptions = {}) {
+            assertActive(disposed, "create");
+            const raw = composition.create(resolveDefinition(definition), instanceOptions);
+            let instanceDisposed = false;
+            let instanceDisposePromise;
+            const leases = new WeakMap();
+            const wrapper = {
+                id: raw.id,
+                snapshot: () => {
+                    assertActive(disposed || instanceDisposed, raw.id);
+                    return agentInstanceSnapshot(raw.snapshot());
+                },
+                acquireControllerLease: async (owner) => {
+                    assertActive(disposed || instanceDisposed, raw.id);
+                    const lease = await raw.acquireControllerLease(owner);
+                    const projected = Object.freeze({
+                        id: lease.id,
+                        instanceId: lease.instanceId,
+                        owner: lease.owner,
+                        revision: lease.revision,
+                        isActive: () => !disposed && !instanceDisposed && lease.isActive(),
+                        release: async () => {
+                            assertActive(disposed || instanceDisposed, raw.id);
+                            await lease.release();
+                        },
+                    });
+                    leases.set(projected, lease);
+                    return projected;
+                },
+                run: (input, runOptions) => {
+                    assertActive(disposed || instanceDisposed, raw.id);
+                    const lease = leases.get(runOptions.lease);
+                    if (!lease)
+                        throw new Error(`Embedded SDK lease does not belong to Agent instance: ${raw.id}`);
+                    const operation = raw.run(canonicalInput(input), { lease, signal: runOptions.signal });
+                    let terminal;
+                    let cancelEmitted = false;
+                    const reportCancel = () => {
+                        if (cancelEmitted)
+                            return;
+                        cancelEmitted = true;
+                        emit(OPERATION_CANCEL_EVENT_ID, validateOperationCancelEventDataV1({
+                            version: 1,
+                            operationId: operation.id,
+                            operationKind: "agent.run",
+                        }), operation.id);
+                    };
+                    operation.signal.addEventListener("abort", reportCancel, { once: true });
+                    if (operation.signal.aborted)
+                        reportCancel();
+                    if (!runOptions.signal?.aborted) {
+                        emit(OPERATION_START_EVENT_ID, validateOperationStartEventDataV1({
+                            version: 1,
+                            operationId: operation.id,
+                            operationKind: "agent.run",
+                        }), operation.id);
+                    }
+                    const result = operation.result.then((value) => {
+                        try {
+                            const output = canonicalOutput(value, operation.id);
+                            terminal = { version: 1, status: "succeeded", result: output };
+                            emit(OPERATION_END_EVENT_ID, validateOperationEndEventDataV1({
+                                version: 1,
+                                operationId: operation.id,
+                                operationKind: "agent.run",
+                                status: "succeeded",
+                            }), operation.id);
+                            return output;
+                        }
+                        catch (error) {
+                            terminal = {
+                                version: 1,
+                                status: "failed",
+                                error: errorEnvelope(error, "agent_invalid_result"),
+                            };
+                            emit(OPERATION_END_EVENT_ID, validateOperationEndEventDataV1({
+                                version: 1,
+                                operationId: operation.id,
+                                operationKind: "agent.run",
+                                status: "failed",
+                                errorMessage: error instanceof Error ? error.message : String(error),
+                            }), operation.id);
+                            throw error;
+                        }
+                    }, (error) => {
+                        const status = operation.status() === "cancelled" ? "cancelled" : "failed";
+                        terminal = { version: 1, status, error: errorEnvelope(error, `agent_${status}`) };
+                        emit(OPERATION_END_EVENT_ID, validateOperationEndEventDataV1({
+                            version: 1,
+                            operationId: operation.id,
+                            operationKind: "agent.run",
+                            status,
+                            errorMessage: error instanceof Error ? error.message : String(error),
+                        }), operation.id);
+                        throw error;
+                    });
+                    return Object.freeze({
+                        id: operation.id,
+                        result,
+                        snapshot: () => buildOperationSnapshotV1({
+                            version: 1,
+                            operationId: operation.id,
+                            kind: "agent.run",
+                            status: terminal?.status ?? operationStatus(operation.status()),
+                            ...(terminal === undefined && operation.status() === "cancelled"
+                                ? {
+                                    terminal: {
+                                        version: 1,
+                                        status: "cancelled",
+                                        error: errorEnvelope(new Error("Operation cancelled"), "agent_cancelled"),
+                                    },
+                                }
+                                : terminal === undefined
+                                    ? {}
+                                    : { terminal }),
+                            instanceId: raw.id,
+                        }),
+                        cancel: async (reason) => {
+                            assertActive(disposed || instanceDisposed, raw.id);
+                            if (operation.status() !== "queued" && operation.status() !== "running")
+                                return;
+                            await operation.cancel(reason);
+                        },
+                    });
+                },
+                wait: async () => detachedFreeze(resultSnapshot(await raw.wait())),
+                cancel: async (reason) => {
+                    assertActive(disposed || instanceDisposed, raw.id);
+                    await raw.cancel(reason);
+                },
+                dispose: async () => {
+                    instanceDisposePromise ??= (async () => {
+                        if (!instanceDisposed) {
+                            instanceDisposed = true;
+                            await raw.dispose();
+                            instances.delete(raw.id);
+                        }
+                    })();
+                    return instanceDisposePromise;
+                },
+            };
+            instances.set(raw.id, wrapper);
+            return Object.freeze(wrapper);
+        },
+        listInstances: () => Object.freeze([...instances.values()]
+            .map((instance) => instance.snapshot())
+            .sort((left, right) => left.id.localeCompare(right.id))),
+        subscribe(listener) {
+            assertActive(disposed, "subscribe");
+            const id = `embedded-sdk:subscription:${++sequence}`;
+            let released = false;
+            listeners.set(id, listener);
+            return Object.freeze({
+                id,
+                dispose: () => {
+                    if (released)
+                        return;
+                    released = true;
+                    listeners.delete(id);
+                },
+            });
+        },
+        dispose: async () => {
+            disposePromise ??= (async () => {
+                if (disposed)
+                    return;
+                disposed = true;
+                const failures = [];
+                for (const instance of [...instances.values()]) {
+                    try {
+                        await instance.dispose();
+                    }
+                    catch (error) {
+                        failures.push(error);
+                    }
+                }
+                listeners.clear();
+                if (ownsComposition && "disposeDefinitions" in composition) {
+                    try {
+                        composition.disposeDefinitions([...definitions.values()]);
+                    }
+                    catch (error) {
+                        failures.push(error);
+                    }
+                }
+                definitions.clear();
+                if (failures.length === 1)
+                    throw failures[0];
+                if (failures.length > 1)
+                    throw new AggregateError(failures, "Embedded SDK disposal failed");
+            })();
+            return disposePromise;
+        },
+    };
+    return Object.freeze(binding);
+}
+export const createEmbeddedSdkBinding = createEmbeddedSdkBindingV1;
+//# sourceMappingURL=embedded-sdk.js.map

package/dist/core/embedded-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-sdk.js","sourceRoot":"","sources":["../../src/core/embedded-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,8BAA8B,EAC9B,8BAA8B,EAC9B,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,GAQtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kCAAkC,EAClC,+BAA+B,EAC/B,iCAAiC,GACjC,MAAM,mCAAmC,CAAC;AAiH3C,SAAS,cAAc,CAAI,KAAQ,EAAE,IAAI,GAAG,IAAI,OAAO,EAAmB,EAAK;IAC9E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAa,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAM,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAC;IACrF,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAM,CAAC;AAAA,CAChC;AAED,SAAS,YAAY,CAAC,QAAiB,EAAE,KAAa,EAAQ;IAC7D,IAAI,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;AAAA,CAC5E;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,IAAY,EAAmB;IACrE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,oBAAoB,CAAC;QAC3B,OAAO,EAAE,CAAC;QACV,IAAI;QACJ,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC,CAAC;AAAA,CACH;AAED,SAAS,uBAAuB,CAC/B,UAA4C,EAChB;IAC5B,OAAO,8BAA8B,CAAC;QACrC,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,iBAAiB,EAAE,UAAU,CAAC,OAAO;QACrC,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,YAAY,EAAE,EAAE;QAChB,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;KACtE,CAAC,CAAC;AAAA,CACH;AAED,SAAS,qBAAqB,CAC7B,QAAiE,EACvC;IAC1B,OAAO,4BAA4B,CAAC;QACnC,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,GAAG,CAAC,QAAQ,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACnG,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;KACjF,CAAC,CAAC;AAAA,CACH;AAED,SAAS,eAAe,CAAC,MAAsD,EAAiC;IAC/G,OAAO,MAAM,CAAC;AAAA,CACd;AAED,SAAS,cAAc,CACtB,MAAoC,EACH;IACjC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC;YACrB,MAAM,EAAE,WAAoB;YAC5B,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAiB,EAAE,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5E,QAAQ,EAAE,MAAM,CAAC,QAAQ;SACzB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,cAAc,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;KACvG,CAAC,CAAC;AAAA,CACH;AAED,SAAS,eAAe,CAA4B,KAAc,EAAE,WAAmB,EAAW;IACjG,wBAAwB,CAAC;QACxB,OAAO,EAAE,CAAC;QACV,WAAW;QACX,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;KAC5D,CAAC,CAAC;IACH,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAAA,CAC7B;AAED,SAAS,cAAc,CAA2B,KAAa,EAAU;IACxE,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC3F,wBAAwB,CAAC;QACxB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;KAC5D,CAAC,CAAC;IACH,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAAA,CAC7B;AAED,SAAS,8BAA8B,CAAC,OAAmB,EAA4B;IACtF,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,GAAsB,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,WAAY,EAAE,CAAC,CAAC;IACpF,MAAM,OAAO,GACZ,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,aAAa;QAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,CAAU;YACnB,GAAG,EAAE,GAAqB,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,kBAAmB,EAAU,CAAC;YAClF,MAAM,EAAE,CAAmB,OAA4C,EAAE,EAAE,CAC1E,OAAO,CAAC,aAAc,CAAC,OAAO,CAAC;SAChC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,CAAU;QACnB,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE;QAC1C,WAAW;QACX,QAAQ,EAAE,GAAG,EAAE,CACd,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC;QACnG,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACxD,gBAAgB,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAClE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9C,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CACvB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC/G,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;QACxC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC7C,CAAC,CAAC;AAAA,CACH;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAO,GAAyB,EAAE,EAAwB;IACpG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,6BAA6B,EAAE,CAAC;IAC3E,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;IACrF,MAAM,eAAe,GAAG;QACvB,sBAAsB;QACtB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,qBAAqB,EAAE,SAAS,CAAC,CAAC;KACvF,CAAC;IACF,MAAM,WAAW,GAAG,cAAc,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,cAAc;QACpC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE;QAC3D,UAAU,EAAE,CAAC,YAAY,CAAU;KACnC,CAAkB,CAAC;IACpB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,8BAA8B,CAAC;QAC/C,UAAU,EAAE,uCAAuC;QACnD,YAAY,EAAE,EAAE;QAChB,WAAW;KACX,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiD,CAAC;IAC7E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyD,CAAC;IACnF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;IAChE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,cAAyC,CAAC;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,MAAM,GAAG,CAAC,IAA0B,EAAU,EAAE,CAAC;QACtD,QAAQ,IAAI,CAAC,CAAC;QACd,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,gBAAgB,IAAI,IAAI,QAAQ,EAAE,CAAC;IAAA,CACjF,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,IAAe,EAAE,WAAoB,EAAQ,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;YAC9B,IAAI;YACJ,MAAM,EAAE,cAAc;YACtB,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC;YACjC,QAAQ,EACP,IAAI,KAAK,wBAAwB,IAAI,IAAI,KAAK,yBAAyB,IAAI,IAAI,KAAK,sBAAsB;gBACzG,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,aAAa;YACjB,iBAAiB,EAAE,aAAa;YAChC,IAAI;YACJ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;SACjF,CAAC,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACJ,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACR,gDAAgD;YACjD,CAAC;QACF,CAAC;IAAA,CACD,CAAC;IACF,MAAM,iBAAiB,GAAG,CACzB,UAA0G,EACvE,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7E,MAAM,iBAAiB,GAAG,CACzB,mBAAmB,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CACrE,CAAC;QACZ,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ;YAAE,OAAO,QAA4C,CAAC;QAClE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,WAAW,CAAC,GAAG,CAAkB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAAA,CAC1F,CAAC;IAEF,MAAM,OAAO,GAAyB;QACrC,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,WAAW;QACX,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,MAAM,CAAsD,UAA4C,EAAE;YACzG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAClD,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,UAAmD,CAAC,CAAC;YAC/G,OAAO,cAAc,CAAC,EAAE,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAAA,CACzE;QACD,MAAM,CACL,UAA0G,EAC1G,eAAe,GAAiE,EAAE,EACjF;YACD,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC,CAAC;YAC/E,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,IAAI,sBAAiD,CAAC;YACtD,MAAM,MAAM,GAAG,IAAI,OAAO,EAAmD,CAAC;YAC9E,MAAM,OAAO,GAA6C;gBACzD,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,QAAQ,EAAE,GAAG,EAAE,CAAC;oBACf,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBACnD,OAAO,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAAA,CAC7C;gBACD,sBAAsB,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE,CAAC;oBACjD,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBACnD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;oBACtD,MAAM,SAAS,GAA8B,MAAM,CAAC,MAAM,CAAC;wBAC1D,EAAE,EAAE,KAAK,CAAC,EAAE;wBACZ,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,QAAQ,EAAE;wBAClE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;4BACpB,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;4BACnD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;wBAAA,CACtB;qBACD,CAAC,CAAC;oBACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBAC7B,OAAO,SAAS,CAAC;gBAAA,CACjB;gBACD,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;oBAC3B,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAC3C,IAAI,CAAC,KAAK;wBAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC/F,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;oBACvF,IAAI,QAAyC,CAAC;oBAC9C,IAAI,aAAa,GAAG,KAAK,CAAC;oBAC1B,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;wBAC1B,IAAI,aAAa;4BAAE,OAAO;wBAC1B,aAAa,GAAG,IAAI,CAAC;wBACrB,IAAI,CACH,yBAAyB,EACzB,kCAAkC,CAAC;4BAClC,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,SAAS,CAAC,EAAE;4BACzB,aAAa,EAAE,WAAW;yBAC1B,CAAyB,EAC1B,SAAS,CAAC,EAAE,CACZ,CAAC;oBAAA,CACF,CAAC;oBACF,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBACzE,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO;wBAAE,YAAY,EAAE,CAAC;oBAC7C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;wBACjC,IAAI,CACH,wBAAwB,EACxB,iCAAiC,CAAC;4BACjC,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,SAAS,CAAC,EAAE;4BACzB,aAAa,EAAE,WAAW;yBAC1B,CAAyB,EAC1B,SAAS,CAAC,EAAE,CACZ,CAAC;oBACH,CAAC;oBACD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CACnC,CAAC,KAAc,EAAE,EAAE,CAAC;wBACnB,IAAI,CAAC;4BACJ,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;4BACpD,QAAQ,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;4BAC/D,IAAI,CACH,sBAAsB,EACtB,+BAA+B,CAAC;gCAC/B,OAAO,EAAE,CAAC;gCACV,WAAW,EAAE,SAAS,CAAC,EAAE;gCACzB,aAAa,EAAE,WAAW;gCAC1B,MAAM,EAAE,WAAW;6BACnB,CAAyB,EAC1B,SAAS,CAAC,EAAE,CACZ,CAAC;4BACF,OAAO,MAAM,CAAC;wBACf,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BAChB,QAAQ,GAAG;gCACV,OAAO,EAAE,CAAC;gCACV,MAAM,EAAE,QAAQ;gCAChB,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC;6BACnD,CAAC;4BACF,IAAI,CACH,sBAAsB,EACtB,+BAA+B,CAAC;gCAC/B,OAAO,EAAE,CAAC;gCACV,WAAW,EAAE,SAAS,CAAC,EAAE;gCACzB,aAAa,EAAE,WAAW;gCAC1B,MAAM,EAAE,QAAQ;gCAChB,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;6BACpE,CAAyB,EAC1B,SAAS,CAAC,EAAE,CACZ,CAAC;4BACF,MAAM,KAAK,CAAC;wBACb,CAAC;oBAAA,CACD,EACD,CAAC,KAAc,EAAE,EAAE,CAAC;wBACnB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;wBAC3E,QAAQ,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;wBAClF,IAAI,CACH,sBAAsB,EACtB,+BAA+B,CAAC;4BAC/B,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,SAAS,CAAC,EAAE;4BACzB,aAAa,EAAE,WAAW;4BAC1B,MAAM;4BACN,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBACpE,CAAyB,EAC1B,SAAS,CAAC,EAAE,CACZ,CAAC;wBACF,MAAM,KAAK,CAAC;oBAAA,CACZ,CACD,CAAC;oBACF,OAAO,MAAM,CAAC,MAAM,CAAC;wBACpB,EAAE,EAAE,SAAS,CAAC,EAAE;wBAChB,MAAM;wBACN,QAAQ,EAAE,GAAG,EAAE,CACd,wBAAwB,CAAC;4BACxB,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,SAAS,CAAC,EAAE;4BACzB,IAAI,EAAE,WAAW;4BACjB,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;4BAC/D,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,WAAW;gCAC/D,CAAC,CAAC;oCACA,QAAQ,EAAE;wCACT,OAAO,EAAE,CAAC;wCACV,MAAM,EAAE,WAAW;wCACnB,KAAK,EAAE,aAAa,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAAE,iBAAiB,CAAC;qCACzE;iCACD;gCACF,CAAC,CAAC,QAAQ,KAAK,SAAS;oCACvB,CAAC,CAAC,EAAE;oCACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;4BACjB,UAAU,EAAE,GAAG,CAAC,EAAE;yBAClB,CAAC;wBACH,MAAM,EAAE,KAAK,EAAE,MAAe,EAAE,EAAE,CAAC;4BAClC,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;4BACnD,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,SAAS;gCAAE,OAAO;4BAChF,MAAM,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;wBAAA,CAC/B;qBACD,CAAC,CAAC;gBAAA,CACH;gBACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClE,MAAM,EAAE,KAAK,EAAE,MAAe,EAAE,EAAE,CAAC;oBAClC,YAAY,CAAC,QAAQ,IAAI,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBACnD,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAAA,CACzB;gBACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;oBACpB,sBAAsB,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;wBACvC,IAAI,CAAC,gBAAgB,EAAE,CAAC;4BACvB,gBAAgB,GAAG,IAAI,CAAC;4BACxB,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;4BACpB,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBAC1B,CAAC;oBAAA,CACD,CAAC,EAAE,CAAC;oBACL,OAAO,sBAAsB,CAAC;gBAAA,CAC9B;aACD,CAAC;YACF,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAwD,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAAA,CAC9B;QACD,aAAa,EAAE,GAAG,EAAE,CACnB,MAAM,CAAC,MAAM,CACZ,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;aACrB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;aACtC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CACxD;QACF,SAAS,CAAC,QAAoC,EAAE;YAC/C,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,6BAA6B,EAAE,QAAQ,EAAE,CAAC;YACrD,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;gBACpB,EAAE;gBACF,OAAO,EAAE,GAAG,EAAE,CAAC;oBACd,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAAA,CACrB;aACD,CAAC,CAAC;QAAA,CACH;QACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YACpB,cAAc,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,QAAQ,GAAc,EAAE,CAAC;gBAC/B,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC;wBACJ,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC1B,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACtB,CAAC;gBACF,CAAC;gBACD,SAAS,CAAC,KAAK,EAAE,CAAC;gBAClB,IAAI,eAAe,IAAI,oBAAoB,IAAI,WAAW,EAAE,CAAC;oBAC5D,IAAI,CAAC;wBACH,WAAiD,CAAC,kBAAkB,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAClG,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACtB,CAAC;gBACF,CAAC;gBACD,WAAW,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC7C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;YAAA,CAC5F,CAAC,EAAE,CAAC;YACL,OAAO,cAAc,CAAC;QAAA,CACtB;KACD,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAAA,CAC9B;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC","sourcesContent":["import {\n\ttype AgentCapabilityContractV1,\n\ttype AgentDefinitionSnapshotV1,\n\ttype AgentInstanceSnapshotV1,\n\tbuildAgentCapabilityContractV1,\n\tbuildAgentDefinitionSnapshotV1,\n\tbuildAgentInstanceSnapshotV1,\n\tbuildErrorEnvelopeV1,\n\tbuildEventEnvelopeV1,\n\tbuildOperationSnapshotV1,\n\tbuildSessionSnapshotV1,\n\ttype ErrorEnvelopeV1,\n\ttype EventEnvelopeV1,\n\ttype HostContextV1,\n\ttype JsonValue,\n\ttype OperationSnapshotV1,\n\ttype SessionRevisionV1,\n\ttype SessionSnapshotV1,\n} from \"./agent-capability-contract.ts\";\nimport { createAgentCompositionRuntime } from \"./extensions/agent-composition.ts\";\nimport {\n\tOPERATION_CANCEL_EVENT_ID,\n\tOPERATION_END_EVENT_ID,\n\tOPERATION_START_EVENT_ID,\n\tvalidateOperationCancelEventDataV1,\n\tvalidateOperationEndEventDataV1,\n\tvalidateOperationStartEventDataV1,\n} from \"./extensions/lifecycle-catalog.ts\";\nimport type {\n\tAgentCompositionAPI,\n\tAgentCompositionDefinitionBinding,\n\tAgentContextCommitRequestV1,\n\tAgentContextFacadeV1,\n\tAgentControllerLease,\n\tAgentDefinition,\n\tAgentInstance,\n\tAgentInstanceResult,\n\tOperationHandle,\n\tPromptOutcome,\n\tSessionAPI,\n} from \"./extensions/public-api.ts\";\n\n/**\n * An in-process binding over AgentComposition. It intentionally excludes the\n * transitional AgentSession command surface and every remote transport concern.\n */\nexport interface EmbeddedSdkBindingV1 {\n\treadonly version: 1;\n\treadonly contract: AgentCapabilityContractV1;\n\treadonly hostContext: HostContextV1;\n\t/** Optional session-backed facade supplied by an in-process host. */\n\treadonly session?: EmbeddedSessionBindingV1;\n\tdefine<TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: AgentDefinition<TInput, TResult>,\n\t): EmbeddedAgentDefinitionV1<TInput, TResult>;\n\tcreate<TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t\toptions?: { readonly id?: string; readonly parentInstanceId?: string },\n\t): EmbeddedAgentInstanceV1<TInput, TResult>;\n\tlistInstances(): readonly AgentInstanceSnapshotV1[];\n\tsubscribe(listener: EmbeddedSdkEventListenerV1): EmbeddedSdkSubscriptionV1;\n\tdispose(): Promise<void>;\n}\n\nexport interface EmbeddedSdkOptionsV1 {\n\treadonly composition?: AgentCompositionAPI;\n\t/** Optional host session to expose through the stable in-process facade. */\n\treadonly session?: SessionAPI;\n\t/** Whether this binding owns and may remove definitions from the supplied composition. */\n\treadonly ownsComposition?: boolean;\n\treadonly mode?: HostContextV1[\"mode\"];\n\treadonly features?: readonly string[];\n\treadonly clock?: () => number;\n\treadonly idFactory?: (kind: \"event\" | \"delivery\", sequence: number) => string;\n}\n\n/** Stable, detached session projection used by embedded and future service bindings. */\nexport interface EmbeddedSessionBindingV1 {\n\treadonly version: 1;\n\tgetSessionId(): string;\n\tgetRevision(): SessionRevisionV1;\n\tsnapshot(): SessionSnapshotV1;\n\tgetMessages(): readonly unknown[];\n\tgetBranchEntries(): readonly unknown[];\n\tisIdle(): boolean;\n\tprompt(text: string): Promise<PromptOutcome>;\n\tsteer(text: string): Promise<void>;\n\tabort(): Promise<void>;\n\twaitForIdle(): Promise<void>;\n\treadonly context?: AgentContextFacadeV1;\n}\n\nexport interface EmbeddedAgentDefinitionV1<_TInput extends JsonValue, _TResult extends JsonValue> {\n\treadonly snapshot: AgentDefinitionSnapshotV1;\n}\n\nexport interface EmbeddedControllerLeaseV1 {\n\treadonly id: string;\n\treadonly instanceId: string;\n\treadonly owner: string;\n\treadonly revision: number;\n\tisActive(): boolean;\n\trelease(): Promise<void>;\n}\n\nexport interface EmbeddedOperationHandleV1<TResult extends JsonValue> {\n\treadonly id: string;\n\treadonly result: Promise<TResult>;\n\tsnapshot(): OperationSnapshotV1;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface EmbeddedAgentInstanceV1<TInput extends JsonValue, TResult extends JsonValue> {\n\treadonly id: string;\n\tsnapshot(): AgentInstanceSnapshotV1;\n\tacquireControllerLease(owner?: string): Promise<EmbeddedControllerLeaseV1>;\n\trun(\n\t\tinput: TInput,\n\t\toptions: { readonly lease: EmbeddedControllerLeaseV1; readonly signal?: AbortSignal },\n\t): EmbeddedOperationHandleV1<TResult>;\n\twait(): Promise<EmbeddedAgentResultV1<TResult>>;\n\tcancel(reason?: string): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nexport type EmbeddedAgentResultV1<TResult extends JsonValue> =\n\t| { readonly status: \"succeeded\"; readonly output: TResult; readonly revision: number }\n\t| {\n\t\t\treadonly status: \"failed\" | \"cancelled\" | \"disposed\";\n\t\t\treadonly error?: ErrorEnvelopeV1;\n\t\t\treadonly revision: number;\n\t  };\n\nexport type EmbeddedSdkEventListenerV1 = (event: EventEnvelopeV1) => void;\n\nexport interface EmbeddedSdkSubscriptionV1 {\n\treadonly id: string;\n\tdispose(): void;\n}\n\nfunction detachedFreeze<T>(value: T, seen = new WeakMap<object, unknown>()): T {\n\tif (value === null || typeof value !== \"object\") return value;\n\tconst existing = seen.get(value);\n\tif (existing !== undefined) return existing as T;\n\tif (Array.isArray(value)) {\n\t\tconst copy: unknown[] = [];\n\t\tseen.set(value, copy);\n\t\tfor (const child of value) copy.push(detachedFreeze(child, seen));\n\t\treturn Object.freeze(copy) as T;\n\t}\n\tconst copy: Record<string, unknown> = Object.create(null) as Record<string, unknown>;\n\tseen.set(value, copy);\n\tfor (const [key, child] of Object.entries(value as Record<string, unknown>)) copy[key] = detachedFreeze(child, seen);\n\treturn Object.freeze(copy) as T;\n}\n\nfunction assertActive(disposed: boolean, label: string): void {\n\tif (disposed) throw new Error(`Embedded SDK binding is disposed: ${label}`);\n}\n\nfunction errorEnvelope(error: unknown, code: string): ErrorEnvelopeV1 {\n\tconst message = error instanceof Error ? error.message : String(error);\n\treturn buildErrorEnvelopeV1({\n\t\tversion: 1,\n\t\tcode,\n\t\tmessage,\n\t\tretryable: false,\n\t\t...(error instanceof Error ? { name: error.name } : {}),\n\t});\n}\n\nfunction agentDefinitionSnapshot<TInput extends JsonValue, TResult extends JsonValue>(\n\tdefinition: AgentDefinition<TInput, TResult>,\n): AgentDefinitionSnapshotV1 {\n\treturn buildAgentDefinitionSnapshotV1({\n\t\tversion: 1,\n\t\tid: definition.id,\n\t\tdefinitionVersion: definition.version,\n\t\trole: definition.role,\n\t\tcapabilities: [],\n\t\t...(definition.owner === undefined ? {} : { owner: definition.owner }),\n\t});\n}\n\nfunction agentInstanceSnapshot(\n\tsnapshot: ReturnType<AgentInstance<unknown, unknown>[\"snapshot\"]>,\n): AgentInstanceSnapshotV1 {\n\treturn buildAgentInstanceSnapshotV1({\n\t\tversion: 1,\n\t\tid: snapshot.id,\n\t\tdefinitionId: snapshot.definitionId,\n\t\tdefinitionVersion: snapshot.definitionVersion,\n\t\trole: snapshot.role,\n\t\tstatus: snapshot.status,\n\t\trevision: snapshot.revision,\n\t\t...(snapshot.parentInstanceId === undefined ? {} : { parentInstanceId: snapshot.parentInstanceId }),\n\t\t...(snapshot.leaseOwner === undefined ? {} : { leaseOwner: snapshot.leaseOwner }),\n\t});\n}\n\nfunction operationStatus(status: ReturnType<OperationHandle<unknown>[\"status\"]>): OperationSnapshotV1[\"status\"] {\n\treturn status;\n}\n\nfunction resultSnapshot<TResult extends JsonValue>(\n\tresult: AgentInstanceResult<TResult>,\n): EmbeddedAgentResultV1<TResult> {\n\tif (result.status === \"succeeded\") {\n\t\treturn detachedFreeze({\n\t\t\tstatus: \"succeeded\" as const,\n\t\t\toutput: canonicalOutput(result.output as TResult, `wait:${result.revision}`),\n\t\t\trevision: result.revision,\n\t\t});\n\t}\n\treturn detachedFreeze({\n\t\tstatus: result.status,\n\t\trevision: result.revision,\n\t\t...(result.error === undefined ? {} : { error: errorEnvelope(result.error, `agent_${result.status}`) }),\n\t});\n}\n\nfunction canonicalOutput<TResult extends JsonValue>(value: TResult, operationId: string): TResult {\n\tbuildOperationSnapshotV1({\n\t\tversion: 1,\n\t\toperationId,\n\t\tkind: \"agent.run\",\n\t\tstatus: \"succeeded\",\n\t\tterminal: { version: 1, status: \"succeeded\", result: value },\n\t});\n\treturn detachedFreeze(value);\n}\n\nfunction canonicalInput<TInput extends JsonValue>(value: TInput): TInput {\n\tif (value === undefined) throw new Error(\"Embedded SDK run input must be JSON-compatible\");\n\tbuildOperationSnapshotV1({\n\t\tversion: 1,\n\t\toperationId: \"embedded-sdk:input\",\n\t\tkind: \"agent.run\",\n\t\tstatus: \"succeeded\",\n\t\tterminal: { version: 1, status: \"succeeded\", result: value },\n\t});\n\treturn detachedFreeze(value);\n}\n\nfunction createEmbeddedSessionBindingV1(session: SessionAPI): EmbeddedSessionBindingV1 {\n\tif (!session.getRevision) throw new Error(\"Embedded SDK session requires revision support\");\n\tconst getRevision = (): SessionRevisionV1 => detachedFreeze(session.getRevision!());\n\tconst context =\n\t\tsession.getContextSnapshot && session.commitContext\n\t\t\t? Object.freeze({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tget: <TValue = unknown>() => detachedFreeze(session.getContextSnapshot!<TValue>()),\n\t\t\t\t\tcommit: <TValue = unknown>(request: AgentContextCommitRequestV1<TValue>) =>\n\t\t\t\t\t\tsession.commitContext!(request),\n\t\t\t\t})\n\t\t\t: undefined;\n\treturn Object.freeze({\n\t\tversion: 1 as const,\n\t\tgetSessionId: () => session.getSessionId(),\n\t\tgetRevision,\n\t\tsnapshot: () =>\n\t\t\tbuildSessionSnapshotV1({ version: 1, sessionId: session.getSessionId(), revision: getRevision() }),\n\t\tgetMessages: () => detachedFreeze(session.getMessages()),\n\t\tgetBranchEntries: () => detachedFreeze(session.getBranchEntries()),\n\t\tisIdle: () => session.isIdle(),\n\t\tprompt: (text: string) => session.prompt(text),\n\t\tsteer: (text: string) =>\n\t\t\tsession.steer ? session.steer(text) : Promise.reject(new Error(\"Embedded SDK session does not support steer\")),\n\t\tabort: () => session.abort(),\n\t\twaitForIdle: () => session.waitForIdle(),\n\t\t...(context === undefined ? {} : { context }),\n\t});\n}\n\nexport function createEmbeddedSdkBindingV1(options: EmbeddedSdkOptionsV1 = {}): EmbeddedSdkBindingV1 {\n\tconst composition = options.composition ?? createAgentCompositionRuntime();\n\tconst ownsComposition = options.ownsComposition ?? options.composition === undefined;\n\tconst defaultFeatures = [\n\t\t\"agent-composition-v1\",\n\t\t...(options.session === undefined ? [] : [\"session\", \"session-revision-v1\", \"context\"]),\n\t];\n\tconst hostContext = detachedFreeze({\n\t\tmode: options.mode ?? \"full-control\",\n\t\tfeatures: [...(options.features ?? defaultFeatures)].sort(),\n\t\ttransports: [\"in-process\"] as const,\n\t}) as HostContextV1;\n\tconst session = options.session === undefined ? undefined : createEmbeddedSessionBindingV1(options.session);\n\tconst contract = buildAgentCapabilityContractV1({\n\t\tcontractId: \"agent-forge/agent-capability-contract\",\n\t\tcapabilities: [],\n\t\thostContext,\n\t});\n\tconst definitions = new Map<string, AgentDefinition<JsonValue, JsonValue>>();\n\tconst instances = new Map<string, EmbeddedAgentInstanceV1<JsonValue, JsonValue>>();\n\tconst listeners = new Map<string, EmbeddedSdkEventListenerV1>();\n\tlet sequence = 0;\n\tlet disposePromise: Promise<void> | undefined;\n\tlet disposed = false;\n\n\tconst nextId = (kind: \"event\" | \"delivery\"): string => {\n\t\tsequence += 1;\n\t\treturn options.idFactory?.(kind, sequence) ?? `embedded-sdk:${kind}:${sequence}`;\n\t};\n\tconst emit = (type: string, data: JsonValue, operationId?: string): void => {\n\t\tconst event = buildEventEnvelopeV1({\n\t\t\tid: nextId(\"event\"),\n\t\t\tdeliveryId: nextId(\"delivery\"),\n\t\t\ttype,\n\t\t\tsource: \"embedded-sdk\",\n\t\t\ttimestamp: options.clock?.() ?? 0,\n\t\t\tcategory:\n\t\t\t\ttype === OPERATION_START_EVENT_ID || type === OPERATION_CANCEL_EVENT_ID || type === OPERATION_END_EVENT_ID\n\t\t\t\t\t? \"authoritative\"\n\t\t\t\t\t: \"observation\",\n\t\t\tdeliveryGuarantee: \"best-effort\",\n\t\t\tdata,\n\t\t\t...(operationId === undefined ? {} : { operationId, correlationId: operationId }),\n\t\t});\n\t\tfor (const listener of listeners.values()) {\n\t\t\ttry {\n\t\t\t\tlistener(event);\n\t\t\t} catch {\n\t\t\t\t// Observers must not affect an Agent operation.\n\t\t\t}\n\t\t}\n\t};\n\tconst resolveDefinition = <TInput extends JsonValue, TResult extends JsonValue>(\n\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t): AgentDefinition<TInput, TResult> => {\n\t\tconst snapshot = \"snapshot\" in definition ? definition.snapshot : definition;\n\t\tconst definitionVersion = (\n\t\t\t\"definitionVersion\" in snapshot ? snapshot.definitionVersion : snapshot.version\n\t\t) as number;\n\t\tconst resolved = definitions.get(`${snapshot.id}@${definitionVersion}`);\n\t\tif (resolved) return resolved as AgentDefinition<TInput, TResult>;\n\t\tif (options.composition !== undefined) {\n\t\t\treturn composition.get<TInput, TResult>(snapshot.id, definitionVersion);\n\t\t}\n\t\tthrow new Error(`Embedded SDK has no defined Agent: ${snapshot.id}@${definitionVersion}`);\n\t};\n\n\tconst binding: EmbeddedSdkBindingV1 = {\n\t\tversion: 1,\n\t\tcontract,\n\t\thostContext,\n\t\t...(session === undefined ? {} : { session }),\n\t\tdefine<TInput extends JsonValue, TResult extends JsonValue>(definition: AgentDefinition<TInput, TResult>) {\n\t\t\tassertActive(disposed, \"define\");\n\t\t\tconst registered = composition.define(definition);\n\t\t\tdefinitions.set(`${registered.id}@${registered.version}`, registered as AgentDefinition<JsonValue, JsonValue>);\n\t\t\treturn detachedFreeze({ snapshot: agentDefinitionSnapshot(registered) });\n\t\t},\n\t\tcreate<TInput extends JsonValue, TResult extends JsonValue>(\n\t\t\tdefinition: EmbeddedAgentDefinitionV1<TInput, TResult> | { readonly id: string; readonly version: number },\n\t\t\tinstanceOptions: { readonly id?: string; readonly parentInstanceId?: string } = {},\n\t\t) {\n\t\t\tassertActive(disposed, \"create\");\n\t\t\tconst raw = composition.create(resolveDefinition(definition), instanceOptions);\n\t\t\tlet instanceDisposed = false;\n\t\t\tlet instanceDisposePromise: Promise<void> | undefined;\n\t\t\tconst leases = new WeakMap<EmbeddedControllerLeaseV1, AgentControllerLease>();\n\t\t\tconst wrapper: EmbeddedAgentInstanceV1<TInput, TResult> = {\n\t\t\t\tid: raw.id,\n\t\t\t\tsnapshot: () => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\treturn agentInstanceSnapshot(raw.snapshot());\n\t\t\t\t},\n\t\t\t\tacquireControllerLease: async (owner?: string) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tconst lease = await raw.acquireControllerLease(owner);\n\t\t\t\t\tconst projected: EmbeddedControllerLeaseV1 = Object.freeze({\n\t\t\t\t\t\tid: lease.id,\n\t\t\t\t\t\tinstanceId: lease.instanceId,\n\t\t\t\t\t\towner: lease.owner,\n\t\t\t\t\t\trevision: lease.revision,\n\t\t\t\t\t\tisActive: () => !disposed && !instanceDisposed && lease.isActive(),\n\t\t\t\t\t\trelease: async () => {\n\t\t\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\t\t\tawait lease.release();\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\tleases.set(projected, lease);\n\t\t\t\t\treturn projected;\n\t\t\t\t},\n\t\t\t\trun: (input, runOptions) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tconst lease = leases.get(runOptions.lease);\n\t\t\t\t\tif (!lease) throw new Error(`Embedded SDK lease does not belong to Agent instance: ${raw.id}`);\n\t\t\t\t\tconst operation = raw.run(canonicalInput(input), { lease, signal: runOptions.signal });\n\t\t\t\t\tlet terminal: OperationSnapshotV1[\"terminal\"];\n\t\t\t\t\tlet cancelEmitted = false;\n\t\t\t\t\tconst reportCancel = () => {\n\t\t\t\t\t\tif (cancelEmitted) return;\n\t\t\t\t\t\tcancelEmitted = true;\n\t\t\t\t\t\temit(\n\t\t\t\t\t\t\tOPERATION_CANCEL_EVENT_ID,\n\t\t\t\t\t\t\tvalidateOperationCancelEventDataV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t);\n\t\t\t\t\t};\n\t\t\t\t\toperation.signal.addEventListener(\"abort\", reportCancel, { once: true });\n\t\t\t\t\tif (operation.signal.aborted) reportCancel();\n\t\t\t\t\tif (!runOptions.signal?.aborted) {\n\t\t\t\t\t\temit(\n\t\t\t\t\t\t\tOPERATION_START_EVENT_ID,\n\t\t\t\t\t\t\tvalidateOperationStartEventDataV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst result = operation.result.then(\n\t\t\t\t\t\t(value: TResult) => {\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tconst output = canonicalOutput(value, operation.id);\n\t\t\t\t\t\t\t\tterminal = { version: 1, status: \"succeeded\", result: output };\n\t\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\t\tstatus: \"succeeded\",\n\t\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn output;\n\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\tterminal = {\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\t\terror: errorEnvelope(error, \"agent_invalid_result\"),\n\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t\t(error: unknown) => {\n\t\t\t\t\t\t\tconst status = operation.status() === \"cancelled\" ? \"cancelled\" : \"failed\";\n\t\t\t\t\t\t\tterminal = { version: 1, status, error: errorEnvelope(error, `agent_${status}`) };\n\t\t\t\t\t\t\temit(\n\t\t\t\t\t\t\t\tOPERATION_END_EVENT_ID,\n\t\t\t\t\t\t\t\tvalidateOperationEndEventDataV1({\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\t\toperationKind: \"agent.run\",\n\t\t\t\t\t\t\t\t\tstatus,\n\t\t\t\t\t\t\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t\t}) as unknown as JsonValue,\n\t\t\t\t\t\t\t\toperation.id,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t},\n\t\t\t\t\t);\n\t\t\t\t\treturn Object.freeze({\n\t\t\t\t\t\tid: operation.id,\n\t\t\t\t\t\tresult,\n\t\t\t\t\t\tsnapshot: () =>\n\t\t\t\t\t\t\tbuildOperationSnapshotV1({\n\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\t\tkind: \"agent.run\",\n\t\t\t\t\t\t\t\tstatus: terminal?.status ?? operationStatus(operation.status()),\n\t\t\t\t\t\t\t\t...(terminal === undefined && operation.status() === \"cancelled\"\n\t\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\t\tterminal: {\n\t\t\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\t\t\tstatus: \"cancelled\",\n\t\t\t\t\t\t\t\t\t\t\t\terror: errorEnvelope(new Error(\"Operation cancelled\"), \"agent_cancelled\"),\n\t\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t: terminal === undefined\n\t\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t\t: { terminal }),\n\t\t\t\t\t\t\t\tinstanceId: raw.id,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\tcancel: async (reason?: string) => {\n\t\t\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\t\t\tif (operation.status() !== \"queued\" && operation.status() !== \"running\") return;\n\t\t\t\t\t\t\tawait operation.cancel(reason);\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\twait: async () => detachedFreeze(resultSnapshot(await raw.wait())),\n\t\t\t\tcancel: async (reason?: string) => {\n\t\t\t\t\tassertActive(disposed || instanceDisposed, raw.id);\n\t\t\t\t\tawait raw.cancel(reason);\n\t\t\t\t},\n\t\t\t\tdispose: async () => {\n\t\t\t\t\tinstanceDisposePromise ??= (async () => {\n\t\t\t\t\t\tif (!instanceDisposed) {\n\t\t\t\t\t\t\tinstanceDisposed = true;\n\t\t\t\t\t\t\tawait raw.dispose();\n\t\t\t\t\t\t\tinstances.delete(raw.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t})();\n\t\t\t\t\treturn instanceDisposePromise;\n\t\t\t\t},\n\t\t\t};\n\t\t\tinstances.set(raw.id, wrapper as EmbeddedAgentInstanceV1<JsonValue, JsonValue>);\n\t\t\treturn Object.freeze(wrapper);\n\t\t},\n\t\tlistInstances: () =>\n\t\t\tObject.freeze(\n\t\t\t\t[...instances.values()]\n\t\t\t\t\t.map((instance) => instance.snapshot())\n\t\t\t\t\t.sort((left, right) => left.id.localeCompare(right.id)),\n\t\t\t),\n\t\tsubscribe(listener: EmbeddedSdkEventListenerV1) {\n\t\t\tassertActive(disposed, \"subscribe\");\n\t\t\tconst id = `embedded-sdk:subscription:${++sequence}`;\n\t\t\tlet released = false;\n\t\t\tlisteners.set(id, listener);\n\t\t\treturn Object.freeze({\n\t\t\t\tid,\n\t\t\t\tdispose: () => {\n\t\t\t\t\tif (released) return;\n\t\t\t\t\treleased = true;\n\t\t\t\t\tlisteners.delete(id);\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tif (disposed) return;\n\t\t\t\tdisposed = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\tfor (const instance of [...instances.values()]) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait instance.dispose();\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlisteners.clear();\n\t\t\t\tif (ownsComposition && \"disposeDefinitions\" in composition) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\t(composition as AgentCompositionDefinitionBinding).disposeDefinitions([...definitions.values()]);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tdefinitions.clear();\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Embedded SDK disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n\treturn Object.freeze(binding);\n}\n\nexport const createEmbeddedSdkBinding = createEmbeddedSdkBindingV1;\n"]}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,9 @@
+export interface EventBus {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export interface EventBusController extends EventBus {
+    clear(): void;
+}
+export declare function createEventBus(): EventBusController;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IACnD,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAqBnD","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/event-bus.js

@@ -0,0 +1,25 @@
+import { EventEmitter } from "node:events";
+export function createEventBus() {
+    const emitter = new EventEmitter();
+    return {
+        emit: (channel, data) => {
+            emitter.emit(channel, data);
+        },
+        on: (channel, handler) => {
+            const safeHandler = async (data) => {
+                try {
+                    await handler(data);
+                }
+                catch (err) {
+                    console.error(`Event handler error (${channel}):`, err);
+                }
+            };
+            emitter.on(channel, safeHandler);
+            return () => emitter.off(channel, safeHandler);
+        },
+        clear: () => {
+            emitter.removeAllListeners();
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,UAAU,cAAc,GAAuB;IACpD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAA,CAC5B;QACD,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YAAA,CACD,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAAA,CAC/C;QACD,KAAK,EAAE,GAAG,EAAE,CAAC;YACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAAA,CAC7B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/exec.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared command execution utilities for extensions and custom tools.
+ */
+/**
+ * Options for executing shell commands.
+ */
+export interface ExecOptions {
+    /** AbortSignal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Result of executing a shell command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export declare function execCommand(command: string, args: string[], cwd: string, options?: ExecOptions): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/core/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}