@aalis/plugin-agent 0.15.2 → 0.17.0

package/dist/helpers.d.ts

@@ -1,14 +1,6 @@
-/**
- * DefaultAgent 内部纯工具函数。
- *
- * 这些函数**不碰能力、也不碰 this**，可独立测试与替换。
- * 拆分目的：
- * - 让 index.ts 主类聚焦在编排/状态管理，而不是 token 估算细节
- * - 让纯函数可被 vitest 单独覆盖（无需搭出一次激活）
- */
-import type { PersonaSessionOptions } from '@aalis/api-persona';
-import type { SessionConfig } from '@aalis/api-session-manager';
-import type { IncomingMessage, Message } from '@aalis/schema-message';
+import type { MemoryService } from '@aalis/api-memory';
+import type { TextRef } from '@aalis/schema-i18n';
+import type { IncomingMessage, Message, ToolCall } from '@aalis/schema-message';
 /**
  * 将时间戳格式化为可读的时间标签：同年 `M/D HH:mm`，跨年 `YYYY/M/D HH:mm`。
  *
@@ -29,29 +21,63 @@ export declare function formatTimeLabel(ts: number, now: number): string;
  */
 export declare const INPUT_CONVENTIONS: string;
 /**
- * 群聊焦点指引 —— 仅在群聊被显式触发（@ / 直接对话）时注入。
+ * 群聊焦点指引 —— 多方房间里这一轮有被点名的输入时注入，紧贴在这一轮的输入之前，按时间与发送者账号逐条列出被点名的那几条；
+ * 插进被点名的输入时在它们之前另加一块，不改前面那块。
  *
  * 背景痛点：群里多人陈述某事件 E，A 突然 @bot「你怎么看 E」。bot 看到的 messages 是
  * 「B 长篇陈述 → C 长篇陈述 → D 长篇陈述 → A 简短@」，注意力容易被最显眼的陈述吸走，
  * 把陈述者本人当成评价主体，而不是被陈述的事件 E 本身。
  *
- * 解决：在触发场景下插一条焦点指引，明确"本轮最后一条带发送者标注的消息即焦点"，并指引 LLM 区分
+ * 解决：插一条焦点指引，明确哪几条是焦点（按时间与发送者标注认，正文里不另加标记：之后它们进历史时正文不变），并指引 LLM 区分
  *   - 评价对象（被引用 / 被讨论的事件 E）
  *   - 引用者（发言者本人）
  *
- * 仅 sessionType=group 且 triggerType ∈ {direct, immediate} 时返回，其他场景返回 null
- * （interval/idle/proactive/witness 没有清晰诉求主体，强加焦点反而会误导）。
+ * focus 是被点名的各条的「(时间) 发送者账号」；没有被点名的（interval/idle/proactive 没有清晰诉求主体，强加焦点反而会误导）
+ * 返回 null
+ */
+export declare function buildFocusGuidance(focus: readonly string[]): Message | null;
+/**
+ * 由排着的真人消息开的一轮的说明：它们是上一轮进行期间到的。quiet 为真时（多方房间里这一批全是没点名她的插话）另说没有
+ * 需要接的可以不说话；私聊、工作会话与批里有点名的照常回
  */
-export declare function buildFocusGuidance(incoming: IncomingMessage): Message | null;
-/** 估算文本的 token 数（区分中文与 ASCII） */
-export declare function estimateTextTokens(text: string): number;
-export declare function estimateMsgTokens(msg: Message): number;
+export declare function queuedNote(quiet: boolean): Message;
+/**
+ * 停下标记（schema-message 的 TurnStopped）：落进会话历史，让下一轮的模型知道上面这一轮没答完就停了。who 是停下的人的称呼，
+ * 没有具体的人时不给。末句不叫她接着做，接不接看之后的消息
+ */
+export declare function stoppedNote(who: string | undefined, turnId: string): Message;
+/**
+ * 本轮附件有没有描述正文：附件描述里有一项去掉不带描述的附件引用（只是指针，如关了到达识别时的 `[图片 | ref:…]`）之后
+ * 还有文字。媒体识别的描述（带引用的、没落盘的、视频与音频）与文件说明都算
+ */
+export declare function hasAttachmentDescriptions(incoming: Pick<IncomingMessage, '_attachmentDescriptions'>): boolean;
 /** 估算一组消息的总 token 数 */
 export declare function estimateTokens(messages: Message[]): number;
