niceeval 0.13.1 → 0.13.2

package/dist/agents/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":";;AAAA,iDAAiD;AACjD,uDAAgE","sourcesContent":["// agent 域类型:Agent / Adapter 契约、会话与 tracing 导出配置。\nimport { AGENT_DOCKERFILE_CACHE_SAFE } from \"./cache-marker.ts\";\n// 「连到哪个被测对象、协议怎么说」的全部契约在这里(见 docs-site/zh/explanation/adapter.mdx)。\n// 能力不再是问卷式声明:t 上解锁什么完全由构造证据决定(见 docs-site 「能力从哪来」一节)。\nimport type { DiagnosticInput, JsonValue, ProgressUpdate } from \"../shared/types.ts\";\nimport type { StreamEvent, TraceSpan, Usage } from \"../o11y/types.ts\";\nimport type { Sandbox } from \"../sandbox/types.ts\";\nimport type { AttemptRef, MaybePromise, SandboxCommandTarget, StableSandboxCommand } from \"../sandbox/commands.ts\";\nimport type { RegisteredSandboxContent } from \"../sandbox/content.ts\";\nimport type { SendFailureClassifier } from \"../context/send-failures.ts\";\nimport type { SessionSlot } from \"./session-slot.ts\";\nexport type { SessionSlot } from \"./session-slot.ts\";\n/**\n * 本地 stdio 形态的 MCP server:沙箱内起子进程,按 stdio 说 MCP 协议。\n * 与 {@link McpHttpServer} 按形状判别(有 `command` 的是 stdio,有 `url` 的是 HTTP)。\n */\nexport interface McpStdioServer {\n    /** 服务器唯一名(config key)。 */\n    name: string;\n    /** 启动命令(如 \"npx\"、\"node\"、\"uvx\")。 */\n    command: string;\n    /** 传给命令的参数。 */\n    args?: readonly string[];\n    /** 注入服务器进程的环境变量(可能含 secret,不进 manifest)。 */\n    env?: Readonly<globalThis.Record<string, string>>;\n    /** stdio 与 HTTP 是互斥完成态，不能把另一分支的字段混进来。 */\n    url?: never;\n    headers?: never;\n}\n/**\n * 远程 Streamable HTTP 形态的 MCP server:沙箱直接连一个 HTTP 端点。\n * `url` 必须沙箱内可达——宿主机上的服务先经隧道(cloudflared / tailscale 等)暴露。\n */\nexport interface McpHttpServer {\n    /** 服务器唯一名(config key)。 */\n    name: string;\n    /** Streamable HTTP 端点(如 https://mem.example.com/mcp/)。 */\n    url: string;\n    /** 逐字写进每个请求的 HTTP 头(常用于 Authorization;可能含 secret,不进 manifest)。 */\n    headers?: Readonly<globalThis.Record<string, string>>;\n    /** HTTP 与 stdio 是互斥完成态，不能把另一分支的字段混进来。 */\n    command?: never;\n    args?: never;\n    env?: never;\n}\n/**\n * MCP server 描述符 —— 支持 MCP 的 adapter(Claude Code / Codex)共用的工具服务单元,\n * 不是 native plugin 的一种。stdio 与 Streamable HTTP 两种形态按形状判别,不设 kind 标签\n * (两种形态各有唯一必填判别字段);同时给出 `command` 与 `url` 属配置错误,setup 报错点名。\n * 在 agent factory config 里声明,setup 阶段写进各自的配置文件。\n * 见 docs/feature/adapters/architecture/coding-agent-extensions.md「类型边界」。\n */\nexport type McpServer = McpStdioServer | McpHttpServer;\n/**\n * Skill 的来源描述 —— Claude Code / Codex / Bub 共用的**数据类型**:只统一「从哪里取得\n * 哪份 Skill」,安装位置、发现机制、要不要额外写 project instruction 由各 Adapter 决定。\n * 见 docs/feature/adapters/architecture/coding-agent-extensions.md「类型边界」。\n */\nexport type SkillSpec = {\n    kind: \"local\";\n    /** 相对项目根(跑 niceeval 的目录)的 Skill 文件或目录:`SKILL.md`、含 `SKILL.md` 的目录,或单个 `.md`。 */\n    path: string;\n    /** 展示名;省略时由文件或目录名推导(`<dir>/SKILL.md` → `<dir>`,`foo.md` → `foo`)。 */\n    name?: string;\n} | {\n    kind: \"repo\";\n    /** GitHub `owner/repo` 或 Git URL。 */\n    source: string;\n    /** 多 Skill Repo 中要启用的 Skill;repo 只有一个 Skill 时可省略,多个时省略即 setup 失败。 */\n    skills?: readonly string[];\n    /** Tag、Commit 或 Branch;省略表示 repo 默认 ref。 */\n    ref?: string;\n};\n/** Manifest 里的一条 Skill 安装记录:本地(带内容哈希)或 repo(带来源与 ref)。 */\nexport type AgentSetupSkill = {\n    kind: \"local\";\n    name: string;\n    path: string;\n    sha256: string;\n} | {\n    kind: \"repo\";\n    source: string;\n    ref?: string;\n    skills: string[];\n};\n/**\n * 一次 Agent setup 实际装了什么 —— 沙箱型 Coding Agent Adapter 在 setup 收尾经\n * `ctx.reportSetup()` 交回的安装清单。它是宿主侧内存对象,运行器把它作为 attempt artifact 存成\n * `agent-setup.json`(见 docs/feature/record/architecture.md);沙箱磁盘上不落它。不参与评分,\n * 只回答「这次实际装了什么」;**环境变量值与 secret 不写进来**(所以 mcpServers 只记\n * name/command/args)。\n */\nexport interface AgentSetupManifest {\n    /** 装进去的 Skill(按配置顺序;同名来自多个来源时逐条保留,不静默合并)。 */\n    skills: AgentSetupSkill[];\n    /** Agent 原生 Plugin(Claude Code / Codex 各自的 Marketplace 协议)。 */\n    nativePlugins?: Array<{\n        agent: \"claude-code\" | \"codex\";\n        marketplace: {\n            name: string;\n            source: string;\n            ref?: string;\n        };\n        name: string;\n        /** 安装后 CLI 报告的版本;取不到时省略。 */\n        resolvedVersion?: string;\n    }>;\n    /** 挂上的 MCP server(只记非 secret 字段:stdio 不含 env,HTTP 不含 headers)。 */\n    mcpServers?: Array<{\n        name: string;\n        command: string;\n        args?: string[];\n    } | {\n        name: string;\n        url: string;\n    }>;\n    /**\n     * 官方原生配置文件(Claude Code `settings.json` / Codex `config.toml`):只记 Agent 名、\n     * 项目相对来源路径与原始字节的 SHA-256,不落正文 —— 任意官方配置都可能携带敏感字符串,\n     * 不能靠字段白名单证明适合原样落盘。\n     */\n    nativeConfigFile?: {\n        agent: \"claude-code\" | \"codex\";\n        path: string;\n        sha256: string;\n    };\n    /** Bub 的 Python Plugin(规范化后的 package 串)。 */\n    pythonPlugins?: Array<{\n        package: string;\n    }>;\n}\n// ───────────────────────── 证据覆盖声明 ─────────────────────────\n/** 证据通道的覆盖状态；不存在隐含的 unknown 第四态。 */\nexport type EvidenceCoverageStatus = \"complete\" | \"partial\" | \"unavailable\";\n/** 非完整通道必须解释缺口；完整通道不能携带一个自相矛盾的 reason。 */\nexport type EvidenceCoverageEntry = {\n    readonly status: \"complete\";\n    readonly reason?: never;\n} | {\n    readonly status: Exclude<EvidenceCoverageStatus, \"complete\">;\n    readonly reason: string;\n};\n/**\n * 覆盖声明(EvidenceCoverage):完整性不是口头承诺,是随数据走的声明\n * (见 docs/feature/adapters/architecture/evidence.md)。两层:\n * - Agent 级默认(`defineAgent` / `defineSandboxAgent` 的 `evidenceCoverage`)必须逐一声明\n *   六个通道；官方 SDK 适配器可使用 `completeEvidenceCoverage`。\n * - Turn 级降级(`Turn.evidenceCoverage`)只用于相对 Agent 默认值降级。\n */\nexport interface EvidenceCoverage {\n    /** 完整事件流(event / notEvent / order 的依据)。 */\n    readonly events: EvidenceCoverageEntry;\n    /** action 生命周期(工具正负断言、顺序、失败的依据)。 */\n    readonly actions: EvidenceCoverageEntry;\n    /** assistant / user message(reply、messageIncludes 的依据)。 */\n    readonly messages: EvidenceCoverageEntry;\n    /** usage(token / cost 上限断言的依据)。 */\n    readonly usage: EvidenceCoverageEntry;\n    /** Turn status 的真实性(succeeded / parked 的依据)——恒 completed 的映射必须声明非 complete。 */\n    readonly status: EvidenceCoverageEntry;\n    /** Turn.data(outputEquals / outputMatches 的依据)。 */\n    readonly data: EvidenceCoverageEntry;\n}\n/** 单轮只列相对 Agent 默认值的降级通道；省略的通道沿用 Agent 声明。 */\nexport type TurnEvidenceCoverage = Partial<EvidenceCoverage>;\n/** 随一轮消息附带的文件(图片等多模态输入)。 */\nexport interface InputFile {\n    /** 文件名(可选,供 adapter / 模型参考)。 */\n    readonly filename?: string;\n    /** MIME 类型,如 `image/png`、`image/jpeg`。 */\n    readonly mimeType: string;\n    /** base64 编码的文件内容(JSON 友好,remote adapter 可直接放进请求体)。 */\n    readonly dataBase64: string;\n}\n/**\n * HITL 回答轮里,人的裁决以结构化形式随 `input.responses` 到达——adapter 不需要解析\n * `text` 去猜哪句回答对应哪个请求、算不算批准。见 docs-site/zh/explanation/adapter.mdx\n * 「不同回答的入参」一节的四种典型形态。\n */\nexport type AnswerValue = {\n    readonly optionId: string;\n    readonly text?: never;\n} | {\n    readonly text: string;\n    readonly optionId?: never;\n};\nexport type InputResponse = {\n    /** 对应哪条 input.requested 请求;多个请求并停时靠它对位。 */\n    readonly requestId: string;\n} & AnswerValue;\nexport interface TurnInput {\n    readonly text: string;\n    /** 本轮附带的文件(图片等)。adapter 自行决定怎么投递;不支持多模态的 adapter 忽略它。 */\n    readonly files?: readonly InputFile[];\n    /** 仅回答轮(t.respond / t.respondAll):逐请求的结构化回答,按 requestId 对位。 */\n    readonly responses?: readonly InputResponse[];\n}\n/** adapter 的 send 返回值(事件流为核心)。 */\nexport interface Turn {\n    readonly events: StreamEvent[];\n    readonly data?: JsonValue;\n    readonly status: \"completed\" | \"failed\" | \"waiting\";\n    readonly usage?: Usage;\n    /**\n     * 本轮相对 Agent 默认覆盖的降级声明(这一轮流断了、拿不到 usage 等);\n     * 只能降级,不能把 Agent 未声明的通道升格成 complete(见 EvidenceCoverage)。\n     */\n    readonly evidenceCoverage?: TurnEvidenceCoverage;\n}\n/**\n * 本次运行的 OTLP traces 接收信息(仅当配置了 OTel 接入时有——agent 的 `tracing` 块 /\n * config 的 telemetry 存在)。经 ctx.telemetry 交给 agent。span 只进瀑布图,不喂断言。\n * 远程 HTTP 接入的 send 只需要 spread `headers`(每轮一个新 traceparent);接收端点是\n * 启动期配置(`defineConfig({ telemetry: { port } } )`)固定的,不从这里传。\n */\nexport interface Telemetry {\n    /** 接收端点(完整路径,形如 http://127.0.0.1:PORT/v1/traces)。 */\n    readonly endpoint: string;\n    /**\n     * env-based 导出的 env(= AgentTracing.env(endpoint) 的结果),ready-to-spread。\n     * adapter 的 send 直接 `{ ...ctx.telemetry?.env }` 注入,不必手搓 OTEL_* 拼装。\n     */\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n    /**\n     * 本轮的 W3C trace context(traceparent),每轮一个新值。send 把它 spread 进 HTTP 请求头\n     * (或注入子进程 env)——应用埋点支持 context 传播时,本轮 span 挂到我们给的 trace 下,\n     * 并发跑 eval 的 span 归属才精确;不带则回退时间窗口归属(该 agent 自动降为串行)。\n     */\n    readonly headers?: Readonly<globalThis.Record<string, string>>;\n}\n/**\n * agent 的 OTLP 导出配置 —— 「沙箱里怎么让这个 CLI 把 trace 发到 endpoint」。\n * 刻意从 setup 里拆出来:setup 管运行配置,这里只管 otel 导出。CLI 安装归 `agent.ensure`。两种投递方式\n * (互不排斥,按 CLI 而定):\n *   · env-based(标准 OTEL_* 环境变量,如 bub/Python OTel SDK)—— 用 `env`;\n *   · file-based(CLI 自有配置文件,如 codex 的 config.toml [otel] 块)—— 用 `configure`。\n */\nexport interface AgentTracing {\n    /**\n     * 线协议(codex 发 OTLP/JSON、bub 发 OTLP/protobuf)。接收器按 content-type 自动解码,\n     * 此字段仅作声明/日志用,也为将来按协议分流留口。\n     */\n    protocol?: \"http/json\" | \"http/protobuf\";\n    /**\n     * 接收器粒度(仅非沙箱 agent;沙箱型每沙箱一个,与此无关):\n     *   · \"attempt\"(默认)—— 每个 attempt 一个接收器。适合每轮能切换导出端点的被测对象\n     *     (进程内 adapter,如内置 aiSdkAgent 的可切换 exporter),attempt 间天然隔离、可全并发。\n     *   · \"run\" —— 整个 run 共享一个接收器(每 agent 一个)。**长驻服务必选**:应用的 OTEL_*\n     *     env 进程启动时读一次,per-attempt 端口会在第一个 attempt 结束时失效。span 逐轮归属\n     *     (traceparent / 时间窗口 + 串行守卫),见 ctx.telemetry.headers。\n     * config 配了 `telemetry`(固定端口,无侵入接入的长驻服务场景)的非沙箱 agent 自动按 \"run\" 处理。\n     */\n    scope?: \"attempt\" | \"run\";\n    /**\n     * env-based 导出:给 endpoint → 返回要注入每轮 send 的 env(纯函数)。运行器把结果\n     * 放进 ctx.telemetry.env,send 直接 spread。\n     */\n    env?(endpoint: string): globalThis.Record<string, string>;\n    /**\n     * file-based 导出:给 sandbox + ctx(ctx.telemetry.endpoint 必有),自己写 / 追加配置文件。\n     * 运行器在 agent.setup 之后、首次 send 之前调一次(仅当 tracing 开 + 有 endpoint)。\n     * 注:codex 的 [otel.trace_exporter.otlp-http] 是子表,configure 在 setup 写完主配置后\n     * 追加到 config.toml 末尾,天然满足「子表在所有上层表之后」。\n     */\n    configure?(sandbox: Sandbox, ctx: SandboxAgentContext): Promise<void> | void;\n}\n/**\n * 一条会话线。核心承诺只有一句:**同一条会话线的每次 send 拿到同一个 `ctx.session`,\n * 新会话线(eval 第一轮 / t.newSession() 之后)拿到一个全新的。**\n * 服务端历史用 `id` / `capture`，客户端历史与 HITL 停轮现场用 Adapter\n * 私有的 typed slot。\"第一轮\"是新会话线的自然形态，没有要判断的分支。\n */\nexport interface AgentSession {\n    /** 会话续接:服务端记历史。本线记过的会话 id;新会话线是 undefined。 */\n    readonly id?: string;\n    /** 记回传的会话 id;只在还没记过时落地(first-writer-wins),空值忽略。 */\n    capture(id: string | undefined): void;\n    /** 读 Adapter 私有 slot；新会话线或未写过的 slot 为空。 */\n    get<T>(slot: SessionSlot<T>): T | undefined;\n    /** 写 Adapter 私有 slot；同一 slot 再写覆盖旧值。 */\n    set<T>(slot: SessionSlot<T>, value: T): void;\n    /** 读并删除 Adapter 私有 slot，只消费一次。 */\n    take<T>(slot: SessionSlot<T>): T | undefined;\n}\nexport interface AgentContext {\n    /**\n     * 软取消信号:合并了 attempt 超时、run 级中断(用户 Ctrl+C)与评估用例自身的中断请求\n     * (见 src/runner/attempt.ts)。adapter 可以选择性检查它(或直接传给 `fetch`)以提前\n     * 优雅退出,但这不是唯一的硬边界——即便 adapter 完全忽略它,运行器也会用\n     * `Effect.timeoutTo` 兜底强制收尾(停 Sandbox 容器)。\n     */\n    readonly signal: AbortSignal;\n    /** 本次 attempt 用的模型名,透传自 experiment 的 `model` 字段。sandbox 型 agent 通常在 setup 里用它写配置,direct 型通常在 send 里用它选模型。 */\n    readonly model?: string;\n    /** 模型推理努力程度;归属同 model——实验决定,省略时不覆盖 agent 原生默认。 */\n    readonly reasoningEffort?: string;\n    /**\n     * experiment 的 `flags` 字段原样透传,内容和结构完全由 experiment 作者自定义\n     * (如 `{ webResearch: true }`、`{ systemPrompt: \"...\" }`)。adapter 按自己的约定\n     * 读取其中的字段;框架本身不解释、不校验它的内容。命名特意避开 CLI 解析出的\n     * `flag`(跑法层面的 --timeout/--budget 等),两者是不相关的概念。\n     */\n    readonly flags: Readonly<globalThis.Record<string, JsonValue>>;\n    /**\n     * 路径推导出的实验 id(与结果归属 `runWho` / `AgentRun.experimentId` 同源);不经\n     * experiment 跑(如脱离 CLI、直接构造 `AgentRun` 的场景)时为 undefined。典型用途:\n     * SandboxLayer command 按实验隔离跨 attempt 的基础设施内容，或 adapter 按实验切换鉴权 / 路由。\n     * 与 `flags`(实验条件的\n     * 具体取值)是两个维度——这里只是「跑的是哪个实验」的稳定标识,不携带条件内容。\n     */\n    readonly experimentId?: string;\n    /**\n     * 当前 Attempt 对应的 eval id。NiceEval runner 始终从 discovery 后的 Eval 身份填入；\n     * 第三方直接构造 AgentContext 时可省略。Adapter 可用它定位与题目同目录的只读宿主资产，\n     * 但不能据此绕过 Sandbox 的隐藏判据隔离。\n     */\n    readonly evalId?: string;\n    /** 当前 Attempt 的 Eval Group；未分组 Eval 省略。 */\n    readonly evalGroup?: {\n        readonly id: string;\n        readonly definitionHash: string;\n    };\n    /** Runner 填入的当前 Attempt 引用；第三方直接构造上下文时可省略。 */\n    readonly attempt?: AttemptRef;\n    readonly session: AgentSession;\n    /**\n     * 仅当配置了 OTel 接入时有(agent 的 `tracing` 块 / config 的 telemetry 存在):\n     * 本次运行的 OTLP traces 接收信息(endpoint + env-based 导出 env)。\n     * 怎么把它交给 CLI 由 agent 的 `tracing` 块声明:env-based 的把 ctx.telemetry.env\n     * spread 进 send;file-based 的在 tracing.configure 里写配置。远程 HTTP 接入的 send\n     * 只需要把 headers spread 进请求头(每轮一个新 traceparent);端点是启动期配置\n     * (defineConfig({ telemetry: { port } }))固定的,不从这里传。\n     */\n    readonly telemetry?: Telemetry;\n    /**\n     * 作用域反馈:报告此刻正在做什么(turn / tool / 安装进度)。短命状态——Human profile\n     * 更新 active 行,`agent`/`ci` 不逐条打印,也不进最终结果;不要每个 token/delta 都调用。\n     * runner 按当前回调所处的生命周期阶段(agent.setup / agent.run / agent.teardown)归因,\n     * 调用方不能冒充其它阶段(见 docs/feature/experiments/library.md)。\n     */\n    progress(update: ProgressUpdate): void;\n    /**\n     * 作用域反馈:报告运行结束后仍应保留的问题(协议降级、数据不完整、cleanup 问题)。\n     * 永久事件,落进 attempt 的 diagnostics 并进各 profile 的永久输出;`dedupeKey` 去重。\n     * 即使 level 为 \"error\" 也不改变 Turn.status / verdict——无法继续时抛异常。\n     */\n    diagnostic(input: DiagnosticInput): void;\n    /**\n     * `progress({ message: msg })` 的别名,不是第二条通道(见 docs/feature/experiments/cli.md\n     * 「Attempt 阶段」)。超时失败时最近若干行会并入结果的 error 信息,方便定位卡在哪一步。\n     */\n    log(msg: string): void;\n}\n/** 仅 Sandbox Agent 可见的上下文；Direct Agent 不接收也不伪造 Sandbox。 */\nexport interface SandboxAgentContext extends AgentContext {\n    readonly sandbox: Sandbox;\n}\n/**\n * Agent `setup` 的上下文:沙箱上下文再加一条宿主侧安装清单回执通道。只有 `setup` 收得到它——\n * 安装事实在这一步产生,`send` / `teardown` 不再补写。\n */\nexport interface SandboxAgentSetupContext extends SandboxAgentContext {\n    /**\n     * 交回这次实际安装了什么(Skill / 原生 Plugin / MCP / 原生配置文件)。清单是宿主侧内存对象,\n     * 运行器直接存成 attempt artifact `agent-setup.json`;沙箱里不落任何框架文件\n     * (见 docs/observability.md「宿主侧行为断言:t.o11y」)。什么都没装就别调——空清单不生成\n     * artifact。同一次 `setup` 内多次调用后写覆盖先写。\n     */\n    reportSetup(manifest: AgentSetupManifest): void;\n}\n/**\n * agent 自己的沙箱运行时生命周期(每个 Attempt 一次,与「每轮 send」分开):\n * CLI 安装属于 runner 的 agent.ensure；`setup` 只写 model/base/auth 等本 Attempt 运行配置，`send` 只管把一轮 prompt\n * 跑起来(第一次 fresh / 后续 resume)+ 解析 transcript,`teardown` 清理。\n * 运行器在 layer prepare → agent.ensure → baseline 后、第一次 send 前调一次 `setup`,不返回值;\n * `teardown` 当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免——半初始化\n * 的现场同样要扫尾),在 finally 里跑。要把 `setup` 里创建的句柄传给 `teardown`,以\n * `sandbox` 实例为键存取(同一个 Agent 实例服务并发 attempt,不要用实例字段或模块变量)。\n */\nexport type AgentSetup = (sandbox: Sandbox, ctx: SandboxAgentSetupContext) => Promise<void> | void;\nexport type AgentTeardown = (sandbox: Sandbox, ctx: SandboxAgentContext) => Promise<void> | void;\nexport type DirectAgentSetup = (ctx: AgentContext) => Promise<void> | void;\nexport type DirectAgentTeardown = (ctx: AgentContext) => Promise<void> | void;\n/**\n * 本 agent 的原生 OTLP span → canonical GenAI semconv 的薄 mapper。\n * 由 adapter 声明(和 tracing.env 一样属于「连到谁」的特殊性),core 只调接口——\n * 省略时 core 走通用 heuristic 兜底,不按 agent 名字分支。\n */\nexport type SpanMapper = (spans: TraceSpan[]) => TraceSpan[];\ninterface AgentBase {\n    readonly name: string;\n    /** 该 Adapter 的常态证据覆盖声明；六通道必填。 */\n    readonly evidenceCoverage: EvidenceCoverage;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /**\n     * 可选 send 执行失败分类器:归类 adapter reject 的 `SendFailure`；可信的 failed Turn\n     * 是领域结果，不进入这条链。\n     * 返回 `undefined` 表示不认识、回落保守兜底。链上排在实验的 `classifyFailure` 之后,\n     * 实验作者认领过的失败问不到这里。分类器只声明决策轴与诊断词,不影响重试策略(次数、\n     * 退避对所有 agent 一致);抛错按 `undefined` 回落并被吞掉,不掩盖原始失败。形状与分类链、\n     * 执行体时序见 docs/feature/error-classification/architecture.md。\n     */\n    classifySendFailure?: SendFailureClassifier;\n}\n// ───────────────────────── Agent Ensure / Installer ─────────────────────────\n/**\n * Agent 安装身份:纯数据,进 configHash 与 `run.json`。\n * 与 sandbox case 身份正交——改 Agent 版本不重建任务 BuildKey。\n * 见 docs/feature/adapters/architecture/agent-ensure.md。\n */\nexport interface AgentIdentity {\n    /** Agent 名(与 adapter 显示名对齐,如 `codex`)。 */\n    readonly agent: string;\n    /** 精确版本;禁止 `latest` 等无钉死取值——无稳定身份不参与可携带结果。 */\n    readonly version: string;\n    /** 配方修订(内置用数字字符串,自定义可用任意稳定串)。 */\n    readonly revision: string;\n}\n/**\n * 三种安装模式,全部显式;失败后不允许在模式之间静默降级。\n * - `staged`:制品在题面网络外准备,经文件 API 送入(内置默认)。\n * - `sandbox-network`:显式声明用沙箱内网络安装。\n * - `verify-only`:只接受预装命中;探测失败立即 errored。\n */\nexport type AgentInstallMode = \"staged\" | \"sandbox-network\" | \"verify-only\";\n/** staged payload 的完成态目标平台；Linux 的 libc 是身份的一部分，不能留成缺值。 */\nexport type AgentArtifactPlatform = {\n    readonly _tag: \"Linux\";\n    readonly os: \"linux\";\n    readonly arch: string;\n    readonly libc: \"gnu\" | \"musl\";\n} | {\n    readonly _tag: \"Darwin\";\n    readonly os: \"darwin\";\n    readonly arch: string;\n} | {\n    readonly _tag: \"Windows\";\n    readonly os: \"windows\";\n    readonly arch: string;\n};\n/**\n * Run 级准备好的锁定制品。digest + 实际 platform 只属于运行 provenance，不进入\n * configHash 或 Eval fingerprint；静态 installer identity/revision 与 ProviderPlan target 才是配置身份。\n * 安装时经主 Sandbox 文件 API 上传,不依赖题面网络。\n */\nexport interface AgentStagedArtifact {\n    readonly platform: AgentArtifactPlatform;\n    /** digest-backed 不可变内容句柄；不向 Attempt 泄露宿主路径。 */\n    readonly content: RegisteredSandboxContent;\n    /** 沙箱内落点，位于 workdir 外的 Agent 自有目录。 */\n    readonly targetPath: string;\n    /** 安装协议必须显式，不从缺失字段推断历史默认。 */\n    readonly install: AgentArtifactInstallShape;\n}\nexport type AgentArtifactInstallShape = {\n    readonly kind: \"npm-tarball\";\n} | {\n    readonly kind: \"self-contained\";\n    readonly binPath: string;\n};\n/** `agent.ensure` 的取值:区分 probe 命中与本次安装。 */\nexport type AgentEnsureOutcome = \"hit\" | \"installed\";\n/**\n * Adapter 声明的纯 Ensure 义务：身份与只读 probe。probe 的非零退出是未命中，不是\n * Agent 任务失败；Runner 决定是否交给 identity 精确匹配的 installer。\n */\nexport interface AgentEnsure {\n    readonly identity: AgentIdentity;\n    readonly probe: StableSandboxCommand;\n    /** Human-only transient labels; omitted adapters do not add an ensure detail. */\n    readonly progress?: {\n        readonly checking?: string;\n        readonly ready?: string;\n    };\n}\nexport interface AgentInstallContext {\n    readonly identity: AgentIdentity;\n    readonly targetPlatform: AgentArtifactPlatform;\n    readonly signal: AbortSignal;\n    progress(update: ProgressUpdate): void;\n}\nexport interface AgentArtifactContext {\n    readonly targetPlatform: AgentArtifactPlatform;\n    readonly signal: AbortSignal;\n}\nexport interface StagedAgentInstallContext extends AgentInstallContext {\n    readonly artifact: AgentStagedArtifact;\n}\ninterface AgentInstallerBase {\n    /** 必须与某条 ensure identity 完全相同；Runner 不做近似匹配。 */\n    readonly identity: AgentIdentity;\n    /** 支持的目标平台键(`linux-x64-gnu` 等)；省略表示 installer 自己支持所有平台。 */\n    readonly platforms?: readonly string[];\n    /** Human-only transient label; omitted installers do not add an install detail. */\n    readonly progress?: {\n        readonly installing?: string;\n    };\n    /** @internal 只由内置 cache-safe staged installer 写入。 */\n    readonly [AGENT_DOCKERFILE_CACHE_SAFE]?: true;\n}\nexport type AgentInstaller = (AgentInstallerBase & {\n    readonly installMode: \"staged\";\n    prepareArtifact(context: AgentArtifactContext): MaybePromise<AgentStagedArtifact>;\n    install(sandbox: SandboxCommandTarget, context: StagedAgentInstallContext): MaybePromise<void>;\n}) | (AgentInstallerBase & {\n    readonly installMode: \"sandbox-network\";\n    readonly prepareArtifact?: never;\n    install(sandbox: SandboxCommandTarget, context: AgentInstallContext): MaybePromise<void>;\n}) | (AgentInstallerBase & {\n    readonly installMode: \"verify-only\";\n    readonly prepareArtifact?: never;\n    readonly install?: never;\n});\n/** 在 NiceEval 管理的 Sandbox 内驱动 CLI 的 Agent。 */\nexport interface SandboxAgent extends AgentBase {\n    readonly kind: \"sandbox\";\n    /** Runner 在 author layers 后、setup 前按声明顺序执行。 */\n    readonly ensure: readonly AgentEnsure[];\n    /** 官方或第三方随 adapter 提供的安装层；仅 identity 精确匹配时可接手。 */\n    readonly installers: readonly AgentInstaller[];\n    setup?: AgentSetup;\n    tracing?: AgentTracing;\n    send(input: TurnInput, ctx: SandboxAgentContext): Promise<Turn>;\n    teardown?: AgentTeardown;\n}\n/** 由 runner 直接调用函数、SDK 或服务端点的 Agent；目标进程可以在本地或远端。 */\nexport interface DirectAgent extends AgentBase {\n    readonly kind: \"direct\";\n    setup?: DirectAgentSetup;\n    tracing?: Omit<AgentTracing, \"configure\">;\n    send(input: TurnInput, ctx: AgentContext): Promise<Turn>;\n    teardown?: DirectAgentTeardown;\n}\n/** 注册表里的 Agent；判别值描述驱动拓扑，不描述目标所在位置。 */\nexport type Agent = SandboxAgent | DirectAgent;\n/** `defineSandboxAgent()` 的入参形状(见 src/define.ts)——`kind: \"sandbox\"` 由 define 固定填入,不由用户声明。 */\nexport interface SandboxAgentDef {\n    /** agent 的显示名/标识,原样进入 `Agent.name`——不是注册表查找 key,只用于展示、结果归属与去重指纹。 */\n    name: string;\n    /** 该 Adapter 的常态证据覆盖声明；完整采集可用 `completeEvidenceCoverage`。 */\n    evidenceCoverage: EvidenceCoverage;\n    /** 单条或数组都按声明顺序规范化为 Agent layer。 */\n    ensure: AgentEnsure | readonly AgentEnsure[];\n    /**\n     * 配对安装层；省略表示这个 adapter 只提供 probe 协议，未命中时 Runner 在\n     * `agent.ensure` 点名缺失的精确 identity。工厂会把省略规范化成空数组。\n     */\n    installers?: readonly AgentInstaller[];\n    /**\n     * 每条 Attempt 一次(不是每轮 send 一次):写 config.toml / 鉴权配置(model/base/auth 等\n     * 本 Attempt 内不变的运行配置)。CLI 的 probe、安装与复检属于 `agent.ensure`。运行器在 Sandbox\n     * 备好(layer prepare/ensure/baseline 之后)、第一次 send 前调用一次,不返回值。\n     */\n    setup?: AgentSetup;\n    /** OTLP 导出配置:Sandbox 里怎么让 CLI 把 trace 发到 endpoint(env / 配置文件),从 setup 拆出。 */\n    tracing?: AgentTracing;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /** 每轮一次:跑 prompt(fresh / resume)+ 解析成 events。 */\n    send(input: TurnInput, ctx: SandboxAgentContext): Promise<Turn>;\n    /** 可选 send 执行失败分类器:见 `Agent.classifySendFailure`。 */\n    classifySendFailure?: SendFailureClassifier;\n    /** Sandbox 销毁前的清理,当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免),\n     * 在 finally 里跑一次。 */\n    teardown?: AgentTeardown;\n}\n/** `defineAgent()` 的入参形状(见 src/define.ts)——`kind: \"direct\"` 由 define 固定填入,不由用户声明。 */\nexport interface DirectAgentDef {\n    /** agent 的显示名/标识,原样进入 `Agent.name`——不是注册表查找 key,只用于展示、结果归属与去重指纹。 */\n    name: string;\n    /** 该 Adapter 的常态证据覆盖声明；完整采集可用 `completeEvidenceCoverage`。 */\n    evidenceCoverage: EvidenceCoverage;\n    /**\n     * 每个 attempt 一次。Direct Agent 不接收 Sandbox；常用于建立连接、鉴权等一次性准备。\n     */\n    setup?: DirectAgentSetup;\n    /** OTLP 导出配置:被测对象怎么把 trace 发到 endpoint(env-based 注入)。 */\n    tracing?: Omit<AgentTracing, \"configure\">;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /** 每轮一次:把一轮 prompt 直接发给函数、SDK 或服务端点,解析响应成 events。 */\n    send(input: TurnInput, ctx: AgentContext): Promise<Turn>;\n    /** 可选 send 执行失败分类器:见 `Agent.classifySendFailure`。 */\n    classifySendFailure?: SendFailureClassifier;\n    /** 运行结束前的清理,当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免),\n     * 在 finally 里跑一次。 */\n    teardown?: DirectAgentTeardown;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":";;AAAA,iDAAiD;AACjD,uDAAgE","sourcesContent":["// agent 域类型:Agent / Adapter 契约、会话与 tracing 导出配置。\nimport { AGENT_DOCKERFILE_CACHE_SAFE } from \"./cache-marker.ts\";\n// 「连到哪个被测对象、协议怎么说」的全部契约在这里(见 docs-site/zh/explanation/adapter.mdx)。\n// 能力不再是问卷式声明:t 上解锁什么完全由构造证据决定(见 docs-site 「能力从哪来」一节)。\nimport type { DiagnosticInput, JsonValue, ProgressUpdate } from \"../shared/types.ts\";\nimport type { StreamEvent, TraceSpan, Usage } from \"../o11y/types.ts\";\nimport type { Sandbox } from \"../sandbox/types.ts\";\nimport type { AttemptRef, MaybePromise, SandboxCommandTarget, StableSandboxCommand } from \"../sandbox/commands.ts\";\nimport type { RegisteredSandboxContent } from \"../sandbox/content.ts\";\nimport type { SendFailureClassifier } from \"../context/send-failures.ts\";\nimport type { SessionSlot } from \"./session-slot.ts\";\nexport type { SessionSlot } from \"./session-slot.ts\";\n/**\n * 本地 stdio 形态的 MCP server:沙箱内起子进程,按 stdio 说 MCP 协议。\n * 与 {@link McpHttpServer} 按形状判别(有 `command` 的是 stdio,有 `url` 的是 HTTP)。\n */\nexport interface McpStdioServer {\n    /** 服务器唯一名(config key)。 */\n    name: string;\n    /** 启动命令(如 \"npx\"、\"node\"、\"uvx\")。 */\n    command: string;\n    /** 传给命令的参数。 */\n    args?: readonly string[];\n    /** 注入服务器进程的环境变量(可能含 secret,不进 manifest)。 */\n    env?: Readonly<globalThis.Record<string, string>>;\n    /** stdio 与 HTTP 是互斥完成态，不能把另一分支的字段混进来。 */\n    url?: never;\n    headers?: never;\n}\n/**\n * 远程 Streamable HTTP 形态的 MCP server:沙箱直接连一个 HTTP 端点。\n * `url` 必须沙箱内可达——宿主机上的服务先经隧道(cloudflared / tailscale 等)暴露。\n */\nexport interface McpHttpServer {\n    /** 服务器唯一名(config key)。 */\n    name: string;\n    /** Streamable HTTP 端点(如 https://mem.example.com/mcp/)。 */\n    url: string;\n    /** 逐字写进每个请求的 HTTP 头(常用于 Authorization;可能含 secret,不进 manifest)。 */\n    headers?: Readonly<globalThis.Record<string, string>>;\n    /** HTTP 与 stdio 是互斥完成态，不能把另一分支的字段混进来。 */\n    command?: never;\n    args?: never;\n    env?: never;\n}\n/**\n * MCP server 描述符 —— 支持 MCP 的 adapter(Claude Code / Codex)共用的工具服务单元,\n * 不是 native plugin 的一种。stdio 与 Streamable HTTP 两种形态按形状判别,不设 kind 标签\n * (两种形态各有唯一必填判别字段);同时给出 `command` 与 `url` 属配置错误,setup 报错点名。\n * 在 agent factory config 里声明,setup 阶段写进各自的配置文件。\n * 见 docs/feature/adapters/architecture/coding-agent-extensions.md「类型边界」。\n */\nexport type McpServer = McpStdioServer | McpHttpServer;\n/**\n * Skill 的来源描述 —— Claude Code / Codex / Bub 共用的**数据类型**:只统一「从哪里取得\n * 哪份 Skill」,安装位置、发现机制、要不要额外写 project instruction 由各 Adapter 决定。\n * 见 docs/feature/adapters/architecture/coding-agent-extensions.md「类型边界」。\n */\nexport type SkillSpec = {\n    kind: \"local\";\n    /** 相对项目根(跑 niceeval 的目录)的 Skill 文件或目录:`SKILL.md`、含 `SKILL.md` 的目录,或单个 `.md`。 */\n    path: string;\n    /** 展示名;省略时由文件或目录名推导(`<dir>/SKILL.md` → `<dir>`,`foo.md` → `foo`)。 */\n    name?: string;\n} | {\n    kind: \"repo\";\n    /** GitHub `owner/repo` 或 Git URL。 */\n    source: string;\n    /** 多 Skill Repo 中要启用的 Skill;repo 只有一个 Skill 时可省略,多个时省略即 setup 失败。 */\n    skills?: readonly string[];\n    /** Tag、Commit 或 Branch;省略表示 repo 默认 ref。 */\n    ref?: string;\n};\n/** Manifest 里的一条 Skill 安装记录:本地(带内容哈希)或 repo(带来源与 ref)。 */\nexport type AgentSetupSkill = {\n    kind: \"local\";\n    name: string;\n    path: string;\n    sha256: string;\n} | {\n    kind: \"repo\";\n    source: string;\n    ref?: string;\n    skills: string[];\n};\n/**\n * 一次 Agent setup 实际装了什么 —— 沙箱型 Coding Agent Adapter 在 setup 收尾经\n * `ctx.reportSetup()` 交回的安装清单。它是宿主侧内存对象,运行器把它作为 attempt artifact 存成\n * `agent-setup.json`(见 docs/feature/record/architecture.md);沙箱磁盘上不落它。不参与评分,\n * 只回答「这次实际装了什么」;**环境变量值与 secret 不写进来**(所以 mcpServers 只记\n * name/command/args)。\n */\nexport interface AgentSetupManifest {\n    /** 装进去的 Skill(按配置顺序;同名来自多个来源时逐条保留,不静默合并)。 */\n    skills: AgentSetupSkill[];\n    /** Agent 原生 Plugin(Claude Code / Codex 各自的 Marketplace 协议)。 */\n    nativePlugins?: Array<{\n        agent: \"claude-code\" | \"codex\";\n        marketplace: {\n            name: string;\n            source: string;\n            ref?: string;\n        };\n        name: string;\n        /** 安装后 CLI 报告的版本;取不到时省略。 */\n        resolvedVersion?: string;\n    }>;\n    /** 挂上的 MCP server(只记非 secret 字段:stdio 不含 env,HTTP 不含 headers)。 */\n    mcpServers?: Array<{\n        name: string;\n        command: string;\n        args?: string[];\n    } | {\n        name: string;\n        url: string;\n    }>;\n    /**\n     * 官方原生配置文件(Claude Code `settings.json` / Codex `config.toml`):只记 Agent 名、\n     * 项目相对来源路径与原始字节的 SHA-256,不落正文 —— 任意官方配置都可能携带敏感字符串,\n     * 不能靠字段白名单证明适合原样落盘。\n     */\n    nativeConfigFile?: {\n        agent: \"claude-code\" | \"codex\";\n        path: string;\n        sha256: string;\n    };\n    /** Bub 的 Python Plugin(规范化后的 package 串)。 */\n    pythonPlugins?: Array<{\n        package: string;\n    }>;\n}\n// ───────────────────────── 证据覆盖声明 ─────────────────────────\n/** 证据通道的覆盖状态；不存在隐含的 unknown 第四态。 */\nexport type EvidenceCoverageStatus = \"complete\" | \"partial\" | \"unavailable\";\n/** 非完整通道必须解释缺口；完整通道不能携带一个自相矛盾的 reason。 */\nexport type EvidenceCoverageEntry = {\n    readonly status: \"complete\";\n    readonly reason?: never;\n} | {\n    readonly status: Exclude<EvidenceCoverageStatus, \"complete\">;\n    readonly reason: string;\n};\n/**\n * 覆盖声明(EvidenceCoverage):完整性不是口头承诺,是随数据走的声明\n * (见 docs/feature/adapters/architecture/evidence.md)。两层:\n * - Agent 级默认(`defineAgent` / `defineSandboxAgent` 的 `evidenceCoverage`)必须逐一声明\n *   六个通道；官方 SDK 适配器可使用 `completeEvidenceCoverage`。\n * - Turn 级降级(`Turn.evidenceCoverage`)只用于相对 Agent 默认值降级。\n */\nexport interface EvidenceCoverage {\n    /** 完整事件流(event / notEvent / order 的依据)。 */\n    readonly events: EvidenceCoverageEntry;\n    /** action 生命周期(工具正负断言、顺序、失败的依据)。 */\n    readonly actions: EvidenceCoverageEntry;\n    /** assistant / user message（reply 与显式 message 值断言的依据）。 */\n    readonly messages: EvidenceCoverageEntry;\n    /** usage(token / cost 上限断言的依据)。 */\n    readonly usage: EvidenceCoverageEntry;\n    /** Turn status 的真实性(succeeded / parked 的依据)——恒 completed 的映射必须声明非 complete。 */\n    readonly status: EvidenceCoverageEntry;\n    /** Turn.data（供 `t.check(turn.data, match)` 检查结构化输出）。 */\n    readonly data: EvidenceCoverageEntry;\n}\n/** 单轮只列相对 Agent 默认值的降级通道；省略的通道沿用 Agent 声明。 */\nexport type TurnEvidenceCoverage = Partial<EvidenceCoverage>;\n/** 随一轮消息附带的文件(图片等多模态输入)。 */\nexport interface InputFile {\n    /** 文件名(可选,供 adapter / 模型参考)。 */\n    readonly filename?: string;\n    /** MIME 类型,如 `image/png`、`image/jpeg`。 */\n    readonly mimeType: string;\n    /** base64 编码的文件内容(JSON 友好,remote adapter 可直接放进请求体)。 */\n    readonly dataBase64: string;\n}\n/**\n * HITL 回答轮里,人的裁决以结构化形式随 `input.responses` 到达——adapter 不需要解析\n * `text` 去猜哪句回答对应哪个请求、算不算批准。见 docs-site/zh/explanation/adapter.mdx\n * 「不同回答的入参」一节的四种典型形态。\n */\nexport type AnswerValue = {\n    readonly optionId: string;\n    readonly text?: never;\n} | {\n    readonly text: string;\n    readonly optionId?: never;\n};\nexport type InputResponse = {\n    /** 对应哪条 input.requested 请求;多个请求并停时靠它对位。 */\n    readonly requestId: string;\n} & AnswerValue;\nexport interface TurnInput {\n    readonly text: string;\n    /** 本轮附带的文件(图片等)。adapter 自行决定怎么投递;不支持多模态的 adapter 忽略它。 */\n    readonly files?: readonly InputFile[];\n    /** 仅回答轮(t.respond / t.respondAll):逐请求的结构化回答,按 requestId 对位。 */\n    readonly responses?: readonly InputResponse[];\n}\n/** adapter 的 send 返回值(事件流为核心)。 */\nexport interface Turn {\n    readonly events: StreamEvent[];\n    readonly data?: JsonValue;\n    readonly status: \"completed\" | \"failed\" | \"waiting\";\n    readonly usage?: Usage;\n    /**\n     * 本轮相对 Agent 默认覆盖的降级声明(这一轮流断了、拿不到 usage 等);\n     * 只能降级,不能把 Agent 未声明的通道升格成 complete(见 EvidenceCoverage)。\n     */\n    readonly evidenceCoverage?: TurnEvidenceCoverage;\n}\n/**\n * 本次运行的 OTLP traces 接收信息(仅当配置了 OTel 接入时有——agent 的 `tracing` 块 /\n * config 的 telemetry 存在)。经 ctx.telemetry 交给 agent。span 只进瀑布图,不喂断言。\n * 远程 HTTP 接入的 send 只需要 spread `headers`(每轮一个新 traceparent);接收端点是\n * 启动期配置(`defineConfig({ telemetry: { port } } )`)固定的,不从这里传。\n */\nexport interface Telemetry {\n    /** 接收端点(完整路径,形如 http://127.0.0.1:PORT/v1/traces)。 */\n    readonly endpoint: string;\n    /**\n     * env-based 导出的 env(= AgentTracing.env(endpoint) 的结果),ready-to-spread。\n     * adapter 的 send 直接 `{ ...ctx.telemetry?.env }` 注入,不必手搓 OTEL_* 拼装。\n     */\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n    /**\n     * 本轮的 W3C trace context(traceparent),每轮一个新值。send 把它 spread 进 HTTP 请求头\n     * (或注入子进程 env)——应用埋点支持 context 传播时,本轮 span 挂到我们给的 trace 下,\n     * 并发跑 eval 的 span 归属才精确;不带则回退时间窗口归属(该 agent 自动降为串行)。\n     */\n    readonly headers?: Readonly<globalThis.Record<string, string>>;\n}\n/**\n * agent 的 OTLP 导出配置 —— 「沙箱里怎么让这个 CLI 把 trace 发到 endpoint」。\n * 刻意从 setup 里拆出来:setup 管运行配置,这里只管 otel 导出。CLI 安装归 `agent.ensure`。两种投递方式\n * (互不排斥,按 CLI 而定):\n *   · env-based(标准 OTEL_* 环境变量,如 bub/Python OTel SDK)—— 用 `env`;\n *   · file-based(CLI 自有配置文件,如 codex 的 config.toml [otel] 块)—— 用 `configure`。\n */\nexport interface AgentTracing {\n    /**\n     * 线协议(codex 发 OTLP/JSON、bub 发 OTLP/protobuf)。接收器按 content-type 自动解码,\n     * 此字段仅作声明/日志用,也为将来按协议分流留口。\n     */\n    protocol?: \"http/json\" | \"http/protobuf\";\n    /**\n     * 接收器粒度(仅非沙箱 agent;沙箱型每沙箱一个,与此无关):\n     *   · \"attempt\"(默认)—— 每个 attempt 一个接收器。适合每轮能切换导出端点的被测对象\n     *     (进程内 adapter,如内置 aiSdkAgent 的可切换 exporter),attempt 间天然隔离、可全并发。\n     *   · \"run\" —— 整个 run 共享一个接收器(每 agent 一个)。**长驻服务必选**:应用的 OTEL_*\n     *     env 进程启动时读一次,per-attempt 端口会在第一个 attempt 结束时失效。span 逐轮归属\n     *     (traceparent / 时间窗口 + 串行守卫),见 ctx.telemetry.headers。\n     * config 配了 `telemetry`(固定端口,无侵入接入的长驻服务场景)的非沙箱 agent 自动按 \"run\" 处理。\n     */\n    scope?: \"attempt\" | \"run\";\n    /**\n     * env-based 导出:给 endpoint → 返回要注入每轮 send 的 env(纯函数)。运行器把结果\n     * 放进 ctx.telemetry.env,send 直接 spread。\n     */\n    env?(endpoint: string): globalThis.Record<string, string>;\n    /**\n     * file-based 导出:给 sandbox + ctx(ctx.telemetry.endpoint 必有),自己写 / 追加配置文件。\n     * 运行器在 agent.setup 之后、首次 send 之前调一次(仅当 tracing 开 + 有 endpoint)。\n     * 注:codex 的 [otel.trace_exporter.otlp-http] 是子表,configure 在 setup 写完主配置后\n     * 追加到 config.toml 末尾,天然满足「子表在所有上层表之后」。\n     */\n    configure?(sandbox: Sandbox, ctx: SandboxAgentContext): Promise<void> | void;\n}\n/**\n * 一条会话线。核心承诺只有一句:**同一条会话线的每次 send 拿到同一个 `ctx.session`,\n * 新会话线(eval 第一轮 / t.newSession() 之后)拿到一个全新的。**\n * 服务端历史用 `id` / `capture`，客户端历史与 HITL 停轮现场用 Adapter\n * 私有的 typed slot。\"第一轮\"是新会话线的自然形态，没有要判断的分支。\n */\nexport interface AgentSession {\n    /** 会话续接:服务端记历史。本线记过的会话 id;新会话线是 undefined。 */\n    readonly id?: string;\n    /** 记回传的会话 id;只在还没记过时落地(first-writer-wins),空值忽略。 */\n    capture(id: string | undefined): void;\n    /** 读 Adapter 私有 slot；新会话线或未写过的 slot 为空。 */\n    get<T>(slot: SessionSlot<T>): T | undefined;\n    /** 写 Adapter 私有 slot；同一 slot 再写覆盖旧值。 */\n    set<T>(slot: SessionSlot<T>, value: T): void;\n    /** 读并删除 Adapter 私有 slot，只消费一次。 */\n    take<T>(slot: SessionSlot<T>): T | undefined;\n}\nexport interface AgentContext {\n    /**\n     * 软取消信号:合并了 attempt 超时、run 级中断(用户 Ctrl+C)与评估用例自身的中断请求\n     * (见 src/runner/attempt.ts)。adapter 可以选择性检查它(或直接传给 `fetch`)以提前\n     * 优雅退出,但这不是唯一的硬边界——即便 adapter 完全忽略它,运行器也会用\n     * `Effect.timeoutTo` 兜底强制收尾(停 Sandbox 容器)。\n     */\n    readonly signal: AbortSignal;\n    /** 本次 attempt 用的模型名,透传自 experiment 的 `model` 字段。sandbox 型 agent 通常在 setup 里用它写配置,direct 型通常在 send 里用它选模型。 */\n    readonly model?: string;\n    /** 模型推理努力程度;归属同 model——实验决定,省略时不覆盖 agent 原生默认。 */\n    readonly reasoningEffort?: string;\n    /**\n     * experiment 的 `flags` 字段原样透传,内容和结构完全由 experiment 作者自定义\n     * (如 `{ webResearch: true }`、`{ systemPrompt: \"...\" }`)。adapter 按自己的约定\n     * 读取其中的字段;框架本身不解释、不校验它的内容。命名特意避开 CLI 解析出的\n     * `flag`(跑法层面的 --timeout/--budget 等),两者是不相关的概念。\n     */\n    readonly flags: Readonly<globalThis.Record<string, JsonValue>>;\n    /**\n     * 路径推导出的实验 id(与结果归属 `runWho` / `AgentRun.experimentId` 同源);不经\n     * experiment 跑(如脱离 CLI、直接构造 `AgentRun` 的场景)时为 undefined。典型用途:\n     * SandboxLayer command 按实验隔离跨 attempt 的基础设施内容，或 adapter 按实验切换鉴权 / 路由。\n     * 与 `flags`(实验条件的\n     * 具体取值)是两个维度——这里只是「跑的是哪个实验」的稳定标识,不携带条件内容。\n     */\n    readonly experimentId?: string;\n    /**\n     * 当前 Attempt 对应的 eval ID。NiceEval Runner 始终从 discovery 后的评估用例身份填入；\n     * 第三方直接构造 AgentContext 时可省略。Adapter 可用它定位与题目同目录的只读宿主资产，\n     * 但不能据此绕过 Sandbox 的隐藏判据隔离。\n     */\n    readonly evalId?: string;\n    /** 当前 Attempt 的评估组；未分组评估用例省略。 */\n    readonly evalGroup?: {\n        readonly id: string;\n        readonly definitionHash: string;\n    };\n    /** Runner 填入的当前 Attempt 引用；第三方直接构造上下文时可省略。 */\n    readonly attempt?: AttemptRef;\n    readonly session: AgentSession;\n    /**\n     * 仅当配置了 OTel 接入时有(agent 的 `tracing` 块 / config 的 telemetry 存在):\n     * 本次运行的 OTLP traces 接收信息(endpoint + env-based 导出 env)。\n     * 怎么把它交给 CLI 由 agent 的 `tracing` 块声明:env-based 的把 ctx.telemetry.env\n     * spread 进 send;file-based 的在 tracing.configure 里写配置。远程 HTTP 接入的 send\n     * 只需要把 headers spread 进请求头(每轮一个新 traceparent);端点是启动期配置\n     * (defineConfig({ telemetry: { port } }))固定的,不从这里传。\n     */\n    readonly telemetry?: Telemetry;\n    /**\n     * 作用域反馈:报告此刻正在做什么(turn / tool / 安装进度)。短命状态——Human profile\n     * 更新 active 行,`agent`/`ci` 不逐条打印,也不进最终结果;不要每个 token/delta 都调用。\n     * runner 按当前回调所处的生命周期阶段(agent.setup / agent.run / agent.teardown)归因,\n     * 调用方不能冒充其它阶段(见 docs/feature/experiments/library.md)。\n     */\n    progress(update: ProgressUpdate): void;\n    /**\n     * 作用域反馈:报告运行结束后仍应保留的问题(协议降级、数据不完整、cleanup 问题)。\n     * 永久事件,落进 attempt 的 diagnostics 并进各 profile 的永久输出;`dedupeKey` 去重。\n     * 即使 level 为 \"error\" 也不改变 Turn.status / verdict——无法继续时抛异常。\n     */\n    diagnostic(input: DiagnosticInput): void;\n    /**\n     * `progress({ message: msg })` 的别名,不是第二条通道(见 docs/feature/experiments/cli.md\n     * 「Attempt 阶段」)。超时失败时最近若干行会并入结果的 error 信息,方便定位卡在哪一步。\n     */\n    log(msg: string): void;\n}\n/** 仅 Sandbox Agent 可见的上下文；Direct Agent 不接收也不伪造 Sandbox。 */\nexport interface SandboxAgentContext extends AgentContext {\n    readonly sandbox: Sandbox;\n}\n/**\n * Agent `setup` 的上下文:沙箱上下文再加一条宿主侧安装清单回执通道。只有 `setup` 收得到它——\n * 安装事实在这一步产生,`send` / `teardown` 不再补写。\n */\nexport interface SandboxAgentSetupContext extends SandboxAgentContext {\n    /**\n     * 交回这次实际安装了什么(Skill / 原生 Plugin / MCP / 原生配置文件)。清单是宿主侧内存对象,\n     * 运行器直接存成 attempt artifact `agent-setup.json`;沙箱里不落任何框架文件\n     * (见 docs/observability.md「宿主侧行为断言:t.o11y」)。什么都没装就别调——空清单不生成\n     * artifact。同一次 `setup` 内多次调用后写覆盖先写。\n     */\n    reportSetup(manifest: AgentSetupManifest): void;\n}\n/**\n * agent 自己的沙箱运行时生命周期(每个 Attempt 一次,与「每轮 send」分开):\n * CLI 安装属于 runner 的 agent.ensure；`setup` 只写 model/base/auth 等本 Attempt 运行配置，`send` 只管把一轮 prompt\n * 跑起来(第一次 fresh / 后续 resume)+ 解析 transcript,`teardown` 清理。\n * 运行器在 layer prepare → agent.ensure → baseline 后、第一次 send 前调一次 `setup`,不返回值;\n * `teardown` 当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免——半初始化\n * 的现场同样要扫尾),在 finally 里跑。要把 `setup` 里创建的句柄传给 `teardown`,以\n * `sandbox` 实例为键存取(同一个 Agent 实例服务并发 attempt,不要用实例字段或模块变量)。\n */\nexport type AgentSetup = (sandbox: Sandbox, ctx: SandboxAgentSetupContext) => Promise<void> | void;\nexport type AgentTeardown = (sandbox: Sandbox, ctx: SandboxAgentContext) => Promise<void> | void;\nexport type DirectAgentSetup = (ctx: AgentContext) => Promise<void> | void;\nexport type DirectAgentTeardown = (ctx: AgentContext) => Promise<void> | void;\n/**\n * 本 agent 的原生 OTLP span → canonical GenAI semconv 的薄 mapper。\n * 由 adapter 声明(和 tracing.env 一样属于「连到谁」的特殊性),core 只调接口——\n * 省略时 core 走通用 heuristic 兜底,不按 agent 名字分支。\n */\nexport type SpanMapper = (spans: TraceSpan[]) => TraceSpan[];\ninterface AgentBase {\n    readonly name: string;\n    /** 该 Adapter 的常态证据覆盖声明；六通道必填。 */\n    readonly evidenceCoverage: EvidenceCoverage;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /**\n     * 可选 send 执行失败分类器:归类 adapter reject 的 `SendFailure`；可信的 failed Turn\n     * 是领域结果，不进入这条链。\n     * 返回 `undefined` 表示不认识、回落保守兜底。链上排在实验的 `classifyFailure` 之后,\n     * 实验作者认领过的失败问不到这里。分类器只声明决策轴与诊断词,不影响重试策略(次数、\n     * 退避对所有 agent 一致);抛错按 `undefined` 回落并被吞掉,不掩盖原始失败。形状与分类链、\n     * 执行体时序见 docs/feature/error-classification/architecture.md。\n     */\n    classifySendFailure?: SendFailureClassifier;\n}\n// ───────────────────────── Agent Ensure / Installer ─────────────────────────\n/**\n * Agent 安装身份:纯数据,进 configHash 与 `run.json`。\n * 与 sandbox case 身份正交——改 Agent 版本不重建任务 BuildKey。\n * 见 docs/feature/adapters/architecture/agent-ensure.md。\n */\nexport interface AgentIdentity {\n    /** Agent 名(与 adapter 显示名对齐,如 `codex`)。 */\n    readonly agent: string;\n    /** 精确版本;禁止 `latest` 等无钉死取值——无稳定身份不参与可携带结果。 */\n    readonly version: string;\n    /** 配方修订(内置用数字字符串,自定义可用任意稳定串)。 */\n    readonly revision: string;\n}\n/**\n * 三种安装模式,全部显式;失败后不允许在模式之间静默降级。\n * - `staged`:制品在题面网络外准备,经文件 API 送入(内置默认)。\n * - `sandbox-network`:显式声明用沙箱内网络安装。\n * - `verify-only`:只接受预装命中;探测失败立即 errored。\n */\nexport type AgentInstallMode = \"staged\" | \"sandbox-network\" | \"verify-only\";\n/** staged payload 的完成态目标平台；Linux 的 libc 是身份的一部分，不能留成缺值。 */\nexport type AgentArtifactPlatform = {\n    readonly _tag: \"Linux\";\n    readonly os: \"linux\";\n    readonly arch: string;\n    readonly libc: \"gnu\" | \"musl\";\n} | {\n    readonly _tag: \"Darwin\";\n    readonly os: \"darwin\";\n    readonly arch: string;\n} | {\n    readonly _tag: \"Windows\";\n    readonly os: \"windows\";\n    readonly arch: string;\n};\n/**\n * Run 级准备好的锁定制品。digest + 实际 platform 只属于运行 provenance，不进入\n * configHash 或 Eval fingerprint；静态 installer identity/revision 与 ProviderPlan target 才是配置身份。\n * 安装时经主 Sandbox 文件 API 上传,不依赖题面网络。\n */\nexport interface AgentStagedArtifact {\n    readonly platform: AgentArtifactPlatform;\n    /** digest-backed 不可变内容句柄；不向 Attempt 泄露宿主路径。 */\n    readonly content: RegisteredSandboxContent;\n    /** 沙箱内落点，位于 workdir 外的 Agent 自有目录。 */\n    readonly targetPath: string;\n    /** 安装协议必须显式，不从缺失字段推断历史默认。 */\n    readonly install: AgentArtifactInstallShape;\n}\nexport type AgentArtifactInstallShape = {\n    readonly kind: \"npm-tarball\";\n} | {\n    readonly kind: \"self-contained\";\n    readonly binPath: string;\n};\n/** `agent.ensure` 的取值:区分 probe 命中与本次安装。 */\nexport type AgentEnsureOutcome = \"hit\" | \"installed\";\n/**\n * Adapter 声明的纯 Ensure 义务：身份与只读 probe。probe 的非零退出是未命中，不是\n * Agent 任务失败；Runner 决定是否交给 identity 精确匹配的 installer。\n */\nexport interface AgentEnsure {\n    readonly identity: AgentIdentity;\n    readonly probe: StableSandboxCommand;\n    /** Human-only transient labels; omitted adapters do not add an ensure detail. */\n    readonly progress?: {\n        readonly checking?: string;\n        readonly ready?: string;\n    };\n}\nexport interface AgentInstallContext {\n    readonly identity: AgentIdentity;\n    readonly targetPlatform: AgentArtifactPlatform;\n    readonly signal: AbortSignal;\n    progress(update: ProgressUpdate): void;\n}\nexport interface AgentArtifactContext {\n    readonly targetPlatform: AgentArtifactPlatform;\n    readonly signal: AbortSignal;\n}\nexport interface StagedAgentInstallContext extends AgentInstallContext {\n    readonly artifact: AgentStagedArtifact;\n}\ninterface AgentInstallerBase {\n    /** 必须与某条 ensure identity 完全相同；Runner 不做近似匹配。 */\n    readonly identity: AgentIdentity;\n    /** 支持的目标平台键(`linux-x64-gnu` 等)；省略表示 installer 自己支持所有平台。 */\n    readonly platforms?: readonly string[];\n    /** Human-only transient label; omitted installers do not add an install detail. */\n    readonly progress?: {\n        readonly installing?: string;\n    };\n    /** @internal 只由内置 cache-safe staged installer 写入。 */\n    readonly [AGENT_DOCKERFILE_CACHE_SAFE]?: true;\n}\nexport type AgentInstaller = (AgentInstallerBase & {\n    readonly installMode: \"staged\";\n    prepareArtifact(context: AgentArtifactContext): MaybePromise<AgentStagedArtifact>;\n    install(sandbox: SandboxCommandTarget, context: StagedAgentInstallContext): MaybePromise<void>;\n}) | (AgentInstallerBase & {\n    readonly installMode: \"sandbox-network\";\n    readonly prepareArtifact?: never;\n    install(sandbox: SandboxCommandTarget, context: AgentInstallContext): MaybePromise<void>;\n}) | (AgentInstallerBase & {\n    readonly installMode: \"verify-only\";\n    readonly prepareArtifact?: never;\n    readonly install?: never;\n});\n/** 在 NiceEval 管理的 Sandbox 内驱动 CLI 的 Agent。 */\nexport interface SandboxAgent extends AgentBase {\n    readonly kind: \"sandbox\";\n    /** Runner 在 author layers 后、setup 前按声明顺序执行。 */\n    readonly ensure: readonly AgentEnsure[];\n    /** 官方或第三方随 adapter 提供的安装层；仅 identity 精确匹配时可接手。 */\n    readonly installers: readonly AgentInstaller[];\n    setup?: AgentSetup;\n    tracing?: AgentTracing;\n    send(input: TurnInput, ctx: SandboxAgentContext): Promise<Turn>;\n    teardown?: AgentTeardown;\n}\n/** 由 runner 直接调用函数、SDK 或服务端点的 Agent；目标进程可以在本地或远端。 */\nexport interface DirectAgent extends AgentBase {\n    readonly kind: \"direct\";\n    setup?: DirectAgentSetup;\n    tracing?: Omit<AgentTracing, \"configure\">;\n    send(input: TurnInput, ctx: AgentContext): Promise<Turn>;\n    teardown?: DirectAgentTeardown;\n}\n/** 注册表里的 Agent；判别值描述驱动拓扑，不描述目标所在位置。 */\nexport type Agent = SandboxAgent | DirectAgent;\n/** `defineSandboxAgent()` 的入参形状(见 src/define.ts)——`kind: \"sandbox\"` 由 define 固定填入,不由用户声明。 */\nexport interface SandboxAgentDef {\n    /** agent 的显示名/标识,原样进入 `Agent.name`——不是注册表查找 key,只用于展示、结果归属与去重指纹。 */\n    name: string;\n    /** 该 Adapter 的常态证据覆盖声明；完整采集可用 `completeEvidenceCoverage`。 */\n    evidenceCoverage: EvidenceCoverage;\n    /** 单条或数组都按声明顺序规范化为 Agent layer。 */\n    ensure: AgentEnsure | readonly AgentEnsure[];\n    /**\n     * 配对安装层；省略表示这个 adapter 只提供 probe 协议，未命中时 Runner 在\n     * `agent.ensure` 点名缺失的精确 identity。工厂会把省略规范化成空数组。\n     */\n    installers?: readonly AgentInstaller[];\n    /**\n     * 每条 Attempt 一次(不是每轮 send 一次):写 config.toml / 鉴权配置(model/base/auth 等\n     * 本 Attempt 内不变的运行配置)。CLI 的 probe、安装与复检属于 `agent.ensure`。运行器在 Sandbox\n     * 备好(layer prepare/ensure/baseline 之后)、第一次 send 前调用一次,不返回值。\n     */\n    setup?: AgentSetup;\n    /** OTLP 导出配置:Sandbox 里怎么让 CLI 把 trace 发到 endpoint(env / 配置文件),从 setup 拆出。 */\n    tracing?: AgentTracing;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /** 每轮一次:跑 prompt(fresh / resume)+ 解析成 events。 */\n    send(input: TurnInput, ctx: SandboxAgentContext): Promise<Turn>;\n    /** 可选 send 执行失败分类器:见 `Agent.classifySendFailure`。 */\n    classifySendFailure?: SendFailureClassifier;\n    /** Sandbox 销毁前的清理,当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免),\n     * 在 finally 里跑一次。 */\n    teardown?: AgentTeardown;\n}\n/** `defineAgent()` 的入参形状(见 src/define.ts)——`kind: \"direct\"` 由 define 固定填入,不由用户声明。 */\nexport interface DirectAgentDef {\n    /** agent 的显示名/标识,原样进入 `Agent.name`——不是注册表查找 key,只用于展示、结果归属与去重指纹。 */\n    name: string;\n    /** 该 Adapter 的常态证据覆盖声明；完整采集可用 `completeEvidenceCoverage`。 */\n    evidenceCoverage: EvidenceCoverage;\n    /**\n     * 每个 attempt 一次。Direct Agent 不接收 Sandbox；常用于建立连接、鉴权等一次性准备。\n     */\n    setup?: DirectAgentSetup;\n    /** OTLP 导出配置:被测对象怎么把 trace 发到 endpoint(env-based 注入)。 */\n    tracing?: Omit<AgentTracing, \"configure\">;\n    /** 原生 span → canonical 的薄 mapper;省略走通用 heuristic。只影响瀑布图。 */\n    spanMapper?: SpanMapper;\n    /** 每轮一次:把一轮 prompt 直接发给函数、SDK 或服务端点,解析响应成 events。 */\n    send(input: TurnInput, ctx: AgentContext): Promise<Turn>;\n    /** 可选 send 执行失败分类器:见 `Agent.classifySendFailure`。 */\n    classifySendFailure?: SendFailureClassifier;\n    /** 运行结束前的清理,当且仅当本 attempt 走到过 `setup` 时点才执行(`setup` 抛错不豁免),\n     * 在 finally 里跑一次。 */\n    teardown?: DirectAgentTeardown;\n}\n"]}

