Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(helper): enforce task digest byte budget

Zhao Dengfengda0ae04ef413
diff --git a/packages/lizi-mcps/src/__tests__/getTaskDigestTool.test.ts b/packages/lizi-mcps/src/__tests__/getTaskDigestTool.test.ts
index c92f571991..0a847ea229 100644
--- a/packages/lizi-mcps/src/__tests__/getTaskDigestTool.test.ts
+++ b/packages/lizi-mcps/src/__tests__/getTaskDigestTool.test.ts
@@ -2,8 +2,8 @@
* 测试价值
* - 生产入口与可观察结果:get_task_digest 经 registry.call 返回给模型的 JSON(字段、大小、错误码)。
* - 规则依据:被程序叫醒的伙伴先读 ≤2KB 摘要再决定;每段文字 ≤300 字;只读调用方可读范围内的任务。
- * - 现有覆盖缺口:长助手回复只截开头,丢掉末尾结果;总预算收紧时也须保留结论。
- * - 最小失败输入:超过 300 字、末尾才写失败结论的回复,分别带有/不带其他长字段;受限范围外任务。
+ * - 现有覆盖缺口:长助手回复只截开头,丢掉末尾结果;总预算收紧时也须保留结论;可选链接与必填元数据的字节预算未覆盖。
+ * - 最小失败输入:超过 300 字、末尾才写失败结论的回复,分别带有/不带其他长字段;超长链接或模型元数据;受限范围外任务。
* - tier:unit(纯工具层,宿主回调 mock)。
*/
import { describe, expect, it, vi } from 'vitest';
@@ -98,6 +98,31 @@ describe('get_task_digest', () => {
expect(Array.from(reply).length).toBeLessThanOrEqual(pressure ? 299 : 300);
});
+ it('omits an oversized optional sessionUrl without corrupting task identity', async () => {
+ const reg = setup({
+ taskDigest: async () => ({ ok: true as const, digest }),
+ sessionUrl: () => `cindy://session/laptop::s-9?${'x'.repeat(4096)}`,
+ });
+ const result = await reg.call('get_task_digest', { session_id: digest.session_id });
+ const { text, json } = parse(result);
+ expect(new TextEncoder().encode(text).length).toBeLessThanOrEqual(TASK_DIGEST_MAX_BYTES);
+ expect(json).toMatchObject({ ok: true, session_id: digest.session_id });
+ expect(json).not.toHaveProperty('sessionUrl');
+ });
+
+ it('returns a small explicit error when required metadata cannot fit the byte budget', async () => {
+ const raw = {
+ ...digest,
+ current_route: { ...digest.current_route!, model: 'm'.repeat(4096) },
+ };
+ const reg = setup({ taskDigest: async () => ({ ok: true as const, digest: raw }) });
+ const result = await reg.call('get_task_digest', { session_id: raw.session_id });
+ const { text, json } = parse(result);
+ expect(new TextEncoder().encode(text).length).toBeLessThanOrEqual(TASK_DIGEST_MAX_BYTES);
+ expect(json).toMatchObject({ ok: false, errorCode: 'DIGEST_TOO_LARGE' });
+ expect(result.isError).toBe(true);
+ });
+
it('refuses a task outside a scoped caller\'s readable history and passes host errors through', async () => {
const taskDigest = vi.fn(async () => ({ ok: false as const, errorCode: 'NOT_FOUND' as const, message: 'gone' }));
const scoped = setup({
diff --git a/packages/lizi-mcps/src/xdt-helper/get_task_digest.ts b/packages/lizi-mcps/src/xdt-helper/get_task_digest.ts
index f2bc8fdcde..7b1519535b 100644
--- a/packages/lizi-mcps/src/xdt-helper/get_task_digest.ts
+++ b/packages/lizi-mcps/src/xdt-helper/get_task_digest.ts
@@ -4,7 +4,7 @@
* 给被程序叫醒的伙伴用:先读这一份再决定继续、代答、换模型还是提醒主人,不必拉整段聊天记录。
* 本机任务直接给 id;另一台电脑上的任务写 deviceId::sessionId(只读,对方须在线)。
* 宿主负责取数;本文件只负责输出合同:每段文字 ≤300 字,整份 JSON ≤2KB(UTF-8 字节),
- * 超出时先收紧长文字、最后置空,不截断成非法 JSON。
+ * 超出时先收紧长文字、最后置空,不截断成非法 JSON;必填元数据仍装不下时返回短错误。
*/
import { z } from 'zod';
@@ -84,7 +84,7 @@ const encoder = new TextEncoder();
const payloadBytes = (digest: TaskDigestWire) =>
encoder.encode(JSON.stringify({ ok: true, ...digest })).length;
-/** 输出合同:文字逐段 ≤300 字,整份(含 ok 外壳)≤2KB。 */
+/** 尽力收缩文字与可选字段;handler 负责拒绝仍超过 2KB 的必填元数据。 */
export function boundTaskDigest(raw: TaskDigestWire): TaskDigestWire {
const digest: TaskDigestWire = {
...raw,
@@ -99,7 +99,7 @@ export function boundTaskDigest(raw: TaskDigestWire): TaskDigestWire {
for (const key of SHRINKABLE) digest[key] = clip(digest[key], max, key === 'last_assistant_line');
digest.title = clip(digest.title, Math.min(TITLE_MAX, max)) ?? '';
}
- // 极端情况(超长 id / 模型名):去掉可选文字,保证合同成立。
+ // 极端情况(超长 id / 模型名):继续去掉可选文字,不破坏任务身份。
for (const key of SHRINKABLE) {
if (payloadBytes(digest) <= TASK_DIGEST_MAX_BYTES) break;
digest[key] = null;
@@ -108,6 +108,7 @@ export function boundTaskDigest(raw: TaskDigestWire): TaskDigestWire {
digest.suggested_route = null;
digest.title = clip(digest.title, 20) ?? '';
}
+ if (payloadBytes(digest) > TASK_DIGEST_MAX_BYTES) delete digest.sessionUrl;
return digest;
}
@@ -158,10 +159,14 @@ export function registerGetTaskDigestTool(
callerSessionId: deps.getSessionContext?.()?.sessionId,
});
if (!result.ok) return errorPayload(result.errorCode, result.message);
- return okPayload({ ...boundTaskDigest({
+ const digest = boundTaskDigest({
...result.digest,
...(deps.history.sessionUrl ? { sessionUrl: deps.history.sessionUrl(result.digest.session_id) } : {}),
- }) });
+ });
+ if (payloadBytes(digest) > TASK_DIGEST_MAX_BYTES) {
+ return errorPayload('DIGEST_TOO_LARGE', '任务摘要的必填元数据超过 2KB,无法安全返回。');
+ }
+ return okPayload({ ...digest });
},
});
}