@lokvis/runtime 0.1.0

package/dist/asset-store.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Lokvis Asset Store
+ *
+ * 资产存储管理。元数据存 IndexedDB，大文件存 OPFS。
+ * Runtime 只操作 AssetId，不直接持有 File 或 Blob。
+ *
+ * 降级链(createAssetStore 工厂,W2.8):
+ *   preferOpfs → OPFS → IndexedDB(Dexie) → Memory(始终可用,不持久化)
+ */
+import type { Asset, AssetId, AssetMetadata, AssetSource, BlobHandle } from '@lokvis/schema';
+/** Asset 存储接口 */
+export interface AssetStore {
+    /** 导入资产（从 File / Blob / URL） */
+    import(source: AssetSource): Promise<Asset>;
+    /** 获取资产元数据 */
+    get(id: AssetId): Promise<Asset | undefined>;
+    /** 获取资产的 Blob 数据 */
+    getBlob(handle: BlobHandle): Promise<Blob>;
+    /** 删除资产 */
+    remove(id: AssetId): Promise<void>;
+    /** 列出所有资产 */
+    list(): Promise<Asset[]>;
+    /** 创建新 Asset（内部用，由 Capability 产出） */
+    create(blob: Blob, metadata: AssetMetadata, type: Asset['type']): Promise<Asset>;
+}
+/** 生成唯一 ID */
+export declare function generateId(): string;
+/** 从 MIME 类型推断 Asset 类型 */
+export declare function inferAssetType(mimeType: string): Asset['type'];
+/** 从 MIME 类型获取格式扩展名 */
+export declare function getFormatFromMime(mimeType: string): string;
+/** 从 AssetSource 提取 Blob 与 MIME(支持 file/blob,其余抛 not supported) */
+export declare function extractBlobFromSource(source: AssetSource): {
+    blob: Blob;
+    mimeType: string;
+};
+/** prepareImport 返回值:统一构造的导入数据(供三个 store 复用) */
+export interface PreparedImport {
+    id: AssetId;
+    blob: Blob;
+    metadata: AssetMetadata;
+    type: Asset['type'];
+}
+/**
+ * 从 AssetSource 准备导入数据(共享逻辑,供 Memory/OPFS/IDB store 复用):
+ * 提取 blob + MIME、生成 id、推断 type、构造 metadata。
+ * 各 store 只需负责"写入 blob + 存元数据"。
+ */
+export declare function prepareImport(source: AssetSource): PreparedImport;
+/** 从 BlobHandle.path 解析出 AssetId(共享,各 store 按 prefix 调用) */
+export declare function parseBlobPath(path: string, prefix: string): AssetId;
+/** 构造完整 Asset 元数据 + 默认字段(共享工厂) */
+export declare function buildAsset(id: AssetId, blob: Blob, metadata: AssetMetadata, type: Asset['type'], pathPrefix: string): Asset;
+/** 创建内存版 AssetStore（降级方案，不持久化） */
+export declare function createMemoryAssetStore(): AssetStore;
+/** 工厂配置(W2.8) */
+export interface CreateAssetStoreOptions {
+    /** 是否优先使用 OPFS(默认 true);为 false 时跳过 OPFS */
+    preferOpfs?: boolean;
+}
+/**
+ * AssetStore 工厂:自动探测环境,按降级链创建存储(W2.8)。
+ *
+ * 顺序:
+ *   1. preferOpfs(默认 true)且 OPFS 可用 → OpfsAssetStore
+ *   2. IndexedDB 可用 → IdbAssetStore(Dexie)
+ *   3. 兜底 → MemoryAssetStore(始终可用,不持久化)
+ *
+ * 任一阶段抛错均自动降级,最终必定返回一个可用 store。
+ */
+export declare function createAssetStore(options?: CreateAssetStoreOptions): Promise<AssetStore>;
+//# sourceMappingURL=asset-store.d.ts.map

