Files
UHD_Media_Tool/packages/contracts/test/agent-events.test.ts
T
rootandClaude Opus 5.5 db5352eecd refactor(contracts,agent): single capability spec and agent run event definitions in contracts
B3: CapabilityDescriptor gains replay; CapabilitySpec + capabilitySpec(id) assemble
CAPABILITY_CATALOG + CAPABILITY_IO; drop CapabilityDefinition/CapabilityRisk. agent
registry registers contracts CapabilitySpec (kind/allowedKinds instead of its own
scope enum; approve also requires authorize). AgentRun port renamed AgentRunHandle.

B9: contracts AgentRunEvent/AgentRunEventBody/AgentRunEventRow/AgentUsageTotals with
row and SSE mapping helpers; agent onEvent receives AgentRunEvent, delivered serially
in seq order, firstSeq continues numbering across processes.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-27 19:15:49 +08:00

67 lines
2.5 KiB
TypeScript

import { describe, expect, it } from "vitest";
import * as C from "../src/index.ts";
const RUN = "7f0f5d64-6a39-4a4e-9a86-0d3a2f1e8b11";
const AT = "2026-09-27T00:00:00.000Z";
const usage = { inputTokens: 1, outputTokens: 2, cacheReadTokens: 0, cacheWriteTokens: 0, totalTokens: 3, costUsd: 0 };
const samples: C.AgentRunEventBody[] = [
{ type: "run_started", goal: "g", resumed: false },
{ type: "text_delta", delta: "hi" },
{ type: "thinking_delta", delta: "..." },
{ type: "tool_call_start", toolCallId: "t1", capabilityId: "inventory.query", inputSummary: "{}", recovery: false },
{
type: "tool_call_end",
toolCallId: "t1",
capabilityId: "inventory.query",
isError: true,
outputSummary: "x",
recovery: false,
},
{ type: "tool_call_rejected", toolCallId: "t2", toolName: "bash", reason: "不在白名单" },
{ type: "compaction", phase: "end", reason: "threshold", status: "completed" },
{ type: "run_completed", finalText: "done", usage },
{ type: "run_failed", reason: "budget", message: "超预算", usage, budget: "tokens" },
];
describe("agent 运行事件", () => {
it("样例覆盖全部 9 种事件类型", () => {
expect(samples.map((s) => s.type).sort()).toEqual([...C.AgentRunEventType.options].sort());
});
it("行往返无损,且行 schema 合法", () => {
samples.forEach((body, seq) => {
const e = { ...body, runId: RUN, seq, at: AT } as C.AgentRunEvent;
expect(C.AgentRunEvent.safeParse(e).success, body.type).toBe(true);
const row = C.agentRunEventToRow(e);
expect(C.AgentRunEventRow.safeParse(row).success, body.type).toBe(true);
expect(row.payload).not.toHaveProperty("type");
expect(C.agentRunEventFromRow(row)).toEqual(e);
});
});
it("映射到全局 SSE 事件:tool phase / run status,且 payload 合法", () => {
const bus = samples.map((body, seq) =>
C.agentRunEventToBusEvent({ ...body, runId: RUN, seq, at: AT } as C.AgentRunEvent),
);
expect(
bus.map((b) =>
b
? `${b.type}:${"phase" in b.payload ? b.payload.phase : "status" in b.payload ? b.payload.status : ""}`
: null,
),
).toEqual([
"agent.run_status:running",
"agent.text_delta:",
null,
"agent.tool_call:started",
"agent.tool_call:failed",
"agent.tool_call:denied",
null,
"agent.run_status:succeeded",
"agent.run_status:budget_exceeded",
]);
for (const b of bus) if (b) expect(C.parseEventPayload(b.type, b.payload), b.type).not.toBeNull();
});
});