@lokvis/schema 0.1.0

package/dist/asset.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Lokvis Asset Model
+ *
+ * 核心设计：Runtime 只操作 AssetId，不直接持有 File 或 Blob。
+ * 所有大文件通过 OPFS 引用，避免内存爆炸。
+ */
+/** Asset 唯一标识 */
+export type AssetId = string;
+/** Asset 类型枚举 */
+export type AssetType = 'image' | 'video' | 'audio' | 'pdf' | 'text' | 'data' | 'unknown';
+/** Asset 元数据 */
+export interface AssetMetadata {
+    mimeType: string;
+    /** 字节数 */
+    size: number;
+    /** 图像/视频尺寸 */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /** 视频/音频时长（秒） */
+    duration?: number;
+    /** PDF 页数 */
+    pages?: number;
+    /** 文件格式：png, mp4, pdf, mp3... */
+    format: string;
+}
+/** Blob 在 OPFS 中的引用句柄 */
+export interface BlobHandle {
+    /** OPFS 中的文件路径 */
+    path: string;
+    /** 字节数 */
+    size: number;
+    /** MIME 类型 */
+    mimeType: string;
+}
+/** 预览图句柄 */
+export interface PreviewHandle {
+    /** 缩略图 OPFS 路径 */
+    path: string;
+    width: number;
+    height: number;
+}
+/** 处理历史记录条目 */
+export interface HistoryEntry {
+    id: string;
+    workflowId: string;
+    nodeId: string;
+    capability: string;
+    params: Record<string, unknown>;
+    inputs: AssetId[];
+    outputs: AssetId[];
+    timestamp: number;
+}
+/** 统一 Asset 抽象 */
+export interface Asset {
+    id: AssetId;
+    type: AssetType;
+    metadata: AssetMetadata;
+    /** OPFS 中的引用，不直接持有内存 */
+    blob: BlobHandle;
+    /** 缩略图（可选） */
+    preview?: PreviewHandle;
+    /** 处理历史 */
+    history: HistoryEntry[];
+    /** 用户标签 */
+    tags: string[];
+    createdAt: number;
+    updatedAt: number;
+}
+/** 资产导入来源 */
+export type AssetSource = {
+    kind: 'file';
+    file: File;
+} | {
+    kind: 'blob';
+    blob: Blob;
+    name: string;
+} | {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'opfs';
+    path: string;
+};
+//# sourceMappingURL=asset.d.ts.map

package/dist/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../src/asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iBAAiB;AACjB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,iBAAiB;AACjB,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,OAAO,GACP,OAAO,GACP,KAAK,GACL,MAAM,GACN,MAAM,GACN,SAAS,CAAC;AAEd,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yBAAyB;AACzB,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kBAAkB;AAClB,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,wBAAwB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW;IACX,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/asset.js

@@ -0,0 +1,8 @@
+/**
+ * Lokvis Asset Model
+ *
+ * 核心设计：Runtime 只操作 AssetId，不直接持有 File 或 Blob。
+ * 所有大文件通过 OPFS 引用，避免内存爆炸。
+ */
+export {};
+//# sourceMappingURL=asset.js.map