+/** 估算一组消息里历史与工具结果（system 以外的消息）的 token 数，与用量拆分的 history、toolResults 两项同一口径 */
+export declare function estimateHistoryTokens(messages: Message[]): number;
+/**
+ * 发给模型的会话历史丢掉活跃历史里最早的几条对话消息：条数线为 0、或对话消息不超过它时为 0；超过时按半条线成段前移。
+ * 只由对话消息的条数与条数线决定，两次前移之间不变：发出的开头逐字不变，服务商的前缀缓存才命中
+ */
+export declare function historyStart(count: number, limit: number): number;
+/**
+ * 读发给模型的会话历史：活跃历史丢掉最早的 historyStart 条对话消息，余下的到末尾；count 是活跃历史里对话消息的条数（条数只数
+ * 对话消息，与 api-memory 的 countHistory 同一口径；真实回合与 token:request 的快照共用）。后端有 countHistory 时先数再按条数
+ * 只读起点之后的那一段（没超线时读最近条数线那么多条：数完到读之间进来的消息不会挤掉最早那条），没有时读全部再切，两条路是同一段
+ */
+export declare function readHistory(memory: Pick<MemoryService, 'getHistory' | 'countHistory'>, sessionId: string, limit?: number): Promise<{
+    messages: Message[];
+    count: number;
+}>;
+/**
+ * 交给模型的一条历史：她的回复带可见正文（schema-message 的 VisibleContent，落库的是结构化输出的信封时才有）时换成可见正文的
+ * 副本，免得模型照抄信封；其余原样
+ */
+export declare function historyForModel(m: Message): Message;
 /** 比较两条消息是否在 role/timestamp/name/content 维度上等价（不比较 toolCalls / id） */
 export declare function isSameMessage(a: Message, b: Message): boolean;
 /**
- * LLM 解析失败时的可诊断说明（纯函数）。
+ * LLM 解析失败时的可诊断说明（纯函数）：给人看的文字对象，发进聊天时按会话的语言显示，写日志取 toSource。
  *
  * `resolveLLMModel` 拿到显式 ref 却匹配不上任何 entry 时静默返回 undefined，调用方只知道
  * 「没拿到」。而 ref 是**包名 + 模型名**——包一改名（`plugin-deepseek` → `plugin-llm-deepseek`）、
@@ -68,15 +94,22 @@ export declare function isSameMessage(a: Message, b: Message): boolean;
 export declare function describeLLMFailure(available: readonly string[], wanted?: {
     provider?: string;
     model?: string;
-}, erroredProviders?: readonly string[]): string;
-/**
- * 会话解析结果 → persona 的会话选项。真实回合与 token:request 快照共用这一份构造，
- * 快照里 persona 那一桶才会按会话实际人设与额外提示估算。无 session-manager 时给 undefined（全局默认）。
- */
-export declare function toPersonaOptions(resolved: Omit<SessionConfig, 'sessionDefaults'> | undefined): PersonaSessionOptions | undefined;
+}, erroredProviders?: readonly string[]): TextRef;
 /**
  * 调试日志里的工具参数。参数经 `agent:tool:before` 钩子后可能含 JSON 序列化不了的值（BigInt、循环引用），
  * 序列化失败时回落为说明文字：日志不能让工具调用失败。
  */
 export declare function formatToolArgsForLog(args: unknown): string;
