@my-life-buddies/buddy-runtime 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,137 @@
+import type { AgentMessage, AgentOptions, AgentState } from "@earendil-works/pi-agent-core";
+/** 一个搭子在一场会话里的配置。形状照 pi 的 Agent 来。 */
+export type BuddyOptions = Pick<AgentOptions, "transformContext" | "beforeToolCall" | "afterToolCall" | "shouldStopAfterTurn" | "prepareNextTurnWithContext" | "thinkingBudgets" | "toolExecution"> & {
+    /** systemPrompt 必填；tools / thinkingLevel 可选。model / messages 不露——模型在 BuddyServer.start 的 model 里按 id 选、历史从平台灌 */
+    initialState: Pick<AgentState, "systemPrompt"> & Partial<Pick<AgentState, "tools" | "thinkingLevel">>;
+};
+/** 工厂：每场会话第一条消息到达时调一次。 */
+export type BuddyFactory = (conversation: Conversation) => BuddyOptions | Promise<BuddyOptions>;
+/** 一场会话。工厂和工具闭包都拿得到。 */
+export interface Conversation {
+    /** 平台的会话键：私聊 p_ 前缀、群 g_ 前缀。两场会话之间不该看得见对方 */
+    readonly key: string;
+    /** 行首带搭子 id */
+    readonly log: BuddyLogger;
+    /**
+     * 这场会话的记忆：搭子写给自己的长期印象，平台只存不读，按会话隔离，会话删除时平台一并清掉。
+     * 会话键已经绑好，调的时候不用传。失败（超配额、key 不合法、网络错误）直接 throw，文案是平台给的原因。
+     */
+    readonly memory: {
+        /** 全量列出，按 key 字典序。GET /internal/v1/memory */
+        list(): Promise<MemoryEntry[]>;
+        /** 覆盖写一条。key 是主题名：非空、不含空白与 /、≤64 字；text 单条 ≤16KB；每会话 ≤64 条、合计 ≤256KB。PUT /internal/v1/memory/:key */
+        write(key: string, text: string): Promise<void>;
+        /** 删一条，删不存在的也算成功。DELETE /internal/v1/memory/:key */
+        delete(key: string): Promise<void>;
+    };
+}
+/** 一条记忆：GET /internal/v1/memory 响应体 entries 里的每条 */
+export interface MemoryEntry {
+    /** 主题名 */
+    key: string;
+    text: string;
+    /** 最后写入时刻，毫秒 */
+    updatedAt: number;
+}
+export interface BuddyLogger {
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+export interface StartOptions {
+    buddy: BuddyFactory;
+    /** 模型 id，取值照平台 GET /cli/models 报的；不给就是 kimi-k3。整个进程的会话共用这一个 */
+    model?: string;
+}
+export interface BuddyServerHandle {
+    stop(): Promise<void>;
+}
+declare module "@earendil-works/pi-agent-core" {
+    interface CustomAgentMessages {
+        note: NoteMessage;
+    }
+}
+export interface NoteMessage {
+    role: "note";
+    text: string;
+    timestamp: number;
+}
+/** 读口每条记录 */
+export interface PlatformMessage {
+    /** 落库自增号，③ 唯一标识兼游标 */
+    seq: number;
+    /** message / checkin / tool / question / note / widget / messagesCard / system */
+    type: string;
+    /** user / buddy / platform */
+    author: string;
+    /** 正文；富类型这里是给人看的一行摘要 */
+    text: string;
+    /** 发言人显示名（群成员现名 / 私聊转发人）；搭子自己的消息不带 */
+    name?: string;
+    /** 群会话该句成员号快照 m_…，认人靠它 */
+    memberId?: string;
+    /** 落库时刻毫秒（含时间机器偏移） */
+    timestamp: number;
+    /** 平台算好的开口判定，只在对方侧消息上有 */
+    shouldReply?: boolean;
+    question?: unknown;
+    widget?: {
+        id: string;
+    };
+    messagesCard?: MessagesCard;
+    toolCalls?: PlatformToolCall[];
+    /** 该步推理原文，只有搭子自己的记录上有 */
+    thinking?: string;
+    /** 半截话，重建跳过 */
+    interrupted?: boolean;
+    quote?: {
+        name?: string;
+        text?: string;
+    };
+}
+export interface MessagesCard {
+    from?: string;
+    buddy?: string;
+    items: {
+        name?: string;
+        text?: string;
+        messagesCard?: MessagesCard;
+    }[];
+}
+export interface PlatformToolCall {
+    callId: string;
+    name: string;
+    /** 给平台排查看的一行 */
+    summary: string;
+    arguments?: unknown;
+    result?: string;
+}
+/** 写口每条：type 只能是 message / checkin / tool / question / widget / note */
+export interface OutgoingMessage {
+    type: "message" | "tool" | "note" | "widget";
+    text?: string;
+    timestamp?: number;
+    thinking?: string;
+    toolCalls?: PlatformToolCall[];
+    interrupted?: boolean;
+    widget?: {
+        id: string;
+    };
+    idempotencyKey?: string;
+}
+/** 读口响应。没有 context 字段 = 键已作废 */
+export interface PullResponse {
+    messages: PlatformMessage[];
+    context?: string;
+}
+/** 事件流分发出来的事件；welcome / data-access 在流那层就丢掉 */
+export type BuddyEvent = {
+    type: "message";
+    convoKey: string;
+} | {
+    type: "delete";
+    convoKey: string;
+};
+/** 一个 pi AgentMessage 在平台上的来处：rebuild 灌进来的记住 seq，出站时不重写 */
+export type Transcript = AgentMessage[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+// 开发者契约 + 模块间共享的类型。设计正本：REDoc《【技术设计】搭子 runtime 基座》。
+//
+// 开发者交一个工厂：buddy: (conversation) => BuddyOptions。BuddyOptions 里没有一个自造字段——
+// 名字和签名全部从 pi 的 AgentOptions / AgentState 上 Pick，运行时只做两件事：
+// 藏掉运行时独占的字段（streamFn / getApiKey / model / messages / convertToLlm / steeringMode …），
+// 把 systemPrompt 设成必填（没人设的搭子是 bug，类型上就拦）。
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,0EAA0E;AAC1E,2DAA2D;AAC3D,uFAAuF;AACvF,0CAA0C"}

package/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "@my-life-buddies/buddy-runtime",
+	"version": "0.0.1",
+	"type": "module",
+	"description": "MLB 搭子运行时，基于 pi-agent-core：订阅平台事件流、拉取消息、驱动模型、写回回复。开发者调用 BuddyServer.start 交一份配置即可跑起一只搭子",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist/"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc --noEmit -p tsconfig.json",
+		"test": "node --test src/*.test.ts src/conversation/*.test.ts src/tools/*.test.ts",
+		"prepublishOnly": "npm run build"
+	},
+	"dependencies": {
+		"@earendil-works/pi-agent-core": "0.85.1",
+		"@earendil-works/pi-ai": "0.85.1",
+		"typebox": "1.3.7"
+	},
+	"devDependencies": {
+		"@types/node": "^26.2.0",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	}
+}