persona-core 1.0.0

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcxB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnB,CAAC;AAGH,MAAM,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,OAAO,QAAQ,CAAC,YAAY,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,OAAO,QAAQ,CAAC,YAAY,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,85 @@
+/**
+ * Drizzle ORM Schema 定义
+ * 用于 Schedule 的持久化存储
+ */
+import { pgTable, varchar, text, jsonb, timestamp, integer, index } from 'drizzle-orm/pg-core';
+/**
+ * Schedules 表
+ * 存储 Schedule 的基本信息和状态
+ */
+export const schedules = pgTable('schedules', {
+    id: varchar('id', { length: 64 }).primaryKey(),
+    personaId: varchar('persona_id', { length: 64 }).notNull(),
+    /** Persona 快照，启动时嵌入存储 */
+    persona: jsonb('persona').notNull(),
+    name: varchar('name', { length: 256 }).notNull(),
+    description: text('description'),
+    status: varchar('status', { length: 32 }).notNull().default('pending'),
+    entryNodeId: varchar('entry_node_id', { length: 64 }).notNull(),
+    currentNodeId: varchar('current_node_id', { length: 64 }),
+    sharedData: jsonb('shared_data'),
+    runtimeState: jsonb('runtime_state'),
+    executionSeq: integer('execution_seq').default(0),
+    createdAt: timestamp('created_at').defaultNow(),
+    updatedAt: timestamp('updated_at').defaultNow(),
+    startedAt: timestamp('started_at'),
+    completedAt: timestamp('completed_at'),
+});
+/**
+ * Schedule Nodes 表
+ * 存储 Schedule 中的所有节点实例
+ */
+export const scheduleNodes = pgTable('schedule_nodes', {
+    id: varchar('id', { length: 64 }).primaryKey(),
+    scheduleId: varchar('schedule_id', { length: 64 }).notNull(),
+    kind: varchar('kind', { length: 32 }).notNull(),
+    config: jsonb('config'),
+    nextNodeId: varchar('next_node_id', { length: 64 }),
+    onFailure: varchar('on_failure', { length: 32 }),
+    createdAt: timestamp('created_at').defaultNow(),
+    createdBy: varchar('created_by', { length: 64 }),
+}, (table) => ({
+    scheduleIdIdx: index('schedule_nodes_schedule_id_idx').on(table.scheduleId),
+}));
+/**
+ * Node Executions 表
+ * 记录节点执行历史
+ */
+export const nodeExecutions = pgTable('node_executions', {
+    id: varchar('id', { length: 64 }).primaryKey(),
+    scheduleId: varchar('schedule_id', { length: 64 }).notNull(),
+    nodeId: varchar('node_id', { length: 64 }).notNull(),
+    status: varchar('status', { length: 32 }).notNull(),
+    result: jsonb('result'),
+    error: text('error'),
+    retryCount: integer('retry_count').default(0),
+    startedAt: timestamp('started_at'),
+    completedAt: timestamp('completed_at'),
+}, (table) => ({
+    scheduleIdIdx: index('node_executions_schedule_id_idx').on(table.scheduleId),
+    nodeIdIdx: index('node_executions_node_id_idx').on(table.nodeId),
+    scheduleNodeIdx: index('node_executions_schedule_node_idx').on(table.scheduleId, table.nodeId),
+}));
+/**
+ * Plan Results 表
+ * 用于思考节点的幂等性
+ */
+export const planResults = pgTable('plan_results', {
+    idempotencyKey: varchar('idempotency_key', { length: 256 }).primaryKey(),
+    result: jsonb('result').notNull(),
+    createdAt: timestamp('created_at').defaultNow(),
+});
+/**
+ * Personas 表
+ * 存储 Persona 信息
+ */
+export const personas = pgTable('personas', {
+    id: varchar('id', { length: 64 }).primaryKey(),
+    name: varchar('name', { length: 256 }).notNull(),
+    description: text('description'),
+    systemPrompt: text('system_prompt').notNull(),
+    actionTypes: jsonb('action_types').notNull(),
+    createdAt: timestamp('created_at').defaultNow(),
+    updatedAt: timestamp('updated_at').defaultNow(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PersonaCore - 动态规划 Workflow Agent 工具
+ *
+ * 主模块导出
+ */
+export * from './types/index.js';
+export * from './db/index.js';
+export * from './llm/index.js';
+export * from './services/index.js';
+export * from './temporal/index.js';
+//# 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;;;;GAIG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * PersonaCore - 动态规划 Workflow Agent 工具
+ *
+ * 主模块导出
+ */
+// 类型定义
+export * from './types/index.js';
+// 数据库层
+export * from './db/index.js';
+// LLM 抽象层
+export * from './llm/index.js';
+// 服务层
+export * from './services/index.js';
+// Temporal 集成
+export * from './temporal/index.js';
+//# 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;;;;GAIG;AAEH,OAAO;AACP,cAAc,kBAAkB,CAAC;AAEjC,OAAO;AACP,cAAc,eAAe,CAAC;AAE9B,UAAU;AACV,cAAc,gBAAgB,CAAC;AAE/B,MAAM;AACN,cAAc,qBAAqB,CAAC;AAEpC,cAAc;AACd,cAAc,qBAAqB,CAAC"}

package/dist/llm/capabilities.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LLM 能力实现
+ * 基于 LLMProvider 实现特定场景的能力
+ */
+import { LLMProvider, LLMCallOptions, PlanningCapability, PlanningContext, PlanningOutput, BranchDecisionCapability, ContentGenerationCapability, ContentGenerationResult } from './interfaces.js';
+/**
+ * 基于 LLMProvider 实现的规划能力
+ */
+export declare class LLMPlanningCapability implements PlanningCapability {
+    private provider;
+    /** 默认选项，规划场景建议使用低 temperature (0.3-0.5) */
+    private defaultOptions?;
+    constructor(provider: LLMProvider, 
+    /** 默认选项，规划场景建议使用低 temperature (0.3-0.5) */
+    defaultOptions?: LLMCallOptions | undefined);
+    plan(systemPrompt: string, userPrompt: string, context: PlanningContext, options?: LLMCallOptions): Promise<PlanningOutput>;
+    private buildSystemPrompt;
+    private buildUserPrompt;
+    private getOutputSchema;
+}
+/**
+ * 基于 LLMProvider 实现的分支决策能力
+ */
+export declare class LLMBranchDecisionCapability implements BranchDecisionCapability {
+    private provider;
+    /** 默认选项，决策场景建议使用低 temperature (0.2-0.4) */
+    private defaultOptions?;
+    constructor(provider: LLMProvider, 
+    /** 默认选项，决策场景建议使用低 temperature (0.2-0.4) */
+    defaultOptions?: LLMCallOptions | undefined);
+    decide(prompt: string, inputs: Record<string, unknown>, branches: Array<{
+        branchId: string;
+        name: string;
+    }>, options?: LLMCallOptions): Promise<string>;
+}
+/**
+ * 基于 LLMProvider 实现的内容生成能力
+ */
+export declare class LLMContentGenerationCapability implements ContentGenerationCapability {
+    private provider;
+    /** 默认选项，内容生成场景可使用较高 temperature (0.7-0.9) 以增加创意性 */
+    private defaultOptions?;
+    constructor(provider: LLMProvider, 
+    /** 默认选项，内容生成场景可使用较高 temperature (0.7-0.9) 以增加创意性 */
+    defaultOptions?: LLMCallOptions | undefined);
+    generate(actionName: string, actionDescription: string | undefined, inputs: Record<string, unknown>, outputFields: Array<{
+        name: string;
+        typeHint?: string;
+    }>, options?: LLMCallOptions): Promise<ContentGenerationResult>;
+    /**
+     * 根据 outputFields 动态构建 JSON schema
+     * 确保 LLM 返回的结构与 ActionNodeType.outputFields 定义一致
+     */
+    private buildOutputSchema;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/llm/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/llm/capabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAE5D,OAAO,CAAC,QAAQ;IAChB,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAC;gBAFf,QAAQ,EAAE,WAAW;IAC7B,2CAA2C;IACnC,cAAc,CAAC,EAAE,cAAc,YAAA;IAGnC,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;IAuB1B,OAAO,CAAC,iBAAiB;IA+EzB,OAAO,CAAC,eAAe;IAkDvB,OAAO,CAAC,eAAe;CAwCxB;AAED;;GAEG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAExE,OAAO,CAAC,QAAQ;IAChB,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAC;gBAFf,QAAQ,EAAE,WAAW;IAC7B,2CAA2C;IACnC,cAAc,CAAC,EAAE,cAAc,YAAA;IAGnC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;CAqCnB;AAED;;GAEG;AACH,qBAAa,8BAA+B,YAAW,2BAA2B;IAE9E,OAAO,CAAC,QAAQ;IAChB,oDAAoD;IACpD,OAAO,CAAC,cAAc,CAAC;gBAFf,QAAQ,EAAE,WAAW;IAC7B,oDAAoD;IAC5C,cAAc,CAAC,EAAE,cAAc,YAAA;IAGnC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,CAAC;IAiDnC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/llm/capabilities.js

@@ -0,0 +1,305 @@
+/**
+ * LLM 能力实现
+ * 基于 LLMProvider 实现特定场景的能力
+ */
+/**
+ * 基于 LLMProvider 实现的规划能力
+ */
+export class LLMPlanningCapability {
+    provider;
+    defaultOptions;
+    constructor(provider, 
+    /** 默认选项，规划场景建议使用低 temperature (0.3-0.5) */
+    defaultOptions) {
+        this.provider = provider;
+        this.defaultOptions = defaultOptions;
+    }
+    async plan(systemPrompt, userPrompt, context, options) {
+        const fullSystemPrompt = this.buildSystemPrompt(systemPrompt, context);
+        const fullUserPrompt = this.buildUserPrompt(userPrompt, context);
+        // 合并默认选项和传入选项
+        const mergedOptions = { ...this.defaultOptions, ...options };
+        const response = await this.provider.chatWithStructuredOutput([
+            { role: 'system', content: fullSystemPrompt },
+            { role: 'user', content: fullUserPrompt },
+        ], { schema: this.getOutputSchema() }, mergedOptions);
+        // 返回结果，附带 reasoningContent
+        return {
+            ...response.data,
+            reasoningContent: response.reasoningContent,
+        };
+    }
+    buildSystemPrompt(basePrompt, context) {
+        // 构建详细的动作类型描述，包含输出数据结构
+        const actionTypesDesc = context.availableActionTypes
+            .map(a => {
+            const inputsDesc = a.inputFields
+                .map(f => `${f.name}${f.required ? '*' : ''}`)
+                .join(', ');
+            // 展示输出字段的 TypeScript 类型
+            const outputsDesc = a.outputFields
+                .map(f => {
+                const typeHint = f.typeHint ?? 'string';
+                return `    - ${f.name}: ${typeHint}`;
+            })
+                .join('\n');
+            return `- **${a.id}**: ${a.name}
+  ${a.description ?? ''}
+  输入: ${inputsDesc}
+  输出:
+${outputsDesc}`;
+        })
+            .join('\n\n');
+        return `${basePrompt}
+
+你是一个工作流规划助手。你需要根据任务需求规划后续的执行节点。
+
+## 可用的动作类型（输出类型使用 TypeScript 格式）
+
+${actionTypesDesc}
+
+## 内置节点类型
+
+1. **thinking** - 思考节点：用于进一步规划
+2. **branch** - 分支节点：根据条件选择不同路径
+   - 支持 expression（表达式）、llm（LLM 决策）类型
+
+## 规划规则
+
+1. 每个节点必须有唯一的 id
+2. 使用 nextNodeId 连接节点，最后一个节点设为 null
+3. 分支节点的 nextNodeId 必须为 null，通过 branches 定义分支目标
+4. 输入可以是 fixed（固定值）或 reference（引用共享数据）
+5. 循环结构中必须有可退出的分支
+
+### 重要：reference 类型输入的 path 属性
+
+当输入的 type 为 "reference" 时，如果被引用的数据是**数组**或**嵌套对象**，必须使用 path 属性指定如何提取数据：
+
+**path 语法**：
+- \`[0].fieldName\` - 获取数组第一个元素的 fieldName 字段
+- \`[*].fieldName\` - 获取数组所有元素的 fieldName 字段，返回新数组
+- \`.fieldName\` - 获取对象的 fieldName 属性
+
+**示例**：
+假设 web_search 输出 organic: Array<{title, link, snippet}>，要将第一个结果的链接传给 fetch_webpage：
+\`\`\`json
+{
+  "url": {
+    "type": "reference",
+    "fieldName": "searchResults",
+    "path": "[0].link"
+  }
+}
+\`\`\`
+
+假设 image_search 输出 images: Array<{title, imageUrl, link}>，要将所有图片 URL 传给 generate_comic_art：
+\`\`\`json
+{
+  "referenceImages": {
+    "type": "reference",
+    "fieldName": "searchedImages",
+    "path": "[*].imageUrl"
+  }
+}
+\`\`\``;
+    }
+    buildUserPrompt(prompt, context) {
+        let userPrompt = `## 当前任务
+
+${prompt}
+
+## 当前共享数据
+
+${JSON.stringify(context.sharedData, null, 2)}`;
+        // 如果有工作流上下文，添加后续节点信息
+        if (context.workflowContext?.hasUpcomingNodes) {
+            const wfCtx = context.workflowContext;
+            const upcomingNodesDesc = wfCtx.upcomingNodes.map((node, idx) => {
+                const stepNum = wfCtx.position + idx + 1;
+                let desc = `- 第 ${stepNum} 步: ${node.kind} 节点`;
+                if (node.kind === 'action') {
+                    desc += ` (${node.actionTypeId})`;
+                    if (node.actionName) {
+                        desc += ` - ${node.actionName}`;
+                    }
+                }
+                else if (node.kind === 'thinking' && node.thinkingPrompt) {
+                    const truncatedPrompt = node.thinkingPrompt.length > 50
+                        ? node.thinkingPrompt.slice(0, 50) + '...'
+                        : node.thinkingPrompt;
+                    desc += ` - "${truncatedPrompt}"`;
+                }
+                return desc;
+            }).join('\n');
+            userPrompt += `
+
+## 工作流上下文（重要）
+
+你是工作流中的**第 ${wfCtx.position} 步**。
+
+**后续已规划的节点**：
+${upcomingNodesDesc}
+
+**规划选项**：
+1. **只更新数据（推荐）** - 如果后续节点能完成任务，只在 sharedDataUpdates 中准备数据，返回空的 plannedNodes: []，让流程继续执行后续节点
+2. **替换后续节点** - 如果后续节点不满足需求，规划新节点（你的新节点会替换后续所有节点）
+3. **在后续节点前插入** - 规划新节点，并将最后一个新节点的 nextNodeId 设置为后续第一个节点的 ID: "${wfCtx.upcomingNodes[0]?.id}"
+
+请仔细考虑后续节点是否已经能满足需求，避免重复规划！`;
+        }
+        userPrompt += '\n\n请规划后续的执行节点。';
+        return userPrompt;
+    }
+    getOutputSchema() {
+        return `{
+  "analysis": {
+    "taskBreakdown": "将用户需求分解为具体步骤",
+    "dataFlowAnalysis": "分析每个步骤的输入来源和输出格式。特别注意：如果输出是数组类型，明确标注元素结构。例如：web_search 输出 organic: Array<{title, link, snippet}>",
+    "inputResolution": "规划每个节点如何获取输入数据。如果引用的数据是数组，必须指定 path 表达式（如 [0].link 或 [*].imageUrl）"
+  },
+  "plannedNodes": [
+    {
+      "id": "节点ID（唯一）",
+      "kind": "action|thinking|branch",
+      "actionTypeId": "动作类型ID（仅 action 节点）",
+      "thinkingPrompt": "思考提示（仅 thinking 节点）",
+      "inputs": {
+        "字段名": {
+          "type": "fixed|reference",
+          "value": "固定值（type=fixed时使用）",
+          "fieldName": "引用的共享数据字段名（type=reference时使用）",
+          "path": "从数组或嵌套对象中提取数据的路径（type=reference且数据是数组/对象时必须指定），如 [0].link 或 [*].imageUrl"
+        }
+      },
+      "outputMappings": [
+        {
+          "outputField": "动作输出字段名",
+          "targetField": "存储到共享数据的字段名"
+        }
+      ],
+      "branches": [ ... ],
+      "decisionConfig": { ... },
+      "nextNodeId": "下一个节点ID或null"
+    }
+  ],
+  "sharedDataUpdates": { "字段名": "值" },
+  "sharedDataDeclaration": {
+    "fields": [
+      { "name": "字段名", "isCollection": false, "description": "用途说明" }
+    ]
+  }
+}`;
+    }
+}
+/**
+ * 基于 LLMProvider 实现的分支决策能力
+ */
+export class LLMBranchDecisionCapability {
+    provider;
+    defaultOptions;
+    constructor(provider, 
+    /** 默认选项，决策场景建议使用低 temperature (0.2-0.4) */
+    defaultOptions) {
+        this.provider = provider;
+        this.defaultOptions = defaultOptions;
+    }
+    async decide(prompt, inputs, branches, options) {
+        const branchOptions = branches
+            .map(b => `- ${b.branchId}: ${b.name}`)
+            .join('\n');
+        // 合并默认选项和传入选项
+        const mergedOptions = { ...this.defaultOptions, ...options };
+        const response = await this.provider.chatWithStructuredOutput([
+            {
+                role: 'system',
+                content: '你是一个决策助手。根据输入数据和决策提示，选择最合适的分支。',
+            },
+            {
+                role: 'user',
+                content: `## 决策提示
+
+${prompt}
+
+## 输入数据
+
+${JSON.stringify(inputs, null, 2)}
+
+## 可选分支
+
+${branchOptions}
+
+请选择最合适的分支。`,
+            },
+        ], { schema: '{ "selectedBranchId": "选择的分支ID" }' }, mergedOptions);
+        return response.data.selectedBranchId;
+    }
+}
+/**
+ * 基于 LLMProvider 实现的内容生成能力
+ */
+export class LLMContentGenerationCapability {
+    provider;
+    defaultOptions;
+    constructor(provider, 
+    /** 默认选项，内容生成场景可使用较高 temperature (0.7-0.9) 以增加创意性 */
+    defaultOptions) {
+        this.provider = provider;
+        this.defaultOptions = defaultOptions;
+    }
+    async generate(actionName, actionDescription, inputs, outputFields, options) {
+        const inputsDesc = Object.entries(inputs)
+            .map(([key, value]) => `${key}: ${JSON.stringify(value)}`)
+            .join('\n');
+        // 基于 outputFields 动态构建 JSON schema 确保输出一致性
+        const outputSchema = this.buildOutputSchema(outputFields);
+        // 合并默认选项和传入选项
+        const mergedOptions = { ...this.defaultOptions, ...options };
+        // 使用 chatWithStructuredOutput 确保返回结构化数据
+        const response = await this.provider.chatWithStructuredOutput([
+            {
+                role: 'system',
+                content: `你是一个专业的内容创作助手。请根据要求完成任务，并严格按照指定的输出格式返回结果。
+
+重要规则：
+1. 必须返回合法的 JSON 格式
+2. 字符串值中的特殊字符必须正确转义：
+   - 换行符用 \\n 表示
+   - 双引号用 \\" 表示
+   - 反斜杠用 \\\\ 表示
+   - 制表符用 \\t 表示
+3. 不要在 JSON 中使用未转义的换行符`,
+            },
+            {
+                role: 'user',
+                content: `执行任务：${actionName}
+
+任务描述：${actionDescription ?? ''}
+
+输入参数：
+${inputsDesc}
+
+请完成这个任务并返回结果。`,
+            },
+        ], { schema: outputSchema }, mergedOptions);
+        return {
+            outputs: response.data,
+            reasoningContent: response.reasoningContent,
+        };
+    }
+    /**
+     * 根据 outputFields 动态构建 JSON schema
+     * 确保 LLM 返回的结构与 ActionNodeType.outputFields 定义一致
+     */
+    buildOutputSchema(outputFields) {
+        const fields = outputFields.map(f => {
+            // 直接使用 TypeScript 类型格式作为描述
+            const typeHint = f.typeHint ?? 'string';
+            return `  "${f.name}": "<${typeHint}>"`;
+        });
+        return `{
+${fields.join(',\n')}
+}`;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/llm/capabilities.js.map

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

package/dist/llm/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * LLM 抽象层导出
+ */
+export * from './interfaces.js';
+export { LLMPlanningCapability, LLMBranchDecisionCapability, LLMContentGenerationCapability, } from './capabilities.js';
+export * from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAG3B,cAAc,sBAAsB,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,10 @@
+/**
+ * LLM 抽象层导出
+ */
+// 接口
+export * from './interfaces.js';
+// 能力实现
+export { LLMPlanningCapability, LLMBranchDecisionCapability, LLMContentGenerationCapability, } from './capabilities.js';
+// Providers
+export * from './providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK;AACL,cAAc,iBAAiB,CAAC;AAEhC,OAAO;AACP,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,cAAc,sBAAsB,CAAC"}