@next-open-ai/openbot 0.6.8 → 0.6.16

package/dist/core/memory/persist-compaction-on-close.js

@@ -0,0 +1,32 @@
+/**
+ * 会话关闭时将内存中缓存的 compaction summary 写入向量库的纯逻辑，便于单测且与 AgentManager 解耦。
+ */
+const COMPOSITE_KEY_SEP = "::";
+/**
+ * 将 map 中指定 compositeKey 的 summary 写入 addMemory 并从 map 删除；用于 Session 关闭前。
+ * 写入采用 fire-and-forget，不阻塞调用方，避免 agent.chat 等请求被 addMemory/embed 拖住导致无回复。
+ */
+export async function persistStoredCompactionForSession(sessionLatestCompactionSummary, compositeKey, addMemory) {
+    const summary = sessionLatestCompactionSummary.get(compositeKey);
+    sessionLatestCompactionSummary.delete(compositeKey);
+    if (summary?.trim()) {
+        const sessionId = compositeKey.split(COMPOSITE_KEY_SEP)[0];
+        void addMemory(summary.trim(), { infotype: "compaction", sessionId }).catch(() => { });
+    }
+}
+/**
+ * 将 map 中所有给定 keys（需以 sessionId + "::" 为前缀）的 summary 依次写入 addMemory 并删除；用于按业务 sessionId 关闭时。
+ * 写入采用 fire-and-forget，不阻塞调用方。
+ */
+export async function persistStoredCompactionForBusinessSession(sessionLatestCompactionSummary, keysToProcess, sessionId, addMemory) {
+    const prefix = sessionId + COMPOSITE_KEY_SEP;
+    for (const key of keysToProcess) {
+        if (!key.startsWith(prefix))
+            continue;
+        const summary = sessionLatestCompactionSummary.get(key);
+        sessionLatestCompactionSummary.delete(key);
+        if (summary?.trim()) {
+            void addMemory(summary.trim(), { infotype: "compaction", sessionId }).catch(() => { });
+        }
+    }
+}

package/dist/core/session-outlet/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 会话消息统一出口：各模块仅需 sessionId + 消息即可通过统一出口准确送达当前会话对应的 Web/Desktop 或通道。
+ */
+import type { SessionMessageInput, ISessionOutlet } from "./types.js";
+export type { SessionMessage, SessionMessageInput, SessionMessageConsumer, ISessionOutlet } from "./types.js";
+export { SessionOutlet } from "./outlet.js";
+/**
+ * 获取当前使用的出口实例（Gateway 启动时通过 setSessionOutlet 注入）。
+ */
+export declare function getSessionOutlet(): ISessionOutlet | null;
+/**
+ * 设置全局出口实例；传 null 可清空（测试用）。
+ */
+export declare function setSessionOutlet(outlet: ISessionOutlet | null): void;
+/**
+ * 解耦 API：任意模块携带 sessionId 即可发送会话消息，由统一出口路由到正确端。
+ * 若未设置出口或 sessionId 为空，则静默忽略。
+ */
+export declare function sendSessionMessage(sessionId: string, message: Omit<SessionMessageInput, "sessionId">): void;

package/dist/core/session-outlet/index.js

@@ -0,0 +1,33 @@
+/**
+ * 会话消息统一出口：各模块仅需 sessionId + 消息即可通过统一出口准确送达当前会话对应的 Web/Desktop 或通道。
+ */
+export { SessionOutlet } from "./outlet.js";
+let defaultOutlet = null;
+/**
+ * 获取当前使用的出口实例（Gateway 启动时通过 setSessionOutlet 注入）。
+ */
+export function getSessionOutlet() {
+    return defaultOutlet;
+}
+/**
+ * 设置全局出口实例；传 null 可清空（测试用）。
+ */
+export function setSessionOutlet(outlet) {
+    defaultOutlet = outlet;
+}
+/**
+ * 解耦 API：任意模块携带 sessionId 即可发送会话消息，由统一出口路由到正确端。
+ * 若未设置出口或 sessionId 为空，则静默忽略。
+ */
+export function sendSessionMessage(sessionId, message) {
+    if (!sessionId || !message)
+        return;
+    const outlet = getSessionOutlet();
+    if (!outlet)
+        return;
+    outlet.emit(sessionId, {
+        type: message.type,
+        code: message.code,
+        payload: message.payload ?? {},
+    });
+}

