审批质询(前端)第一步:质询的类型与接口、时间线解读 approval.inquiry

- types.ts 末尾按前后端约定加 Inquiry、InquiryRequest/Response、查询与快照的类型,字段名一个不改
- api/inquiry.ts:提问(POST,不设超时,服务端自有时长上限)、列出问答、取质询引用过的查询快照(外层包不包一层都交给界面认)
- decode.ts:approval.inquiry 不再落进「未识别的事件」,解读成顶层一行「审批人质询」:标题带问题前 40 字,副标题说回答完成 / 不完整(写明哪个上限)/ 未能回答、查了几次,封存之后问的写明封存后追加;缺字段、类型不对的照实少说,不拿 0 顶查询次数
- check-decode 断言上述说法与缺字段的兜底;check-trace 加「运行停在审批时来了一条质询,相位仍是等待」:等待段不被收掉、执行时长不涨、恢复后照常跑完、每个前缀上 trace 与 decodePhase 一致
This commit is contained in:
ThearchyHelios
2026-10-05 18:46:03 +08:00
parent 14dcbe19bb
commit 23cdc986fc
6 changed files with 341 additions and 4 deletions
+105
View File
@@ -3690,3 +3690,108 @@ export interface ChallengeArtifact {
claims: ChallengeClaim[]
model: string | null
}
// ---------------------------------------------------------------------------
// 审批质询:审批人就待审的报告提问,核查模型只读查库作答。形状照前后端共用的接口约定(F5a / F5b 同一份),字段名一个
// 不改;回答正文、行数、触顶原因都是服务端给的,界面只排版
// ---------------------------------------------------------------------------
/** 回答停在哪个上限上:每次最多查询次数、时长、这一次的金额、核查的每日金额 */
export type InquiryLimit = 'max_queries' | 'timeout_s' | 'max_cost_usd' | 'daily_max_usd'
/** 质询的回答 */
export interface InquiryAnswer {
/** 渲染后的正文(数字已按出处换好) */
text: string
/** compose_doc 组装的文档工件:有它,正文里的数字可以点开看出处;没有(组装失败)只显示 text */
doc_artifact: string | null
ok: boolean
limit: InquiryLimit | (string & {}) | null
/** 没答成时的中文说明 */
error: string | null
}
/** 核查模型为回答执行的一次只读查询。编号是这次质询自己的,快照按质询工件接口取(遮罩列已遮掉) */
export interface InquiryQuery {
alias: string
artifact: string
sql: string
row_count: number | null
truncated: boolean
/** 数据源名 */
source: string | null
}
export interface InquiryUsage {
input_tokens?: number
output_tokens?: number
cost_usd?: number | null
calls?: number
unpriced_calls?: number
}
/** 一次质询:问的是哪份报告的哪一句(或划选的哪段原文)、问了什么、怎么答的、查了什么 */
export interface Inquiry {
/** 运行记录里那条 approval.inquiry 事件的序号;没写进运行记录时为 null */
seq: number | null
/** 什么时候问的(ISO 时间或秒级时间戳) */
at: string | number | null
/** 提问人的署名;没署名时为 null */
actor: string | null
/** 报告撰写节点 id */
report: string
/** 句子单元 id(如 u12);就整份报告提问时为 null */
unit: string | null
/** 划选的原文 */
quote: string | null
question: string
answer: InquiryAnswer
queries: InquiryQuery[]
/** 作答的核查模型 */
model: string | null
usage: InquiryUsage
/** 运行封存之后才问的(只有探索运行可以) */
post_seal: boolean
/** 提问时停在的那张审批;封存之后问的为 null */
approval_id: string | null
}
/** POST /runs/{id}/inquiries 的请求体 */
export interface InquiryRequest {
report: string
unit: string | null
quote?: string | null
question: string
/** 运行停在审批上时必填:指明是哪一张 */
approval_id?: string
}
/** POST /runs/{id}/inquiries 的答复 */
export interface InquiryResponse {
inquiry: Inquiry
/** 是否写进了运行记录 */
recorded: boolean
/** 没写进运行记录时的中文说明,否则为 null */
note: string | null
}
/** GET /runs/{id}/inquiries 的答复 */
export interface InquiryList {
items: Inquiry[]
}
/**
* GET /runs/{id}/inquiries/artifacts/{artifact}:质询引用过的查询快照,遮罩列照证据面板的规则遮掉(值写「已遮罩」)。
* 约定只说了是快照:可能是快照本身,也可能包在 {id, content} 里(同工件接口),界面两种都认
*/
export interface InquirySnapshot {
columns: string[]
rows: unknown[][]
sql: string | null
truncated: boolean
/** 结果一共几行(快照的 row_count / total_rows),不给时按 rows 的长度 */
total: number | null
/** 遮掉的列 */
masked: string[]
source: string | null
}