@my-life-buddies/buddy-runtime 0.0.1

package/README.md

@@ -0,0 +1,175 @@
+# @my-life-buddies/buddy-runtime
+
+MLB 搭子运行时。基于 [`@earendil-works/pi-agent-core`](https://www.npmjs.com/package/@earendil-works/pi-agent-core) 构建，负责搭子与 MLB 平台之间的全部交互：订阅事件流、拉取消息、驱动模型、写回回复、推送在线状态。开发者只需提供搭子的配置。
+
+## 安装
+
+```bash
+npm install @my-life-buddies/buddy-runtime typebox
+```
+
+要求 Node.js ≥ 22.19。
+
+## 快速开始
+
+```
+my-buddy/
+├─ package.json
+├─ .env              MLB_BUDDY_ID / MLB_BUDDY_TOKEN
+└─ src/main.ts
+```
+
+```ts
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { BuddyServer } from "@my-life-buddies/buddy-runtime";
+import { Type } from "typebox";
+
+const PLAN_MENU_PARAMS = Type.Object({ date: Type.String() });
+
+const planMenu: AgentTool<typeof PLAN_MENU_PARAMS, undefined> = {
+	name: "plan_menu",
+	label: "正在排菜单",
+	description: "给某一天排三餐。",
+	parameters: PLAN_MENU_PARAMS,
+	execute: async (_id, { date }) => ({
+		content: [{ type: "text", text: `${date} 的三餐排好了。` }],
+		details: undefined,
+	}),
+};
+
+await BuddyServer.start({
+	model: "kimi-k3",   // 可选，不填为 kimi-k3；可选值见开发者接口 GET /cli/models
+	buddy: () => ({
+		initialState: {
+			systemPrompt: "你是「小涂阿姨」——一位管做饭的阿姨……",
+			tools: [planMenu],
+		},
+	}),
+});
+```
+
+```json
+{
+	"scripts": {
+		"start": "node --env-file-if-exists=.env src/main.ts"
+	}
+}
+```
+
+完整示例见 [examples/aunt-tu/](examples/aunt-tu/)。
+
+## API
+
+### `BuddyServer.start(options)`
+
+启动搭子进程，连接平台事件流。返回 `{ stop(): Promise<void> }`。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `options.model` | `string`，可选 | 模型 id，取值见平台 `GET /cli/models`；不填为 `kimi-k3`。进程内所有会话共用。id 在运行时内置的模型目录中不存在时启动失败 |
+| `options.buddy` | `(conversation: Conversation) => BuddyOptions \| Promise<BuddyOptions>` | 搭子配置工厂。每场会话在第一条消息到达时调用一次 |
+
+### `BuddyOptions`
+
+配置的形状与字段名与 pi-agent-core 的 `AgentOptions` / `AgentState` 一致，签名请参考 pi 的文档。
+
+```ts
+type BuddyOptions =
+	Pick<AgentOptions,
+		| "transformContext" | "beforeToolCall" | "afterToolCall"
+		| "shouldStopAfterTurn" | "prepareNextTurnWithContext"
+		| "thinkingBudgets" | "toolExecution">
+	& { initialState: Pick<AgentState, "systemPrompt"> & Partial<Pick<AgentState, "tools" | "thinkingLevel">> };
+```
+
+| 字段 | 说明 |
+|---|---|
+| `initialState.systemPrompt` | 系统提示。静态内容；每回合变化的信息不应写在这里 |
+| `initialState.tools` | 工具列表，类型为 pi 的 `AgentTool`。`label` 为必填，用作用户可见的状态行文案（空字符串表示不显示）；`execute` 返回值的 `details` 为必填（可为 `undefined`）；执行失败应直接抛出异常。工具名不得与官方工具或其他工具重复。先单独声明为 `AgentTool<typeof 参数 schema>` 再放入数组，`execute` 的参数才有类型；直接写在数组里时参数类型为 `unknown` |
+| `initialState.thinkingLevel` | 思考级别，默认 `off`。`off` 时 kimi-k3 不发送思考参数，由模型默认行为决定；kimi-k2.6、deepseek-v4-flash、deepseek-v4-pro 发送关闭思考的参数 |
+| `transformContext` | 历史裁剪。开发者的函数先执行，运行时随后插入平台下发的会话上下文 |
+| `beforeToolCall` / `afterToolCall` / `shouldStopAfterTurn` / `prepareNextTurnWithContext` / `thinkingBudgets` / `toolExecution` | 原样传递给 pi |
+
+密钥、会话历史、会话标识与插话策略由运行时统一管理，不对开发者开放。模型通过 `BuddyServer.start` 的 `model` 选择。
+
+### `Conversation`
+
+```ts
+interface Conversation {
+	readonly key: string;        // 会话键：私聊为 p_ 前缀，群聊为 g_ 前缀
+	readonly log: BuddyLogger;
+	readonly memory: {
+		list(): Promise<MemoryEntry[]>;                   // 全量列出，按 key 字典序
+		write(key: string, text: string): Promise<void>;  // 覆盖写一条
+		delete(key: string): Promise<void>;               // 删一条，删不存在的也算成功
+	};
+}
+
+interface MemoryEntry {
+	key: string;        // 主题名
+	text: string;
+	updatedAt: number;  // 最后写入时刻，毫秒
+}
+```
+
+传入配置工厂，可在工具闭包中使用。会话之间的数据应以 `key` 隔离。
+
+`memory` 是这场会话的长期记忆，由平台保存，只在本会话内可见，会话删除时平台一并清除；会话键已经绑好，调用时无需传入。`key` 为主题名（非空、不含空白与 `/`，最长 64 字），`text` 单条不超过 16KB；每场会话最多 64 条、合计不超过 256KB。超出配额、`key` 不合法或网络出错时直接抛出异常，异常信息为平台给出的原因；在工具的 `execute` 中调用时，模型能看到这个原因。
+
+```ts
+const REMEMBER_PARAMS = Type.Object({ topic: Type.String(), text: Type.String() });
+
+await BuddyServer.start({
+	buddy: (conversation) => {
+		const remember: AgentTool<typeof REMEMBER_PARAMS, undefined> = {
+			name: "remember",
+			label: "正在记下",
+			description: "把一条关于对方的印象记下来，同一主题覆盖旧的。",
+			parameters: REMEMBER_PARAMS,
+			execute: async (_id, { topic, text }) => {
+				await conversation.memory.write(topic, text);
+				return { content: [{ type: "text", text: "记下了。" }], details: undefined };
+			},
+		};
+		return { initialState: { systemPrompt: PERSONA, tools: [remember] } };
+	},
+});
+```
+
+完整示例见 [examples/aunt-tu/](examples/aunt-tu/)：`taste_read` / `taste_write` 两个工具用 `memory` 记每个人爱吃什么、不爱吃什么。
+
+### Buddy 内置 Tools
+
+**小挂件**：运行时根据搭子在平台上登记的小挂件类型自动装配，无需配置：`widget_create`、`widget_write`、`widget_read`、`widget_delete`、`widget_send`（把小挂件发进聊天流）。系统提示中可按名称引用。
+
+**资料读取**：`loadResources` / `resourceCatalog` / `readResourceTool` 三个函数，用于让模型按需读取 markdown 资料。
+
+```ts
+import { BuddyServer, loadResources, readResourceTool, resourceCatalog } from "@my-life-buddies/buddy-runtime";
+
+const resources = loadResources("resources");   // 递归收集目录下全部 .md 文件
+await BuddyServer.start({
+	buddy: () => ({
+		initialState: {
+			systemPrompt: `${PERSONA}\n\n${resourceCatalog(resources)}`,   // 资料清单附在系统提示之后
+			tools: [readResourceTool(resources)],                         // 装配 read_resource 工具
+		},
+	}),
+});
+```
+
+## 环境变量
+
+| 变量 | 说明 |
+|---|---|
+| `MLB_BUDDY_ID` | 搭子 id，注册时由平台分配 |
+| `MLB_BUDDY_TOKEN` | 搭子令牌，注册时由平台分配 |
+
+网关地址无需配置，搭子连接测试平台 ecs-test（`http://47.116.168.81:8788`）。
+
+搭子的档案（名称、头像、简介）由平台保存：注册时通过 `POST /cli/buddies` 提交，修改通过 `PUT /cli/buddies/:id/meta`。搭子进程不监听端口、不接收入站请求。从非回环地址连接网关时，平台将其识别为 `<id>-dev` 分身，会话与正式身份隔离。
+
+## 开发
+
+- `npm run dev`：以 `node --watch` 启动，文件变更后自动重启。停止时需终止整个进程树（`pkill -f "node --watch .* src/main.ts"`），仅终止子进程会被父进程重新拉起。
+- 运行时仓库：`npm test`、`npm run typecheck`、`npm run build`。

package/dist/conversation/agent.d.ts

@@ -0,0 +1,24 @@
+import { Agent } from "@earendil-works/pi-agent-core";
+import type { AgentEvent, StreamFn } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { MLBClient, WidgetType } from "../mlbClient.ts";
+import type { BuddyFactory, BuddyLogger } from "../types.ts";
+export interface AgentDeps {
+    key: string;
+    buddyId: string;
+    client: MLBClient;
+    model: Model<Api>;
+    streamFn: StreamFn;
+    /** 搭子令牌：经 Agent 的 getApiKey 交给模型通道，变成 Authorization: Bearer 头 */
+    token: string;
+    widgetTypes: () => Promise<WidgetType[]>;
+    factory: BuddyFactory;
+    log: BuddyLogger;
+    /** 每次模型调用前现取平台 context 段；空就不插 */
+    contextOf: () => string | undefined;
+    /** Agent 事件的去处。pi 会等它返回，所以只能同步做事 */
+    onEvent: (agent: Agent, event: AgentEvent) => void;
+}
+/** 跑开发者工厂拿配置，叠上运行时预置，建 Agent。工具名跟小挂件工具重名或互相重名 → throw。 */
+export declare function createAgent(deps: AgentDeps): Promise<Agent>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/conversation/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/conversation/agent.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAa,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;AAEzF,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,WAAW,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,oCAAoC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACnD;AAED,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAgFjE"}

package/dist/conversation/agent.js

@@ -0,0 +1,94 @@
+// 一场会话的 Agent 怎么建：运行时先把该填的填好，开发者的配置叠上去。
+// 管：拼好交给开发者工厂的 Conversation（会话键、日志、绑好会话键的 memory 三个方法），跑工厂拿配置；小挂件工具排在开发者工具前面并查重名；
+//     钩子叠加——开发者的 transformContext 先跑、运行时最后插平台 context 段；开发者的 beforeToolCall 包 try/catch 抛了按放行；其余直通；
+//     每次请求模型，transformContext 入参 / 出参、convertToLlm 出参、请求体（onPayload）全量打日志。
+// 不管：Agent 建好之后的事（回合、事件分发在 index.ts）。
+import { Agent } from "@earendil-works/pi-agent-core";
+import { convertToLlm, injectContext } from "./convert.js";
+import { errorText } from "../log.js";
+import { widgetTools } from "../tools/widgets.js";
+/** 跑开发者工厂拿配置，叠上运行时预置，建 Agent。工具名跟小挂件工具重名或互相重名 → throw。 */
+export async function createAgent(deps) {
+    const conversation = {
+        key: deps.key,
+        log: deps.log,
+        memory: {
+            list: () => deps.client.memoryList(deps.key),
+            write: (key, text) => deps.client.memoryWrite(deps.key, key, text),
+            delete: (key) => deps.client.memoryDelete(deps.key, key),
+        },
+    };
+    const options = await deps.factory(conversation);
+    const types = await deps.widgetTypes();
+    const tools = [...widgetTools(deps.client, deps.key, types), ...(options.initialState.tools ?? [])];
+    const seen = new Set();
+    for (const tool of tools) {
+        if (seen.has(tool.name))
+            throw new Error(`工具重名：${tool.name}`);
+        seen.add(tool.name);
+    }
+    const { log, key } = deps;
+    const devTransform = options.transformContext;
+    const devBefore = options.beforeToolCall;
+    const agent = new Agent({
+        streamFn: deps.streamFn,
+        getApiKey: () => deps.token,
+        sessionId: `buddy:${deps.buddyId}:${key}`,
+        initialState: {
+            model: deps.model,
+            systemPrompt: options.initialState.systemPrompt,
+            tools,
+            thinkingLevel: options.initialState.thinkingLevel ?? "off",
+        },
+        steeringMode: "all",
+        followUpMode: "all",
+        // 下面三个钩子按 pi 每次请求模型时的调用顺序排：transformContext → convertToLlm → onPayload，每一步的全量都打一行日志
+        // 返回的是新数组（injectContext 不动传进来的）；context 为空就原样交回去，不插
+        transformContext: async (messages, signal) => {
+            log.info("transformContext 入参", { convoKey: key, messages });
+            let base = messages;
+            if (devTransform !== undefined) {
+                try {
+                    base = await devTransform(messages, signal);
+                }
+                catch (e) {
+                    log.warn("开发者的 transformContext 抛错，用原历史", { convoKey: key, error: errorText(e) });
+                    base = messages;
+                }
+                log.info("开发者 transformContext 出参", { convoKey: key, messages: base });
+            }
+            const injected = injectContext(base, deps.contextOf());
+            log.info("injectContext 出参", { convoKey: key, messages: injected });
+            return injected;
+        },
+        convertToLlm: (messages) => {
+            const llmMessages = convertToLlm(messages);
+            log.info("convertToLlm 出参", { convoKey: key, messages: llmMessages });
+            return llmMessages;
+        },
+        // 只打日志、返回 undefined：返回别的值 pi-ai 会拿它顶替请求体发出去
+        onPayload: (payload) => {
+            log.info("模型请求体", { convoKey: key, payload });
+            return undefined;
+        },
+        beforeToolCall: devBefore === undefined
+            ? undefined
+            : async (context, signal) => {
+                try {
+                    return await devBefore(context, signal);
+                }
+                catch (e) {
+                    log.warn("开发者的 beforeToolCall 抛错，按放行", { convoKey: key, tool: context.toolCall.name, error: errorText(e) });
+                    return undefined;
+                }
+            },
+        afterToolCall: options.afterToolCall,
+        shouldStopAfterTurn: options.shouldStopAfterTurn,
+        prepareNextTurnWithContext: options.prepareNextTurnWithContext,
+        thinkingBudgets: options.thinkingBudgets,
+        toolExecution: options.toolExecution,
+    });
+    agent.subscribe((event) => deps.onEvent(agent, event));
+    return agent;
+}
+//# sourceMappingURL=agent.js.map

package/dist/conversation/agent.js.map

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

package/dist/conversation/convert.d.ts

@@ -0,0 +1,46 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { AssistantMessage, Message, ToolResultMessage } from "@earendil-works/pi-ai";
+import type { NoteMessage, OutgoingMessage, PlatformMessage } from "../types.ts";
+/** 重建 assistant 消息时抄的模型身份（model.ts 的 modelIdentity 给） */
+export interface ModelIdentity {
+    api: string;
+    provider: string;
+    model: string;
+}
+/**
+ * 把一批平台记录换成 pi 的历史。跳过的：interrupted 的半截话、question / widget、空正文又没工具调用的搭子记录。
+ * 对方的 message 变 user（群里带成员前缀）、system 变 user（带「群里发生了一件事」）、messagesCard 拍平成 user；
+ * 搭子的 message / checkin 变 assistant，tool 变 assistant + 每个调用一条 toolResult，note 变 note。
+ */
+export declare function toAgentMessages(records: PlatformMessage[], identity: ModelIdentity): AgentMessage[];
+/**
+ * 不带工具调用的 assistant 消息写成 message 记录。
+ * 正常收尾的照写（带 thinking）；error / aborted 收尾但已经说了半截的写成 interrupted；其余不写。
+ */
+export declare function outboundFromAssistant(m: AssistantMessage): OutgoingMessage | null;
+/**
+ * 带工具调用的 assistant 消息连同它的结果写成一条 tool 记录；每个调用的 summary 取工具的 label，没有 label 用名字。
+ * 没有工具调用的返回 null（那种走 outboundFromAssistant）。
+ */
+export declare function outboundFromTurn(m: AssistantMessage, toolResults: ToolResultMessage[], tools: {
+    name: string;
+    label: string;
+}[]): OutgoingMessage | null;
+/** note 消息写成 note 记录 */
+export declare function outboundFromNote(n: NoteMessage): OutgoingMessage;
+/** assistant 消息里所有 thinking 块的推理原文拼起来；一个字都没有返回 undefined */
+export declare function thinkingOf(m: AssistantMessage): string | undefined;
+/** assistant 消息里所有 text 块的正文拼起来 */
+export declare function textOf(m: AssistantMessage): string;
+/**
+ * 交给 pi 的 convertToLlm：note 变 user；相邻两条 user 合并成一条（正文中间隔一个换行）；user / assistant / toolResult 原样。
+ * 返回的是新数组，合并出来的也是新对象，不改传进来的消息。
+ */
+export declare const convertToLlm: (messages: AgentMessage[]) => Message[];
+/**
+ * 把平台随拉取下发的 context 段插进历史：找到末尾那段连续的 user（note 也算，它到模型那边就是 user），插在这段前面，
+ * 后面的 convertToLlm 会把它跟这段合并；末尾是 assistant / toolResult 时，往前找最后一段 user 插在它前面。
+ * context 为空原样返回；否则返回新数组，不改传进来的。
+ */
+export declare function injectContext(messages: AgentMessage[], context: string | undefined): AgentMessage[];
+//# sourceMappingURL=convert.d.ts.map

package/dist/conversation/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/conversation/convert.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACX,gBAAgB,EAEhB,OAAO,EAIP,iBAAiB,EAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAgB,WAAW,EAAE,eAAe,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAEjH,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AA6BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,GAAG,YAAY,EAAE,CAgCnG;AAgFD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG,eAAe,GAAG,IAAI,CAQjF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,CAAC,EAAE,gBAAgB,EACnB,WAAW,EAAE,iBAAiB,EAAE,EAChC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACtC,eAAe,GAAG,IAAI,CAkBxB;AAED,wBAAwB;AACxB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,eAAe,CAEhE;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAMlE;AAED,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAKlD;AAYD;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,YAAY,EAAE,KAAG,OAAO,EAa9D,CAAC;AA8BF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE,CAQnG"}

package/dist/conversation/convert.js

@@ -0,0 +1,275 @@
+// 平台记录与 pi 消息之间的换算。只管形状换算，不碰网络、不碰 Agent、不管游标和幂等键。
+// 入站：把 GET /internal/v1/messages 拉回来的记录换成 pi 的 AgentMessage（重建历史、灌对方的话都用它）。
+// 出站：把 pi 跑出来的 assistant / toolResult / note 换成 POST /internal/v1/messages 的每条 body。
+// 另外两件给 Agent 用的事也在这：convertToLlm（note 变 user、相邻 user 合并）和 injectContext（把平台 context 段插进历史末尾）。
+/** 工具结果没回来（回合被中断）时，写给模型和平台的占位文本 */
+const MISSING_TOOL_RESULT = "（工具结果未返回：回合被中断）";
+/** system 记录换成 user 消息时加在正文前的说明 */
+const SYSTEM_EVENT_PREFIX = "（群里发生了一件事）";
+/** 转发卡最多展开几层，再深的一层写成一句省略 */
+const CARD_MAX_DEPTH = 3;
+const CARD_TOO_DEEP = "（更深的转发略）";
+/** 重建出来的 thinking 块用的签名：pi 的 openai-completions 回放时按它把推理原文写回 reasoning_content 字段 */
+const THINKING_SIGNATURE = "reasoning_content";
+/** 重建的 assistant 消息没有真实用量，全零；形状照 pi-agent-core 的 EMPTY_USAGE */
+function emptyUsage() {
+    return {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens: 0,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+}
+// —— 入站：平台记录 → pi AgentMessage
+/**
+ * 把一批平台记录换成 pi 的历史。跳过的：interrupted 的半截话、question / widget、空正文又没工具调用的搭子记录。
+ * 对方的 message 变 user（群里带成员前缀）、system 变 user（带「群里发生了一件事」）、messagesCard 拍平成 user；
+ * 搭子的 message / checkin 变 assistant，tool 变 assistant + 每个调用一条 toolResult，note 变 note。
+ */
+export function toAgentMessages(records, identity) {
+    const out = [];
+    for (const record of records) {
+        if (record.interrupted)
+            continue;
+        const text = record.text ?? "";
+        switch (record.type) {
+            case "system":
+                out.push(userMessage(SYSTEM_EVENT_PREFIX + text, record.timestamp));
+                break;
+            case "messagesCard":
+                if (record.messagesCard)
+                    out.push(userMessage(flattenCard(record.messagesCard, 1).join("\n"), record.timestamp));
+                break;
+            case "message":
+            case "checkin":
+                if (record.author === "buddy") {
+                    if (text)
+                        out.push(assistantMessage(record, [...thinkingBlocks(record.thinking), { type: "text", text }], "stop", identity));
+                }
+                else if (record.type === "message" && text) {
+                    out.push(userMessage(memberPrefix(record) + text, record.timestamp));
+                }
+                break;
+            case "tool":
+                if (record.author === "buddy")
+                    out.push(...toolTurn(record, text, identity));
+                break;
+            case "note":
+                if (record.author === "buddy" && text)
+                    out.push({ role: "note", text, timestamp: record.timestamp });
+                break;
+            default:
+                // question / widget 和别的类型：模型不需要
+                break;
+        }
+    }
+    return out;
+}
+/** 搭子的 tool 记录：一条带 toolCall 块的 assistant，后面每个调用跟一条 toolResult */
+function toolTurn(record, text, identity) {
+    const calls = record.toolCalls ?? [];
+    if (!text && calls.length === 0)
+        return [];
+    const content = [...thinkingBlocks(record.thinking)];
+    if (text)
+        content.push({ type: "text", text });
+    for (const call of calls)
+        content.push({ type: "toolCall", id: call.callId, name: call.name, arguments: argumentsOf(call) });
+    const assistant = assistantMessage(record, content, calls.length > 0 ? "toolUse" : "stop", identity);
+    const results = calls.map((call) => ({
+        role: "toolResult",
+        toolCallId: call.callId,
+        toolName: call.name,
+        content: [{ type: "text", text: call.result ?? MISSING_TOOL_RESULT }],
+        isError: call.result === undefined,
+        timestamp: record.timestamp,
+    }));
+    return [assistant, ...results];
+}
+function assistantMessage(record, content, stopReason, identity) {
+    return {
+        role: "assistant",
+        content,
+        api: identity.api,
+        provider: identity.provider,
+        model: identity.model,
+        usage: emptyUsage(),
+        stopReason,
+        timestamp: record.timestamp,
+    };
+}
+function userMessage(text, timestamp) {
+    return { role: "user", content: [{ type: "text", text }], timestamp };
+}
+/** 有推理原文才放 thinking 块，没有就一个不放 */
+function thinkingBlocks(thinking) {
+    return thinking ? [{ type: "thinking", thinking, thinkingSignature: THINKING_SIGNATURE }] : [];
+}
+/** pi 的 toolCall 块要 arguments 是对象；平台存的不是对象就当空参数 */
+function argumentsOf(call) {
+    const value = call.arguments;
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+/** 群成员说的话前面标谁说的：有成员号写 `[名字 #m_…] `，没成员号只写 `[名字] `；私聊没名字不标 */
+function memberPrefix(record) {
+    const name = record.name;
+    const memberId = record.memberId;
+    if (name && memberId)
+        return `[${name} #${memberId}] `;
+    if (name)
+        return `[${name}] `;
+    if (memberId)
+        return `[#${memberId}] `;
+    return "";
+}
+/** 转发卡拍平成行：每条先一行 `【名字】`，正文原样跟一行；嵌套卡接着展开，超过层数上限写一句省略 */
+function flattenCard(card, depth) {
+    const lines = [];
+    for (const item of card.items ?? []) {
+        lines.push(`【${item.name ?? ""}】`);
+        if (item.text)
+            lines.push(item.text);
+        if (item.messagesCard) {
+            if (depth >= CARD_MAX_DEPTH)
+                lines.push(CARD_TOO_DEEP);
+            else
+                lines.push(...flattenCard(item.messagesCard, depth + 1));
+        }
+    }
+    return lines;
+}
+// —— 出站：pi 消息 → 平台写口的每条 body
+/**
+ * 不带工具调用的 assistant 消息写成 message 记录。
+ * 正常收尾的照写（带 thinking）；error / aborted 收尾但已经说了半截的写成 interrupted；其余不写。
+ */
+export function outboundFromAssistant(m) {
+    if (m.content.some((block) => block.type === "toolCall"))
+        return null;
+    const text = textOf(m);
+    if (m.stopReason === "error" || m.stopReason === "aborted") {
+        return text ? { type: "message", text, interrupted: true } : null;
+    }
+    const thinking = thinkingOf(m);
+    return thinking === undefined ? { type: "message", text } : { type: "message", text, thinking };
+}
+/**
+ * 带工具调用的 assistant 消息连同它的结果写成一条 tool 记录；每个调用的 summary 取工具的 label，没有 label 用名字。
+ * 没有工具调用的返回 null（那种走 outboundFromAssistant）。
+ */
+export function outboundFromTurn(m, toolResults, tools) {
+    const calls = m.content.filter((block) => block.type === "toolCall");
+    if (calls.length === 0)
+        return null;
+    const toolCalls = calls.map((call) => {
+        const result = toolResults.find((r) => r.toolCallId === call.id);
+        const label = tools.find((t) => t.name === call.name)?.label;
+        return {
+            callId: call.id,
+            name: call.name,
+            summary: label || call.name,
+            arguments: call.arguments,
+            result: result === undefined ? MISSING_TOOL_RESULT : resultText(result),
+        };
+    });
+    const thinking = thinkingOf(m);
+    const record = { type: "tool", text: textOf(m), toolCalls };
+    if (thinking !== undefined)
+        record.thinking = thinking;
+    return record;
+}
+/** note 消息写成 note 记录 */
+export function outboundFromNote(n) {
+    return { type: "note", text: n.text };
+}
+/** assistant 消息里所有 thinking 块的推理原文拼起来；一个字都没有返回 undefined */
+export function thinkingOf(m) {
+    const thinking = m.content
+        .filter((block) => block.type === "thinking")
+        .map((block) => block.thinking)
+        .join("");
+    return thinking === "" ? undefined : thinking;
+}
+/** assistant 消息里所有 text 块的正文拼起来 */
+export function textOf(m) {
+    return m.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}
+/** 工具结果的文本：多个 text 块用换行接起来（跟 pi 的 openai-completions 回放时一样） */
+function resultText(result) {
+    return result.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+}
+// —— 给 Agent 用的两个钩子
+/**
+ * 交给 pi 的 convertToLlm：note 变 user；相邻两条 user 合并成一条（正文中间隔一个换行）；user / assistant / toolResult 原样。
+ * 返回的是新数组，合并出来的也是新对象，不改传进来的消息。
+ */
+export const convertToLlm = (messages) => {
+    const out = [];
+    for (const m of messages) {
+        const next = toLlmMessage(m);
+        if (next === undefined)
+            continue;
+        const prev = out[out.length - 1];
+        if (next.role === "user" && prev !== undefined && prev.role === "user") {
+            out[out.length - 1] = mergeUsers(prev, next);
+        }
+        else {
+            out.push(next);
+        }
+    }
+    return out;
+};
+/** 一条 AgentMessage 到模型那边是什么：note 变 user；pi harness 自己并进来的那几种 role（bashExecution / custom / …）这个运行时不产生，照 pi 默认 convertToLlm 的做法不给模型 */
+function toLlmMessage(m) {
+    switch (m.role) {
+        case "note":
+            return userMessage(m.text, m.timestamp);
+        case "user":
+        case "assistant":
+        case "toolResult":
+            return m;
+        default:
+            return undefined;
+    }
+}
+function mergeUsers(a, b) {
+    const blocks = [...userBlocks(a), ...userBlocks(b)];
+    const text = blocks
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+    const images = blocks.filter((block) => block.type === "image");
+    return { role: "user", content: [{ type: "text", text }, ...images], timestamp: a.timestamp };
+}
+function userBlocks(m) {
+    return typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
+}
+/**
+ * 把平台随拉取下发的 context 段插进历史：找到末尾那段连续的 user（note 也算，它到模型那边就是 user），插在这段前面，
+ * 后面的 convertToLlm 会把它跟这段合并；末尾是 assistant / toolResult 时，往前找最后一段 user 插在它前面。
+ * context 为空原样返回；否则返回新数组，不改传进来的。
+ */
+export function injectContext(messages, context) {
+    if (!context)
+        return messages;
+    let last = messages.length - 1;
+    while (last >= 0 && !isUserSide(messages[last]))
+        last--;
+    let start = last < 0 ? messages.length : last;
+    while (start > 0 && isUserSide(messages[start - 1]))
+        start--;
+    const injected = userMessage(context, Date.now());
+    return [...messages.slice(0, start), injected, ...messages.slice(start)];
+}
+function isUserSide(m) {
+    return m.role === "user" || m.role === "note";
+}
+//# sourceMappingURL=convert.js.map

package/dist/conversation/convert.js.map

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