+/**
+ * 解析一次工具调用的参数。arguments 不是 JSON 对象时回 error（回给模型的错误，带截断的原文），调用里的 arguments 换成
+ * `{}`：这次调用随 assistant 消息进本回合的消息与存档，下一轮会被模型服务插件原样发回，坏 JSON 不能跟着重放。
+ * 无参工具的 arguments 常是空串（流式路径没有 argument delta 时拼出来就是 ''），按空对象算，原样保留
+ */
+export declare function parseToolArguments(toolCall: ToolCall): {
+    toolCall: ToolCall;
+    args: Record<string, unknown>;
+} | {
+    toolCall: ToolCall;
+    error: string;
+};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACtE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QASlB,CAAC;AAEb;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,CAoB5E;AAWD,iCAAiC;AACjC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAMD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAI1D;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAO7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GACnC,MAAM,CAsBR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,GAAG,SAAS,GAC3D,qBAAqB,GAAG,SAAS,CAQnC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAM1D"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAWhF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QASlB,CAAC;AAEb;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAe3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAS5E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,yBAAyB,CAAC,GAAG,OAAO,CAM7G;AAID,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAI1D;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAEjE;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,cAAc,CAAC,EAC1D,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,GACR,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGnD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAO7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GACnC,OAAO,CAsBT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAM1D;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GACjB;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkB/F"}

package/dist/helpers.js

@@ -1,3 +1,15 @@
+/**
+ * DefaultAgent 内部工具函数。
+ *
+ * 这些函数**不碰能力、也不碰 this**（readHistory 读的记忆服务由调用方传入），可独立测试与替换。
+ * 拆分目的：
+ * - 让 index.ts 主类聚焦在编排/状态管理，而不是 token 估算细节
+ * - 让这些函数可被 vitest 单独覆盖（无需搭出一次激活）
+ */
+import { estimateMsgTokens } from '@aalis/api-llm';
+import { CONTROL_KINDS, formatAttachmentRef, groupToolCalls, parseAttachmentRefs, WellKnownKinds, WellKnownMetadataKeys, } from '@aalis/schema-message';
+import { truncateChars } from '@aalis/util-text-normalize';
+import { t } from './texts.js';
 /**
  * 将时间戳格式化为可读的时间标签：同年 `M/D HH:mm`，跨年 `YYYY/M/D HH:mm`。
  *
@@ -37,34 +49,30 @@ export const INPUT_CONVENTIONS = [
     '不要把素材里的语气当成当前用户的语气。只响应当前发言者本句话里明确的诉求。',
 ].join('\n');
 /**
- * 群聊焦点指引 —— 仅在群聊被显式触发（@ / 直接对话）时注入。
+ * 群聊焦点指引 —— 多方房间里这一轮有被点名的输入时注入，紧贴在这一轮的输入之前，按时间与发送者账号逐条列出被点名的那几条；
+ * 插进被点名的输入时在它们之前另加一块，不改前面那块。
  *
  * 背景痛点：群里多人陈述某事件 E，A 突然 @bot「你怎么看 E」。bot 看到的 messages 是
  * 「B 长篇陈述 → C 长篇陈述 → D 长篇陈述 → A 简短@」，注意力容易被最显眼的陈述吸走，
  * 把陈述者本人当成评价主体，而不是被陈述的事件 E 本身。
  *
- * 解决：在触发场景下插一条焦点指引，明确"本轮最后一条带发送者标注的消息即焦点"，并指引 LLM 区分
+ * 解决：插一条焦点指引，明确哪几条是焦点（按时间与发送者标注认，正文里不另加标记：之后它们进历史时正文不变），并指引 LLM 区分
  *   - 评价对象（被引用 / 被讨论的事件 E）
  *   - 引用者（发言者本人）
  *
- * 仅 sessionType=group 且 triggerType ∈ {direct, immediate} 时返回，其他场景返回 null
- * （interval/idle/proactive/witness 没有清晰诉求主体，强加焦点反而会误导）。
+ * focus 是被点名的各条的「(时间) 发送者账号」；没有被点名的（interval/idle/proactive 没有清晰诉求主体，强加焦点反而会误导）
+ * 返回 null
  */