package/dist/agents/types.d.cts

@@ -148,13 +148,13 @@ export interface EvidenceCoverage {
     readonly events: EvidenceCoverageEntry;
     /** action 生命周期(工具正负断言、顺序、失败的依据)。 */
     readonly actions: EvidenceCoverageEntry;
-    /** assistant / user message(reply、messageIncludes 的依据)。 */
+    /** assistant / user message（reply 与显式 message 值断言的依据）。 */
     readonly messages: EvidenceCoverageEntry;
     /** usage(token / cost 上限断言的依据)。 */
     readonly usage: EvidenceCoverageEntry;
     /** Turn status 的真实性(succeeded / parked 的依据)——恒 completed 的映射必须声明非 complete。 */
     readonly status: EvidenceCoverageEntry;
-    /** Turn.data(outputEquals / outputMatches 的依据)。 */
+    /** Turn.data（供 `t.check(turn.data, match)` 检查结构化输出）。 */
     readonly data: EvidenceCoverageEntry;
 }
 /** 单轮只列相对 Agent 默认值的降级通道；省略的通道沿用 Agent 声明。 */
@@ -306,12 +306,12 @@ export interface AgentContext {
      */
     readonly experimentId?: string;
     /**
-     * 当前 Attempt 对应的 eval id。NiceEval runner 始终从 discovery 后的 Eval 身份填入；
+     * 当前 Attempt 对应的 eval ID。NiceEval Runner 始终从 discovery 后的评估用例身份填入；
      * 第三方直接构造 AgentContext 时可省略。Adapter 可用它定位与题目同目录的只读宿主资产，
      * 但不能据此绕过 Sandbox 的隐藏判据隔离。
      */
     readonly evalId?: string;
-    /** 当前 Attempt 的 Eval Group；未分组 Eval 省略。 */
+    /** 当前 Attempt 的评估组；未分组评估用例省略。 */
     readonly evalGroup?: {
         readonly id: string;
         readonly definitionHash: string;

package/dist/agents/types.d.mts

@@ -148,13 +148,13 @@ export interface EvidenceCoverage {
     readonly events: EvidenceCoverageEntry;
     /** action 生命周期(工具正负断言、顺序、失败的依据)。 */
     readonly actions: EvidenceCoverageEntry;
-    /** assistant / user message(reply、messageIncludes 的依据)。 */
+    /** assistant / user message（reply 与显式 message 值断言的依据）。 */
     readonly messages: EvidenceCoverageEntry;
     /** usage(token / cost 上限断言的依据)。 */
     readonly usage: EvidenceCoverageEntry;
     /** Turn status 的真实性(succeeded / parked 的依据)——恒 completed 的映射必须声明非 complete。 */
     readonly status: EvidenceCoverageEntry;
-    /** Turn.data(outputEquals / outputMatches 的依据)。 */
+    /** Turn.data（供 `t.check(turn.data, match)` 检查结构化输出）。 */
     readonly data: EvidenceCoverageEntry;
 }
 /** 单轮只列相对 Agent 默认值的降级通道；省略的通道沿用 Agent 声明。 */
@@ -306,12 +306,12 @@ export interface AgentContext {
      */
     readonly experimentId?: string;
     /**
-     * 当前 Attempt 对应的 eval id。NiceEval runner 始终从 discovery 后的 Eval 身份填入；
+     * 当前 Attempt 对应的 eval ID。NiceEval Runner 始终从 discovery 后的评估用例身份填入；
      * 第三方直接构造 AgentContext 时可省略。Adapter 可用它定位与题目同目录的只读宿主资产，
      * 但不能据此绕过 Sandbox 的隐藏判据隔离。
      */
     readonly evalId?: string;
-    /** 当前 Attempt 的 Eval Group；未分组 Eval 省略。 */
+    /** 当前 Attempt 的评估组；未分组评估用例省略。 */
     readonly evalGroup?: {
         readonly id: string;
         readonly definitionHash: string;

package/dist/agents/types.d.ts

@@ -148,13 +148,13 @@ export interface EvidenceCoverage {
     readonly events: EvidenceCoverageEntry;
     /** action 生命周期(工具正负断言、顺序、失败的依据)。 */
     readonly actions: EvidenceCoverageEntry;
-    /** assistant / user message(reply、messageIncludes 的依据)。 */
+    /** assistant / user message（reply 与显式 message 值断言的依据）。 */
     readonly messages: EvidenceCoverageEntry;
     /** usage(token / cost 上限断言的依据)。 */
     readonly usage: EvidenceCoverageEntry;
     /** Turn status 的真实性(succeeded / parked 的依据)——恒 completed 的映射必须声明非 complete。 */
     readonly status: EvidenceCoverageEntry;
-    /** Turn.data(outputEquals / outputMatches 的依据)。 */
+    /** Turn.data（供 `t.check(turn.data, match)` 检查结构化输出）。 */
     readonly data: EvidenceCoverageEntry;
 }
 /** 单轮只列相对 Agent 默认值的降级通道；省略的通道沿用 Agent 声明。 */
@@ -306,12 +306,12 @@ export interface AgentContext {
      */
     readonly experimentId?: string;
     /**
-     * 当前 Attempt 对应的 eval id。NiceEval runner 始终从 discovery 后的 Eval 身份填入；
+     * 当前 Attempt 对应的 eval ID。NiceEval Runner 始终从 discovery 后的评估用例身份填入；
      * 第三方直接构造 AgentContext 时可省略。Adapter 可用它定位与题目同目录的只读宿主资产，
      * 但不能据此绕过 Sandbox 的隐藏判据隔离。
      */
     readonly evalId?: string;
-    /** 当前 Attempt 的 Eval Group；未分组 Eval 省略。 */
+    /** 当前 Attempt 的评估组；未分组评估用例省略。 */
     readonly evalGroup?: {
         readonly id: string;
         readonly definitionHash: string;

package/dist/agents/ui-message-stream.cjs

@@ -68,7 +68,7 @@ function loadAiEffect() {
     })));
 }
 // ───────────────────────── SSE 解析 ─────────────────────────
-function drainSseEvents(buffer, controller, onChunk) {
+function drainSseEvents(buffer, controller, onChunk, onDone) {
     for (;;) {
         const sepIndex = buffer.indexOf("\n\n");
         if (sepIndex === -1)
@@ -79,8 +79,14 @@ function drainSseEvents(buffer, controller, onChunk) {
         if (!line)
             continue;
         const payload = line.slice("data: ".length);
-        if (payload === "[DONE]")
-            continue;
+        if (payload === "[DONE]") {
+            onDone();
+            // `[DONE]` is the protocol terminal, not an advisory event. Closing the
+            // reducer input here prevents frames later in the same network chunk (or
+            // later chunks) from manufacturing a successful Turn after termination.
+            controller.terminate();
+            return "";
+        }
         const chunk = JSON.parse(payload);
         onChunk(chunk);
         controller.enqueue(chunk);
@@ -91,17 +97,17 @@ function drainSseEvents(buffer, controller, onChunk) {
  * Scope finalization below aborts/cancels this pipeline, so an interrupted reducer cannot retain a
  * body reader or live HTTP transport.
  */
-function toChunkStream(body, onChunk) {
+function toChunkStream(body, onChunk, onDone) {
     const decoder = new TextDecoder();
     let buffer = "";
     return body.pipeThrough(new TransformStream({
         transform(value, controller) {
             buffer += decoder.decode(value, { stream: true });
-            buffer = drainSseEvents(buffer, controller, onChunk);
+            buffer = drainSseEvents(buffer, controller, onChunk, onDone);
         },
         flush(controller) {
             // Keep the original protocol rule: only a completed `\n\n` record is observable.
-            buffer = drainSseEvents(buffer, controller, onChunk);
+            buffer = drainSseEvents(buffer, controller, onChunk, onDone);
         },
     }));
 }
@@ -325,13 +331,24 @@ function uiMessageStreamSendEffect(options, input, ctx) {
                 cause: (0, external_cause_ts_1.normalizeExternalCause)({ status: res.status }),
             }));
         }
-        const streamState = { sawError: undefined };
+        const streamState = {
+            sawDone: false,
+            sawError: undefined,
+        };
         const chunkStream = toChunkStream(responseBody, (chunk) => {
             if (chunk.type === "error")
                 streamState.sawError = chunk.errorText;
+        }, () => {
+            streamState.sawDone = true;
         });
         yield* effect_1.Effect.addFinalizer(() => effect_1.Effect.sync(() => transport.abort()).pipe(effect_1.Effect.zipRight(cancelReadableStreamEffect(chunkStream))));
         const finalMessage = yield* reduceUiMessageStreamEffect(readUIMessageStream, prepared.resumeFrom, chunkStream, transport);
+        if (!streamState.sawDone) {
+            return yield* effect_1.Effect.fail((0, send_failures_ts_1.makeSendFailure)({
+                acceptance: "unknown",
+                message: `POST ${url} ended before the UI Message Stream [DONE] marker. The response was truncated or the endpoint does not speak the complete UI Message Stream protocol.`,
+            }));
+        }
         if (!finalMessage) {
             return yield* effect_1.Effect.fail((0, send_failures_ts_1.makeSendFailure)({
                 acceptance: "unknown",

package/dist/agents/ui-message-stream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ui-message-stream.js","sourceRoot":"","sources":["ui-message-stream.ts"],"names":[],"mappings":"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","sourcesContent":["// uiMessageStreamAgent():AI SDK UI Message Stream Protocol 的无侵入 HTTP adapter 工厂。\n//\n// 协议:https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol —— `useChat` 后端的标准 SSE\n// (`data: {UIMessageChunk}\\n\\n`,以 `data: [DONE]\\n\\n` 收尾)。这是「对着一个已部署的\n// AI SDK 应用的 HTTP 接口无侵入接入」:adapter 只 fetch,不 import 被测应用的任何代码。\n//\n//   · 会话:协议是服务端零状态、「客户端带全量历史」——工厂用 typed slot 存整份\n//     UIMessage[],每轮原样重放;ctx.session.id 未记录时开新 chat id 并 capture 回写。\n//   · 事件流:从归约后的 assistant 消息 parts 直构(text → message,tool part 的\n//     approval-requested → operation.started,output-available / output-error / 审批拒绝\n//     → operation.finished),\n//     不要求应用接 OTel;跨 resume 轮次按 callId / 已报文本长度去重。\n//   · HITL:v7 tool approval(`needsApproval` 工具)——part 停在 `approval-requested` 时\n//     整轮 `waiting` + `input.requested`;下一轮输入(approve / yes / 同意 / 批准 开头 =\n//     批准,其余拒绝)翻译成 `approval-responded` 原地改写该 part、原样重发 messages 触发\n//     服务端续跑 —— 和真实前端 `addToolApprovalResponse()` + `sendMessage()` 的协议行为\n//     完全一致,没有单独的 approve 端点。拒绝的调用协议里不会有任何 tool-output 帧\n//     (从没真正执行),由工厂合成 `status: \"rejected\"` 的 operation.finished。\n//   · chunk 归约用 `ai` 包官方导出的框架无关 reducer `readUIMessageStream`(`useChat`\n//     内部同款),保证重放回服务端的 UIMessage 形状协议正确 —— `ai` 是可选 peer 依赖,\n//     只在用到本工厂时需要安装。\n//\n// tracing / spanMapper 原样透传:应用有 OTel 时接上拿瀑布图(span 只进瀑布图,不喂断言),\n// 事件流始终从协议帧直构。\nimport { randomUUID } from \"node:crypto\";\nimport { Effect } from \"effect\";\nimport { defineAgent } from \"../define.ts\";\nimport { makeSendFailure } from \"../context/send-failures.ts\";\nimport { normalizeExternalCause } from \"../shared/external-cause.ts\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport type { Agent, AgentContext, AgentTracing, CommandProjection, EvidenceCoverage, InputResponse, JsonValue, SpanMapper, StreamEvent, TurnInput } from \"../types.ts\";\nimport { createSessionSlot } from \"./session-slot.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\n// UI Message Stream 帧里没有 usage(协议本身不带 token 计数,见 docs/engineering/testing/e2e/README.md\n// 第 2 节);events/actions/messages/status 都直接来自完整归约的协议帧,和 turnFromAiSdk/aiSdkAgent\n// 同等完整——官方 SDK 适配器应声明全通道 complete(docs/feature/adapters/architecture/evidence.md),\n// 这里唯一的例外是协议本身没有的 usage 通道,如实标 unavailable 而不是留成 unknown。\nconst COVERAGE: EvidenceCoverage = Object.freeze({\n    ...completeEvidenceCoverage,\n    usage: { status: \"unavailable\" as const, reason: \"UI Message Stream frames carry no token usage\" },\n});\n// ───────────────────────── 协议的结构化类型(structural,不依赖 ai 包的类型) ─────────────────────────\n/** UIMessage 的最小结构面:只声明工厂真正要读的字段,其余原样透传。 */\nexport interface UIMessageLike {\n    id: string;\n    role: string;\n    parts: UIMessagePartLike[];\n    [key: string]: JsonValue | UIMessagePartLike[] | undefined;\n}\nexport interface UIMessagePartLike {\n    type: string;\n    state?: string;\n    text?: string;\n    toolCallId?: string;\n    toolName?: string;\n    input?: JsonValue;\n    output?: JsonValue;\n    errorText?: string;\n    approval?: {\n        id: string;\n        approved?: boolean;\n        reason?: string;\n    };\n    [key: string]: JsonValue | undefined;\n}\ninterface UIMessageChunkLike {\n    type: string;\n    errorText?: string;\n    [key: string]: JsonValue | undefined;\n}\ninterface UiMessageSessionState {\n    chatId?: string;\n    reported?: ReportedState;\n}\nconst historySlot = createSessionSlot<UIMessageLike[]>(\"ui-message-stream/history\");\nconst sessionStateSlot = createSessionSlot<UiMessageSessionState>(\"ui-message-stream/state\");\ntype ReadUIMessageStream = (options: {\n    message?: UIMessageLike;\n    stream: ReadableStream<UIMessageChunkLike>;\n}) => AsyncIterable<UIMessageLike>;\n// ai 是可选 peer 依赖:动态 import,缺了就把「装什么」直接说清楚。\n// 说明符经变量传入,避免 TS 对字面量模块名做安装检查(niceeval 自身不依赖 ai)。\nlet aiModule: Promise<{\n    readUIMessageStream: ReadUIMessageStream;\n}> | undefined;\nfunction missingAiModule(): Error {\n    return new Error(\"uiMessageStreamAgent 需要 `ai` 包(AI SDK v5+,协议 reducer readUIMessageStream 来自它)。在你的 eval 项目里安装:npm install -D ai\");\n}\n/** Dynamic import is an SDK Promise boundary; a rejected load is never cached. */\nfunction loadAiEffect(): Effect.Effect<{\n    readUIMessageStream: ReadUIMessageStream;\n}, Error> {\n    const pending = aiModule;\n    return Effect.tryPromise({\n        try: () => {\n            if (pending !== undefined)\n                return pending;\n            const specifier = \"ai\";\n            const loading = __niceevalDynamicImport(specifier) as Promise<{\n                readUIMessageStream: ReadUIMessageStream;\n            }>;\n            aiModule = loading;\n            return loading;\n        },\n        catch: () => missingAiModule(),\n    }).pipe(Effect.tapError(() => Effect.sync(() => {\n        aiModule = undefined;\n    })));\n}\n// ───────────────────────── SSE 解析 ─────────────────────────\nfunction drainSseEvents(buffer: string, controller: TransformStreamDefaultController<UIMessageChunkLike>, onChunk: (chunk: UIMessageChunkLike) => void): string {\n    for (;;) {\n        const sepIndex = buffer.indexOf(\"\\n\\n\");\n        if (sepIndex === -1)\n            return buffer;\n        const rawEvent = buffer.slice(0, sepIndex);\n        buffer = buffer.slice(sepIndex + 2);\n        const line = rawEvent.split(\"\\n\").find((candidate) => candidate.startsWith(\"data: \"));\n        if (!line)\n            continue;\n        const payload = line.slice(\"data: \".length);\n        if (payload === \"[DONE]\")\n            continue;\n        const chunk = JSON.parse(payload) as UIMessageChunkLike;\n        onChunk(chunk);\n        controller.enqueue(chunk);\n    }\n}\n/**\n * Build the AI SDK reducer input with native stream composition rather than a hand-owned reader.\n * Scope finalization below aborts/cancels this pipeline, so an interrupted reducer cannot retain a\n * body reader or live HTTP transport.\n */\nfunction toChunkStream(body: ReadableStream<Uint8Array>, onChunk: (c: UIMessageChunkLike) => void): ReadableStream<UIMessageChunkLike> {\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n    return body.pipeThrough(new TransformStream<Uint8Array, UIMessageChunkLike>({\n        transform(value, controller) {\n            buffer += decoder.decode(value, { stream: true });\n            buffer = drainSseEvents(buffer, controller, onChunk);\n        },\n        flush(controller) {\n            // Keep the original protocol rule: only a completed `\\n\\n` record is observable.\n            buffer = drainSseEvents(buffer, controller, onChunk);\n        },\n    }));\n}\n// ───────────────────────── parts → 事件 ─────────────────────────\nfunction isToolPart(part: UIMessagePartLike): boolean {\n    return part.type === \"dynamic-tool\" || part.type.startsWith(\"tool-\");\n}\nfunction toolNameOf(part: UIMessagePartLike): string {\n    if (part.type === \"dynamic-tool\")\n        return part.toolName ?? \"dynamic-tool\";\n    return part.type.slice(\"tool-\".length);\n}\nfunction isApprovalRequested(part: UIMessagePartLike): boolean {\n    return isToolPart(part) && part.state === \"approval-requested\";\n}\n/** 和 aiSdkAgent 同一词法(t.respond 的自由文本回答):approve / yes / 同意 / 批准 开头 = 批准。 */\nfunction isApproved(text: string): boolean {\n    return /^(approve|yes|同意|批准)/i.test(text.trim());\n}\n/** 按 requestId 从 input.responses 对位取裁决;optionId 优先,自由文本走 isApproved,没答到直接报错。 */\nfunction approvalDecision(responses: readonly InputResponse[] | undefined, requestId: string | undefined): boolean {\n    const matched = responses?.find((r) => r.requestId === requestId);\n    if (!matched) {\n        throw new Error(`No response for pending approval \"${requestId ?? \"unknown\"}\". Answer approval requests with t.respond(...).`);\n    }\n    if (matched.optionId !== undefined)\n        return matched.optionId === \"approve\";\n    return isApproved(matched.text ?? \"\");\n}\n/** 已报告的进度:resume 续跑的是同一条 assistant 消息,跨轮去重靠它。 */\ninterface ReportedState {\n    startedCalls: Set<string>;\n    finishedCalls: Set<string>;\n    textLen: number;\n}\n/**\n * 从归约后的最终消息派生本轮事件。工具事件按 part 顺序;文本合并成一条 message 事件\n * (resume 轮只报新增的后缀)。停在 approval-requested 的调用先报 started,\n * 因此它在审批轮是 pending;裁决后的续跑轮只补 finished,落成 completed 或 rejected。\n */\nfunction deriveTurnEvents(message: UIMessageLike, reported: ReportedState, projectToolCommand: UiMessageStreamAgentOptions[\"projectToolCommand\"]): StreamEvent[] {\n    const events: StreamEvent[] = [];\n    let fullText = \"\";\n    for (const part of message.parts) {\n        if (part.type === \"text\") {\n            fullText += part.text ?? \"\";\n            continue;\n        }\n        if (!isToolPart(part))\n            continue;\n        const callId = part.toolCallId ?? \"\";\n        if (!callId || reported.finishedCalls.has(callId))\n            continue;\n        const name = toolNameOf(part);\n        const input = (part.input ?? null) as JsonValue;\n        const start = () => {\n            if (reported.startedCalls.has(callId))\n                return;\n            const command = projectToolCommand?.({ name, input });\n            events.push({\n                type: \"operation.started\",\n                operationId: callId,\n                operation: {\n                    kind: \"tool\",\n                    name,\n                    input,\n                    ...(command === undefined ? {} : { command }),\n                },\n            });\n            reported.startedCalls.add(callId);\n        };\n        if (part.state === \"output-available\") {\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", output: part.output as JsonValue, status: \"completed\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"output-error\") {\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", output: part.errorText, status: \"failed\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"output-denied\" ||\n            (part.state === \"approval-responded\" && part.approval?.approved === false)) {\n            // 拒绝的调用从没真正执行,协议里不会再有它的任何帧 —— 在裁决落地的这一轮合成。\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", status: \"rejected\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"approval-requested\") {\n            start();\n        }\n        // input-* 中间态还没有可信的完整入参,等 approval-requested 或终态再报。\n    }\n    const newText = fullText.slice(reported.textLen);\n    if (newText.trim())\n        events.push({ type: \"message\", role: \"assistant\", text: newText });\n    reported.textLen = fullText.length;\n    return events;\n}\n// ───────────────────────── 工厂 ─────────────────────────\nexport interface UiMessageStreamAgentOptions {\n    /** agent 名(报告 / 结果聚合的身份)。默认 \"ui-message-stream\"。 */\n    name?: string;\n    /** 被测应用的 chat 端点(完整 URL,应用在哪部署就指哪);函数形式每轮解析。 */\n    url: string | ((ctx: AgentContext) => string | Promise<string>);\n    /** 附加请求头(鉴权等);`ctx.telemetry.headers`(traceparent)总会自动并入。 */\n    headers?: globalThis.Record<string, string> | ((ctx: AgentContext) => globalThis.Record<string, string>);\n    /** 除 `messages` 外并入请求体的字段,如 `(ctx) => ({ model: ctx.model })`(undefined 字段序列化时自动丢弃)。 */\n    body?: (ctx: AgentContext) => globalThis.Record<string, JsonValue | undefined>;\n    /**\n     * 由 endpoint owner 逐笔把逻辑工具调用分类为 command 或 not-command。\n     * 未知调用返回 undefined 并保持 actions coverage partial；NiceEval 不按名称或 input 猜测。\n     */\n    projectToolCommand?: (tool: Readonly<{\n        name: string;\n        input: JsonValue;\n    }>) => CommandProjection | undefined;\n    /**\n     * 拒绝审批时随 `approval-responded` 带出的理由。应用/SDK 会把它作为模型看到的工具结果\n     * 文本 —— 写清楚「不要重试」能明显降低模型原样重发同一调用的概率(实测)。\n     */\n    denyReason?: string;\n    /** 流结束后再等这么久才返回(毫秒),给应用侧的观测导出(如 BatchSpanProcessor)留时间。 */\n    settleMs?: number;\n    /** 应用有 OTel 时的端点投递方式(拿瀑布图);事件流不依赖它。 */\n    tracing?: AgentTracing;\n    /** 应用有 OTel 时的 span 归一函数(拿瀑布图);事件流不依赖它。 */\n    spanMapper?: SpanMapper;\n}\nconst DEFAULT_DENY_REASON = \"用户拒绝了这次调用,不要重试,直接告知用户操作未执行。\";\ninterface PreparedUiMessageStreamSend {\n    readonly bookkeeping: UiMessageSessionState;\n    readonly messagesToSend: UIMessageLike[];\n    readonly resumeFrom: UIMessageLike | undefined;\n}\n/** External SDK / transport Promise boundary. */\nfunction promiseEffect<Value>(run: (signal: AbortSignal) => PromiseLike<Value>): Effect.Effect<Value, unknown> {\n    return Effect.tryPromise({ try: run, catch: (cause) => cause });\n}\nfunction resolveUrlEffect(options: UiMessageStreamAgentOptions, ctx: AgentContext): Effect.Effect<string, unknown> {\n    const url = options.url;\n    return typeof url === \"function\"\n        ? promiseEffect(() => Promise.resolve(url(ctx)))\n        : Effect.succeed(url);\n}\nfunction resolveHeadersEffect(options: UiMessageStreamAgentOptions, ctx: AgentContext): Effect.Effect<globalThis.Record<string, string>, unknown> {\n    return Effect.try({\n        try: () => typeof options.headers === \"function\" ? options.headers(ctx) : (options.headers ?? {}),\n        catch: (cause) => cause,\n    });\n}\nfunction transportController() {\n    return Effect.acquireRelease(Effect.sync(() => new AbortController()), (controller) => Effect.sync(() => controller.abort()));\n}\nfunction cancelReadableStreamEffect<Value>(stream: ReadableStream<Value>): Effect.Effect<void> {\n    return promiseEffect(() => stream.cancel()).pipe(Effect.catchAll(() => Effect.void), Effect.asVoid);\n}\nfunction prepareMessages(options: UiMessageStreamAgentOptions, input: TurnInput, ctx: AgentContext): PreparedUiMessageStreamSend {\n    // 会话续接是「客户端带全量历史」模式:历史与协议簿记各用一个 typed slot,\n    // 新线自然两者都为空；相同名字不会让其它 Adapter 的 slot 与它们碰撞。\n    const priorMessages = ctx.session.get(historySlot) ?? [];\n    const bookkeeping = ctx.session.get(sessionStateSlot) ?? {};\n    ctx.session.set(sessionStateSlot, bookkeeping);\n    let id = bookkeeping.chatId;\n    if (!id) {\n        id = `uims-${randomUUID()}`;\n        bookkeeping.chatId = id;\n        ctx.session.capture(id); // 镜像:t.sessionId / 报告可见\n    }\n    const lastMessage = priorMessages.at(-1);\n    const pendingPart = lastMessage?.role === \"assistant\" ? lastMessage.parts.find(isApprovalRequested) : undefined;\n    if (pendingPart && lastMessage) {\n        // HITL 续跑:不追加新 user 消息 —— 把停在 approval-requested 的 part 原地改成\n        // approval-responded,原样重发,服务端续跑同一条被打断的 assistant 消息。\n        // 裁决按 requestId 从 input.responses 对位读取(t.respond 的结构化回答)。\n        const requestId = pendingPart.approval?.id ?? pendingPart.toolCallId;\n        const approved = approvalDecision(input.responses, requestId);\n        const mutatedParts = lastMessage.parts.map((part) => isApprovalRequested(part) && part.approval?.id === pendingPart.approval?.id\n            ? {\n                ...part,\n                state: \"approval-responded\",\n                approval: {\n                    id: pendingPart.approval!.id,\n                    approved,\n                    ...(approved ? {} : { reason: options.denyReason ?? DEFAULT_DENY_REASON }),\n                },\n            }\n            : part);\n        const resumeFrom = { ...lastMessage, parts: mutatedParts };\n        return {\n            bookkeeping,\n            resumeFrom,\n            messagesToSend: [...priorMessages.slice(0, -1), resumeFrom],\n        };\n    }\n    const parts: UIMessagePartLike[] = [{ type: \"text\", text: input.text }];\n    for (const file of input.files ?? []) {\n        parts.push({ type: \"file\", mediaType: file.mimeType, url: `data:${file.mimeType};base64,${file.dataBase64}` });\n    }\n    return {\n        bookkeeping,\n        resumeFrom: undefined,\n        messagesToSend: [...priorMessages, { id: randomUUID(), role: \"user\", parts }],\n    };\n}\n/** Consume the SDK's native async iterator only inside its named Effect Promise boundary. */\nfunction reduceUiMessageStreamEffect(readUIMessageStream: ReadUIMessageStream, resumeFrom: UIMessageLike | undefined, stream: ReadableStream<UIMessageChunkLike>, transport: AbortController): Effect.Effect<UIMessageLike | undefined, unknown> {\n    return promiseEffect(async (signal) => {\n        const onAbort = () => transport.abort(signal.reason);\n        signal.addEventListener(\"abort\", onAbort, { once: true });\n        if (signal.aborted)\n            onAbort();\n        try {\n            let finalMessage: UIMessageLike | undefined;\n            for await (const message of readUIMessageStream({ message: resumeFrom, stream })) {\n                finalMessage = message;\n            }\n            return finalMessage;\n        }\n        finally {\n            signal.removeEventListener(\"abort\", onAbort);\n        }\n    });\n}\nfunction uiMessageStreamSendEffect(options: UiMessageStreamAgentOptions, input: TurnInput, ctx: AgentContext): Effect.Effect<import(\"../types.ts\").Turn, unknown> {\n    return Effect.scoped(Effect.gen(function* () {\n        const { readUIMessageStream } = yield* loadAiEffect();\n        const prepared = yield* Effect.try({\n            try: () => prepareMessages(options, input, ctx),\n            catch: (cause) => cause,\n        });\n        const url = yield* resolveUrlEffect(options, ctx);\n        const extraHeaders = yield* resolveHeadersEffect(options, ctx);\n        const transport = yield* transportController();\n        const res = yield* Effect.tryPromise({\n            try: (signal) => fetch(url, {\n                method: \"POST\",\n                // traceparent 随请求带过去:应用埋点支持 context 传播时,span 归属精确到本轮。\n                headers: { \"content-type\": \"application/json\", ...extraHeaders, ...ctx.telemetry?.headers },\n                body: JSON.stringify({ ...options.body?.(ctx), messages: prepared.messagesToSend }),\n                signal: AbortSignal.any([ctx.signal, signal, transport.signal]),\n            }),\n            catch: (err) => {\n                if (ctx.signal.aborted)\n                    return err;\n                const cause = err instanceof Error\n                    ? (err.cause instanceof Error ? err.cause.message : err.message)\n                    : String(err);\n                return makeSendFailure({\n                    acceptance: \"unknown\",\n                    message: `Could not connect to ${url} (${cause}). Is the app under test running? Start it yourself first, or point url at a deployed instance via config.`,\n                    cause: normalizeExternalCause(err),\n                });\n            },\n        });\n        const responseBody = res.body;\n        if (!res.ok || !responseBody) {\n            const responseText = yield* promiseEffect(() => res.text()).pipe(Effect.catchAll(() => Effect.succeed(\"\")));\n            return yield* Effect.fail(makeSendFailure({\n                acceptance: \"unknown\",\n                message: `POST ${url} failed: ${res.status} ${responseText}. Confirm the app is running and the endpoint speaks the UI Message Stream protocol (the backend useChat expects).`,\n                cause: normalizeExternalCause({ status: res.status }),\n            }));\n        }\n        const streamState: {\n            sawError: string | undefined;\n        } = { sawError: undefined };\n        const chunkStream = toChunkStream(responseBody, (chunk) => {\n            if (chunk.type === \"error\")\n                streamState.sawError = chunk.errorText;\n        });\n        yield* Effect.addFinalizer(() => Effect.sync(() => transport.abort()).pipe(Effect.zipRight(cancelReadableStreamEffect(chunkStream))));\n        const finalMessage = yield* reduceUiMessageStreamEffect(readUIMessageStream, prepared.resumeFrom, chunkStream, transport);\n        if (!finalMessage) {\n            return yield* Effect.fail(makeSendFailure({\n                acceptance: \"unknown\",\n                message: `POST ${url} 的流结束了但一条 assistant 消息都没归约出来 —— 端点吐的不是 UI Message Stream 帧?`,\n            }));\n        }\n        const derived = yield* Effect.try({\n            try: () => {\n                // 续跑轮:finalMessage 是同一条消息的完整版,替换末尾半成品;全新轮:追加。\n                ctx.session.set(historySlot, prepared.resumeFrom\n                    ? [...prepared.messagesToSend.slice(0, -1), finalMessage]\n                    : [...prepared.messagesToSend, finalMessage]);\n                const reported: ReportedState = prepared.resumeFrom && prepared.bookkeeping.reported\n                    ? prepared.bookkeeping.reported\n                    : { startedCalls: new Set(), finishedCalls: new Set(), textLen: 0 };\n                prepared.bookkeeping.reported = reported;\n                return {\n                    events: deriveTurnEvents(finalMessage, reported, options.projectToolCommand),\n                    request: finalMessage.parts.find(isApprovalRequested),\n                };\n            },\n            catch: (cause) => cause,\n        });\n        const request = derived.request;\n        if (request) {\n            return yield* Effect.try({\n                try: () => {\n                    const waitingEvents = [\n                        ...derived.events,\n                        {\n                            type: \"input.requested\" as const,\n                            request: {\n                                id: request.approval?.id ?? request.toolCallId,\n                                action: toolNameOf(request),\n                                input: (request.input ?? null) as JsonValue,\n                                options: [{ id: \"approve\" }, { id: \"deny\" }],\n                            },\n                        },\n                    ];\n                    const evidenceCoverage = unclassifiedToolActionsCoverage(waitingEvents);\n                    return {\n                        status: \"waiting\" as const,\n                        events: waitingEvents,\n                        ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),\n                    };\n                },\n                catch: (cause) => cause,\n            });\n        }\n        if (options.settleMs)\n            yield* Effect.sleep(options.settleMs);\n        return yield* Effect.try({\n            try: () => {\n                const finalEvents = [\n                    ...derived.events,\n                    ...(streamState.sawError ? [{ type: \"error\" as const, message: streamState.sawError }] : []),\n                ];\n                const evidenceCoverage = unclassifiedToolActionsCoverage(finalEvents);\n                return {\n                    status: streamState.sawError ? (\"failed\" as const) : (\"completed\" as const),\n                    events: finalEvents,\n                    ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),\n                };\n            },\n            catch: (cause) => cause,\n        });\n    }));\n}\n/**\n * UI Message Stream Protocol(AI SDK `useChat` 后端的标准 SSE 协议)的内置无侵入 adapter。\n * 对着已部署应用的 HTTP 端点收发,不 import 应用代码:\n *\n * ```typescript\n * import { uiMessageStreamAgent } from \"niceeval/adapter\";\n *\n * export default uiMessageStreamAgent({\n *   name: \"my-assistant\",\n *   url: \"https://my-app.example.com/api/chat\",\n *   body: (ctx) => ({ model: ctx.model }),   // 应用支持请求级选模型时,模型对比零改动\n * });\n * ```\n */\nexport function uiMessageStreamAgent(options: UiMessageStreamAgentOptions): Agent {\n    return defineAgent({\n        name: options.name ?? \"ui-message-stream\",\n        evidenceCoverage: COVERAGE,\n        tracing: options.tracing,\n        spanMapper: options.spanMapper,\n        send: (input, ctx) => Effect.runPromise(uiMessageStreamSendEffect(options, input, ctx), { signal: ctx.signal }),\n    });\n}\n"]}
+{"version":3,"file":"ui-message-stream.js","sourceRoot":"","sources":["ui-message-stream.ts"],"names":[],"mappings":"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","sourcesContent":["// uiMessageStreamAgent():AI SDK UI Message Stream Protocol 的无侵入 HTTP adapter 工厂。\n//\n// 协议:https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol —— `useChat` 后端的标准 SSE\n// (`data: {UIMessageChunk}\\n\\n`,以 `data: [DONE]\\n\\n` 收尾)。这是「对着一个已部署的\n// AI SDK 应用的 HTTP 接口无侵入接入」:adapter 只 fetch,不 import 被测应用的任何代码。\n//\n//   · 会话:协议是服务端零状态、「客户端带全量历史」——工厂用 typed slot 存整份\n//     UIMessage[],每轮原样重放;ctx.session.id 未记录时开新 chat id 并 capture 回写。\n//   · 事件流:从归约后的 assistant 消息 parts 直构(text → message,tool part 的\n//     approval-requested → operation.started,output-available / output-error / 审批拒绝\n//     → operation.finished),\n//     不要求应用接 OTel;跨 resume 轮次按 callId / 已报文本长度去重。\n//   · HITL:v7 tool approval(`needsApproval` 工具)——part 停在 `approval-requested` 时\n//     整轮 `waiting` + `input.requested`;下一轮输入(approve / yes / 同意 / 批准 开头 =\n//     批准,其余拒绝)翻译成 `approval-responded` 原地改写该 part、原样重发 messages 触发\n//     服务端续跑 —— 和真实前端 `addToolApprovalResponse()` + `sendMessage()` 的协议行为\n//     完全一致,没有单独的 approve 端点。拒绝的调用协议里不会有任何 tool-output 帧\n//     (从没真正执行),由工厂合成 `status: \"rejected\"` 的 operation.finished。\n//   · chunk 归约用 `ai` 包官方导出的框架无关 reducer `readUIMessageStream`(`useChat`\n//     内部同款),保证重放回服务端的 UIMessage 形状协议正确 —— `ai` 是可选 peer 依赖,\n//     只在用到本工厂时需要安装。\n//\n// tracing / spanMapper 原样透传:应用有 OTel 时接上拿瀑布图(span 只进瀑布图,不喂断言),\n// 事件流始终从协议帧直构。\nimport { randomUUID } from \"node:crypto\";\nimport { Effect } from \"effect\";\nimport { defineAgent } from \"../define.ts\";\nimport { makeSendFailure } from \"../context/send-failures.ts\";\nimport { normalizeExternalCause } from \"../shared/external-cause.ts\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport type { Agent, AgentContext, AgentTracing, CommandProjection, EvidenceCoverage, InputResponse, JsonValue, SpanMapper, StreamEvent, TurnInput } from \"../types.ts\";\nimport { createSessionSlot } from \"./session-slot.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\n// UI Message Stream 帧里没有 usage(协议本身不带 token 计数,见 docs/engineering/testing/e2e/README.md\n// 第 2 节);events/actions/messages/status 都直接来自完整归约的协议帧,和 turnFromAiSdk/aiSdkAgent\n// 同等完整——官方 SDK 适配器应声明全通道 complete(docs/feature/adapters/architecture/evidence.md),\n// 这里唯一的例外是协议本身没有的 usage 通道,如实标 unavailable 而不是留成 unknown。\nconst COVERAGE: EvidenceCoverage = Object.freeze({\n    ...completeEvidenceCoverage,\n    usage: { status: \"unavailable\" as const, reason: \"UI Message Stream frames carry no token usage\" },\n});\n// ───────────────────────── 协议的结构化类型(structural,不依赖 ai 包的类型) ─────────────────────────\n/** UIMessage 的最小结构面:只声明工厂真正要读的字段,其余原样透传。 */\nexport interface UIMessageLike {\n    id: string;\n    role: string;\n    parts: UIMessagePartLike[];\n    [key: string]: JsonValue | UIMessagePartLike[] | undefined;\n}\nexport interface UIMessagePartLike {\n    type: string;\n    state?: string;\n    text?: string;\n    toolCallId?: string;\n    toolName?: string;\n    input?: JsonValue;\n    output?: JsonValue;\n    errorText?: string;\n    approval?: {\n        id: string;\n        approved?: boolean;\n        reason?: string;\n    };\n    [key: string]: JsonValue | undefined;\n}\ninterface UIMessageChunkLike {\n    type: string;\n    errorText?: string;\n    [key: string]: JsonValue | undefined;\n}\ninterface UiMessageSessionState {\n    chatId?: string;\n    reported?: ReportedState;\n}\nconst historySlot = createSessionSlot<UIMessageLike[]>(\"ui-message-stream/history\");\nconst sessionStateSlot = createSessionSlot<UiMessageSessionState>(\"ui-message-stream/state\");\ntype ReadUIMessageStream = (options: {\n    message?: UIMessageLike;\n    stream: ReadableStream<UIMessageChunkLike>;\n}) => AsyncIterable<UIMessageLike>;\n// ai 是可选 peer 依赖:动态 import,缺了就把「装什么」直接说清楚。\n// 说明符经变量传入,避免 TS 对字面量模块名做安装检查(niceeval 自身不依赖 ai)。\nlet aiModule: Promise<{\n    readUIMessageStream: ReadUIMessageStream;\n}> | undefined;\nfunction missingAiModule(): Error {\n    return new Error(\"uiMessageStreamAgent 需要 `ai` 包(AI SDK v5+,协议 reducer readUIMessageStream 来自它)。在你的 eval 项目里安装:npm install -D ai\");\n}\n/** Dynamic import is an SDK Promise boundary; a rejected load is never cached. */\nfunction loadAiEffect(): Effect.Effect<{\n    readUIMessageStream: ReadUIMessageStream;\n}, Error> {\n    const pending = aiModule;\n    return Effect.tryPromise({\n        try: () => {\n            if (pending !== undefined)\n                return pending;\n            const specifier = \"ai\";\n            const loading = __niceevalDynamicImport(specifier) as Promise<{\n                readUIMessageStream: ReadUIMessageStream;\n            }>;\n            aiModule = loading;\n            return loading;\n        },\n        catch: () => missingAiModule(),\n    }).pipe(Effect.tapError(() => Effect.sync(() => {\n        aiModule = undefined;\n    })));\n}\n// ───────────────────────── SSE 解析 ─────────────────────────\nfunction drainSseEvents(buffer: string, controller: TransformStreamDefaultController<UIMessageChunkLike>, onChunk: (chunk: UIMessageChunkLike) => void, onDone: () => void): string {\n    for (;;) {\n        const sepIndex = buffer.indexOf(\"\\n\\n\");\n        if (sepIndex === -1)\n            return buffer;\n        const rawEvent = buffer.slice(0, sepIndex);\n        buffer = buffer.slice(sepIndex + 2);\n        const line = rawEvent.split(\"\\n\").find((candidate) => candidate.startsWith(\"data: \"));\n        if (!line)\n            continue;\n        const payload = line.slice(\"data: \".length);\n        if (payload === \"[DONE]\") {\n            onDone();\n            // `[DONE]` is the protocol terminal, not an advisory event. Closing the\n            // reducer input here prevents frames later in the same network chunk (or\n            // later chunks) from manufacturing a successful Turn after termination.\n            controller.terminate();\n            return \"\";\n        }\n        const chunk = JSON.parse(payload) as UIMessageChunkLike;\n        onChunk(chunk);\n        controller.enqueue(chunk);\n    }\n}\n/**\n * Build the AI SDK reducer input with native stream composition rather than a hand-owned reader.\n * Scope finalization below aborts/cancels this pipeline, so an interrupted reducer cannot retain a\n * body reader or live HTTP transport.\n */\nfunction toChunkStream(body: ReadableStream<Uint8Array>, onChunk: (c: UIMessageChunkLike) => void, onDone: () => void): ReadableStream<UIMessageChunkLike> {\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n    return body.pipeThrough(new TransformStream<Uint8Array, UIMessageChunkLike>({\n        transform(value, controller) {\n            buffer += decoder.decode(value, { stream: true });\n            buffer = drainSseEvents(buffer, controller, onChunk, onDone);\n        },\n        flush(controller) {\n            // Keep the original protocol rule: only a completed `\\n\\n` record is observable.\n            buffer = drainSseEvents(buffer, controller, onChunk, onDone);\n        },\n    }));\n}\n// ───────────────────────── parts → 事件 ─────────────────────────\nfunction isToolPart(part: UIMessagePartLike): boolean {\n    return part.type === \"dynamic-tool\" || part.type.startsWith(\"tool-\");\n}\nfunction toolNameOf(part: UIMessagePartLike): string {\n    if (part.type === \"dynamic-tool\")\n        return part.toolName ?? \"dynamic-tool\";\n    return part.type.slice(\"tool-\".length);\n}\nfunction isApprovalRequested(part: UIMessagePartLike): boolean {\n    return isToolPart(part) && part.state === \"approval-requested\";\n}\n/** 和 aiSdkAgent 同一词法(t.respond 的自由文本回答):approve / yes / 同意 / 批准 开头 = 批准。 */\nfunction isApproved(text: string): boolean {\n    return /^(approve|yes|同意|批准)/i.test(text.trim());\n}\n/** 按 requestId 从 input.responses 对位取裁决;optionId 优先,自由文本走 isApproved,没答到直接报错。 */\nfunction approvalDecision(responses: readonly InputResponse[] | undefined, requestId: string | undefined): boolean {\n    const matched = responses?.find((r) => r.requestId === requestId);\n    if (!matched) {\n        throw new Error(`No response for pending approval \"${requestId ?? \"unknown\"}\". Answer approval requests with t.respond(...).`);\n    }\n    if (matched.optionId !== undefined)\n        return matched.optionId === \"approve\";\n    return isApproved(matched.text ?? \"\");\n}\n/** 已报告的进度:resume 续跑的是同一条 assistant 消息,跨轮去重靠它。 */\ninterface ReportedState {\n    startedCalls: Set<string>;\n    finishedCalls: Set<string>;\n    textLen: number;\n}\n/**\n * 从归约后的最终消息派生本轮事件。工具事件按 part 顺序;文本合并成一条 message 事件\n * (resume 轮只报新增的后缀)。停在 approval-requested 的调用先报 started,\n * 因此它在审批轮是 pending;裁决后的续跑轮只补 finished,落成 completed 或 rejected。\n */\nfunction deriveTurnEvents(message: UIMessageLike, reported: ReportedState, projectToolCommand: UiMessageStreamAgentOptions[\"projectToolCommand\"]): StreamEvent[] {\n    const events: StreamEvent[] = [];\n    let fullText = \"\";\n    for (const part of message.parts) {\n        if (part.type === \"text\") {\n            fullText += part.text ?? \"\";\n            continue;\n        }\n        if (!isToolPart(part))\n            continue;\n        const callId = part.toolCallId ?? \"\";\n        if (!callId || reported.finishedCalls.has(callId))\n            continue;\n        const name = toolNameOf(part);\n        const input = (part.input ?? null) as JsonValue;\n        const start = () => {\n            if (reported.startedCalls.has(callId))\n                return;\n            const command = projectToolCommand?.({ name, input });\n            events.push({\n                type: \"operation.started\",\n                operationId: callId,\n                operation: {\n                    kind: \"tool\",\n                    name,\n                    input,\n                    ...(command === undefined ? {} : { command }),\n                },\n            });\n            reported.startedCalls.add(callId);\n        };\n        if (part.state === \"output-available\") {\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", output: part.output as JsonValue, status: \"completed\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"output-error\") {\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", output: part.errorText, status: \"failed\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"output-denied\" ||\n            (part.state === \"approval-responded\" && part.approval?.approved === false)) {\n            // 拒绝的调用从没真正执行,协议里不会再有它的任何帧 —— 在裁决落地的这一轮合成。\n            start();\n            events.push({ type: \"operation.finished\", operationId: callId, kind: \"tool\", status: \"rejected\" });\n            reported.finishedCalls.add(callId);\n        }\n        else if (part.state === \"approval-requested\") {\n            start();\n        }\n        // input-* 中间态还没有可信的完整入参,等 approval-requested 或终态再报。\n    }\n    const newText = fullText.slice(reported.textLen);\n    if (newText.trim())\n        events.push({ type: \"message\", role: \"assistant\", text: newText });\n    reported.textLen = fullText.length;\n    return events;\n}\n// ───────────────────────── 工厂 ─────────────────────────\nexport interface UiMessageStreamAgentOptions {\n    /** agent 名(报告 / 结果聚合的身份)。默认 \"ui-message-stream\"。 */\n    name?: string;\n    /** 被测应用的 chat 端点(完整 URL,应用在哪部署就指哪);函数形式每轮解析。 */\n    url: string | ((ctx: AgentContext) => string | Promise<string>);\n    /** 附加请求头(鉴权等);`ctx.telemetry.headers`(traceparent)总会自动并入。 */\n    headers?: globalThis.Record<string, string> | ((ctx: AgentContext) => globalThis.Record<string, string>);\n    /** 除 `messages` 外并入请求体的字段,如 `(ctx) => ({ model: ctx.model })`(undefined 字段序列化时自动丢弃)。 */\n    body?: (ctx: AgentContext) => globalThis.Record<string, JsonValue | undefined>;\n    /**\n     * 由 endpoint owner 逐笔把逻辑工具调用分类为 command 或 not-command。\n     * 未知调用返回 undefined 并保持 actions coverage partial；NiceEval 不按名称或 input 猜测。\n     */\n    projectToolCommand?: (tool: Readonly<{\n        name: string;\n        input: JsonValue;\n    }>) => CommandProjection | undefined;\n    /**\n     * 拒绝审批时随 `approval-responded` 带出的理由。应用/SDK 会把它作为模型看到的工具结果\n     * 文本 —— 写清楚「不要重试」能明显降低模型原样重发同一调用的概率(实测)。\n     */\n    denyReason?: string;\n    /** 流结束后再等这么久才返回(毫秒),给应用侧的观测导出(如 BatchSpanProcessor)留时间。 */\n    settleMs?: number;\n    /** 应用有 OTel 时的端点投递方式(拿瀑布图);事件流不依赖它。 */\n    tracing?: AgentTracing;\n    /** 应用有 OTel 时的 span 归一函数(拿瀑布图);事件流不依赖它。 */\n    spanMapper?: SpanMapper;\n}\nconst DEFAULT_DENY_REASON = \"用户拒绝了这次调用,不要重试,直接告知用户操作未执行。\";\ninterface PreparedUiMessageStreamSend {\n    readonly bookkeeping: UiMessageSessionState;\n    readonly messagesToSend: UIMessageLike[];\n    readonly resumeFrom: UIMessageLike | undefined;\n}\n/** External SDK / transport Promise boundary. */\nfunction promiseEffect<Value>(run: (signal: AbortSignal) => PromiseLike<Value>): Effect.Effect<Value, unknown> {\n    return Effect.tryPromise({ try: run, catch: (cause) => cause });\n}\nfunction resolveUrlEffect(options: UiMessageStreamAgentOptions, ctx: AgentContext): Effect.Effect<string, unknown> {\n    const url = options.url;\n    return typeof url === \"function\"\n        ? promiseEffect(() => Promise.resolve(url(ctx)))\n        : Effect.succeed(url);\n}\nfunction resolveHeadersEffect(options: UiMessageStreamAgentOptions, ctx: AgentContext): Effect.Effect<globalThis.Record<string, string>, unknown> {\n    return Effect.try({\n        try: () => typeof options.headers === \"function\" ? options.headers(ctx) : (options.headers ?? {}),\n        catch: (cause) => cause,\n    });\n}\nfunction transportController() {\n    return Effect.acquireRelease(Effect.sync(() => new AbortController()), (controller) => Effect.sync(() => controller.abort()));\n}\nfunction cancelReadableStreamEffect<Value>(stream: ReadableStream<Value>): Effect.Effect<void> {\n    return promiseEffect(() => stream.cancel()).pipe(Effect.catchAll(() => Effect.void), Effect.asVoid);\n}\nfunction prepareMessages(options: UiMessageStreamAgentOptions, input: TurnInput, ctx: AgentContext): PreparedUiMessageStreamSend {\n    // 会话续接是「客户端带全量历史」模式:历史与协议簿记各用一个 typed slot,\n    // 新线自然两者都为空；相同名字不会让其它 Adapter 的 slot 与它们碰撞。\n    const priorMessages = ctx.session.get(historySlot) ?? [];\n    const bookkeeping = ctx.session.get(sessionStateSlot) ?? {};\n    ctx.session.set(sessionStateSlot, bookkeeping);\n    let id = bookkeeping.chatId;\n    if (!id) {\n        id = `uims-${randomUUID()}`;\n        bookkeeping.chatId = id;\n        ctx.session.capture(id); // 镜像:t.sessionId / 报告可见\n    }\n    const lastMessage = priorMessages.at(-1);\n    const pendingPart = lastMessage?.role === \"assistant\" ? lastMessage.parts.find(isApprovalRequested) : undefined;\n    if (pendingPart && lastMessage) {\n        // HITL 续跑:不追加新 user 消息 —— 把停在 approval-requested 的 part 原地改成\n        // approval-responded,原样重发,服务端续跑同一条被打断的 assistant 消息。\n        // 裁决按 requestId 从 input.responses 对位读取(t.respond 的结构化回答)。\n        const requestId = pendingPart.approval?.id ?? pendingPart.toolCallId;\n        const approved = approvalDecision(input.responses, requestId);\n        const mutatedParts = lastMessage.parts.map((part) => isApprovalRequested(part) && part.approval?.id === pendingPart.approval?.id\n            ? {\n                ...part,\n                state: \"approval-responded\",\n                approval: {\n                    id: pendingPart.approval!.id,\n                    approved,\n                    ...(approved ? {} : { reason: options.denyReason ?? DEFAULT_DENY_REASON }),\n                },\n            }\n            : part);\n        const resumeFrom = { ...lastMessage, parts: mutatedParts };\n        return {\n            bookkeeping,\n            resumeFrom,\n            messagesToSend: [...priorMessages.slice(0, -1), resumeFrom],\n        };\n    }\n    const parts: UIMessagePartLike[] = [{ type: \"text\", text: input.text }];\n    for (const file of input.files ?? []) {\n        parts.push({ type: \"file\", mediaType: file.mimeType, url: `data:${file.mimeType};base64,${file.dataBase64}` });\n    }\n    return {\n        bookkeeping,\n        resumeFrom: undefined,\n        messagesToSend: [...priorMessages, { id: randomUUID(), role: \"user\", parts }],\n    };\n}\n/** Consume the SDK's native async iterator only inside its named Effect Promise boundary. */\nfunction reduceUiMessageStreamEffect(readUIMessageStream: ReadUIMessageStream, resumeFrom: UIMessageLike | undefined, stream: ReadableStream<UIMessageChunkLike>, transport: AbortController): Effect.Effect<UIMessageLike | undefined, unknown> {\n    return promiseEffect(async (signal) => {\n        const onAbort = () => transport.abort(signal.reason);\n        signal.addEventListener(\"abort\", onAbort, { once: true });\n        if (signal.aborted)\n            onAbort();\n        try {\n            let finalMessage: UIMessageLike | undefined;\n            for await (const message of readUIMessageStream({ message: resumeFrom, stream })) {\n                finalMessage = message;\n            }\n            return finalMessage;\n        }\n        finally {\n            signal.removeEventListener(\"abort\", onAbort);\n        }\n    });\n}\nfunction uiMessageStreamSendEffect(options: UiMessageStreamAgentOptions, input: TurnInput, ctx: AgentContext): Effect.Effect<import(\"../types.ts\").Turn, unknown> {\n    return Effect.scoped(Effect.gen(function* () {\n        const { readUIMessageStream } = yield* loadAiEffect();\n        const prepared = yield* Effect.try({\n            try: () => prepareMessages(options, input, ctx),\n            catch: (cause) => cause,\n        });\n        const url = yield* resolveUrlEffect(options, ctx);\n        const extraHeaders = yield* resolveHeadersEffect(options, ctx);\n        const transport = yield* transportController();\n        const res = yield* Effect.tryPromise({\n            try: (signal) => fetch(url, {\n                method: \"POST\",\n                // traceparent 随请求带过去:应用埋点支持 context 传播时,span 归属精确到本轮。\n                headers: { \"content-type\": \"application/json\", ...extraHeaders, ...ctx.telemetry?.headers },\n                body: JSON.stringify({ ...options.body?.(ctx), messages: prepared.messagesToSend }),\n                signal: AbortSignal.any([ctx.signal, signal, transport.signal]),\n            }),\n            catch: (err) => {\n                if (ctx.signal.aborted)\n                    return err;\n                const cause = err instanceof Error\n                    ? (err.cause instanceof Error ? err.cause.message : err.message)\n                    : String(err);\n                return makeSendFailure({\n                    acceptance: \"unknown\",\n                    message: `Could not connect to ${url} (${cause}). Is the app under test running? Start it yourself first, or point url at a deployed instance via config.`,\n                    cause: normalizeExternalCause(err),\n                });\n            },\n        });\n        const responseBody = res.body;\n        if (!res.ok || !responseBody) {\n            const responseText = yield* promiseEffect(() => res.text()).pipe(Effect.catchAll(() => Effect.succeed(\"\")));\n            return yield* Effect.fail(makeSendFailure({\n                acceptance: \"unknown\",\n                message: `POST ${url} failed: ${res.status} ${responseText}. Confirm the app is running and the endpoint speaks the UI Message Stream protocol (the backend useChat expects).`,\n                cause: normalizeExternalCause({ status: res.status }),\n            }));\n        }\n        const streamState: {\n            sawDone: boolean;\n            sawError: string | undefined;\n        } = {\n            sawDone: false,\n            sawError: undefined,\n        };\n        const chunkStream = toChunkStream(responseBody, (chunk) => {\n            if (chunk.type === \"error\")\n                streamState.sawError = chunk.errorText;\n        }, () => {\n            streamState.sawDone = true;\n        });\n        yield* Effect.addFinalizer(() => Effect.sync(() => transport.abort()).pipe(Effect.zipRight(cancelReadableStreamEffect(chunkStream))));\n        const finalMessage = yield* reduceUiMessageStreamEffect(readUIMessageStream, prepared.resumeFrom, chunkStream, transport);\n        if (!streamState.sawDone) {\n            return yield* Effect.fail(makeSendFailure({\n                acceptance: \"unknown\",\n                message: `POST ${url} ended before the UI Message Stream [DONE] marker. The response was truncated or the endpoint does not speak the complete UI Message Stream protocol.`,\n            }));\n        }\n        if (!finalMessage) {\n            return yield* Effect.fail(makeSendFailure({\n                acceptance: \"unknown\",\n                message: `POST ${url} 的流结束了但一条 assistant 消息都没归约出来 —— 端点吐的不是 UI Message Stream 帧?`,\n            }));\n        }\n        const derived = yield* Effect.try({\n            try: () => {\n                // 续跑轮:finalMessage 是同一条消息的完整版,替换末尾半成品;全新轮:追加。\n                ctx.session.set(historySlot, prepared.resumeFrom\n                    ? [...prepared.messagesToSend.slice(0, -1), finalMessage]\n                    : [...prepared.messagesToSend, finalMessage]);\n                const reported: ReportedState = prepared.resumeFrom && prepared.bookkeeping.reported\n                    ? prepared.bookkeeping.reported\n                    : { startedCalls: new Set(), finishedCalls: new Set(), textLen: 0 };\n                prepared.bookkeeping.reported = reported;\n                return {\n                    events: deriveTurnEvents(finalMessage, reported, options.projectToolCommand),\n                    request: finalMessage.parts.find(isApprovalRequested),\n                };\n            },\n            catch: (cause) => cause,\n        });\n        const request = derived.request;\n        if (request) {\n            return yield* Effect.try({\n                try: () => {\n                    const waitingEvents = [\n                        ...derived.events,\n                        {\n                            type: \"input.requested\" as const,\n                            request: {\n                                id: request.approval?.id ?? request.toolCallId,\n                                action: toolNameOf(request),\n                                input: (request.input ?? null) as JsonValue,\n                                options: [{ id: \"approve\" }, { id: \"deny\" }],\n                            },\n                        },\n                    ];\n                    const evidenceCoverage = unclassifiedToolActionsCoverage(waitingEvents);\n                    return {\n                        status: \"waiting\" as const,\n                        events: waitingEvents,\n                        ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),\n                    };\n                },\n                catch: (cause) => cause,\n            });\n        }\n        if (options.settleMs)\n            yield* Effect.sleep(options.settleMs);\n        return yield* Effect.try({\n            try: () => {\n                const finalEvents = [\n                    ...derived.events,\n                    ...(streamState.sawError ? [{ type: \"error\" as const, message: streamState.sawError }] : []),\n                ];\n                const evidenceCoverage = unclassifiedToolActionsCoverage(finalEvents);\n                return {\n                    status: streamState.sawError ? (\"failed\" as const) : (\"completed\" as const),\n                    events: finalEvents,\n                    ...(evidenceCoverage === undefined ? {} : { evidenceCoverage }),\n                };\n            },\n            catch: (cause) => cause,\n        });\n    }));\n}\n/**\n * UI Message Stream Protocol(AI SDK `useChat` 后端的标准 SSE 协议)的内置无侵入 adapter。\n * 对着已部署应用的 HTTP 端点收发,不 import 应用代码:\n *\n * ```typescript\n * import { uiMessageStreamAgent } from \"niceeval/adapter\";\n *\n * export default uiMessageStreamAgent({\n *   name: \"my-assistant\",\n *   url: \"https://my-app.example.com/api/chat\",\n *   body: (ctx) => ({ model: ctx.model }),   // 应用支持请求级选模型时,模型对比零改动\n * });\n * ```\n */\nexport function uiMessageStreamAgent(options: UiMessageStreamAgentOptions): Agent {\n    return defineAgent({\n        name: options.name ?? \"ui-message-stream\",\n        evidenceCoverage: COVERAGE,\n        tracing: options.tracing,\n        spanMapper: options.spanMapper,\n        send: (input, ctx) => Effect.runPromise(uiMessageStreamSendEffect(options, input, ctx), { signal: ctx.signal }),\n    });\n}\n"]}