@ai-agent-forge/agent-forge 0.85.0

package/dist/core/extensions/capability-plugin.js

@@ -0,0 +1,485 @@
+import { lstatSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import * as pluginSdk from "@agent-forge/plugin-sdk";
+import { parseCapabilityPluginManifest, } from "@agent-forge/plugin-sdk";
+import * as pluginSdkSessionLineage from "@agent-forge/plugin-sdk/session-lineage";
+import * as protocolSubagent from "@agent-forge/protocol/subagent";
+import { createJiti } from "jiti/static";
+import * as typebox from "typebox";
+import * as typeboxValue from "typebox/value";
+import { PLUGIN_DISPOSE_EVENT_ID, PLUGIN_DISPOSE_EVENT_VERSION, PLUGIN_READY_EVENT_ID, PLUGIN_READY_EVENT_VERSION, } from "./lifecycle-catalog.js";
+export { parseCapabilityPluginManifest } from "@agent-forge/plugin-sdk";
+const activePlugins = new WeakMap();
+// Host-resolved heavy-dependency aliases (D-075 S4 fourth batch, installed-
+// code-loading): the memory plugin package carries its vector stack pinned in
+// its own package.json, but an npm-installed tarball ships no node_modules —
+// the same void the SDK/protocol virtual modules below fill. Unlike those,
+// lancedb/transformers are NATIVE/lazy packages the host must not bundle or
+// import here: they stay host dependencies, and each specifier is resolved
+// ONCE (module-level cache, successes only) to the host's own entry file
+// path and handed to jiti as an alias. The alias reliably intercepts only
+// STATIC imports on the entry chain of files jiti transforms — lazy
+// `await import()` calls inside an installed ESM dist bypass the transform
+// pipeline and hit the native resolver, so those lazy paths are supplied by
+// the hostDependencyPaths absolute-path channel instead (hostDependencyPaths-
+// Config below plus the plugin-side host-module-import). Resolution failures
+// are tolerated on both channels: the alias table is a best-effort supply
+// path, and heavy-dependency failures must surface at the plugin's point of
+// use, where the memory plugin reports structured failures with an action
+// list.
+const hostHeavyDependencyAliases = new Set([
+    "@lancedb/lancedb",
+    "@huggingface/transformers",
+    // memory 的 onnxruntime 预检（nativeBinaryCheck）在插件内直接 resolve 该传递
+    // 依赖；安装店副本无 node_modules，必须与 transformers 同走宿主 alias 通道。
+    "onnxruntime-node",
+]);
+const resolvedHeavyDependencyAliases = new Map();
+const defaultHostDependencyAliasResolution = {
+    resolve: (specifier) => createRequire(import.meta.url).resolve(specifier),
+    cache: resolvedHeavyDependencyAliases,
+};
+/**
+ * Tolerant heavy-dependency resolution shared by the jiti alias channel and
+ * the hostDependencyPaths config channel: each specifier is resolved against
+ * the host installation (successes cached module-level), and a specifier that
+ * fails to resolve is simply absent from the result. The alias table is a
+ * best-effort supply path — heavy-dependency failures must surface at the
+ * plugin's point of use, where the memory plugin reports structured failures
+ * with an action list. Exported for deterministic tests; production callers
+ * pass {@link defaultHostDependencyAliasResolution} explicitly.
+ */
+export function buildHostDependencyAliases(specifiers, resolution) {
+    const aliases = {};
+    for (const specifier of specifiers) {
+        const cached = resolution.cache.get(specifier);
+        if (cached !== undefined) {
+            aliases[specifier] = cached;
+            continue;
+        }
+        try {
+            const resolved = resolution.resolve(specifier);
+            resolution.cache.set(specifier, resolved);
+            aliases[specifier] = resolved;
+        }
+        catch {
+            // Tolerant by contract: absent entry = plugin-side fallback.
+        }
+    }
+    return aliases;
+}
+/**
+ * Host-resolved heavy-dependency entry paths (specifier → absolute path) for
+ * the config channel that feeds the lazy `await import()` paths the jiti
+ * alias channel cannot reach (installed ESM dists bypass the transform
+ * pipeline). Tolerant like the alias table: a specifier the host installation
+ * cannot resolve is simply absent, and plugin code falls back to its own
+ * resolution (or reports the structured failure). camelCase keys keep the
+ * JSON config channel idiomatic for plugin consumers.
+ */
+function hostDependencyPathsConfig() {
+    const paths = {};
+    for (const [specifier, entryPath] of Object.entries(buildHostDependencyAliases(hostHeavyDependencyAliases, defaultHostDependencyAliasResolution))) {
+        paths[camelCaseDependencyKey(specifier)] = entryPath;
+    }
+    return paths;
+}
+function camelCaseDependencyKey(specifier) {
+    const scoped = specifier.replace(/^@[^/]+\//, "");
+    return scoped.replace(/[-.](.)/g, (_, character) => character.toUpperCase());
+}
+function isPluginInstance(value) {
+    return typeof value === "object" && value !== null && typeof value.dispose === "function";
+}
+function normalizePluginInstance(value, manifest) {
+    if (value === undefined)
+        return undefined;
+    if (!isPluginInstance(value)) {
+        throw new Error(`Capability plugin factory must return void or an instance with dispose(): ${manifest.id}`);
+    }
+    return value;
+}
+function normalizePluginSyncInstance(value, manifest) {
+    if (value === undefined)
+        return undefined;
+    if (!isPluginInstance(value)) {
+        throw new Error(`Synchronous capability plugin factory must return void or an instance with dispose(): ${manifest.id}`);
+    }
+    return value;
+}
+function throwCleanupErrors(errors, manifestId) {
+    if (errors.length === 0)
+        return;
+    if (errors.length === 1)
+        throw errors[0];
+    throw new AggregateError(errors, `Capability plugin cleanup failed: ${manifestId}`);
+}
+async function dispatchPluginDisposeEvent(runtime, manifest, status) {
+    if (!runtime.hasLifecycleEvent(PLUGIN_DISPOSE_EVENT_ID, PLUGIN_DISPOSE_EVENT_VERSION))
+        return;
+    await runtime.dispatchLifecycle({
+        type: PLUGIN_DISPOSE_EVENT_ID,
+        version: PLUGIN_DISPOSE_EVENT_VERSION,
+        phase: "committed",
+        data: {
+            version: 1,
+            pluginId: manifest.id,
+            pluginVersion: manifest.version,
+            status,
+        },
+        source: "capability-plugin",
+    });
+}
+async function dispatchPluginReadyEvent(runtime, manifest) {
+    if (!runtime.hasLifecycleEvent(PLUGIN_READY_EVENT_ID, PLUGIN_READY_EVENT_VERSION))
+        return;
+    await runtime.dispatchLifecycle({
+        type: PLUGIN_READY_EVENT_ID,
+        version: PLUGIN_READY_EVENT_VERSION,
+        phase: "committed",
+        data: {
+            version: 1,
+            pluginId: manifest.id,
+            pluginVersion: manifest.version,
+        },
+        source: "capability-plugin",
+    });
+}
+function isMissingPathError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function compareNames(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/**
+ * Find installed capability manifests below the given plugin directories.
+ *
+ * Directories are visited in caller order; entries in each directory use a
+ * stable lexical order. Missing roots are normal for a first-run host.
+ * Existing unreadable or malformed filesystem paths fail explicitly rather
+ * than silently changing the loaded plugin set. Dependency and hidden
+ * directories are never traversed.
+ */
+export function discoverCapabilityPluginManifests(pluginDirectories) {
+    const manifests = [];
+    const seenDirectories = new Set();
+    const seenManifests = new Set();
+    const visit = (directory, optional) => {
+        const resolvedDirectory = path.resolve(directory);
+        let stats;
+        try {
+            stats = statSync(resolvedDirectory);
+        }
+        catch (error) {
+            if (optional && isMissingPathError(error)) {
+                try {
+                    if (!lstatSync(resolvedDirectory).isSymbolicLink())
+                        return;
+                }
+                catch (linkError) {
+                    if (isMissingPathError(linkError))
+                        return;
+                    throw new Error(`Failed to inspect capability plugin directory ${resolvedDirectory}: ${linkError instanceof Error ? linkError.message : String(linkError)}`);
+                }
+            }
+            throw new Error(`Failed to inspect capability plugin directory ${resolvedDirectory}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!stats.isDirectory()) {
+            throw new Error(`Capability plugin path must be a directory: ${resolvedDirectory}`);
+        }
+        let canonicalDirectory;
+        try {
+            canonicalDirectory = realpathSync(resolvedDirectory);
+        }
+        catch (error) {
+            throw new Error(`Failed to resolve capability plugin directory ${resolvedDirectory}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (seenDirectories.has(canonicalDirectory))
+            return;
+        seenDirectories.add(canonicalDirectory);
+        let entries;
+        try {
+            entries = readdirSync(resolvedDirectory, { withFileTypes: true, encoding: "utf8" });
+        }
+        catch (error) {
+            throw new Error(`Failed to read capability plugin directory ${resolvedDirectory}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        for (const entry of entries.sort((left, right) => compareNames(left.name, right.name))) {
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            const entryPath = path.join(resolvedDirectory, entry.name);
+            if (entry.isDirectory()) {
+                visit(entryPath, false);
+                continue;
+            }
+            if (!entry.isFile() || entry.name !== "plugin.json")
+                continue;
+            let canonicalManifest;
+            try {
+                canonicalManifest = realpathSync(entryPath);
+            }
+            catch (error) {
+                throw new Error(`Failed to resolve capability plugin manifest ${entryPath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            if (seenManifests.has(canonicalManifest))
+                continue;
+            seenManifests.add(canonicalManifest);
+            manifests.push(canonicalManifest);
+        }
+    };
+    for (const pluginDirectory of pluginDirectories)
+        visit(pluginDirectory, true);
+    return manifests;
+}
+/**
+ * Load a capability plugin through the public facade only.
+ * Filesystem discovery and package installation stay outside this mechanism.
+ */
+export async function loadCapabilityPlugin(runtime, manifest, factory) {
+    const active = activePlugins.get(runtime) ?? new Map();
+    if (active.has(manifest.id))
+        throw new Error(`Capability plugin is already loaded: ${manifest.id}`);
+    const ownerToken = Symbol(manifest.id);
+    active.set(manifest.id, ownerToken);
+    activePlugins.set(runtime, active);
+    let api;
+    let instance;
+    const cleanup = async (notifyDispose) => {
+        const errors = [];
+        if (api)
+            runtime.revokeAPI(api);
+        try {
+            await runtime.disposePlugin(manifest.id);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            await instance?.dispose();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (notifyDispose) {
+            try {
+                await dispatchPluginDisposeEvent(runtime, manifest, errors.length === 0 ? "disposed" : "failed");
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        throwCleanupErrors(errors, manifest.id);
+    };
+    try {
+        api = runtime.createAPI(manifest);
+        instance = normalizePluginInstance(await factory(api), manifest);
+        await dispatchPluginReadyEvent(runtime, manifest);
+        const pluginApi = api;
+        let disposePromise;
+        return {
+            manifest,
+            api: pluginApi,
+            ready: Promise.resolve(),
+            dispose: async () => {
+                disposePromise ??= (async () => {
+                    try {
+                        await cleanup(true);
+                    }
+                    finally {
+                        if (active.get(manifest.id) === ownerToken)
+                            active.delete(manifest.id);
+                    }
+                })();
+                return disposePromise;
+            },
+        };
+    }
+    catch (error) {
+        try {
+            await cleanup(false);
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], `Capability plugin startup cleanup failed: ${manifest.id}`);
+        }
+        finally {
+            if (active.get(manifest.id) === ownerToken)
+                active.delete(manifest.id);
+        }
+        throw error;
+    }
+}
+/** Load a synchronous embedded plugin during host construction. */
+export function loadCapabilityPluginSync(runtime, manifest, factory) {
+    const active = activePlugins.get(runtime) ?? new Map();
+    if (active.has(manifest.id))
+        throw new Error(`Capability plugin is already loaded: ${manifest.id}`);
+    const ownerToken = Symbol(manifest.id);
+    active.set(manifest.id, ownerToken);
+    activePlugins.set(runtime, active);
+    let api;
+    let instance;
+    const cleanupRegistrationsSync = () => {
+        const errors = [];
+        if (api)
+            runtime.revokeAPI(api);
+        try {
+            runtime.disposePluginSync(manifest.id);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        return errors;
+    };
+    const cleanupSync = async () => {
+        const errors = cleanupRegistrationsSync();
+        let result;
+        try {
+            result = instance?.dispose();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (result && typeof result.then === "function") {
+            const contractError = new Error(`Synchronous capability plugin disposer must not return a Promise: ${manifest.id}`);
+            try {
+                await result;
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            errors.push(contractError);
+        }
+        try {
+            await dispatchPluginDisposeEvent(runtime, manifest, errors.length === 0 ? "disposed" : "failed");
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        throwCleanupErrors(errors, manifest.id);
+    };
+    try {
+        api = runtime.createAPI(manifest);
+        instance = normalizePluginSyncInstance(factory(api), manifest);
+    }
+    catch (error) {
+        try {
+            throwCleanupErrors(cleanupRegistrationsSync(), manifest.id);
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], `Capability plugin startup cleanup failed: ${manifest.id}`);
+        }
+        finally {
+            if (active.get(manifest.id) === ownerToken)
+                active.delete(manifest.id);
+        }
+        throw error;
+    }
+    const ready = dispatchPluginReadyEvent(runtime, manifest);
+    // The embedded constructor API is synchronous; retain a handled promise so
+    // hosts may explicitly await lifecycle delivery without risking an unhandled rejection.
+    void ready.catch(() => undefined);
+    let disposePromise;
+    return {
+        manifest,
+        api: api,
+        ready,
+        dispose: async () => {
+            disposePromise ??= (async () => {
+                let readyError;
+                try {
+                    await ready;
+                }
+                catch (error) {
+                    readyError = error;
+                }
+                try {
+                    await cleanupSync();
+                    if (readyError !== undefined)
+                        throw readyError;
+                }
+                catch (error) {
+                    if (readyError !== undefined && error !== readyError) {
+                        throw new AggregateError([readyError, error], `Capability plugin cleanup failed: ${manifest.id}`);
+                    }
+                    throw error;
+                }
+                finally {
+                    if (active.get(manifest.id) === ownerToken)
+                        active.delete(manifest.id);
+                }
+            })();
+            return disposePromise;
+        },
+    };
+}
+/**
+ * Load a plugin from its JSON manifest. This is intentionally separate from
+ * legacy extension discovery until both systems share the same public facade.
+ *
+ * `options.configOverride` (D-075 S4 third batch) merges host-declared values
+ * over the manifest's own `config` defaults before the plugin API is built —
+ * a public channel (first-party and third-party plugins alike) for hosts that
+ * vouch for facts the manifest cannot know, e.g. the CLI declaring its own
+ * process entry trustworthy so the subagent-delegate package auto-pools. It
+ * stays below any plugin-side config channel: the agent-dir config file the
+ * plugin entry reads merges over whatever the host injected here.
+ */
+export async function loadCapabilityPluginFromManifest(runtime, manifestPath, options) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to read capability plugin manifest ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = parseCapabilityPluginManifest(raw, manifestPath);
+    // hostDependencyPaths (安装店重依赖可见性): 宿主已解析的重依赖入口绝对路径
+    // 并进 manifest config——安装店副本无 node_modules, 插件内 createRequire 自
+    // 解析不可达 (memory 的 onnxruntime native 预检实证); 与 jiti alias 通道互补
+    // (alias 拦截 import, 本通道喂插件内的路径式消费)。公共同道: 第一方与第三方
+    // 插件同样可读。仍低于插件侧 config 文件通道 (agent-dir 配置合并在其上)。
+    const hostDependencyOverride = { hostDependencyPaths: hostDependencyPathsConfig() };
+    const callerOverride = options?.configOverride;
+    const manifest = callerOverride === undefined || Object.keys(callerOverride).length === 0
+        ? { ...parsed, config: { ...parsed.config, ...hostDependencyOverride } }
+        : { ...parsed, config: { ...parsed.config, ...hostDependencyOverride, ...callerOverride } };
+    const entryPath = path.resolve(path.dirname(manifestPath), manifest.entry);
+    // Host-resolved authoring dependencies (D-075 §4.1): installed plugin
+    // packages live in the install store, which carries no node_modules (npm
+    // tarballs never include dependencies), so their bare imports of the SDK
+    // and the pinned typebox dependency resolve against the host's own copies
+    // through jiti virtual modules. Works identically in the bundle and Bun
+    // binaries where no source-tree node_modules exists at all. D-075 S4 third
+    // batch: the protocol package joins — the subagent-delegate package's
+    // runtime imports (`@agent-forge/protocol`) resolve the same way. S4 fourth
+    // batch: the memory package's native vector stack (`@lancedb/lancedb`,
+    // `@huggingface/transformers`) resolves through the jiti alias channel
+    // instead — those stay real host node_modules entries, so plugins load the
+    // host's native builds rather than a virtual copy.
+    const jiti = createJiti(import.meta.url, {
+        moduleCache: false,
+        tsconfigPaths: true,
+        alias: buildHostDependencyAliases(hostHeavyDependencyAliases, defaultHostDependencyAliasResolution),
+        virtualModules: {
+            "@agent-forge/plugin-sdk": pluginSdk,
+            "@agent-forge/plugin-sdk/session-lineage": pluginSdkSessionLineage,
+            "@agent-forge/protocol/subagent": protocolSubagent,
+            typebox,
+            "typebox/value": typeboxValue,
+        },
+    });
+    let factory;
+    try {
+        factory = await jiti.import(entryPath, { default: true });
+    }
+    catch (error) {
+        throw new Error(`Failed to import capability plugin entry ${entryPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof factory !== "function") {
+        throw new Error(`Capability plugin entry must default-export a factory function: ${entryPath}`);
+    }
+    return loadCapabilityPlugin(runtime, manifest, factory);
+}
+//# sourceMappingURL=capability-plugin.js.map

package/dist/core/extensions/capability-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-plugin.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Dirent } from \"node:fs\";\nimport { lstatSync, readdirSync, realpathSync, statSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport * as pluginSdk from \"@agent-forge/plugin-sdk\";\nimport {\n\ttype CapabilityPluginFactory,\n\ttype CapabilityPluginInstance,\n\ttype CapabilityPluginSyncFactory,\n\ttype CapabilityPluginSyncInstance,\n\tparseCapabilityPluginManifest,\n} from \"@agent-forge/plugin-sdk\";\nimport * as pluginSdkSessionLineage from \"@agent-forge/plugin-sdk/session-lineage\";\nimport * as protocolSubagent from \"@agent-forge/protocol/subagent\";\nimport { createJiti } from \"jiti/static\";\nimport * as typebox from \"typebox\";\nimport * as typeboxValue from \"typebox/value\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport {\n\tPLUGIN_DISPOSE_EVENT_ID,\n\tPLUGIN_DISPOSE_EVENT_VERSION,\n\tPLUGIN_READY_EVENT_ID,\n\tPLUGIN_READY_EVENT_VERSION,\n\ttype PluginDisposeEventDataV1,\n} from \"./lifecycle-catalog.ts\";\nimport type { CapabilityAPI, PluginConfig, PluginManifest } from \"./public-api.ts\";\n\n// Authoring-surface symbols moved to @agent-forge/plugin-sdk (D-075 S2);\n// re-exported here so existing host imports keep resolving.\nexport type {\n\tCapabilityPluginFactory,\n\tCapabilityPluginFactoryResult,\n\tCapabilityPluginInstance,\n\tCapabilityPluginSyncFactory,\n\tCapabilityPluginSyncInstance,\n} from \"@agent-forge/plugin-sdk\";\nexport { parseCapabilityPluginManifest } from \"@agent-forge/plugin-sdk\";\n\nexport interface CapabilityPluginHandle {\n\treadonly manifest: PluginManifest;\n\treadonly api: CapabilityAPI;\n\t/** Resolves once the plugin.ready lifecycle delivery has settled. */\n\treadonly ready: Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nconst activePlugins = new WeakMap<CapabilityRuntime, Map<string, symbol>>();\n\n// Host-resolved heavy-dependency aliases (D-075 S4 fourth batch, installed-\n// code-loading): the memory plugin package carries its vector stack pinned in\n// its own package.json, but an npm-installed tarball ships no node_modules —\n// the same void the SDK/protocol virtual modules below fill. Unlike those,\n// lancedb/transformers are NATIVE/lazy packages the host must not bundle or\n// import here: they stay host dependencies, and each specifier is resolved\n// ONCE (module-level cache, successes only) to the host's own entry file\n// path and handed to jiti as an alias. The alias reliably intercepts only\n// STATIC imports on the entry chain of files jiti transforms — lazy\n// `await import()` calls inside an installed ESM dist bypass the transform\n// pipeline and hit the native resolver, so those lazy paths are supplied by\n// the hostDependencyPaths absolute-path channel instead (hostDependencyPaths-\n// Config below plus the plugin-side host-module-import). Resolution failures\n// are tolerated on both channels: the alias table is a best-effort supply\n// path, and heavy-dependency failures must surface at the plugin's point of\n// use, where the memory plugin reports structured failures with an action\n// list.\nconst hostHeavyDependencyAliases: ReadonlySet<string> = new Set([\n\t\"@lancedb/lancedb\",\n\t\"@huggingface/transformers\",\n\t// memory 的 onnxruntime 预检（nativeBinaryCheck）在插件内直接 resolve 该传递\n\t// 依赖；安装店副本无 node_modules，必须与 transformers 同走宿主 alias 通道。\n\t\"onnxruntime-node\",\n]);\n\nconst resolvedHeavyDependencyAliases: Map<string, string> = new Map();\n\n/**\n * Explicit injection object for {@link buildHostDependencyAliases}. Both fields\n * are required on purpose: with optional positional parameters a test could\n * inject only `resolve` and silently write its fake results into the\n * module-level production cache (`resolvedHeavyDependencyAliases`), hijacking\n * every later real plugin load in the same vitest worker. Making the object\n * mandatory means a test cannot supply a resolver without also supplying the\n * cache it pollutes.\n */\nexport interface HostDependencyAliasResolution {\n\treadonly resolve: (specifier: string) => string;\n\treadonly cache: Map<string, string>;\n}\n\nconst defaultHostDependencyAliasResolution: HostDependencyAliasResolution = {\n\tresolve: (specifier) => createRequire(import.meta.url).resolve(specifier),\n\tcache: resolvedHeavyDependencyAliases,\n};\n\n/**\n * Tolerant heavy-dependency resolution shared by the jiti alias channel and\n * the hostDependencyPaths config channel: each specifier is resolved against\n * the host installation (successes cached module-level), and a specifier that\n * fails to resolve is simply absent from the result. The alias table is a\n * best-effort supply path — heavy-dependency failures must surface at the\n * plugin's point of use, where the memory plugin reports structured failures\n * with an action list. Exported for deterministic tests; production callers\n * pass {@link defaultHostDependencyAliasResolution} explicitly.\n */\nexport function buildHostDependencyAliases(\n\tspecifiers: ReadonlySet<string> | readonly string[],\n\tresolution: HostDependencyAliasResolution,\n): Record<string, string> {\n\tconst aliases: Record<string, string> = {};\n\tfor (const specifier of specifiers) {\n\t\tconst cached = resolution.cache.get(specifier);\n\t\tif (cached !== undefined) {\n\t\t\taliases[specifier] = cached;\n\t\t\tcontinue;\n\t\t}\n\t\ttry {\n\t\t\tconst resolved = resolution.resolve(specifier);\n\t\t\tresolution.cache.set(specifier, resolved);\n\t\t\taliases[specifier] = resolved;\n\t\t} catch {\n\t\t\t// Tolerant by contract: absent entry = plugin-side fallback.\n\t\t}\n\t}\n\treturn aliases;\n}\n\n/**\n * Host-resolved heavy-dependency entry paths (specifier → absolute path) for\n * the config channel that feeds the lazy `await import()` paths the jiti\n * alias channel cannot reach (installed ESM dists bypass the transform\n * pipeline). Tolerant like the alias table: a specifier the host installation\n * cannot resolve is simply absent, and plugin code falls back to its own\n * resolution (or reports the structured failure). camelCase keys keep the\n * JSON config channel idiomatic for plugin consumers.\n */\nfunction hostDependencyPathsConfig(): Record<string, string> {\n\tconst paths: Record<string, string> = {};\n\tfor (const [specifier, entryPath] of Object.entries(\n\t\tbuildHostDependencyAliases(hostHeavyDependencyAliases, defaultHostDependencyAliasResolution),\n\t)) {\n\t\tpaths[camelCaseDependencyKey(specifier)] = entryPath;\n\t}\n\treturn paths;\n}\n\nfunction camelCaseDependencyKey(specifier: string): string {\n\tconst scoped = specifier.replace(/^@[^/]+\\//, \"\");\n\treturn scoped.replace(/[-.](.)/g, (_, character: string) => character.toUpperCase());\n}\n\nfunction isPluginInstance(value: unknown): value is CapabilityPluginInstance {\n\treturn typeof value === \"object\" && value !== null && typeof (value as { dispose?: unknown }).dispose === \"function\";\n}\n\nfunction normalizePluginInstance(value: unknown, manifest: PluginManifest): CapabilityPluginInstance | undefined {\n\tif (value === undefined) return undefined;\n\tif (!isPluginInstance(value)) {\n\t\tthrow new Error(`Capability plugin factory must return void or an instance with dispose(): ${manifest.id}`);\n\t}\n\treturn value;\n}\n\nfunction normalizePluginSyncInstance(\n\tvalue: unknown,\n\tmanifest: PluginManifest,\n): CapabilityPluginSyncInstance | undefined {\n\tif (value === undefined) return undefined;\n\tif (!isPluginInstance(value)) {\n\t\tthrow new Error(\n\t\t\t`Synchronous capability plugin factory must return void or an instance with dispose(): ${manifest.id}`,\n\t\t);\n\t}\n\treturn value as CapabilityPluginSyncInstance;\n}\n\nfunction throwCleanupErrors(errors: unknown[], manifestId: string): void {\n\tif (errors.length === 0) return;\n\tif (errors.length === 1) throw errors[0];\n\tthrow new AggregateError(errors, `Capability plugin cleanup failed: ${manifestId}`);\n}\n\nasync function dispatchPluginDisposeEvent(\n\truntime: CapabilityRuntime,\n\tmanifest: PluginManifest,\n\tstatus: PluginDisposeEventDataV1[\"status\"],\n): Promise<void> {\n\tif (!runtime.hasLifecycleEvent(PLUGIN_DISPOSE_EVENT_ID, PLUGIN_DISPOSE_EVENT_VERSION)) return;\n\tawait runtime.dispatchLifecycle({\n\t\ttype: PLUGIN_DISPOSE_EVENT_ID,\n\t\tversion: PLUGIN_DISPOSE_EVENT_VERSION,\n\t\tphase: \"committed\",\n\t\tdata: {\n\t\t\tversion: 1,\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.version,\n\t\t\tstatus,\n\t\t},\n\t\tsource: \"capability-plugin\",\n\t});\n}\n\nasync function dispatchPluginReadyEvent(runtime: CapabilityRuntime, manifest: PluginManifest): Promise<void> {\n\tif (!runtime.hasLifecycleEvent(PLUGIN_READY_EVENT_ID, PLUGIN_READY_EVENT_VERSION)) return;\n\tawait runtime.dispatchLifecycle({\n\t\ttype: PLUGIN_READY_EVENT_ID,\n\t\tversion: PLUGIN_READY_EVENT_VERSION,\n\t\tphase: \"committed\",\n\t\tdata: {\n\t\t\tversion: 1,\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.version,\n\t\t},\n\t\tsource: \"capability-plugin\",\n\t});\n}\n\nfunction isMissingPathError(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nfunction compareNames(left: string, right: string): number {\n\treturn left < right ? -1 : left > right ? 1 : 0;\n}\n\n/**\n * Find installed capability manifests below the given plugin directories.\n *\n * Directories are visited in caller order; entries in each directory use a\n * stable lexical order. Missing roots are normal for a first-run host.\n * Existing unreadable or malformed filesystem paths fail explicitly rather\n * than silently changing the loaded plugin set. Dependency and hidden\n * directories are never traversed.\n */\nexport function discoverCapabilityPluginManifests(pluginDirectories: readonly string[]): string[] {\n\tconst manifests: string[] = [];\n\tconst seenDirectories = new Set<string>();\n\tconst seenManifests = new Set<string>();\n\n\tconst visit = (directory: string, optional: boolean): void => {\n\t\tconst resolvedDirectory = path.resolve(directory);\n\t\tlet stats: ReturnType<typeof statSync>;\n\t\ttry {\n\t\t\tstats = statSync(resolvedDirectory);\n\t\t} catch (error) {\n\t\t\tif (optional && isMissingPathError(error)) {\n\t\t\t\ttry {\n\t\t\t\t\tif (!lstatSync(resolvedDirectory).isSymbolicLink()) return;\n\t\t\t\t} catch (linkError) {\n\t\t\t\t\tif (isMissingPathError(linkError)) return;\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Failed to inspect capability plugin directory ${resolvedDirectory}: ${\n\t\t\t\t\t\t\tlinkError instanceof Error ? linkError.message : String(linkError)\n\t\t\t\t\t\t}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to inspect capability plugin directory ${resolvedDirectory}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t);\n\t\t}\n\t\tif (!stats.isDirectory()) {\n\t\t\tthrow new Error(`Capability plugin path must be a directory: ${resolvedDirectory}`);\n\t\t}\n\n\t\tlet canonicalDirectory: string;\n\t\ttry {\n\t\t\tcanonicalDirectory = realpathSync(resolvedDirectory);\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to resolve capability plugin directory ${resolvedDirectory}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t);\n\t\t}\n\t\tif (seenDirectories.has(canonicalDirectory)) return;\n\t\tseenDirectories.add(canonicalDirectory);\n\n\t\tlet entries: Dirent<string>[];\n\t\ttry {\n\t\t\tentries = readdirSync(resolvedDirectory, { withFileTypes: true, encoding: \"utf8\" });\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to read capability plugin directory ${resolvedDirectory}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t);\n\t\t}\n\n\t\tfor (const entry of entries.sort((left, right) => compareNames(left.name, right.name))) {\n\t\t\tif (entry.name === \"node_modules\" || entry.name.startsWith(\".\")) continue;\n\t\t\tconst entryPath = path.join(resolvedDirectory, entry.name);\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tvisit(entryPath, false);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!entry.isFile() || entry.name !== \"plugin.json\") continue;\n\n\t\t\tlet canonicalManifest: string;\n\t\t\ttry {\n\t\t\t\tcanonicalManifest = realpathSync(entryPath);\n\t\t\t} catch (error) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Failed to resolve capability plugin manifest ${entryPath}: ${\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t\t}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (seenManifests.has(canonicalManifest)) continue;\n\t\t\tseenManifests.add(canonicalManifest);\n\t\t\tmanifests.push(canonicalManifest);\n\t\t}\n\t};\n\n\tfor (const pluginDirectory of pluginDirectories) visit(pluginDirectory, true);\n\treturn manifests;\n}\n\n/**\n * Load a capability plugin through the public facade only.\n * Filesystem discovery and package installation stay outside this mechanism.\n */\nexport async function loadCapabilityPlugin(\n\truntime: CapabilityRuntime,\n\tmanifest: PluginManifest,\n\tfactory: CapabilityPluginFactory,\n): Promise<CapabilityPluginHandle> {\n\tconst active = activePlugins.get(runtime) ?? new Map<string, symbol>();\n\tif (active.has(manifest.id)) throw new Error(`Capability plugin is already loaded: ${manifest.id}`);\n\tconst ownerToken = Symbol(manifest.id);\n\tactive.set(manifest.id, ownerToken);\n\tactivePlugins.set(runtime, active);\n\tlet api: CapabilityAPI | undefined;\n\tlet instance: CapabilityPluginInstance | undefined;\n\tconst cleanup = async (notifyDispose: boolean): Promise<void> => {\n\t\tconst errors: unknown[] = [];\n\t\tif (api) runtime.revokeAPI(api);\n\t\ttry {\n\t\t\tawait runtime.disposePlugin(manifest.id);\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t\ttry {\n\t\t\tawait instance?.dispose();\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t\tif (notifyDispose) {\n\t\t\ttry {\n\t\t\t\tawait dispatchPluginDisposeEvent(runtime, manifest, errors.length === 0 ? \"disposed\" : \"failed\");\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(error);\n\t\t\t}\n\t\t}\n\t\tthrowCleanupErrors(errors, manifest.id);\n\t};\n\ttry {\n\t\tapi = runtime.createAPI(manifest);\n\t\tinstance = normalizePluginInstance(await factory(api), manifest);\n\t\tawait dispatchPluginReadyEvent(runtime, manifest);\n\t\tconst pluginApi = api;\n\t\tlet disposePromise: Promise<void> | undefined;\n\t\treturn {\n\t\t\tmanifest,\n\t\t\tapi: pluginApi,\n\t\t\tready: Promise.resolve(),\n\t\t\tdispose: async () => {\n\t\t\t\tdisposePromise ??= (async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait cleanup(true);\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tif (active.get(manifest.id) === ownerToken) active.delete(manifest.id);\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t\treturn disposePromise;\n\t\t\t},\n\t\t};\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait cleanup(false);\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError([error, cleanupError], `Capability plugin startup cleanup failed: ${manifest.id}`);\n\t\t} finally {\n\t\t\tif (active.get(manifest.id) === ownerToken) active.delete(manifest.id);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/** Load a synchronous embedded plugin during host construction. */\nexport function loadCapabilityPluginSync(\n\truntime: CapabilityRuntime,\n\tmanifest: PluginManifest,\n\tfactory: CapabilityPluginSyncFactory,\n): CapabilityPluginHandle {\n\tconst active = activePlugins.get(runtime) ?? new Map<string, symbol>();\n\tif (active.has(manifest.id)) throw new Error(`Capability plugin is already loaded: ${manifest.id}`);\n\tconst ownerToken = Symbol(manifest.id);\n\tactive.set(manifest.id, ownerToken);\n\tactivePlugins.set(runtime, active);\n\tlet api: CapabilityAPI | undefined;\n\tlet instance: CapabilityPluginSyncInstance | undefined;\n\tconst cleanupRegistrationsSync = (): unknown[] => {\n\t\tconst errors: unknown[] = [];\n\t\tif (api) runtime.revokeAPI(api);\n\t\ttry {\n\t\t\truntime.disposePluginSync(manifest.id);\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t\treturn errors;\n\t};\n\tconst cleanupSync = async (): Promise<void> => {\n\t\tconst errors = cleanupRegistrationsSync();\n\t\tlet result: unknown;\n\t\ttry {\n\t\t\tresult = instance?.dispose();\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t\tif (result && typeof (result as PromiseLike<void>).then === \"function\") {\n\t\t\tconst contractError = new Error(\n\t\t\t\t`Synchronous capability plugin disposer must not return a Promise: ${manifest.id}`,\n\t\t\t);\n\t\t\ttry {\n\t\t\t\tawait result;\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(error);\n\t\t\t}\n\t\t\terrors.push(contractError);\n\t\t}\n\t\ttry {\n\t\t\tawait dispatchPluginDisposeEvent(runtime, manifest, errors.length === 0 ? \"disposed\" : \"failed\");\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t\tthrowCleanupErrors(errors, manifest.id);\n\t};\n\ttry {\n\t\tapi = runtime.createAPI(manifest);\n\t\tinstance = normalizePluginSyncInstance(factory(api), manifest);\n\t} catch (error) {\n\t\ttry {\n\t\t\tthrowCleanupErrors(cleanupRegistrationsSync(), manifest.id);\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError([error, cleanupError], `Capability plugin startup cleanup failed: ${manifest.id}`);\n\t\t} finally {\n\t\t\tif (active.get(manifest.id) === ownerToken) active.delete(manifest.id);\n\t\t}\n\t\tthrow error;\n\t}\n\tconst ready = dispatchPluginReadyEvent(runtime, manifest);\n\t// The embedded constructor API is synchronous; retain a handled promise so\n\t// hosts may explicitly await lifecycle delivery without risking an unhandled rejection.\n\tvoid ready.catch(() => undefined);\n\tlet disposePromise: Promise<void> | undefined;\n\treturn {\n\t\tmanifest,\n\t\tapi: api!,\n\t\tready,\n\t\tdispose: async () => {\n\t\t\tdisposePromise ??= (async () => {\n\t\t\t\tlet readyError: 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\treadyError = error;\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait cleanupSync();\n\t\t\t\t\tif (readyError !== undefined) throw readyError;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (readyError !== undefined && error !== readyError) {\n\t\t\t\t\t\tthrow new AggregateError([readyError, error], `Capability plugin cleanup failed: ${manifest.id}`);\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t} finally {\n\t\t\t\t\tif (active.get(manifest.id) === ownerToken) active.delete(manifest.id);\n\t\t\t\t}\n\t\t\t})();\n\t\t\treturn disposePromise;\n\t\t},\n\t};\n}\n\n/**\n * Load a plugin from its JSON manifest. This is intentionally separate from\n * legacy extension discovery until both systems share the same public facade.\n *\n * `options.configOverride` (D-075 S4 third batch) merges host-declared values\n * over the manifest's own `config` defaults before the plugin API is built —\n * a public channel (first-party and third-party plugins alike) for hosts that\n * vouch for facts the manifest cannot know, e.g. the CLI declaring its own\n * process entry trustworthy so the subagent-delegate package auto-pools. It\n * stays below any plugin-side config channel: the agent-dir config file the\n * plugin entry reads merges over whatever the host injected here.\n */\nexport async function loadCapabilityPluginFromManifest(\n\truntime: CapabilityRuntime,\n\tmanifestPath: string,\n\toptions?: { readonly configOverride?: PluginConfig },\n): Promise<CapabilityPluginHandle> {\n\tlet raw: unknown;\n\ttry {\n\t\traw = JSON.parse(await readFile(manifestPath, \"utf8\"));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Failed to read capability plugin manifest ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\tconst parsed = parseCapabilityPluginManifest(raw, manifestPath);\n\t// hostDependencyPaths (安装店重依赖可见性): 宿主已解析的重依赖入口绝对路径\n\t// 并进 manifest config——安装店副本无 node_modules, 插件内 createRequire 自\n\t// 解析不可达 (memory 的 onnxruntime native 预检实证); 与 jiti alias 通道互补\n\t// (alias 拦截 import, 本通道喂插件内的路径式消费)。公共同道: 第一方与第三方\n\t// 插件同样可读。仍低于插件侧 config 文件通道 (agent-dir 配置合并在其上)。\n\tconst hostDependencyOverride = { hostDependencyPaths: hostDependencyPathsConfig() };\n\tconst callerOverride = options?.configOverride;\n\tconst manifest =\n\t\tcallerOverride === undefined || Object.keys(callerOverride).length === 0\n\t\t\t? { ...parsed, config: { ...parsed.config, ...hostDependencyOverride } }\n\t\t\t: { ...parsed, config: { ...parsed.config, ...hostDependencyOverride, ...callerOverride } };\n\tconst entryPath = path.resolve(path.dirname(manifestPath), manifest.entry);\n\t// Host-resolved authoring dependencies (D-075 §4.1): installed plugin\n\t// packages live in the install store, which carries no node_modules (npm\n\t// tarballs never include dependencies), so their bare imports of the SDK\n\t// and the pinned typebox dependency resolve against the host's own copies\n\t// through jiti virtual modules. Works identically in the bundle and Bun\n\t// binaries where no source-tree node_modules exists at all. D-075 S4 third\n\t// batch: the protocol package joins — the subagent-delegate package's\n\t// runtime imports (`@agent-forge/protocol`) resolve the same way. S4 fourth\n\t// batch: the memory package's native vector stack (`@lancedb/lancedb`,\n\t// `@huggingface/transformers`) resolves through the jiti alias channel\n\t// instead — those stay real host node_modules entries, so plugins load the\n\t// host's native builds rather than a virtual copy.\n\tconst jiti = createJiti(import.meta.url, {\n\t\tmoduleCache: false,\n\t\ttsconfigPaths: true,\n\t\talias: buildHostDependencyAliases(hostHeavyDependencyAliases, defaultHostDependencyAliasResolution),\n\t\tvirtualModules: {\n\t\t\t\"@agent-forge/plugin-sdk\": pluginSdk,\n\t\t\t\"@agent-forge/plugin-sdk/session-lineage\": pluginSdkSessionLineage,\n\t\t\t\"@agent-forge/protocol/subagent\": protocolSubagent,\n\t\t\ttypebox,\n\t\t\t\"typebox/value\": typeboxValue,\n\t\t},\n\t});\n\tlet factory: unknown;\n\ttry {\n\t\tfactory = await jiti.import(entryPath, { default: true });\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Failed to import capability plugin entry ${entryPath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\tif (typeof factory !== \"function\") {\n\t\tthrow new Error(`Capability plugin entry must default-export a factory function: ${entryPath}`);\n\t}\n\treturn loadCapabilityPlugin(runtime, manifest, factory as CapabilityPluginFactory);\n}\n"]}

package/dist/core/extensions/capability-runtime-events.d.ts

@@ -0,0 +1,22 @@
+import type { CapabilityRuntimeOptions, CapabilityRuntimeState, OperationTerminalStatus, RegisteredPluginCapability } from "./capability-runtime-types.ts";
+import { type LifecycleDispatchRequest, type LifecycleDispatchResult, type OperationProgress } from "./public-api.ts";
+export interface LifecycleRuntime {
+    dispatchLifecycle: <TData>(request: LifecycleDispatchRequest<TData>) => Promise<LifecycleDispatchResult<TData>>;
+    reportOperationEnd: (operationId: string, operationKind: string, status: OperationTerminalStatus, ownerTokens: readonly symbol[]) => void;
+    reportOperationStart: (operationId: string, operationKind: string, ownerTokens: readonly symbol[]) => void;
+    reportOperationStep: (operationId: string, operationKind: string, ownerTokens: readonly symbol[], progress: OperationProgress, step: number) => boolean;
+    reportOperationCancel: (operationId: string, operationKind: string, ownerTokens: readonly symbol[]) => void;
+    reportCapabilityCall: (event: "start" | "cancel" | "end", operationId: string, callerPluginId: string, capability: RegisteredPluginCapability, ownerTokens: readonly symbol[], status?: OperationTerminalStatus) => void;
+}
+/**
+ * Create the lifecycle dispatch and operation-fact machinery for one runtime.
+ * All mutable state is shared through {@link CapabilityRuntimeState}; the
+ * returned functions close over the same state object as the runtime entry.
+ */
+export declare function createLifecycleRuntime(deps: {
+    state: CapabilityRuntimeState;
+    clock: () => number;
+    createRuntimeId: (kind: string, sequence: number, fallback: string) => string;
+    onLifecycleDispatch?: CapabilityRuntimeOptions["onLifecycleDispatch"];
+}): LifecycleRuntime;
+//# sourceMappingURL=capability-runtime-events.d.ts.map

package/dist/core/extensions/capability-runtime-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-events.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-events.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAE1B,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EAGN,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAO5B,KAAK,iBAAiB,EACtB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,gBAAgB;IAChC,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,wBAAwB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChH,kBAAkB,EAAE,CACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,KAC1B,IAAI,CAAC;IACV,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3G,mBAAmB,EAAE,CACpB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;IACb,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5G,oBAAoB,EAAE,CACrB,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,EACjC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,0BAA0B,EACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,MAAM,CAAC,EAAE,uBAAuB,KAC5B,IAAI,CAAC;CACV;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9E,mBAAmB,CAAC,EAAE,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;CACtE,GAAG,gBAAgB,CA4anB","sourcesContent":["import { isPluginConfigValue } from \"./capability-runtime-manifest.ts\";\nimport { cancellationError } from \"./capability-runtime-operation.ts\";\nimport { detachedSnapshot, lifecycleErrorSnapshot } from \"./capability-runtime-snapshot.ts\";\nimport {\n\tcreateRevokedCapabilityError,\n\tinvokeRegisteredCapabilityWithSignal,\n\tisRevokedCapabilityError,\n} from \"./capability-runtime-store.ts\";\nimport type {\n\tCapabilityRuntimeOptions,\n\tCapabilityRuntimeState,\n\tOperationTerminalStatus,\n\tRegisteredPluginCapability,\n\tStoredLifecycleDefinition,\n} from \"./capability-runtime-types.ts\";\nimport { lifecycleEventKey, lifecyclePhases } from \"./capability-runtime-validation.ts\";\nimport {\n\tCAPABILITY_CALL_EVENT_ID,\n\tCAPABILITY_CALL_EVENT_VERSION,\n\tOPERATION_CANCEL_EVENT_ID,\n\tOPERATION_END_EVENT_ID,\n\tOPERATION_START_EVENT_ID,\n\tOPERATION_STEP_EVENT_ID,\n} from \"./lifecycle-catalog.ts\";\nimport { LifecycleDeliveryQueueOverflowError } from \"./lifecycle-delivery-queue.ts\";\nimport {\n\ttype LifecycleDeliveryFailure,\n\ttype LifecycleDeliveryReport,\n\ttype LifecycleDispatchRequest,\n\ttype LifecycleDispatchResult,\n\ttype LifecycleEvent,\n\tLifecycleExecuteError,\n\ttype LifecycleExecuteHandler,\n\ttype LifecycleObserveHandler,\n\tLifecycleTransformError,\n\ttype LifecycleTransformHandler,\n\ttype OperationProgress,\n} from \"./public-api.ts\";\n\nconst MAX_RUNTIME_INSPECTOR_LIFECYCLE_REPORTS = 64;\n\nexport interface LifecycleRuntime {\n\tdispatchLifecycle: <TData>(request: LifecycleDispatchRequest<TData>) => Promise<LifecycleDispatchResult<TData>>;\n\treportOperationEnd: (\n\t\toperationId: string,\n\t\toperationKind: string,\n\t\tstatus: OperationTerminalStatus,\n\t\townerTokens: readonly symbol[],\n\t) => void;\n\treportOperationStart: (operationId: string, operationKind: string, ownerTokens: readonly symbol[]) => void;\n\treportOperationStep: (\n\t\toperationId: string,\n\t\toperationKind: string,\n\t\townerTokens: readonly symbol[],\n\t\tprogress: OperationProgress,\n\t\tstep: number,\n\t) => boolean;\n\treportOperationCancel: (operationId: string, operationKind: string, ownerTokens: readonly symbol[]) => void;\n\treportCapabilityCall: (\n\t\tevent: \"start\" | \"cancel\" | \"end\",\n\t\toperationId: string,\n\t\tcallerPluginId: string,\n\t\tcapability: RegisteredPluginCapability,\n\t\townerTokens: readonly symbol[],\n\t\tstatus?: OperationTerminalStatus,\n\t) => void;\n}\n\n/**\n * Create the lifecycle dispatch and operation-fact machinery for one runtime.\n * All mutable state is shared through {@link CapabilityRuntimeState}; the\n * returned functions close over the same state object as the runtime entry.\n */\nexport function createLifecycleRuntime(deps: {\n\tstate: CapabilityRuntimeState;\n\tclock: () => number;\n\tcreateRuntimeId: (kind: string, sequence: number, fallback: string) => string;\n\tonLifecycleDispatch?: CapabilityRuntimeOptions[\"onLifecycleDispatch\"];\n}): LifecycleRuntime {\n\tconst { state, clock, createRuntimeId, onLifecycleDispatch } = deps;\n\tconst lifecycleReport = (\n\t\tevent: LifecycleEvent,\n\t\tstatus: LifecycleDeliveryReport[\"status\"],\n\t\tattempted: number,\n\t\tsucceeded: number,\n\t\tfailures: readonly LifecycleDeliveryFailure[],\n\t\tqueued = 0,\n\t): LifecycleDeliveryReport =>\n\t\tObject.freeze({\n\t\t\teventId: event.id,\n\t\t\ttype: event.type,\n\t\t\tversion: event.version,\n\t\t\tphase: event.phase,\n\t\t\tstatus,\n\t\t\tattempted,\n\t\t\tsucceeded,\n\t\t\t...(queued === 0 ? {} : { queued }),\n\t\t\tfailed: failures.length,\n\t\t\tfailures: Object.freeze([...failures]),\n\t\t});\n\tconst recordLifecycleReport = (report: LifecycleDeliveryReport): void => {\n\t\tconst snapshot = detachedSnapshot({\n\t\t\teventId: report.eventId,\n\t\t\ttype: report.type,\n\t\t\tversion: report.version,\n\t\t\tphase: report.phase,\n\t\t\tstatus: report.status,\n\t\t\tattempted: report.attempted,\n\t\t\tsucceeded: report.succeeded,\n\t\t\t...(report.queued === undefined ? {} : { queued: report.queued }),\n\t\t\tfailed: report.failed,\n\t\t\tcompletedAt: clock(),\n\t\t\tfailures: report.failures.map((failure) => ({\n\t\t\t\tpluginId: failure.pluginId,\n\t\t\t\tregistrationId: failure.registrationId,\n\t\t\t\tkind: failure.kind,\n\t\t\t\terror: lifecycleErrorSnapshot(failure.error),\n\t\t\t})),\n\t\t});\n\t\tstate.lifecycleReports.push(snapshot);\n\t\tif (state.lifecycleReports.length > MAX_RUNTIME_INSPECTOR_LIFECYCLE_REPORTS) state.lifecycleReports.shift();\n\t};\n\tconst assertLifecycleDefinitionActive = (stored: StoredLifecycleDefinition): void => {\n\t\tif (!state.activeOwnerTokens.has(stored.ownerToken)) {\n\t\t\tthrow createRevokedCapabilityError(stored.owner);\n\t\t}\n\t};\n\n\tconst dispatchLifecycleImpl = async <TData>(\n\t\trequest: LifecycleDispatchRequest<TData>,\n\t): Promise<LifecycleDispatchResult<TData>> => {\n\t\tif (!request || typeof request !== \"object\") throw new Error(\"Lifecycle dispatch request is required\");\n\t\tif (request.signal?.aborted) throw cancellationError(request.signal.reason);\n\t\tif (typeof request.type !== \"string\" || !request.type.trim()) {\n\t\t\tthrow new Error(\"Lifecycle dispatch requires a non-empty type\");\n\t\t}\n\t\tif (!Number.isSafeInteger(request.version) || request.version < 1) {\n\t\t\tthrow new Error(\"Lifecycle dispatch version must be a positive safe integer\");\n\t\t}\n\t\tif (!lifecyclePhases.has(request.phase)) throw new Error(`Lifecycle dispatch phase is invalid: ${request.phase}`);\n\t\tconst stored = state.lifecycleDefinitions.get(lifecycleEventKey(request.type, request.version));\n\t\tif (!stored || !state.activeOwnerTokens.has(stored.ownerToken)) {\n\t\t\tthrow new Error(`Lifecycle event is not defined: ${request.type}@${request.version}`);\n\t\t}\n\t\tif (!(stored.definition.allowedPhases ?? [stored.definition.phase]).includes(request.phase)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Lifecycle dispatch phase does not match event definition: ${request.type}@${request.version}`,\n\t\t\t);\n\t\t}\n\t\tassertLifecycleDefinitionActive(stored);\n\t\tconst sequence = ++state.eventSequence;\n\t\tconst deliveryId = createRuntimeId(\"lifecycle-delivery\", sequence, `lifecycle-delivery:${sequence}`);\n\t\tconst operationId = request.operationId;\n\t\tconst correlationId = request.correlationId ?? operationId;\n\t\tif (operationId !== undefined && (typeof operationId !== \"string\" || !operationId.trim()))\n\t\t\tthrow new Error(\"Lifecycle operationId must be non-empty\");\n\t\tif (correlationId !== undefined && (typeof correlationId !== \"string\" || !correlationId.trim())) {\n\t\t\tthrow new Error(\"Lifecycle correlationId must be non-empty\");\n\t\t}\n\t\tif (\n\t\t\trequest.causationId !== undefined &&\n\t\t\t(typeof request.causationId !== \"string\" || !request.causationId.trim())\n\t\t) {\n\t\t\tthrow new Error(\"Lifecycle causationId must be non-empty\");\n\t\t}\n\t\tconst source = request.source ?? \"host\";\n\t\tif (typeof source !== \"string\" || !source.trim()) throw new Error(\"Lifecycle source must be non-empty\");\n\n\t\tconst validated = stored.definition.validate(detachedSnapshot(request.data));\n\t\tassertLifecycleDefinitionActive(stored);\n\t\tlet data = detachedSnapshot(validated) as TData;\n\t\tconst makeEvent = (): LifecycleEvent<TData> =>\n\t\t\tdetachedSnapshot({\n\t\t\t\tid: createRuntimeId(\"lifecycle-event\", sequence, `lifecycle-event:${sequence}`),\n\t\t\t\tdeliveryId,\n\t\t\t\ttype: request.type,\n\t\t\t\tversion: request.version,\n\t\t\t\tphase: request.phase,\n\t\t\t\tsource,\n\t\t\t\ttimestamp: clock(),\n\t\t\t\t...(operationId === undefined ? {} : { operationId }),\n\t\t\t\t...(correlationId === undefined ? {} : { correlationId }),\n\t\t\t\t...(request.causationId === undefined ? {} : { causationId: request.causationId }),\n\t\t\t\tdata,\n\t\t\t});\n\t\tlet event = makeEvent();\n\t\tconst registrations = Array.from(\n\t\t\tstate.lifecycleRegistrations.get(lifecycleEventKey(request.type, request.version))?.values() ?? [],\n\t\t).sort((left, right) => left.sequence - right.sequence);\n\t\tconst transforms = registrations.filter((registration) => registration.kind === \"transform\");\n\t\tfor (let index = 0; index < transforms.length; index++) {\n\t\t\tconst registration = transforms[index];\n\t\t\ttry {\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t\tconst registered = {\n\t\t\t\t\towner: registration.owner,\n\t\t\t\t\townerToken: registration.ownerToken,\n\t\t\t\t\tvalue: registration.handler,\n\t\t\t\t};\n\t\t\t\tconst result = await invokeRegisteredCapabilityWithSignal(state, registered, request.signal, (handler) =>\n\t\t\t\t\t(handler as LifecycleTransformHandler<TData>)(detachedSnapshot(event), request.signal),\n\t\t\t\t);\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t\tdata = detachedSnapshot(stored.definition.validate(detachedSnapshot(result))) as TData;\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t\tevent = makeEvent();\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t} catch (error) {\n\t\t\t\tconst failure: LifecycleDeliveryFailure = {\n\t\t\t\t\tpluginId: registration.owner,\n\t\t\t\t\tregistrationId: registration.id,\n\t\t\t\t\tkind: registration.kind,\n\t\t\t\t\terror,\n\t\t\t\t};\n\t\t\t\tconst report = lifecycleReport(event, \"transform-failed\", index + 1, index, [failure]);\n\t\t\t\trecordLifecycleReport(report);\n\t\t\t\tthrow new LifecycleTransformError(error, report);\n\t\t\t}\n\t\t}\n\t\tconst executes = registrations.filter(\n\t\t\t(registration) => request.phase === \"committed\" && registration.kind === \"execute\",\n\t\t);\n\t\tconst executeResults: unknown[] = [];\n\t\tfor (let index = 0; index < executes.length; index++) {\n\t\t\tconst registration = executes[index];\n\t\t\ttry {\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t\tconst registered = {\n\t\t\t\t\towner: registration.owner,\n\t\t\t\t\townerToken: registration.ownerToken,\n\t\t\t\t\tvalue: registration.handler,\n\t\t\t\t};\n\t\t\t\tconst result = await invokeRegisteredCapabilityWithSignal(state, registered, request.signal, (handler) =>\n\t\t\t\t\t(handler as LifecycleExecuteHandler<TData>)(detachedSnapshot(event), request.signal),\n\t\t\t\t);\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t\texecuteResults.push(detachedSnapshot(result));\n\t\t\t\tassertLifecycleDefinitionActive(stored);\n\t\t\t} catch (error) {\n\t\t\t\tconst failure: LifecycleDeliveryFailure = {\n\t\t\t\t\tpluginId: registration.owner,\n\t\t\t\t\tregistrationId: registration.id,\n\t\t\t\t\tkind: registration.kind,\n\t\t\t\t\terror,\n\t\t\t\t};\n\t\t\t\tconst report = lifecycleReport(event, \"execute-failed\", index + 1, index, [failure]);\n\t\t\t\trecordLifecycleReport(report);\n\t\t\t\tthrow new LifecycleExecuteError(error, report);\n\t\t\t}\n\t\t}\n\n\t\tconst deliveries = registrations.filter(\n\t\t\t(registration) =>\n\t\t\t\tregistration.kind === \"observe\" || (request.phase === \"committed\" && registration.kind === \"after-commit\"),\n\t\t);\n\t\tassertLifecycleDefinitionActive(stored);\n\t\tconst results = await Promise.allSettled(\n\t\t\tdeliveries\n\t\t\t\t.filter((registration) => registration.queue === undefined)\n\t\t\t\t.map((registration) => {\n\t\t\t\t\tconst registered = {\n\t\t\t\t\t\towner: registration.owner,\n\t\t\t\t\t\townerToken: registration.ownerToken,\n\t\t\t\t\t\tvalue: registration.handler,\n\t\t\t\t\t};\n\t\t\t\t\treturn invokeRegisteredCapabilityWithSignal(state, registered, request.signal, (handler) =>\n\t\t\t\t\t\t(handler as LifecycleObserveHandler<TData>)(detachedSnapshot(event), request.signal),\n\t\t\t\t\t);\n\t\t\t\t}),\n\t\t);\n\t\tif (request.signal?.aborted) throw cancellationError(request.signal.reason);\n\t\tconst failures: LifecycleDeliveryFailure[] = [];\n\t\tlet succeeded = 0;\n\t\tconst inlineDeliveries = deliveries.filter((registration) => registration.queue === undefined);\n\t\tfor (let index = 0; index < results.length; index++) {\n\t\t\tconst result = results[index];\n\t\t\tif (result.status === \"fulfilled\") {\n\t\t\t\tsucceeded++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (isRevokedCapabilityError(result.reason)) continue;\n\t\t\tconst registration = inlineDeliveries[index];\n\t\t\tfailures.push({\n\t\t\t\tpluginId: registration.owner,\n\t\t\t\tregistrationId: registration.id,\n\t\t\t\tkind: registration.kind,\n\t\t\t\terror: result.reason,\n\t\t\t});\n\t\t}\n\t\tlet queued = 0;\n\t\tfor (const registration of deliveries) {\n\t\t\tconst queue = registration.queue;\n\t\t\tif (!queue) continue;\n\t\t\ttry {\n\t\t\t\tconst acceptedBefore = queue.snapshot().accepted;\n\t\t\t\tconst delivery = queue.enqueue({ event: detachedSnapshot(event), signal: request.signal });\n\t\t\t\tconst queueSnapshot = queue.snapshot();\n\t\t\t\tif (queueSnapshot.accepted > acceptedBefore) queued += 1;\n\t\t\t\tif (queueSnapshot.status === \"overflowed\") {\n\t\t\t\t\tfailures.push({\n\t\t\t\t\t\tpluginId: registration.owner,\n\t\t\t\t\t\tregistrationId: registration.id,\n\t\t\t\t\t\tkind: registration.kind,\n\t\t\t\t\t\terror: new LifecycleDeliveryQueueOverflowError(\n\t\t\t\t\t\t\tevent.type === \"model.stream\"\n\t\t\t\t\t\t\t\t? \"model_stream_backpressure_overflow\"\n\t\t\t\t\t\t\t\t: \"lifecycle_delivery_backpressure_overflow\",\n\t\t\t\t\t\t\tqueueSnapshot.maxPendingEvents,\n\t\t\t\t\t\t\tqueueSnapshot.maxPendingBytes,\n\t\t\t\t\t\t\tqueueSnapshot.pendingEvents,\n\t\t\t\t\t\t\tqueueSnapshot.pendingBytes,\n\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tvoid delivery.then(\n\t\t\t\t\t() => recordLifecycleReport(lifecycleReport(event, \"delivered\", 1, 1, [])),\n\t\t\t\t\t(error) => {\n\t\t\t\t\t\tif (isRevokedCapabilityError(error)) return;\n\t\t\t\t\t\tif (error instanceof LifecycleDeliveryQueueOverflowError) return;\n\t\t\t\t\t\tconst failure: LifecycleDeliveryFailure = {\n\t\t\t\t\t\t\tpluginId: registration.owner,\n\t\t\t\t\t\t\tregistrationId: registration.id,\n\t\t\t\t\t\t\tkind: registration.kind,\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t};\n\t\t\t\t\t\trecordLifecycleReport(lifecycleReport(event, \"delivered\", 1, 0, [failure]));\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tfailures.push({\n\t\t\t\t\tpluginId: registration.owner,\n\t\t\t\t\tregistrationId: registration.id,\n\t\t\t\t\tkind: registration.kind,\n\t\t\t\t\terror,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\tassertLifecycleDefinitionActive(stored);\n\t\tconst report = lifecycleReport(\n\t\t\tevent,\n\t\t\tqueued > 0 ? \"queued\" : \"delivered\",\n\t\t\tdeliveries.length,\n\t\t\tsucceeded,\n\t\t\tfailures,\n\t\t\tqueued,\n\t\t);\n\t\trecordLifecycleReport(report);\n\t\tassertLifecycleDefinitionActive(stored);\n\t\treturn Object.freeze({ event, data: event.data, executeResults: Object.freeze(executeResults), report });\n\t};\n\tconst dispatchLifecycle = <TData>(\n\t\trequest: LifecycleDispatchRequest<TData>,\n\t): Promise<LifecycleDispatchResult<TData>> => {\n\t\tconst settled = dispatchLifecycleImpl(request);\n\t\ttry {\n\t\t\tonLifecycleDispatch?.(\n\t\t\t\trequest as LifecycleDispatchRequest<unknown>,\n\t\t\t\tsettled as Promise<LifecycleDispatchResult<unknown>>,\n\t\t\t);\n\t\t} catch {\n\t\t\t// Test observers must never alter lifecycle delivery or operation results.\n\t\t}\n\t\treturn settled;\n\t};\n\tconst reportOperationFact = (\n\t\teventId: string,\n\t\toperationId: string,\n\t\toperationKind: string,\n\t\tstatus: OperationTerminalStatus,\n\t\townerTokens: readonly symbol[],\n\t): void => {\n\t\tif (ownerTokens.some((ownerToken) => !state.activeOwnerTokens.has(ownerToken))) return;\n\t\tconst data = {\n\t\t\tversion: 1 as const,\n\t\t\toperationId,\n\t\t\toperationKind,\n\t\t\tstatus,\n\t\t\t...(status === \"failed\" ? { errorMessage: \"operation failed\" } : {}),\n\t\t\t...(status === \"cancelled\" ? { reason: \"cancelled\" } : {}),\n\t\t};\n\t\tvoid dispatchLifecycle({\n\t\t\ttype: eventId,\n\t\t\tversion: 1,\n\t\t\tphase: \"committed\",\n\t\t\tsource: \"host\",\n\t\t\toperationId,\n\t\t\tcorrelationId: operationId,\n\t\t\tdata,\n\t\t}).catch(() => {});\n\t};\n\tconst reportOperationEnd = (\n\t\toperationId: string,\n\t\toperationKind: string,\n\t\tstatus: OperationTerminalStatus,\n\t\townerTokens: readonly symbol[],\n\t): void => {\n\t\treportOperationFact(OPERATION_END_EVENT_ID, operationId, operationKind, status, ownerTokens);\n\t};\n\t// operation.start fires when execution begins; operation.cancel fires at the\n\t// cancellation request, before the terminal operation.end fact. Both stay\n\t// within CapabilityAPI-registered operations and never carry input, results,\n\t// or caller cancellation reasons.\n\tconst reportOperationStart = (operationId: string, operationKind: string, ownerTokens: readonly symbol[]): void => {\n\t\tif (ownerTokens.some((ownerToken) => !state.activeOwnerTokens.has(ownerToken))) return;\n\t\tvoid dispatchLifecycle({\n\t\t\ttype: OPERATION_START_EVENT_ID,\n\t\t\tversion: 1,\n\t\t\tphase: \"committed\",\n\t\t\tsource: \"host\",\n\t\t\toperationId,\n\t\t\tcorrelationId: operationId,\n\t\t\tdata: { version: 1, operationId, operationKind },\n\t\t}).catch(() => {});\n\t};\n\tconst reportOperationStep = (\n\t\toperationId: string,\n\t\toperationKind: string,\n\t\townerTokens: readonly symbol[],\n\t\tprogress: OperationProgress,\n\t\tstep: number,\n\t): boolean => {\n\t\tif (\n\t\t\townerTokens.some((ownerToken) => !state.activeOwnerTokens.has(ownerToken)) ||\n\t\t\tstate.statuses.get(operationId) !== \"running\"\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t\tif (!progress || typeof progress !== \"object\" || Array.isArray(progress)) {\n\t\t\tthrow new Error(\"Operation progress must be an object\");\n\t\t}\n\t\tif (progress.message !== undefined && (typeof progress.message !== \"string\" || !progress.message.trim())) {\n\t\t\tthrow new Error(\"Operation progress message must be a non-empty string\");\n\t\t}\n\t\tif (progress.data !== undefined && !isPluginConfigValue(progress.data)) {\n\t\t\tthrow new Error(\"Operation progress data must be serializable\");\n\t\t}\n\t\tvoid dispatchLifecycle({\n\t\t\ttype: OPERATION_STEP_EVENT_ID,\n\t\t\tversion: 1,\n\t\t\tphase: \"committed\",\n\t\t\tsource: \"host\",\n\t\t\toperationId,\n\t\t\tcorrelationId: operationId,\n\t\t\tdata: {\n\t\t\t\tversion: 1,\n\t\t\t\toperationId,\n\t\t\t\toperationKind,\n\t\t\t\tstep,\n\t\t\t\t...(progress.message === undefined ? {} : { message: progress.message }),\n\t\t\t\t...(progress.data === undefined ? {} : { data: detachedSnapshot(progress.data) }),\n\t\t\t},\n\t\t}).catch(() => {});\n\t\treturn true;\n\t};\n\tconst reportOperationCancel = (operationId: string, operationKind: string, ownerTokens: readonly symbol[]): void => {\n\t\tif (ownerTokens.some((ownerToken) => !state.activeOwnerTokens.has(ownerToken))) return;\n\t\tvoid dispatchLifecycle({\n\t\t\ttype: OPERATION_CANCEL_EVENT_ID,\n\t\t\tversion: 1,\n\t\t\tphase: \"committed\",\n\t\t\tsource: \"host\",\n\t\t\toperationId,\n\t\t\tcorrelationId: operationId,\n\t\t\tdata: { version: 1, operationId, operationKind },\n\t\t}).catch(() => {});\n\t};\n\tconst reportCapabilityCall = (\n\t\tevent: \"start\" | \"cancel\" | \"end\",\n\t\toperationId: string,\n\t\tcallerPluginId: string,\n\t\tcapability: RegisteredPluginCapability,\n\t\townerTokens: readonly symbol[],\n\t\tstatus?: OperationTerminalStatus,\n\t): void => {\n\t\tif (ownerTokens.some((ownerToken) => !state.activeOwnerTokens.has(ownerToken))) return;\n\t\tconst data = {\n\t\t\tversion: 1 as const,\n\t\t\tevent,\n\t\t\toperationId,\n\t\t\tcallerPluginId,\n\t\t\tcapabilityId: capability.declaration.id,\n\t\t\tcapabilityVersion: capability.declaration.version,\n\t\t\tcapabilityKind: capability.declaration.kind,\n\t\t\tproviderPluginId: capability.owner,\n\t\t\t...(status === undefined ? {} : { status }),\n\t\t};\n\t\tvoid dispatchLifecycle({\n\t\t\ttype: CAPABILITY_CALL_EVENT_ID,\n\t\t\tversion: CAPABILITY_CALL_EVENT_VERSION,\n\t\t\tphase: \"committed\",\n\t\t\tsource: \"host\",\n\t\t\toperationId,\n\t\t\tcorrelationId: operationId,\n\t\t\tdata,\n\t\t}).catch(() => {});\n\t};\n\n\treturn {\n\t\tdispatchLifecycle,\n\t\treportOperationEnd,\n\t\treportOperationStart,\n\t\treportOperationStep,\n\t\treportOperationCancel,\n\t\treportCapabilityCall,\n\t};\n}\n"]}