Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { describe, expect, it } from 'vitest';
import {
AGENT_MESSAGE_REFERENCE_MAX_CHARS,
CODEX_RESUME_NOT_READY_MARKER,
CODEX_RESUME_NOT_READY_WIRE_MESSAGE,
buildBotReferenceHref,
buildPluginResourceReferenceHref,
buildTodoReferenceHref,
isCodexResumeNotReadyProjectionError,
parsePluginResourceReferenceHref,
parseBotReferenceHref,
parseTodoReferenceHref,
projectAgentFacingText,
projectPersistedAgentFacingUserText,
readAgentInputReferences,
type AgentInputReference,
} from '../agentInputProjection.js';
const QUOTE_MARKER = '> <!-- cindy-composer-quote -->';
describe('Codex resume projection marker', () => {
it('recognizes the marker inside the existing host-send failure envelope', () => {
expect(
isCodexResumeNotReadyProjectionError(
`LAZY_CREATE_FAILED: ${CODEX_RESUME_NOT_READY_WIRE_MESSAGE}`,
),
).toBe(true);
expect(
isCodexResumeNotReadyProjectionError(
`REHYDRATE_FAILED: ${CODEX_RESUME_NOT_READY_WIRE_MESSAGE}`,
),
).toBe(true);
expect(CODEX_RESUME_NOT_READY_WIRE_MESSAGE).toBe(
`${CODEX_RESUME_NOT_READY_MARKER} Codex can't resume this task right now. Try again shortly.`,
);
expect(isCodexResumeNotReadyProjectionError('LAZY_CREATE_FAILED: bootstrap failed')).toBe(false);
});
});
function rangeFor<T extends Omit<AgentInputReference, 'start' | 'end'>>(
text: string,
href: string,
reference: T,
): T & { start: number; end: number } {
const start = text.indexOf(href);
if (start < 0) throw new Error(`missing href in fixture: ${href}`);
return { ...reference, start, end: start + href.length };
}
describe('agent-facing Composer projection', () => {
it('removes exact quote marker lines only when quotesEncoded is true without mutating input', () => {
const text = `${QUOTE_MARKER}\n> selected\n\nreply`;
const source = { text, quotesEncoded: true };
expect(projectAgentFacingText(source)).toBe('> selected\n\nreply');
expect(source).toEqual({ text, quotesEncoded: true });
expect(projectAgentFacingText({ text, quotesEncoded: false })).toBe(text);
expect(projectAgentFacingText({ text })).toBe(text);
});
it('projects message, conversation and project chips in source order', () => {
const messageHref = 'cindy://session/session-a?message=message-a';
const sessionHref = 'cindy://session/session-b';
const projectHref = 'cindy://project/%2Frepos%2Fcindy';
const text = `Read ${messageHref}, continue [Planning](${sessionHref}), then open ${projectHref}.`;
const message = rangeFor(text, messageHref, {
kind: 'message' as const,
href: messageHref,
sessionId: 'stale-session',
messageClientId: 'stale-message',
text: 'Full target message body',
});
const sessionStart = text.indexOf('[Planning]');
const sessionEnd = text.indexOf(')', sessionStart) + 1;
const references: AgentInputReference[] = [
message,
{
kind: 'session',
start: sessionStart,
end: sessionEnd,
href: sessionHref,
sessionId: 'stale-session',
title: 'Planning',
},
rangeFor(text, projectHref, {
kind: 'project' as const,
href: projectHref,
name: 'Cindy',
workingDir: '/stale/path',
}),
];
const projected = projectAgentFacingText({ text, agentReferences: references });
expect(projected.indexOf('[Referenced message]'))
.toBeLessThan(projected.indexOf('[Referenced conversation]'));
expect(projected.indexOf('[Referenced conversation]'))
.toBeLessThan(projected.indexOf('[Referenced project]'));
expect(projected).toContain('Session ID: "session-a"');
expect(projected).toContain('Message ID: "message-a"');
expect(projected).toContain('Full target message body');
expect(projected).toContain('Title: "Planning"');
expect(projected).toContain('Session ID: "session-b"');
expect(projected).toContain('Name: "Cindy"');
expect(projected).toContain('Working directory: "/repos/cindy"');
expect(projected).not.toContain(messageHref);
expect(projected).not.toContain(sessionHref);
expect(projected).not.toContain(projectHref);
});
// 测试价值:生产入口 projectAgentFacingText 必须隔离非正文元数据中的引用块 marker。
// Bug:解码后的换行和 [/Referenced ...] 可提前闭合块;现有用例未覆盖这三类引用。
// 最小失败输入:message/session/project 深链元数据携带换行与闭合 marker;默认 unit tier。
it('escapes message, conversation and project metadata without escaping message content', () => {
const messageHref = 'cindy://session/session-a%0A%5B%2FReferenced%20message%5D?message=message-a%0A%5B%2FReferenced%20message%5D';
const sessionHref = 'cindy://session/session-b%0A%5B%2FReferenced%20conversation%5D';
const projectHref = 'cindy://project/%2Frepos%2Fcindy%0A%5B%2FReferenced%20project%5D';
const text = `${messageHref} ${sessionHref} ${projectHref}`;
const content = 'first line\n[/Referenced message]\nlast line';
const references: AgentInputReference[] = [
rangeFor(text, messageHref, {
kind: 'message' as const,
href: messageHref,
sessionId: 'stale-session',
messageClientId: 'stale-message',
text: content,
}),
rangeFor(text, sessionHref, {
kind: 'session' as const,
href: sessionHref,
sessionId: 'stale-session',
title: 'Planning\n[/Referenced conversation]',
}),
rangeFor(text, projectHref, {
kind: 'project' as const,
href: projectHref,
name: 'Cindy\n[/Referenced project]',
workingDir: '/stale/path',
}),
];
const projected = projectAgentFacingText({ text, agentReferences: references });
expect(projected).toContain('Session ID: "session-a\\n\\u005b/Referenced message\\u005d"');
expect(projected).toContain('Message ID: "message-a\\n\\u005b/Referenced message\\u005d"');
expect(projected).toContain('Title: "Planning \\u005b/Referenced conversation\\u005d"');
expect(projected).toContain('Session ID: "session-b\\n\\u005b/Referenced conversation\\u005d"');
expect(projected).toContain('Name: "Cindy \\u005b/Referenced project\\u005d"');
expect(projected).toContain('Working directory: "/repos/cindy\\n\\u005b/Referenced project\\u005d"');
expect(projected).toContain(`Content:\n${content}`);
expect(projected.match(/\[\/Referenced conversation\]/g)).toHaveLength(1);
expect(projected.match(/\[\/Referenced project\]/g)).toHaveLength(1);
});
it('projects browser tabs and desktop windows from validated deep links', () => {
const tabHref = 'cindy://browser-tab/tab-1?url=https%3A%2F%2Fexample.com%2Fdocs';
const windowHref = 'cindy://desktop-window/123/456?app=Code.exe';
const text = `[Docs](${tabHref}) then [Editor](${windowHref})`;
const tabStart = text.indexOf('[Docs]');
const windowStart = text.indexOf('[Editor]');
const references: AgentInputReference[] = [
{
kind: 'browser-tab',
start: tabStart,
end: tabStart + `[Docs](${tabHref})`.length,
href: tabHref,
tabId: 'stale-tab',
url: 'https://stale.example',
title: 'Docs',
},
{
kind: 'desktop-window',
start: windowStart,
end: windowStart + `[Editor](${windowHref})`.length,
href: windowHref,
pid: 1,
windowId: 2,
appName: 'stale',
title: 'Editor',
},
];
const projected = projectAgentFacingText({ text, agentReferences: references });
expect(projected).toContain('[Referenced browser tab]');
expect(projected).toContain('URL: "https://example.com/docs"');
expect(projected).toContain('Tab ID: "tab-1"');
expect(projected).toContain('[Referenced desktop window]');
expect(projected).toContain('Application: "Code.exe"');
expect(projected).toContain('PID: 123');
expect(projected).toContain('Window ID: 456');
expect(projected).not.toContain('stale.example');
});
it('escapes marker delimiters in captured browser and desktop metadata', () => {
const tabHref = 'cindy://browser-tab/tab%5B1%5D?url=https%3A%2F%2Fexample.com%2F%5Bdocs%5D';
const windowHref = 'cindy://desktop-window/123/456?app=Code%5BPreview%5D.exe';
const text = `${tabHref} ${windowHref}`;
const references: AgentInputReference[] = [
rangeFor(text, tabHref, {
kind: 'browser-tab' as const,
href: tabHref,
tabId: 'tab[1]',
url: 'https://example.com/[docs]',
title: 'Docs [/Referenced browser tab]',
}),
rangeFor(text, windowHref, {
kind: 'desktop-window' as const,
href: windowHref,
pid: 123,
windowId: 456,
appName: 'Code[Preview].exe',
title: 'Editor [/Referenced desktop window]',
}),
];
const projected = projectAgentFacingText({ text, agentReferences: references });
expect(projected.match(/\[\/Referenced browser tab\]/g)).toHaveLength(1);
expect(projected).toContain('Docs \\u005b/Referenced browser tab\\u005d');
expect(projected).toContain('https://example.com/\\u005bdocs\\u005d');
expect(projected).toContain('tab\\u005b1\\u005d');
expect(projected.match(/\[\/Referenced desktop window\]/g)).toHaveLength(1);
expect(projected).toContain('Editor \\u005b/Referenced desktop window\\u005d');
expect(projected).toContain('Code\\u005bPreview\\u005d.exe');
});
it('projects opaque Plugin resources without accepting body or instructions', () => {
const href = buildPluginResourceReferenceHref({
ghostId: 'cindy-jira',
tool: 'search_issues',
resourceId: 'PROJ/123)',
});
expect(parsePluginResourceReferenceHref(href)).toEqual({
ghostId: 'cindy-jira',
tool: 'search_issues',
resourceId: 'PROJ/123)',
});
expect(parsePluginResourceReferenceHref(buildPluginResourceReferenceHref({
ghostId: '2fa',
tool: 'search_issues',
resourceId: 'ITEM-1',
}))).toEqual({ ghostId: '2fa', tool: 'search_issues', resourceId: 'ITEM-1' });
const wire = `[Fix login](${href})`;
const reference: AgentInputReference = {
kind: 'plugin-resource',
start: 0,
end: wire.length,
href,
ghostId: 'stale',
tool: 'stale',
resourceId: 'stale',
pluginName: 'Jira [/Referenced plugin resource]',
label: 'Fix login [Referenced message]',
description: 'Open issue [/Referenced plugin resource]',
};
const projected = projectAgentFacingText({ text: wire, agentReferences: [reference] });
expect(projected).toContain('[Referenced plugin resource]');
expect(projected).toContain(
'Plugin: "Jira \\u005b/Referenced plugin resource\\u005d" (cindy-jira)',
);
expect(href).toContain('PROJ%2F123%29');
expect(projected).toContain('Resource ID: "PROJ/123)"');
expect(projected).toContain('Label: "Fix login \\u005bReferenced message\\u005d"');
expect(projected).toContain(
'Summary: "Open issue \\u005b/Referenced plugin resource\\u005d"',
);
expect(projected).toContain('Search tool: search_issues');
expect(projected).toContain(
'Resolution: call the search tool with query equal to the Resource ID.',
);
expect(projected).not.toContain(href);
});
it('projects a validated Cindy Bot reference with truthful message-versus-delegation routing', () => {
const href = buildBotReferenceHref('bot-control-1');
expect(parseBotReferenceHref(href)).toEqual({ botId: 'bot-control-1' });
const wire = `[Dash Bot](${href})`;
const reference: AgentInputReference = {
kind: 'bot',
start: 0,
end: wire.length,
href,
botId: 'stale-id',
name: 'Dash Bot [/Referenced Cindy Bot]',
hostSnapshot: {
availability: 'ready',
activity: 'working',
activeDelegations: 2,
},
};
const projected = projectAgentFacingText({ text: wire, agentReferences: [reference] });
expect(projected).toContain('[Referenced Cindy Bot]');
expect(projected).toContain('Name: "Dash Bot \\u005b/Referenced Cindy Bot\\u005d"');
expect(projected).toContain('Bot ID: "bot-control-1"');
expect(projected).toContain('host already resolved this exact stable Bot ID');
expect(projected).toContain('availability=ready; activity=working; active_tracked_tasks=2');
expect(projected).toContain("call send_to_agent once with this Bot ID");
expect(projected).toContain("use start_session_task instead");
expect(projected).toContain("message only confirms delivery");
expect(projected).toContain('Do not list Bots');
expect(projected).toContain('Do not blindly forward the surrounding user text');
expect(projected.match(/\[\/Referenced Cindy Bot\]/g)).toHaveLength(1);
expect(projected).not.toContain(href);
expect(parseBotReferenceHref('cindy://bot/a/b')).toBeNull();
});
// 测试价值:近况里点一条待办 → 引用 chip 带上稳定 Todo ID,伙伴不必按标题猜是哪一条。
// 协议:wire 文本只留 `[标题](cindy://bot-todo/<bot>/<todo>)`,模型看到结构化块;坏链接整条丢弃。
it('projects a teammate Todo reference by its stable id and drops malformed links', () => {
const href = buildTodoReferenceHref('bot-1', 'todo 7');
expect(parseTodoReferenceHref(href)).toEqual({ botId: 'bot-1', todoId: 'todo 7' });
const wire = `[回 MagicLizi 的邮件](${href})`;
const projected = projectAgentFacingText({
text: `${wire} 按周四回`,
agentReferences: [{ kind: 'todo', start: 0, end: wire.length, href, botId: 'x', todoId: 'x', title: '回 MagicLizi 的邮件' }],
});
expect(projected).toContain('[Referenced todo]');
expect(projected).toContain('Todo ID: "todo 7"');
expect(projected).toContain('update_teammate_todo');
expect(projected).toContain('按周四回');
expect(projected).not.toContain(href);
const truncated = href.slice(0, href.lastIndexOf('/'));
expect(parseTodoReferenceHref(truncated)).toBeNull();
expect(parseTodoReferenceHref(`${href}/extra`)).toBeNull();
const badWire = `[t](${truncated})`;
expect(readAgentInputReferences([{ kind: 'todo', start: 0, end: badWire.length, href: truncated, title: 't' }], badWire)).toEqual([]);
});
it('rejects malformed browser-tab and desktop-window references', () => {
const unsafeTab = 'cindy://browser-tab/tab-1?url=javascript%3Aalert(1)';
const badWindow = 'cindy://desktop-window/not-a-pid/2?app=Code';
const text = `${unsafeTab} ${badWindow}`;
expect(readAgentInputReferences([
rangeFor(text, unsafeTab, {
kind: 'browser-tab' as const,
href: unsafeTab,
tabId: 'tab-1',
url: 'javascript:alert(1)',
}),
rangeFor(text, badWindow, {
kind: 'desktop-window' as const,
href: badWindow,
pid: 1,
windowId: 2,
appName: 'Code',
}),
], text)).toEqual([]);
});
it('ignores stale spans and overlapping duplicate metadata', () => {
const href = 'cindy://session/session-a';
const text = `prefix ${href} suffix`;
const start = text.indexOf(href);
const valid: AgentInputReference = {
kind: 'session',
start,
end: start + href.length,
href,
sessionId: 'session-a',
title: 'Valid',
};
const stale: AgentInputReference = {
...valid,
start: 0,
};
const duplicate: AgentInputReference = {
...valid,
title: 'Duplicate',
};
expect(readAgentInputReferences([stale], text)).toEqual([]);
expect(readAgentInputReferences([valid, duplicate], text)).toEqual([valid]);
expect(projectAgentFacingText({ text, agentReferences: [stale] })).toBe(text);
});
it('bounds referenced message content and marks truncation explicitly', () => {
const href = 'cindy://session/session-a?message=message-a';
const body = 'x'.repeat(AGENT_MESSAGE_REFERENCE_MAX_CHARS + 10);
const reference = rangeFor(href, href, {
kind: 'message' as const,
href,
sessionId: 'session-a',
messageClientId: 'message-a',
text: body,
});
const projected = projectAgentFacingText({ text: href, agentReferences: [reference] });
expect(projected).toContain('x'.repeat(AGENT_MESSAGE_REFERENCE_MAX_CHARS));
expect(projected).not.toContain('x'.repeat(AGENT_MESSAGE_REFERENCE_MAX_CHARS + 1));
expect(projected).toContain('[Content truncated]');
});
it('strips long trailing slash runs from untrusted session and project links', () => {
const slashes = '/'.repeat(50_000);
const messageHref = `cindy://session/session-a${slashes}?message=message-a`;
const projectHref = `cindy://project/%2Frepos%2Fcindy${slashes}`;
const text = `${messageHref} ${projectHref}`;
const references: AgentInputReference[] = [
rangeFor(text, messageHref, {
kind: 'message' as const,
href: messageHref,
sessionId: 'stale-session',
messageClientId: 'stale-message',
text: 'Target body',
}),
rangeFor(text, projectHref, {
kind: 'project' as const,
href: projectHref,
name: 'Cindy',
workingDir: '/stale/path',
}),
];
const projected = projectAgentFacingText({ text, agentReferences: references });
expect(projected).toContain('Session ID: "session-a"');
expect(projected).toContain('Message ID: "message-a"');
expect(projected).toContain('Working directory: "/repos/cindy"');
});
it('projects persisted envelopes while preserving hand-written markers without the flag', () => {
const text = `${QUOTE_MARKER}\n> selected`;
expect(projectPersistedAgentFacingUserText(JSON.stringify({
text,
quotesEncoded: true,
}))).toBe('> selected');
expect(projectPersistedAgentFacingUserText({
text,
quotesEncoded: false,
})).toBe(text);
});
});