@lokvis/runtime 0.2.2 → 0.4.1

package/dist/managers/history-manager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * History Manager(W1.3 从 runtime.ts 抽取)
+ *
+ * 持有每个工作流的 HistoryStack + initialInputs / currentOutputs 映射,
+ * 提供 history / undo / redo / jumpTo,监听 node:finished 自动 append,
+ * LRU 上限清理,持久化快照到 historyStore(IDB)支持跨会话恢复。
+ * deps 注入 eventBus / assetStore / historyStore?,不持有 Runtime 实例避免
+ * 循环依赖。prepareForRun / recordRunResult 供 WorkflowCoordinator 调用。
+ */
+import type { AssetId, EventBus, HistoryEntry, LokvisEvent } from '@lokvis/schema';
+import { HistoryStack } from '../history.js';
+import type { HistoryStore } from '../history-store.js';
+import type { QuotaAwareAssetStore } from './quota-manager.js';
+export interface HistoryManagerDeps {
+    eventBus: EventBus;
+    assetStore: QuotaAwareAssetStore;
+    /** undefined 时退化为仅内存历史(刷新后丢失) */
+    historyStore?: HistoryStore;
+}
+/** 历史栈管理封装,由 RuntimeImpl 持有并委托 */
+export declare class HistoryManager {
+    private readonly deps;
+    private historyStacks;
+    private initialInputsMap;
+    private currentOutputsMap;
+    /** 加载快照期间守卫:restore() 触发 onChanged → persistHistory 时跳过冗余写回 */
+    private isLoadingHistory;
+    /**
+     * 加载期间被跳过的 persistHistory 加入此 Set,loadPersistedHistory 结束后
+     * 逐个补 persist,避免加载期间变更被永久丢弃(W7.2 review 修复)。
+     */
+    private dirtyDuringLoad;
+    constructor(deps: HistoryManagerDeps);
+    history(workflowId: string): Promise<HistoryEntry[]>;
+    getHistoryState(workflowId: string): Promise<{
+        entries: HistoryEntry[];
+        cursor: number;
+    }>;
+    /** 工作流当前输出 AssetId(undo/redo 后的"当前"状态) */
+    getCurrentOutputs(workflowId: string): AssetId[];
+    undo(workflowId: string): Promise<void>;
+    redo(workflowId: string): Promise<void>;
+    jumpTo(workflowId: string, index: number): Promise<void>;
+    /**
+     * run() 前的历史栈准备:
+     * - appendHistory=true 且已有栈:保留栈与 currentOutputs,仅确保初始输入已记录
+     * - 否则(默认重置):丢弃旧历史,重新初始化
+     * 然后执行 LRU 上限清理。
+     */
+    prepareForRun(workflowId: string, inputIds: AssetId[], appendHistory: boolean): void;
+    /** run() 成功完成后,记录最终输出为当前(outputs 非空时)。 */
+    recordRunResult(workflowId: string, outputs: AssetId[]): void;
+    /** node:finished 事件处理:append 到对应工作流栈,inputs 取上一步 outputs。 */
+    recordFromNodeEvent(event: Extract<LokvisEvent, {
+        type: 'node:finished';
+    }>): void;
+    /**
+     * LRU 上限清理:超 MAX_CONCURRENT_WORKFLOW_STACKS 时按 FIFO 删最旧 stack
+     * (reset 触发 onEvict → assetStore.remove 回收资产)。
+     * appendHistory 模式下当前工作流栈必须跳过,否则 FIFO 首位时被误删。
+     */
+    enforceStacksLimit(currentWorkflowId: string): void;
+    /** 获取或创建工作流对应的 HistoryStack */
+    getOrCreateStack(workflowId: string): HistoryStack;
+    /**
+     * 清理指定工作流的历史栈(reset 触发 onEvict 回收资产),不取消运行中执行。
+     *
+     * TD-2.1 长期方案:返回 Promise 并在末尾 `await persistHistory`,使调用方
+     * (disposeWorkflow / disposeAll)能在持久化完成后才返回,消除测试轮询。
+     * stack.reset() 触发 onChanged → fire-and-forget persistHistory(删除空记录),
+     * 此处显式 await 保证 IDB 删除已落地;两次 delete 幂等,无副作用。
+     */
+    disposeHistory(workflowId: string): Promise<void>;
+    /**
+     * 清理所有工作流的历史栈(W21.6 runtime.dispose 用)。
+     *
+     * 复制 keys 后逐个 await disposeHistory,触发 onEvict 回收 outputs 资产。
+     * TD-2.1:改为 async 顺序 await,确保 runtime.dispose() 返回前所有持久化
+     * 删除已落地(避免 dispose 后 IDB 仍有残留记录的竞态)。
+     */
+    disposeAll(): Promise<void>;
+    /**
+     * 把工作流当前历史快照写入 historyStore(W7.2)。
+     *
+     * 时序:currentOutputs 从 stack snapshot 派生(cursor === -1 用 initialInputs,
+     * 否则用 entries[cursor].outputs),不读 currentOutputsMap —— onChanged 在
+     * undo/redo/jumpTo/run 内部同步触发时 map 尚未更新会读到旧值。
+     * 竞态:多个 fire-and-forget save 的 IDB readwrite 事务由 IndexedDB 引擎按发起
+     * 顺序串行化,无需应用层加链。
+     * entries 为空 → delete;加载期间跳过写回,记入 dirtyDuringLoad 后续补 persist。
+     */
+    persistHistory(workflowId: string): Promise<void>;
+    /**
+     * 从 historyStore 预加载所有持久化的历史快照(由 createRuntime 工厂调用)。
+     * 加载期间置 isLoadingHistory 守卫;被跳过的 persist 记入 dirtyDuringLoad,
+     * 加载结束后补 persist,避免加载期间其他来源变更被永久丢弃。
+     */
+    loadPersistedHistory(): Promise<void>;
+}
+//# sourceMappingURL=history-manager.d.ts.map

