persona-core 1.0.0

package/dist/temporal/personaCoreClient.d.ts

@@ -0,0 +1,199 @@
+/**
+ * PersonaCore 高级客户端
+ *
+ * 纯 Temporal 客户端封装，不直接连接数据库。
+ * Schedule 通过 Workflow 输入传递，由 Worker 负责写入数据库。
+ */
+import { Client } from '@temporalio/client';
+import { ScheduleExecutionStatus } from './workflows/scheduleWorkflow.js';
+import { Persona, Schedule, SharedDataValue } from '../types/index.js';
+/**
+ * 启动参数：使用已存在的 Schedule
+ */
+export interface StartScheduleParams {
+    /** 已存在于数据库中的 Schedule ID */
+    scheduleId: string;
+}
+/**
+ * 启动参数：传入完整的 Persona 和 Schedule 定义
+ */
+export interface StartWithPersonaParams {
+    /** 完整的 Persona 定义 */
+    persona: Persona;
+    /** 完整的 Schedule 定义 */
+    schedule: Schedule;
+}
+/**
+ * 启动参数：传入 Persona 定义和初始思考提示
+ * 系统会自动创建一个只有入口思考节点的 Schedule
+ */
+export interface StartWithThinkingParams {
+    /** 完整的 Persona 定义 */
+    persona: Persona;
+    /** 初始思考节点的提示 */
+    thinkingPrompt: string;
+    /** 可选：Schedule 名称 */
+    scheduleName?: string;
+    /** 可选：初始共享数据 */
+    initialSharedData?: Record<string, SharedDataValue>;
+}
+/**
+ * Workflow 执行句柄
+ */
+export interface WorkflowHandle {
+    /** Workflow ID */
+    workflowId: string;
+    /** Schedule ID */
+    scheduleId: string;
+    /** Persona ID */
+    personaId: string;
+    /** 获取执行状态 */
+    getStatus(): Promise<ScheduleExecutionStatus>;
+    /** 暂停执行 */
+    pause(): Promise<void>;
+    /** 恢复执行 */
+    resume(): Promise<void>;
+    /** 取消执行 */
+    cancel(): Promise<void>;
+    /** 等待执行完成 */
+    waitForCompletion(): Promise<void>;
+}
+/**
+ * PersonaCore 客户端配置
+ *
+ * 注意：Client 不再需要数据库连接，所有数据操作由 Worker 完成。
+ */
+export interface PersonaCoreClientConfig {
+    /** Temporal Server 地址（与 temporalClient 二选一） */
+    temporalAddress?: string;
+    /** 已有的 Temporal Client（与 temporalAddress 二选一，用于测试） */
+    temporalClient?: Client;
+    /** 任务队列名称 */
+    taskQueue: string;
+}
+/**
+ * PersonaCore 高级客户端
+ *
+ * 纯 Temporal 客户端，不直接连接数据库。
+ * Schedule 通过 Workflow 输入传递，由 Worker 负责持久化。
+ *
+ * @example
+ * ```typescript
+ * // 创建客户端（无需数据库配置）
+ * const client = await PersonaCoreClient.create({
+ *   temporalAddress: 'localhost:7233',
+ *   taskQueue: 'my-queue',
+ * });
+ *
+ * // 方式一：传入完整的 Persona 和思考提示
+ * const handle = await client.startWithThinking({
+ *   persona: myPersona,
+ *   thinkingPrompt: '帮我规划一个任务...',
+ * });
+ *
+ * // 方式二：传入完整的 Persona 和 Schedule
+ * const handle = await client.startWithPersona({
+ *   persona: myPersona,
+ *   schedule: mySchedule,
+ * });
+ *
+ * // 等待完成
+ * await handle.waitForCompletion();
+ * ```
+ */
+export declare class PersonaCoreClient {
+    private client;
+    private taskQueue;
+    private constructor();
+    /**
+     * 创建 PersonaCore 客户端
+     */
+    static create(config: PersonaCoreClientConfig): Promise<PersonaCoreClient>;
+    /**
+     * 使用完整的 Persona 和 Schedule 启动 Workflow
+     *
+     * @example
+     * ```typescript
+     * const handle = await client.startWithPersona({
+     *   persona: {
+     *     id: 'my-persona',
+     *     name: '示例人格',
+     *     systemPrompt: '你是一个有帮助的助手',
+     *     actionTypes: [...],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     *   schedule: {
+     *     id: 'my-schedule',
+     *     personaId: 'my-persona',
+     *     name: '示例任务',
+     *     entryNodeId: 'think-1',
+     *     nodes: { ... },
+     *     sharedData: { data: {}, fieldTypes: {} },
+     *     status: 'pending',
+     *     executionHistory: [],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     * });
+     * ```
+     */
+    startWithPersona(params: StartWithPersonaParams): Promise<WorkflowHandle>;
+    /**
+     * 使用 Persona 和思考提示启动 Workflow
+     * 系统会自动创建一个只有入口思考节点的 Schedule
+     *
+     * @example
+     * ```typescript
+     * const handle = await client.startWithThinking({
+     *   persona: {
+     *     id: 'humor-bot',
+     *     name: '幽默机器人',
+     *     systemPrompt: '你是一个幽默的助手...',
+     *     actionTypes: [
+     *       {
+     *         kind: 'action',
+     *         id: 'reply',
+     *         name: '回复',
+     *         executionType: 'llm_call',
+     *         inputFields: [...],
+     *         outputFields: [...],
+     *       },
+     *     ],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     *   thinkingPrompt: '用户说他今天很累，请给他一个幽默的回复',
+     *   scheduleName: '幽默回复任务',
+     * });
+     * ```
+     */
+    startWithThinking(params: StartWithThinkingParams): Promise<WorkflowHandle>;
+    /**
+     * 使用已存在的 Schedule ID 启动 Workflow
+     *
+     * 注意：此方法假设 Schedule 已存在于数据库中。
+     * 如果 Schedule 不存在，Workflow 执行时会失败。
+     *
+     * @deprecated 推荐使用 startWithPersona 或 startWithThinking，它们会自动创建 Schedule
+     */
+    startSchedule(params: StartScheduleParams & {
+        personaId: string;
+    }): Promise<WorkflowHandle>;
+    /**
+     * 内部方法：启动 Workflow
+     * @param scheduleId - Schedule ID
+     * @param personaId - Persona ID
+     * @param schedule - 可选的完整 Schedule（首次启动时传入，由 Worker 写入数据库）
+     */
+    private startWorkflow;
+    /**
+     * 获取内部 Temporal Client
+     */
+    getTemporalClient(): Client;
+    /**
+     * 获取 Workflow Handle（用于查询已有的 Workflow）
+     */
+    getWorkflowHandle(workflowId: string): import("@temporalio/client").WorkflowHandle<import("@temporalio/client").Workflow>;
+}
+//# sourceMappingURL=personaCoreClient.d.ts.map