package/dist/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../src/asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/capability.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Lokvis Capability Model
+ *
+ * Runtime 永远不知道 FFmpeg，只知道 Capability。
+ * Capability 由 Plugin 注册，由 Engine 实现。
+ */
+import type { AssetType } from './asset.js';
+/** 能力名称采用点分命名：`<domain>.<action>`，如 `image.resize` */
+export type CapabilityName = string;
+/** 能力参数类型 */
+export type CapabilityParamType = 'number' | 'string' | 'boolean' | 'enum' | 'color' | 'file' | 'array' | 'object';
+/** 能力参数定义 */
+export interface CapabilityParam {
+    name: string;
+    type: CapabilityParamType;
+    description?: string;
+    required?: boolean;
+    default?: unknown;
+    min?: number;
+    max?: number;
+    /** type === 'enum' 时的可选值 */
+    values?: string[];
+    /** type === 'array' 时的元素类型 */
+    items?: CapabilityParamType;
+}
+/** 性能预估等级 */
+export type PerformanceLevel = 'fast' | 'medium' | 'slow';
+/**
+ * 引擎选择策略(由 CapabilityRegistry 在无显式 preferredEngine 时使用):
+ * - `'first'`:按注册顺序取第一个(默认,确定性高,保留旧行为)
+ * - `'fastest'`:按性能等级排序取最快(fast > medium > slow,同档按注册顺序)
+ * - `'balanced'`:优先取与能力声明 performance 匹配的实现;无匹配则退化为 fastest
+ */
+export type EngineSelectionStrategy = 'first' | 'fastest' | 'balanced';
+/** 能力声明（由 Plugin 提供） */
+export interface Capability {
+    /** 能力名，如 `image.resize` */
+    name: CapabilityName;
+    description: string;
+    /** 接受的输入 Asset 类型 */
+    inputTypes: AssetType[];
+    /** 产出的输出 Asset 类型 */
+    outputTypes: AssetType[];
+    /** 参数 Schema */
+    params: CapabilityParam[];
+    /** 性能预估，用于 UI 提示与调度优化 */
+    performance: PerformanceLevel;
+    /** 是否支持批量处理（一次处理多个 Asset） */
+    batchable?: boolean;
+    /**
+     * MCP 暴露配置(可选,见 docs/AI生态冲击调整方案.md §7.1):
+     * - `'public'`(默认):暴露给 MCP server,可被 AI 客户端调用
+     * - `'private'`:不暴露(如内部能力、危险操作)
+     * - `'batch-only'`:仅在 batch 模式暴露(避免单文件误用)
+     */
+    mcpExposure?: 'public' | 'private' | 'batch-only';
+    /**
+     * MCP tool 名称覆盖(可选)。
+     * 默认为 `lokvis_${name.replace(/\./g, '_')}`,如 `image.resize` → `lokvis_image_resize`。
+     * 显式指定时用于更友好的命名(如 `lokvis_compress_image`)。
+     */
+    mcpToolName?: string;
+}
+/** 能力实现（由 Plugin 注册到 Runtime） */
+export interface CapabilityImplementation {
+    /** 对应的 Capability 名 */
+    capability: CapabilityName;
+    /** 实现该能力的引擎名 */
+    engine: string;
+    /**
+     * 该引擎的性能等级(可选)。缺省时使用能力声明的 performance。
+     * 用于 EngineSelectionStrategy('fastest'/'balanced')排序选择。
+     */
+    performance?: PerformanceLevel;
+    /** 实际执行函数 */
+    execute: (inputs: import('./asset.js').Asset[], params: Record<string, unknown>, context: ExecutionContext) => Promise<import('./asset.js').Asset[]>;
+}
+/** 能力执行上下文 */
+export interface ExecutionContext {
+    /** 当前 Workflow ID */
+    workflowId: string;
+    /** 当前 Node ID */
+    nodeId: string;
+    /** 取消信号 */
+    signal: AbortSignal;
+    /** 进度回调（0-1） */
+    onProgress?: (progress: number, message?: string) => void;
+    /** 日志函数 */
+    log: (level: 'info' | 'warn' | 'error', message: string) => void;
+}
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,aAAa;AACb,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEb,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,aAAa;AACb,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvE,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,qBAAqB;IACrB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,gBAAgB;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,yBAAyB;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAClD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iCAAiC;AACjC,MAAM,WAAW,wBAAwB;IACvC,uBAAuB;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa;IACb,OAAO,EAAE,CACP,MAAM,EAAE,OAAO,YAAY,EAAE,KAAK,EAAE,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,OAAO,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;CAC5C;AAED,cAAc;AACd,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB;IAChB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,WAAW;IACX,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE"}

package/dist/capability.js

