@lokvis/schema 0.1.0

package/dist/validators.d.ts

@@ -0,0 +1,393 @@
+/**
+ * Lokvis Schema Zod Validators
+ *
+ * 提供 Workflow / Asset / Plugin 的运行时校验。
+ */
+import { z } from 'zod';
+export declare const assetTypeSchema: z.ZodEnum<["image", "video", "audio", "pdf", "text", "data", "unknown"]>;
+export declare const assetMetadataSchema: z.ZodObject<{
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    dimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    pages: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mimeType: string;
+    size: number;
+    format: string;
+    dimensions?: {
+        width: number;
+        height: number;
+    } | undefined;
+    duration?: number | undefined;
+    pages?: number | undefined;
+}, {
+    mimeType: string;
+    size: number;
+    format: string;
+    dimensions?: {
+        width: number;
+        height: number;
+    } | undefined;
+    duration?: number | undefined;
+    pages?: number | undefined;
+}>;
+export declare const workflowNodeSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["load", "transform", "export"]>;
+    capability: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "load" | "transform" | "export";
+    id: string;
+    params?: Record<string, unknown> | undefined;
+    capability?: string | undefined;
+    label?: string | undefined;
+}, {
+    type: "load" | "transform" | "export";
+    id: string;
+    params?: Record<string, unknown> | undefined;
+    capability?: string | undefined;
+    label?: string | undefined;
+}>, {
+    type: "load" | "transform" | "export";
+    id: string;
+    params?: Record<string, unknown> | undefined;
+    capability?: string | undefined;
+    label?: string | undefined;
+}, {
+    type: "load" | "transform" | "export";
+    id: string;
+    params?: Record<string, unknown> | undefined;
+    capability?: string | undefined;
+    label?: string | undefined;
+}>;
+export declare const workflowEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+}, {
+    from: string;
+    to: string;
+}>;
+export declare const workflowSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    version: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+    }, {
+        id: string;
+        name: string;
+    }>;
+    category: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    nodes: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<["load", "transform", "export"]>;
+        capability: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }, {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }>, {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }, {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>, "many">;
+    inputs: z.ZodObject<{
+        type: z.ZodEnum<["image", "video", "audio", "pdf", "text", "data", "unknown"]>;
+        multiple: z.ZodBoolean;
+        maxCount: z.ZodOptional<z.ZodNumber>;
+        accept: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    }, {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    }>;
+    outputs: z.ZodObject<{
+        type: z.ZodEnum<["image", "video", "audio", "pdf", "text", "data", "unknown", "archive"]>;
+        format: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    }, {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    }>;
+    official: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    author: {
+        id: string;
+        name: string;
+    };
+    category: string;
+    tags: string[];
+    nodes: {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+    }[];
+    inputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    };
+    outputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    };
+    $schema?: string | undefined;
+    official?: boolean | undefined;
+    createdAt?: number | undefined;
+    updatedAt?: number | undefined;
+}, {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    author: {
+        id: string;
+        name: string;
+    };
+    category: string;
+    tags: string[];
+    nodes: {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+    }[];
+    inputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    };
+    outputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    };
+    $schema?: string | undefined;
+    official?: boolean | undefined;
+    createdAt?: number | undefined;
+    updatedAt?: number | undefined;
+}>;
+export declare const pluginManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodString;
+    license: z.ZodString;
+    main: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+    engines: z.ZodObject<{
+        'lokvis-runtime': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'lokvis-runtime': string;
+    }, {
+        'lokvis-runtime': string;
+    }>;
+    permissions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    name: string;
+    description: string;
+    author: string;
+    license: string;
+    main: string;
+    capabilities: string[];
+    engines: {
+        'lokvis-runtime': string;
+    };
+    permissions: string[];
+    icon?: string | undefined;
+}, {
+    version: string;
+    name: string;
+    description: string;
+    author: string;
+    license: string;
+    main: string;
+    capabilities: string[];
+    engines: {
+        'lokvis-runtime': string;
+    };
+    permissions: string[];
+    icon?: string | undefined;
+}>;
+/** 校验 Workflow JSON */
+export declare function validateWorkflow(data: unknown): z.SafeParseReturnType<{
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    author: {
+        id: string;
+        name: string;
+    };
+    category: string;
+    tags: string[];
+    nodes: {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+    }[];
+    inputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    };
+    outputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    };
+    $schema?: string | undefined;
+    official?: boolean | undefined;
+    createdAt?: number | undefined;
+    updatedAt?: number | undefined;
+}, {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    author: {
+        id: string;
+        name: string;
+    };
+    category: string;
+    tags: string[];
+    nodes: {
+        type: "load" | "transform" | "export";
+        id: string;
+        params?: Record<string, unknown> | undefined;
+        capability?: string | undefined;
+        label?: string | undefined;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+    }[];
+    inputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown";
+        multiple: boolean;
+        maxCount?: number | undefined;
+        accept?: string[] | undefined;
+    };
+    outputs: {
+        type: "image" | "video" | "audio" | "pdf" | "text" | "data" | "unknown" | "archive";
+        format?: string | undefined;
+    };
+    $schema?: string | undefined;
+    official?: boolean | undefined;
+    createdAt?: number | undefined;
+    updatedAt?: number | undefined;
+}>;
+/** 校验 Plugin Manifest */
+export declare function validatePluginManifest(data: unknown): z.SafeParseReturnType<{
+    version: string;
+    name: string;
+    description: string;
+    author: string;
+    license: string;
+    main: string;
+    capabilities: string[];
+    engines: {
+        'lokvis-runtime': string;
+    };
+    permissions: string[];
+    icon?: string | undefined;
+}, {
+    version: string;
+    name: string;
+    description: string;
+    author: string;
+    license: string;
+    main: string;
+    capabilities: string[];
+    engines: {
+        'lokvis-runtime': string;
+    };
+    permissions: string[];
+    icon?: string | undefined;
+}>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe,0EAQ1B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU9B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,uBAAuB;AACvB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE7C;AAED,yBAAyB;AACzB,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;GAEnD"}

