npm - @ai-agent-forge/agent-forge - Versions diffs - 0.86.7 → 0.88.0 - Mend

@ai-agent-forge/agent-forge 0.86.7 → 0.88.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (717) hide show

package/dist/testing/plugin-testkit.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin-testkit.d.ts","sourceRoot":"","sources":["../../src/testing/plugin-testkit.ts"],"names":[],"mappings":"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","sourcesContent":["import { installBootstrapLifecycle } from \"../core/extensions/bootstrap-lifecycle.ts\";\nimport {\n\ttype CapabilityPluginFactory,\n\ttype CapabilityPluginHandle,\n\tloadCapabilityPlugin,\n} from \"../core/extensions/capability-plugin.ts\";\nimport {\n\ttype CapabilityRuntime,\n\tcreateCapabilityRuntime,\n\tresolvePluginCapabilityOrder,\n} from \"../core/extensions/capability-runtime.ts\";\nimport {\n\ttype CapabilityAPI,\n\ttype CapabilityDirectoryAPI,\n\ttype CapabilityProviderHandler,\n\ttype DisposableRegistration,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype HostCapabilities,\n\ttype LifecycleDispatchRequest,\n\ttype LifecycleDispatchResult,\n\ttype LifecycleEvent,\n\ttype LifecyclePhase,\n\ttype OperationHandle,\n\ttype OperationStatus,\n\ttype PluginCapabilityDeclaration,\n\ttype PluginManifest,\n\ttype RuntimeInspectorSnapshot,\n\ttype StateAPI,\n\ttype StateChange,\n\ttype StateEntry,\n\ttype StateSetOptions,\n} from \"../core/extensions/public-api.ts\";\n\n/*\n A deterministic, runtime-only fixture for experimental capability plugins.\n \n It deliberately does not create an AgentSession or a model provider. Tests\n * that need those integration points should use the existing session harness.\n /\nexport interface PluginTestKitPlugin {\n\treadonly manifest: PluginManifest;\n\treadonly factory: CapabilityPluginFactory;\n}\n\nexport interface PluginTestKitOptions {\n\treadonly plugins: readonly PluginTestKitPlugin[];\n\treadonly host?: Omit<HostCapabilities, \"apiVersion\">;\n\treadonly clock?: () => number;\n\t/* Injects stable runtime identifiers for deterministic transcript tests. /\n\treadonly idFactory?: (kind: string, sequence: number) => string;\n\t/* Logical root used to identify inline manifests without a host filesystem path. /\n\treadonly manifestRoot?: string;\n\t/\n\t Installs the bootstrap lifecycle catalog (host parity: the real session\n\t * host installs it) before the plugin load loop, so plugin factories can\n\t * registerObserve standard events. Off by default to keep existing\n\t * transcripts unchanged; the installed handle is disposed by\n\t * runtime.disposeAll() inside dispose().\n\t /\n\treadonly lifecycle?: boolean;\n}\n\nexport interface PluginTestKitManifestIdentity {\n\treadonly pluginId: string;\n\treadonly version: string;\n\treadonly entry: string;\n}\n\nexport interface PluginTestKitLifecycleEnvelope {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecycleEvent[\"phase\"];\n\treadonly deliveryId: string;\n\treadonly source: string;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data: unknown;\n}\n\nexport interface PluginTestKitLifecycleFailureReport {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecyclePhase;\n\treadonly status: \"transform-failed\" \| \"execute-failed\" \| \"delivered\" \| \"queued\";\n\treadonly attempted: number;\n\treadonly succeeded: number;\n\treadonly queued?: number;\n\treadonly failed: number;\n\treadonly failures: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly registrationId: string;\n\t\treadonly kind: string;\n\t\treadonly error: unknown;\n\t}[];\n}\n\n/* A dispatch rejection is retained even when no event envelope was created. /\nexport interface PluginTestKitLifecycleFailure {\n\treadonly eventId: string \| null;\n\treadonly type: string \| null;\n\treadonly version: number \| null;\n\treadonly phase: LifecyclePhase \| null;\n\treadonly deliveryId: string \| null;\n\treadonly source: string \| null;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data?: unknown;\n\treadonly status: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\treadonly error: unknown;\n\treadonly report?: PluginTestKitLifecycleFailureReport;\n}\n\nexport interface PluginTestKitStateMutation {\n\treadonly pluginId: string;\n\treadonly action: \"set\" \| \"delete\";\n\treadonly key: string;\n\treadonly status: \"committed\" \| \"rejected\";\n\treadonly revision?: number;\n\treadonly expectedRevision?: number;\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitStateWatchDelivery {\n\treadonly pluginId: string;\n\treadonly watcherId: string;\n\treadonly key: string;\n\treadonly revision: number;\n\treadonly status: \"delivered\" \| \"failed\";\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitCapabilityCall {\n\treadonly operationId: string \| null;\n\treadonly callerPluginId: string;\n\treadonly providerPluginId: string;\n\treadonly capabilityId: string;\n\treadonly capabilityVersion: number;\n\treadonly capabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\treadonly status: OperationStatus;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitTranscript {\n\treadonly version: 1;\n\treadonly manifestRoot: string;\n\treadonly manifests: readonly PluginTestKitManifestIdentity[];\n\treadonly inputOrder: readonly string[];\n\treadonly loadOrder: readonly string[];\n\treadonly state: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly entries: readonly StateEntry[];\n\t}[];\n\treadonly stateMutations: readonly PluginTestKitStateMutation[];\n\treadonly stateWatchDeliveries: readonly PluginTestKitStateWatchDelivery[];\n\treadonly capabilityCalls: readonly PluginTestKitCapabilityCall[];\n\treadonly lifecycleEvents: readonly PluginTestKitLifecycleEnvelope[];\n\treadonly lifecycleFailures: readonly PluginTestKitLifecycleFailure[];\n\treadonly lifecycleReports: RuntimeInspectorSnapshot[\"lifecycleReports\"];\n\treadonly inspector: RuntimeInspectorSnapshot;\n}\n\nexport interface PluginTestKit {\n\treadonly runtime: CapabilityRuntime;\n\t/* Resolves after every manifest is topology-ordered and its factory has loaded. /\n\treadonly ready: Promise<void>;\n\tapi(pluginId: string): CapabilityAPI;\n\trevoke(pluginId: string): void;\n\tinspect(): RuntimeInspectorSnapshot;\n\ttranscript(): PluginTestKitTranscript;\n\t/* Waits for lifecycle facts initiated by runtime-owned detached operations. /\n\tflushLifecycle(): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nfunction snapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate \|\| typeof candidate !== \"object\" \|\| ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\nfunction transcriptValue(value: unknown, seen = new WeakSet<object>()): unknown {\n\tif (value === null \|\| typeof value === \"string\" \|\| typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return `${value}n`;\n\tif (value === undefined) return null;\n\tif (value instanceof Error) {\n\t\tif (seen.has(value)) return \"[Circular]\";\n\t\tseen.add(value);\n\t\tconst output: Record<string, unknown> = { name: value.name, message: value.message };\n\t\tconst code = (value as Error & { code?: unknown }).code;\n\t\tif (code !== undefined) output.code = transcriptValue(code, seen);\n\t\tconst cause = (value as Error & { cause?: unknown }).cause;\n\t\tif (cause !== undefined) output.cause = transcriptValue(cause, seen);\n\t\tfor (const key of Object.keys(value).sort()) {\n\t\t\tif (key === \"code\" \|\| key === \"cause\") continue;\n\t\t\toutput[key] = transcriptValue((value as unknown as Record<string, unknown>)[key], seen);\n\t\t}\n\t\treturn output;\n\t}\n\tif (typeof value !== \"object\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\tif (Array.isArray(value)) return value.map((item) => transcriptValue(item, seen));\n\tconst output: Record<string, unknown> = {};\n\tfor (const key of Object.keys(value as Record<string, unknown>).sort()) {\n\t\toutput[key] = transcriptValue((value as Record<string, unknown>)[key], seen);\n\t}\n\treturn output;\n}\n\nfunction canonicalJson(value: unknown): string {\n\tconst serialized = JSON.stringify(transcriptValue(value));\n\t// v8 ignore next -- transcriptValue 已消毒全部值，JSON.stringify 不会返回 undefined\n\tif (serialized === undefined) throw new Error(\"Plugin testkit transcript is not JSON-serializable\");\n\treturn serialized;\n}\n\ntype PluginTestKitLifecycleReport = PluginTestKitLifecycleFailureReport;\n\nfunction lifecycleFailureReport(error: unknown): PluginTestKitLifecycleReport \| undefined {\n\tif (!error \|\| typeof error !== \"object\") return undefined;\n\tconst report = (error as { report?: unknown }).report;\n\tif (!report \|\| typeof report !== \"object\") return undefined;\n\tconst candidate = report as RuntimeInspectorSnapshot[\"lifecycleReports\"][number];\n\t// v8 ignore next -- report 由 runtime 构造、形状恒满足；此处仅防御伪造的 report\n\tif (\n\t\ttypeof candidate.eventId !== \"string\" \|\|\n\t\ttypeof candidate.type !== \"string\" \|\|\n\t\t!Number.isSafeInteger(candidate.version) \|\|\n\t\t(candidate.phase !== \"raw\" && candidate.phase !== \"candidate\" && candidate.phase !== \"committed\") \|\|\n\t\t(candidate.status !== \"transform-failed\" &&\n\t\t\tcandidate.status !== \"execute-failed\" &&\n\t\t\tcandidate.status !== \"delivered\") \|\|\n\t\t!Array.isArray(candidate.failures)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\teventId: candidate.eventId,\n\t\ttype: candidate.type,\n\t\tversion: candidate.version,\n\t\tphase: candidate.phase,\n\t\tstatus: candidate.status,\n\t\tattempted: candidate.attempted,\n\t\tsucceeded: candidate.succeeded,\n\t\tfailed: candidate.failed,\n\t\tfailures: candidate.failures.map((failure) => ({\n\t\t\tpluginId: failure.pluginId,\n\t\t\tregistrationId: failure.registrationId,\n\t\t\tkind: failure.kind,\n\t\t\terror: transcriptValue(failure.error),\n\t\t})),\n\t};\n}\n\nfunction defaultHost(): HostCapabilities {\n\treturn {\n\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\tmode: \"full-control\",\n\t\tfeatures: [\"logger-v1\", \"diagnostics-v1\", \"plugin-state-v1\", \"runtime-inspector-v1\"],\n\t\ttransports: [\"in-process\"],\n\t};\n}\n\nconst DEFAULT_MANIFEST_ROOT = \"<plugin-testkit>\";\n\ninterface MutablePluginTestKitStateMutation {\n\tpluginId: string;\n\taction: \"set\" \| \"delete\";\n\tkey: string;\n\tstatus: \"committed\" \| \"rejected\";\n\trevision?: number;\n\texpectedRevision?: number;\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitStateWatchDelivery {\n\tpluginId: string;\n\twatcherId: string;\n\tkey: string;\n\trevision: number;\n\tstatus: \"delivered\" \| \"failed\";\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitCapabilityCall {\n\toperationId: string \| null;\n\tcallerPluginId: string;\n\tproviderPluginId: string;\n\tcapabilityId: string;\n\tcapabilityVersion: number;\n\tcapabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\tstatus: OperationStatus;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitLifecycleFailure {\n\teventId: string \| null;\n\ttype: string \| null;\n\tversion: number \| null;\n\tphase: LifecyclePhase \| null;\n\tdeliveryId: string \| null;\n\tsource: string \| null;\n\toperationId?: string;\n\tcorrelationId?: string;\n\tcausationId?: string;\n\tdata?: unknown;\n\tstatus: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\terror: unknown;\n\treport?: PluginTestKitLifecycleFailureReport;\n}\n\n/* Create a runtime-only fixture with deterministic topology and teardown. /\nexport function createPluginTestKit(options: PluginTestKitOptions): PluginTestKit {\n\tconst manifestRoot = options.manifestRoot ?? DEFAULT_MANIFEST_ROOT;\n\tif (typeof manifestRoot !== \"string\" \|\| !manifestRoot.trim()) {\n\t\tthrow new Error(\"Plugin testkit manifestRoot must be a non-empty string\");\n\t}\n\tconst inputPlugins = options.plugins.map((plugin) => ({\n\t\tmanifest: snapshot(plugin.manifest),\n\t\tfactory: plugin.factory,\n\t}));\n\tconst suppliedHost = options.host;\n\tconst host: HostCapabilities = {\n\t\t...defaultHost(),\n\t\t...suppliedHost,\n\t\tfeatures: suppliedHost?.features ?? defaultHost().features,\n\t\ttransports: suppliedHost?.transports ?? defaultHost().transports,\n\t};\n\tconst pluginsByManifest = new Map(inputPlugins.map((plugin) => [plugin.manifest, plugin]));\n\tconst handles = new Map<string, CapabilityPluginHandle>();\n\tconst revokedState = new Map<string, readonly StateEntry[]>();\n\tconst retainedState = new Map<string, readonly StateEntry[]>();\n\tconst loadOrder: string[] = [];\n\tconst stateMutations: MutablePluginTestKitStateMutation[] = [];\n\tconst stateWatchDeliveries: MutablePluginTestKitStateWatchDelivery[] = [];\n\tconst capabilityCalls: MutablePluginTestKitCapabilityCall[] = [];\n\tconst lifecycleEvents: PluginTestKitLifecycleEnvelope[] = [];\n\tconst lifecycleFailures: MutablePluginTestKitLifecycleFailure[] = [];\n\tconst pendingLifecycleDispatches = new Set<Promise<void>>();\n\tlet disposePromise: Promise<void> \| undefined;\n\tconst recordLifecycleDispatch = (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t): void => {\n\t\tconst recorded = settled.then(\n\t\t\t(result) => {\n\t\t\t\tlifecycleEvents.push(\n\t\t\t\t\tsnapshot({\n\t\t\t\t\t\teventId: result.event.id,\n\t\t\t\t\t\ttype: result.event.type,\n\t\t\t\t\t\tversion: result.event.version,\n\t\t\t\t\t\tphase: result.event.phase,\n\t\t\t\t\t\tdeliveryId: result.event.deliveryId,\n\t\t\t\t\t\tsource: result.event.source,\n\t\t\t\t\t\t...(result.event.operationId === undefined ? {} : { operationId: result.event.operationId }),\n\t\t\t\t\t\t...(result.event.correlationId === undefined ? {} : { correlationId: result.event.correlationId }),\n\t\t\t\t\t\t...(result.event.causationId === undefined ? {} : { causationId: result.event.causationId }),\n\t\t\t\t\t\tdata: transcriptValue(result.event.data),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tconst requestObject =\n\t\t\t\t\trequest && typeof request === \"object\" ? (request as unknown as Record<string, unknown>) : undefined;\n\t\t\t\tconst report = lifecycleFailureReport(error);\n\t\t\t\tconst rawPhase = requestObject?.phase;\n\t\t\t\tconst phase: LifecyclePhase \| null =\n\t\t\t\t\trawPhase === \"raw\" \|\| rawPhase === \"candidate\" \|\| rawPhase === \"committed\" ? rawPhase : null;\n\t\t\t\tconst rawSource = requestObject?.source;\n\t\t\t\tconst source =\n\t\t\t\t\trawSource === undefined\n\t\t\t\t\t\t? requestObject === undefined\n\t\t\t\t\t\t\t? null\n\t\t\t\t\t\t\t: \"host\"\n\t\t\t\t\t\t: typeof rawSource === \"string\"\n\t\t\t\t\t\t\t? rawSource\n\t\t\t\t\t\t\t: null;\n\t\t\t\tconst rawVersion = requestObject?.version;\n\t\t\t\tconst version = typeof rawVersion === \"number\" && Number.isSafeInteger(rawVersion) ? rawVersion : null;\n\t\t\t\tconst failure: MutablePluginTestKitLifecycleFailure = {\n\t\t\t\t\teventId: report?.eventId ?? null,\n\t\t\t\t\ttype: typeof requestObject?.type === \"string\" ? requestObject.type : null,\n\t\t\t\t\tversion,\n\t\t\t\t\tphase,\n\t\t\t\t\tdeliveryId: null,\n\t\t\t\t\tsource,\n\t\t\t\t\t...(typeof requestObject?.operationId === \"string\" ? { operationId: requestObject.operationId } : {}),\n\t\t\t\t\t...(typeof requestObject?.correlationId === \"string\"\n\t\t\t\t\t\t? { correlationId: requestObject.correlationId }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\t...(typeof requestObject?.causationId === \"string\" ? { causationId: requestObject.causationId } : {}),\n\t\t\t\t\t...(requestObject !== undefined && \"data\" in requestObject\n\t\t\t\t\t\t? { data: transcriptValue(requestObject.data) }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\tstatus:\n\t\t\t\t\t\treport?.status === \"transform-failed\" \|\| report?.status === \"execute-failed\"\n\t\t\t\t\t\t\t? report.status\n\t\t\t\t\t\t\t: requestObject?.signal instanceof AbortSignal && requestObject.signal.aborted\n\t\t\t\t\t\t\t\t? \"cancelled\"\n\t\t\t\t\t\t\t\t: \"rejected\",\n\t\t\t\t\terror: transcriptValue(error),\n\t\t\t\t\t...(report === undefined ? {} : { report }),\n\t\t\t\t};\n\t\t\t\tlifecycleFailures.push(snapshot(failure));\n\t\t\t},\n\t\t);\n\t\tpendingLifecycleDispatches.add(recorded);\n\t\tvoid recorded.then(() => pendingLifecycleDispatches.delete(recorded));\n\t};\n\tconst runtime = createCapabilityRuntime(host, {\n\t\tclock: options.clock ?? (() => 0),\n\t\tidFactory: options.idFactory ?? ((kind, sequence) => `testkit:${kind}:${sequence}`),\n\t\tonLifecycleDispatch: recordLifecycleDispatch,\n\t});\n\t// Must run before the ready loop: plugin factories registerObserve during load.\n\tif (options.lifecycle === true) installBootstrapLifecycle(runtime);\n\n\tconst inputManifests = inputPlugins.map(({ manifest }) => ({\n\t\tpluginId: manifest.id,\n\t\tversion: manifest.version,\n\t\tentry: manifest.entry,\n\t}));\n\tconst inputOrder = inputPlugins.map(({ manifest }) => manifest.id);\n\tconst wrappedToRawAPI = new WeakMap<CapabilityAPI, CapabilityAPI>();\n\tconst wrapStateAPI = (pluginId: string, state: StateAPI): StateAPI => {\n\t\tconst operationMetadata = (options?: StateSetOptions) => ({\n\t\t\t...(options?.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),\n\t\t\t...(options?.operationId === undefined ? {} : { operationId: options.operationId }),\n\t\t\t...(options?.correlationId === undefined ? {} : { correlationId: options.correlationId }),\n\t\t});\n\t\tconst recordMutation = (\n\t\t\taction: \"set\" \| \"delete\",\n\t\t\tkey: string,\n\t\t\tmetadata: ReturnType<typeof operationMetadata>,\n\t\t\tresult: { status: \"committed\"; revision: number; value?: unknown } \| { status: \"rejected\"; error: unknown },\n\t\t): void => {\n\t\t\tstateMutations.push({\n\t\t\t\tpluginId,\n\t\t\t\taction,\n\t\t\t\tkey,\n\t\t\t\t...metadata,\n\t\t\t\t...result,\n\t\t\t});\n\t\t};\n\t\treturn Object.freeze({\n\t\t\tget: (key: string) => state.get(key),\n\t\t\tset: (key: string, value: Parameters<StateAPI[\"set\"]>[1], options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.set(key, value, options);\n\t\t\t\t\trecordMutation(\"set\", key, metadata, {\n\t\t\t\t\t\tstatus: \"committed\",\n\t\t\t\t\t\trevision,\n\t\t\t\t\t\tvalue: transcriptValue(value),\n\t\t\t\t\t});\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"set\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelete: (key: string, options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.delete(key, options);\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"committed\", revision });\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tlist: (prefix?: string) => state.list(prefix),\n\t\t\twatch: (prefix: string \| undefined, handler: (change: StateChange) => void) => {\n\t\t\t\tlet watcherId = \"<pending>\";\n\t\t\t\tconst registration = state.watch(prefix, (change) => {\n\t\t\t\t\tconst delivery: MutablePluginTestKitStateWatchDelivery = {\n\t\t\t\t\t\tpluginId,\n\t\t\t\t\t\twatcherId,\n\t\t\t\t\t\tkey: change.key,\n\t\t\t\t\t\trevision: change.revision,\n\t\t\t\t\t\tstatus: \"delivered\",\n\t\t\t\t\t\t...(change.value === undefined ? {} : { value: transcriptValue(change.value) }),\n\t\t\t\t\t\t...(change.operationId === undefined ? {} : { operationId: change.operationId }),\n\t\t\t\t\t\t...(change.correlationId === undefined ? {} : { correlationId: change.correlationId }),\n\t\t\t\t\t};\n\t\t\t\t\tstateWatchDeliveries.push(delivery);\n\t\t\t\t\ttry {\n\t\t\t\t\t\thandler(change);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tdelivery.status = \"failed\";\n\t\t\t\t\t\tdelivery.error = transcriptValue(error);\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\twatcherId = registration.id;\n\t\t\t\treturn registration;\n\t\t\t},\n\t\t});\n\t};\n\tconst wrapCapabilityDirectory = (\n\t\tcallerPluginId: string,\n\t\tcapabilities: CapabilityDirectoryAPI,\n\t): CapabilityDirectoryAPI =>\n\t\tObject.freeze({\n\t\t\tprovide: <TInput = unknown, TResult = unknown>(\n\t\t\t\tdeclaration: PluginCapabilityDeclaration,\n\t\t\t\thandler: CapabilityProviderHandler<TInput, TResult>,\n\t\t\t): DisposableRegistration => capabilities.provide(declaration, handler),\n\t\t\trequire: <TResult = unknown>(id: string, requireOptions?: { version?: number }) => {\n\t\t\t\tconst handle = capabilities.require<TResult>(id, requireOptions);\n\t\t\t\treturn Object.freeze({\n\t\t\t\t\tdeclaration: handle.declaration,\n\t\t\t\t\towner: handle.owner,\n\t\t\t\t\tcall: (input: unknown, callOptions?: { signal?: AbortSignal }): OperationHandle<TResult> => {\n\t\t\t\t\t\tlet operation: OperationHandle<TResult>;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\toperation = handle.call(input, callOptions);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tcapabilityCalls.push({\n\t\t\t\t\t\t\t\toperationId: null,\n\t\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\terror: transcriptValue(error),\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\tconst record: MutablePluginTestKitCapabilityCall = {\n\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\tstatus: operation.status(),\n\t\t\t\t\t\t};\n\t\t\t\t\t\tcapabilityCalls.push(record);\n\t\t\t\t\t\tvoid operation.result.then(\n\t\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(error) => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t\trecord.error = transcriptValue(error);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn operation;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t},\n\t\t\tlist: (listOptions?: { kind?: PluginCapabilityDeclaration[\"kind\"] }) => capabilities.list(listOptions),\n\t\t});\n\tconst originalCreateAPI = runtime.createAPI.bind(runtime);\n\tconst originalRevokeAPI = runtime.revokeAPI.bind(runtime);\n\truntime.createAPI = (manifest) => {\n\t\tconst rawAPI = originalCreateAPI(manifest);\n\t\tconst wrappedAPI = Object.freeze({\n\t\t\t...rawAPI,\n\t\t\tcapabilities: wrapCapabilityDirectory(rawAPI.manifest.id, rawAPI.capabilities),\n\t\t\t...(rawAPI.state === undefined ? {} : { state: wrapStateAPI(rawAPI.manifest.id, rawAPI.state) }),\n\t\t});\n\t\twrappedToRawAPI.set(wrappedAPI, rawAPI);\n\t\treturn wrappedAPI;\n\t};\n\truntime.revokeAPI = (api) => {\n\t\t// v8 ignore next -- 所有 API 均经包装后的 createAPI 创建，映射必命中\n\t\tconst rawAPI = wrappedToRawAPI.get(api) ?? api;\n\t\tfor (const [pluginId, handle] of handles) {\n\t\t\tif (handle.api === api \|\| handle.api === rawAPI) captureState(pluginId, handle);\n\t\t}\n\t\toriginalRevokeAPI(rawAPI);\n\t};\n\n\tconst captureState = (pluginId: string, handle: CapabilityPluginHandle): void => {\n\t\tif (retainedState.has(pluginId) \|\| revokedState.has(pluginId)) return;\n\t\tretainedState.set(pluginId, snapshot(handle.api.state?.list() ?? []));\n\t};\n\tconst stateTranscript = (): readonly { readonly pluginId: string; readonly entries: readonly StateEntry[] }[] =>\n\t\t[...handles.entries()].map(([pluginId, handle]) => {\n\t\t\treturn {\n\t\t\t\tpluginId,\n\t\t\t\tentries: retainedState.get(pluginId) ?? snapshot(handle.api.state?.list() ?? []),\n\t\t\t};\n\t\t});\n\n\tlet closing = false;\n\tconst ready = (async () => {\n\t\ttry {\n\t\t\tconst ordered = resolvePluginCapabilityOrder(inputPlugins.map((plugin) => plugin.manifest));\n\t\t\tfor (const manifest of ordered) {\n\t\t\t\tif (closing) throw new Error(\"Plugin testkit was disposed during startup\");\n\t\t\t\tconst plugin = pluginsByManifest.get(manifest);\n\t\t\t\t// v8 ignore next -- plugins 数组同时供给加载顺序与 factory 映射，必可解析\n\t\t\t\tif (!plugin) throw new Error(`Plugin testkit cannot resolve factory: ${manifest.id}`);\n\t\t\t\tconst handle = await loadCapabilityPlugin(runtime, plugin.manifest, plugin.factory);\n\t\t\t\thandles.set(manifest.id, handle);\n\t\t\t\tloadOrder.push(manifest.id);\n\t\t\t}\n\t\t} catch (startupError) {\n\t\t\tconst failures: unknown[] = [startupError];\n\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\ttry {\n\t\t\t\t\tawait handle.dispose();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t}\n\t\t\thandles.clear();\n\t\t\ttry {\n\t\t\t\tawait runtime.disposeAll();\n\t\t\t} catch (error) {\n\t\t\t\tfailures.push(error);\n\t\t\t}\n\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit startup rollback failed\");\n\t\t\tthrow startupError;\n\t\t}\n\t})();\n\n\treturn {\n\t\truntime,\n\t\tready,\n\t\tapi(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\treturn handle.api;\n\t\t},\n\t\trevoke(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\tif (handle.api.state) {\n\t\t\t\tconst entries = snapshot(handle.api.state.list());\n\t\t\t\trevokedState.set(pluginId, entries);\n\t\t\t\tretainedState.set(pluginId, entries);\n\t\t\t}\n\t\t\truntime.revokeAPI(handle.api);\n\t\t},\n\t\tinspect: () => runtime.inspect(),\n\t\tflushLifecycle: async () => {\n\t\t\twhile (pendingLifecycleDispatches.size > 0) {\n\t\t\t\tawait Promise.all([...pendingLifecycleDispatches]);\n\t\t\t}\n\t\t\tawait runtime.drainLifecycleDeliveries();\n\t\t},\n\t\ttranscript: () =>\n\t\t\tsnapshot(\n\t\t\t\ttranscriptValue({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tmanifestRoot,\n\t\t\t\t\tmanifests: inputManifests,\n\t\t\t\t\tinputOrder,\n\t\t\t\t\tloadOrder,\n\t\t\t\t\tstate: stateTranscript(),\n\t\t\t\t\tstateMutations,\n\t\t\t\t\tstateWatchDeliveries,\n\t\t\t\t\tcapabilityCalls,\n\t\t\t\t\tlifecycleEvents,\n\t\t\t\t\tlifecycleFailures,\n\t\t\t\t\tlifecycleReports: runtime.inspect().lifecycleReports,\n\t\t\t\t\tinspector: runtime.inspect(),\n\t\t\t\t}) as PluginTestKitTranscript,\n\t\t\t),\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tclosing = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\ttry {\n\t\t\t\t\tawait ready;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!(error instanceof Error && error.message === \"Plugin testkit was disposed during startup\")) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfor (const [pluginId, handle] of handles) captureState(pluginId, handle);\n\t\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait handle.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\ttry {\n\t\t\t\t\tawait runtime.disposeAll();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n}\n\n/* Runs a fixture repeatedly and rejects on the first transcript divergence. */\nexport async function repeatPluginTestKit(\n\ttimes: number,\n\trun: () => Promise<PluginTestKitTranscript>,\n): Promise<PluginTestKitTranscript> {\n\tif (!Number.isSafeInteger(times) \|\| times < 1)\n\t\tthrow new Error(\"Plugin testkit repeat count must be a positive integer\");\n\tlet baseline: PluginTestKitTranscript \| undefined;\n\tfor (let index = 0; index < times; index += 1) {\n\t\tconst transcript = await run();\n\t\tif (baseline && canonicalJson(transcript) !== canonicalJson(baseline)) {\n\t\t\tthrow new Error(`Plugin testkit transcript diverged on run ${index + 1}`);\n\t\t}\n\t\tbaseline = transcript;\n\t}\n\treturn baseline!;\n}\n"]}
1	+ {"version":3,"file":"plugin-testkit.d.ts","sourceRoot":"","sources":["../../src/testing/plugin-testkit.ts"],"names":[],"mappings":"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","sourcesContent":["import { installBootstrapLifecycle } from \"../core/extensions/bootstrap-lifecycle.ts\";\nimport {\n\ttype CapabilityPluginFactory,\n\ttype CapabilityPluginHandle,\n\tloadCapabilityPlugin,\n} from \"../core/extensions/capability-plugin.ts\";\nimport {\n\ttype CapabilityRuntime,\n\tcreateCapabilityRuntime,\n\tresolvePluginCapabilityOrder,\n} from \"../core/extensions/capability-runtime.ts\";\nimport {\n\ttype CapabilityAPI,\n\ttype CapabilityDirectoryAPI,\n\ttype CapabilityProviderHandler,\n\ttype DisposableRegistration,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype HostCapabilities,\n\ttype LifecycleDispatchRequest,\n\ttype LifecycleDispatchResult,\n\ttype LifecycleEvent,\n\ttype LifecyclePhase,\n\ttype OperationHandle,\n\ttype OperationStatus,\n\ttype PluginCapabilityDeclaration,\n\ttype PluginManifest,\n\ttype RuntimeInspectorSnapshot,\n\ttype StateAPI,\n\ttype StateChange,\n\ttype StateEntry,\n\ttype StateSetOptions,\n} from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\n\n/*\n A deterministic, runtime-only fixture for experimental capability plugins.\n \n It deliberately does not create an AgentSession or a model provider. Tests\n * that need those integration points should use the existing session harness.\n /\nexport interface PluginTestKitPlugin {\n\treadonly manifest: PluginManifest;\n\treadonly factory: CapabilityPluginFactory;\n}\n\nexport interface PluginTestKitOptions {\n\treadonly plugins: readonly PluginTestKitPlugin[];\n\treadonly host?: Omit<HostCapabilities, \"apiVersion\">;\n\treadonly clock?: () => number;\n\t/* Injects stable runtime identifiers for deterministic transcript tests. /\n\treadonly idFactory?: (kind: string, sequence: number) => string;\n\t/* Logical root used to identify inline manifests without a host filesystem path. /\n\treadonly manifestRoot?: string;\n\t/\n\t Installs the bootstrap lifecycle catalog (host parity: the real session\n\t * host installs it) before the plugin load loop, so plugin factories can\n\t * registerObserve standard events. Off by default to keep existing\n\t * transcripts unchanged; the installed handle is disposed by\n\t * runtime.disposeAll() inside dispose().\n\t /\n\treadonly lifecycle?: boolean;\n}\n\nexport interface PluginTestKitManifestIdentity {\n\treadonly pluginId: string;\n\treadonly version: string;\n\treadonly entry: string;\n}\n\nexport interface PluginTestKitLifecycleEnvelope {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecycleEvent[\"phase\"];\n\treadonly deliveryId: string;\n\treadonly source: string;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data: unknown;\n}\n\nexport interface PluginTestKitLifecycleFailureReport {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecyclePhase;\n\treadonly status: \"transform-failed\" \| \"execute-failed\" \| \"delivered\" \| \"queued\";\n\treadonly attempted: number;\n\treadonly succeeded: number;\n\treadonly queued?: number;\n\treadonly failed: number;\n\treadonly failures: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly registrationId: string;\n\t\treadonly kind: string;\n\t\treadonly error: unknown;\n\t}[];\n}\n\n/* A dispatch rejection is retained even when no event envelope was created. /\nexport interface PluginTestKitLifecycleFailure {\n\treadonly eventId: string \| null;\n\treadonly type: string \| null;\n\treadonly version: number \| null;\n\treadonly phase: LifecyclePhase \| null;\n\treadonly deliveryId: string \| null;\n\treadonly source: string \| null;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data?: unknown;\n\treadonly status: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\treadonly error: unknown;\n\treadonly report?: PluginTestKitLifecycleFailureReport;\n}\n\nexport interface PluginTestKitStateMutation {\n\treadonly pluginId: string;\n\treadonly action: \"set\" \| \"delete\";\n\treadonly key: string;\n\treadonly status: \"committed\" \| \"rejected\";\n\treadonly revision?: number;\n\treadonly expectedRevision?: number;\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitStateWatchDelivery {\n\treadonly pluginId: string;\n\treadonly watcherId: string;\n\treadonly key: string;\n\treadonly revision: number;\n\treadonly status: \"delivered\" \| \"failed\";\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitCapabilityCall {\n\treadonly operationId: string \| null;\n\treadonly callerPluginId: string;\n\treadonly providerPluginId: string;\n\treadonly capabilityId: string;\n\treadonly capabilityVersion: number;\n\treadonly capabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\treadonly status: OperationStatus;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitTranscript {\n\treadonly version: 1;\n\treadonly manifestRoot: string;\n\treadonly manifests: readonly PluginTestKitManifestIdentity[];\n\treadonly inputOrder: readonly string[];\n\treadonly loadOrder: readonly string[];\n\treadonly state: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly entries: readonly StateEntry[];\n\t}[];\n\treadonly stateMutations: readonly PluginTestKitStateMutation[];\n\treadonly stateWatchDeliveries: readonly PluginTestKitStateWatchDelivery[];\n\treadonly capabilityCalls: readonly PluginTestKitCapabilityCall[];\n\treadonly lifecycleEvents: readonly PluginTestKitLifecycleEnvelope[];\n\treadonly lifecycleFailures: readonly PluginTestKitLifecycleFailure[];\n\treadonly lifecycleReports: RuntimeInspectorSnapshot[\"lifecycleReports\"];\n\treadonly inspector: RuntimeInspectorSnapshot;\n}\n\nexport interface PluginTestKit {\n\treadonly runtime: CapabilityRuntime;\n\t/* Resolves after every manifest is topology-ordered and its factory has loaded. /\n\treadonly ready: Promise<void>;\n\tapi(pluginId: string): CapabilityAPI;\n\trevoke(pluginId: string): void;\n\tinspect(): RuntimeInspectorSnapshot;\n\ttranscript(): PluginTestKitTranscript;\n\t/* Waits for lifecycle facts initiated by runtime-owned detached operations. /\n\tflushLifecycle(): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nfunction snapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate \|\| typeof candidate !== \"object\" \|\| ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\nfunction transcriptValue(value: unknown, seen = new WeakSet<object>()): unknown {\n\tif (value === null \|\| typeof value === \"string\" \|\| typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return `${value}n`;\n\tif (value === undefined) return null;\n\tif (value instanceof Error) {\n\t\tif (seen.has(value)) return \"[Circular]\";\n\t\tseen.add(value);\n\t\tconst output: Record<string, unknown> = { name: value.name, message: value.message };\n\t\tconst code = (value as Error & { code?: unknown }).code;\n\t\tif (code !== undefined) output.code = transcriptValue(code, seen);\n\t\tconst cause = (value as Error & { cause?: unknown }).cause;\n\t\tif (cause !== undefined) output.cause = transcriptValue(cause, seen);\n\t\tfor (const key of Object.keys(value).sort()) {\n\t\t\tif (key === \"code\" \|\| key === \"cause\") continue;\n\t\t\toutput[key] = transcriptValue((value as unknown as Record<string, unknown>)[key], seen);\n\t\t}\n\t\treturn output;\n\t}\n\tif (typeof value !== \"object\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\tif (Array.isArray(value)) return value.map((item) => transcriptValue(item, seen));\n\tconst output: Record<string, unknown> = {};\n\tfor (const key of Object.keys(value as Record<string, unknown>).sort()) {\n\t\toutput[key] = transcriptValue((value as Record<string, unknown>)[key], seen);\n\t}\n\treturn output;\n}\n\nfunction canonicalJson(value: unknown): string {\n\tconst serialized = JSON.stringify(transcriptValue(value));\n\t// v8 ignore next -- transcriptValue 已消毒全部值，JSON.stringify 不会返回 undefined\n\tif (serialized === undefined) throw new Error(\"Plugin testkit transcript is not JSON-serializable\");\n\treturn serialized;\n}\n\ntype PluginTestKitLifecycleReport = PluginTestKitLifecycleFailureReport;\n\nfunction lifecycleFailureReport(error: unknown): PluginTestKitLifecycleReport \| undefined {\n\tif (!error \|\| typeof error !== \"object\") return undefined;\n\tconst report = (error as { report?: unknown }).report;\n\tif (!report \|\| typeof report !== \"object\") return undefined;\n\tconst candidate = report as RuntimeInspectorSnapshot[\"lifecycleReports\"][number];\n\t// v8 ignore next -- report 由 runtime 构造、形状恒满足；此处仅防御伪造的 report\n\tif (\n\t\ttypeof candidate.eventId !== \"string\" \|\|\n\t\ttypeof candidate.type !== \"string\" \|\|\n\t\t!Number.isSafeInteger(candidate.version) \|\|\n\t\t(candidate.phase !== \"raw\" && candidate.phase !== \"candidate\" && candidate.phase !== \"committed\") \|\|\n\t\t(candidate.status !== \"transform-failed\" &&\n\t\t\tcandidate.status !== \"execute-failed\" &&\n\t\t\tcandidate.status !== \"delivered\") \|\|\n\t\t!Array.isArray(candidate.failures)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\teventId: candidate.eventId,\n\t\ttype: candidate.type,\n\t\tversion: candidate.version,\n\t\tphase: candidate.phase,\n\t\tstatus: candidate.status,\n\t\tattempted: candidate.attempted,\n\t\tsucceeded: candidate.succeeded,\n\t\tfailed: candidate.failed,\n\t\tfailures: candidate.failures.map((failure) => ({\n\t\t\tpluginId: failure.pluginId,\n\t\t\tregistrationId: failure.registrationId,\n\t\t\tkind: failure.kind,\n\t\t\terror: transcriptValue(failure.error),\n\t\t})),\n\t};\n}\n\nfunction defaultHost(): HostCapabilities {\n\treturn {\n\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\tmode: \"full-control\",\n\t\tfeatures: [\"logger-v1\", \"diagnostics-v1\", \"plugin-state-v1\", \"runtime-inspector-v1\"],\n\t\ttransports: [\"in-process\"],\n\t};\n}\n\nconst DEFAULT_MANIFEST_ROOT = \"<plugin-testkit>\";\n\ninterface MutablePluginTestKitStateMutation {\n\tpluginId: string;\n\taction: \"set\" \| \"delete\";\n\tkey: string;\n\tstatus: \"committed\" \| \"rejected\";\n\trevision?: number;\n\texpectedRevision?: number;\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitStateWatchDelivery {\n\tpluginId: string;\n\twatcherId: string;\n\tkey: string;\n\trevision: number;\n\tstatus: \"delivered\" \| \"failed\";\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitCapabilityCall {\n\toperationId: string \| null;\n\tcallerPluginId: string;\n\tproviderPluginId: string;\n\tcapabilityId: string;\n\tcapabilityVersion: number;\n\tcapabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\tstatus: OperationStatus;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitLifecycleFailure {\n\teventId: string \| null;\n\ttype: string \| null;\n\tversion: number \| null;\n\tphase: LifecyclePhase \| null;\n\tdeliveryId: string \| null;\n\tsource: string \| null;\n\toperationId?: string;\n\tcorrelationId?: string;\n\tcausationId?: string;\n\tdata?: unknown;\n\tstatus: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\terror: unknown;\n\treport?: PluginTestKitLifecycleFailureReport;\n}\n\n/* Create a runtime-only fixture with deterministic topology and teardown. /\nexport function createPluginTestKit(options: PluginTestKitOptions): PluginTestKit {\n\tconst manifestRoot = options.manifestRoot ?? DEFAULT_MANIFEST_ROOT;\n\tif (typeof manifestRoot !== \"string\" \|\| !manifestRoot.trim()) {\n\t\tthrow new Error(t(\"Plugin testkit manifestRoot must be a non-empty string\"));\n\t}\n\tconst inputPlugins = options.plugins.map((plugin) => ({\n\t\tmanifest: snapshot(plugin.manifest),\n\t\tfactory: plugin.factory,\n\t}));\n\tconst suppliedHost = options.host;\n\tconst host: HostCapabilities = {\n\t\t...defaultHost(),\n\t\t...suppliedHost,\n\t\tfeatures: suppliedHost?.features ?? defaultHost().features,\n\t\ttransports: suppliedHost?.transports ?? defaultHost().transports,\n\t};\n\tconst pluginsByManifest = new Map(inputPlugins.map((plugin) => [plugin.manifest, plugin]));\n\tconst handles = new Map<string, CapabilityPluginHandle>();\n\tconst revokedState = new Map<string, readonly StateEntry[]>();\n\tconst retainedState = new Map<string, readonly StateEntry[]>();\n\tconst loadOrder: string[] = [];\n\tconst stateMutations: MutablePluginTestKitStateMutation[] = [];\n\tconst stateWatchDeliveries: MutablePluginTestKitStateWatchDelivery[] = [];\n\tconst capabilityCalls: MutablePluginTestKitCapabilityCall[] = [];\n\tconst lifecycleEvents: PluginTestKitLifecycleEnvelope[] = [];\n\tconst lifecycleFailures: MutablePluginTestKitLifecycleFailure[] = [];\n\tconst pendingLifecycleDispatches = new Set<Promise<void>>();\n\tlet disposePromise: Promise<void> \| undefined;\n\tconst recordLifecycleDispatch = (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t): void => {\n\t\tconst recorded = settled.then(\n\t\t\t(result) => {\n\t\t\t\tlifecycleEvents.push(\n\t\t\t\t\tsnapshot({\n\t\t\t\t\t\teventId: result.event.id,\n\t\t\t\t\t\ttype: result.event.type,\n\t\t\t\t\t\tversion: result.event.version,\n\t\t\t\t\t\tphase: result.event.phase,\n\t\t\t\t\t\tdeliveryId: result.event.deliveryId,\n\t\t\t\t\t\tsource: result.event.source,\n\t\t\t\t\t\t...(result.event.operationId === undefined ? {} : { operationId: result.event.operationId }),\n\t\t\t\t\t\t...(result.event.correlationId === undefined ? {} : { correlationId: result.event.correlationId }),\n\t\t\t\t\t\t...(result.event.causationId === undefined ? {} : { causationId: result.event.causationId }),\n\t\t\t\t\t\tdata: transcriptValue(result.event.data),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tconst requestObject =\n\t\t\t\t\trequest && typeof request === \"object\" ? (request as unknown as Record<string, unknown>) : undefined;\n\t\t\t\tconst report = lifecycleFailureReport(error);\n\t\t\t\tconst rawPhase = requestObject?.phase;\n\t\t\t\tconst phase: LifecyclePhase \| null =\n\t\t\t\t\trawPhase === \"raw\" \|\| rawPhase === \"candidate\" \|\| rawPhase === \"committed\" ? rawPhase : null;\n\t\t\t\tconst rawSource = requestObject?.source;\n\t\t\t\tconst source =\n\t\t\t\t\trawSource === undefined\n\t\t\t\t\t\t? requestObject === undefined\n\t\t\t\t\t\t\t? null\n\t\t\t\t\t\t\t: \"host\"\n\t\t\t\t\t\t: typeof rawSource === \"string\"\n\t\t\t\t\t\t\t? rawSource\n\t\t\t\t\t\t\t: null;\n\t\t\t\tconst rawVersion = requestObject?.version;\n\t\t\t\tconst version = typeof rawVersion === \"number\" && Number.isSafeInteger(rawVersion) ? rawVersion : null;\n\t\t\t\tconst failure: MutablePluginTestKitLifecycleFailure = {\n\t\t\t\t\teventId: report?.eventId ?? null,\n\t\t\t\t\ttype: typeof requestObject?.type === \"string\" ? requestObject.type : null,\n\t\t\t\t\tversion,\n\t\t\t\t\tphase,\n\t\t\t\t\tdeliveryId: null,\n\t\t\t\t\tsource,\n\t\t\t\t\t...(typeof requestObject?.operationId === \"string\" ? { operationId: requestObject.operationId } : {}),\n\t\t\t\t\t...(typeof requestObject?.correlationId === \"string\"\n\t\t\t\t\t\t? { correlationId: requestObject.correlationId }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\t...(typeof requestObject?.causationId === \"string\" ? { causationId: requestObject.causationId } : {}),\n\t\t\t\t\t...(requestObject !== undefined && \"data\" in requestObject\n\t\t\t\t\t\t? { data: transcriptValue(requestObject.data) }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\tstatus:\n\t\t\t\t\t\treport?.status === \"transform-failed\" \|\| report?.status === \"execute-failed\"\n\t\t\t\t\t\t\t? report.status\n\t\t\t\t\t\t\t: requestObject?.signal instanceof AbortSignal && requestObject.signal.aborted\n\t\t\t\t\t\t\t\t? \"cancelled\"\n\t\t\t\t\t\t\t\t: \"rejected\",\n\t\t\t\t\terror: transcriptValue(error),\n\t\t\t\t\t...(report === undefined ? {} : { report }),\n\t\t\t\t};\n\t\t\t\tlifecycleFailures.push(snapshot(failure));\n\t\t\t},\n\t\t);\n\t\tpendingLifecycleDispatches.add(recorded);\n\t\tvoid recorded.then(() => pendingLifecycleDispatches.delete(recorded));\n\t};\n\tconst runtime = createCapabilityRuntime(host, {\n\t\tclock: options.clock ?? (() => 0),\n\t\tidFactory: options.idFactory ?? ((kind, sequence) => `testkit:${kind}:${sequence}`),\n\t\tonLifecycleDispatch: recordLifecycleDispatch,\n\t});\n\t// Must run before the ready loop: plugin factories registerObserve during load.\n\tif (options.lifecycle === true) installBootstrapLifecycle(runtime);\n\n\tconst inputManifests = inputPlugins.map(({ manifest }) => ({\n\t\tpluginId: manifest.id,\n\t\tversion: manifest.version,\n\t\tentry: manifest.entry,\n\t}));\n\tconst inputOrder = inputPlugins.map(({ manifest }) => manifest.id);\n\tconst wrappedToRawAPI = new WeakMap<CapabilityAPI, CapabilityAPI>();\n\tconst wrapStateAPI = (pluginId: string, state: StateAPI): StateAPI => {\n\t\tconst operationMetadata = (options?: StateSetOptions) => ({\n\t\t\t...(options?.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),\n\t\t\t...(options?.operationId === undefined ? {} : { operationId: options.operationId }),\n\t\t\t...(options?.correlationId === undefined ? {} : { correlationId: options.correlationId }),\n\t\t});\n\t\tconst recordMutation = (\n\t\t\taction: \"set\" \| \"delete\",\n\t\t\tkey: string,\n\t\t\tmetadata: ReturnType<typeof operationMetadata>,\n\t\t\tresult: { status: \"committed\"; revision: number; value?: unknown } \| { status: \"rejected\"; error: unknown },\n\t\t): void => {\n\t\t\tstateMutations.push({\n\t\t\t\tpluginId,\n\t\t\t\taction,\n\t\t\t\tkey,\n\t\t\t\t...metadata,\n\t\t\t\t...result,\n\t\t\t});\n\t\t};\n\t\treturn Object.freeze({\n\t\t\tget: (key: string) => state.get(key),\n\t\t\tset: (key: string, value: Parameters<StateAPI[\"set\"]>[1], options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.set(key, value, options);\n\t\t\t\t\trecordMutation(\"set\", key, metadata, {\n\t\t\t\t\t\tstatus: \"committed\",\n\t\t\t\t\t\trevision,\n\t\t\t\t\t\tvalue: transcriptValue(value),\n\t\t\t\t\t});\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"set\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelete: (key: string, options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.delete(key, options);\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"committed\", revision });\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tlist: (prefix?: string) => state.list(prefix),\n\t\t\twatch: (prefix: string \| undefined, handler: (change: StateChange) => void) => {\n\t\t\t\tlet watcherId = \"<pending>\";\n\t\t\t\tconst registration = state.watch(prefix, (change) => {\n\t\t\t\t\tconst delivery: MutablePluginTestKitStateWatchDelivery = {\n\t\t\t\t\t\tpluginId,\n\t\t\t\t\t\twatcherId,\n\t\t\t\t\t\tkey: change.key,\n\t\t\t\t\t\trevision: change.revision,\n\t\t\t\t\t\tstatus: \"delivered\",\n\t\t\t\t\t\t...(change.value === undefined ? {} : { value: transcriptValue(change.value) }),\n\t\t\t\t\t\t...(change.operationId === undefined ? {} : { operationId: change.operationId }),\n\t\t\t\t\t\t...(change.correlationId === undefined ? {} : { correlationId: change.correlationId }),\n\t\t\t\t\t};\n\t\t\t\t\tstateWatchDeliveries.push(delivery);\n\t\t\t\t\ttry {\n\t\t\t\t\t\thandler(change);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tdelivery.status = \"failed\";\n\t\t\t\t\t\tdelivery.error = transcriptValue(error);\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\twatcherId = registration.id;\n\t\t\t\treturn registration;\n\t\t\t},\n\t\t});\n\t};\n\tconst wrapCapabilityDirectory = (\n\t\tcallerPluginId: string,\n\t\tcapabilities: CapabilityDirectoryAPI,\n\t): CapabilityDirectoryAPI =>\n\t\tObject.freeze({\n\t\t\tprovide: <TInput = unknown, TResult = unknown>(\n\t\t\t\tdeclaration: PluginCapabilityDeclaration,\n\t\t\t\thandler: CapabilityProviderHandler<TInput, TResult>,\n\t\t\t): DisposableRegistration => capabilities.provide(declaration, handler),\n\t\t\trequire: <TResult = unknown>(id: string, requireOptions?: { version?: number }) => {\n\t\t\t\tconst handle = capabilities.require<TResult>(id, requireOptions);\n\t\t\t\treturn Object.freeze({\n\t\t\t\t\tdeclaration: handle.declaration,\n\t\t\t\t\towner: handle.owner,\n\t\t\t\t\tcall: (input: unknown, callOptions?: { signal?: AbortSignal }): OperationHandle<TResult> => {\n\t\t\t\t\t\tlet operation: OperationHandle<TResult>;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\toperation = handle.call(input, callOptions);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tcapabilityCalls.push({\n\t\t\t\t\t\t\t\toperationId: null,\n\t\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\terror: transcriptValue(error),\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\tconst record: MutablePluginTestKitCapabilityCall = {\n\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\tstatus: operation.status(),\n\t\t\t\t\t\t};\n\t\t\t\t\t\tcapabilityCalls.push(record);\n\t\t\t\t\t\tvoid operation.result.then(\n\t\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(error) => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t\trecord.error = transcriptValue(error);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn operation;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t},\n\t\t\tlist: (listOptions?: { kind?: PluginCapabilityDeclaration[\"kind\"] }) => capabilities.list(listOptions),\n\t\t});\n\tconst originalCreateAPI = runtime.createAPI.bind(runtime);\n\tconst originalRevokeAPI = runtime.revokeAPI.bind(runtime);\n\truntime.createAPI = (manifest) => {\n\t\tconst rawAPI = originalCreateAPI(manifest);\n\t\tconst wrappedAPI = Object.freeze({\n\t\t\t...rawAPI,\n\t\t\tcapabilities: wrapCapabilityDirectory(rawAPI.manifest.id, rawAPI.capabilities),\n\t\t\t...(rawAPI.state === undefined ? {} : { state: wrapStateAPI(rawAPI.manifest.id, rawAPI.state) }),\n\t\t});\n\t\twrappedToRawAPI.set(wrappedAPI, rawAPI);\n\t\treturn wrappedAPI;\n\t};\n\truntime.revokeAPI = (api) => {\n\t\t// v8 ignore next -- 所有 API 均经包装后的 createAPI 创建，映射必命中\n\t\tconst rawAPI = wrappedToRawAPI.get(api) ?? api;\n\t\tfor (const [pluginId, handle] of handles) {\n\t\t\tif (handle.api === api \|\| handle.api === rawAPI) captureState(pluginId, handle);\n\t\t}\n\t\toriginalRevokeAPI(rawAPI);\n\t};\n\n\tconst captureState = (pluginId: string, handle: CapabilityPluginHandle): void => {\n\t\tif (retainedState.has(pluginId) \|\| revokedState.has(pluginId)) return;\n\t\tretainedState.set(pluginId, snapshot(handle.api.state?.list() ?? []));\n\t};\n\tconst stateTranscript = (): readonly { readonly pluginId: string; readonly entries: readonly StateEntry[] }[] =>\n\t\t[...handles.entries()].map(([pluginId, handle]) => {\n\t\t\treturn {\n\t\t\t\tpluginId,\n\t\t\t\tentries: retainedState.get(pluginId) ?? snapshot(handle.api.state?.list() ?? []),\n\t\t\t};\n\t\t});\n\n\tlet closing = false;\n\tconst ready = (async () => {\n\t\ttry {\n\t\t\tconst ordered = resolvePluginCapabilityOrder(inputPlugins.map((plugin) => plugin.manifest));\n\t\t\tfor (const manifest of ordered) {\n\t\t\t\tif (closing) throw new Error(\"Plugin testkit was disposed during startup\");\n\t\t\t\tconst plugin = pluginsByManifest.get(manifest);\n\t\t\t\t// v8 ignore next -- plugins 数组同时供给加载顺序与 factory 映射，必可解析\n\t\t\t\tif (!plugin) throw new Error(`Plugin testkit cannot resolve factory: ${manifest.id}`);\n\t\t\t\tconst handle = await loadCapabilityPlugin(runtime, plugin.manifest, plugin.factory);\n\t\t\t\thandles.set(manifest.id, handle);\n\t\t\t\tloadOrder.push(manifest.id);\n\t\t\t}\n\t\t} catch (startupError) {\n\t\t\tconst failures: unknown[] = [startupError];\n\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\ttry {\n\t\t\t\t\tawait handle.dispose();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t}\n\t\t\thandles.clear();\n\t\t\ttry {\n\t\t\t\tawait runtime.disposeAll();\n\t\t\t} catch (error) {\n\t\t\t\tfailures.push(error);\n\t\t\t}\n\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit startup rollback failed\");\n\t\t\tthrow startupError;\n\t\t}\n\t})();\n\n\treturn {\n\t\truntime,\n\t\tready,\n\t\tapi(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\treturn handle.api;\n\t\t},\n\t\trevoke(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\tif (handle.api.state) {\n\t\t\t\tconst entries = snapshot(handle.api.state.list());\n\t\t\t\trevokedState.set(pluginId, entries);\n\t\t\t\tretainedState.set(pluginId, entries);\n\t\t\t}\n\t\t\truntime.revokeAPI(handle.api);\n\t\t},\n\t\tinspect: () => runtime.inspect(),\n\t\tflushLifecycle: async () => {\n\t\t\twhile (pendingLifecycleDispatches.size > 0) {\n\t\t\t\tawait Promise.all([...pendingLifecycleDispatches]);\n\t\t\t}\n\t\t\tawait runtime.drainLifecycleDeliveries();\n\t\t},\n\t\ttranscript: () =>\n\t\t\tsnapshot(\n\t\t\t\ttranscriptValue({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tmanifestRoot,\n\t\t\t\t\tmanifests: inputManifests,\n\t\t\t\t\tinputOrder,\n\t\t\t\t\tloadOrder,\n\t\t\t\t\tstate: stateTranscript(),\n\t\t\t\t\tstateMutations,\n\t\t\t\t\tstateWatchDeliveries,\n\t\t\t\t\tcapabilityCalls,\n\t\t\t\t\tlifecycleEvents,\n\t\t\t\t\tlifecycleFailures,\n\t\t\t\t\tlifecycleReports: runtime.inspect().lifecycleReports,\n\t\t\t\t\tinspector: runtime.inspect(),\n\t\t\t\t}) as PluginTestKitTranscript,\n\t\t\t),\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tclosing = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\ttry {\n\t\t\t\t\tawait ready;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!(error instanceof Error && error.message === \"Plugin testkit was disposed during startup\")) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfor (const [pluginId, handle] of handles) captureState(pluginId, handle);\n\t\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait handle.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\ttry {\n\t\t\t\t\tawait runtime.disposeAll();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n}\n\n/* Runs a fixture repeatedly and rejects on the first transcript divergence. */\nexport async function repeatPluginTestKit(\n\ttimes: number,\n\trun: () => Promise<PluginTestKitTranscript>,\n): Promise<PluginTestKitTranscript> {\n\tif (!Number.isSafeInteger(times) \|\| times < 1)\n\t\tthrow new Error(t(\"Plugin testkit repeat count must be a positive integer\"));\n\tlet baseline: PluginTestKitTranscript \| undefined;\n\tfor (let index = 0; index < times; index += 1) {\n\t\tconst transcript = await run();\n\t\tif (baseline && canonicalJson(transcript) !== canonicalJson(baseline)) {\n\t\t\tthrow new Error(t(\"Plugin testkit transcript diverged on run {run}\", { run: index + 1 }));\n\t\t}\n\t\tbaseline = transcript;\n\t}\n\treturn baseline!;\n}\n"]}

package/dist/testing/plugin-testkit.js CHANGED Viewed

@@ -2,6 +2,7 @@ import { installBootstrapLifecycle } from "../core/extensions/bootstrap-lifecycl
 import { loadCapabilityPlugin, } from "../core/extensions/capability-plugin.js";
 import { createCapabilityRuntime, resolvePluginCapabilityOrder, } from "../core/extensions/capability-runtime.js";
 import { EXPERIMENTAL_PUBLIC_API_VERSION, } from "../core/extensions/public-api.js";
+import { t } from "../core/i18n/index.js";
 function snapshot(value) {
     const clone = structuredClone(value);
     const freeze = (candidate) => {
@@ -109,7 +110,7 @@ const DEFAULT_MANIFEST_ROOT = "<plugin-testkit>";
 export function createPluginTestKit(options) {
     const manifestRoot = options.manifestRoot ?? DEFAULT_MANIFEST_ROOT;
     if (typeof manifestRoot !== "string" || !manifestRoot.trim()) {
-        throw new Error("Plugin testkit manifestRoot must be a non-empty string");
+        throw new Error(t("Plugin testkit manifestRoot must be a non-empty string"));
     }
     const inputPlugins = options.plugins.map((plugin) => ({
         manifest: snapshot(plugin.manifest),
@@ -479,12 +480,12 @@ export function createPluginTestKit(options) {
 /** Runs a fixture repeatedly and rejects on the first transcript divergence. */
 export async function repeatPluginTestKit(times, run) {
     if (!Number.isSafeInteger(times) || times < 1)
-        throw new Error("Plugin testkit repeat count must be a positive integer");
+        throw new Error(t("Plugin testkit repeat count must be a positive integer"));
     let baseline;
     for (let index = 0; index < times; index += 1) {
         const transcript = await run();
         if (baseline && canonicalJson(transcript) !== canonicalJson(baseline)) {
-            throw new Error(`Plugin testkit transcript diverged on run ${index + 1}`);
+            throw new Error(t("Plugin testkit transcript diverged on run {run}", { run: index + 1 }));
         }
         baseline = transcript;
     }

package/dist/testing/plugin-testkit.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin-testkit.js","sourceRoot":"","sources":["../../src/testing/plugin-testkit.ts"],"names":[],"mappings":"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","sourcesContent":["import { installBootstrapLifecycle } from \"../core/extensions/bootstrap-lifecycle.ts\";\nimport {\n\ttype CapabilityPluginFactory,\n\ttype CapabilityPluginHandle,\n\tloadCapabilityPlugin,\n} from \"../core/extensions/capability-plugin.ts\";\nimport {\n\ttype CapabilityRuntime,\n\tcreateCapabilityRuntime,\n\tresolvePluginCapabilityOrder,\n} from \"../core/extensions/capability-runtime.ts\";\nimport {\n\ttype CapabilityAPI,\n\ttype CapabilityDirectoryAPI,\n\ttype CapabilityProviderHandler,\n\ttype DisposableRegistration,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype HostCapabilities,\n\ttype LifecycleDispatchRequest,\n\ttype LifecycleDispatchResult,\n\ttype LifecycleEvent,\n\ttype LifecyclePhase,\n\ttype OperationHandle,\n\ttype OperationStatus,\n\ttype PluginCapabilityDeclaration,\n\ttype PluginManifest,\n\ttype RuntimeInspectorSnapshot,\n\ttype StateAPI,\n\ttype StateChange,\n\ttype StateEntry,\n\ttype StateSetOptions,\n} from \"../core/extensions/public-api.ts\";\n\n/*\n A deterministic, runtime-only fixture for experimental capability plugins.\n \n It deliberately does not create an AgentSession or a model provider. Tests\n * that need those integration points should use the existing session harness.\n /\nexport interface PluginTestKitPlugin {\n\treadonly manifest: PluginManifest;\n\treadonly factory: CapabilityPluginFactory;\n}\n\nexport interface PluginTestKitOptions {\n\treadonly plugins: readonly PluginTestKitPlugin[];\n\treadonly host?: Omit<HostCapabilities, \"apiVersion\">;\n\treadonly clock?: () => number;\n\t/* Injects stable runtime identifiers for deterministic transcript tests. /\n\treadonly idFactory?: (kind: string, sequence: number) => string;\n\t/* Logical root used to identify inline manifests without a host filesystem path. /\n\treadonly manifestRoot?: string;\n\t/\n\t Installs the bootstrap lifecycle catalog (host parity: the real session\n\t * host installs it) before the plugin load loop, so plugin factories can\n\t * registerObserve standard events. Off by default to keep existing\n\t * transcripts unchanged; the installed handle is disposed by\n\t * runtime.disposeAll() inside dispose().\n\t /\n\treadonly lifecycle?: boolean;\n}\n\nexport interface PluginTestKitManifestIdentity {\n\treadonly pluginId: string;\n\treadonly version: string;\n\treadonly entry: string;\n}\n\nexport interface PluginTestKitLifecycleEnvelope {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecycleEvent[\"phase\"];\n\treadonly deliveryId: string;\n\treadonly source: string;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data: unknown;\n}\n\nexport interface PluginTestKitLifecycleFailureReport {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecyclePhase;\n\treadonly status: \"transform-failed\" \| \"execute-failed\" \| \"delivered\" \| \"queued\";\n\treadonly attempted: number;\n\treadonly succeeded: number;\n\treadonly queued?: number;\n\treadonly failed: number;\n\treadonly failures: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly registrationId: string;\n\t\treadonly kind: string;\n\t\treadonly error: unknown;\n\t}[];\n}\n\n/* A dispatch rejection is retained even when no event envelope was created. /\nexport interface PluginTestKitLifecycleFailure {\n\treadonly eventId: string \| null;\n\treadonly type: string \| null;\n\treadonly version: number \| null;\n\treadonly phase: LifecyclePhase \| null;\n\treadonly deliveryId: string \| null;\n\treadonly source: string \| null;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data?: unknown;\n\treadonly status: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\treadonly error: unknown;\n\treadonly report?: PluginTestKitLifecycleFailureReport;\n}\n\nexport interface PluginTestKitStateMutation {\n\treadonly pluginId: string;\n\treadonly action: \"set\" \| \"delete\";\n\treadonly key: string;\n\treadonly status: \"committed\" \| \"rejected\";\n\treadonly revision?: number;\n\treadonly expectedRevision?: number;\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitStateWatchDelivery {\n\treadonly pluginId: string;\n\treadonly watcherId: string;\n\treadonly key: string;\n\treadonly revision: number;\n\treadonly status: \"delivered\" \| \"failed\";\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitCapabilityCall {\n\treadonly operationId: string \| null;\n\treadonly callerPluginId: string;\n\treadonly providerPluginId: string;\n\treadonly capabilityId: string;\n\treadonly capabilityVersion: number;\n\treadonly capabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\treadonly status: OperationStatus;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitTranscript {\n\treadonly version: 1;\n\treadonly manifestRoot: string;\n\treadonly manifests: readonly PluginTestKitManifestIdentity[];\n\treadonly inputOrder: readonly string[];\n\treadonly loadOrder: readonly string[];\n\treadonly state: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly entries: readonly StateEntry[];\n\t}[];\n\treadonly stateMutations: readonly PluginTestKitStateMutation[];\n\treadonly stateWatchDeliveries: readonly PluginTestKitStateWatchDelivery[];\n\treadonly capabilityCalls: readonly PluginTestKitCapabilityCall[];\n\treadonly lifecycleEvents: readonly PluginTestKitLifecycleEnvelope[];\n\treadonly lifecycleFailures: readonly PluginTestKitLifecycleFailure[];\n\treadonly lifecycleReports: RuntimeInspectorSnapshot[\"lifecycleReports\"];\n\treadonly inspector: RuntimeInspectorSnapshot;\n}\n\nexport interface PluginTestKit {\n\treadonly runtime: CapabilityRuntime;\n\t/* Resolves after every manifest is topology-ordered and its factory has loaded. /\n\treadonly ready: Promise<void>;\n\tapi(pluginId: string): CapabilityAPI;\n\trevoke(pluginId: string): void;\n\tinspect(): RuntimeInspectorSnapshot;\n\ttranscript(): PluginTestKitTranscript;\n\t/* Waits for lifecycle facts initiated by runtime-owned detached operations. /\n\tflushLifecycle(): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nfunction snapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate \|\| typeof candidate !== \"object\" \|\| ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\nfunction transcriptValue(value: unknown, seen = new WeakSet<object>()): unknown {\n\tif (value === null \|\| typeof value === \"string\" \|\| typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return `${value}n`;\n\tif (value === undefined) return null;\n\tif (value instanceof Error) {\n\t\tif (seen.has(value)) return \"[Circular]\";\n\t\tseen.add(value);\n\t\tconst output: Record<string, unknown> = { name: value.name, message: value.message };\n\t\tconst code = (value as Error & { code?: unknown }).code;\n\t\tif (code !== undefined) output.code = transcriptValue(code, seen);\n\t\tconst cause = (value as Error & { cause?: unknown }).cause;\n\t\tif (cause !== undefined) output.cause = transcriptValue(cause, seen);\n\t\tfor (const key of Object.keys(value).sort()) {\n\t\t\tif (key === \"code\" \|\| key === \"cause\") continue;\n\t\t\toutput[key] = transcriptValue((value as unknown as Record<string, unknown>)[key], seen);\n\t\t}\n\t\treturn output;\n\t}\n\tif (typeof value !== \"object\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\tif (Array.isArray(value)) return value.map((item) => transcriptValue(item, seen));\n\tconst output: Record<string, unknown> = {};\n\tfor (const key of Object.keys(value as Record<string, unknown>).sort()) {\n\t\toutput[key] = transcriptValue((value as Record<string, unknown>)[key], seen);\n\t}\n\treturn output;\n}\n\nfunction canonicalJson(value: unknown): string {\n\tconst serialized = JSON.stringify(transcriptValue(value));\n\t// v8 ignore next -- transcriptValue 已消毒全部值，JSON.stringify 不会返回 undefined\n\tif (serialized === undefined) throw new Error(\"Plugin testkit transcript is not JSON-serializable\");\n\treturn serialized;\n}\n\ntype PluginTestKitLifecycleReport = PluginTestKitLifecycleFailureReport;\n\nfunction lifecycleFailureReport(error: unknown): PluginTestKitLifecycleReport \| undefined {\n\tif (!error \|\| typeof error !== \"object\") return undefined;\n\tconst report = (error as { report?: unknown }).report;\n\tif (!report \|\| typeof report !== \"object\") return undefined;\n\tconst candidate = report as RuntimeInspectorSnapshot[\"lifecycleReports\"][number];\n\t// v8 ignore next -- report 由 runtime 构造、形状恒满足；此处仅防御伪造的 report\n\tif (\n\t\ttypeof candidate.eventId !== \"string\" \|\|\n\t\ttypeof candidate.type !== \"string\" \|\|\n\t\t!Number.isSafeInteger(candidate.version) \|\|\n\t\t(candidate.phase !== \"raw\" && candidate.phase !== \"candidate\" && candidate.phase !== \"committed\") \|\|\n\t\t(candidate.status !== \"transform-failed\" &&\n\t\t\tcandidate.status !== \"execute-failed\" &&\n\t\t\tcandidate.status !== \"delivered\") \|\|\n\t\t!Array.isArray(candidate.failures)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\teventId: candidate.eventId,\n\t\ttype: candidate.type,\n\t\tversion: candidate.version,\n\t\tphase: candidate.phase,\n\t\tstatus: candidate.status,\n\t\tattempted: candidate.attempted,\n\t\tsucceeded: candidate.succeeded,\n\t\tfailed: candidate.failed,\n\t\tfailures: candidate.failures.map((failure) => ({\n\t\t\tpluginId: failure.pluginId,\n\t\t\tregistrationId: failure.registrationId,\n\t\t\tkind: failure.kind,\n\t\t\terror: transcriptValue(failure.error),\n\t\t})),\n\t};\n}\n\nfunction defaultHost(): HostCapabilities {\n\treturn {\n\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\tmode: \"full-control\",\n\t\tfeatures: [\"logger-v1\", \"diagnostics-v1\", \"plugin-state-v1\", \"runtime-inspector-v1\"],\n\t\ttransports: [\"in-process\"],\n\t};\n}\n\nconst DEFAULT_MANIFEST_ROOT = \"<plugin-testkit>\";\n\ninterface MutablePluginTestKitStateMutation {\n\tpluginId: string;\n\taction: \"set\" \| \"delete\";\n\tkey: string;\n\tstatus: \"committed\" \| \"rejected\";\n\trevision?: number;\n\texpectedRevision?: number;\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitStateWatchDelivery {\n\tpluginId: string;\n\twatcherId: string;\n\tkey: string;\n\trevision: number;\n\tstatus: \"delivered\" \| \"failed\";\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitCapabilityCall {\n\toperationId: string \| null;\n\tcallerPluginId: string;\n\tproviderPluginId: string;\n\tcapabilityId: string;\n\tcapabilityVersion: number;\n\tcapabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\tstatus: OperationStatus;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitLifecycleFailure {\n\teventId: string \| null;\n\ttype: string \| null;\n\tversion: number \| null;\n\tphase: LifecyclePhase \| null;\n\tdeliveryId: string \| null;\n\tsource: string \| null;\n\toperationId?: string;\n\tcorrelationId?: string;\n\tcausationId?: string;\n\tdata?: unknown;\n\tstatus: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\terror: unknown;\n\treport?: PluginTestKitLifecycleFailureReport;\n}\n\n/* Create a runtime-only fixture with deterministic topology and teardown. /\nexport function createPluginTestKit(options: PluginTestKitOptions): PluginTestKit {\n\tconst manifestRoot = options.manifestRoot ?? DEFAULT_MANIFEST_ROOT;\n\tif (typeof manifestRoot !== \"string\" \|\| !manifestRoot.trim()) {\n\t\tthrow new Error(\"Plugin testkit manifestRoot must be a non-empty string\");\n\t}\n\tconst inputPlugins = options.plugins.map((plugin) => ({\n\t\tmanifest: snapshot(plugin.manifest),\n\t\tfactory: plugin.factory,\n\t}));\n\tconst suppliedHost = options.host;\n\tconst host: HostCapabilities = {\n\t\t...defaultHost(),\n\t\t...suppliedHost,\n\t\tfeatures: suppliedHost?.features ?? defaultHost().features,\n\t\ttransports: suppliedHost?.transports ?? defaultHost().transports,\n\t};\n\tconst pluginsByManifest = new Map(inputPlugins.map((plugin) => [plugin.manifest, plugin]));\n\tconst handles = new Map<string, CapabilityPluginHandle>();\n\tconst revokedState = new Map<string, readonly StateEntry[]>();\n\tconst retainedState = new Map<string, readonly StateEntry[]>();\n\tconst loadOrder: string[] = [];\n\tconst stateMutations: MutablePluginTestKitStateMutation[] = [];\n\tconst stateWatchDeliveries: MutablePluginTestKitStateWatchDelivery[] = [];\n\tconst capabilityCalls: MutablePluginTestKitCapabilityCall[] = [];\n\tconst lifecycleEvents: PluginTestKitLifecycleEnvelope[] = [];\n\tconst lifecycleFailures: MutablePluginTestKitLifecycleFailure[] = [];\n\tconst pendingLifecycleDispatches = new Set<Promise<void>>();\n\tlet disposePromise: Promise<void> \| undefined;\n\tconst recordLifecycleDispatch = (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t): void => {\n\t\tconst recorded = settled.then(\n\t\t\t(result) => {\n\t\t\t\tlifecycleEvents.push(\n\t\t\t\t\tsnapshot({\n\t\t\t\t\t\teventId: result.event.id,\n\t\t\t\t\t\ttype: result.event.type,\n\t\t\t\t\t\tversion: result.event.version,\n\t\t\t\t\t\tphase: result.event.phase,\n\t\t\t\t\t\tdeliveryId: result.event.deliveryId,\n\t\t\t\t\t\tsource: result.event.source,\n\t\t\t\t\t\t...(result.event.operationId === undefined ? {} : { operationId: result.event.operationId }),\n\t\t\t\t\t\t...(result.event.correlationId === undefined ? {} : { correlationId: result.event.correlationId }),\n\t\t\t\t\t\t...(result.event.causationId === undefined ? {} : { causationId: result.event.causationId }),\n\t\t\t\t\t\tdata: transcriptValue(result.event.data),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tconst requestObject =\n\t\t\t\t\trequest && typeof request === \"object\" ? (request as unknown as Record<string, unknown>) : undefined;\n\t\t\t\tconst report = lifecycleFailureReport(error);\n\t\t\t\tconst rawPhase = requestObject?.phase;\n\t\t\t\tconst phase: LifecyclePhase \| null =\n\t\t\t\t\trawPhase === \"raw\" \|\| rawPhase === \"candidate\" \|\| rawPhase === \"committed\" ? rawPhase : null;\n\t\t\t\tconst rawSource = requestObject?.source;\n\t\t\t\tconst source =\n\t\t\t\t\trawSource === undefined\n\t\t\t\t\t\t? requestObject === undefined\n\t\t\t\t\t\t\t? null\n\t\t\t\t\t\t\t: \"host\"\n\t\t\t\t\t\t: typeof rawSource === \"string\"\n\t\t\t\t\t\t\t? rawSource\n\t\t\t\t\t\t\t: null;\n\t\t\t\tconst rawVersion = requestObject?.version;\n\t\t\t\tconst version = typeof rawVersion === \"number\" && Number.isSafeInteger(rawVersion) ? rawVersion : null;\n\t\t\t\tconst failure: MutablePluginTestKitLifecycleFailure = {\n\t\t\t\t\teventId: report?.eventId ?? null,\n\t\t\t\t\ttype: typeof requestObject?.type === \"string\" ? requestObject.type : null,\n\t\t\t\t\tversion,\n\t\t\t\t\tphase,\n\t\t\t\t\tdeliveryId: null,\n\t\t\t\t\tsource,\n\t\t\t\t\t...(typeof requestObject?.operationId === \"string\" ? { operationId: requestObject.operationId } : {}),\n\t\t\t\t\t...(typeof requestObject?.correlationId === \"string\"\n\t\t\t\t\t\t? { correlationId: requestObject.correlationId }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\t...(typeof requestObject?.causationId === \"string\" ? { causationId: requestObject.causationId } : {}),\n\t\t\t\t\t...(requestObject !== undefined && \"data\" in requestObject\n\t\t\t\t\t\t? { data: transcriptValue(requestObject.data) }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\tstatus:\n\t\t\t\t\t\treport?.status === \"transform-failed\" \|\| report?.status === \"execute-failed\"\n\t\t\t\t\t\t\t? report.status\n\t\t\t\t\t\t\t: requestObject?.signal instanceof AbortSignal && requestObject.signal.aborted\n\t\t\t\t\t\t\t\t? \"cancelled\"\n\t\t\t\t\t\t\t\t: \"rejected\",\n\t\t\t\t\terror: transcriptValue(error),\n\t\t\t\t\t...(report === undefined ? {} : { report }),\n\t\t\t\t};\n\t\t\t\tlifecycleFailures.push(snapshot(failure));\n\t\t\t},\n\t\t);\n\t\tpendingLifecycleDispatches.add(recorded);\n\t\tvoid recorded.then(() => pendingLifecycleDispatches.delete(recorded));\n\t};\n\tconst runtime = createCapabilityRuntime(host, {\n\t\tclock: options.clock ?? (() => 0),\n\t\tidFactory: options.idFactory ?? ((kind, sequence) => `testkit:${kind}:${sequence}`),\n\t\tonLifecycleDispatch: recordLifecycleDispatch,\n\t});\n\t// Must run before the ready loop: plugin factories registerObserve during load.\n\tif (options.lifecycle === true) installBootstrapLifecycle(runtime);\n\n\tconst inputManifests = inputPlugins.map(({ manifest }) => ({\n\t\tpluginId: manifest.id,\n\t\tversion: manifest.version,\n\t\tentry: manifest.entry,\n\t}));\n\tconst inputOrder = inputPlugins.map(({ manifest }) => manifest.id);\n\tconst wrappedToRawAPI = new WeakMap<CapabilityAPI, CapabilityAPI>();\n\tconst wrapStateAPI = (pluginId: string, state: StateAPI): StateAPI => {\n\t\tconst operationMetadata = (options?: StateSetOptions) => ({\n\t\t\t...(options?.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),\n\t\t\t...(options?.operationId === undefined ? {} : { operationId: options.operationId }),\n\t\t\t...(options?.correlationId === undefined ? {} : { correlationId: options.correlationId }),\n\t\t});\n\t\tconst recordMutation = (\n\t\t\taction: \"set\" \| \"delete\",\n\t\t\tkey: string,\n\t\t\tmetadata: ReturnType<typeof operationMetadata>,\n\t\t\tresult: { status: \"committed\"; revision: number; value?: unknown } \| { status: \"rejected\"; error: unknown },\n\t\t): void => {\n\t\t\tstateMutations.push({\n\t\t\t\tpluginId,\n\t\t\t\taction,\n\t\t\t\tkey,\n\t\t\t\t...metadata,\n\t\t\t\t...result,\n\t\t\t});\n\t\t};\n\t\treturn Object.freeze({\n\t\t\tget: (key: string) => state.get(key),\n\t\t\tset: (key: string, value: Parameters<StateAPI[\"set\"]>[1], options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.set(key, value, options);\n\t\t\t\t\trecordMutation(\"set\", key, metadata, {\n\t\t\t\t\t\tstatus: \"committed\",\n\t\t\t\t\t\trevision,\n\t\t\t\t\t\tvalue: transcriptValue(value),\n\t\t\t\t\t});\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"set\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelete: (key: string, options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.delete(key, options);\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"committed\", revision });\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tlist: (prefix?: string) => state.list(prefix),\n\t\t\twatch: (prefix: string \| undefined, handler: (change: StateChange) => void) => {\n\t\t\t\tlet watcherId = \"<pending>\";\n\t\t\t\tconst registration = state.watch(prefix, (change) => {\n\t\t\t\t\tconst delivery: MutablePluginTestKitStateWatchDelivery = {\n\t\t\t\t\t\tpluginId,\n\t\t\t\t\t\twatcherId,\n\t\t\t\t\t\tkey: change.key,\n\t\t\t\t\t\trevision: change.revision,\n\t\t\t\t\t\tstatus: \"delivered\",\n\t\t\t\t\t\t...(change.value === undefined ? {} : { value: transcriptValue(change.value) }),\n\t\t\t\t\t\t...(change.operationId === undefined ? {} : { operationId: change.operationId }),\n\t\t\t\t\t\t...(change.correlationId === undefined ? {} : { correlationId: change.correlationId }),\n\t\t\t\t\t};\n\t\t\t\t\tstateWatchDeliveries.push(delivery);\n\t\t\t\t\ttry {\n\t\t\t\t\t\thandler(change);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tdelivery.status = \"failed\";\n\t\t\t\t\t\tdelivery.error = transcriptValue(error);\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\twatcherId = registration.id;\n\t\t\t\treturn registration;\n\t\t\t},\n\t\t});\n\t};\n\tconst wrapCapabilityDirectory = (\n\t\tcallerPluginId: string,\n\t\tcapabilities: CapabilityDirectoryAPI,\n\t): CapabilityDirectoryAPI =>\n\t\tObject.freeze({\n\t\t\tprovide: <TInput = unknown, TResult = unknown>(\n\t\t\t\tdeclaration: PluginCapabilityDeclaration,\n\t\t\t\thandler: CapabilityProviderHandler<TInput, TResult>,\n\t\t\t): DisposableRegistration => capabilities.provide(declaration, handler),\n\t\t\trequire: <TResult = unknown>(id: string, requireOptions?: { version?: number }) => {\n\t\t\t\tconst handle = capabilities.require<TResult>(id, requireOptions);\n\t\t\t\treturn Object.freeze({\n\t\t\t\t\tdeclaration: handle.declaration,\n\t\t\t\t\towner: handle.owner,\n\t\t\t\t\tcall: (input: unknown, callOptions?: { signal?: AbortSignal }): OperationHandle<TResult> => {\n\t\t\t\t\t\tlet operation: OperationHandle<TResult>;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\toperation = handle.call(input, callOptions);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tcapabilityCalls.push({\n\t\t\t\t\t\t\t\toperationId: null,\n\t\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\terror: transcriptValue(error),\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\tconst record: MutablePluginTestKitCapabilityCall = {\n\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\tstatus: operation.status(),\n\t\t\t\t\t\t};\n\t\t\t\t\t\tcapabilityCalls.push(record);\n\t\t\t\t\t\tvoid operation.result.then(\n\t\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(error) => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t\trecord.error = transcriptValue(error);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn operation;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t},\n\t\t\tlist: (listOptions?: { kind?: PluginCapabilityDeclaration[\"kind\"] }) => capabilities.list(listOptions),\n\t\t});\n\tconst originalCreateAPI = runtime.createAPI.bind(runtime);\n\tconst originalRevokeAPI = runtime.revokeAPI.bind(runtime);\n\truntime.createAPI = (manifest) => {\n\t\tconst rawAPI = originalCreateAPI(manifest);\n\t\tconst wrappedAPI = Object.freeze({\n\t\t\t...rawAPI,\n\t\t\tcapabilities: wrapCapabilityDirectory(rawAPI.manifest.id, rawAPI.capabilities),\n\t\t\t...(rawAPI.state === undefined ? {} : { state: wrapStateAPI(rawAPI.manifest.id, rawAPI.state) }),\n\t\t});\n\t\twrappedToRawAPI.set(wrappedAPI, rawAPI);\n\t\treturn wrappedAPI;\n\t};\n\truntime.revokeAPI = (api) => {\n\t\t// v8 ignore next -- 所有 API 均经包装后的 createAPI 创建，映射必命中\n\t\tconst rawAPI = wrappedToRawAPI.get(api) ?? api;\n\t\tfor (const [pluginId, handle] of handles) {\n\t\t\tif (handle.api === api \|\| handle.api === rawAPI) captureState(pluginId, handle);\n\t\t}\n\t\toriginalRevokeAPI(rawAPI);\n\t};\n\n\tconst captureState = (pluginId: string, handle: CapabilityPluginHandle): void => {\n\t\tif (retainedState.has(pluginId) \|\| revokedState.has(pluginId)) return;\n\t\tretainedState.set(pluginId, snapshot(handle.api.state?.list() ?? []));\n\t};\n\tconst stateTranscript = (): readonly { readonly pluginId: string; readonly entries: readonly StateEntry[] }[] =>\n\t\t[...handles.entries()].map(([pluginId, handle]) => {\n\t\t\treturn {\n\t\t\t\tpluginId,\n\t\t\t\tentries: retainedState.get(pluginId) ?? snapshot(handle.api.state?.list() ?? []),\n\t\t\t};\n\t\t});\n\n\tlet closing = false;\n\tconst ready = (async () => {\n\t\ttry {\n\t\t\tconst ordered = resolvePluginCapabilityOrder(inputPlugins.map((plugin) => plugin.manifest));\n\t\t\tfor (const manifest of ordered) {\n\t\t\t\tif (closing) throw new Error(\"Plugin testkit was disposed during startup\");\n\t\t\t\tconst plugin = pluginsByManifest.get(manifest);\n\t\t\t\t// v8 ignore next -- plugins 数组同时供给加载顺序与 factory 映射，必可解析\n\t\t\t\tif (!plugin) throw new Error(`Plugin testkit cannot resolve factory: ${manifest.id}`);\n\t\t\t\tconst handle = await loadCapabilityPlugin(runtime, plugin.manifest, plugin.factory);\n\t\t\t\thandles.set(manifest.id, handle);\n\t\t\t\tloadOrder.push(manifest.id);\n\t\t\t}\n\t\t} catch (startupError) {\n\t\t\tconst failures: unknown[] = [startupError];\n\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\ttry {\n\t\t\t\t\tawait handle.dispose();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t}\n\t\t\thandles.clear();\n\t\t\ttry {\n\t\t\t\tawait runtime.disposeAll();\n\t\t\t} catch (error) {\n\t\t\t\tfailures.push(error);\n\t\t\t}\n\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit startup rollback failed\");\n\t\t\tthrow startupError;\n\t\t}\n\t})();\n\n\treturn {\n\t\truntime,\n\t\tready,\n\t\tapi(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\treturn handle.api;\n\t\t},\n\t\trevoke(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\tif (handle.api.state) {\n\t\t\t\tconst entries = snapshot(handle.api.state.list());\n\t\t\t\trevokedState.set(pluginId, entries);\n\t\t\t\tretainedState.set(pluginId, entries);\n\t\t\t}\n\t\t\truntime.revokeAPI(handle.api);\n\t\t},\n\t\tinspect: () => runtime.inspect(),\n\t\tflushLifecycle: async () => {\n\t\t\twhile (pendingLifecycleDispatches.size > 0) {\n\t\t\t\tawait Promise.all([...pendingLifecycleDispatches]);\n\t\t\t}\n\t\t\tawait runtime.drainLifecycleDeliveries();\n\t\t},\n\t\ttranscript: () =>\n\t\t\tsnapshot(\n\t\t\t\ttranscriptValue({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tmanifestRoot,\n\t\t\t\t\tmanifests: inputManifests,\n\t\t\t\t\tinputOrder,\n\t\t\t\t\tloadOrder,\n\t\t\t\t\tstate: stateTranscript(),\n\t\t\t\t\tstateMutations,\n\t\t\t\t\tstateWatchDeliveries,\n\t\t\t\t\tcapabilityCalls,\n\t\t\t\t\tlifecycleEvents,\n\t\t\t\t\tlifecycleFailures,\n\t\t\t\t\tlifecycleReports: runtime.inspect().lifecycleReports,\n\t\t\t\t\tinspector: runtime.inspect(),\n\t\t\t\t}) as PluginTestKitTranscript,\n\t\t\t),\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tclosing = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\ttry {\n\t\t\t\t\tawait ready;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!(error instanceof Error && error.message === \"Plugin testkit was disposed during startup\")) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfor (const [pluginId, handle] of handles) captureState(pluginId, handle);\n\t\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait handle.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\ttry {\n\t\t\t\t\tawait runtime.disposeAll();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n}\n\n/* Runs a fixture repeatedly and rejects on the first transcript divergence. */\nexport async function repeatPluginTestKit(\n\ttimes: number,\n\trun: () => Promise<PluginTestKitTranscript>,\n): Promise<PluginTestKitTranscript> {\n\tif (!Number.isSafeInteger(times) \|\| times < 1)\n\t\tthrow new Error(\"Plugin testkit repeat count must be a positive integer\");\n\tlet baseline: PluginTestKitTranscript \| undefined;\n\tfor (let index = 0; index < times; index += 1) {\n\t\tconst transcript = await run();\n\t\tif (baseline && canonicalJson(transcript) !== canonicalJson(baseline)) {\n\t\t\tthrow new Error(`Plugin testkit transcript diverged on run ${index + 1}`);\n\t\t}\n\t\tbaseline = transcript;\n\t}\n\treturn baseline!;\n}\n"]}
1	+ {"version":3,"file":"plugin-testkit.js","sourceRoot":"","sources":["../../src/testing/plugin-testkit.ts"],"names":[],"mappings":"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","sourcesContent":["import { installBootstrapLifecycle } from \"../core/extensions/bootstrap-lifecycle.ts\";\nimport {\n\ttype CapabilityPluginFactory,\n\ttype CapabilityPluginHandle,\n\tloadCapabilityPlugin,\n} from \"../core/extensions/capability-plugin.ts\";\nimport {\n\ttype CapabilityRuntime,\n\tcreateCapabilityRuntime,\n\tresolvePluginCapabilityOrder,\n} from \"../core/extensions/capability-runtime.ts\";\nimport {\n\ttype CapabilityAPI,\n\ttype CapabilityDirectoryAPI,\n\ttype CapabilityProviderHandler,\n\ttype DisposableRegistration,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype HostCapabilities,\n\ttype LifecycleDispatchRequest,\n\ttype LifecycleDispatchResult,\n\ttype LifecycleEvent,\n\ttype LifecyclePhase,\n\ttype OperationHandle,\n\ttype OperationStatus,\n\ttype PluginCapabilityDeclaration,\n\ttype PluginManifest,\n\ttype RuntimeInspectorSnapshot,\n\ttype StateAPI,\n\ttype StateChange,\n\ttype StateEntry,\n\ttype StateSetOptions,\n} from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\n\n/*\n A deterministic, runtime-only fixture for experimental capability plugins.\n \n It deliberately does not create an AgentSession or a model provider. Tests\n * that need those integration points should use the existing session harness.\n /\nexport interface PluginTestKitPlugin {\n\treadonly manifest: PluginManifest;\n\treadonly factory: CapabilityPluginFactory;\n}\n\nexport interface PluginTestKitOptions {\n\treadonly plugins: readonly PluginTestKitPlugin[];\n\treadonly host?: Omit<HostCapabilities, \"apiVersion\">;\n\treadonly clock?: () => number;\n\t/* Injects stable runtime identifiers for deterministic transcript tests. /\n\treadonly idFactory?: (kind: string, sequence: number) => string;\n\t/* Logical root used to identify inline manifests without a host filesystem path. /\n\treadonly manifestRoot?: string;\n\t/\n\t Installs the bootstrap lifecycle catalog (host parity: the real session\n\t * host installs it) before the plugin load loop, so plugin factories can\n\t * registerObserve standard events. Off by default to keep existing\n\t * transcripts unchanged; the installed handle is disposed by\n\t * runtime.disposeAll() inside dispose().\n\t /\n\treadonly lifecycle?: boolean;\n}\n\nexport interface PluginTestKitManifestIdentity {\n\treadonly pluginId: string;\n\treadonly version: string;\n\treadonly entry: string;\n}\n\nexport interface PluginTestKitLifecycleEnvelope {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecycleEvent[\"phase\"];\n\treadonly deliveryId: string;\n\treadonly source: string;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data: unknown;\n}\n\nexport interface PluginTestKitLifecycleFailureReport {\n\treadonly eventId: string;\n\treadonly type: string;\n\treadonly version: number;\n\treadonly phase: LifecyclePhase;\n\treadonly status: \"transform-failed\" \| \"execute-failed\" \| \"delivered\" \| \"queued\";\n\treadonly attempted: number;\n\treadonly succeeded: number;\n\treadonly queued?: number;\n\treadonly failed: number;\n\treadonly failures: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly registrationId: string;\n\t\treadonly kind: string;\n\t\treadonly error: unknown;\n\t}[];\n}\n\n/* A dispatch rejection is retained even when no event envelope was created. /\nexport interface PluginTestKitLifecycleFailure {\n\treadonly eventId: string \| null;\n\treadonly type: string \| null;\n\treadonly version: number \| null;\n\treadonly phase: LifecyclePhase \| null;\n\treadonly deliveryId: string \| null;\n\treadonly source: string \| null;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly data?: unknown;\n\treadonly status: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\treadonly error: unknown;\n\treadonly report?: PluginTestKitLifecycleFailureReport;\n}\n\nexport interface PluginTestKitStateMutation {\n\treadonly pluginId: string;\n\treadonly action: \"set\" \| \"delete\";\n\treadonly key: string;\n\treadonly status: \"committed\" \| \"rejected\";\n\treadonly revision?: number;\n\treadonly expectedRevision?: number;\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitStateWatchDelivery {\n\treadonly pluginId: string;\n\treadonly watcherId: string;\n\treadonly key: string;\n\treadonly revision: number;\n\treadonly status: \"delivered\" \| \"failed\";\n\treadonly value?: unknown;\n\treadonly operationId?: string;\n\treadonly correlationId?: string;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitCapabilityCall {\n\treadonly operationId: string \| null;\n\treadonly callerPluginId: string;\n\treadonly providerPluginId: string;\n\treadonly capabilityId: string;\n\treadonly capabilityVersion: number;\n\treadonly capabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\treadonly status: OperationStatus;\n\treadonly error?: unknown;\n}\n\nexport interface PluginTestKitTranscript {\n\treadonly version: 1;\n\treadonly manifestRoot: string;\n\treadonly manifests: readonly PluginTestKitManifestIdentity[];\n\treadonly inputOrder: readonly string[];\n\treadonly loadOrder: readonly string[];\n\treadonly state: readonly {\n\t\treadonly pluginId: string;\n\t\treadonly entries: readonly StateEntry[];\n\t}[];\n\treadonly stateMutations: readonly PluginTestKitStateMutation[];\n\treadonly stateWatchDeliveries: readonly PluginTestKitStateWatchDelivery[];\n\treadonly capabilityCalls: readonly PluginTestKitCapabilityCall[];\n\treadonly lifecycleEvents: readonly PluginTestKitLifecycleEnvelope[];\n\treadonly lifecycleFailures: readonly PluginTestKitLifecycleFailure[];\n\treadonly lifecycleReports: RuntimeInspectorSnapshot[\"lifecycleReports\"];\n\treadonly inspector: RuntimeInspectorSnapshot;\n}\n\nexport interface PluginTestKit {\n\treadonly runtime: CapabilityRuntime;\n\t/* Resolves after every manifest is topology-ordered and its factory has loaded. /\n\treadonly ready: Promise<void>;\n\tapi(pluginId: string): CapabilityAPI;\n\trevoke(pluginId: string): void;\n\tinspect(): RuntimeInspectorSnapshot;\n\ttranscript(): PluginTestKitTranscript;\n\t/* Waits for lifecycle facts initiated by runtime-owned detached operations. /\n\tflushLifecycle(): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nfunction snapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate \|\| typeof candidate !== \"object\" \|\| ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\nfunction transcriptValue(value: unknown, seen = new WeakSet<object>()): unknown {\n\tif (value === null \|\| typeof value === \"string\" \|\| typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return `${value}n`;\n\tif (value === undefined) return null;\n\tif (value instanceof Error) {\n\t\tif (seen.has(value)) return \"[Circular]\";\n\t\tseen.add(value);\n\t\tconst output: Record<string, unknown> = { name: value.name, message: value.message };\n\t\tconst code = (value as Error & { code?: unknown }).code;\n\t\tif (code !== undefined) output.code = transcriptValue(code, seen);\n\t\tconst cause = (value as Error & { cause?: unknown }).cause;\n\t\tif (cause !== undefined) output.cause = transcriptValue(cause, seen);\n\t\tfor (const key of Object.keys(value).sort()) {\n\t\t\tif (key === \"code\" \|\| key === \"cause\") continue;\n\t\t\toutput[key] = transcriptValue((value as unknown as Record<string, unknown>)[key], seen);\n\t\t}\n\t\treturn output;\n\t}\n\tif (typeof value !== \"object\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\tif (Array.isArray(value)) return value.map((item) => transcriptValue(item, seen));\n\tconst output: Record<string, unknown> = {};\n\tfor (const key of Object.keys(value as Record<string, unknown>).sort()) {\n\t\toutput[key] = transcriptValue((value as Record<string, unknown>)[key], seen);\n\t}\n\treturn output;\n}\n\nfunction canonicalJson(value: unknown): string {\n\tconst serialized = JSON.stringify(transcriptValue(value));\n\t// v8 ignore next -- transcriptValue 已消毒全部值，JSON.stringify 不会返回 undefined\n\tif (serialized === undefined) throw new Error(\"Plugin testkit transcript is not JSON-serializable\");\n\treturn serialized;\n}\n\ntype PluginTestKitLifecycleReport = PluginTestKitLifecycleFailureReport;\n\nfunction lifecycleFailureReport(error: unknown): PluginTestKitLifecycleReport \| undefined {\n\tif (!error \|\| typeof error !== \"object\") return undefined;\n\tconst report = (error as { report?: unknown }).report;\n\tif (!report \|\| typeof report !== \"object\") return undefined;\n\tconst candidate = report as RuntimeInspectorSnapshot[\"lifecycleReports\"][number];\n\t// v8 ignore next -- report 由 runtime 构造、形状恒满足；此处仅防御伪造的 report\n\tif (\n\t\ttypeof candidate.eventId !== \"string\" \|\|\n\t\ttypeof candidate.type !== \"string\" \|\|\n\t\t!Number.isSafeInteger(candidate.version) \|\|\n\t\t(candidate.phase !== \"raw\" && candidate.phase !== \"candidate\" && candidate.phase !== \"committed\") \|\|\n\t\t(candidate.status !== \"transform-failed\" &&\n\t\t\tcandidate.status !== \"execute-failed\" &&\n\t\t\tcandidate.status !== \"delivered\") \|\|\n\t\t!Array.isArray(candidate.failures)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\teventId: candidate.eventId,\n\t\ttype: candidate.type,\n\t\tversion: candidate.version,\n\t\tphase: candidate.phase,\n\t\tstatus: candidate.status,\n\t\tattempted: candidate.attempted,\n\t\tsucceeded: candidate.succeeded,\n\t\tfailed: candidate.failed,\n\t\tfailures: candidate.failures.map((failure) => ({\n\t\t\tpluginId: failure.pluginId,\n\t\t\tregistrationId: failure.registrationId,\n\t\t\tkind: failure.kind,\n\t\t\terror: transcriptValue(failure.error),\n\t\t})),\n\t};\n}\n\nfunction defaultHost(): HostCapabilities {\n\treturn {\n\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\tmode: \"full-control\",\n\t\tfeatures: [\"logger-v1\", \"diagnostics-v1\", \"plugin-state-v1\", \"runtime-inspector-v1\"],\n\t\ttransports: [\"in-process\"],\n\t};\n}\n\nconst DEFAULT_MANIFEST_ROOT = \"<plugin-testkit>\";\n\ninterface MutablePluginTestKitStateMutation {\n\tpluginId: string;\n\taction: \"set\" \| \"delete\";\n\tkey: string;\n\tstatus: \"committed\" \| \"rejected\";\n\trevision?: number;\n\texpectedRevision?: number;\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitStateWatchDelivery {\n\tpluginId: string;\n\twatcherId: string;\n\tkey: string;\n\trevision: number;\n\tstatus: \"delivered\" \| \"failed\";\n\tvalue?: unknown;\n\toperationId?: string;\n\tcorrelationId?: string;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitCapabilityCall {\n\toperationId: string \| null;\n\tcallerPluginId: string;\n\tproviderPluginId: string;\n\tcapabilityId: string;\n\tcapabilityVersion: number;\n\tcapabilityKind: PluginCapabilityDeclaration[\"kind\"];\n\tstatus: OperationStatus;\n\terror?: unknown;\n}\n\ninterface MutablePluginTestKitLifecycleFailure {\n\teventId: string \| null;\n\ttype: string \| null;\n\tversion: number \| null;\n\tphase: LifecyclePhase \| null;\n\tdeliveryId: string \| null;\n\tsource: string \| null;\n\toperationId?: string;\n\tcorrelationId?: string;\n\tcausationId?: string;\n\tdata?: unknown;\n\tstatus: \"rejected\" \| \"cancelled\" \| \"transform-failed\" \| \"execute-failed\";\n\terror: unknown;\n\treport?: PluginTestKitLifecycleFailureReport;\n}\n\n/* Create a runtime-only fixture with deterministic topology and teardown. /\nexport function createPluginTestKit(options: PluginTestKitOptions): PluginTestKit {\n\tconst manifestRoot = options.manifestRoot ?? DEFAULT_MANIFEST_ROOT;\n\tif (typeof manifestRoot !== \"string\" \|\| !manifestRoot.trim()) {\n\t\tthrow new Error(t(\"Plugin testkit manifestRoot must be a non-empty string\"));\n\t}\n\tconst inputPlugins = options.plugins.map((plugin) => ({\n\t\tmanifest: snapshot(plugin.manifest),\n\t\tfactory: plugin.factory,\n\t}));\n\tconst suppliedHost = options.host;\n\tconst host: HostCapabilities = {\n\t\t...defaultHost(),\n\t\t...suppliedHost,\n\t\tfeatures: suppliedHost?.features ?? defaultHost().features,\n\t\ttransports: suppliedHost?.transports ?? defaultHost().transports,\n\t};\n\tconst pluginsByManifest = new Map(inputPlugins.map((plugin) => [plugin.manifest, plugin]));\n\tconst handles = new Map<string, CapabilityPluginHandle>();\n\tconst revokedState = new Map<string, readonly StateEntry[]>();\n\tconst retainedState = new Map<string, readonly StateEntry[]>();\n\tconst loadOrder: string[] = [];\n\tconst stateMutations: MutablePluginTestKitStateMutation[] = [];\n\tconst stateWatchDeliveries: MutablePluginTestKitStateWatchDelivery[] = [];\n\tconst capabilityCalls: MutablePluginTestKitCapabilityCall[] = [];\n\tconst lifecycleEvents: PluginTestKitLifecycleEnvelope[] = [];\n\tconst lifecycleFailures: MutablePluginTestKitLifecycleFailure[] = [];\n\tconst pendingLifecycleDispatches = new Set<Promise<void>>();\n\tlet disposePromise: Promise<void> \| undefined;\n\tconst recordLifecycleDispatch = (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t): void => {\n\t\tconst recorded = settled.then(\n\t\t\t(result) => {\n\t\t\t\tlifecycleEvents.push(\n\t\t\t\t\tsnapshot({\n\t\t\t\t\t\teventId: result.event.id,\n\t\t\t\t\t\ttype: result.event.type,\n\t\t\t\t\t\tversion: result.event.version,\n\t\t\t\t\t\tphase: result.event.phase,\n\t\t\t\t\t\tdeliveryId: result.event.deliveryId,\n\t\t\t\t\t\tsource: result.event.source,\n\t\t\t\t\t\t...(result.event.operationId === undefined ? {} : { operationId: result.event.operationId }),\n\t\t\t\t\t\t...(result.event.correlationId === undefined ? {} : { correlationId: result.event.correlationId }),\n\t\t\t\t\t\t...(result.event.causationId === undefined ? {} : { causationId: result.event.causationId }),\n\t\t\t\t\t\tdata: transcriptValue(result.event.data),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tconst requestObject =\n\t\t\t\t\trequest && typeof request === \"object\" ? (request as unknown as Record<string, unknown>) : undefined;\n\t\t\t\tconst report = lifecycleFailureReport(error);\n\t\t\t\tconst rawPhase = requestObject?.phase;\n\t\t\t\tconst phase: LifecyclePhase \| null =\n\t\t\t\t\trawPhase === \"raw\" \|\| rawPhase === \"candidate\" \|\| rawPhase === \"committed\" ? rawPhase : null;\n\t\t\t\tconst rawSource = requestObject?.source;\n\t\t\t\tconst source =\n\t\t\t\t\trawSource === undefined\n\t\t\t\t\t\t? requestObject === undefined\n\t\t\t\t\t\t\t? null\n\t\t\t\t\t\t\t: \"host\"\n\t\t\t\t\t\t: typeof rawSource === \"string\"\n\t\t\t\t\t\t\t? rawSource\n\t\t\t\t\t\t\t: null;\n\t\t\t\tconst rawVersion = requestObject?.version;\n\t\t\t\tconst version = typeof rawVersion === \"number\" && Number.isSafeInteger(rawVersion) ? rawVersion : null;\n\t\t\t\tconst failure: MutablePluginTestKitLifecycleFailure = {\n\t\t\t\t\teventId: report?.eventId ?? null,\n\t\t\t\t\ttype: typeof requestObject?.type === \"string\" ? requestObject.type : null,\n\t\t\t\t\tversion,\n\t\t\t\t\tphase,\n\t\t\t\t\tdeliveryId: null,\n\t\t\t\t\tsource,\n\t\t\t\t\t...(typeof requestObject?.operationId === \"string\" ? { operationId: requestObject.operationId } : {}),\n\t\t\t\t\t...(typeof requestObject?.correlationId === \"string\"\n\t\t\t\t\t\t? { correlationId: requestObject.correlationId }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\t...(typeof requestObject?.causationId === \"string\" ? { causationId: requestObject.causationId } : {}),\n\t\t\t\t\t...(requestObject !== undefined && \"data\" in requestObject\n\t\t\t\t\t\t? { data: transcriptValue(requestObject.data) }\n\t\t\t\t\t\t: {}),\n\t\t\t\t\tstatus:\n\t\t\t\t\t\treport?.status === \"transform-failed\" \|\| report?.status === \"execute-failed\"\n\t\t\t\t\t\t\t? report.status\n\t\t\t\t\t\t\t: requestObject?.signal instanceof AbortSignal && requestObject.signal.aborted\n\t\t\t\t\t\t\t\t? \"cancelled\"\n\t\t\t\t\t\t\t\t: \"rejected\",\n\t\t\t\t\terror: transcriptValue(error),\n\t\t\t\t\t...(report === undefined ? {} : { report }),\n\t\t\t\t};\n\t\t\t\tlifecycleFailures.push(snapshot(failure));\n\t\t\t},\n\t\t);\n\t\tpendingLifecycleDispatches.add(recorded);\n\t\tvoid recorded.then(() => pendingLifecycleDispatches.delete(recorded));\n\t};\n\tconst runtime = createCapabilityRuntime(host, {\n\t\tclock: options.clock ?? (() => 0),\n\t\tidFactory: options.idFactory ?? ((kind, sequence) => `testkit:${kind}:${sequence}`),\n\t\tonLifecycleDispatch: recordLifecycleDispatch,\n\t});\n\t// Must run before the ready loop: plugin factories registerObserve during load.\n\tif (options.lifecycle === true) installBootstrapLifecycle(runtime);\n\n\tconst inputManifests = inputPlugins.map(({ manifest }) => ({\n\t\tpluginId: manifest.id,\n\t\tversion: manifest.version,\n\t\tentry: manifest.entry,\n\t}));\n\tconst inputOrder = inputPlugins.map(({ manifest }) => manifest.id);\n\tconst wrappedToRawAPI = new WeakMap<CapabilityAPI, CapabilityAPI>();\n\tconst wrapStateAPI = (pluginId: string, state: StateAPI): StateAPI => {\n\t\tconst operationMetadata = (options?: StateSetOptions) => ({\n\t\t\t...(options?.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),\n\t\t\t...(options?.operationId === undefined ? {} : { operationId: options.operationId }),\n\t\t\t...(options?.correlationId === undefined ? {} : { correlationId: options.correlationId }),\n\t\t});\n\t\tconst recordMutation = (\n\t\t\taction: \"set\" \| \"delete\",\n\t\t\tkey: string,\n\t\t\tmetadata: ReturnType<typeof operationMetadata>,\n\t\t\tresult: { status: \"committed\"; revision: number; value?: unknown } \| { status: \"rejected\"; error: unknown },\n\t\t): void => {\n\t\t\tstateMutations.push({\n\t\t\t\tpluginId,\n\t\t\t\taction,\n\t\t\t\tkey,\n\t\t\t\t...metadata,\n\t\t\t\t...result,\n\t\t\t});\n\t\t};\n\t\treturn Object.freeze({\n\t\t\tget: (key: string) => state.get(key),\n\t\t\tset: (key: string, value: Parameters<StateAPI[\"set\"]>[1], options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.set(key, value, options);\n\t\t\t\t\trecordMutation(\"set\", key, metadata, {\n\t\t\t\t\t\tstatus: \"committed\",\n\t\t\t\t\t\trevision,\n\t\t\t\t\t\tvalue: transcriptValue(value),\n\t\t\t\t\t});\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"set\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelete: (key: string, options?: StateSetOptions) => {\n\t\t\t\tconst metadata = operationMetadata(options);\n\t\t\t\ttry {\n\t\t\t\t\tconst revision = state.delete(key, options);\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"committed\", revision });\n\t\t\t\t\treturn revision;\n\t\t\t\t} catch (error) {\n\t\t\t\t\trecordMutation(\"delete\", key, metadata, { status: \"rejected\", error: transcriptValue(error) });\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t},\n\t\t\tlist: (prefix?: string) => state.list(prefix),\n\t\t\twatch: (prefix: string \| undefined, handler: (change: StateChange) => void) => {\n\t\t\t\tlet watcherId = \"<pending>\";\n\t\t\t\tconst registration = state.watch(prefix, (change) => {\n\t\t\t\t\tconst delivery: MutablePluginTestKitStateWatchDelivery = {\n\t\t\t\t\t\tpluginId,\n\t\t\t\t\t\twatcherId,\n\t\t\t\t\t\tkey: change.key,\n\t\t\t\t\t\trevision: change.revision,\n\t\t\t\t\t\tstatus: \"delivered\",\n\t\t\t\t\t\t...(change.value === undefined ? {} : { value: transcriptValue(change.value) }),\n\t\t\t\t\t\t...(change.operationId === undefined ? {} : { operationId: change.operationId }),\n\t\t\t\t\t\t...(change.correlationId === undefined ? {} : { correlationId: change.correlationId }),\n\t\t\t\t\t};\n\t\t\t\t\tstateWatchDeliveries.push(delivery);\n\t\t\t\t\ttry {\n\t\t\t\t\t\thandler(change);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tdelivery.status = \"failed\";\n\t\t\t\t\t\tdelivery.error = transcriptValue(error);\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\twatcherId = registration.id;\n\t\t\t\treturn registration;\n\t\t\t},\n\t\t});\n\t};\n\tconst wrapCapabilityDirectory = (\n\t\tcallerPluginId: string,\n\t\tcapabilities: CapabilityDirectoryAPI,\n\t): CapabilityDirectoryAPI =>\n\t\tObject.freeze({\n\t\t\tprovide: <TInput = unknown, TResult = unknown>(\n\t\t\t\tdeclaration: PluginCapabilityDeclaration,\n\t\t\t\thandler: CapabilityProviderHandler<TInput, TResult>,\n\t\t\t): DisposableRegistration => capabilities.provide(declaration, handler),\n\t\t\trequire: <TResult = unknown>(id: string, requireOptions?: { version?: number }) => {\n\t\t\t\tconst handle = capabilities.require<TResult>(id, requireOptions);\n\t\t\t\treturn Object.freeze({\n\t\t\t\t\tdeclaration: handle.declaration,\n\t\t\t\t\towner: handle.owner,\n\t\t\t\t\tcall: (input: unknown, callOptions?: { signal?: AbortSignal }): OperationHandle<TResult> => {\n\t\t\t\t\t\tlet operation: OperationHandle<TResult>;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\toperation = handle.call(input, callOptions);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tcapabilityCalls.push({\n\t\t\t\t\t\t\t\toperationId: null,\n\t\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\t\terror: transcriptValue(error),\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\tconst record: MutablePluginTestKitCapabilityCall = {\n\t\t\t\t\t\t\toperationId: operation.id,\n\t\t\t\t\t\t\tcallerPluginId,\n\t\t\t\t\t\t\tproviderPluginId: handle.owner,\n\t\t\t\t\t\t\tcapabilityId: handle.declaration.id,\n\t\t\t\t\t\t\tcapabilityVersion: handle.declaration.version,\n\t\t\t\t\t\t\tcapabilityKind: handle.declaration.kind,\n\t\t\t\t\t\t\tstatus: operation.status(),\n\t\t\t\t\t\t};\n\t\t\t\t\t\tcapabilityCalls.push(record);\n\t\t\t\t\t\tvoid operation.result.then(\n\t\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(error) => {\n\t\t\t\t\t\t\t\trecord.status = operation.status();\n\t\t\t\t\t\t\t\trecord.error = transcriptValue(error);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn operation;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t},\n\t\t\tlist: (listOptions?: { kind?: PluginCapabilityDeclaration[\"kind\"] }) => capabilities.list(listOptions),\n\t\t});\n\tconst originalCreateAPI = runtime.createAPI.bind(runtime);\n\tconst originalRevokeAPI = runtime.revokeAPI.bind(runtime);\n\truntime.createAPI = (manifest) => {\n\t\tconst rawAPI = originalCreateAPI(manifest);\n\t\tconst wrappedAPI = Object.freeze({\n\t\t\t...rawAPI,\n\t\t\tcapabilities: wrapCapabilityDirectory(rawAPI.manifest.id, rawAPI.capabilities),\n\t\t\t...(rawAPI.state === undefined ? {} : { state: wrapStateAPI(rawAPI.manifest.id, rawAPI.state) }),\n\t\t});\n\t\twrappedToRawAPI.set(wrappedAPI, rawAPI);\n\t\treturn wrappedAPI;\n\t};\n\truntime.revokeAPI = (api) => {\n\t\t// v8 ignore next -- 所有 API 均经包装后的 createAPI 创建，映射必命中\n\t\tconst rawAPI = wrappedToRawAPI.get(api) ?? api;\n\t\tfor (const [pluginId, handle] of handles) {\n\t\t\tif (handle.api === api \|\| handle.api === rawAPI) captureState(pluginId, handle);\n\t\t}\n\t\toriginalRevokeAPI(rawAPI);\n\t};\n\n\tconst captureState = (pluginId: string, handle: CapabilityPluginHandle): void => {\n\t\tif (retainedState.has(pluginId) \|\| revokedState.has(pluginId)) return;\n\t\tretainedState.set(pluginId, snapshot(handle.api.state?.list() ?? []));\n\t};\n\tconst stateTranscript = (): readonly { readonly pluginId: string; readonly entries: readonly StateEntry[] }[] =>\n\t\t[...handles.entries()].map(([pluginId, handle]) => {\n\t\t\treturn {\n\t\t\t\tpluginId,\n\t\t\t\tentries: retainedState.get(pluginId) ?? snapshot(handle.api.state?.list() ?? []),\n\t\t\t};\n\t\t});\n\n\tlet closing = false;\n\tconst ready = (async () => {\n\t\ttry {\n\t\t\tconst ordered = resolvePluginCapabilityOrder(inputPlugins.map((plugin) => plugin.manifest));\n\t\t\tfor (const manifest of ordered) {\n\t\t\t\tif (closing) throw new Error(\"Plugin testkit was disposed during startup\");\n\t\t\t\tconst plugin = pluginsByManifest.get(manifest);\n\t\t\t\t// v8 ignore next -- plugins 数组同时供给加载顺序与 factory 映射，必可解析\n\t\t\t\tif (!plugin) throw new Error(`Plugin testkit cannot resolve factory: ${manifest.id}`);\n\t\t\t\tconst handle = await loadCapabilityPlugin(runtime, plugin.manifest, plugin.factory);\n\t\t\t\thandles.set(manifest.id, handle);\n\t\t\t\tloadOrder.push(manifest.id);\n\t\t\t}\n\t\t} catch (startupError) {\n\t\t\tconst failures: unknown[] = [startupError];\n\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\ttry {\n\t\t\t\t\tawait handle.dispose();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t}\n\t\t\thandles.clear();\n\t\t\ttry {\n\t\t\t\tawait runtime.disposeAll();\n\t\t\t} catch (error) {\n\t\t\t\tfailures.push(error);\n\t\t\t}\n\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit startup rollback failed\");\n\t\t\tthrow startupError;\n\t\t}\n\t})();\n\n\treturn {\n\t\truntime,\n\t\tready,\n\t\tapi(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\treturn handle.api;\n\t\t},\n\t\trevoke(pluginId) {\n\t\t\tconst handle = handles.get(pluginId);\n\t\t\tif (!handle) throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);\n\t\t\tif (handle.api.state) {\n\t\t\t\tconst entries = snapshot(handle.api.state.list());\n\t\t\t\trevokedState.set(pluginId, entries);\n\t\t\t\tretainedState.set(pluginId, entries);\n\t\t\t}\n\t\t\truntime.revokeAPI(handle.api);\n\t\t},\n\t\tinspect: () => runtime.inspect(),\n\t\tflushLifecycle: async () => {\n\t\t\twhile (pendingLifecycleDispatches.size > 0) {\n\t\t\t\tawait Promise.all([...pendingLifecycleDispatches]);\n\t\t\t}\n\t\t\tawait runtime.drainLifecycleDeliveries();\n\t\t},\n\t\ttranscript: () =>\n\t\t\tsnapshot(\n\t\t\t\ttranscriptValue({\n\t\t\t\t\tversion: 1 as const,\n\t\t\t\t\tmanifestRoot,\n\t\t\t\t\tmanifests: inputManifests,\n\t\t\t\t\tinputOrder,\n\t\t\t\t\tloadOrder,\n\t\t\t\t\tstate: stateTranscript(),\n\t\t\t\t\tstateMutations,\n\t\t\t\t\tstateWatchDeliveries,\n\t\t\t\t\tcapabilityCalls,\n\t\t\t\t\tlifecycleEvents,\n\t\t\t\t\tlifecycleFailures,\n\t\t\t\t\tlifecycleReports: runtime.inspect().lifecycleReports,\n\t\t\t\t\tinspector: runtime.inspect(),\n\t\t\t\t}) as PluginTestKitTranscript,\n\t\t\t),\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tclosing = true;\n\t\t\t\tconst failures: unknown[] = [];\n\t\t\t\ttry {\n\t\t\t\t\tawait ready;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!(error instanceof Error && error.message === \"Plugin testkit was disposed during startup\")) {\n\t\t\t\t\t\tfailures.push(error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfor (const [pluginId, handle] of handles) captureState(pluginId, handle);\n\t\t\t\tfor (const handle of [...handles.values()].reverse()) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait handle.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\ttry {\n\t\t\t\t\tawait runtime.disposeAll();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tfailures.push(error);\n\t\t\t\t}\n\t\t\t\tif (failures.length === 1) throw failures[0];\n\t\t\t\tif (failures.length > 1) throw new AggregateError(failures, \"Plugin testkit disposal failed\");\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n}\n\n/* Runs a fixture repeatedly and rejects on the first transcript divergence. */\nexport async function repeatPluginTestKit(\n\ttimes: number,\n\trun: () => Promise<PluginTestKitTranscript>,\n): Promise<PluginTestKitTranscript> {\n\tif (!Number.isSafeInteger(times) \|\| times < 1)\n\t\tthrow new Error(t(\"Plugin testkit repeat count must be a positive integer\"));\n\tlet baseline: PluginTestKitTranscript \| undefined;\n\tfor (let index = 0; index < times; index += 1) {\n\t\tconst transcript = await run();\n\t\tif (baseline && canonicalJson(transcript) !== canonicalJson(baseline)) {\n\t\t\tthrow new Error(t(\"Plugin testkit transcript diverged on run {run}\", { run: index + 1 }));\n\t\t}\n\t\tbaseline = transcript;\n\t}\n\treturn baseline!;\n}\n"]}

package/dist/testing/runtime-delivery-queue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runtime-delivery-queue.d.ts","sourceRoot":"","sources":["../../src/testing/runtime-delivery-queue.ts"],"names":[],"mappings":"~~AAAA~~,4EAA4E;AAC5E,eAAO,MAAM,uCAAuC,sCAAgD,CAAC;AAErG,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B,CAAC,CAAC;IACjD,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,gCAAgC,CAAC;CAC7C;AAED,qBAAa,oCAAqC,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,uCAA2C;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAQ/D;CACD;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC/C,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,GACzC,wBAAwB,CAAC,CAAC,CAAC,CAsH7B","sourcesContent":["/** Stable error code required by the model.stream backpressure contract. /\nexport const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE = \"model_stream_backpressure_overflow\" as const;\n\nexport type RuntimeOnlyDeliveryQueueStatus = \"active\" \| \"overflowed\" \| \"closed\";\n\nexport interface RuntimeOnlyDeliveryQueueSnapshot {\n\treadonly status: RuntimeOnlyDeliveryQueueStatus;\n\treadonly capacity: number;\n\t/* Weight of in-flight and queued values that have not finished delivery. /\n\treadonly pending: number;\n\treadonly accepted: number;\n\treadonly delivered: number;\n\treadonly rejected: number;\n}\n\nexport interface RuntimeOnlyDeliveryQueueOptions<T> {\n\t/* Maximum pending weight for this subscription. /\n\treadonly capacity: number;\n\t/* Defaults to one event per value. /\n\treadonly measure?: (value: T) => number;\n\treadonly deliver: (value: T) => void \| Promise<void>;\n}\n\nexport interface RuntimeOnlyDeliveryQueue<T> {\n\tenqueue(value: T): Promise<void>;\n\tdrain(): Promise<void>;\n\tclose(): void;\n\tsnapshot(): RuntimeOnlyDeliveryQueueSnapshot;\n}\n\nexport class RuntimeOnlyBackpressureOverflowError extends Error {\n\treadonly code = MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE;\n\treadonly capacity: number;\n\treadonly pending: number;\n\treadonly attempted: number;\n\n\tconstructor(capacity: number, pending: number, attempted: number) {\n\t\tsuper(\n\t\t\t`Runtime-only delivery queue overflow: pending ${pending} + attempted ${attempted} exceeds capacity ${capacity}`,\n\t\t);\n\t\tthis.name = \"RuntimeOnlyBackpressureOverflowError\";\n\t\tthis.capacity = capacity;\n\t\tthis.pending = pending;\n\t\tthis.attempted = attempted;\n\t}\n}\n\ninterface QueueEntry<T> {\n\treadonly value: T;\n\treadonly weight: number;\n\treadonly resolve: () => void;\n\treadonly reject: (error: unknown) => void;\n}\n\nfunction assertPositiveSafeInteger(value: number, name: string): void {\n\tif (!Number.isSafeInteger(value) \|\| value < 1) {\n\t\tthrow new Error(`Runtime-only delivery queue ${name} must be a positive safe integer`);\n\t}\n}\n\n/\n Creates a deterministic host-side subscription queue for runtime-only tests.\n \n Overflow rejects only the new enqueue, permanently terminates this queue,\n * and leaves already accepted values in order for delivery. Other queues are\n * independent and are not affected.\n \n Test-only divergence from the production lifecycle delivery queue: a handler\n * failure closes this whole queue and rejects every pending value with the\n * same error, while the production queue isolates the failure to that single\n * delivery and keeps accepting. Tests that need production semantics must use\n * the production runtime, not this fixture.\n */\nexport function createRuntimeOnlyDeliveryQueue<T>(\n\toptions: RuntimeOnlyDeliveryQueueOptions<T>,\n): RuntimeOnlyDeliveryQueue<T> {\n\tassertPositiveSafeInteger(options.capacity, \"capacity\");\n\tconst measure = options.measure ?? (() => 1);\n\tconst entries: QueueEntry<T>[] = [];\n\tlet status: RuntimeOnlyDeliveryQueueStatus = \"active\";\n\tlet pending = 0;\n\tlet accepted = 0;\n\tlet delivered = 0;\n\tlet rejected = 0;\n\tlet processing = false;\n\tlet drainPromise: Promise<void> \| undefined;\n\tlet resolveDrain: (() => void) \| undefined;\n\n\tconst ensureDrainPromise = (): Promise<void> => {\n\t\tif (drainPromise === undefined) {\n\t\t\tdrainPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveDrain = resolve;\n\t\t\t});\n\t\t}\n\t\treturn drainPromise;\n\t};\n\n\tconst settleDrainIfIdle = (): void => {\n\t\tif (processing \|\| entries.length > 0) return;\n\t\tresolveDrain?.();\n\t\tdrainPromise = undefined;\n\t\tresolveDrain = undefined;\n\t};\n\n\tconst pump = async (): Promise<void> => {\n\t\tif (processing) return;\n\t\tprocessing = true;\n\t\ttry {\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\ttry {\n\t\t\t\t\tawait options.deliver(entry.value);\n\t\t\t\t\tdelivered += 1;\n\t\t\t\t\tentry.resolve();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstatus = \"closed\";\n\t\t\t\t\trejected += 1;\n\t\t\t\t\tentry.reject(error);\n\t\t\t\t\twhile (entries.length > 0) {\n\t\t\t\t\t\tconst pendingEntry = entries.shift();\n\t\t\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\t\t\tif (pendingEntry === undefined) continue;\n\t\t\t\t\t\tpending -= pendingEntry.weight;\n\t\t\t\t\t\trejected += 1;\n\t\t\t\t\t\tpendingEntry.reject(error);\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tpending -= entry.weight;\n\t\t\t\t}\n\t\t\t\tif (status === \"closed\") break;\n\t\t\t}\n\t\t} finally {\n\t\t\tprocessing = false;\n\t\t\tsettleDrainIfIdle();\n\t\t}\n\t};\n\n\tconst enqueue = (value: T): Promise<void> => {\n\t\tif (status !== \"active\") {\n\t\t\trejected += 1;\n\t\t\tif (status === \"overflowed\") {\n\t\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, 0));\n\t\t\t}\n\t\t\treturn Promise.reject(new Error(`Runtime-only delivery queue is ${status}`));\n\t\t}\n\t\tconst weight = measure(value);\n\t\tassertPositiveSafeInteger(weight, \"measure result\");\n\t\tif (pending + weight > options.capacity) {\n\t\t\tstatus = \"overflowed\";\n\t\t\trejected += 1;\n\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, weight));\n\t\t}\n\t\taccepted += 1;\n\t\tpending += weight;\n\t\tconst result = new Promise<void>((resolve, reject) => {\n\t\t\tentries.push({ value, weight, resolve, reject });\n\t\t});\n\t\tensureDrainPromise();\n\t\tvoid pump();\n\t\treturn result;\n\t};\n\n\treturn {\n\t\tenqueue,\n\t\tdrain: () => {\n\t\t\tif (!processing && entries.length === 0) return Promise.resolve();\n\t\t\treturn ensureDrainPromise();\n\t\t},\n\t\tclose: () => {\n\t\t\tif (status === \"closed\") return;\n\t\t\tstatus = \"closed\";\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\tpending -= entry.weight;\n\t\t\t\trejected += 1;\n\t\t\t\tentry.reject(new Error(\"Runtime-only delivery queue was closed\"));\n\t\t\t}\n\t\t\tsettleDrainIfIdle();\n\t\t},\n\t\tsnapshot: () =>\n\t\t\tObject.freeze({\n\t\t\t\tstatus,\n\t\t\t\tcapacity: options.capacity,\n\t\t\t\tpending,\n\t\t\t\taccepted,\n\t\t\t\tdelivered,\n\t\t\t\trejected,\n\t\t\t}),\n\t};\n}\n"]}
1	+ {"version":3,"file":"runtime-delivery-queue.d.ts","sourceRoot":"","sources":["../../src/testing/runtime-delivery-queue.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,uCAAuC,sCAAgD,CAAC;AAErG,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B,CAAC,CAAC;IACjD,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,gCAAgC,CAAC;CAC7C;AAED,qBAAa,oCAAqC,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,uCAA2C;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAQ/D;CACD;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC/C,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,GACzC,wBAAwB,CAAC,CAAC,CAAC,CAsH7B","sourcesContent":["import { t } from \"../core/i18n/index.ts\";\n\n/** Stable error code required by the model.stream backpressure contract. /\nexport const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE = \"model_stream_backpressure_overflow\" as const;\n\nexport type RuntimeOnlyDeliveryQueueStatus = \"active\" \| \"overflowed\" \| \"closed\";\n\nexport interface RuntimeOnlyDeliveryQueueSnapshot {\n\treadonly status: RuntimeOnlyDeliveryQueueStatus;\n\treadonly capacity: number;\n\t/* Weight of in-flight and queued values that have not finished delivery. /\n\treadonly pending: number;\n\treadonly accepted: number;\n\treadonly delivered: number;\n\treadonly rejected: number;\n}\n\nexport interface RuntimeOnlyDeliveryQueueOptions<T> {\n\t/* Maximum pending weight for this subscription. /\n\treadonly capacity: number;\n\t/* Defaults to one event per value. /\n\treadonly measure?: (value: T) => number;\n\treadonly deliver: (value: T) => void \| Promise<void>;\n}\n\nexport interface RuntimeOnlyDeliveryQueue<T> {\n\tenqueue(value: T): Promise<void>;\n\tdrain(): Promise<void>;\n\tclose(): void;\n\tsnapshot(): RuntimeOnlyDeliveryQueueSnapshot;\n}\n\nexport class RuntimeOnlyBackpressureOverflowError extends Error {\n\treadonly code = MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE;\n\treadonly capacity: number;\n\treadonly pending: number;\n\treadonly attempted: number;\n\n\tconstructor(capacity: number, pending: number, attempted: number) {\n\t\tsuper(\n\t\t\t`Runtime-only delivery queue overflow: pending ${pending} + attempted ${attempted} exceeds capacity ${capacity}`,\n\t\t);\n\t\tthis.name = \"RuntimeOnlyBackpressureOverflowError\";\n\t\tthis.capacity = capacity;\n\t\tthis.pending = pending;\n\t\tthis.attempted = attempted;\n\t}\n}\n\ninterface QueueEntry<T> {\n\treadonly value: T;\n\treadonly weight: number;\n\treadonly resolve: () => void;\n\treadonly reject: (error: unknown) => void;\n}\n\nfunction assertPositiveSafeInteger(value: number, name: string): void {\n\tif (!Number.isSafeInteger(value) \|\| value < 1) {\n\t\tthrow new Error(t(\"Runtime-only delivery queue {name} must be a positive safe integer\", { name }));\n\t}\n}\n\n/\n Creates a deterministic host-side subscription queue for runtime-only tests.\n \n Overflow rejects only the new enqueue, permanently terminates this queue,\n * and leaves already accepted values in order for delivery. Other queues are\n * independent and are not affected.\n \n Test-only divergence from the production lifecycle delivery queue: a handler\n * failure closes this whole queue and rejects every pending value with the\n * same error, while the production queue isolates the failure to that single\n * delivery and keeps accepting. Tests that need production semantics must use\n * the production runtime, not this fixture.\n */\nexport function createRuntimeOnlyDeliveryQueue<T>(\n\toptions: RuntimeOnlyDeliveryQueueOptions<T>,\n): RuntimeOnlyDeliveryQueue<T> {\n\tassertPositiveSafeInteger(options.capacity, \"capacity\");\n\tconst measure = options.measure ?? (() => 1);\n\tconst entries: QueueEntry<T>[] = [];\n\tlet status: RuntimeOnlyDeliveryQueueStatus = \"active\";\n\tlet pending = 0;\n\tlet accepted = 0;\n\tlet delivered = 0;\n\tlet rejected = 0;\n\tlet processing = false;\n\tlet drainPromise: Promise<void> \| undefined;\n\tlet resolveDrain: (() => void) \| undefined;\n\n\tconst ensureDrainPromise = (): Promise<void> => {\n\t\tif (drainPromise === undefined) {\n\t\t\tdrainPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveDrain = resolve;\n\t\t\t});\n\t\t}\n\t\treturn drainPromise;\n\t};\n\n\tconst settleDrainIfIdle = (): void => {\n\t\tif (processing \|\| entries.length > 0) return;\n\t\tresolveDrain?.();\n\t\tdrainPromise = undefined;\n\t\tresolveDrain = undefined;\n\t};\n\n\tconst pump = async (): Promise<void> => {\n\t\tif (processing) return;\n\t\tprocessing = true;\n\t\ttry {\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\ttry {\n\t\t\t\t\tawait options.deliver(entry.value);\n\t\t\t\t\tdelivered += 1;\n\t\t\t\t\tentry.resolve();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstatus = \"closed\";\n\t\t\t\t\trejected += 1;\n\t\t\t\t\tentry.reject(error);\n\t\t\t\t\twhile (entries.length > 0) {\n\t\t\t\t\t\tconst pendingEntry = entries.shift();\n\t\t\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\t\t\tif (pendingEntry === undefined) continue;\n\t\t\t\t\t\tpending -= pendingEntry.weight;\n\t\t\t\t\t\trejected += 1;\n\t\t\t\t\t\tpendingEntry.reject(error);\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tpending -= entry.weight;\n\t\t\t\t}\n\t\t\t\tif (status === \"closed\") break;\n\t\t\t}\n\t\t} finally {\n\t\t\tprocessing = false;\n\t\t\tsettleDrainIfIdle();\n\t\t}\n\t};\n\n\tconst enqueue = (value: T): Promise<void> => {\n\t\tif (status !== \"active\") {\n\t\t\trejected += 1;\n\t\t\tif (status === \"overflowed\") {\n\t\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, 0));\n\t\t\t}\n\t\t\treturn Promise.reject(new Error(`Runtime-only delivery queue is ${status}`));\n\t\t}\n\t\tconst weight = measure(value);\n\t\tassertPositiveSafeInteger(weight, \"measure result\");\n\t\tif (pending + weight > options.capacity) {\n\t\t\tstatus = \"overflowed\";\n\t\t\trejected += 1;\n\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, weight));\n\t\t}\n\t\taccepted += 1;\n\t\tpending += weight;\n\t\tconst result = new Promise<void>((resolve, reject) => {\n\t\t\tentries.push({ value, weight, resolve, reject });\n\t\t});\n\t\tensureDrainPromise();\n\t\tvoid pump();\n\t\treturn result;\n\t};\n\n\treturn {\n\t\tenqueue,\n\t\tdrain: () => {\n\t\t\tif (!processing && entries.length === 0) return Promise.resolve();\n\t\t\treturn ensureDrainPromise();\n\t\t},\n\t\tclose: () => {\n\t\t\tif (status === \"closed\") return;\n\t\t\tstatus = \"closed\";\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\tpending -= entry.weight;\n\t\t\t\trejected += 1;\n\t\t\t\tentry.reject(new Error(\"Runtime-only delivery queue was closed\"));\n\t\t\t}\n\t\t\tsettleDrainIfIdle();\n\t\t},\n\t\tsnapshot: () =>\n\t\t\tObject.freeze({\n\t\t\t\tstatus,\n\t\t\t\tcapacity: options.capacity,\n\t\t\t\tpending,\n\t\t\t\taccepted,\n\t\t\t\tdelivered,\n\t\t\t\trejected,\n\t\t\t}),\n\t};\n}\n"]}

package/dist/testing/runtime-delivery-queue.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { t } from "../core/i18n/index.js";
 /** Stable error code required by the model.stream backpressure contract. */
 export const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE = "model_stream_backpressure_overflow";
 export class RuntimeOnlyBackpressureOverflowError extends Error {
@@ -15,7 +16,7 @@ export class RuntimeOnlyBackpressureOverflowError extends Error {
 }
 function assertPositiveSafeInteger(value, name) {
     if (!Number.isSafeInteger(value) || value < 1) {
-        throw new Error(`Runtime-only delivery queue ${name} must be a positive safe integer`);
+        throw new Error(t("Runtime-only delivery queue {name} must be a positive safe integer", { name }));
     }
 }
 /**

package/dist/testing/runtime-delivery-queue.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runtime-delivery-queue.js","sourceRoot":"","sources":["../../src/testing/runtime-delivery-queue.ts"],"names":[],"mappings":"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","sourcesContent":["/** Stable error code required by the model.stream backpressure contract. /\nexport const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE = \"model_stream_backpressure_overflow\" as const;\n\nexport type RuntimeOnlyDeliveryQueueStatus = \"active\" \| \"overflowed\" \| \"closed\";\n\nexport interface RuntimeOnlyDeliveryQueueSnapshot {\n\treadonly status: RuntimeOnlyDeliveryQueueStatus;\n\treadonly capacity: number;\n\t/* Weight of in-flight and queued values that have not finished delivery. /\n\treadonly pending: number;\n\treadonly accepted: number;\n\treadonly delivered: number;\n\treadonly rejected: number;\n}\n\nexport interface RuntimeOnlyDeliveryQueueOptions<T> {\n\t/* Maximum pending weight for this subscription. /\n\treadonly capacity: number;\n\t/* Defaults to one event per value. /\n\treadonly measure?: (value: T) => number;\n\treadonly deliver: (value: T) => void \| Promise<void>;\n}\n\nexport interface RuntimeOnlyDeliveryQueue<T> {\n\tenqueue(value: T): Promise<void>;\n\tdrain(): Promise<void>;\n\tclose(): void;\n\tsnapshot(): RuntimeOnlyDeliveryQueueSnapshot;\n}\n\nexport class RuntimeOnlyBackpressureOverflowError extends Error {\n\treadonly code = MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE;\n\treadonly capacity: number;\n\treadonly pending: number;\n\treadonly attempted: number;\n\n\tconstructor(capacity: number, pending: number, attempted: number) {\n\t\tsuper(\n\t\t\t`Runtime-only delivery queue overflow: pending ${pending} + attempted ${attempted} exceeds capacity ${capacity}`,\n\t\t);\n\t\tthis.name = \"RuntimeOnlyBackpressureOverflowError\";\n\t\tthis.capacity = capacity;\n\t\tthis.pending = pending;\n\t\tthis.attempted = attempted;\n\t}\n}\n\ninterface QueueEntry<T> {\n\treadonly value: T;\n\treadonly weight: number;\n\treadonly resolve: () => void;\n\treadonly reject: (error: unknown) => void;\n}\n\nfunction assertPositiveSafeInteger(value: number, name: string): void {\n\tif (!Number.isSafeInteger(value) \|\| value < 1) {\n\t\tthrow new Error(`Runtime-only delivery queue ${name} must be a positive safe integer`);\n\t}\n}\n\n/\n Creates a deterministic host-side subscription queue for runtime-only tests.\n \n Overflow rejects only the new enqueue, permanently terminates this queue,\n * and leaves already accepted values in order for delivery. Other queues are\n * independent and are not affected.\n \n Test-only divergence from the production lifecycle delivery queue: a handler\n * failure closes this whole queue and rejects every pending value with the\n * same error, while the production queue isolates the failure to that single\n * delivery and keeps accepting. Tests that need production semantics must use\n * the production runtime, not this fixture.\n */\nexport function createRuntimeOnlyDeliveryQueue<T>(\n\toptions: RuntimeOnlyDeliveryQueueOptions<T>,\n): RuntimeOnlyDeliveryQueue<T> {\n\tassertPositiveSafeInteger(options.capacity, \"capacity\");\n\tconst measure = options.measure ?? (() => 1);\n\tconst entries: QueueEntry<T>[] = [];\n\tlet status: RuntimeOnlyDeliveryQueueStatus = \"active\";\n\tlet pending = 0;\n\tlet accepted = 0;\n\tlet delivered = 0;\n\tlet rejected = 0;\n\tlet processing = false;\n\tlet drainPromise: Promise<void> \| undefined;\n\tlet resolveDrain: (() => void) \| undefined;\n\n\tconst ensureDrainPromise = (): Promise<void> => {\n\t\tif (drainPromise === undefined) {\n\t\t\tdrainPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveDrain = resolve;\n\t\t\t});\n\t\t}\n\t\treturn drainPromise;\n\t};\n\n\tconst settleDrainIfIdle = (): void => {\n\t\tif (processing \|\| entries.length > 0) return;\n\t\tresolveDrain?.();\n\t\tdrainPromise = undefined;\n\t\tresolveDrain = undefined;\n\t};\n\n\tconst pump = async (): Promise<void> => {\n\t\tif (processing) return;\n\t\tprocessing = true;\n\t\ttry {\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\ttry {\n\t\t\t\t\tawait options.deliver(entry.value);\n\t\t\t\t\tdelivered += 1;\n\t\t\t\t\tentry.resolve();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstatus = \"closed\";\n\t\t\t\t\trejected += 1;\n\t\t\t\t\tentry.reject(error);\n\t\t\t\t\twhile (entries.length > 0) {\n\t\t\t\t\t\tconst pendingEntry = entries.shift();\n\t\t\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\t\t\tif (pendingEntry === undefined) continue;\n\t\t\t\t\t\tpending -= pendingEntry.weight;\n\t\t\t\t\t\trejected += 1;\n\t\t\t\t\t\tpendingEntry.reject(error);\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tpending -= entry.weight;\n\t\t\t\t}\n\t\t\t\tif (status === \"closed\") break;\n\t\t\t}\n\t\t} finally {\n\t\t\tprocessing = false;\n\t\t\tsettleDrainIfIdle();\n\t\t}\n\t};\n\n\tconst enqueue = (value: T): Promise<void> => {\n\t\tif (status !== \"active\") {\n\t\t\trejected += 1;\n\t\t\tif (status === \"overflowed\") {\n\t\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, 0));\n\t\t\t}\n\t\t\treturn Promise.reject(new Error(`Runtime-only delivery queue is ${status}`));\n\t\t}\n\t\tconst weight = measure(value);\n\t\tassertPositiveSafeInteger(weight, \"measure result\");\n\t\tif (pending + weight > options.capacity) {\n\t\t\tstatus = \"overflowed\";\n\t\t\trejected += 1;\n\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, weight));\n\t\t}\n\t\taccepted += 1;\n\t\tpending += weight;\n\t\tconst result = new Promise<void>((resolve, reject) => {\n\t\t\tentries.push({ value, weight, resolve, reject });\n\t\t});\n\t\tensureDrainPromise();\n\t\tvoid pump();\n\t\treturn result;\n\t};\n\n\treturn {\n\t\tenqueue,\n\t\tdrain: () => {\n\t\t\tif (!processing && entries.length === 0) return Promise.resolve();\n\t\t\treturn ensureDrainPromise();\n\t\t},\n\t\tclose: () => {\n\t\t\tif (status === \"closed\") return;\n\t\t\tstatus = \"closed\";\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\tpending -= entry.weight;\n\t\t\t\trejected += 1;\n\t\t\t\tentry.reject(new Error(\"Runtime-only delivery queue was closed\"));\n\t\t\t}\n\t\t\tsettleDrainIfIdle();\n\t\t},\n\t\tsnapshot: () =>\n\t\t\tObject.freeze({\n\t\t\t\tstatus,\n\t\t\t\tcapacity: options.capacity,\n\t\t\t\tpending,\n\t\t\t\taccepted,\n\t\t\t\tdelivered,\n\t\t\t\trejected,\n\t\t\t}),\n\t};\n}\n"]}
1	+ {"version":3,"file":"runtime-delivery-queue.js","sourceRoot":"","sources":["../../src/testing/runtime-delivery-queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { t } from \"../core/i18n/index.ts\";\n\n/** Stable error code required by the model.stream backpressure contract. /\nexport const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE = \"model_stream_backpressure_overflow\" as const;\n\nexport type RuntimeOnlyDeliveryQueueStatus = \"active\" \| \"overflowed\" \| \"closed\";\n\nexport interface RuntimeOnlyDeliveryQueueSnapshot {\n\treadonly status: RuntimeOnlyDeliveryQueueStatus;\n\treadonly capacity: number;\n\t/* Weight of in-flight and queued values that have not finished delivery. /\n\treadonly pending: number;\n\treadonly accepted: number;\n\treadonly delivered: number;\n\treadonly rejected: number;\n}\n\nexport interface RuntimeOnlyDeliveryQueueOptions<T> {\n\t/* Maximum pending weight for this subscription. /\n\treadonly capacity: number;\n\t/* Defaults to one event per value. /\n\treadonly measure?: (value: T) => number;\n\treadonly deliver: (value: T) => void \| Promise<void>;\n}\n\nexport interface RuntimeOnlyDeliveryQueue<T> {\n\tenqueue(value: T): Promise<void>;\n\tdrain(): Promise<void>;\n\tclose(): void;\n\tsnapshot(): RuntimeOnlyDeliveryQueueSnapshot;\n}\n\nexport class RuntimeOnlyBackpressureOverflowError extends Error {\n\treadonly code = MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE;\n\treadonly capacity: number;\n\treadonly pending: number;\n\treadonly attempted: number;\n\n\tconstructor(capacity: number, pending: number, attempted: number) {\n\t\tsuper(\n\t\t\t`Runtime-only delivery queue overflow: pending ${pending} + attempted ${attempted} exceeds capacity ${capacity}`,\n\t\t);\n\t\tthis.name = \"RuntimeOnlyBackpressureOverflowError\";\n\t\tthis.capacity = capacity;\n\t\tthis.pending = pending;\n\t\tthis.attempted = attempted;\n\t}\n}\n\ninterface QueueEntry<T> {\n\treadonly value: T;\n\treadonly weight: number;\n\treadonly resolve: () => void;\n\treadonly reject: (error: unknown) => void;\n}\n\nfunction assertPositiveSafeInteger(value: number, name: string): void {\n\tif (!Number.isSafeInteger(value) \|\| value < 1) {\n\t\tthrow new Error(t(\"Runtime-only delivery queue {name} must be a positive safe integer\", { name }));\n\t}\n}\n\n/\n Creates a deterministic host-side subscription queue for runtime-only tests.\n \n Overflow rejects only the new enqueue, permanently terminates this queue,\n * and leaves already accepted values in order for delivery. Other queues are\n * independent and are not affected.\n \n Test-only divergence from the production lifecycle delivery queue: a handler\n * failure closes this whole queue and rejects every pending value with the\n * same error, while the production queue isolates the failure to that single\n * delivery and keeps accepting. Tests that need production semantics must use\n * the production runtime, not this fixture.\n */\nexport function createRuntimeOnlyDeliveryQueue<T>(\n\toptions: RuntimeOnlyDeliveryQueueOptions<T>,\n): RuntimeOnlyDeliveryQueue<T> {\n\tassertPositiveSafeInteger(options.capacity, \"capacity\");\n\tconst measure = options.measure ?? (() => 1);\n\tconst entries: QueueEntry<T>[] = [];\n\tlet status: RuntimeOnlyDeliveryQueueStatus = \"active\";\n\tlet pending = 0;\n\tlet accepted = 0;\n\tlet delivered = 0;\n\tlet rejected = 0;\n\tlet processing = false;\n\tlet drainPromise: Promise<void> \| undefined;\n\tlet resolveDrain: (() => void) \| undefined;\n\n\tconst ensureDrainPromise = (): Promise<void> => {\n\t\tif (drainPromise === undefined) {\n\t\t\tdrainPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveDrain = resolve;\n\t\t\t});\n\t\t}\n\t\treturn drainPromise;\n\t};\n\n\tconst settleDrainIfIdle = (): void => {\n\t\tif (processing \|\| entries.length > 0) return;\n\t\tresolveDrain?.();\n\t\tdrainPromise = undefined;\n\t\tresolveDrain = undefined;\n\t};\n\n\tconst pump = async (): Promise<void> => {\n\t\tif (processing) return;\n\t\tprocessing = true;\n\t\ttry {\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\ttry {\n\t\t\t\t\tawait options.deliver(entry.value);\n\t\t\t\t\tdelivered += 1;\n\t\t\t\t\tentry.resolve();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstatus = \"closed\";\n\t\t\t\t\trejected += 1;\n\t\t\t\t\tentry.reject(error);\n\t\t\t\t\twhile (entries.length > 0) {\n\t\t\t\t\t\tconst pendingEntry = entries.shift();\n\t\t\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\t\t\tif (pendingEntry === undefined) continue;\n\t\t\t\t\t\tpending -= pendingEntry.weight;\n\t\t\t\t\t\trejected += 1;\n\t\t\t\t\t\tpendingEntry.reject(error);\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tpending -= entry.weight;\n\t\t\t\t}\n\t\t\t\tif (status === \"closed\") break;\n\t\t\t}\n\t\t} finally {\n\t\t\tprocessing = false;\n\t\t\tsettleDrainIfIdle();\n\t\t}\n\t};\n\n\tconst enqueue = (value: T): Promise<void> => {\n\t\tif (status !== \"active\") {\n\t\t\trejected += 1;\n\t\t\tif (status === \"overflowed\") {\n\t\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, 0));\n\t\t\t}\n\t\t\treturn Promise.reject(new Error(`Runtime-only delivery queue is ${status}`));\n\t\t}\n\t\tconst weight = measure(value);\n\t\tassertPositiveSafeInteger(weight, \"measure result\");\n\t\tif (pending + weight > options.capacity) {\n\t\t\tstatus = \"overflowed\";\n\t\t\trejected += 1;\n\t\t\treturn Promise.reject(new RuntimeOnlyBackpressureOverflowError(options.capacity, pending, weight));\n\t\t}\n\t\taccepted += 1;\n\t\tpending += weight;\n\t\tconst result = new Promise<void>((resolve, reject) => {\n\t\t\tentries.push({ value, weight, resolve, reject });\n\t\t});\n\t\tensureDrainPromise();\n\t\tvoid pump();\n\t\treturn result;\n\t};\n\n\treturn {\n\t\tenqueue,\n\t\tdrain: () => {\n\t\t\tif (!processing && entries.length === 0) return Promise.resolve();\n\t\t\treturn ensureDrainPromise();\n\t\t},\n\t\tclose: () => {\n\t\t\tif (status === \"closed\") return;\n\t\t\tstatus = \"closed\";\n\t\t\twhile (entries.length > 0) {\n\t\t\t\tconst entry = entries.shift();\n\t\t\t\t// v8 ignore next -- 循环条件保证 shift 必有元素\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\tpending -= entry.weight;\n\t\t\t\trejected += 1;\n\t\t\t\tentry.reject(new Error(\"Runtime-only delivery queue was closed\"));\n\t\t\t}\n\t\t\tsettleDrainIfIdle();\n\t\t},\n\t\tsnapshot: () =>\n\t\t\tObject.freeze({\n\t\t\t\tstatus,\n\t\t\t\tcapacity: options.capacity,\n\t\t\t\tpending,\n\t\t\t\taccepted,\n\t\t\t\tdelivered,\n\t\t\t\trejected,\n\t\t\t}),\n\t};\n}\n"]}