@lokvis/schema 0.4.0 → 0.4.1

package/dist/capability-names.generated.d.ts

@@ -1,7 +1,7 @@
 /**
  * AUTO-GENERATED BY scripts/codegen-capabilities.ts — DO NOT EDIT.
  *
- * 来源:packages/capability/manifests/ai.manifest.json, packages/capability/manifests/audio.manifest.json, packages/capability/manifests/image.manifest.json, packages/capability/manifests/pdf.manifest.json, packages/capability/manifests/video.manifest.json
+ * 来源:packages/capability/manifests/ai.manifest.json, packages/capability/manifests/audio.manifest.json, packages/capability/manifests/developer.manifest.json, packages/capability/manifests/image.manifest.json, packages/capability/manifests/pdf.manifest.json, packages/capability/manifests/video.manifest.json
  * 重跑:pnpm codegen
  *
  * 此文件提供精确字面量联合类型 BuiltinCapabilityName,
@@ -13,7 +13,7 @@
  * - `BuiltinCapabilityName` 是已知内置能力的字面量子集,
  *   可作为 `CapabilityName` 的精确化类型
  */
-export type BuiltinCapabilityName = 'ai.ocr' | 'ai.caption' | 'ai.background-remove' | 'ai.generate-workflow' | 'ai.optimize-workflow' | 'audio.trim' | 'audio.normalize' | 'audio.merge' | 'audio.transcode' | 'audio.denoise' | 'image.resize' | 'image.compress' | 'image.convert' | 'image.crop' | 'image.rotate' | 'image.flip' | 'image.watermark' | 'image.background' | 'image.filter' | 'pdf.merge' | 'pdf.split' | 'pdf.compress' | 'pdf.rotate' | 'pdf.watermark' | 'pdf.ocr' | 'pdf.sign' | 'pdf.add-page-numbers' | 'video.compress' | 'video.transcode' | 'video.trim' | 'video.merge' | 'video.extract-audio' | 'video.to-gif' | 'video.screenshot';
+export type BuiltinCapabilityName = 'ai.ocr' | 'ai.caption' | 'ai.background-remove' | 'ai.generate-workflow' | 'ai.optimize-workflow' | 'ai.diagnose-error' | 'audio.trim' | 'audio.normalize' | 'audio.merge' | 'audio.transcode' | 'developer.inspect.capabilities' | 'developer.inspect.asset' | 'developer.validate.workflow' | 'developer.profile' | 'image.resize' | 'image.compress' | 'image.convert' | 'image.crop' | 'image.rotate' | 'image.flip' | 'image.watermark' | 'image.background' | 'image.filter' | 'pdf.merge' | 'pdf.split' | 'pdf.compress' | 'pdf.rotate' | 'pdf.watermark' | 'pdf.ocr' | 'pdf.sign' | 'video.compress' | 'video.transcode' | 'video.trim' | 'video.merge' | 'video.extract-audio' | 'video.to-gif' | 'video.screenshot';
 /** 全部内置能力名常量数组(运行时校验 / 枚举用) */
 export declare const BUILTIN_CAPABILITY_NAMES: readonly BuiltinCapabilityName[];
 //# sourceMappingURL=capability-names.generated.d.ts.map