package/dist/core/session-outlet/outlet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 会话消息出口实现：按 sessionId 维护消费者集合，emit 时扇出到该会话所有消费者。
+ */
+import type { SessionMessage, SessionMessageConsumer } from "./types.js";
+export declare class SessionOutlet {
+    private readonly consumersBySession;
+    /**
+     * 向指定会话注册消费者；返回取消注册函数。
+     */
+    registerConsumer(sessionId: string, consumer: SessionMessageConsumer): () => void;
+    /**
+     * 向指定会话发送消息；将 sessionId、timestamp 注入后扇出到该会话所有消费者。
+     */
+    emit(sessionId: string, message: Omit<SessionMessage, "sessionId" | "timestamp">): void;
+}

package/dist/core/session-outlet/outlet.js

@@ -0,0 +1,49 @@
+/**
+ * 会话消息出口实现：按 sessionId 维护消费者集合，emit 时扇出到该会话所有消费者。
+ */
+export class SessionOutlet {
+    consumersBySession = new Map();
+    /**
+     * 向指定会话注册消费者；返回取消注册函数。
+     */
+    registerConsumer(sessionId, consumer) {
+        let set = this.consumersBySession.get(sessionId);
+        if (!set) {
+            set = new Set();
+            this.consumersBySession.set(sessionId, set);
+        }
+        set.add(consumer);
+        return () => {
+            const s = this.consumersBySession.get(sessionId);
+            if (s) {
+                s.delete(consumer);
+                if (s.size === 0)
+                    this.consumersBySession.delete(sessionId);
+            }
+        };
+    }
+    /**
+     * 向指定会话发送消息；将 sessionId、timestamp 注入后扇出到该会话所有消费者。
+     */
+    emit(sessionId, message) {
+        const full = {
+            ...message,
+            sessionId,
+            timestamp: Date.now(),
+        };
+        const set = this.consumersBySession.get(sessionId);
+        if (!set || set.size === 0)
+            return;
+        for (const consumer of set) {
+            try {
+                const result = consumer.send(full);
+                if (result && typeof result.catch === "function") {
+                    result.catch((err) => console.warn("[SessionOutlet] consumer.send rejected:", err));
+                }
+            }
+            catch (err) {
+                console.warn("[SessionOutlet] consumer.send threw:", err);
+            }
+        }
+    }
+}

package/dist/core/session-outlet/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 会话消息出口：统一消息类型与消费者接口。
+ * 所有发给各端（Web/Desktop、通道）的会话消息经此抽象，由出口按 sessionId 路由到已注册的消费者。
+ */
+/** 消息类型：对话内容 vs 系统消息（MCP 进度、// 命令结果等） */
+export type SessionMessageType = "chat" | "system";
+/** 系统消息子类型，便于各端区分展示 */
+export type SessionMessageCode = "agent.chunk" | "agent.tool" | "turn_end" | "message_complete" | "agent_end" | "conversation_end" | "mcp.progress" | "command.result";
+/**
+ * 统一会话消息：出口只认 sessionId + 本结构，不关心具体传输。
+ */
+export interface SessionMessage {
+    type: SessionMessageType;
+    code?: SessionMessageCode;
+    payload: Record<string, unknown>;
+    sessionId: string;
+    timestamp?: number;
+}
+/** 发送时调用方可不带 sessionId，由出口注入 */
+export type SessionMessageInput = Omit<SessionMessage, "sessionId"> & {
+    sessionId?: string;
+};
+/**
+ * 消费者接口：各端（Web、通道）注册后，出口将消息推送给 send(message)。
+ */
+export interface SessionMessageConsumer {
+    send(message: SessionMessage): void | Promise<void>;
+}
+/**
+ * 出口接口：支持注册消费者与发送消息，便于注入与测试。
+ */
+export interface ISessionOutlet {
+    emit(sessionId: string, message: Omit<SessionMessage, "sessionId" | "timestamp">): void;
+    registerConsumer(sessionId: string, consumer: SessionMessageConsumer): () => void;
+}