package/dist/managers/history-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-manager.d.ts","sourceRoot":"","sources":["../../src/managers/history-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAA2B,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAO/D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,oBAAoB,CAAC;IACjC,iCAAiC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,kCAAkC;AAClC,qBAAa,cAAc;IAYb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,iBAAiB,CAAgC;IACzD,+DAA+D;IAC/D,OAAO,CAAC,gBAAgB,CAAS;IACjC;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAqB;gBAEf,IAAI,EAAE,kBAAkB;IAQ/C,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIpD,eAAe,CACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOvD,0CAA0C;IAC1C,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAK1C,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D;;;;;OAKG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,OAAO,GACrB,IAAI;IAgBP,0CAA0C;IAC1C,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI;IAM7D,6DAA6D;IAC7D,mBAAmB,CACjB,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC,GACrD,IAAI;IAsBP;;;;OAIG;IACH,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAoBnD,+BAA+B;IAC/B,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAgClD;;;;;;;OAOG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;;;;;;;;OASG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCvD;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB5C"}

package/dist/managers/history-manager.js

@@ -0,0 +1,296 @@
+/**
+ * History Manager(W1.3 从 runtime.ts 抽取)
+ *
+ * 持有每个工作流的 HistoryStack + initialInputs / currentOutputs 映射,
+ * 提供 history / undo / redo / jumpTo,监听 node:finished 自动 append,
+ * LRU 上限清理,持久化快照到 historyStore(IDB)支持跨会话恢复。
+ * deps 注入 eventBus / assetStore / historyStore?,不持有 Runtime 实例避免
+ * 循环依赖。prepareForRun / recordRunResult 供 WorkflowCoordinator 调用。
+ */
+import { generateId } from '../asset-store.js';
+import { HistoryStack } from '../history.js';
+const DEFAULT_MAX_HISTORY = 10;
+/** 同时持有的工作流历史栈上限(W2.8);超限按 FIFO 清理最旧 stack。 */
+const MAX_CONCURRENT_WORKFLOW_STACKS = 32;
+/** 历史栈管理封装,由 RuntimeImpl 持有并委托 */
+export class HistoryManager {
+    deps;
+    historyStacks = new Map();
+    initialInputsMap = new Map();
+    currentOutputsMap = new Map();
+    /** 加载快照期间守卫:restore() 触发 onChanged → persistHistory 时跳过冗余写回 */
+    isLoadingHistory = false;
+    /**
+     * 加载期间被跳过的 persistHistory 加入此 Set,loadPersistedHistory 结束后
+     * 逐个补 persist,避免加载期间变更被永久丢弃(W7.2 review 修复)。
+     */
+    dirtyDuringLoad = new Set();
+    constructor(deps) {
+        this.deps = deps;
+        this.deps.eventBus.on('node:finished', (event) => {
+            this.recordFromNodeEvent(event);
+        });
+    }
+    async history(workflowId) {
+        return this.historyStacks.get(workflowId)?.list() ?? [];
+    }
+    async getHistoryState(workflowId) {
+        const stack = this.historyStacks.get(workflowId);
+        if (!stack)
+            return { entries: [], cursor: -1 };
+        const snap = stack.snapshot();
+        return { entries: snap.entries, cursor: snap.cursor };
+    }
+    /** 工作流当前输出 AssetId(undo/redo 后的"当前"状态) */
+    getCurrentOutputs(workflowId) {
+        return this.currentOutputsMap.get(workflowId) ?? [];
+    }
+    // history:changed 事件由 stack.onChanged 统一发射,避免双发
+    async undo(workflowId) {
+        const stack = this.getOrCreateStack(workflowId);
+        const result = stack.undo();
+        if (result === undefined)
+            return;
+        // null 表示回到初始状态 → 用 initialInputs;entry → 用其 outputs
+        const newCurrent = result === null
+            ? (this.initialInputsMap.get(workflowId) ?? [])
+            : result.outputs;
+        this.currentOutputsMap.set(workflowId, newCurrent);
+    }
+    async redo(workflowId) {
+        const stack = this.getOrCreateStack(workflowId);
+        const entry = stack.redo();
+        if (entry === undefined)
+            return;
+        this.currentOutputsMap.set(workflowId, entry.outputs);
+    }
+    async jumpTo(workflowId, index) {
+        const stack = this.getOrCreateStack(workflowId);
+        const result = stack.jumpTo(index);
+        if (result === undefined)
+            return;
+        const newCurrent = result === null
+            ? (this.initialInputsMap.get(workflowId) ?? [])
+            : result.outputs;
+        this.currentOutputsMap.set(workflowId, newCurrent);
+    }
+    /**
+     * run() 前的历史栈准备:
+     * - appendHistory=true 且已有栈:保留栈与 currentOutputs,仅确保初始输入已记录
+     * - 否则(默认重置):丢弃旧历史,重新初始化
+     * 然后执行 LRU 上限清理。
+     */
+    prepareForRun(workflowId, inputIds, appendHistory) {
+        if (appendHistory && this.historyStacks.has(workflowId)) {
+            if (!this.initialInputsMap.has(workflowId)) {
+                this.initialInputsMap.set(workflowId, inputIds);
+            }
+        }
+        else {
+            const existingStack = this.historyStacks.get(workflowId);
+            if (existingStack) {
+                existingStack.reset();
+            }
+            this.initialInputsMap.set(workflowId, inputIds);
+            this.currentOutputsMap.set(workflowId, inputIds);
+        }
+        this.enforceStacksLimit(workflowId);
+    }
+    /** run() 成功完成后,记录最终输出为当前(outputs 非空时)。 */
+    recordRunResult(workflowId, outputs) {
+        if (outputs.length > 0) {
+            this.currentOutputsMap.set(workflowId, outputs);
+        }
+    }
+    /** node:finished 事件处理:append 到对应工作流栈,inputs 取上一步 outputs。 */
+    recordFromNodeEvent(event) {
+        if (!event.outputs || event.outputs.length === 0)
+            return;
+        const stack = this.getOrCreateStack(event.workflowId);
+        const outputs = event.outputs.map((a) => a.id);
+        const inputs = this.currentOutputsMap.get(event.workflowId) ?? [];
+        const entry = {
+            id: generateId(),
+            workflowId: event.workflowId,
+            nodeId: event.nodeId,
+            capability: event.capability,
+            params: event.params,
+            inputs,
+            outputs,
+            timestamp: Date.now(),
+        };
+        stack.append(entry);
+        this.currentOutputsMap.set(event.workflowId, outputs);
+    }
+    /**
+     * LRU 上限清理:超 MAX_CONCURRENT_WORKFLOW_STACKS 时按 FIFO 删最旧 stack
+     * (reset 触发 onEvict → assetStore.remove 回收资产)。
+     * appendHistory 模式下当前工作流栈必须跳过,否则 FIFO 首位时被误删。
+     */
+    enforceStacksLimit(currentWorkflowId) {
+        while (this.historyStacks.size >= MAX_CONCURRENT_WORKFLOW_STACKS) {
+            let oldestId = this.historyStacks.keys().next().value;
+            if (oldestId === undefined)
+                break;
+            if (oldestId === currentWorkflowId) {
+                const iter = this.historyStacks.keys();
+                iter.next();
+                oldestId = iter.next().value;
+                if (oldestId === undefined)
+                    break;
+            }
+            const stack = this.historyStacks.get(oldestId);
+            if (stack) {
+                stack.reset();
+            }
+            this.historyStacks.delete(oldestId);
+            this.initialInputsMap.delete(oldestId);
+            this.currentOutputsMap.delete(oldestId);
+        }
+    }
+    /** 获取或创建工作流对应的 HistoryStack */
+    getOrCreateStack(workflowId) {
+        let stack = this.historyStacks.get(workflowId);
+        if (!stack) {
+            const stackConfig = {
+                maxEntries: DEFAULT_MAX_HISTORY,
+                onEvict: (entry) => {
+                    // 淘汰条目时清理其 outputs 资产(避免 OPFS 泄漏)
+                    // TD-3.2: opfs/idb asset-store 的 remove 已对 NotFoundError 静默忽略
+                    // (幂等删除),因此此处 catch 到的都是真实错误(权限/IO/quota 等),
+                    // 用 error 级别记录,便于 Sentry 上报与孤儿资产排查
+                    for (const assetId of entry.outputs) {
+                        this.deps.assetStore.remove(assetId).catch((err) => {
+                            console.error(`[lokvis] onEvict: remove(${assetId}) failed:`, err);
+                        });
+                    }
+                },
+                onChanged: (wfId, entries, currentIndex) => {
+                    this.deps.eventBus.emit({
+                        type: 'history:changed',
+                        workflowId: wfId,
+                        entries,
+                        currentIndex,
+                    });
+                    void this.persistHistory(wfId);
+                },
+            };
+            stack = new HistoryStack(workflowId, stackConfig);
+            this.historyStacks.set(workflowId, stack);
+        }
+        return stack;
+    }
+    /**
+     * 清理指定工作流的历史栈(reset 触发 onEvict 回收资产),不取消运行中执行。
+     *
+     * TD-2.1 长期方案:返回 Promise 并在末尾 `await persistHistory`,使调用方
+     * (disposeWorkflow / disposeAll)能在持久化完成后才返回,消除测试轮询。
+     * stack.reset() 触发 onChanged → fire-and-forget persistHistory(删除空记录),
+     * 此处显式 await 保证 IDB 删除已落地;两次 delete 幂等,无副作用。
+     */
+    async disposeHistory(workflowId) {
+        const stack = this.historyStacks.get(workflowId);
+        if (stack) {
+            stack.reset();
+            this.historyStacks.delete(workflowId);
+        }
+        this.initialInputsMap.delete(workflowId);
+        this.currentOutputsMap.delete(workflowId);
+        await this.persistHistory(workflowId);
+    }
+    /**
+     * 清理所有工作流的历史栈(W21.6 runtime.dispose 用)。
+     *
+     * 复制 keys 后逐个 await disposeHistory,触发 onEvict 回收 outputs 资产。
+     * TD-2.1:改为 async 顺序 await,确保 runtime.dispose() 返回前所有持久化
+     * 删除已落地(避免 dispose 后 IDB 仍有残留记录的竞态)。
+     */
+    async disposeAll() {
+        // 复制一份:disposeHistory 内 stack.reset() → onEvict → assetStore.remove
+        // 可能间接触发其他 listener 改动 historyStacks(理论上不会,但防御性写法)
+        for (const workflowId of [...this.historyStacks.keys()]) {
+            await this.disposeHistory(workflowId);
+        }
+        this.dirtyDuringLoad.clear();
+    }
+    /**
+     * 把工作流当前历史快照写入 historyStore(W7.2)。
+     *
+     * 时序:currentOutputs 从 stack snapshot 派生(cursor === -1 用 initialInputs,
+     * 否则用 entries[cursor].outputs),不读 currentOutputsMap —— onChanged 在
+     * undo/redo/jumpTo/run 内部同步触发时 map 尚未更新会读到旧值。
+     * 竞态:多个 fire-and-forget save 的 IDB readwrite 事务由 IndexedDB 引擎按发起
+     * 顺序串行化,无需应用层加链。
+     * entries 为空 → delete;加载期间跳过写回,记入 dirtyDuringLoad 后续补 persist。
+     */
+    async persistHistory(workflowId) {
+        if (!this.deps.historyStore)
+            return;
+        if (this.isLoadingHistory) {
+            this.dirtyDuringLoad.add(workflowId);
+            return;
+        }
+        // fire-and-forget 调用方用 `void this.persistHistory(...)`,故内部必须 try/catch,
+        // 否则 IDB 故障会变成 unhandled promise rejection。
+        try {
+            const stack = this.historyStacks.get(workflowId);
+            // 栈已从内存移除(disposeHistory / enforceStacksLimit 后异步到达)→ 删除持久化记录
+            if (!stack) {
+                await this.deps.historyStore.delete(workflowId);
+                return;
+            }
+            const { entries, cursor } = stack.snapshot();
+            if (entries.length === 0) {
+                await this.deps.historyStore.delete(workflowId);
+                return;
+            }
+            const initialInputs = this.initialInputsMap.get(workflowId) ?? [];
+            const currentOutputs = cursor === -1
+                ? initialInputs
+                : (entries[cursor]?.outputs ?? initialInputs);
+            await this.deps.historyStore.save({
+                workflowId,
+                entries,
+                cursor,
+                initialInputs,
+                currentOutputs,
+                updatedAt: Date.now(),
+            });
+        }
+        catch (err) {
+            console.warn(`[lokvis] persistHistory failed for workflow ${workflowId}:`, err);
+        }
+    }
+    /**
+     * 从 historyStore 预加载所有持久化的历史快照(由 createRuntime 工厂调用)。
+     * 加载期间置 isLoadingHistory 守卫;被跳过的 persist 记入 dirtyDuringLoad,
+     * 加载结束后补 persist,避免加载期间其他来源变更被永久丢弃。
+     */
+    async loadPersistedHistory() {
+        if (!this.deps.historyStore)
+            return;
+        let records = [];
+        this.isLoadingHistory = true;
+        try {
+            records = await this.deps.historyStore.loadAll();
+            for (const record of records) {
+                if (record.entries.length === 0)
+                    continue; // 跳过空记录(双重防御)
+                const stack = this.getOrCreateStack(record.workflowId);
+                stack.restore({ entries: record.entries, cursor: record.cursor });
+                this.initialInputsMap.set(record.workflowId, record.initialInputs);
+                this.currentOutputsMap.set(record.workflowId, record.currentOutputs);
+            }
+        }
+        finally {
+            this.isLoadingHistory = false;
+            // 补 persist:逐个 await 保证顺序;复制一份避免补 persist 过程中
+            // 新触发 onChanged → dirtyDuringLoad 死循环
+            const pending = [...this.dirtyDuringLoad];
+            this.dirtyDuringLoad.clear();
+            for (const wfId of pending)
+                await this.persistHistory(wfId);
+        }
+    }
+}
+//# sourceMappingURL=history-manager.js.map