package/dist/temporal/personaCoreClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaCoreClient.d.ts","sourceRoot":"","sources":["../../src/temporal/personaCoreClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAML,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAwB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa;IACb,SAAS,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9C,WAAW;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW;IACX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,WAAW;IACX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,aAAa;IACb,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;IAKP;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAehF;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAyCjF;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjG;;;;;OAKG;YACW,aAAa;IAwC3B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM;CAGrC"}

package/dist/temporal/personaCoreClient.js

@@ -0,0 +1,233 @@
+/**
+ * PersonaCore 高级客户端
+ *
+ * 纯 Temporal 客户端封装，不直接连接数据库。
+ * Schedule 通过 Workflow 输入传递，由 Worker 负责写入数据库。
+ */
+import { Client, Connection } from '@temporalio/client';
+import { v4 as uuidv4 } from 'uuid';
+import { scheduleWorkflow, getStatusQuery, pauseSignal, resumeSignal, cancelSignal, } from './workflows/scheduleWorkflow.js';
+/**
+ * PersonaCore 高级客户端
+ *
+ * 纯 Temporal 客户端，不直接连接数据库。
+ * Schedule 通过 Workflow 输入传递，由 Worker 负责持久化。
+ *
+ * @example
+ * ```typescript
+ * // 创建客户端（无需数据库配置）
+ * const client = await PersonaCoreClient.create({
+ *   temporalAddress: 'localhost:7233',
+ *   taskQueue: 'my-queue',
+ * });
+ *
+ * // 方式一：传入完整的 Persona 和思考提示
+ * const handle = await client.startWithThinking({
+ *   persona: myPersona,
+ *   thinkingPrompt: '帮我规划一个任务...',
+ * });
+ *
+ * // 方式二：传入完整的 Persona 和 Schedule
+ * const handle = await client.startWithPersona({
+ *   persona: myPersona,
+ *   schedule: mySchedule,
+ * });
+ *
+ * // 等待完成
+ * await handle.waitForCompletion();
+ * ```
+ */
+export class PersonaCoreClient {
+    client;
+    taskQueue;
+    constructor(client, taskQueue) {
+        this.client = client;
+        this.taskQueue = taskQueue;
+    }
+    /**
+     * 创建 PersonaCore 客户端
+     */
+    static async create(config) {
+        // 获取或创建 Temporal Client
+        let client;
+        if (config.temporalClient) {
+            client = config.temporalClient;
+        }
+        else if (config.temporalAddress) {
+            const connection = await Connection.connect({ address: config.temporalAddress });
+            client = new Client({ connection });
+        }
+        else {
+            throw new Error('Either temporalAddress or temporalClient must be provided');
+        }
+        return new PersonaCoreClient(client, config.taskQueue);
+    }
+    /**
+     * 使用完整的 Persona 和 Schedule 启动 Workflow
+     *
+     * @example
+     * ```typescript
+     * const handle = await client.startWithPersona({
+     *   persona: {
+     *     id: 'my-persona',
+     *     name: '示例人格',
+     *     systemPrompt: '你是一个有帮助的助手',
+     *     actionTypes: [...],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     *   schedule: {
+     *     id: 'my-schedule',
+     *     personaId: 'my-persona',
+     *     name: '示例任务',
+     *     entryNodeId: 'think-1',
+     *     nodes: { ... },
+     *     sharedData: { data: {}, fieldTypes: {} },
+     *     status: 'pending',
+     *     executionHistory: [],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     * });
+     * ```
+     */
+    async startWithPersona(params) {
+        const { persona, schedule } = params;
+        // 确保 schedule.personaId 与 persona.id 一致
+        if (schedule.personaId !== persona.id) {
+            throw new Error(`Schedule.personaId (${schedule.personaId}) must match Persona.id (${persona.id})`);
+        }
+        // 确保 schedule 包含 persona 快照
+        const scheduleWithPersona = {
+            ...schedule,
+            persona, // 嵌入 persona 快照
+        };
+        // 启动 Workflow，传入完整的 Schedule（由 Worker 写入数据库）
+        return this.startWorkflow(schedule.id, persona.id, scheduleWithPersona);
+    }
+    /**
+     * 使用 Persona 和思考提示启动 Workflow
+     * 系统会自动创建一个只有入口思考节点的 Schedule
+     *
+     * @example
+     * ```typescript
+     * const handle = await client.startWithThinking({
+     *   persona: {
+     *     id: 'humor-bot',
+     *     name: '幽默机器人',
+     *     systemPrompt: '你是一个幽默的助手...',
+     *     actionTypes: [
+     *       {
+     *         kind: 'action',
+     *         id: 'reply',
+     *         name: '回复',
+     *         executionType: 'llm_call',
+     *         inputFields: [...],
+     *         outputFields: [...],
+     *       },
+     *     ],
+     *     createdAt: new Date(),
+     *     updatedAt: new Date(),
+     *   },
+     *   thinkingPrompt: '用户说他今天很累，请给他一个幽默的回复',
+     *   scheduleName: '幽默回复任务',
+     * });
+     * ```
+     */
+    async startWithThinking(params) {
+        const { persona, thinkingPrompt, scheduleName, initialSharedData } = params;
+        // 生成 IDs（使用短 UUID 以确保节点 ID 不超过 64 字符限制）
+        const shortUuid = () => uuidv4().slice(0, 8);
+        const scheduleId = `sched-${shortUuid()}`;
+        const thinkingNodeId = `think-${shortUuid()}`;
+        // 创建入口思考节点
+        const thinkingNode = {
+            id: thinkingNodeId,
+            kind: 'thinking',
+            thinkingPrompt,
+            inputs: {},
+            nextNodeId: null,
+        };
+        // 创建 Schedule（包含 persona 快照）
+        const schedule = {
+            id: scheduleId,
+            personaId: persona.id,
+            persona, // 嵌入 persona 快照
+            name: scheduleName ?? `Task-${Date.now()}`,
+            entryNodeId: thinkingNodeId,
+            nodes: {
+                [thinkingNodeId]: thinkingNode,
+            },
+            sharedData: {
+                data: initialSharedData ?? {},
+                fieldTypes: {},
+            },
+            status: 'pending',
+            executionHistory: [],
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        // 使用 startWithPersona 完成剩余工作
+        return this.startWithPersona({ persona, schedule });
+    }
+    /**
+     * 使用已存在的 Schedule ID 启动 Workflow
+     *
+     * 注意：此方法假设 Schedule 已存在于数据库中。
+     * 如果 Schedule 不存在，Workflow 执行时会失败。
+     *
+     * @deprecated 推荐使用 startWithPersona 或 startWithThinking，它们会自动创建 Schedule
+     */
+    async startSchedule(params) {
+        const { scheduleId, personaId } = params;
+        // 启动 Workflow（不传入 schedule，假设已存在）
+        return this.startWorkflow(scheduleId, personaId);
+    }
+    /**
+     * 内部方法：启动 Workflow
+     * @param scheduleId - Schedule ID
+     * @param personaId - Persona ID
+     * @param schedule - 可选的完整 Schedule（首次启动时传入，由 Worker 写入数据库）
+     */
+    async startWorkflow(scheduleId, personaId, schedule) {
+        const handle = await this.client.workflow.start(scheduleWorkflow, {
+            args: [{ scheduleId, schedule }],
+            taskQueue: this.taskQueue,
+            workflowId: `schedule-${scheduleId}`,
+        });
+        const workflowId = handle.workflowId;
+        return {
+            workflowId,
+            scheduleId,
+            personaId,
+            async getStatus() {
+                return handle.query(getStatusQuery);
+            },
+            async pause() {
+                await handle.signal(pauseSignal);
+            },
+            async resume() {
+                await handle.signal(resumeSignal);
+            },
+            async cancel() {
+                await handle.signal(cancelSignal);
+            },
+            async waitForCompletion() {
+                await handle.result();
+            },
+        };
+    }
+    /**
+     * 获取内部 Temporal Client
+     */
+    getTemporalClient() {
+        return this.client;
+    }
+    /**
+     * 获取 Workflow Handle（用于查询已有的 Workflow）
+     */
+    getWorkflowHandle(workflowId) {
+        return this.client.workflow.getHandle(workflowId);
+    }
+}
+//# sourceMappingURL=personaCoreClient.js.map

package/dist/temporal/personaCoreClient.js.map

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

package/dist/temporal/personaWorker.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Persona Worker 简化创建函数
+ *
+ * 提供开箱即用的 Worker 创建方式，用户只需提供：
+ * - LLM Provider
+ * - Temporal 地址
+ * - 可选的 PostgreSQL 连接字符串
+ */
+import { LLMProvider } from '../llm/interfaces.js';
+import { DatabaseHandle } from '../db/client.js';
+import { WorkerHandle } from './worker.js';
+/**
+ * PersonaWorker 配置
+ */
+export interface PersonaWorkerConfig {
+    /**
+     * Temporal Server 地址（与 nativeConnection 二选一）
+     * @example "localhost:7233"
+     */
+    temporalAddress?: string;
+    /**
+     * 已有的 NativeConnection（与 temporalAddress 二选一，用于测试）
+     * 如果提供，将使用此连接而不是创建新连接
+     */
+    nativeConnection?: import('@temporalio/worker').NativeConnection;
+    /**
+     * Temporal 任务队列名称
+     * @default "persona-core-queue"
+     */
+    taskQueue?: string;
+    /**
+     * LLM 提供者（必需）
+     * 用于思考节点、内容生成、分支决策等
+     *
+     * @example
+     * ```typescript
+     * import { OpenAICompatibleProvider } from 'persona-core';
+     *
+     * const llmProvider = new OpenAICompatibleProvider({
+     *   apiKey: 'your-api-key',
+     *   baseUrl: 'https://api.openai.com/v1',
+     *   model: 'gpt-4',
+     * });
+     * ```
+     */
+    llmProvider: LLMProvider;
+    /**
+     * 可选：为不同场景配置不同的 LLM 提供者
+     */
+    providers?: {
+        /** 规划专用 Provider（用于思考节点，可能需要更强大的模型） */
+        planning?: LLMProvider;
+        /** 分支决策专用 Provider（可使用更快的模型以降低延迟） */
+        branch?: LLMProvider;
+        /** 内容生成专用 Provider（可使用领域优化的模型） */
+        content?: LLMProvider;
+    };
+    /**
+     * 可选：PostgreSQL 数据库连接字符串
+     * 如果不提供，将使用 PGlite 内存数据库
+     *
+     * @example "postgres://user:password@localhost:5432/persona_pilot"
+     */
+    postgresUrl?: string;
+    /**
+     * 可选：已有的数据库句柄（用于测试或共享数据库）
+     * 如果提供，将忽略 postgresUrl
+     */
+    databaseHandle?: DatabaseHandle;
+    /**
+     * 可选：文件操作配置
+     */
+    fileConfig?: {
+        /** 文件操作的基础目录 */
+        baseDir?: string;
+        /** 最大文件大小（字节） */
+        maxFileSize?: number;
+    };
+    /**
+     * 可选：Temporal 连接超时时间（毫秒）
+     * @default 10000
+     */
+    connectTimeout?: number;
+}
+/**
+ * PersonaWorker 句柄
+ * 包含 Worker 实例和资源清理方法
+ */
+export interface PersonaWorkerHandle {
+    /** Temporal Worker 句柄 */
+    workerHandle: WorkerHandle;
+    /** 数据库句柄 */
+    databaseHandle: DatabaseHandle;
+    /**
+     * 优雅关闭所有资源
+     * 包括 Worker、Temporal 连接和数据库连接
+     */
+    shutdown: () => Promise<void>;
+}
+/**
+ * 创建 PersonaWorker
+ *
+ * 简化的 Worker 创建函数，自动使用默认的服务实现。
+ * 用户只需提供 LLM Provider 和 Temporal 地址即可。
+ *
+ * @example
+ * ```typescript
+ * import { createPersonaWorker, OpenAICompatibleProvider } from 'persona-core';
+ *
+ * // 使用 PGlite 内存数据库（开发/测试）
+ * const worker = await createPersonaWorker({
+ *   temporalAddress: 'localhost:7233',
+ *   llmProvider: new OpenAICompatibleProvider({
+ *     apiKey: process.env.OPENAI_API_KEY!,
+ *     model: 'gpt-4',
+ *   }),
+ * });
+ *
+ * // 运行 Worker
+ * await worker.workerHandle.worker.run();
+ *
+ * // 优雅关闭
+ * await worker.shutdown();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 使用 PostgreSQL 数据库（生产）
+ * const worker = await createPersonaWorker({
+ *   temporalAddress: 'temporal.example.com:7233',
+ *   postgresUrl: 'postgres://user:pass@db.example.com:5432/persona_pilot',
+ *   llmProvider: new OpenAICompatibleProvider({
+ *     apiKey: process.env.OPENAI_API_KEY!,
+ *     baseUrl: 'https://api.openai.com/v1',
+ *     model: 'gpt-4-turbo',
+ *   }),
+ * });
+ * ```
+ */
+export declare function createPersonaWorker(config: PersonaWorkerConfig): Promise<PersonaWorkerHandle>;
+//# sourceMappingURL=personaWorker.d.ts.map

package/dist/temporal/personaWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaWorker.d.ts","sourceRoot":"","sources":["../../src/temporal/personaWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAkB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAA8B,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,CAAC;IAEjE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;OAcG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,uCAAuC;QACvC,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,qCAAqC;QACrC,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,kCAAkC;QAClC,OAAO,CAAC,EAAE,WAAW,CAAC;KACvB,CAAC;IAEF;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,gBAAgB;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/temporal/personaWorker.js

@@ -0,0 +1,93 @@
+/**
+ * Persona Worker 简化创建函数
+ *
+ * 提供开箱即用的 Worker 创建方式，用户只需提供：
+ * - LLM Provider
+ * - Temporal 地址
+ * - 可选的 PostgreSQL 连接字符串
+ */
+import { createServices } from '../services/factory.js';
+import { createDatabase } from '../db/client.js';
+import { createWorker } from './worker.js';
+/**
+ * 创建 PersonaWorker
+ *
+ * 简化的 Worker 创建函数，自动使用默认的服务实现。
+ * 用户只需提供 LLM Provider 和 Temporal 地址即可。
+ *
+ * @example
+ * ```typescript
+ * import { createPersonaWorker, OpenAICompatibleProvider } from 'persona-core';
+ *
+ * // 使用 PGlite 内存数据库（开发/测试）
+ * const worker = await createPersonaWorker({
+ *   temporalAddress: 'localhost:7233',
+ *   llmProvider: new OpenAICompatibleProvider({
+ *     apiKey: process.env.OPENAI_API_KEY!,
+ *     model: 'gpt-4',
+ *   }),
+ * });
+ *
+ * // 运行 Worker
+ * await worker.workerHandle.worker.run();
+ *
+ * // 优雅关闭
+ * await worker.shutdown();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 使用 PostgreSQL 数据库（生产）
+ * const worker = await createPersonaWorker({
+ *   temporalAddress: 'temporal.example.com:7233',
+ *   postgresUrl: 'postgres://user:pass@db.example.com:5432/persona_pilot',
+ *   llmProvider: new OpenAICompatibleProvider({
+ *     apiKey: process.env.OPENAI_API_KEY!,
+ *     baseUrl: 'https://api.openai.com/v1',
+ *     model: 'gpt-4-turbo',
+ *   }),
+ * });
+ * ```
+ */
+export async function createPersonaWorker(config) {
+    // 1. 创建或使用已有的数据库连接
+    const ownDatabase = !config.databaseHandle;
+    const databaseHandle = config.databaseHandle ?? await createDatabase(config.postgresUrl);
+    // 2. 创建服务配置
+    const serviceConfig = {
+        llmProvider: config.llmProvider,
+        planningProvider: config.providers?.planning,
+        branchProvider: config.providers?.branch,
+        contentProvider: config.providers?.content,
+        fileConfig: config.fileConfig,
+    };
+    // 3. 使用工厂创建所有默认服务
+    const services = createServices(serviceConfig);
+    // 4. 创建 Worker 配置
+    const workerConfig = {
+        temporalAddress: config.temporalAddress,
+        nativeConnection: config.nativeConnection,
+        taskQueue: config.taskQueue ?? 'persona-core-queue',
+        db: databaseHandle.db,
+        thinkingService: services.thinkingService,
+        actionService: services.actionService,
+        branchService: services.branchService,
+        connectTimeout: config.connectTimeout,
+    };
+    // 5. 创建 Worker
+    const workerHandle = await createWorker(workerConfig);
+    // 6. 返回句柄
+    return {
+        workerHandle,
+        databaseHandle,
+        shutdown: async () => {
+            // 优雅关闭 Worker
+            await workerHandle.shutdown();
+            // 只有自己创建的数据库连接才需要关闭
+            if (ownDatabase) {
+                await databaseHandle.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=personaWorker.js.map

package/dist/temporal/personaWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaWorker.js","sourceRoot":"","sources":["../../src/temporal/personaWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAA8B,MAAM,aAAa,CAAC;AAoGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA2B;IAE3B,mBAAmB;IACnB,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC;IAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzF,YAAY;IACZ,MAAM,aAAa,GAAkB;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ;QAC5C,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM;QACxC,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO;QAC1C,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IAEF,kBAAkB;IAClB,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAE/C,kBAAkB;IAClB,MAAM,YAAY,GAAiB;QACjC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,oBAAoB;QACnD,EAAE,EAAE,cAAc,CAAC,EAAE;QACrB,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;IAEF,eAAe;IACf,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAEtD,UAAU;IACV,OAAO;QACL,YAAY;QACZ,cAAc;QACd,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,cAAc;YACd,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB;YACpB,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}