package/dist/core/session-outlet/types.js

@@ -0,0 +1,5 @@
+/**
+ * 会话消息出口：统一消息类型与消费者接口。
+ * 所有发给各端（Web/Desktop、通道）的会话消息经此抽象，由出口按 sessionId 路由到已注册的消费者。
+ */
+export {};

package/dist/core/tools/bookmark-tool.d.ts

@@ -1,4 +1,8 @@
 import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+/**
+ * 新增一个收藏标签。当 get_bookmark_tags 返回的列表中缺少用户想要的标签时，可先调用本工具创建该标签，再使用 save_bookmark 保存收藏。
+ */
+export declare function createAddBookmarkTagTool(): ToolDefinition;
 /**
  * 获取当前系统中已维护的标签列表，供保存 URL 时选择匹配的标签。
  */

package/dist/core/tools/bookmark-tool.js

@@ -1,11 +1,14 @@
 import { Type } from "@sinclair/typebox";
 import { getBackendBaseUrl } from "../../gateway/backend-url.js";
 const GetBookmarkTagsSchema = Type.Object({});
+const AddBookmarkTagSchema = Type.Object({
+    tagName: Type.String({ description: "要新增的标签名称，如「技术」「待读」「美女」等" }),
+});
 const SaveBookmarkSchema = Type.Object({
     url: Type.String({ description: "要收藏的 URL" }),
     title: Type.Optional(Type.String({ description: "可选标题" })),
     tagNames: Type.Optional(Type.Array(Type.String(), {
-        description: "标签名称列表，须与系统中已维护的标签一致。保存前应先用 get_bookmark_tags 获取可用标签。",
+        description: "标签名称列表，须与系统中已维护的标签一致。保存前应先用 get_bookmark_tags 获取可用标签；若缺标签可先用 add_bookmark_tag 新增。",
     })),
 });
 async function apiGet(path) {
@@ -39,6 +42,59 @@ async function apiPost(path, body) {
     }
     return res.json();
 }
+/**
+ * 新增一个收藏标签。当 get_bookmark_tags 返回的列表中缺少用户想要的标签时，可先调用本工具创建该标签，再使用 save_bookmark 保存收藏。
+ */
+export function createAddBookmarkTagTool() {
+    return {
+        name: "add_bookmark_tag",
+        label: "Add Bookmark Tag",
+        description: "在系统中新增一个收藏标签。当用户要保存链接到某个尚不存在的标签（如「美女」「技术」「待读」）时，先调用本工具创建该标签，再调用 get_bookmark_tags 获取最新列表并用 save_bookmark 保存。若标签已存在会提示无需重复创建。",
+        parameters: AddBookmarkTagSchema,
+        execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
+            const tagName = (params.tagName ?? "").trim();
+            if (!tagName) {
+                return {
+                    content: [{ type: "text", text: "请提供要新增的标签名称。" }],
+                    details: undefined,
+                };
+            }
+            try {
+                const json = await apiPost("/tags", {
+                    name: tagName,
+                });
+                const data = json.data;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `已新增标签「${data?.name ?? tagName}」，可直接用于 save_bookmark 的 tagNames。`,
+                        },
+                    ],
+                    details: data,
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes("409") || msg.includes("已存在") || msg.includes("Conflict")) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `标签「${tagName}」已存在，无需重复创建。可直接在 save_bookmark 的 tagNames 中使用该名称。`,
+                            },
+                        ],
+                        details: undefined,
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: `新增标签失败: ${msg}` }],
+                    details: undefined,
+                };
+            }
+        },
+    };
+}
 /**
  * 获取当前系统中已维护的标签列表，供保存 URL 时选择匹配的标签。
  */