package/dist/managers/history-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-manager.js","sourceRoot":"","sources":["../../src/managers/history-manager.ts"],"names":[],"mappings":"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"}

package/dist/managers/mcp-manifest-builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Manifest Builder(W1.5 从 runtime.ts 抽取)
+ *
+ * 把已注册 Capability 列表转换为 MCP server manifest(纯函数,无 `this`,
+ * 不依赖 CapabilityRegistry)。Runtime.toMcpManifest() 委托本模块。
+ *
+ * 暴露规则(见 docs/AI生态冲击调整方案.md §6):
+ * - private:任何模式都不暴露
+ * - batch-only:仅在 options.batchMode=true 时暴露(避免单文件误用)
+ * - 其余(默认 public):总是暴露
+ * tool 名取 capability.mcpToolName 或 `lokvis_${name.replace(/\./g, '_')}`;
+ * resource 固定为 capabilities 与 workflows 两个清单。
+ */
+import type { Capability, McpManifest } from '@lokvis/schema';
+import type { ToMcpManifestOptions } from '../types.js';
+/** 生成 MCP server manifest(不启动 server,仅描述可被 MCP 暴露的能力)。 */
+export declare function toMcpManifest(capabilities: Capability[], options: ToMcpManifestOptions | undefined, version: string): McpManifest;
+//# sourceMappingURL=mcp-manifest-builder.d.ts.map