@@ -0,0 +1,8 @@
+/**
+ * Lokvis Capability Model
+ *
+ * Runtime 永远不知道 FFmpeg，只知道 Capability。
+ * Capability 由 Plugin 注册，由 Engine 实现。
+ */
+export {};
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/event.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Lokvis Event Bus Types
+ *
+ * 所有操作发出标准事件，Analytics/Undo/AI/Plugin 都监听事件，无需侵入核心逻辑。
+ */
+import type { Asset, AssetId, AssetMetadata } from './asset.js';
+import type { Workflow, WorkflowResult } from './workflow.js';
+import type { HistoryEntry } from './asset.js';
+/** Lokvis 标准事件类型联合 */
+export type LokvisEvent = {
+    type: 'asset:imported';
+    assetId: AssetId;
+    metadata: AssetMetadata;
+} | {
+    type: 'asset:removed';
+    assetId: AssetId;
+} | {
+    type: 'workflow:started';
+    workflowId: string;
+    workflow: Workflow;
+} | {
+    type: 'workflow:paused';
+    workflowId: string;
+} | {
+    type: 'workflow:resumed';
+    workflowId: string;
+} | {
+    type: 'workflow:cancelled';
+    workflowId: string;
+} | {
+    type: 'node:started';
+    workflowId: string;
+    nodeId: string;
+    inputs: Asset[];
+} | {
+    type: 'node:finished';
+    workflowId: string;
+    nodeId: string;
+    capability: string;
+    params: Record<string, unknown>;
+    outputs: Asset[];
+    duration: number;
+} | {
+    type: 'node:failed';
+    workflowId: string;
+    nodeId: string;
+    error: Error;
+} | {
+    type: 'workflow:completed';
+    workflowId: string;
+    result: WorkflowResult;
+} | {
+    type: 'export:completed';
+    assetId: AssetId;
+    format: string;
+    size: number;
+} | {
+    type: 'history:changed';
+    workflowId: string;
+    entries: HistoryEntry[];
+} | {
+    type: 'capability:registered';
+    capability: string;
+    engine: string;
+} | {
+    type: 'plugin:loaded';
+    name: string;
+    version: string;
+};
+/** 所有事件类型字面量 */
+export type LokvisEventType = LokvisEvent['type'];
+/** 事件处理器函数 */
+export type EventHandler<T extends LokvisEvent> = (event: T) => void;
+/** 事件总线接口 */
+export interface EventBus {
+    /**
+     * 订阅事件
+     * @returns 取消订阅函数
+     */
+    on<T extends LokvisEventType>(type: T, handler: (event: Extract<LokvisEvent, {
+        type: T;
+    }>) => void): () => void;
+    /** 订阅所有事件（用于日志、分析） */
+    onAny(handler: (event: LokvisEvent) => void): () => void;
+    /** 发出事件 */
+    emit(event: LokvisEvent): void;
+    /** 清除所有订阅 */
+    clear(): void;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

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

package/dist/event.js

@@ -0,0 +1,7 @@
+/**
+ * Lokvis Event Bus Types
+ *
+ * 所有操作发出标准事件，Analytics/Undo/AI/Plugin 都监听事件，无需侵入核心逻辑。
+ */
+export {};
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @lokvis/schema
+ *
+ * Lokvis Schema - Workflow / Asset / Plugin / Event 类型定义与校验器。
+ * 这是整个项目的稳定核心，变化最慢，严格 semver，无 Breaking Change。
+ */
+export * from './asset.js';
+export * from './capability.js';
+export * from './workflow.js';
+export * from './event.js';
+export * from './plugin.js';
+export * from './mcp.js';
+export * from './validators.js';
+export declare const SCHEMA_VERSION: "1.0.0";
+export declare const RUNTIME_MIN_VERSION: "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC;AAGhC,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAC/C,eAAO,MAAM,mBAAmB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @lokvis/schema
+ *
+ * Lokvis Schema - Workflow / Asset / Plugin / Event 类型定义与校验器。
+ * 这是整个项目的稳定核心，变化最慢，严格 semver，无 Breaking Change。
+ */
+// 核心类型
+export * from './asset.js';
+export * from './capability.js';
+export * from './workflow.js';
+export * from './event.js';
+export * from './plugin.js';
+// MCP manifest 类型(见 docs/AI生态冲击调整方案.md §6.1)
+export * from './mcp.js';
+// Zod 校验器
+export * from './validators.js';
+// 版本信息
+export const SCHEMA_VERSION = '1.0.0';
+export const RUNTIME_MIN_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO;AACP,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,6CAA6C;AAC7C,cAAc,UAAU,CAAC;AAEzB,UAAU;AACV,cAAc,iBAAiB,CAAC;AAEhC,OAAO;AACP,MAAM,CAAC,MAAM,cAAc,GAAG,OAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lokvis MCP 类型定义
+ *
+ * 把 Lokvis Runtime 的能力包装为 MCP server 时使用的 manifest 类型。
+ * 由 @lokvis/runtime 实现 toMcpManifest(),@lokvis/mcp-server 消费。
+ *
+ * 类型定义在 schema 包(而非 sdk/runtime)是为了避免
+ * runtime → sdk 的循环依赖:runtime 和 sdk 都从 @lokvis/schema 引入。
+ */
+/** 单个 MCP tool 的描述(不启动 server,仅描述可用能力) */
+export interface McpToolManifest {
+    /** tool 名称,约定为 `lokvis_${capability.replace(/\./g, '_')}` */
+    name: string;
+    /** tool 描述,供 AI 客户端理解用途 */
+    description: string;
+    /** 输入参数 JSON Schema */
+    inputSchema: object;
+    /** 依赖的 Lokvis capability 名 */
+    capabilities: string[];
+}
+/** 单个 MCP resource 的描述 */
+export interface McpResourceManifest {
+    /** resource URI,如 `lokvis://capabilities` */
+    uri: string;
+    /** resource 名称(UI 显示用) */
+    name: string;
+    /** resource 描述 */
+    description: string;
+    /** MIME 类型 */
+    mimeType: string;
+}
+/** MCP server manifest:Runtime 当前可被 MCP 暴露的能力概览 */
+export interface McpManifest {
+    /** MCP server 名称,固定为 `lokvis` */
+    serverName: string;
+    /** Runtime 版本 */
+    version: string;
+    /** 暴露的 tools 列表 */
+    tools: McpToolManifest[];
+    /** 暴露的 resources 列表 */
+    resources: McpResourceManifest[];
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,uBAAuB;IACvB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC"}

package/dist/mcp.js

@@ -0,0 +1,11 @@
+/**
+ * Lokvis MCP 类型定义
+ *
+ * 把 Lokvis Runtime 的能力包装为 MCP server 时使用的 manifest 类型。
+ * 由 @lokvis/runtime 实现 toMcpManifest(),@lokvis/mcp-server 消费。
+ *
+ * 类型定义在 schema 包(而非 sdk/runtime)是为了避免
+ * runtime → sdk 的循环依赖:runtime 和 sdk 都从 @lokvis/schema 引入。
+ */
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/plugin.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Lokvis Plugin Schema
+ *
+ * Plugin 是能力的载体。Plugin 通过 PluginContext 注册 Capability 到 Runtime。
+ */
+import type { Capability, CapabilityImplementation } from './capability.js';
+/** Plugin 权限声明 */
+export type PluginPermission = 'asset:read' | 'asset:write' | 'network:none' | 'network:limited' | 'network:full' | 'filesystem:opfs' | 'filesystem:local';
+/** Plugin Manifest（package.json 中的 lokvis 字段或独立 manifest.json） */
+export interface PluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    license: string;
+    main: string;
+    icon?: string;
+    /** 声明使用的能力 */
+    capabilities: string[];
+    /** 兼容的 Runtime 版本 */
+    engines: {
+        'lokvis-runtime': string;
+    };
+    /** 权限声明 */
+    permissions: PluginPermission[];
+}
+/** Plugin 配置（definePlugin 的参数） */
+export interface PluginConfig {
+    name: string;
+    version: string;
+    description?: string;
+    /** 声明能力（Capability 定义） */
+    capabilities: Capability[];
+    /** 使用的引擎名 */
+    engine?: string;
+    /** 权限声明 */
+    permissions?: PluginPermission[];
+}
+/** Panel 定义（UI 扩展点） */
+export interface PanelDefinition {
+    id: string;
+    name: string;
+    /** Panel 位置 */
+    location: 'sidebar' | 'inspector' | 'toolbar' | 'modal';
+    /** 渲染组件标识（由 UI 层解析） */
+    component: string;
+    /** 显示条件 */
+    show?: (context: {
+        selectedAssets: string[];
+    }) => boolean;
+}
+/**
+ * Plugin 上下文（Plugin 能访问的全部 API）
+ *
+ * Plugin 只能看到受限的 Runtime API，看不到 React/Redux/Cloud。
+ * 通过 runtime 读写 Asset，通过 registerCapability 注册能力实现。
+ *
+ * 注意:Plugin SDK 已定位为浏览器内嵌入的兼容层(见
+ * docs/AI生态冲击调整方案.md §4)。若目标是让 AI 客户端调用本地能力,
+ * 推荐使用 @lokvis/mcp-server(MCP 标准),而非 Plugin SDK。
+ */
+export interface PluginContext {
+    /** Runtime 受限 API */
+    runtime: {
+        /** 获取资产元数据 */
+        getAsset: (id: string) => Promise<import('./asset.js').Asset>;
+        /** 导入文件为资产，返回 AssetId */
+        importAsset: (file: File | Blob) => Promise<string>;
+        /** 读取资产的实际 Blob 数据（用于处理） */
+        getAssetBlob: (asset: import('./asset.js').Asset) => Promise<Blob>;
+        /** 从 Blob 创建新资产（能力产出物） */
+        createAsset: (blob: Blob, metadata: import('./asset.js').AssetMetadata, type: import('./asset.js').AssetType) => Promise<import('./asset.js').Asset>;
+        /** 列出所有已注册能力 */
+        listCapabilities: () => Promise<import('./capability.js').Capability[]>;
+    };
+    /** 事件总线 */
+    eventBus: import('./event.js').EventBus;
+    /** 注册能力实现 */
+    registerCapability(impl: CapabilityImplementation): void;
+    /** 注册 UI Panel */
+    registerPanel(panel: PanelDefinition): void;
+    /** 日志 */
+    log(level: 'info' | 'warn' | 'error', message: string): void;
+}
+/** definePlugin 返回的安装函数 */
+export type PluginInstaller = (ctx: PluginContext) => void | Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -0,0 +1,7 @@
+/**
+ * Lokvis Plugin Schema
+ *
+ * Plugin 是能力的载体。Plugin 通过 PluginContext 注册 Capability 到 Runtime。
+ */
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}