@@ -55,7 +111,7 @@ export function createGetBookmarkTagsTool() {
                 const names = data.map((t) => t.name);
                 const text = names.length > 0
                     ? `当前可用标签：${names.join("、")}。请根据用户意图选择匹配的标签名用于 save_bookmark。`
-                    : "当前暂无标签。请在设置中先添加标签，或使用 save_bookmark 时不传 tagNames。";
+                    : "当前暂无标签。可使用 add_bookmark_tag 新增标签，或 save_bookmark 时不传 tagNames。";
                 return {
                     content: [{ type: "text", text }],
                     details: { tags: data },
@@ -78,7 +134,7 @@ export function createSaveBookmarkTool() {
     return {
         name: "save_bookmark",
         label: "Save Bookmark",
-        description: "将用户提供的 URL 保存到收藏库，并可关联一个或多个标签。标签名必须使用 get_bookmark_tags 返回的已有标签；若用户未指定标签，可根据上下文推断或留空。",
+        description: "将用户提供的 URL 保存到收藏库，并可关联一个或多个标签。标签名须为系统已有标签（get_bookmark_tags 返回）；若缺少某标签可先用 add_bookmark_tag 新增。",
         parameters: SaveBookmarkSchema,
         execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
             const url = (params.url ?? "").trim();

package/dist/core/tools/index.d.ts

@@ -1,7 +1,8 @@
 export { createBrowserTool, closeBrowser } from "./browser-tool.js";
 export { createSaveExperienceTool } from "./save-experience-tool.js";
+export { createMemoryRecallTool } from "./memory-recall-tool.js";
 export { createInstallSkillTool } from "./install-skill-tool.js";
 export { createSwitchAgentTool } from "./switch-agent-tool.js";
 export { createListAgentsTool } from "./list-agents-tool.js";
 export { createCreateAgentTool } from "./create-agent-tool.js";
-export { createGetBookmarkTagsTool, createSaveBookmarkTool } from "./bookmark-tool.js";
+export { createGetBookmarkTagsTool, createSaveBookmarkTool, createAddBookmarkTagTool, } from "./bookmark-tool.js";

package/dist/core/tools/index.js

@@ -1,7 +1,8 @@
 export { createBrowserTool, closeBrowser } from "./browser-tool.js";
 export { createSaveExperienceTool } from "./save-experience-tool.js";
+export { createMemoryRecallTool } from "./memory-recall-tool.js";
 export { createInstallSkillTool } from "./install-skill-tool.js";
 export { createSwitchAgentTool } from "./switch-agent-tool.js";
 export { createListAgentsTool } from "./list-agents-tool.js";
 export { createCreateAgentTool } from "./create-agent-tool.js";
-export { createGetBookmarkTagsTool, createSaveBookmarkTool } from "./bookmark-tool.js";
+export { createGetBookmarkTagsTool, createSaveBookmarkTool, createAddBookmarkTagTool, } from "./bookmark-tool.js";

package/dist/core/tools/memory-recall-tool.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+/**
+ * 创建 memory_recall 工具：按需从向量库检索经验与对话摘要，供回答「过往工作、决定、日期、人、偏好、待办、复杂任务、定时任务、历史经验」等问题时使用。
+ * @param useLongMemory 当前智能体是否启用长记忆；为 false 时执行空转（不检索，直接返回未启用提示）。
+ */
+export declare function createMemoryRecallTool(useLongMemory: boolean): ToolDefinition;

package/dist/core/tools/memory-recall-tool.js

@@ -0,0 +1,77 @@
+import { Type } from "@sinclair/typebox";
+import { searchMemory } from "../memory/index.js";
+const MemoryRecallSchema = Type.Object({
+    query: Type.String({
+        description: "语义检索查询，例如：过往决定、用户偏好、某日讨论、待办、历史经验、任务总结等",
+    }),
+    topK: Type.Optional(Type.Number({
+        description: "返回条数，默认 6",
+        minimum: 1,
+        maximum: 20,
+    })),
+});
+/**
+ * 创建 memory_recall 工具：按需从向量库检索经验与对话摘要，供回答「过往工作、决定、日期、人、偏好、待办、复杂任务、定时任务、历史经验」等问题时使用。
+ * @param useLongMemory 当前智能体是否启用长记忆；为 false 时执行空转（不检索，直接返回未启用提示）。
+ */
+export function createMemoryRecallTool(useLongMemory) {
+    return {
+        name: "memory_recall",
+        label: "Memory Recall",
+        description: "从长期记忆中语义检索与查询相关的经验总结和对话摘要。在回答与过往工作、决定、日期、人、偏好、待办、复杂任务、定时任务或需要历史经验相关的问题前，应先调用本工具获取相关记忆再作答。",
+        parameters: MemoryRecallSchema,
+        execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
+            if (!useLongMemory) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "当前智能体未启用长记忆（经验），无法检索。",
+                        },
+                    ],
+                    details: undefined,
+                };
+            }
+            const query = (params.query ?? "").trim();
+            if (!query) {
+                return {
+                    content: [{ type: "text", text: "请提供检索查询（query）。" }],
+                    details: undefined,
+                };
+            }
+            const topK = Math.min(20, Math.max(1, params.topK ?? 6));
+            try {
+                const results = await searchMemory(query, topK);
+                if (results.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "未找到与查询相关的记忆。",
+                            },
+                        ],
+                        details: { results: [], query, topK },
+                    };
+                }
+                const lines = results.map((r, i) => `${i + 1}. [${r.metadata?.infotype ?? "memory"}]\n${(r.document ?? "").trim()}`);
+                const text = "以下为检索到的相关记忆：\n\n" + lines.join("\n\n");
+                return {
+                    content: [{ type: "text", text }],
+                    details: { results: results.length, query, topK },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `记忆检索失败: ${msg}`,
+                        },
+                    ],
+                    details: undefined,
+                };
+            }
+        },
+    };
+}

