persona-core 1.0.0

package/dist/types/nodes.d.ts

@@ -0,0 +1,496 @@
+/**
+ * 节点类型定义
+ */
+import { ActionTypeId, NodeId, SharedDataDeclaration, NodeInputValue, OutputMapping } from './common.js';
+/**
+ * 动作执行类型枚举
+ * 系统内置，不可动态扩展
+ */
+export type ActionExecutionType = 'api_call' | 'file_write' | 'file_read' | 'database_query' | 'llm_call' | 'http_request' | 'shell_command';
+/**
+ * 输入/输出字段定义
+ */
+export interface FieldDefinition {
+    name: string;
+    description?: string;
+    required: boolean;
+    /**
+     * TypeScript 类型格式的类型描述
+     *
+     * 使用标准 TypeScript 类型语法：
+     * - 基础类型: "string", "number", "boolean"
+     * - 数组类型: "Array<T>" 或 "T[]"
+     * - 对象类型: "{ field1: Type1, field2: Type2 }"
+     * - 复合类型: "Array<{ title: string, url: string }>"
+     * - 可选字段: "{ required: string, optional?: number }"
+     *
+     * 示例：
+     * - "string"
+     * - "number"
+     * - "boolean"
+     * - "Array<{ title: string, link: string, snippet: string }>"
+     * - "{ name: string, count: number, items?: string[] }"
+     *
+     * 默认值: "string"
+     */
+    typeHint?: string;
+}
+/**
+ * 异步模式定义
+ */
+export interface AsyncModeConfig {
+    /** 是否为异步任务（需要轮询或等待回调） */
+    isAsync: boolean;
+    /** 默认轮询间隔（毫秒），如果是轮询模式 */
+    defaultCheckIntervalMs?: number;
+    /** 默认超时时间（毫秒） */
+    defaultTimeoutMs?: number;
+    /**
+     * 从提交任务响应中提取 taskId 的 JSONPath
+     * 支持点号分隔路径，如: "data.taskId" 或 "id"
+     * 默认为 "taskId"
+     */
+    taskIdPath?: string;
+    /**
+     * 任务状态检查配置
+     */
+    statusCheck?: AsyncStatusCheckConfig;
+    /**
+     * 任务结果获取配置
+     * 如果不配置，结果从最后一次成功的状态检查响应中提取
+     */
+    resultFetch?: AsyncResultFetchConfig;
+}
+/**
+ * 异步任务状态检查配置
+ */
+export interface AsyncStatusCheckConfig {
+    /**
+     * 状态检查的 URL 模板
+     * 支持变量替换：
+     * - ${taskId}: 任务 ID
+     * - ${inputFieldName}: 从提交时的输入中获取值
+     *
+     * 例如: "https://api.example.com/tasks/${taskId}/status"
+     * 例如: "https://api.example.com/v1/generations/${taskId}"
+     */
+    url: string;
+    /**
+     * HTTP 方法，默认 GET
+     */
+    method?: 'GET' | 'POST';
+    /**
+     * 额外的请求头（会与 apiConfig.headers 合并）
+     */
+    headers?: Record<string, string>;
+    /**
+     * 状态字段提取配置
+     */
+    extract: AsyncStatusExtractConfig;
+}
+/**
+ * 状态提取配置
+ */
+export interface AsyncStatusExtractConfig {
+    /**
+     * 状态值的 JSONPath
+     * 默认为 "status"
+     */
+    statusPath?: string;
+    /**
+     * 表示任务完成的状态值
+     * 可以是单个值或多个可能的值
+     * 默认为 "completed"
+     */
+    completedValues?: string | string[];
+    /**
+     * 表示任务失败的状态值
+     * 可以是单个值或多个可能的值
+     * 默认为 "failed"
+     */
+    failedValues?: string | string[];
+    /**
+     * 表示任务进行中的状态值（可选）
+     * 用于日志和调试
+     */
+    pendingValues?: string | string[];
+    /**
+     * 错误信息的 JSONPath
+     * 默认为 "error"
+     */
+    errorPath?: string;
+    /**
+     * 进度百分比的 JSONPath（可选）
+     * 用于报告进度
+     */
+    progressPath?: string;
+}
+/**
+ * 异步任务结果获取配置
+ */
+export interface AsyncResultFetchConfig {
+    /**
+     * 结果获取的 URL 模板
+     * 支持 ${taskId} 和 ${inputFieldName} 变量
+     *
+     * 如果不配置，使用状态检查的最后响应作为结果
+     */
+    url?: string;
+    /**
+     * HTTP 方法，默认 GET
+     */
+    method?: 'GET' | 'POST';
+    /**
+     * 额外的请求头
+     */
+    headers?: Record<string, string>;
+    /**
+     * 结果字段提取映射
+     * key: 输出字段名（对应 outputFields 中定义的字段）
+     * value: JSONPath 表达式
+     *
+     * 例如: { "videoUrl": "data.video.url", "duration": "data.video.duration" }
+     *
+     * 如果不配置，使用整个响应体作为 outputs
+     */
+    extract?: Record<string, string>;
+    /**
+     * 从状态检查响应中提取结果的配置
+     * 当 url 未配置时使用
+     * 表示直接从状态检查的响应中提取最终结果
+     */
+    extractFromStatus?: Record<string, string>;
+}
+/**
+ * HTTP 方法类型
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * API 调用配置
+ * 用于 api_call 类型的动作，定义 HTTP 请求的详细配置
+ */
+export interface ApiCallConfig {
+    /**
+     * API 端点 URL
+     * 支持模板变量，如: "https://api.example.com/users/${userId}"
+     * 模板变量从 inputFields 中解析
+     */
+    url: string;
+    /** HTTP 方法，默认为 GET */
+    method?: HttpMethod;
+    /**
+     * 请求头配置
+     * 定义如何构建 HTTP 请求头
+     */
+    headers?: {
+        /**
+         * 内容类型
+         * static: 使用固定的键值对
+         * template: 使用 Nunjucks 模板
+         */
+        type: 'static' | 'template';
+        /**
+         * 静态请求头值
+         * 当 type 为 'static' 时使用
+         */
+        values?: Record<string, string>;
+        /**
+         * 请求头模板（使用 Nunjucks 模板引擎）
+         * 当 type 为 'template' 时使用
+         * 模板应返回一个 JSON 对象，键值对将作为 HTTP 请求头
+         *
+         * 例如:
+         * ```
+         * {
+         *   "Authorization": "Bearer {{ apiKey }}",
+         *   "X-Custom-Header": "{{ customValue }}"
+         * }
+         * ```
+         */
+        template?: string;
+        /**
+         * 基础请求头
+         * 无论 type 是什么，这些 headers 总是会被添加
+         * 优先级最低（会被 values 或 template 结果覆盖）
+         */
+        base?: Record<string, string>;
+    };
+    /**
+     * 静态 Cookies
+     * 可以在 Persona 定义时设置固定的 cookies
+     */
+    cookies?: Record<string, string>;
+    /**
+     * 请求体配置
+     * 定义如何从 inputFields 构建请求体
+     */
+    body?: {
+        /**
+         * 内容类型
+         * json: 将 inputFields 序列化为 JSON
+         * form: 将 inputFields 序列化为 form-urlencoded
+         * raw: 使用指定字段的原始值
+         * template: 使用 JSON 模板，支持 ${fieldName} 变量替换
+         */
+        contentType: 'json' | 'form' | 'raw' | 'template';
+        /**
+         * 如果 contentType 为 raw，指定使用哪个输入字段作为请求体
+         */
+        rawField?: string;
+        /**
+         * 如果 contentType 为 template，定义 JSON 模板字符串
+         * 支持 ${fieldName} 格式的变量替换
+         * 例如: '{"model": "gpt-4", "prompt": "${userPrompt}"}'
+         * 变量值将被 JSON 安全转义
+         */
+        template?: string;
+        /**
+         * 要包含在请求体中的输入字段名列表
+         * 如果不指定，将使用所有 inputFields
+         */
+        includeFields?: string[];
+        /**
+         * 要从请求体中排除的输入字段名列表
+         */
+        excludeFields?: string[];
+    };
+    /**
+     * 响应配置
+     */
+    response?: {
+        /**
+         * 期望的响应类型
+         * json: 解析为 JSON 对象
+         * text: 返回原始文本
+         * binary: 返回二进制数据
+         */
+        type?: 'json' | 'text' | 'binary';
+        /**
+         * 从响应中提取特定字段的映射
+         * 例如: { "items": "data.results", "total": "meta.total" }
+         * 使用 JSONPath 风格的表达式
+         */
+        extract?: Record<string, string>;
+        /**
+         * 大数据保存到文件配置
+         * 用于处理图片、视频等大型响应数据，避免超出 Temporal payload 限制
+         */
+        saveToFile?: {
+            /** 是否启用保存到文件 */
+            enabled: boolean;
+            /**
+             * 从哪个输入字段获取保存路径
+             * 例如: "outputPath" 表示从 inputs.outputPath 获取文件路径
+             */
+            pathField: string;
+            /**
+             * 从响应中提取要保存数据的路径（JSONPath 风格）
+             * 例如: "choices[0].message.images[0].image_url"
+             * 如果不指定，则保存整个响应
+             */
+            dataPath?: string;
+            /**
+             * 输出字段名，用于返回保存后的文件路径
+             * 默认为 "filePath"
+             */
+            outputField?: string;
+            /**
+             * 数据格式，用于确定如何处理数据
+             * base64: base64 编码的数据（可能带有 data URI 前缀）
+             * binary: 二进制数据
+             * text: 文本数据
+             * json: JSON 数据（将格式化保存）
+             * 默认根据数据内容自动检测
+             */
+            dataFormat?: 'base64' | 'binary' | 'text' | 'json' | 'auto';
+        };
+    };
+    /**
+     * 超时时间（毫秒），默认 30000
+     */
+    timeoutMs?: number;
+    /**
+     * 是否跟随重定向，默认 true
+     */
+    followRedirects?: boolean;
+}
+/**
+ * 动作节点类型
+ * 由 Persona 提供，定义可执行的具体动作
+ */
+export interface ActionNodeType {
+    kind: 'action';
+    /** 动作类型唯一标识 */
+    id: ActionTypeId;
+    /** 语义名称，如 "搜索"、"回复帖子" */
+    name: string;
+    description?: string;
+    /** 执行类型 */
+    executionType: ActionExecutionType;
+    /**
+     * API 调用配置
+     * 仅当 executionType 为 'api_call' 时有效
+     */
+    apiConfig?: ApiCallConfig;
+    /** 异步模式配置 */
+    asyncMode?: AsyncModeConfig;
+    /** 输入字段定义 */
+    inputFields: FieldDefinition[];
+    /** 输出字段定义 */
+    outputFields: FieldDefinition[];
+}
+/**
+ * 思考节点类型
+ * 系统内置类型，不可自定义
+ */
+export interface ThinkingNodeType {
+    kind: 'thinking';
+}
+/**
+ * 分支决策类型
+ */
+export type BranchDecisionType = 'llm' | 'expression' | 'function';
+/**
+ * 分支节点类型
+ * 系统内置类型，不可自定义
+ */
+export interface BranchNodeType {
+    kind: 'branch';
+}
+/**
+ * 所有节点类型的联合类型
+ */
+export type NodeType = ThinkingNodeType | ActionNodeType | BranchNodeType;
+/**
+ * 节点实例基础接口
+ */
+interface NodeInstanceBase {
+    /** 节点实例唯一标识 */
+    id: NodeId;
+    /** 下一个节点的 ID，null 表示结束 */
+    nextNodeId: NodeId | null;
+}
+/**
+ * 思考节点实例
+ */
+export interface ThinkingNodeInstance extends NodeInstanceBase {
+    kind: 'thinking';
+    /** 思考的具体需求/提示 */
+    thinkingPrompt: string;
+    /**
+     * 共享数据声明
+     * 思考节点可以声明新的共享数据字段
+     */
+    sharedDataDeclaration?: SharedDataDeclaration;
+    /**
+     * 输入值映射：字段名 -> 输入值（固定值或引用）
+     * 允许思考节点读取 Shared Data 进行决策
+     */
+    inputs: Record<string, NodeInputValue>;
+    /**
+     * 输出映射配置
+     * 允许思考节点将分析结果写入 Shared Data
+     */
+    outputMappings?: OutputMapping[];
+}
+/**
+ * 动作节点实例
+ */
+export interface ActionNodeInstance extends NodeInstanceBase {
+    kind: 'action';
+    /** 引用的动作类型 ID */
+    actionTypeId: ActionTypeId;
+    /** 输入值映射：字段名 -> 输入值（固定值或引用） */
+    inputs: Record<string, NodeInputValue>;
+    /** 输出映射配置 */
+    outputMappings: OutputMapping[];
+    /** 重试配置 */
+    retryConfig?: RetryConfig;
+    /** 异步执行配置（覆盖类型定义中的默认值） */
+    asyncConfig?: {
+        timeoutMs?: number;
+        checkIntervalMs?: number;
+    };
+}
+/**
+ * 重试配置
+ */
+export interface RetryConfig {
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 重试间隔（毫秒） */
+    retryIntervalMs: number;
+    /** 是否使用指数退避 */
+    exponentialBackoff?: boolean;
+}
+/**
+ * 分支条件
+ */
+export interface BranchCondition {
+    /** 分支标识 */
+    branchId: string;
+    /** 分支名称 */
+    name: string;
+    /** 目标节点 ID */
+    targetNodeId: NodeId;
+}
+/**
+ * LLM 决策配置
+ */
+export interface LLMDecisionConfig {
+    type: 'llm';
+    /**
+     * 决策提示
+     * LLM 将根据 inputs 中的数据和此提示进行决策
+     */
+    prompt: string;
+}
+/**
+ * 表达式决策配置
+ */
+export interface ExpressionDecisionConfig {
+    type: 'expression';
+    /**
+     * 条件表达式映射：branchId -> 表达式
+     * 表达式可以引用 inputs 中的字段，如: "input.counter >= 10"
+     */
+    conditions: Record<string, string>;
+    /** 默认分支 ID，当所有条件都不满足时使用 */
+    defaultBranchId: string;
+}
+/**
+ * 函数决策配置
+ */
+export interface FunctionDecisionConfig {
+    type: 'function';
+    /**
+     * 函数名称，需要在运行时注册
+     * 函数将接收 inputs 作为参数
+     */
+    functionName: string;
+}
+/**
+ * 决策配置联合类型
+ */
+export type DecisionConfig = LLMDecisionConfig | ExpressionDecisionConfig | FunctionDecisionConfig;
+/**
+ * 分支节点实例
+ */
+export interface BranchNodeInstance extends NodeInstanceBase {
+    kind: 'branch';
+    /** 分支条件列表 */
+    branches: BranchCondition[];
+    /**
+     * 输入值映射
+     * 为决策逻辑提供数据上下文
+     */
+    inputs: Record<string, NodeInputValue>;
+    /** 决策配置 */
+    decisionConfig: DecisionConfig;
+}
+/**
+ * 所有节点实例的联合类型
+ */
+export type NodeInstance = ThinkingNodeInstance | ActionNodeInstance | BranchNodeInstance;
+export {};
+//# sourceMappingURL=nodes.d.ts.map