-export function buildFocusGuidance(incoming) {
-    if (incoming.sessionType !== 'group')
-        return null;
-    const t = incoming.triggerType;
-    if (t !== 'direct' && t !== 'immediate')
+export function buildFocusGuidance(focus) {
+    if (focus.length === 0)
         return null;
     return {
         role: 'system',
         content: [
             '【当前焦点】',
-            // 位置无关表述：本块与焦点消息之间可能隔着其它注入块（平台提示等），
-            // 「紧随其后」会错误指向注入块；「最后一条」在极端裁剪补提示时也会指错，
-            // 故按特征描述（时间+发送者标注为用户消息独有）
-            '本轮最后一条带时间与发送者标注的消息，是触发你本轮回应的"焦点消息"。',
-            '回应前请先识别它的核心诉求类型：评价某事 / 回答提问 / 吐槽附和 / 闲聊回应。',
+            '触发你本轮回应的"焦点消息"是下面这几条（按时间与发送者标注认）：',
+            ...focus.map(line => `- ${line}`),
+            '回应前请先识别它们的核心诉求类型：评价某事 / 回答提问 / 吐槽附和 / 闲聊回应。',
             '若焦点消息中通过引用、转发、@他人提及、或文字指向了一个被讨论的对象（事件、作品、',
             '行为、观点），你的回应应当针对"被指向的对象"，而不是把"陈述者本人"当成评价主体。',
             '群里前面其他成员的长篇陈述只是背景上下文，不是焦点。',
@@ -72,49 +80,44 @@ export function buildFocusGuidance(incoming) {
         metadata: { injector: 'focus-guidance' },
     };
 }
-// ----- Token 估算 -----
-//
-// 大多数 BPE tokenizer (GPT / DeepSeek / Qwen) 经验值：
-//   - ASCII 字符 ~ 3.5 字符 / token
-//   - CJK 字符 ~ 1.5 token / 字符
-// 保守取高，避免超限。
-const CJK_REGEX = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7FF\uF900-\uFAFF\uFE30-\uFE4F\uFF00-\uFFEF]/;
-/** 估算文本的 token 数（区分中文与 ASCII） */
-export function estimateTextTokens(text) {
-    let tokens = 0;
-    let i = 0;
-    while (i < text.length) {
-        if (CJK_REGEX.test(text[i])) {
-            tokens += 1.5;
-            i++;
-        }
-        else {
-            let asciiLen = 0;
-            while (i < text.length && !CJK_REGEX.test(text[i])) {
-                asciiLen++;
-                i++;
-            }
-            tokens += Math.ceil(asciiLen / 3.5);
-        }
-    }
-    return Math.ceil(tokens);
+/**
+ * 由排着的真人消息开的一轮的说明：它们是上一轮进行期间到的。quiet 为真时（多方房间里这一批全是没点名她的插话）另说没有
+ * 需要接的可以不说话；私聊、工作会话与批里有点名的照常回
+ */
+export function queuedNote(quiet) {
+    return {
+        role: 'system',
+        content: `下面几条是你上一轮进行期间到的。${quiet ? '没有需要接的可以不说话。' : ''}`,
+        metadata: { injector: 'system-other' },
+    };
 }
-/** 估算单条消息的 token 数（含 toolCalls + reasoningContent） */
-/** 单张图片的保守 token 估算（实测 800×600 静图经 ViT 编码为 500–800 visual token）。 */
-const IMAGE_TOKENS_ESTIMATE = 800;
-export function estimateMsgTokens(msg) {
-    let t = 4;
-    if (msg.content)
-        t += estimateTextTokens(msg.content);
-    if (msg.toolCalls)
-        t += estimateTextTokens(JSON.stringify(msg.toolCalls));
-    if (msg.reasoningContent)
-        t += estimateTextTokens(msg.reasoningContent);
-    // 图片不是按 base64 长度计费的：估一个保守常量，让预算/统计/裁剪看得见它们
-    if (msg.images)
-        t += msg.images.length * IMAGE_TOKENS_ESTIMATE;
-    return t;
+/**
+ * 停下标记（schema-message 的 TurnStopped）：落进会话历史，让下一轮的模型知道上面这一轮没答完就停了。who 是停下的人的称呼，
+ * 没有具体的人时不给。末句不叫她接着做，接不接看之后的消息
+ */
+export function stoppedNote(who, turnId) {
+    const stopped = who ? `你还没答完，就被 ${who} 叫停了` : '你还没答完就被停下了';
+    return {
+        role: 'system',
+        kind: WellKnownKinds.TurnStopped,
+        content: `[已停下] 上面这一轮${stopped}：没说完的话没有留下，已经执行的工具调用以上面的记录为准。要不要接着做，看之后的消息再定。`,
+        timestamp: Date.now(),
+        metadata: { [WellKnownMetadataKeys.TurnId]: turnId },
+    };
+}
+/**
+ * 本轮附件有没有描述正文：附件描述里有一项去掉不带描述的附件引用（只是指针，如关了到达识别时的 `[图片 | ref:…]`）之后
+ * 还有文字。媒体识别的描述（带引用的、没落盘的、视频与音频）与文件说明都算
+ */
+export function hasAttachmentDescriptions(incoming) {
+    return (incoming._attachmentDescriptions ?? []).some(desc => {
+        if (!desc)
+            return false;
+        const pointers = parseAttachmentRefs(desc).filter(ref => !ref.desc);
+        return pointers.reduce((rest, ref) => rest.replace(formatAttachmentRef(ref), ''), desc).trim() !== '';
+    });
 }
+// ----- Token 估算 -----
 /** 估算一组消息的总 token 数 */
 export function estimateTokens(messages) {
     let total = 0;
@@ -122,6 +125,62 @@ export function estimateTokens(messages) {
         total += estimateMsgTokens(msg);
     return total;
 }
+/** 估算一组消息里历史与工具结果（system 以外的消息）的 token 数，与用量拆分的 history、toolResults 两项同一口径 */
+export function estimateHistoryTokens(messages) {
+    return estimateTokens(messages.filter(m => m.role !== 'system'));
+}
+// ----- 发给模型的会话历史 -----
+/**
+ * 发给模型的会话历史丢掉活跃历史里最早的几条对话消息：条数线为 0、或对话消息不超过它时为 0；超过时按半条线成段前移。
+ * 只由对话消息的条数与条数线决定，两次前移之间不变：发出的开头逐字不变，服务商的前缀缓存才命中
+ */
+export function historyStart(count, limit) {
+    if (!limit || count <= limit)
+        return 0;
+    const step = Math.ceil(limit / 2);
+    return Math.ceil((count - limit) / step) * step;
+}
+/**
+ * 读发给模型的会话历史：活跃历史丢掉最早的 historyStart 条对话消息，余下的到末尾；count 是活跃历史里对话消息的条数（条数只数
+ * 对话消息，与 api-memory 的 countHistory 同一口径；真实回合与 token:request 的快照共用）。后端有 countHistory 时先数再按条数
+ * 只读起点之后的那一段（没超线时读最近条数线那么多条：数完到读之间进来的消息不会挤掉最早那条），没有时读全部再切，两条路是同一段
+ */
+export async function readHistory(memory, sessionId, limit = 0) {
+    let messages;
+    let count;
+    let start;
+    if (limit && memory.countHistory) {
+        count = await memory.countHistory(sessionId);
+        start = historyStart(count, limit);
+        messages = await memory.getHistory(sessionId, start ? count - start : limit);
+    }
+    else {
+        const all = await memory.getHistory(sessionId, Infinity);
+        const said = all.flatMap((m, i) => (CONTROL_KINDS.includes(m.kind ?? '') ? [] : [i]));
+        count = said.length;
+        start = historyStart(count, limit);
+        // 同按条数读：从丢掉的最后一条对话消息之后切，夹在它与下一条对话消息之间的标记留下
+        messages = start ? all.slice(said[start - 1] + 1) : all;
+    }
+    // 起点落在工具调用组中间：组首在起点之前已经丢掉，这一组留下的结果（第一组之前组外的结果）随它一起丢，夹在其间的别的消息照留。
+    // 之后组外的结果不是起点切出来的，与起点在不在 0 无关，照旧交给读的一方（真实回合的清洗跳过并告警）
+    const leftover = new Set();
+    for (const { at, shape } of start > 0 ? groupToolCalls(messages) : []) {
+        if (shape === 'complete' || shape === 'partial')
+            break;
+        if (shape === 'loose')
+            leftover.add(at[0]);
+    }
+    return { messages: messages.filter((_, i) => !leftover.has(i)), count };
+}
+/**
+ * 交给模型的一条历史：她的回复带可见正文（schema-message 的 VisibleContent，落库的是结构化输出的信封时才有）时换成可见正文的
+ * 副本，免得模型照抄信封；其余原样
+ */
+export function historyForModel(m) {
+    const visible = m.metadata?.[WellKnownMetadataKeys.VisibleContent];
+    return m.role === 'assistant' && typeof visible === 'string' ? { ...m, content: visible } : m;
+}
 /** 比较两条消息是否在 role/timestamp/name/content 维度上等价（不比较 toolCalls / id） */
 export function isSameMessage(a, b) {
     return (a.role === b.role &&
@@ -130,7 +189,7 @@ export function isSameMessage(a, b) {
         (a.content ?? '') === (b.content ?? ''));
 }
 /**
- * LLM 解析失败时的可诊断说明（纯函数）。
+ * LLM 解析失败时的可诊断说明（纯函数）：给人看的文字对象，发进聊天时按会话的语言显示，写日志取 toSource。
  *
  * `resolveLLMModel` 拿到显式 ref 却匹配不上任何 entry 时静默返回 undefined，调用方只知道
  * 「没拿到」。而 ref 是**包名 + 模型名**——包一改名（`plugin-deepseek` → `plugin-llm-deepseek`）、
@@ -148,38 +207,25 @@ export function describeLLMFailure(available, wanted, erroredProviders) {
     if (available.length === 0) {
         // 最常见的成因是 LLM 插件装了也启用了、只是缺 apiKey 而激活失败。能点名就点名，省掉用户一轮空转；
         // 这条文案会**发进聊天**，只点名实例，原因指向 /doctor。/doctor 是受限指令，收到提示的人不一定能用，故注明要权限。
-        if (erroredProviders && erroredProviders.length > 0) {
-            return `未找到任何具备 chat 能力的 LLM —— 以下 LLM 插件激活失败：${erroredProviders.join('、')}。可用 /doctor 查看原因（需要相应权限）。`;
-        }
-        return '未找到任何具备 chat 能力的 LLM —— 请确认已安装并启用至少一个 LLM 提供者插件（如 @aalis/plugin-llm-deepseek）。';
+        if (erroredProviders && erroredProviders.length > 0)
+            return t('llmNoneErrored', { plugins: erroredProviders });
+        return t('llmNone');
     }
     if (wanted?.provider && wanted?.model) {
         // 只列前 LIST_MAX 个：这条文案会**发进聊天**，而 ollama 是自动发现本机全部模型逐个注册
         // entry 的——实测 40 个模型拼出 1874 字符，且每条消息都发一次。截断后给出总数，
         // 想看全的去 `/model`。
         const LIST_MAX = 5;
-        const shown = available.slice(0, LIST_MAX).join('、');
-        const more = available.length > LIST_MAX ? `…等 ${available.length} 个（用 /model 查看全部）` : '';
-        return `配置指向的模型不存在：${wanted.provider}/${wanted.model}。当前可用：${shown}${more}。`;
+        return t('llmNotFound', {
+            wanted: `${wanted.provider}/${wanted.model}`,
+            models: available.slice(0, LIST_MAX),
+            more: available.length > LIST_MAX ? t('llmMore', { count: available.length }) : '',
+        });
     }
     // ref 不全时 resolveLLM 传的是 undefined，resolveLLMModel 此时取 all[0]——只要有 entry
     // 就必命中。所以走到这里意味着取数与解析看到的不是同一份快照（例如两次调用之间服务被
     // 注销），**不是**「没有可用 entry」。文案要说这个，别谎称都不可用。
-    return `LLM 解析失败：能力过滤后有 ${available.length} 个可用 entry，但解析时一个都没取到（服务可能正在装卸中，稍后重试）。`;
-}
-/**
- * 会话解析结果 → persona 的会话选项。真实回合与 token:request 快照共用这一份构造，
- * 快照里 persona 那一桶才会按会话实际人设与额外提示估算。无 session-manager 时给 undefined（全局默认）。
- */
-export function toPersonaOptions(resolved) {
-    if (!resolved)
-        return undefined;
-    return {
-        persona: resolved.persona,
-        disableOutputFormat: resolved.disableOutputFormat,
-        clientSideJsonRendering: resolved.clientSideJsonRendering,
-        systemPromptExtra: resolved.systemPromptExtra,
-    };
+    return t('llmUnresolved', { count: available.length });
 }
 /**
  * 调试日志里的工具参数。参数经 `agent:tool:before` 钩子后可能含 JSON 序列化不了的值（BigInt、循环引用），
@@ -193,4 +239,30 @@ export function formatToolArgsForLog(args) {
         return `（无法序列化：${err instanceof Error ? err.message : '未知原因'}）`;
     }
 }
+/** 坏工具参数回给模型时附带的原文最多多少字 */
+const RAW_ARGUMENTS_MAX = 200;
+/**
+ * 解析一次工具调用的参数。arguments 不是 JSON 对象时回 error（回给模型的错误，带截断的原文），调用里的 arguments 换成
+ * `{}`：这次调用随 assistant 消息进本回合的消息与存档，下一轮会被模型服务插件原样发回，坏 JSON 不能跟着重放。
+ * 无参工具的 arguments 常是空串（流式路径没有 argument delta 时拼出来就是 ''），按空对象算，原样保留
+ */
+export function parseToolArguments(toolCall) {
+    const raw = toolCall.function.arguments?.trim() ?? '';
+    try {
+        const parsed = raw ? JSON.parse(raw) : {};
+        // 工具按参数名取值：顶层是 null、数组或原始值的同坏 JSON 一样处理
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new TypeError(`顶层是 ${parsed === null ? 'null' : Array.isArray(parsed) ? '数组' : typeof parsed}`);
+        }
+        return { toolCall, args: parsed };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return {
+            toolCall: { ...toolCall, function: { ...toolCall.function, arguments: '{}' } },
+            error: `工具参数不是合法 JSON 对象：${reason}；原文（前 ${RAW_ARGUMENTS_MAX} 字）：` +
+                `${truncateChars(raw, RAW_ARGUMENTS_MAX)}；请重新生成 arguments`,
+        };
+    }
+}
 //# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -8,19 +8,26 @@ declare const _default: import("@aalis/core").PluginDefinition<{
     contributions: import("@aalis/core").ServiceDescriptor<import("@aalis/api-contributions").ContributionRegistry, import("@aalis/api-contributions").Contributions>;
     lifecycle: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").LifecycleCap, import("@aalis/core").LifecycleCap>;
     provide: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Provide, import("@aalis/core").Provide>;
-    services: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Services, import("@aalis/core").Services>;
     commands: import("@aalis/core").OptionalUse<import("@aalis/api-commands").CommandService, import("@aalis/api-commands").BoundCommands>;
     tools: import("@aalis/core").OptionalUse<import("@aalis/api-tools").ToolService, import("@aalis/api-tools").BoundTools>;
-    llm: import("@aalis/core").OptionalUse<LLMModel, import("@aalis/core").ServiceRef<LLMModel>>;
-    memory: import("@aalis/core").OptionalUse<import("@aalis/api-memory").MemoryService, import("@aalis/core").ServiceRef<import("@aalis/api-memory").MemoryService>>;
-    persona: import("@aalis/core").OptionalUse<import("@aalis/api-persona").PersonaService, import("@aalis/core").ServiceRef<import("@aalis/api-persona").PersonaService>>;
-    messageArchive: import("@aalis/core").OptionalUse<import("@aalis/api-message-archive").MessageArchiveService, import("@aalis/core").ServiceRef<import("@aalis/api-message-archive").MessageArchiveService>>;
-    sessionManager: import("@aalis/core").OptionalUse<import("@aalis/api-session-manager").SessionManagerService, import("@aalis/core").ServiceRef<import("@aalis/api-session-manager").SessionManagerService>>;
-    platform: import("@aalis/core").OptionalUse<import("@aalis/api-platform").PlatformAdapter, import("@aalis/core").ServiceRef<import("@aalis/api-platform").PlatformAdapter>>;
-    media: import("@aalis/core").OptionalUse<import("@aalis/api-media").MediaService, import("@aalis/core").ServiceRef<import("@aalis/api-media").MediaService>>;
-    storage: import("@aalis/core").OptionalUse<import("@aalis/api-storage").StorageService, import("@aalis/core").ServiceRef<import("@aalis/api-storage").StorageService>>;
-    gateway: import("@aalis/core").OptionalUse<import("@aalis/api-gateway").GatewayService, import("@aalis/core").ServiceRef<import("@aalis/api-gateway").GatewayService>>;
-    plugins: import("@aalis/core").OptionalUse<import("@aalis/core").PluginManagerService, import("@aalis/core").ServiceRef<import("@aalis/core").PluginManagerService>>;
+    llm: import("@aalis/core").OptionalUse<LLMModel, LLMModel>;
+    memory: import("@aalis/core").OptionalUse<import("@aalis/api-memory").MemoryService, import("@aalis/api-memory").MemoryService>;
+    persona: import("@aalis/core").OptionalUse<import("@aalis/api-persona").PersonaService, import("@aalis/api-persona").PersonaService>;
+    messageArchive: import("@aalis/core").OptionalUse<import("@aalis/api-message-archive").MessageArchiveService, import("@aalis/api-message-archive").MessageArchiveService>;
+    sessionManager: import("@aalis/core").OptionalUse<import("@aalis/api-session-manager").SessionManagerService, import("@aalis/api-session-manager").SessionManagerService>;
+    /** 判谁是 owner：参与者里合一 owner 的各个身份、存档不在时当轮正文的发送者前缀（与存档同一规则，speakerOf）、/stop */
+    authority: import("@aalis/core").OptionalUse<import("@aalis/api-authority").AuthorityService, import("@aalis/api-authority").AuthorityService>;
+    /** 按会话读本插件的四项（模型、深度思考、最大工具迭代、历史条数上限）；缺席时只取插件配置里的值 */
+    sessionFields: import("@aalis/core").OptionalUse<import("@aalis/api-session-settings").SessionSettingsService, import("@aalis/api-session-settings").SessionFields>;
+    /** 按会话字段的全局层：宿主配置文档里本实例的那一段 */
+    document: import("@aalis/core").OptionalUse<import("@aalis/api-host-config").HostConfig, import("@aalis/api-host-config").OwnHostConfig>;
+    platform: import("@aalis/core").OptionalUse<import("@aalis/api-platform").PlatformAdapter, import("@aalis/api-platform").PlatformAdapter>;
+    media: import("@aalis/core").OptionalUse<import("@aalis/api-media").MediaService, import("@aalis/api-media").MediaService>;
+    storage: import("@aalis/core").OptionalUse<import("@aalis/api-storage").StorageService, import("@aalis/api-storage").BoundStorage>;
+    gateway: import("@aalis/core").OptionalUse<import("@aalis/api-gateway").GatewayService, import("@aalis/api-gateway").GatewayService>;
+    plugins: import("@aalis/core").OptionalUse<import("@aalis/core").PluginManagerService, import("@aalis/core").PluginManagerService>;
+    /** 会话没设模型时比对本插件该生效的 llm 偏好与实际用的模型 */
+    services: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Services, import("@aalis/core").Services>;
 }>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAkC,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAe9F,OAAO,EAKL,KAAK,MAAM,EAOZ,MAAM,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;AA+wErB,wBAQG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAkC,QAAQ,EAAY,MAAM,gBAAgB,CAAC;AAwBzF,OAAO,EAKL,KAAK,MAAM,EAQZ,MAAM,aAAa,CAAC;;;;;;;;;;;;;;;;IAgEnB,4EAA4E;;IAE5E,qDAAqD;;IAErD,+BAA+B;;;;;;;IAO/B,qCAAqC;;;AAorEvC,wBAQG"}