package/dist/gateway/channel/adapters/telegram.js

@@ -31,11 +31,14 @@ function truncateForTelegram(text) {
 /**
  * 入站：长轮询 getUpdates，收到 message/edited_message 后转 UnifiedMessage 并分发。
  */
+/** 轮询错误日志节流：同一类错误至少间隔此毫秒数再打印，避免刷屏 */
+const TELEGRAM_POLL_ERROR_LOG_INTERVAL_MS = 60_000;
 class TelegramLongPollInbound {
     config;
     messageHandler = null;
     stopped = false;
     lastOffset = 0;
+    lastPollErrorLogTime = 0;
     constructor(config) {
         this.config = config;
     }
@@ -91,8 +94,16 @@ class TelegramLongPollInbound {
                     }
                 }
                 catch (e) {
-                    if (!this.stopped)
-                        console.error("[Telegram] long poll error:", e);
+                    if (!this.stopped) {
+                        const now = Date.now();
+                        if (now - this.lastPollErrorLogTime >= TELEGRAM_POLL_ERROR_LOG_INTERVAL_MS) {
+                            this.lastPollErrorLogTime = now;
+                            const cause = e?.cause?.code === "UND_ERR_CONNECT_TIMEOUT"
+                                ? " (api.telegram.org 连接超时，可能需代理或网络不可达，将继续重试)"
+                                : "";
+                            console.warn("[Telegram] long poll error:", e?.message ?? e, cause);
+                        }
+                    }
                     await new Promise((r) => setTimeout(r, 2000));
                 }
             }

package/dist/gateway/channel/adapters/wechat.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 微信通道适配器：使用 Wechaty（Web/UOS 协议）接收消息，say() 发送回复。
+ * 不支持流式（微信无法编辑已发消息），回复在 agent_end 后一次性发送。
+ * 扫码：scan 事件产生二维码 URL，经 qrcode 库生成 base64 供前端展示。
+ */
+import type { IChannel } from "../types.js";
+export interface WechatChannelConfig {
+    /** Puppet 名称，缺省使用 Wechaty 自带 puppet */
+    puppet?: string;
+    /** 默认绑定的 agentId */
+    defaultAgentId?: string;
+}
+type WechatLoginStatus = "scanning" | "logged_in" | "logged_out";
+/** 供 Gateway API 查询当前二维码（base64 Data URL 或 null） */
+export declare function getWechatQrCode(): string | null;
+/** 供 Gateway API 查询登录状态 */
+export declare function getWechatStatus(): {
+    status: WechatLoginStatus;
+    userName: string | null;
+};
+/** 重启 Wechaty 以刷新二维码（二维码过期后调用） */
+export declare function refreshWechatQrCode(): Promise<void>;
+export declare function createWechatChannel(config: WechatChannelConfig): IChannel;
+export {};