@ai-agent-forge/agent-forge 0.85.0

package/dist/testing/plugin-testkit.js

@@ -0,0 +1,493 @@
+import { installBootstrapLifecycle } from "../core/extensions/bootstrap-lifecycle.js";
+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";
+function snapshot(value) {
+    const clone = structuredClone(value);
+    const freeze = (candidate) => {
+        if (!candidate || typeof candidate !== "object" || ArrayBuffer.isView(candidate))
+            return;
+        for (const child of Object.values(candidate))
+            freeze(child);
+        Object.freeze(candidate);
+    };
+    freeze(clone);
+    return clone;
+}
+function transcriptValue(value, seen = new WeakSet()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : String(value);
+    if (typeof value === "bigint")
+        return `${value}n`;
+    if (value === undefined)
+        return null;
+    if (value instanceof Error) {
+        if (seen.has(value))
+            return "[Circular]";
+        seen.add(value);
+        const output = { name: value.name, message: value.message };
+        const code = value.code;
+        if (code !== undefined)
+            output.code = transcriptValue(code, seen);
+        const cause = value.cause;
+        if (cause !== undefined)
+            output.cause = transcriptValue(cause, seen);
+        for (const key of Object.keys(value).sort()) {
+            if (key === "code" || key === "cause")
+                continue;
+            output[key] = transcriptValue(value[key], seen);
+        }
+        return output;
+    }
+    if (typeof value !== "object")
+        return String(value);
+    if (seen.has(value))
+        return "[Circular]";
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.map((item) => transcriptValue(item, seen));
+    const output = {};
+    for (const key of Object.keys(value).sort()) {
+        output[key] = transcriptValue(value[key], seen);
+    }
+    return output;
+}
+function canonicalJson(value) {
+    const serialized = JSON.stringify(transcriptValue(value));
+    // v8 ignore next -- transcriptValue 已消毒全部值，JSON.stringify 不会返回 undefined
+    if (serialized === undefined)
+        throw new Error("Plugin testkit transcript is not JSON-serializable");
+    return serialized;
+}
+function lifecycleFailureReport(error) {
+    if (!error || typeof error !== "object")
+        return undefined;
+    const report = error.report;
+    if (!report || typeof report !== "object")
+        return undefined;
+    const candidate = report;
+    // v8 ignore next -- report 由 runtime 构造、形状恒满足；此处仅防御伪造的 report
+    if (typeof candidate.eventId !== "string" ||
+        typeof candidate.type !== "string" ||
+        !Number.isSafeInteger(candidate.version) ||
+        (candidate.phase !== "raw" && candidate.phase !== "candidate" && candidate.phase !== "committed") ||
+        (candidate.status !== "transform-failed" &&
+            candidate.status !== "execute-failed" &&
+            candidate.status !== "delivered") ||
+        !Array.isArray(candidate.failures)) {
+        return undefined;
+    }
+    return {
+        eventId: candidate.eventId,
+        type: candidate.type,
+        version: candidate.version,
+        phase: candidate.phase,
+        status: candidate.status,
+        attempted: candidate.attempted,
+        succeeded: candidate.succeeded,
+        failed: candidate.failed,
+        failures: candidate.failures.map((failure) => ({
+            pluginId: failure.pluginId,
+            registrationId: failure.registrationId,
+            kind: failure.kind,
+            error: transcriptValue(failure.error),
+        })),
+    };
+}
+function defaultHost() {
+    return {
+        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
+        mode: "full-control",
+        features: ["logger-v1", "diagnostics-v1", "plugin-state-v1", "runtime-inspector-v1"],
+        transports: ["in-process"],
+    };
+}
+const DEFAULT_MANIFEST_ROOT = "<plugin-testkit>";
+/** Create a runtime-only fixture with deterministic topology and teardown. */
+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");
+    }
+    const inputPlugins = options.plugins.map((plugin) => ({
+        manifest: snapshot(plugin.manifest),
+        factory: plugin.factory,
+    }));
+    const suppliedHost = options.host;
+    const host = {
+        ...defaultHost(),
+        ...suppliedHost,
+        features: suppliedHost?.features ?? defaultHost().features,
+        transports: suppliedHost?.transports ?? defaultHost().transports,
+    };
+    const pluginsByManifest = new Map(inputPlugins.map((plugin) => [plugin.manifest, plugin]));
+    const handles = new Map();
+    const revokedState = new Map();
+    const retainedState = new Map();
+    const loadOrder = [];
+    const stateMutations = [];
+    const stateWatchDeliveries = [];
+    const capabilityCalls = [];
+    const lifecycleEvents = [];
+    const lifecycleFailures = [];
+    const pendingLifecycleDispatches = new Set();
+    let disposePromise;
+    const recordLifecycleDispatch = (request, settled) => {
+        const recorded = settled.then((result) => {
+            lifecycleEvents.push(snapshot({
+                eventId: result.event.id,
+                type: result.event.type,
+                version: result.event.version,
+                phase: result.event.phase,
+                deliveryId: result.event.deliveryId,
+                source: result.event.source,
+                ...(result.event.operationId === undefined ? {} : { operationId: result.event.operationId }),
+                ...(result.event.correlationId === undefined ? {} : { correlationId: result.event.correlationId }),
+                ...(result.event.causationId === undefined ? {} : { causationId: result.event.causationId }),
+                data: transcriptValue(result.event.data),
+            }));
+        }, (error) => {
+            const requestObject = request && typeof request === "object" ? request : undefined;
+            const report = lifecycleFailureReport(error);
+            const rawPhase = requestObject?.phase;
+            const phase = rawPhase === "raw" || rawPhase === "candidate" || rawPhase === "committed" ? rawPhase : null;
+            const rawSource = requestObject?.source;
+            const source = rawSource === undefined
+                ? requestObject === undefined
+                    ? null
+                    : "host"
+                : typeof rawSource === "string"
+                    ? rawSource
+                    : null;
+            const rawVersion = requestObject?.version;
+            const version = typeof rawVersion === "number" && Number.isSafeInteger(rawVersion) ? rawVersion : null;
+            const failure = {
+                eventId: report?.eventId ?? null,
+                type: typeof requestObject?.type === "string" ? requestObject.type : null,
+                version,
+                phase,
+                deliveryId: null,
+                source,
+                ...(typeof requestObject?.operationId === "string" ? { operationId: requestObject.operationId } : {}),
+                ...(typeof requestObject?.correlationId === "string"
+                    ? { correlationId: requestObject.correlationId }
+                    : {}),
+                ...(typeof requestObject?.causationId === "string" ? { causationId: requestObject.causationId } : {}),
+                ...(requestObject !== undefined && "data" in requestObject
+                    ? { data: transcriptValue(requestObject.data) }
+                    : {}),
+                status: report?.status === "transform-failed" || report?.status === "execute-failed"
+                    ? report.status
+                    : requestObject?.signal instanceof AbortSignal && requestObject.signal.aborted
+                        ? "cancelled"
+                        : "rejected",
+                error: transcriptValue(error),
+                ...(report === undefined ? {} : { report }),
+            };
+            lifecycleFailures.push(snapshot(failure));
+        });
+        pendingLifecycleDispatches.add(recorded);
+        void recorded.then(() => pendingLifecycleDispatches.delete(recorded));
+    };
+    const runtime = createCapabilityRuntime(host, {
+        clock: options.clock ?? (() => 0),
+        idFactory: options.idFactory ?? ((kind, sequence) => `testkit:${kind}:${sequence}`),
+        onLifecycleDispatch: recordLifecycleDispatch,
+    });
+    // Must run before the ready loop: plugin factories registerObserve during load.
+    if (options.lifecycle === true)
+        installBootstrapLifecycle(runtime);
+    const inputManifests = inputPlugins.map(({ manifest }) => ({
+        pluginId: manifest.id,
+        version: manifest.version,
+        entry: manifest.entry,
+    }));
+    const inputOrder = inputPlugins.map(({ manifest }) => manifest.id);
+    const wrappedToRawAPI = new WeakMap();
+    const wrapStateAPI = (pluginId, state) => {
+        const operationMetadata = (options) => ({
+            ...(options?.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),
+            ...(options?.operationId === undefined ? {} : { operationId: options.operationId }),
+            ...(options?.correlationId === undefined ? {} : { correlationId: options.correlationId }),
+        });
+        const recordMutation = (action, key, metadata, result) => {
+            stateMutations.push({
+                pluginId,
+                action,
+                key,
+                ...metadata,
+                ...result,
+            });
+        };
+        return Object.freeze({
+            get: (key) => state.get(key),
+            set: (key, value, options) => {
+                const metadata = operationMetadata(options);
+                try {
+                    const revision = state.set(key, value, options);
+                    recordMutation("set", key, metadata, {
+                        status: "committed",
+                        revision,
+                        value: transcriptValue(value),
+                    });
+                    return revision;
+                }
+                catch (error) {
+                    recordMutation("set", key, metadata, { status: "rejected", error: transcriptValue(error) });
+                    throw error;
+                }
+            },
+            delete: (key, options) => {
+                const metadata = operationMetadata(options);
+                try {
+                    const revision = state.delete(key, options);
+                    recordMutation("delete", key, metadata, { status: "committed", revision });
+                    return revision;
+                }
+                catch (error) {
+                    recordMutation("delete", key, metadata, { status: "rejected", error: transcriptValue(error) });
+                    throw error;
+                }
+            },
+            list: (prefix) => state.list(prefix),
+            watch: (prefix, handler) => {
+                let watcherId = "<pending>";
+                const registration = state.watch(prefix, (change) => {
+                    const delivery = {
+                        pluginId,
+                        watcherId,
+                        key: change.key,
+                        revision: change.revision,
+                        status: "delivered",
+                        ...(change.value === undefined ? {} : { value: transcriptValue(change.value) }),
+                        ...(change.operationId === undefined ? {} : { operationId: change.operationId }),
+                        ...(change.correlationId === undefined ? {} : { correlationId: change.correlationId }),
+                    };
+                    stateWatchDeliveries.push(delivery);
+                    try {
+                        handler(change);
+                    }
+                    catch (error) {
+                        delivery.status = "failed";
+                        delivery.error = transcriptValue(error);
+                        throw error;
+                    }
+                });
+                watcherId = registration.id;
+                return registration;
+            },
+        });
+    };
+    const wrapCapabilityDirectory = (callerPluginId, capabilities) => Object.freeze({
+        provide: (declaration, handler) => capabilities.provide(declaration, handler),
+        require: (id, requireOptions) => {
+            const handle = capabilities.require(id, requireOptions);
+            return Object.freeze({
+                declaration: handle.declaration,
+                owner: handle.owner,
+                call: (input, callOptions) => {
+                    let operation;
+                    try {
+                        operation = handle.call(input, callOptions);
+                    }
+                    catch (error) {
+                        capabilityCalls.push({
+                            operationId: null,
+                            callerPluginId,
+                            providerPluginId: handle.owner,
+                            capabilityId: handle.declaration.id,
+                            capabilityVersion: handle.declaration.version,
+                            capabilityKind: handle.declaration.kind,
+                            status: "failed",
+                            error: transcriptValue(error),
+                        });
+                        throw error;
+                    }
+                    const record = {
+                        operationId: operation.id,
+                        callerPluginId,
+                        providerPluginId: handle.owner,
+                        capabilityId: handle.declaration.id,
+                        capabilityVersion: handle.declaration.version,
+                        capabilityKind: handle.declaration.kind,
+                        status: operation.status(),
+                    };
+                    capabilityCalls.push(record);
+                    void operation.result.then(() => {
+                        record.status = operation.status();
+                    }, (error) => {
+                        record.status = operation.status();
+                        record.error = transcriptValue(error);
+                    });
+                    return operation;
+                },
+            });
+        },
+        list: (listOptions) => capabilities.list(listOptions),
+    });
+    const originalCreateAPI = runtime.createAPI.bind(runtime);
+    const originalRevokeAPI = runtime.revokeAPI.bind(runtime);
+    runtime.createAPI = (manifest) => {
+        const rawAPI = originalCreateAPI(manifest);
+        const wrappedAPI = Object.freeze({
+            ...rawAPI,
+            capabilities: wrapCapabilityDirectory(rawAPI.manifest.id, rawAPI.capabilities),
+            ...(rawAPI.state === undefined ? {} : { state: wrapStateAPI(rawAPI.manifest.id, rawAPI.state) }),
+        });
+        wrappedToRawAPI.set(wrappedAPI, rawAPI);
+        return wrappedAPI;
+    };
+    runtime.revokeAPI = (api) => {
+        // v8 ignore next -- 所有 API 均经包装后的 createAPI 创建，映射必命中
+        const rawAPI = wrappedToRawAPI.get(api) ?? api;
+        for (const [pluginId, handle] of handles) {
+            if (handle.api === api || handle.api === rawAPI)
+                captureState(pluginId, handle);
+        }
+        originalRevokeAPI(rawAPI);
+    };
+    const captureState = (pluginId, handle) => {
+        if (retainedState.has(pluginId) || revokedState.has(pluginId))
+            return;
+        retainedState.set(pluginId, snapshot(handle.api.state?.list() ?? []));
+    };
+    const stateTranscript = () => [...handles.entries()].map(([pluginId, handle]) => {
+        return {
+            pluginId,
+            entries: retainedState.get(pluginId) ?? snapshot(handle.api.state?.list() ?? []),
+        };
+    });
+    let closing = false;
+    const ready = (async () => {
+        try {
+            const ordered = resolvePluginCapabilityOrder(inputPlugins.map((plugin) => plugin.manifest));
+            for (const manifest of ordered) {
+                if (closing)
+                    throw new Error("Plugin testkit was disposed during startup");
+                const plugin = pluginsByManifest.get(manifest);
+                // v8 ignore next -- plugins 数组同时供给加载顺序与 factory 映射，必可解析
+                if (!plugin)
+                    throw new Error(`Plugin testkit cannot resolve factory: ${manifest.id}`);
+                const handle = await loadCapabilityPlugin(runtime, plugin.manifest, plugin.factory);
+                handles.set(manifest.id, handle);
+                loadOrder.push(manifest.id);
+            }
+        }
+        catch (startupError) {
+            const failures = [startupError];
+            for (const handle of [...handles.values()].reverse()) {
+                try {
+                    await handle.dispose();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            handles.clear();
+            try {
+                await runtime.disposeAll();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+            if (failures.length > 1)
+                throw new AggregateError(failures, "Plugin testkit startup rollback failed");
+            throw startupError;
+        }
+    })();
+    return {
+        runtime,
+        ready,
+        api(pluginId) {
+            const handle = handles.get(pluginId);
+            if (!handle)
+                throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);
+            return handle.api;
+        },
+        revoke(pluginId) {
+            const handle = handles.get(pluginId);
+            if (!handle)
+                throw new Error(`Plugin testkit has no loaded plugin: ${pluginId}`);
+            if (handle.api.state) {
+                const entries = snapshot(handle.api.state.list());
+                revokedState.set(pluginId, entries);
+                retainedState.set(pluginId, entries);
+            }
+            runtime.revokeAPI(handle.api);
+        },
+        inspect: () => runtime.inspect(),
+        flushLifecycle: async () => {
+            while (pendingLifecycleDispatches.size > 0) {
+                await Promise.all([...pendingLifecycleDispatches]);
+            }
+            await runtime.drainLifecycleDeliveries();
+        },
+        transcript: () => snapshot(transcriptValue({
+            version: 1,
+            manifestRoot,
+            manifests: inputManifests,
+            inputOrder,
+            loadOrder,
+            state: stateTranscript(),
+            stateMutations,
+            stateWatchDeliveries,
+            capabilityCalls,
+            lifecycleEvents,
+            lifecycleFailures,
+            lifecycleReports: runtime.inspect().lifecycleReports,
+            inspector: runtime.inspect(),
+        })),
+        dispose: async () => {
+            disposePromise ??= (async () => {
+                closing = true;
+                const failures = [];
+                try {
+                    await ready;
+                }
+                catch (error) {
+                    if (!(error instanceof Error && error.message === "Plugin testkit was disposed during startup")) {
+                        failures.push(error);
+                    }
+                }
+                for (const [pluginId, handle] of handles)
+                    captureState(pluginId, handle);
+                for (const handle of [...handles.values()].reverse()) {
+                    try {
+                        await handle.dispose();
+                    }
+                    catch (error) {
+                        failures.push(error);
+                    }
+                }
+                try {
+                    await runtime.disposeAll();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+                if (failures.length === 1)
+                    throw failures[0];
+                if (failures.length > 1)
+                    throw new AggregateError(failures, "Plugin testkit disposal failed");
+            })();
+            return disposePromise;
+        },
+    };
+}
+/** 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");
+    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}`);
+        }
+        baseline = transcript;
+    }
+    return baseline;
+}
+//# sourceMappingURL=plugin-testkit.js.map

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

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

package/dist/testing/runtime-delivery-queue.d.ts

@@ -0,0 +1,47 @@
+/** Stable error code required by the model.stream backpressure contract. */
+export declare const MODEL_STREAM_BACKPRESSURE_OVERFLOW_CODE: "model_stream_backpressure_overflow";
+export type RuntimeOnlyDeliveryQueueStatus = "active" | "overflowed" | "closed";
+export interface RuntimeOnlyDeliveryQueueSnapshot {
+    readonly status: RuntimeOnlyDeliveryQueueStatus;
+    readonly capacity: number;
+    /** Weight of in-flight and queued values that have not finished delivery. */
+    readonly pending: number;
+    readonly accepted: number;
+    readonly delivered: number;
+    readonly rejected: number;
+}
+export interface RuntimeOnlyDeliveryQueueOptions<T> {
+    /** Maximum pending weight for this subscription. */
+    readonly capacity: number;
+    /** Defaults to one event per value. */
+    readonly measure?: (value: T) => number;
+    readonly deliver: (value: T) => void | Promise<void>;
+}
+export interface RuntimeOnlyDeliveryQueue<T> {
+    enqueue(value: T): Promise<void>;
+    drain(): Promise<void>;
+    close(): void;
+    snapshot(): RuntimeOnlyDeliveryQueueSnapshot;
+}
+export declare class RuntimeOnlyBackpressureOverflowError extends Error {
+    readonly code: "model_stream_backpressure_overflow";
+    readonly capacity: number;
+    readonly pending: number;
+    readonly attempted: number;
+    constructor(capacity: number, pending: number, attempted: number);
+}
+/**
+ * Creates a deterministic host-side subscription queue for runtime-only tests.
+ *
+ * Overflow rejects only the new enqueue, permanently terminates this queue,
+ * and leaves already accepted values in order for delivery. Other queues are
+ * independent and are not affected.
+ *
+ * Test-only divergence from the production lifecycle delivery queue: a handler
+ * failure closes this whole queue and rejects every pending value with the
+ * same error, while the production queue isolates the failure to that single
+ * delivery and keeps accepting. Tests that need production semantics must use
+ * the production runtime, not this fixture.
+ */
+export declare function createRuntimeOnlyDeliveryQueue<T>(options: RuntimeOnlyDeliveryQueueOptions<T>): RuntimeOnlyDeliveryQueue<T>;
+//# sourceMappingURL=runtime-delivery-queue.d.ts.map