@ai-agent-forge/agent-forge 0.85.0

package/dist/testing/plugin-testkit.d.ts

@@ -0,0 +1,148 @@
+import { type CapabilityPluginFactory } from "../core/extensions/capability-plugin.ts";
+import { type CapabilityRuntime } from "../core/extensions/capability-runtime.ts";
+import { type CapabilityAPI, type HostCapabilities, type LifecycleEvent, type LifecyclePhase, type OperationStatus, type PluginCapabilityDeclaration, type PluginManifest, type RuntimeInspectorSnapshot, type StateEntry } from "../core/extensions/public-api.ts";
+/**
+ * A deterministic, runtime-only fixture for experimental capability plugins.
+ *
+ * It deliberately does not create an AgentSession or a model provider. Tests
+ * that need those integration points should use the existing session harness.
+ */
+export interface PluginTestKitPlugin {
+    readonly manifest: PluginManifest;
+    readonly factory: CapabilityPluginFactory;
+}
+export interface PluginTestKitOptions {
+    readonly plugins: readonly PluginTestKitPlugin[];
+    readonly host?: Omit<HostCapabilities, "apiVersion">;
+    readonly clock?: () => number;
+    /** Injects stable runtime identifiers for deterministic transcript tests. */
+    readonly idFactory?: (kind: string, sequence: number) => string;
+    /** Logical root used to identify inline manifests without a host filesystem path. */
+    readonly manifestRoot?: string;
+    /**
+     * Installs the bootstrap lifecycle catalog (host parity: the real session
+     * host installs it) before the plugin load loop, so plugin factories can
+     * registerObserve standard events. Off by default to keep existing
+     * transcripts unchanged; the installed handle is disposed by
+     * runtime.disposeAll() inside dispose().
+     */
+    readonly lifecycle?: boolean;
+}
+export interface PluginTestKitManifestIdentity {
+    readonly pluginId: string;
+    readonly version: string;
+    readonly entry: string;
+}
+export interface PluginTestKitLifecycleEnvelope {
+    readonly eventId: string;
+    readonly type: string;
+    readonly version: number;
+    readonly phase: LifecycleEvent["phase"];
+    readonly deliveryId: string;
+    readonly source: string;
+    readonly operationId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly data: unknown;
+}
+export interface PluginTestKitLifecycleFailureReport {
+    readonly eventId: string;
+    readonly type: string;
+    readonly version: number;
+    readonly phase: LifecyclePhase;
+    readonly status: "transform-failed" | "execute-failed" | "delivered" | "queued";
+    readonly attempted: number;
+    readonly succeeded: number;
+    readonly queued?: number;
+    readonly failed: number;
+    readonly failures: readonly {
+        readonly pluginId: string;
+        readonly registrationId: string;
+        readonly kind: string;
+        readonly error: unknown;
+    }[];
+}
+/** A dispatch rejection is retained even when no event envelope was created. */
+export interface PluginTestKitLifecycleFailure {
+    readonly eventId: string | null;
+    readonly type: string | null;
+    readonly version: number | null;
+    readonly phase: LifecyclePhase | null;
+    readonly deliveryId: string | null;
+    readonly source: string | null;
+    readonly operationId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly data?: unknown;
+    readonly status: "rejected" | "cancelled" | "transform-failed" | "execute-failed";
+    readonly error: unknown;
+    readonly report?: PluginTestKitLifecycleFailureReport;
+}
+export interface PluginTestKitStateMutation {
+    readonly pluginId: string;
+    readonly action: "set" | "delete";
+    readonly key: string;
+    readonly status: "committed" | "rejected";
+    readonly revision?: number;
+    readonly expectedRevision?: number;
+    readonly value?: unknown;
+    readonly operationId?: string;
+    readonly correlationId?: string;
+    readonly error?: unknown;
+}
+export interface PluginTestKitStateWatchDelivery {
+    readonly pluginId: string;
+    readonly watcherId: string;
+    readonly key: string;
+    readonly revision: number;
+    readonly status: "delivered" | "failed";
+    readonly value?: unknown;
+    readonly operationId?: string;
+    readonly correlationId?: string;
+    readonly error?: unknown;
+}
+export interface PluginTestKitCapabilityCall {
+    readonly operationId: string | null;
+    readonly callerPluginId: string;
+    readonly providerPluginId: string;
+    readonly capabilityId: string;
+    readonly capabilityVersion: number;
+    readonly capabilityKind: PluginCapabilityDeclaration["kind"];
+    readonly status: OperationStatus;
+    readonly error?: unknown;
+}
+export interface PluginTestKitTranscript {
+    readonly version: 1;
+    readonly manifestRoot: string;
+    readonly manifests: readonly PluginTestKitManifestIdentity[];
+    readonly inputOrder: readonly string[];
+    readonly loadOrder: readonly string[];
+    readonly state: readonly {
+        readonly pluginId: string;
+        readonly entries: readonly StateEntry[];
+    }[];
+    readonly stateMutations: readonly PluginTestKitStateMutation[];
+    readonly stateWatchDeliveries: readonly PluginTestKitStateWatchDelivery[];
+    readonly capabilityCalls: readonly PluginTestKitCapabilityCall[];
+    readonly lifecycleEvents: readonly PluginTestKitLifecycleEnvelope[];
+    readonly lifecycleFailures: readonly PluginTestKitLifecycleFailure[];
+    readonly lifecycleReports: RuntimeInspectorSnapshot["lifecycleReports"];
+    readonly inspector: RuntimeInspectorSnapshot;
+}
+export interface PluginTestKit {
+    readonly runtime: CapabilityRuntime;
+    /** Resolves after every manifest is topology-ordered and its factory has loaded. */
+    readonly ready: Promise<void>;
+    api(pluginId: string): CapabilityAPI;
+    revoke(pluginId: string): void;
+    inspect(): RuntimeInspectorSnapshot;
+    transcript(): PluginTestKitTranscript;
+    /** Waits for lifecycle facts initiated by runtime-owned detached operations. */
+    flushLifecycle(): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Create a runtime-only fixture with deterministic topology and teardown. */
+export declare function createPluginTestKit(options: PluginTestKitOptions): PluginTestKit;
+/** Runs a fixture repeatedly and rejects on the first transcript divergence. */
+export declare function repeatPluginTestKit(times: number, run: () => Promise<PluginTestKitTranscript>): Promise<PluginTestKitTranscript>;
+//# sourceMappingURL=plugin-testkit.d.ts.map

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

@@ -0,0 +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"]}