package/dist/validators.js

@@ -0,0 +1,83 @@
+/**
+ * Lokvis Schema Zod Validators
+ *
+ * 提供 Workflow / Asset / Plugin 的运行时校验。
+ */
+import { z } from 'zod';
+export const assetTypeSchema = z.enum([
+    'image',
+    'video',
+    'audio',
+    'pdf',
+    'text',
+    'data',
+    'unknown',
+]);
+export const assetMetadataSchema = z.object({
+    mimeType: z.string(),
+    size: z.number().nonnegative(),
+    dimensions: z
+        .object({ width: z.number().positive(), height: z.number().positive() })
+        .optional(),
+    duration: z.number().nonnegative().optional(),
+    pages: z.number().int().positive().optional(),
+    format: z.string(),
+});
+export const workflowNodeSchema = z.object({
+    id: z.string(),
+    type: z.enum(['load', 'transform', 'export']),
+    // capability 仅 transform 节点必填;load/export 可不填
+    capability: z.string().optional(),
+    params: z.record(z.unknown()).optional(),
+    label: z.string().optional(),
+}).refine((node) => node.type !== 'transform' || (typeof node.capability === 'string' && node.capability.length > 0), { message: 'transform 节点必须指定 capability' });
+export const workflowEdgeSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+});
+export const workflowSchema = z.object({
+    $schema: z.string().optional(),
+    id: z.string(),
+    version: z.string(),
+    name: z.string(),
+    description: z.string(),
+    author: z.object({ id: z.string(), name: z.string() }),
+    category: z.string(),
+    tags: z.array(z.string()),
+    nodes: z.array(workflowNodeSchema),
+    edges: z.array(workflowEdgeSchema),
+    inputs: z.object({
+        type: assetTypeSchema,
+        multiple: z.boolean(),
+        maxCount: z.number().int().positive().optional(),
+        accept: z.array(z.string()).optional(),
+    }),
+    outputs: z.object({
+        type: z.enum(['image', 'video', 'audio', 'pdf', 'text', 'data', 'unknown', 'archive']),
+        format: z.string().optional(),
+    }),
+    official: z.boolean().optional(),
+    createdAt: z.number().optional(),
+    updatedAt: z.number().optional(),
+});
+export const pluginManifestSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    description: z.string(),
+    author: z.string(),
+    license: z.string(),
+    main: z.string(),
+    icon: z.string().optional(),
+    capabilities: z.array(z.string()),
+    engines: z.object({ 'lokvis-runtime': z.string() }),
+    permissions: z.array(z.string()),
+});
+/** 校验 Workflow JSON */
+export function validateWorkflow(data) {
+    return workflowSchema.safeParse(data);
+}
+/** 校验 Plugin Manifest */
+export function validatePluginManifest(data) {
+    return pluginManifestSchema.safeParse(data);
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/dist/workflow.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Lokvis Workflow Schema
+ *
+ * 第一年只支持 Linear Workflow（线性工作流）。
+ * 不支持：Branch / Loop / Condition / Parallel。
+ */
+import type { AssetType } from './asset.js';
+/** Workflow 节点类型 */
+export type NodeType = 'load' | 'transform' | 'export';
+/** Workflow 节点定义 */
+export interface WorkflowNode {
+    /** 节点唯一 ID */
+    id: string;
+    /** 节点类型 */
+    type: NodeType;
+    /**
+     * 引用的能力名，如 `image.resize`。
+     * 仅 `type === 'transform'` 时必填;load/export 节点可不填。
+     */
+    capability?: string;
+    /** 能力参数 */
+    params?: Record<string, unknown>;
+    /** 节点标签（UI 显示用） */
+    label?: string;
+}
+/** Workflow 边定义（第一年只支持线性链） */
+export interface WorkflowEdge {
+    from: string;
+    to: string;
+}
+/** Workflow 输入定义 */
+export interface WorkflowInput {
+    type: AssetType;
+    /** 是否允许多个输入 */
+    multiple: boolean;
+    /** 最大数量（multiple=true 时生效） */
+    maxCount?: number;
+    /** 文件类型过滤 */
+    accept?: string[];
+}
+/** Workflow 输出定义 */
+export interface WorkflowOutput {
+    type: AssetType | 'archive';
+    format?: string;
+}
+/** Workflow 作者信息 */
+export interface WorkflowAuthor {
+    id: string;
+    name: string;
+}
+/** Workflow 语义版本 */
+export interface WorkflowVersion {
+    /** semver 版本号 */
+    version: string;
+    /** Schema 版本 */
+    schemaVersion: string;
+    /** 兼容的最低 Runtime 版本 */
+    runtimeVersion: string;
+    changelog: string;
+    createdAt: number;
+    deprecated?: boolean;
+}
+/** Workflow 分类 */
+export type WorkflowCategory = 'image' | 'video' | 'audio' | 'pdf' | 'ai' | 'data' | 'developer' | 'ecommerce' | 'content-creation' | 'other';
+/** 完整 Workflow 定义 */
+export interface Workflow {
+    /** Schema URL */
+    $schema?: string;
+    /** Workflow 唯一 ID */
+    id: string;
+    /** 版本号 */
+    version: string;
+    /** 工作流名称 */
+    name: string;
+    /** 描述 */
+    description: string;
+    /** 作者 */
+    author: WorkflowAuthor;
+    /** 分类 */
+    category: WorkflowCategory;
+    /** 标签 */
+    tags: string[];
+    /** 节点列表 */
+    nodes: WorkflowNode[];
+    /** 边列表（线性链） */
+    edges: WorkflowEdge[];
+    /** 输入定义 */
+    inputs: WorkflowInput;
+    /** 输出定义 */
+    outputs: WorkflowOutput;
+    /** 是否为官方工作流 */
+    official?: boolean;
+    /** 创建时间 */
+    createdAt?: number;
+    /** 更新时间 */
+    updatedAt?: number;
+}
+/** Workflow 执行结果 */
+export interface WorkflowResult {
+    workflowId: string;
+    /** 输出 Asset ID 列表 */
+    outputs: import('./asset.js').AssetId[];
+    /** 执行耗时（毫秒） */
+    duration: number;
+    /** 执行状态 */
+    status: 'completed' | 'cancelled' | 'failed';
+    /** 错误信息（status=failed 时） */
+    error?: string;
+}
+/**
+ * Workflow 的 AI 指令描述(见 docs/AI生态冲击调整方案.md §7.2)。
+ * 把 Workflow JSON 转换为 AI Agent 可理解的指令格式,
+ * 供 MCP server 在 prompt 模板 / resource 中暴露给 AI 客户端。
+ */
+export interface WorkflowAiInstruction {
+    /** 人类可读的指令描述,如 "Execute 2-step workflow: image.resize with {...} → image.compress with {...}" */
+    instruction: string;
+    /** 涉及的 Lokvis capability 名(去重) */
+    capabilities: string[];
+    /** 输入参数 JSON Schema(描述 workflow 需要的输入) */
+    inputSchema: object;
+    /** 示例调用(供 AI 学习调用方式) */
+    example: {
+        input: Record<string, unknown>;
+        expectedOutput: string;
+    };
+}
+/**
+ * 把 Workflow 转换为 AI 可理解的指令描述。
+ *
+ * 注意:此函数仅做结构转换,不执行 workflow。
+ * AI 生成的 workflow 仍由确定性 Runtime 执行(见方案 §5.3 设计原则)。
+ *
+ * @param workflow 已定义的 Workflow
+ * @returns AI 指令描述,含人类可读指令、依赖能力、输入 schema、示例
+ */
+export declare function workflowToAiInstruction(workflow: Workflow): WorkflowAiInstruction;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -0,0 +1,64 @@
+/**
+ * Lokvis Workflow Schema
+ *
+ * 第一年只支持 Linear Workflow（线性工作流）。
+ * 不支持：Branch / Loop / Condition / Parallel。
+ */
+/**
+ * 把 Workflow 转换为 AI 可理解的指令描述。
+ *
+ * 注意:此函数仅做结构转换,不执行 workflow。
+ * AI 生成的 workflow 仍由确定性 Runtime 执行(见方案 §5.3 设计原则)。
+ *
+ * @param workflow 已定义的 Workflow
+ * @returns AI 指令描述,含人类可读指令、依赖能力、输入 schema、示例
+ */
+export function workflowToAiInstruction(workflow) {
+    const steps = workflow.nodes
+        .filter((n) => n.capability)
+        .map((n) => `${n.capability} with params ${JSON.stringify(n.params ?? {})}`);
+    // 从节点中收集依赖的 capability 名(去重,保留顺序)
+    const seen = new Set();
+    const capabilities = [];
+    for (const node of workflow.nodes) {
+        if (node.capability && !seen.has(node.capability)) {
+            seen.add(node.capability);
+            capabilities.push(node.capability);
+        }
+    }
+    // 期望输出反映 workflow 实际输出类型/格式(而非硬编码占位),
+    // 供 AI 理解调用后的产物。注意:此处仅描述,实际执行由确定性 Runtime 完成。
+    const outputFormat = workflow.outputs.format ?? workflow.outputs.type;
+    return {
+        instruction: `Execute ${workflow.nodes.length}-step workflow "${workflow.name}": ${steps.join(' → ')}`,
+        capabilities,
+        inputSchema: workflowInputsToJsonSchema(workflow),
+        example: {
+            input: { input_path: `/path/to/input.${workflow.inputs.type}` },
+            expectedOutput: `Processed ${workflow.inputs.type} saved as ${outputFormat}`,
+        },
+    };
+}
+/** 把 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)' : ''}`,
+            },
+        },
+        required: ['input_path'],
+    };
+    if (inputDef.multiple) {
+        schema.properties.input_path = {
+            type: 'array',
+            items: { type: 'string' },
+            description: `List of input ${inputDef.type} file paths${inputDef.maxCount ? ` (max ${inputDef.maxCount})` : ''}`,
+        };
+    }
+    return schema;
+}
+//# sourceMappingURL=workflow.js.map