package/dist/types/nodes.d.ts.map

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

package/dist/types/nodes.js

@@ -0,0 +1,5 @@
+/**
+ * 节点类型定义
+ */
+export {};
+//# sourceMappingURL=nodes.js.map

package/dist/types/nodes.js.map

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

package/dist/types/persona.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Persona 数据结构定义
+ * Persona 代表一个人格/角色，为 Schedule 提供上下文和能力
+ */
+import { PersonaId } from './common.js';
+import { ActionNodeType } from './nodes.js';
+/**
+ * Persona 定义
+ *
+ * 功能：
+ * 1. 提供 System Prompt，定义角色的行为风格
+ * 2. 提供可用的动作节点类型，定义角色可以执行的动作
+ */
+export interface Persona {
+    /** Persona 唯一标识 */
+    id: PersonaId;
+    /** Persona 名称 */
+    name: string;
+    /** 描述 */
+    description?: string;
+    /**
+     * System Prompt
+     * 定义角色的基本行为和风格
+     * 例如："你是一个社交网络内容创作者，非常幽默"
+     */
+    systemPrompt: string;
+    /**
+     * 可用的动作节点类型列表
+     * 这些动作类型可以在 Schedule 中被使用
+     * 注意：思考节点和分支节点是系统内置的，不在这里定义
+     */
+    actionTypes: ActionNodeType[];
+    /** 创建时间 */
+    createdAt: Date;
+    /** 更新时间 */
+    updatedAt: Date;
+}
+/**
+ * 创建 Persona 的输入参数
+ */
+export interface CreatePersonaInput {
+    name: string;
+    description?: string;
+    systemPrompt: string;
+    actionTypes: ActionNodeType[];
+}
+/**
+ * 根据动作类型 ID 查找动作类型
+ */
+export declare function findActionType(persona: Persona, actionTypeId: string): ActionNodeType | undefined;
+/**
+ * 验证 Persona 的动作类型是否有效
+ * 检查是否有重复的 ID
+ */
+export declare function validatePersonaActionTypes(persona: Persona): {
+    isValid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=persona.d.ts.map

package/dist/types/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/types/persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,mBAAmB;IACnB,EAAE,EAAE,SAAS,CAAC;IAEd,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,WAAW,EAAE,cAAc,EAAE,CAAC;IAE9B,WAAW;IACX,SAAS,EAAE,IAAI,CAAC;IAEhB,WAAW;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAE5B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAuBA"}

package/dist/types/persona.js

@@ -0,0 +1,36 @@
+/**
+ * Persona 数据结构定义
+ * Persona 代表一个人格/角色，为 Schedule 提供上下文和能力
+ */
+/**
+ * 根据动作类型 ID 查找动作类型
+ */
+export function findActionType(persona, actionTypeId) {
+    return persona.actionTypes.find(at => at.id === actionTypeId);
+}
+/**
+ * 验证 Persona 的动作类型是否有效
+ * 检查是否有重复的 ID
+ */
+export function validatePersonaActionTypes(persona) {
+    const errors = [];
+    const idSet = new Set();
+    for (const actionType of persona.actionTypes) {
+        if (idSet.has(actionType.id)) {
+            errors.push(`重复的动作类型 ID: ${actionType.id}`);
+        }
+        idSet.add(actionType.id);
+        // 验证必填字段
+        if (!actionType.name) {
+            errors.push(`动作类型 ${actionType.id} 缺少名称`);
+        }
+        if (!actionType.executionType) {
+            errors.push(`动作类型 ${actionType.id} 缺少执行类型`);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=persona.js.map

package/dist/types/persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../src/types/persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqDH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,YAAoB;IAEpB,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IAIzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAEzB,SAAS;QACT,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,QAAQ,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM;KACP,CAAC;AACJ,CAAC"}