package/dist/managers/mcp-manifest-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-manifest-builder.d.ts","sourceRoot":"","sources":["../../src/managers/mcp-manifest-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMxD,0DAA0D;AAC1D,wBAAgB,aAAa,CAC3B,YAAY,EAAE,UAAU,EAAE,EAC1B,OAAO,EAAE,oBAAoB,YAAK,EAClC,OAAO,EAAE,MAAM,GACd,WAAW,CAwBb"}

package/dist/managers/mcp-manifest-builder.js

@@ -0,0 +1,99 @@
+/**
+ * MCP Manifest Builder(W1.5 从 runtime.ts 抽取)
+ *
+ * 把已注册 Capability 列表转换为 MCP server manifest(纯函数,无 `this`,
+ * 不依赖 CapabilityRegistry)。Runtime.toMcpManifest() 委托本模块。
+ *
+ * 暴露规则(见 docs/AI生态冲击调整方案.md §6):
+ * - private:任何模式都不暴露
+ * - batch-only:仅在 options.batchMode=true 时暴露(避免单文件误用)
+ * - 其余(默认 public):总是暴露
+ * tool 名取 capability.mcpToolName 或 `lokvis_${name.replace(/\./g, '_')}`;
+ * resource 固定为 capabilities 与 workflows 两个清单。
+ */
+const SERVER_NAME = 'lokvis';
+const CAPABILITIES_URI = 'lokvis://capabilities';
+const WORKFLOWS_URI = 'lokvis://workflows';
+/** 生成 MCP server manifest(不启动 server,仅描述可被 MCP 暴露的能力)。 */
+export function toMcpManifest(capabilities, options = {}, version) {
+    const { batchMode = false } = options;
+    const tools = [];
+    for (const cap of capabilities) {
+        if (cap.mcpExposure === 'private')
+            continue;
+        if (cap.mcpExposure === 'batch-only' && !batchMode)
+            continue;
+        const toolName = cap.mcpToolName ?? `lokvis_${cap.name.replace(/\./g, '_')}`;
+        tools.push({
+            name: toolName,
+            description: cap.description,
+            inputSchema: capabilityParamsToJsonSchema(cap.params),
+            capabilities: [cap.name],
+        });
+    }
+    return {
+        serverName: SERVER_NAME, version, tools,
+        resources: [
+            { uri: CAPABILITIES_URI, name: 'Capabilities',
+                description: 'List all available Lokvis capabilities',
+                mimeType: 'application/json' },
+            { uri: WORKFLOWS_URI, name: 'Workflows',
+                description: 'List saved workflows', mimeType: 'application/json' },
+        ],
+    };
+}
+/** Capability.params(CapabilityParam[])→ JSON Schema 对象(手写,非 zod-to-json-schema)。 */
+function capabilityParamsToJsonSchema(params) {
+    const properties = {};
+    const required = [];
+    for (const p of params) {
+        properties[p.name] = capabilityParamToJsonSchemaProperty(p);
+        if (p.required)
+            required.push(p.name);
+    }
+    return { type: 'object', properties,
+        ...(required.length > 0 ? { required } : {}) };
+}
+/**
+ * CapabilityParamType → 合法 JSON Schema 类型片段。
+ * color/file/enum 非 JSON Schema 标准类型,color→string+format,
+ * file/enum→string(enum 值由外层 enum 字段追加);其余同名 JSON Schema 类型。
+ */
+function capabilityParamTypeToJsonType(type) {
+    switch (type) {
+        case 'color': return { type: 'string', format: 'color' };
+        case 'file':
+        case 'enum': return { type: 'string' };
+        case 'number':
+        case 'string':
+        case 'boolean':
+        case 'object':
+        case 'array': return { type };
+        default: return { type: 'string' };
+    }
+}
+/** 单个 CapabilityParam → JSON Schema property */
+function capabilityParamToJsonSchemaProperty(p) {
+    const { type: jsonType, format } = capabilityParamTypeToJsonType(p.type);
+    const prop = { type: jsonType };
+    if (format)
+        prop.format = format;
+    if (p.description)
+        prop.description = p.description;
+    if (p.default !== undefined)
+        prop.default = p.default;
+    // min/max 仅对 number 合法(string 应为 minLength/maxLength)
+    if (p.type === 'number') {
+        if (typeof p.min === 'number')
+            prop.minimum = p.min;
+        if (typeof p.max === 'number')
+            prop.maximum = p.max;
+    }
+    if (p.type === 'enum' && p.values)
+        prop.enum = p.values;
+    if (p.type === 'array' && p.items) {
+        prop.items = capabilityParamTypeToJsonType(p.items);
+    }
+    return prop;
+}
+//# sourceMappingURL=mcp-manifest-builder.js.map

