Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
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.tsindex 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.tsindex 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 });},});}