package/dist/capability-names.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-names.generated.d.ts","sourceRoot":"","sources":["../src/capability-names.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,YAAY,GACZ,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,YAAY,GACZ,eAAe,GACf,SAAS,GACT,UAAU,GACV,sBAAsB,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,qBAAqB,GACrB,cAAc,GACd,kBAAkB,CAAC;AAEvB,+BAA+B;AAC/B,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAmCpE,CAAC"}
+{"version":3,"file":"capability-names.generated.d.ts","sourceRoot":"","sources":["../src/capability-names.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,YAAY,GACZ,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,gCAAgC,GAChC,yBAAyB,GACzB,6BAA6B,GAC7B,mBAAmB,GACnB,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,YAAY,GACZ,eAAe,GACf,SAAS,GACT,UAAU,GACV,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,qBAAqB,GACrB,cAAc,GACd,kBAAkB,CAAC;AAEvB,+BAA+B;AAC/B,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAsCpE,CAAC"}

package/dist/capability-names.generated.js

@@ -5,11 +5,15 @@ export const BUILTIN_CAPABILITY_NAMES = [
     'ai.background-remove',
     'ai.generate-workflow',
     'ai.optimize-workflow',
+    'ai.diagnose-error',
     'audio.trim',
     'audio.normalize',
     'audio.merge',
     'audio.transcode',
-    'audio.denoise',
+    'developer.inspect.capabilities',
+    'developer.inspect.asset',
+    'developer.validate.workflow',
+    'developer.profile',
     'image.resize',
     'image.compress',
     'image.convert',
@@ -26,7 +30,6 @@ export const BUILTIN_CAPABILITY_NAMES = [
     'pdf.watermark',
     'pdf.ocr',
     'pdf.sign',
-    'pdf.add-page-numbers',
     'video.compress',
     'video.transcode',
     'video.trim',

package/dist/capability-names.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability-names.generated.js","sourceRoot":"","sources":["../src/capability-names.generated.ts"],"names":[],"mappings":"AAmDA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,QAAQ;IACR,YAAY;IACZ,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,YAAY;IACZ,iBAAiB;IACjB,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,WAAW;IACX,cAAc;IACd,YAAY;IACZ,eAAe;IACf,SAAS;IACT,UAAU;IACV,sBAAsB;IACtB,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,qBAAqB;IACrB,cAAc;IACd,kBAAkB;CACnB,CAAC"}
+{"version":3,"file":"capability-names.generated.js","sourceRoot":"","sources":["../src/capability-names.generated.ts"],"names":[],"mappings":"AAsDA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,QAAQ;IACR,YAAY;IACZ,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,YAAY;IACZ,iBAAiB;IACjB,aAAa;IACb,iBAAiB;IACjB,gCAAgC;IAChC,yBAAyB;IACzB,6BAA6B;IAC7B,mBAAmB;IACnB,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,WAAW;IACX,cAAc;IACd,YAAY;IACZ,eAAe;IACf,SAAS;IACT,UAAU;IACV,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,qBAAqB;IACrB,cAAc;IACd,kBAAkB;CACnB,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './workflow.js';
 export * from './event.js';
 export * from './plugin.js';
 export * from './exif.js';
+export * from './metadata.js';
 export * from './mcp.js';
 export * from './validators.js';
 export declare const SCHEMA_VERSION: "1.0.0";

package/dist/index.d.ts.map

@@ -1 +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;AAC5B,cAAc,WAAW,CAAC;AAE1B,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC;AAGhC,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAC/C,eAAO,MAAM,mBAAmB,EAAG,OAAgB,CAAC"}
+{"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;AAC5B,cAAc,WAAW,CAAC;AAE1B,cAAc,eAAe,CAAC;AAE9B,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

@@ -11,6 +11,8 @@ export * from './workflow.js';
 export * from './event.js';
 export * from './plugin.js';
 export * from './exif.js';
+// 跨层共享的资产元数据查询类型(ImageMetadata / PdfInfo,见 metadata.ts)
+export * from './metadata.js';
 // MCP manifest 类型(见 docs/AI生态冲击调整方案.md §6.1)
 export * from './mcp.js';
 // Zod 校验器

package/dist/index.js.map

@@ -1 +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,cAAc,WAAW,CAAC;AAC1B,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"}
+{"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,cAAc,WAAW,CAAC;AAC1B,wDAAwD;AACxD,cAAc,eAAe,CAAC;AAC9B,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/metadata.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 跨层共享的资产元数据查询类型。
+ *
+ * 与 ExifData 同一设计层级:某些 Plugin 能力本质是"元数据查询"而非
+ * "资产变换"(如 image dimensions 读取、pdf 页数读取),既不符合 Engine
+ * 层 Blob↔Blob 纯函数约束,也不符合 Capability Asset[]→Asset[] 契约。
+ * 这类能力通过 MetadataReader 注册,返回值类型定义在此处,
+ * 供 Runtime / SDK / 上层消费者(mcp-server 等)共享,避免跨层依赖。
+ *
+ * 与 AssetMetadata 的区别:
+ * - AssetMetadata:导入时一次性提取的通用元数据(size/mimeType/format/
+ *   dimensions/duration/pages),所有 asset 都有
+ * - ImageMetadata / PdfInfo:按需查询的领域特定元数据,由 Plugin 通过
+ *   MetadataReader 提供(如 image 经 sharp 解码读尺寸、pdf 经 pdf-lib
+ *   读页数),用于处理后输出资产的精确元数据报告
+ */
+/**
+ * 图像元数据(width/height/format)。
+ *
+ * 由 plugin-image 的 `image.read-metadata` MetadataReader 提供,
+ * 内部调用 engine-image/node 的 getMetadata(sharp .metadata())。
+ * 与 engine-image/node 的 ImageMetadata 接口对齐(此处为共享类型源,
+ * engine-image 改为 re-export 本类型)。
+ */
+export interface ImageMetadata {
+    width: number;
+    height: number;
+    format: string;
+}
+/**
+ * PDF 基本信息(页数)。
+ *
+ * 由 plugin-pdf 的 `pdf.read-info` MetadataReader 提供,
+ * 内部调用 engine-pdf 的 getPdfInfo(pdf-lib getPageCount)。
+ * 与 engine-pdf 的 PdfInfo 接口对齐(此处为共享类型源,
+ * engine-pdf 改为 re-export 本类型)。
+ */
+export interface PdfInfo {
+    pages: number;
+}
+/**
+ * 视频基本信息(分辨率/时长/帧率/编解码)。
+ *
+ * 由 plugin-video/node 的 `video.read-info` MetadataReader 提供,
+ * 内部调用 engine-video/node 的 getVideoInfo(ffprobe 解析)。
+ * 与 engine-video 的 VideoInfo 接口对齐(此处为共享类型源,
+ * engine-video 改为 re-export 本类型)。
+ */
+export interface VideoInfo {
+    width: number;
+    height: number;
+    duration: number;
+    fps: number;
+    codec: string;
+}
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/metadata.js

@@ -0,0 +1,18 @@
+/**
+ * 跨层共享的资产元数据查询类型。
+ *
+ * 与 ExifData 同一设计层级:某些 Plugin 能力本质是"元数据查询"而非
+ * "资产变换"(如 image dimensions 读取、pdf 页数读取),既不符合 Engine
+ * 层 Blob↔Blob 纯函数约束,也不符合 Capability Asset[]→Asset[] 契约。
+ * 这类能力通过 MetadataReader 注册,返回值类型定义在此处,
+ * 供 Runtime / SDK / 上层消费者(mcp-server 等)共享,避免跨层依赖。
+ *
+ * 与 AssetMetadata 的区别:
+ * - AssetMetadata:导入时一次性提取的通用元数据(size/mimeType/format/
+ *   dimensions/duration/pages),所有 asset 都有
+ * - ImageMetadata / PdfInfo:按需查询的领域特定元数据,由 Plugin 通过
+ *   MetadataReader 提供(如 image 经 sharp 解码读尺寸、pdf 经 pdf-lib
+ *   读页数),用于处理后输出资产的精确元数据报告
+ */
+export {};
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/plugin.d.ts

@@ -36,6 +36,34 @@ export interface PluginConfig {
     /** 权限声明 */
     permissions?: PluginPermission[];
 }
+/**
+ * Plugin 权限沙箱契约(由 runtime 实现)。
+ *
+ * Plugin 通过 `ctx.sandbox` 访问自身权限声明,在调用受限 API 前主动断言:
+ *   ctx.sandbox.assertNetworkAllowed('loading model manifest');
+ * 若声明 network:none,断言立即抛 PluginPermissionError;否则 no-op。
+ *
+ * 实现见 @lokvis/runtime 的 PluginPermissionSandbox 类。schema 仅定义契约
+ * (依赖反转:runtime 依赖 schema,而非反之)。
+ */
+export interface PluginPermissionSandbox {
+    /** 插件名(便于错误信息定位) */
+    readonly pluginName: string;
+    /** 声明的权限集合(只读) */
+    readonly declared: ReadonlySet<PluginPermission>;
+    /** 是否声明了指定权限 */
+    has(perm: PluginPermission): boolean;
+    /**
+     * 断言网络调用允许(声明 network:none 时抛错)。
+     * Plugin 在调用 fetch / XHR 等前可主动调用。
+     */
+    assertNetworkAllowed(reason: string): void;
+    /**
+     * 断言文件系统访问允许(声明未含对应 filesystem:* 时抛错)。
+     * @param scope 'opfs'(OPFS 根目录)或 'local'(任意本地文件系统)
+     */
+    assertFilesystemAllowed(scope: 'opfs' | 'local', reason: string): void;
+}
 /** Panel 定义（UI 扩展点） */
 export interface PanelDefinition {
     id: string;
@@ -53,7 +81,7 @@ export interface PanelDefinition {
  * 元数据读取函数(依赖反转)。
  *
  * 某些 Plugin 能力本质是"元数据查询"而非"资产变换"(如 EXIF 读取:
- * Blob → ExifData),既不符合 Engine 层 Blob↔Blob 约束,也不符合
+ * Blob → ExifData),既不符合 Engine 层 Blob↔Blob 纯函数约束,也不符合
  * CapabilityImplementation 的 Asset[]→Asset[] 契约。这类能力通过
  * MetadataReader 注册:Plugin 提供读取函数,Runtime 持有引用并按名调用。
  *
@@ -67,9 +95,28 @@ export interface PanelDefinition {
  * - 类型直接透传(ExifData),无需序列化
  *
  * @param asset 输入资产
+ * @param ctx 读取上下文(提供 log 可观测信号;TD-3.4 长期方案)
  * @returns 读取结果;无数据 / 解析失败返回 null
  */
-export type MetadataReader<T = unknown> = (asset: import('./asset.js').Asset) => Promise<T | null>;
+export type MetadataReader<T = unknown> = (asset: import('./asset.js').Asset, ctx: MetadataReaderContext) => Promise<T | null>;
+/**
+ * 元数据读取上下文(TD-3.4 长期方案)。
+ *
+ * 为 MetadataReader 提供可观测信号,使其能区分"无数据"(返回 null)
+ * 与"解析异常"(log warn 后返回 null),避免静默吞错。
+ *
+ * 与 ExecutionContext 的关系:
+ * - ExecutionContext 用于 Capability execute,含 workflowId / nodeId /
+ *   signal / onProgress(走 WorkflowExecutor)
+ * - MetadataReaderContext 用于 MetadataReader,只含 log(走 Runtime
+ *   直接调用,无 workflow 上下文)
+ *
+ * log 签名与 ExecutionContext.log 一致,便于 Plugin 复用日志逻辑。
+ */
+export interface MetadataReaderContext {
+    /** 日志函数(与 ExecutionContext.log 一致签名) */
+    log: (level: 'info' | 'warn' | 'error', message: string) => void;
+}
 /**
  * Plugin 上下文（Plugin 能访问的全部 API）
  *
@@ -111,6 +158,18 @@ export interface PluginContext {
     registerMetadataReader<T>(name: string, reader: MetadataReader<T>): void;
     /** 注册 UI Panel */
     registerPanel(panel: PanelDefinition): void;
+    /**
+     * 权限沙箱(W18.6)。
+     *
+     * Plugin 据此在调用受限 API 前主动断言:
+     *   ctx.sandbox.assertNetworkAllowed('loading manifest');
+     *
+     * Runtime 在 installPlugin() 期间应用 network guard
+     * (monkey-patch fetch/XHR/WebSocket/EventSource),声明
+     * network:none 时这些 API 调用立即抛 NetworkGuardError。
+     * capability execute() 路径不自动应用守卫 —— plugin 应主动自检。
+     */
+    readonly sandbox: PluginPermissionSandbox;
     /** 日志 */
     log(level: 'info' | 'warn' | 'error', message: string): void;
 }

package/dist/plugin.d.ts.map

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

package/dist/workflow.d.ts

@@ -7,6 +7,14 @@
 import type { AssetType } from './asset.js';
 /** Workflow 节点类型 */
 export type NodeType = 'load' | 'transform' | 'export';
+/**
+ * 工作流最大节点数(M1 MVP 约束)。
+ *
+ * 定义在 schema 层(与 validateWorkflow 的 maxSteps option 同源),
+ * 供 @lokvis/workflow(WorkflowBuilder)与 @lokvis/runtime(WorkflowCoordinator)
+ * 共同消费,避免常量跨包分裂。
+ */
+export declare const MAX_WORKFLOW_STEPS = 5;
 /** Workflow 节点定义 */
 export interface WorkflowNode {
     /** 节点唯一 ID */

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -4,6 +4,14 @@
  * 第一年只支持 Linear Workflow（线性工作流）。
  * 不支持：Branch / Loop / Condition / Parallel。
  */
+/**
+ * 工作流最大节点数(M1 MVP 约束)。
+ *
+ * 定义在 schema 层(与 validateWorkflow 的 maxSteps option 同源),
+ * 供 @lokvis/workflow(WorkflowBuilder)与 @lokvis/runtime(WorkflowCoordinator)
+ * 共同消费,避免常量跨包分裂。
+ */
+export const MAX_WORKFLOW_STEPS = 5;
 /**
  * 把 Workflow 转换为 AI 可理解的指令描述。
  *
@@ -42,23 +50,24 @@ export function workflowToAiInstruction(workflow) {
 /** 把 Workflow 的输入定义转为 JSON Schema(供 AI 理解输入约束) */
 function workflowInputsToJsonSchema(workflow) {
     const inputDef = workflow.inputs;
-    const schema = {
-        type: 'object',
-        properties: {
-            input_path: {
-                type: 'string',
-                description: `Path or asset ID of the input ${inputDef.type} file${inputDef.multiple ? '(s)' : ''}`,
-            },
+    // properties 单独声明为 Record<string, unknown>,动态修改 input_path 时无需强转
+    const properties = {
+        input_path: {
+            type: 'string',
+            description: `Path or asset ID of the input ${inputDef.type} file${inputDef.multiple ? '(s)' : ''}`,
         },
-        required: ['input_path'],
     };
     if (inputDef.multiple) {
-        schema.properties.input_path = {
+        properties.input_path = {
             type: 'array',
             items: { type: 'string' },
             description: `List of input ${inputDef.type} file paths${inputDef.maxCount ? ` (max ${inputDef.maxCount})` : ''}`,
         };
     }
-    return schema;
+    return {
+        type: 'object',
+        properties,
+        required: ['input_path'],
+    };
 }
 //# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwKH;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,gBAAgB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAE/E,kCAAkC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,8CAA8C;IAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IAEtE,OAAO;QACL,WAAW,EACT,WAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,mBAAmB,QAAQ,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC3F,YAAY;QACZ,WAAW,EAAE,0BAA0B,CAAC,QAAQ,CAAC;QACjD,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,UAAU,EAAE,kBAAkB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;YAC/D,cAAc,EAAE,aAAa,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,YAAY,EAAE;SAC7E;KACF,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,SAAS,0BAA0B,CAAC,QAAkB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjC,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC,QAAQ,CAAC,IAAI,QAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;aACpG;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB,CAAC;IACF,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,UAAsC,CAAC,UAAU,GAAG;YAC1D,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,iBAAiB,QAAQ,CAAC,IAAI,cAAc,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SAClH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAmKpC;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,gBAAgB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAE/E,kCAAkC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,8CAA8C;IAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IAEtE,OAAO;QACL,WAAW,EACT,WAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,mBAAmB,QAAQ,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC3F,YAAY;QACZ,WAAW,EAAE,0BAA0B,CAAC,QAAQ,CAAC;QACjD,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,UAAU,EAAE,kBAAkB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;YAC/D,cAAc,EAAE,aAAa,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,YAAY,EAAE;SAC7E;KACF,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,SAAS,0BAA0B,CAAC,QAAkB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjC,iEAAiE;IACjE,MAAM,UAAU,GAA4B;QAC1C,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iCAAiC,QAAQ,CAAC,IAAI,QAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;SACpG;KACF,CAAC;IACF,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,UAAU,CAAC,UAAU,GAAG;YACtB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,iBAAiB,QAAQ,CAAC,IAAI,cAAc,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SAClH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokvis/schema",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Lokvis Schema - Workflow / Asset / Plugin type definitions and validators",
   "license": "MIT",
   "type": "module",

package/src/capability-names.generated.ts

@@ -1,7 +1,7 @@
 /**
  * AUTO-GENERATED BY scripts/codegen-capabilities.ts — DO NOT EDIT.
  *
- * 来源:packages/capability/manifests/ai.manifest.json, packages/capability/manifests/audio.manifest.json, packages/capability/manifests/image.manifest.json, packages/capability/manifests/pdf.manifest.json, packages/capability/manifests/video.manifest.json
+ * 来源:packages/capability/manifests/ai.manifest.json, packages/capability/manifests/audio.manifest.json, packages/capability/manifests/developer.manifest.json, packages/capability/manifests/image.manifest.json, packages/capability/manifests/pdf.manifest.json, packages/capability/manifests/video.manifest.json
  * 重跑:pnpm codegen
  *
  * 此文件提供精确字面量联合类型 BuiltinCapabilityName,
@@ -19,11 +19,15 @@ export type BuiltinCapabilityName =
   | 'ai.background-remove'
   | 'ai.generate-workflow'
   | 'ai.optimize-workflow'
+  | 'ai.diagnose-error'
   | 'audio.trim'
   | 'audio.normalize'
   | 'audio.merge'
   | 'audio.transcode'
-  | 'audio.denoise'
+  | 'developer.inspect.capabilities'
+  | 'developer.inspect.asset'
+  | 'developer.validate.workflow'
+  | 'developer.profile'
   | 'image.resize'
   | 'image.compress'
   | 'image.convert'
@@ -40,7 +44,6 @@ export type BuiltinCapabilityName =
   | 'pdf.watermark'
   | 'pdf.ocr'
   | 'pdf.sign'
-  | 'pdf.add-page-numbers'
   | 'video.compress'
   | 'video.transcode'
   | 'video.trim'
@@ -56,11 +59,15 @@ export const BUILTIN_CAPABILITY_NAMES: readonly BuiltinCapabilityName[] = [
   'ai.background-remove',
   'ai.generate-workflow',
   'ai.optimize-workflow',
+  'ai.diagnose-error',
   'audio.trim',
   'audio.normalize',
   'audio.merge',
   'audio.transcode',
-  'audio.denoise',
+  'developer.inspect.capabilities',
+  'developer.inspect.asset',
+  'developer.validate.workflow',
+  'developer.profile',
   'image.resize',
   'image.compress',
   'image.convert',
@@ -77,7 +84,6 @@ export const BUILTIN_CAPABILITY_NAMES: readonly BuiltinCapabilityName[] = [
   'pdf.watermark',
   'pdf.ocr',
   'pdf.sign',
-  'pdf.add-page-numbers',
   'video.compress',
   'video.transcode',
   'video.trim',

package/src/index.ts

@@ -12,6 +12,8 @@ export * from './workflow.js';
 export * from './event.js';
 export * from './plugin.js';
 export * from './exif.js';
+// 跨层共享的资产元数据查询类型(ImageMetadata / PdfInfo,见 metadata.ts)
+export * from './metadata.js';
 // MCP manifest 类型(见 docs/AI生态冲击调整方案.md §6.1)
 export * from './mcp.js';
 

package/src/metadata.ts

@@ -0,0 +1,58 @@
+/**
+ * 跨层共享的资产元数据查询类型。
+ *
+ * 与 ExifData 同一设计层级:某些 Plugin 能力本质是"元数据查询"而非
+ * "资产变换"(如 image dimensions 读取、pdf 页数读取),既不符合 Engine
+ * 层 Blob↔Blob 纯函数约束,也不符合 Capability Asset[]→Asset[] 契约。
+ * 这类能力通过 MetadataReader 注册,返回值类型定义在此处,
+ * 供 Runtime / SDK / 上层消费者(mcp-server 等)共享,避免跨层依赖。
+ *
+ * 与 AssetMetadata 的区别:
+ * - AssetMetadata:导入时一次性提取的通用元数据(size/mimeType/format/
+ *   dimensions/duration/pages),所有 asset 都有
+ * - ImageMetadata / PdfInfo:按需查询的领域特定元数据,由 Plugin 通过
+ *   MetadataReader 提供(如 image 经 sharp 解码读尺寸、pdf 经 pdf-lib
+ *   读页数),用于处理后输出资产的精确元数据报告
+ */
+
+/**
+ * 图像元数据(width/height/format)。
+ *
+ * 由 plugin-image 的 `image.read-metadata` MetadataReader 提供,
+ * 内部调用 engine-image/node 的 getMetadata(sharp .metadata())。
+ * 与 engine-image/node 的 ImageMetadata 接口对齐(此处为共享类型源,
+ * engine-image 改为 re-export 本类型)。
+ */
+export interface ImageMetadata {
+  width: number;
+  height: number;
+  format: string;
+}
+
+/**
+ * PDF 基本信息(页数)。
+ *
+ * 由 plugin-pdf 的 `pdf.read-info` MetadataReader 提供,
+ * 内部调用 engine-pdf 的 getPdfInfo(pdf-lib getPageCount)。
+ * 与 engine-pdf 的 PdfInfo 接口对齐(此处为共享类型源,
+ * engine-pdf 改为 re-export 本类型)。
+ */
+export interface PdfInfo {
+  pages: number;
+}
+
+/**
+ * 视频基本信息(分辨率/时长/帧率/编解码)。
+ *
+ * 由 plugin-video/node 的 `video.read-info` MetadataReader 提供,
+ * 内部调用 engine-video/node 的 getVideoInfo(ffprobe 解析)。
+ * 与 engine-video 的 VideoInfo 接口对齐(此处为共享类型源,
+ * engine-video 改为 re-export 本类型)。
+ */
+export interface VideoInfo {
+  width: number;
+  height: number;
+  duration: number;
+  fps: number;
+  codec: string;
+}

package/src/plugin.ts

@@ -48,6 +48,35 @@ export interface PluginConfig {
   permissions?: PluginPermission[];
 }
 
+/**
+ * Plugin 权限沙箱契约(由 runtime 实现)。
+ *
+ * Plugin 通过 `ctx.sandbox` 访问自身权限声明,在调用受限 API 前主动断言:
+ *   ctx.sandbox.assertNetworkAllowed('loading model manifest');
+ * 若声明 network:none,断言立即抛 PluginPermissionError;否则 no-op。
+ *
+ * 实现见 @lokvis/runtime 的 PluginPermissionSandbox 类。schema 仅定义契约
+ * (依赖反转:runtime 依赖 schema,而非反之)。
+ */
+export interface PluginPermissionSandbox {
+  /** 插件名(便于错误信息定位) */
+  readonly pluginName: string;
+  /** 声明的权限集合(只读) */
+  readonly declared: ReadonlySet<PluginPermission>;
+  /** 是否声明了指定权限 */
+  has(perm: PluginPermission): boolean;
+  /**
+   * 断言网络调用允许(声明 network:none 时抛错)。
+   * Plugin 在调用 fetch / XHR 等前可主动调用。
+   */
+  assertNetworkAllowed(reason: string): void;
+  /**
+   * 断言文件系统访问允许(声明未含对应 filesystem:* 时抛错)。
+   * @param scope 'opfs'(OPFS 根目录)或 'local'(任意本地文件系统)
+   */
+  assertFilesystemAllowed(scope: 'opfs' | 'local', reason: string): void;
+}
+
 /** Panel 定义（UI 扩展点） */
 export interface PanelDefinition {
   id: string;
@@ -64,7 +93,7 @@ export interface PanelDefinition {
  * 元数据读取函数(依赖反转)。
  *
  * 某些 Plugin 能力本质是"元数据查询"而非"资产变换"(如 EXIF 读取:
- * Blob → ExifData),既不符合 Engine 层 Blob↔Blob 约束,也不符合
+ * Blob → ExifData),既不符合 Engine 层 Blob↔Blob 纯函数约束,也不符合
  * CapabilityImplementation 的 Asset[]→Asset[] 契约。这类能力通过
  * MetadataReader 注册:Plugin 提供读取函数,Runtime 持有引用并按名调用。
  *
@@ -78,12 +107,33 @@ export interface PanelDefinition {
  * - 类型直接透传(ExifData),无需序列化
  *
  * @param asset 输入资产
+ * @param ctx 读取上下文(提供 log 可观测信号;TD-3.4 长期方案)
  * @returns 读取结果;无数据 / 解析失败返回 null
  */
 export type MetadataReader<T = unknown> = (
-  asset: import('./asset.js').Asset
+  asset: import('./asset.js').Asset,
+  ctx: MetadataReaderContext
 ) => Promise<T | null>;
 
+/**
+ * 元数据读取上下文(TD-3.4 长期方案)。
+ *
+ * 为 MetadataReader 提供可观测信号,使其能区分"无数据"(返回 null)
+ * 与"解析异常"(log warn 后返回 null),避免静默吞错。
+ *
+ * 与 ExecutionContext 的关系:
+ * - ExecutionContext 用于 Capability execute,含 workflowId / nodeId /
+ *   signal / onProgress(走 WorkflowExecutor)
+ * - MetadataReaderContext 用于 MetadataReader,只含 log(走 Runtime
+ *   直接调用,无 workflow 上下文)
+ *
+ * log 签名与 ExecutionContext.log 一致,便于 Plugin 复用日志逻辑。
+ */
+export interface MetadataReaderContext {
+  /** 日志函数(与 ExecutionContext.log 一致签名) */
+  log: (level: 'info' | 'warn' | 'error', message: string) => void;
+}
+
 /**
  * Plugin 上下文（Plugin 能访问的全部 API）
  *
@@ -129,6 +179,18 @@ export interface PluginContext {
   registerMetadataReader<T>(name: string, reader: MetadataReader<T>): void;
   /** 注册 UI Panel */
   registerPanel(panel: PanelDefinition): void;
+  /**
+   * 权限沙箱(W18.6)。
+   *
+   * Plugin 据此在调用受限 API 前主动断言:
+   *   ctx.sandbox.assertNetworkAllowed('loading manifest');
+   *
+   * Runtime 在 installPlugin() 期间应用 network guard
+   * (monkey-patch fetch/XHR/WebSocket/EventSource),声明
+   * network:none 时这些 API 调用立即抛 NetworkGuardError。
+   * capability execute() 路径不自动应用守卫 —— plugin 应主动自检。
+   */
+  readonly sandbox: PluginPermissionSandbox;
   /** 日志 */
   log(level: 'info' | 'warn' | 'error', message: string): void;
 }

package/src/workflow.ts

@@ -10,6 +10,15 @@ import type { AssetType } from './asset.js';
 /** Workflow 节点类型 */
 export type NodeType = 'load' | 'transform' | 'export';
 
+/**
+ * 工作流最大节点数(M1 MVP 约束)。
+ *
+ * 定义在 schema 层(与 validateWorkflow 的 maxSteps option 同源),
+ * 供 @lokvis/workflow(WorkflowBuilder)与 @lokvis/runtime(WorkflowCoordinator)
+ * 共同消费,避免常量跨包分裂。
+ */
+export const MAX_WORKFLOW_STEPS = 5;
+
 /** Workflow 节点定义 */
 export interface WorkflowNode {
   /** 节点唯一 ID */
@@ -214,22 +223,23 @@ export function workflowToAiInstruction(workflow: Workflow): WorkflowAiInstructi
 /** 把 Workflow 的输入定义转为 JSON Schema(供 AI 理解输入约束) */
 function workflowInputsToJsonSchema(workflow: Workflow): object {
   const inputDef = workflow.inputs;
-  const schema: Record<string, unknown> = {
-    type: 'object',
-    properties: {
-      input_path: {
-        type: 'string',
-        description: `Path or asset ID of the input ${inputDef.type} file${inputDef.multiple ? '(s)' : ''}`,
-      },
+  // properties 单独声明为 Record<string, unknown>,动态修改 input_path 时无需强转
+  const properties: Record<string, unknown> = {
+    input_path: {
+      type: 'string',
+      description: `Path or asset ID of the input ${inputDef.type} file${inputDef.multiple ? '(s)' : ''}`,
     },
-    required: ['input_path'],
   };
   if (inputDef.multiple) {
-    (schema.properties as Record<string, unknown>).input_path = {
+    properties.input_path = {
       type: 'array',
       items: { type: 'string' },
       description: `List of input ${inputDef.type} file paths${inputDef.maxCount ? ` (max ${inputDef.maxCount})` : ''}`,
     };
   }
-  return schema;
+  return {
+    type: 'object',
+    properties,
+    required: ['input_path'],
+  };
 }