@rxdrag/ai-shared 0.0.1

package/README.md

@@ -0,0 +1,9 @@
+# Summary
+
+Rxdrag Package
+
+# Contributors
+
+`@rxdrag/schema-pro` is maintained by:
+
+- Water.Li

package/dist/index.d.ts

@@ -0,0 +1,261 @@
+import { AgentRunUsage } from "@rxdrag/rxcms-models";
+/**
+ * Agent 类型定义
+ *
+ * 数据结构层次：
+ *   Thread（对话上下文）
+ *     └── Run（单次执行）
+ *           └── TimelineItem（事件记录）
+ *
+ * SSE 事件流：
+ *   run.status:running → thinking.delta → message.delta → tool.call → run.status:completed
+ */
+/** Agent 使用场景 */
+export type AgentScene = "studio" | "website";
+/** 对话线程 ID，创建数据库记录时自动生成 */
+export type AgentThreadId = string;
+/** 单次执行 ID */
+export type AgentRunId = string;
+/** Run 状态 */
+export type AgentRunStatus = "running" | "completed" | "error" | "cancelled";
+/** Thread 状态 */
+export type AgentThreadStatus = "idle" | "running" | "completed" | "error";
+/** 错误信息 */
+export type AgentError = {
+    message: string;
+    code?: string;
+};
+/** 消息角色 */
+export type AgentMessageRole = "user" | "assistant" | "system";
+/** 消息记录（独立存储用，Timeline 中使用 payload 形式） */
+export type AgentMessage = {
+    id: string;
+    threadId: AgentThreadId;
+    role: AgentMessageRole;
+    text: string;
+    createdAt: number;
+};
+/** 服务端工具调用状态 */
+export type ToolCallStatus = "pending" | "running" | "succeeded" | "failed";
+/** 服务端工具调用记录（独立存储用） */
+export type ToolCallRecord = {
+    id: string;
+    threadId: AgentThreadId;
+    name: string;
+    input: unknown;
+    output?: unknown;
+    error?: unknown;
+    status: ToolCallStatus;
+    startedAt?: number;
+    finishedAt?: number;
+    elapsedMs?: number;
+};
+/** 客户端工具调用状态 */
+export type ClientToolCallStatus = "awaiting_user" | "submitted" | "succeeded" | "failed" | "expired";
+/** 客户端工具调用记录（独立存储用） */
+export type ClientToolCallRecord = {
+    callId: string;
+    threadId: AgentThreadId;
+    name: string;
+    input: unknown;
+    output?: unknown;
+    error?: unknown;
+    status: ClientToolCallStatus;
+    createdAt: number;
+    updatedAt: number;
+};
+/**
+ * Timeline 事件类型
+ * - message: 用户或 AI 的消息
+ * - tool_call: 服务端工具调用
+ * - client_tool_call: 客户端工具调用（需要前端交互）
+ * - thinking: AI 推理过程（如 DeepSeek R1）
+ * - plan: 任务计划/TodoList
+ */
+export type AgentTimelineKind = "message" | "tool_call" | "client_tool_call" | "thinking" | "plan";
+/** 消息类型的 payload */
+export type AgentTimelinePayloadMessage = {
+    role: AgentMessageRole;
+    text: string;
+};
+/** 服务端工具调用的 payload */
+export type AgentTimelinePayloadToolCall = {
+    callId: string;
+    name: string;
+    status: ToolCallStatus;
+    input?: unknown;
+    output?: unknown;
+    error?: unknown;
+    elapsedMs?: number;
+};
+/** 客户端工具调用的 payload */
+export type AgentTimelinePayloadClientToolCall = {
+    callId: string;
+    name: string;
+    status: ClientToolCallStatus;
+    input?: unknown;
+    output?: unknown;
+    error?: unknown;
+};
+/** 推理过程的 payload */
+export type AgentTimelinePayloadThinking = {
+    text: string;
+};
+/** 计划项状态 */
+export type PlanItemStatus = "pending" | "in_progress" | "completed";
+/** 计划项 */
+export type PlanItem = {
+    id: string;
+    step: string;
+    status: PlanItemStatus;
+};
+/** 任务计划的 payload */
+export type AgentTimelinePayloadPlan = {
+    explanation?: string;
+    items: PlanItem[];
+};
+/** Timeline payload 联合类型 */
+export type AgentTimelinePayload = AgentTimelinePayloadMessage | AgentTimelinePayloadToolCall | AgentTimelinePayloadClientToolCall | AgentTimelinePayloadThinking | AgentTimelinePayloadPlan | Record<string, unknown>;
+/**
+ * Timeline 事件项
+ * DB 存储结构：通用列 + payload(JSON)
+ */
+export type AgentTimelineItem = {
+    id: string;
+    kind: AgentTimelineKind;
+    createdAt: number;
+    updatedAt: number;
+    payload: AgentTimelinePayload;
+};
+/** 用户上传的附件 */
+export type AgentAttachment = {
+    type: "image" | "file";
+    url: string;
+    name?: string;
+    mimeType?: string;
+};
+/**
+ * Run 状态变更事件
+ * - running: 开始执行，携带 userMessage 和 attachments
+ * - completed: 执行完成，携带 usage
+ * - error: 执行出错
+ * - cancelled: 被取消
+ */
+export type SseRunStatusEvent = {
+    event: "run.status";
+    data: {
+        status: "running" | "completed" | "error" | "cancelled";
+        threadId?: string;
+        runId: string;
+        websiteId?: string;
+        userMessage?: string;
+        attachments?: AgentAttachment[];
+        usage?: AgentRunUsage;
+    };
+};
+/** AI 回复流式输出（增量） */
+export type SseMessageDeltaEvent = {
+    event: "message.delta";
+    data: {
+        runId: string;
+        delta: string;
+    };
+};
+/** AI 回复完成 */
+export type SseMessageCompletedEvent = {
+    event: "message.completed";
+    data: {
+        runId: string;
+        text: string;
+    };
+};
+/** 服务端工具调用开始 */
+export type SseToolCallEvent = {
+    event: "tool.call";
+    data: {
+        runId: string;
+        callId: string;
+        name: string;
+        input: unknown;
+    };
+};
+/** 服务端工具调用成功 */
+export type SseToolResultEvent = {
+    event: "tool.result";
+    data: {
+        runId: string;
+        callId: string;
+        name: string;
+        input: unknown;
+        output: unknown;
+        elapsedMs?: number;
+    };
+};
+/** 服务端工具调用失败 */
+export type SseToolErrorEvent = {
+    event: "tool.error";
+    data: {
+        runId: string;
+        callId: string;
+        name: string;
+        input: unknown;
+        error: unknown;
+        elapsedMs?: number;
+    };
+};
+/** 客户端工具调用（需要前端交互，如确认弹窗） */
+export type SseClientToolCallEvent = {
+    event: "client_tool.call";
+    data: {
+        runId: string;
+        callId: string;
+        name: string;
+        input: unknown;
+    };
+};
+/** 客户端工具调用结果（前端提交） */
+export type SseClientToolResultEvent = {
+    event: "client_tool.result";
+    data: {
+        runId: string;
+        callId: string;
+        name: string;
+        output: unknown;
+    };
+};
+/** AI 推理过程流式输出（增量） */
+export type SseThinkingDeltaEvent = {
+    event: "thinking.delta";
+    data: {
+        runId: string;
+        delta: string;
+    };
+};
+/** AI 推理过程完成 */
+export type SseThinkingCompletedEvent = {
+    event: "thinking.completed";
+    data: {
+        runId: string;
+        text: string;
+    };
+};
+/** 任务计划更新 */
+export type SsePlanUpdateEvent = {
+    event: "plan.update";
+    data: {
+        runId: string;
+        explanation?: string;
+        items: PlanItem[];
+    };
+};
+/** 错误事件（可关联到具体 run） */
+export type SseErrorEvent = {
+    event: "error";
+    data: {
+        runId?: string;
+        message: string;
+        code?: string;
+    };
+};
+/** 所有 SSE 事件的联合类型 */
+export type AgentSseEvent = SseRunStatusEvent | SseMessageDeltaEvent | SseMessageCompletedEvent | SseThinkingDeltaEvent | SseThinkingCompletedEvent | SsePlanUpdateEvent | SseToolCallEvent | SseToolResultEvent | SseToolErrorEvent | SseClientToolCallEvent | SseClientToolResultEvent | SseErrorEvent;

package/dist/index.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@rxdrag/ai-shared",
+  "version": "0.0.1",
+  "author": "Water.Li",
+  "module": "dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "*",
+    "eslint": "^9.39.2",
+    "@rxdrag/tsconfig": "0.2.1",
+    "@rxdrag/eslint-config-custom": "0.2.13",
+    "@rxdrag/rxcms-models": "0.3.99"
+  },
+  "scripts": {
+    "lint": "eslint . --ext .ts,tsx",
+    "clean": "rimraf -rf .turbo && rimraf -rf node_modules && rimraf -rf dist",
+    "build": "vite build"
+  },
+  "typings": "dist/index.d.ts"
+}