package/dist/asset-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-store.d.ts","sourceRoot":"","sources":["../src/asset-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI7F,iBAAiB;AACjB,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,cAAc;IACd,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC7C,oBAAoB;IACpB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,WAAW;IACX,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa;IACb,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAClF;AAED,cAAc;AACd,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAS9D;AAED,uBAAuB;AACvB,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG;IAC1D,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAWjE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED,kCAAkC;AAClC,wBAAgB,UAAU,CACxB,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,UAAU,EAAE,MAAM,GACjB,KAAK,CAgBP;AAKD,kCAAkC;AAClC,wBAAgB,sBAAsB,IAAI,UAAU,CAyCnD;AAED,iBAAiB;AACjB,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

package/dist/asset-store.js

@@ -0,0 +1,167 @@
+/**
+ * Lokvis Asset Store
+ *
+ * 资产存储管理。元数据存 IndexedDB，大文件存 OPFS。
+ * Runtime 只操作 AssetId，不直接持有 File 或 Blob。
+ *
+ * 降级链(createAssetStore 工厂,W2.8):
+ *   preferOpfs → OPFS → IndexedDB(Dexie) → Memory(始终可用,不持久化)
+ */
+import { createOpfsAssetStore, isOpfsSupported } from './opfs-asset-store.js';
+import { createIdbAssetStore, isIdbSupported } from './idb-asset-store.js';
+/** 生成唯一 ID */
+export function generateId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return `asset_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+/** 从 MIME 类型推断 Asset 类型 */
+export function inferAssetType(mimeType) {
+    if (mimeType.startsWith('image/'))
+        return 'image';
+    if (mimeType.startsWith('video/'))
+        return 'video';
+    if (mimeType.startsWith('audio/'))
+        return 'audio';
+    if (mimeType === 'application/pdf')
+        return 'pdf';
+    if (mimeType.startsWith('text/'))
+        return 'text';
+    if (mimeType === 'application/json' || mimeType.startsWith('application/'))
+        return 'data';
+    return 'unknown';
+}
+/** 从 MIME 类型获取格式扩展名 */
+export function getFormatFromMime(mimeType) {
+    const parts = mimeType.split('/');
+    return parts[1] ?? 'bin';
+}
+/** 从 AssetSource 提取 Blob 与 MIME(支持 file/blob,其余抛 not supported) */
+export function extractBlobFromSource(source) {
+    if (source.kind === 'file') {
+        return { blob: source.file, mimeType: source.file.type };
+    }
+    if (source.kind === 'blob') {
+        return { blob: source.blob, mimeType: source.blob.type };
+    }
+    throw new Error(`Asset source kind "${source.kind}" not supported by this store`);
+}
+/**
+ * 从 AssetSource 准备导入数据(共享逻辑,供 Memory/OPFS/IDB store 复用):
+ * 提取 blob + MIME、生成 id、推断 type、构造 metadata。
+ * 各 store 只需负责"写入 blob + 存元数据"。
+ */
+export function prepareImport(source) {
+    const { blob, mimeType: rawMime } = extractBlobFromSource(source);
+    const id = generateId();
+    const mimeType = rawMime || 'application/octet-stream';
+    const type = inferAssetType(mimeType);
+    const metadata = {
+        mimeType,
+        size: blob.size,
+        format: getFormatFromMime(mimeType),
+    };
+    return { id, blob, metadata, type };
+}
+/** 从 BlobHandle.path 解析出 AssetId(共享,各 store 按 prefix 调用) */
+export function parseBlobPath(path, prefix) {
+    const fullPrefix = `${prefix}://`;
+    if (path.startsWith(fullPrefix)) {
+        return path.slice(fullPrefix.length);
+    }
+    return path;
+}
+/** 构造完整 Asset 元数据 + 默认字段(共享工厂) */
+export function buildAsset(id, blob, metadata, type, pathPrefix) {
+    const now = Date.now();
+    return {
+        id,
+        type,
+        metadata,
+        blob: {
+            path: `${pathPrefix}://${id}`,
+            size: blob.size,
+            mimeType: metadata.mimeType,
+        },
+        history: [],
+        tags: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Memory store 的 BlobHandle.path 前缀 */
+const MEMORY_PATH_PREFIX = 'memory';
+/** 创建内存版 AssetStore（降级方案，不持久化） */
+export function createMemoryAssetStore() {
+    const assets = new Map();
+    const blobs = new Map();
+    return {
+        async import(source) {
+            const { id, blob, metadata, type } = prepareImport(source);
+            blobs.set(id, blob);
+            const asset = buildAsset(id, blob, metadata, type, MEMORY_PATH_PREFIX);
+            assets.set(id, asset);
+            return asset;
+        },
+        async get(id) {
+            return assets.get(id);
+        },
+        async getBlob(handle) {
+            const id = parseBlobPath(handle.path, MEMORY_PATH_PREFIX);
+            const blob = blobs.get(id);
+            if (!blob)
+                throw new Error(`Blob not found for path: ${handle.path}`);
+            return blob;
+        },
+        async remove(id) {
+            assets.delete(id);
+            blobs.delete(id);
+        },
+        async list() {
+            return Array.from(assets.values());
+        },
+        async create(blob, metadata, type) {
+            const id = generateId();
+            blobs.set(id, blob);
+            const asset = buildAsset(id, blob, metadata, type, MEMORY_PATH_PREFIX);
+            assets.set(id, asset);
+            return asset;
+        },
+    };
+}
+/**
+ * AssetStore 工厂:自动探测环境,按降级链创建存储(W2.8)。
+ *
+ * 顺序:
+ *   1. preferOpfs(默认 true)且 OPFS 可用 → OpfsAssetStore
+ *   2. IndexedDB 可用 → IdbAssetStore(Dexie)
+ *   3. 兜底 → MemoryAssetStore(始终可用,不持久化)
+ *
+ * 任一阶段抛错均自动降级,最终必定返回一个可用 store。
+ */
+export async function createAssetStore(options = {}) {
+    const preferOpfs = options.preferOpfs ?? true;
+    // 1. OPFS
+    if (preferOpfs && isOpfsSupported()) {
+        try {
+            return await createOpfsAssetStore();
+        }
+        catch (err) {
+            // OPFS 初始化失败,降级到 IndexedDB
+            console.warn('[lokvis] OPFS unavailable, falling back to IndexedDB:', err);
+        }
+    }
+    // 2. IndexedDB
+    if (isIdbSupported()) {
+        try {
+            return await createIdbAssetStore();
+        }
+        catch (err) {
+            console.warn('[lokvis] IndexedDB unavailable, falling back to memory:', err);
+        }
+    }
+    // 3. Memory(兜底,始终可用)
+    return createMemoryAssetStore();
+}
+//# sourceMappingURL=asset-store.js.map

package/dist/asset-store.js.map

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

package/dist/capability-registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Lokvis Capability Registry
+ *
+ * 能力注册中心。Runtime 永远不知道 FFmpeg，只知道 Capability。
+ * Capability 由 Plugin 注册，由 Engine 实现。
+ */
+import type { Capability, CapabilityImplementation, CapabilityName, EngineSelectionStrategy } from '@lokvis/schema';
+/** 能力注册中心 */
+export declare class CapabilityRegistry {
+    private registry;
+    private readonly defaultStrategy;
+    constructor(defaultStrategy?: EngineSelectionStrategy);
+    /** 注册一个能力声明 */
+    registerCapability(capability: Capability): void;
+    /** 注册能力实现 */
+    registerImplementation(impl: CapabilityImplementation): void;
+    /** 列出所有能力声明 */
+    list(): Capability[];
+    /** 检查能力是否存在 */
+    has(name: CapabilityName): boolean;
+    /** 获取能力声明 */
+    get(name: CapabilityName): Capability | undefined;
+    /**
+     * 解析能力实现。
+     * - 若指定 preferredEngine 且存在匹配实现,直接返回;
+     * - 否则按构造时设定的 defaultStrategy 选择('first'/'fastest'/'balanced')。
+     */
+    resolve(name: CapabilityName, preferredEngine?: string): CapabilityImplementation | undefined;
+    /** 按默认策略从实现列表中选择一个 */
+    private selectByStrategy;
+    /** 取性能等级最优的实现(同档按注册顺序,稳定排序) */
+    private fastest;
+    /** 实现的性能等级:优先用实现自身声明,缺省回退到能力声明 */
+    private perfOf;
+    /** 清除所有注册 */
+    clear(): void;
+}
+//# sourceMappingURL=capability-registry.d.ts.map

package/dist/capability-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../src/capability-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACxB,cAAc,EACd,uBAAuB,EAExB,MAAM,gBAAgB,CAAC;AAiBxB,aAAa;AACb,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;gBAE9C,eAAe,GAAE,uBAAiC;IAI9D,eAAe;IACf,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAQhD,aAAa;IACb,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI;IAU5D,eAAe;IACf,IAAI,IAAI,UAAU,EAAE;IAIpB,eAAe;IACf,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIlC,aAAa;IACb,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS;IAIjD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAY7F,sBAAsB;IACtB,OAAO,CAAC,gBAAgB;IAoBxB,+BAA+B;IAC/B,OAAO,CAAC,OAAO;IAYf,kCAAkC;IAClC,OAAO,CAAC,MAAM;IAId,aAAa;IACb,KAAK,IAAI,IAAI;CAGd"}

package/dist/capability-registry.js

@@ -0,0 +1,100 @@
+/**
+ * Lokvis Capability Registry
+ *
+ * 能力注册中心。Runtime 永远不知道 FFmpeg，只知道 Capability。
+ * Capability 由 Plugin 注册，由 Engine 实现。
+ */
+/** 性能等级排序权重(数值越小越快) */
+const PERFORMANCE_RANK = {
+    fast: 0,
+    medium: 1,
+    slow: 2,
+};
+/** 能力注册中心 */
+export class CapabilityRegistry {
+    registry = new Map();
+    defaultStrategy;
+    constructor(defaultStrategy = 'first') {
+        this.defaultStrategy = defaultStrategy;
+    }
+    /** 注册一个能力声明 */
+    registerCapability(capability) {
+        const existing = this.registry.get(capability.name);
+        if (existing) {
+            throw new Error(`Capability "${capability.name}" is already registered`);
+        }
+        this.registry.set(capability.name, { capability, implementations: [] });
+    }
+    /** 注册能力实现 */
+    registerImplementation(impl) {
+        const entry = this.registry.get(impl.capability);
+        if (!entry) {
+            throw new Error(`Cannot register implementation for unknown capability "${impl.capability}". Register the capability first.`);
+        }
+        entry.implementations.push(impl);
+    }
+    /** 列出所有能力声明 */
+    list() {
+        return Array.from(this.registry.values()).map((e) => e.capability);
+    }
+    /** 检查能力是否存在 */
+    has(name) {
+        return this.registry.has(name);
+    }
+    /** 获取能力声明 */
+    get(name) {
+        return this.registry.get(name)?.capability;
+    }
+    /**
+     * 解析能力实现。
+     * - 若指定 preferredEngine 且存在匹配实现,直接返回;
+     * - 否则按构造时设定的 defaultStrategy 选择('first'/'fastest'/'balanced')。
+     */
+    resolve(name, preferredEngine) {
+        const entry = this.registry.get(name);
+        if (!entry || entry.implementations.length === 0)
+            return undefined;
+        if (preferredEngine) {
+            const impl = entry.implementations.find((i) => i.engine === preferredEngine);
+            if (impl)
+                return impl;
+        }
+        return this.selectByStrategy(entry.implementations, entry.capability);
+    }
+    /** 按默认策略从实现列表中选择一个 */
+    selectByStrategy(impls, capability) {
+        switch (this.defaultStrategy) {
+            case 'first':
+                return impls[0];
+            case 'fastest':
+                return this.fastest(impls, capability);
+            case 'balanced': {
+                // 优先取与能力声明 performance 匹配的实现(同档按注册顺序)
+                const target = capability.performance;
+                const matching = impls.filter((i) => this.perfOf(i, capability) === target);
+                if (matching.length > 0)
+                    return matching[0];
+                // 无匹配则退化为最快
+                return this.fastest(impls, capability);
+            }
+        }
+    }
+    /** 取性能等级最优的实现(同档按注册顺序,稳定排序) */
+    fastest(impls, capability) {
+        return impls.reduce((best, cur) => {
+            const a = PERFORMANCE_RANK[this.perfOf(best, capability)];
+            const b = PERFORMANCE_RANK[this.perfOf(cur, capability)];
+            // 仅当严格更优时替换,保证同档保留先注册的(稳定性)
+            return b < a ? cur : best;
+        }, impls[0]);
+    }
+    /** 实现的性能等级:优先用实现自身声明,缺省回退到能力声明 */
+    perfOf(impl, capability) {
+        return impl.performance ?? capability.performance;
+    }
+    /** 清除所有注册 */
+    clear() {
+        this.registry.clear();
+    }
+}
+//# sourceMappingURL=capability-registry.js.map

package/dist/capability-registry.js.map

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

package/dist/event-bus.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lokvis Event Bus Implementation
+ *
+ * 基于 mitt 的轻量事件总线实现。
+ * 所有操作发出标准事件，Analytics/Undo/AI/Plugin 都监听事件。
+ */
+import type { EventBus } from '@lokvis/schema';
+export declare function createEventBus(): EventBus;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAI5D,wBAAgB,cAAc,IAAI,QAAQ,CA4BzC"}

package/dist/event-bus.js

@@ -0,0 +1,33 @@
+/**
+ * Lokvis Event Bus Implementation
+ *
+ * 基于 mitt 的轻量事件总线实现。
+ * 所有操作发出标准事件，Analytics/Undo/AI/Plugin 都监听事件。
+ */
+import mitt from 'mitt';
+export function createEventBus() {
+    const emitter = mitt();
+    const anyHandlers = new Set();
+    return {
+        on(type, handler) {
+            const wrapped = (e) => handler(e);
+            emitter.on(type, wrapped);
+            return () => emitter.off(type, wrapped);
+        },
+        onAny(handler) {
+            anyHandlers.add(handler);
+            return () => anyHandlers.delete(handler);
+        },
+        emit(event) {
+            emitter.emit(event.type, event);
+            for (const handler of anyHandlers) {
+                handler(event);
+            }
+        },
+        clear() {
+            emitter.all.clear();
+            anyHandlers.clear();
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,EAAU,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE5D,OAAO;QACL,EAAE,CAAC,IAAI,EAAE,OAAO;YACd,MAAM,OAAO,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,CAAU,CAAC,CAAC;YACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,OAAO;YACX,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,KAAK;YACR,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,KAAK;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACpB,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/executor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Lokvis Workflow Executor
+ *
+ * 第一年只支持 Linear Workflow（线性链）。
+ * 不支持：Branch / Loop / Condition / Parallel。
+ */
+import type { Asset, AssetId, Workflow, WorkflowResult } from '@lokvis/schema';
+import type { EventBus } from '@lokvis/schema';
+import type { AssetStore } from './asset-store.js';
+import type { CapabilityRegistry } from './capability-registry.js';
+/** Workflow 执行器配置 */
+export interface ExecutorConfig {
+    assetStore: AssetStore;
+    capabilityRegistry: CapabilityRegistry;
+    eventBus: EventBus;
+    enableLog: boolean;
+}
+/** Workflow 执行器 */
+export declare class WorkflowExecutor {
+    private config;
+    private running;
+    /** 暂停时挂起的 resolve:resume/cancel 唤醒之,避免轮询 */
+    private resumeResolvers;
+    constructor(config: ExecutorConfig);
+    /** 执行工作流 */
+    execute(workflow: Workflow, inputs: AssetId[] | Asset[]): Promise<WorkflowResult>;
+    /** 取消执行 */
+    cancel(workflowId: string): Promise<void>;
+    /** 暂停执行 */
+    pause(workflowId: string): Promise<void>;
+    /** 恢复执行 */
+    resume(workflowId: string): Promise<void>;
+    /**
+     * 挂起当前执行直到 resume/cancel 唤醒(Promise resolver 模式)。
+     * 相比轮询(setTimeout)无延迟、无 CPU 占用;resume/cancel 通过
+     * resolveResume 触发 resolver。
+     */
+    private waitForResume;
+    /** 唤醒挂起的 waitForResume(若存在) */
+    private resolveResume;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EAEP,QAAQ,EAGR,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAWnE,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAkED,mBAAmB;AACnB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAsC;IACrD,4CAA4C;IAC5C,OAAO,CAAC,eAAe,CAAiC;gBAE5C,MAAM,EAAE,cAAc;IAIlC,YAAY;IACN,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAC1B,OAAO,CAAC,cAAc,CAAC;IA0I1B,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,WAAW;IACL,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,WAAW;IACL,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB,+BAA+B;IAC/B,OAAO,CAAC,aAAa;CAOtB"}