@lokvis/schema 0.1.0 → 0.2.0

package/dist/validators.js

@@ -13,6 +13,30 @@ export const assetTypeSchema = z.enum([
     'data',
     'unknown',
 ]);
+/** W10: Workflow 分类枚举(与 WorkflowCategory 类型对齐) */
+export const workflowCategorySchema = z.enum([
+    'image',
+    'video',
+    'audio',
+    'pdf',
+    'ai',
+    'data',
+    'developer',
+    'ecommerce',
+    'content-creation',
+    'other',
+]);
+/** W10: Workflow 输出类型枚举(含 archive 用于打包下载场景) */
+export const workflowOutputTypeSchema = z.enum([
+    'image',
+    'video',
+    'audio',
+    'pdf',
+    'text',
+    'data',
+    'unknown',
+    'archive',
+]);
 export const assetMetadataSchema = z.object({
     mimeType: z.string(),
     size: z.number().nonnegative(),
@@ -42,7 +66,7 @@ export const workflowSchema = z.object({
     name: z.string(),
     description: z.string(),
     author: z.object({ id: z.string(), name: z.string() }),
-    category: z.string(),
+    category: workflowCategorySchema,
     tags: z.array(z.string()),
     nodes: z.array(workflowNodeSchema),
     edges: z.array(workflowEdgeSchema),
@@ -53,7 +77,7 @@ export const workflowSchema = z.object({
         accept: z.array(z.string()).optional(),
     }),
     outputs: z.object({
-        type: z.enum(['image', 'video', 'audio', 'pdf', 'text', 'data', 'unknown', 'archive']),
+        type: workflowOutputTypeSchema,
         format: z.string().optional(),
     }),
     official: z.boolean().optional(),
@@ -72,9 +96,193 @@ export const pluginManifestSchema = z.object({
     engines: z.object({ 'lokvis-runtime': z.string() }),
     permissions: z.array(z.string()),
 });
-/** 校验 Workflow JSON */
-export function validateWorkflow(data) {
-    return workflowSchema.safeParse(data);
+export function validateWorkflow(data, options) {
+    const parsed = workflowSchema.safeParse(data);
+    if (!parsed.success) {
+        return parsed;
+    }
+    const wf = parsed.data;
+    const errors = [];
+    // 0. W10.2: 节点数上限校验(可选)
+    if (options?.maxSteps !== undefined && wf.nodes.length > options.maxSteps) {
+        errors.push(`Workflow has ${wf.nodes.length} nodes, exceeds max ${options.maxSteps}.`);
+    }
+    // 1. 保留字哨兵：禁止 __input__ / __output__ 出现在 nodes 或 edges
+    //    （executor 不支持哨兵节点，输入资产注入到入度 0 的首节点）
+    const RESERVED_IDS = new Set(['__input__', '__output__', '__start__', '__end__']);
+    for (const node of wf.nodes) {
+        if (RESERVED_IDS.has(node.id)) {
+            errors.push(`Node id "${node.id}" is reserved; use a non-reserved id.`);
+        }
+    }
+    for (const edge of wf.edges) {
+        if (RESERVED_IDS.has(edge.from)) {
+            errors.push(`Edge from "${edge.from}" references a reserved sentinel id; ` +
+                `the executor injects input assets into the first in-degree-0 node, ` +
+                `no explicit __input__ edge is needed.`);
+        }
+        if (RESERVED_IDS.has(edge.to)) {
+            errors.push(`Edge to "${edge.to}" references a reserved sentinel id.`);
+        }
+    }
+    // 2. node id 唯一性
+    const seenIds = new Set();
+    for (const node of wf.nodes) {
+        if (seenIds.has(node.id)) {
+            errors.push(`Duplicate node id: "${node.id}".`);
+        }
+        seenIds.add(node.id);
+    }
+    // 3. edge.from / edge.to 必须引用已声明节点
+    const nodeIds = new Set(wf.nodes.map((n) => n.id));
+    for (const edge of wf.edges) {
+        if (!nodeIds.has(edge.from)) {
+            errors.push(`Edge from "${edge.from}" to "${edge.to}" references unknown source node "${edge.from}".`);
+        }
+        if (!nodeIds.has(edge.to)) {
+            errors.push(`Edge from "${edge.from}" to "${edge.to}" references unknown target node "${edge.to}".`);
+        }
+        if (edge.from === edge.to) {
+            errors.push(`Edge from "${edge.from}" to itself is a self-loop (cycle).`);
+        }
+    }
+    // 4. DAG 合法性：无环（拓扑排序能覆盖所有节点）
+    if (errors.length === 0) {
+        const inDegree = new Map();
+        const adjacency = new Map();
+        for (const node of wf.nodes) {
+            inDegree.set(node.id, 0);
+            adjacency.set(node.id, []);
+        }
+        for (const edge of wf.edges) {
+            inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1);
+            adjacency.get(edge.from)?.push(edge.to);
+        }
+        const queue = [];
+        for (const [id, deg] of inDegree) {
+            if (deg === 0)
+                queue.push(id);
+        }
+        let visited = 0;
+        while (queue.length > 0) {
+            const id = queue.shift();
+            // 循环条件 queue.length > 0 保证 shift 必返回元素;
+            // 显式检查以满足 noUncheckedIndexedAccess,并在不变量被打破时跳出
+            if (id === undefined)
+                break;
+            visited++;
+            for (const next of adjacency.get(id) ?? []) {
+                const newDeg = (inDegree.get(next) ?? 0) - 1;
+                inDegree.set(next, newDeg);
+                if (newDeg === 0)
+                    queue.push(next);
+            }
+        }
+        if (visited !== wf.nodes.length) {
+            errors.push(`Workflow contains a cycle: only ${visited}/${wf.nodes.length} nodes are reachable.`);
+        }
+    }
+    // 5. W10.2: capability 兼容性校验(可选,仅在 resolveCapability 提供时)
+    //    检查相邻节点(通过 edge 连接)的 outputTypes 与下一节点的 inputTypes 是否有交集。
+    //    - 线性链:edge.from → edge.to,from 节点的 outputTypes 与 to 节点的 inputTypes 交集为空则报错
+    //    - 输入节点(入度 0)的 inputTypes 与 workflow.inputs.type 兼容性
+    //    - 输出节点(出度 0)的 outputTypes 与 workflow.outputs.type 兼容性
+    if (options?.resolveCapability && errors.length === 0) {
+        validateCapabilityCompatibility(wf, options.resolveCapability, errors);
+    }
+    if (errors.length > 0) {
+        return {
+            success: false,
+            error: {
+                issues: errors.map((message) => ({
+                    code: 'custom',
+                    message,
+                    path: [],
+                })),
+            },
+        };
+    }
+    return { success: true, data: wf };
+}
+/** W10.2: capability 兼容性校验内部实现 */
+function validateCapabilityCompatibility(wf, resolveCapability, errors) {
+    // 计算每个节点的入度/出度,识别输入/输出节点
+    const inDegree = new Map();
+    const outDegree = new Map();
+    for (const node of wf.nodes) {
+        inDegree.set(node.id, 0);
+        outDegree.set(node.id, 0);
+    }
+    for (const edge of wf.edges) {
+        inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1);
+        outDegree.set(edge.from, (outDegree.get(edge.from) ?? 0) + 1);
+    }
+    // 缓存每个节点的 capability 声明
+    const capCache = new Map();
+    const getCap = (node) => {
+        if (!node.capability)
+            return undefined;
+        if (capCache.has(node.capability))
+            return capCache.get(node.capability);
+        const cap = resolveCapability(node.capability);
+        capCache.set(node.capability, cap);
+        return cap;
+    };
+    // 5a. 输入节点(入度 0)的 inputTypes 与 workflow.inputs.type 兼容
+    for (const node of wf.nodes) {
+        if ((inDegree.get(node.id) ?? 0) > 0)
+            continue;
+        const cap = getCap(node);
+        // 未注册的 capability 不静默跳过:在 schema 层显式报错,避免用户得到"校验通过"
+        // 的假象,运行时才报错。resolveCapability 未提供时(getCap 始终返回 undefined)
+        // 整个 capability 兼容性校验跳过(向后兼容,见 5d 兜底)。
+        if (!cap) {
+            if (node.capability) {
+                errors.push(`Node "${node.id}" references unknown capability "${node.capability}". ` +
+                    `Capability is not registered in the registry.`);
+            }
+            continue;
+        }
+        const inputTypeMatches = cap.inputTypes.includes(wf.inputs.type);
+        if (!inputTypeMatches) {
+            errors.push(`Node "${node.id}" (capability "${node.capability}") expects input types ` +
+                `[${cap.inputTypes.join(', ')}], but workflow input is "${wf.inputs.type}".`);
+        }
+    }
+    // 5b. 相邻节点:from 的 outputTypes 与 to 的 inputTypes 必须有交集
+    for (const edge of wf.edges) {
+        const fromNode = wf.nodes.find((n) => n.id === edge.from);
+        const toNode = wf.nodes.find((n) => n.id === edge.to);
+        if (!fromNode || !toNode)
+            continue;
+        const fromCap = getCap(fromNode);
+        const toCap = getCap(toNode);
+        if (!fromCap || !toCap)
+            continue; // 5a 已报告未注册 capability,此处不重复
+        const compatible = fromCap.outputTypes.some((t) => toCap.inputTypes.includes(t));
+        if (!compatible) {
+            errors.push(`Capability mismatch on edge "${edge.from}" → "${edge.to}": ` +
+                `"${fromNode.capability}" outputs [${fromCap.outputTypes.join(', ')}], ` +
+                `but "${toNode.capability}" accepts [${toCap.inputTypes.join(', ')}].`);
+        }
+    }
+    // 5c. 输出节点(出度 0)的 outputTypes 与 workflow.outputs.type 兼容
+    //     (archive 类型输出允许任意类型,用于打包下载场景)
+    for (const node of wf.nodes) {
+        if ((outDegree.get(node.id) ?? 0) > 0)
+            continue;
+        const cap = getCap(node);
+        if (!cap)
+            continue; // 5a 已报告未注册 capability,此处不重复
+        const outputType = wf.outputs.type;
+        if (outputType === 'archive')
+            continue;
+        const outputTypeMatches = cap.outputTypes.includes(outputType);
+        if (!outputTypeMatches) {
+            errors.push(`Node "${node.id}" (capability "${node.capability}") produces output types ` +
+                `[${cap.outputTypes.join(', ')}], but workflow output is "${outputType}".`);
+        }
+    }
 }
 /** 校验 Plugin Manifest */
 export function validatePluginManifest(data) {

package/dist/validators.js.map

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

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@lokvis/schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lokvis Schema - Workflow / Asset / Plugin type definitions and validators",
   "license": "MIT",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/capability.ts

@@ -83,6 +83,15 @@ export interface CapabilityImplementation {
   capability: CapabilityName;
   /** 实现该能力的引擎名 */
   engine: string;
+  /**
+   * 实现状态:
+   * - `'stable'`(默认):可正常执行
+   * - `'stub'`:占位实现,调用 execute 会抛出异常
+   *
+   * CapabilityRegistry.resolve() 会跳过 stub 实现,
+   * 避免运行时出现 "not implemented" 错误。
+   */
+  status?: 'stable' | 'stub';
   /**
    * 该引擎的性能等级(可选)。缺省时使用能力声明的 performance。
    * 用于 EngineSelectionStrategy('fastest'/'balanced')排序选择。

package/src/event.ts

@@ -8,6 +8,23 @@ import type { Asset, AssetId, AssetMetadata } from './asset.js';
 import type { Workflow, WorkflowResult } from './workflow.js';
 import type { HistoryEntry } from './asset.js';
 
+/** 批量项状态(对应 BatchProcessor 内部状态机) */
+export type BatchItemStatus =
+  | 'pending'
+  | 'processing'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
+
+/** 批量作业状态 */
+export type BatchJobStatus =
+  | 'queued'
+  | 'running'
+  | 'paused'
+  | 'completed'
+  | 'cancelled'
+  | 'failed';
+
 /** Lokvis 标准事件类型联合 */
 export type LokvisEvent =
   | { type: 'asset:imported'; assetId: AssetId; metadata: AssetMetadata }
@@ -39,9 +56,61 @@ export type LokvisEvent =
       format: string;
       size: number;
     }
-  | { type: 'history:changed'; workflowId: string; entries: HistoryEntry[] }
+  | {
+      type: 'history:changed';
+      workflowId: string;
+      entries: HistoryEntry[];
+      /** 当前游标(指向最后一条已应用的 entry;-1 表示无已应用条目) */
+      currentIndex: number;
+    }
   | { type: 'capability:registered'; capability: string; engine: string }
-  | { type: 'plugin:loaded'; name: string; version: string };
+  | { type: 'plugin:loaded'; name: string; version: string }
+  // ─── 批量作业事件(W6.3)─────────────────────────────────
+  | { type: 'batch:started'; jobId: string; total: number }
+  | {
+      type: 'batch:item:started';
+      jobId: string;
+      itemId: string;
+      index: number;
+      total: number;
+    }
+  | {
+      type: 'batch:item:finished';
+      jobId: string;
+      itemId: string;
+      index: number;
+      total: number;
+      outputAssetId: AssetId;
+      duration: number;
+    }
+  | {
+      type: 'batch:item:failed';
+      jobId: string;
+      itemId: string;
+      index: number;
+      total: number;
+      error: Error;
+      /** 已重试次数(达到 maxRetries 后才发 failed 事件) */
+      attempts: number;
+    }
+  | {
+      type: 'batch:progress';
+      jobId: string;
+      completed: number;
+      failed: number;
+      total: number;
+    }
+  | {
+      type: 'batch:completed';
+      jobId: string;
+      total: number;
+      completed: number;
+      failed: number;
+      duration: number;
+    }
+  | { type: 'batch:cancelled'; jobId: string; cancelled: number }
+  | { type: 'batch:paused'; jobId: string }
+  | { type: 'batch:resumed'; jobId: string };
 
 /** 所有事件类型字面量 */
 export type LokvisEventType = LokvisEvent['type'];

package/src/exif.ts

@@ -0,0 +1,90 @@
+/**
+ * EXIF 元数据类型与格式化(W7.3/7.4)
+ *
+ * 类型分两层:
+ * - `ExifData`:面向 UI / Runtime 的公共类型,只含结构化字段,**无 raw**
+ * - `RawExifData`:Plugin 内部类型,extends ExifData,额外含 `raw`(exifr 原始解析对象)
+ *
+ * 拆分原因(长期方案):UI 缓存 ExifData 时无需手动剔除 raw 字段,
+ * 避免每个消费者都要做 `{...data, raw: undefined}` 的 patch 操作。
+ * Plugin 在返回前把 RawExifData 收窄为 ExifData(丢弃 raw)。
+ */
+
+/**
+ * 面向 UI / Runtime 的 EXIF 结构化数据。
+ * 不含 raw 字段 —— raw 仅在 Plugin 内部用于调试 / 高级展示,
+ * 不会传递到 UI 层(避免大对象在缓存中累积)。
+ */
+export interface ExifData {
+  make?: string;
+  model?: string;
+  lensModel?: string;
+  dateTimeOriginal?: string;
+  iso?: number;
+  fNumber?: number;
+  exposureTime?: number;
+  focalLength?: number;
+  exposureCompensation?: number;
+  whiteBalance?: string;
+  gpsLatitude?: number;
+  gpsLongitude?: number;
+  gpsAltitude?: number;
+  orientation?: number;
+  software?: string;
+}
+
+/**
+ * Plugin 内部使用的完整 EXIF 数据,extends ExifData 并附加 raw 字段。
+ * raw 保留 exifr.parse 返回的原始对象,供调试或未来高级面板使用。
+ * Plugin 在通过 MetadataReader 返回给 Runtime 时,应丢弃 raw(收窄为 ExifData)。
+ */
+export interface RawExifData extends ExifData {
+  /** exifr.parse 返回的原始对象(未筛选) */
+  raw?: Record<string, unknown>;
+}
+
+/** EXIF 面板的单行展示数据 */
+export interface ExifRow {
+  label: string;
+  value: string;
+}
+
+/**
+ * 把 ExifData 格式化为 UI 展示用的行列表。
+ * 纯函数,放 schema 层供 UI 直接调用,避免 UI 跨层依赖 plugin / engine。
+ */
+export function formatExifRows(exif: ExifData): ExifRow[] {
+  const rows: ExifRow[] = [];
+  const push = (label: string, value: string | undefined): void => {
+    if (value !== undefined && value !== '') rows.push({ label, value });
+  };
+  push('Camera', exif.make && exif.model ? `${exif.make} ${exif.model}` : exif.make ?? exif.model);
+  push('Lens', exif.lensModel);
+  push('Date', exif.dateTimeOriginal);
+  push('ISO', exif.iso !== undefined ? `ISO ${exif.iso}` : undefined);
+  push('Aperture', exif.fNumber !== undefined ? `f/${exif.fNumber}` : undefined);
+  push('Shutter', exif.exposureTime !== undefined ? formatShutterSpeed(exif.exposureTime) : undefined);
+  push('Focal Length', exif.focalLength !== undefined ? `${exif.focalLength}mm` : undefined);
+  push('Exposure Comp.', exif.exposureCompensation !== undefined ? `${exif.exposureCompensation} EV` : undefined);
+  push('White Balance', exif.whiteBalance);
+  push('Software', exif.software);
+  if (exif.gpsLatitude !== undefined && exif.gpsLongitude !== undefined) {
+    push('GPS', `${exif.gpsLatitude.toFixed(6)}, ${exif.gpsLongitude.toFixed(6)}`);
+    if (exif.gpsAltitude !== undefined) {
+      push('GPS Altitude', `${exif.gpsAltitude.toFixed(1)} m`);
+    }
+  }
+  push('Orientation', exif.orientation !== undefined ? `${exif.orientation}` : undefined);
+  return rows;
+}
+
+/**
+ * 格式化快门速度:
+ * - >= 1s 直接显示秒数(如 "2s")
+ * - < 1s 转为分数(如 1/250s)
+ */
+function formatShutterSpeed(seconds: number): string {
+  if (seconds >= 1) return `${seconds}s`;
+  const denominator = Math.round(1 / seconds);
+  return `1/${denominator}s`;
+}

package/src/index.ts

@@ -11,6 +11,7 @@ export * from './capability.js';
 export * from './workflow.js';
 export * from './event.js';
 export * from './plugin.js';
+export * from './exif.js';
 // MCP manifest 类型(见 docs/AI生态冲击调整方案.md §6.1)
 export * from './mcp.js';
 

package/src/plugin.ts

@@ -60,6 +60,30 @@ export interface PanelDefinition {
   show?: (context: { selectedAssets: string[] }) => boolean;
 }
 
+/**
+ * 元数据读取函数(依赖反转)。
+ *
+ * 某些 Plugin 能力本质是"元数据查询"而非"资产变换"(如 EXIF 读取:
+ * Blob → ExifData),既不符合 Engine 层 Blob↔Blob 约束,也不符合
+ * CapabilityImplementation 的 Asset[]→Asset[] 契约。这类能力通过
+ * MetadataReader 注册:Plugin 提供读取函数,Runtime 持有引用并按名调用。
+ *
+ * 与 registerCapability 的区别:
+ * - registerCapability:注册变换能力(Asset→Asset),走 WorkflowExecutor
+ * - registerMetadataReader:注册查询函数(Asset→T),走 Runtime 直接调用
+ *
+ * 优点(相对 Capability execute + data Asset 序列化方案):
+ * - 无需创建临时 data Asset(避免手动 removeAsset 清理 / 泄漏)
+ * - 无 JSON marshal/unmarshal 开销
+ * - 类型直接透传(ExifData),无需序列化
+ *
+ * @param asset 输入资产
+ * @returns 读取结果;无数据 / 解析失败返回 null
+ */
+export type MetadataReader<T = unknown> = (
+  asset: import('./asset.js').Asset
+) => Promise<T | null>;
+
 /**
  * Plugin 上下文（Plugin 能访问的全部 API）
  *
@@ -90,8 +114,19 @@ export interface PluginContext {
   };
   /** 事件总线 */
   eventBus: import('./event.js').EventBus;
-  /** 注册能力实现 */
+  /** 注册能力实现(变换:Asset→Asset) */
   registerCapability(impl: CapabilityImplementation): void;
+  /**
+   * 注册元数据读取函数(查询:Asset→T)。
+   *
+   * 用于非变换类能力(如 EXIF 读取)。Runtime 持有 reader 引用,
+   * UI 通过 runtime.readAssetExif(id) 间接调用,不直接依赖 Plugin / Engine。
+   * 同名 reader 重复注册时覆盖前者(支持热更新)。
+   *
+   * @param name 读取器名称,约定与能力名对齐(如 'image.read-exif')
+   * @param reader 读取函数
+   */
+  registerMetadataReader<T>(name: string, reader: MetadataReader<T>): void;
   /** 注册 UI Panel */
   registerPanel(panel: PanelDefinition): void;
   /** 日志 */