package/dist/managers/mcp-manifest-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-manifest-builder.js","sourceRoot":"","sources":["../../src/managers/mcp-manifest-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAC3B,YAA0B,EAC1B,UAAgC,EAAE,EAClC,OAAe;IAEf,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;YAAE,SAAS;QAC5C,IAAI,GAAG,CAAC,WAAW,KAAK,YAAY,IAAI,CAAC,SAAS;YAAE,SAAS;QAC7D,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC;YACrD,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK;QACvC,SAAS,EAAE;YACT,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc;gBAC3C,WAAW,EAAE,wCAAwC;gBACrD,QAAQ,EAAE,kBAAkB,EAAE;YAChC,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW;gBACrC,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SACtE;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,SAAS,4BAA4B,CAAC,MAAyB;IAC7D,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,mCAAmC,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU;QACjC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAS,6BAA6B,CACpC,IAAyB;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACzD,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACvC,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,SAAS,mCAAmC,CAC1C,CAAkB;IAElB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzD,IAAI,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,CAAC,WAAW;QAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACpD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IACtD,sDAAsD;IACtD,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC;QACpD,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/managers/quota-manager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Quota Manager
+ *
+ * 从 runtime.ts 抽取的存储配额管理逻辑(W2.9)。
+ *
+ * 职责:用配额校验包裹 AssetStore,import/create 超限时抛 QuotaExceededError,
+ * 并维护运行中的已用字节数供 runtime.getStorageUsage O(1) 读取。
+ *
+ * 并发安全:import/create/remove 通过 promise 链串行化,避免 check 与 update
+ * 之间的 TOCTOU 窗口导致两个并发操作都基于旧 usage 通过校验或回退。
+ */
+import type { AssetSource } from '@lokvis/schema';
+import type { AssetStore } from '../asset-store.js';
+/** 存储配额超限时抛出(W2.9) */
+export declare class QuotaExceededError extends Error {
+    readonly usage: number;
+    readonly delta: number;
+    readonly quota: number;
+    constructor(usage: number, delta: number, quota: number);
+}
+/**
+ * 从 AssetSource 估算导入字节数用于配额预检。
+ * url/opfs 源大小未知,返回 0 跳过预检 —— 真实大小在 import 完成后
+ * 通过 `usage += asset.metadata.size` 补记到账面,后续操作仍受配额约束。
+ */
+export declare function estimateSourceSize(source: AssetSource): number;
+/**
+ * 配额感知的 AssetStore:在 AssetStore 接口之上扩展 _getQuotaUsage,
+ * 供 runtime.getStorageUsage O(1) 读取内部 usage(下划线表"内部 API")。
+ */
+export type QuotaAwareAssetStore = AssetStore & {
+    _getQuotaUsage: () => number;
+};
+/**
+ * 用配额校验包裹 AssetStore:import/create 超限抛 QuotaExceededError(W2.9)。
+ * 内部维护运行中的已用字节数,remove 时回退。
+ *
+ * 并发安全:import/create/remove 通过 promise 链串行化,避免 check 与 update
+ * 之间的 TOCTOU 窗口导致两个并发操作都基于旧 usage 通过校验或回退。
+ */
+export declare function wrapAssetStoreWithQuota(inner: AssetStore, quota: number): QuotaAwareAssetStore;
+//# sourceMappingURL=quota-manager.d.ts.map

package/dist/managers/quota-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-manager.d.ts","sourceRoot":"","sources":["../../src/managers/quota-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,sBAAsB;AACtB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CASxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC9C,cAAc,EAAE,MAAM,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAwFtB"}