Import packages/plugin/src/compact-bot-round.ts

This commit is contained in:
QQ 2026-11-14 14:55:08 +08:00
parent 3e41145a48
commit 2b63e5ab3f
1 changed files with 90 additions and 0 deletions

View File

@ -0,0 +1,90 @@
/**
* ds-bot group rounds are conversation content, not tool diagnostics: one
* `JSON.stringify({ replies, passed, failed? })` tool result carries every
* Bot's spoken reply for the round. The generic compact projection would cut
* that at 512 characters, which loses whole replies — the client can only
* recover entries that close before the cut, so one long reply hides the
* entire round and the conversation collapses into tool activity.
*
* Keeping the recognised shape as a bounded structural projection preserves the
* reply contract while the frame stays small. This module is shape-only on
* purpose: it whitelists primitive fields and never interprets `kind`, so the
* client remains the semantic authority for reply presentation.
*/
const HEADER = '{"replies"'
const LIMITS = Object.freeze({
/** How far into the detail the payload header may appear. */
scan: 4096,
/** Never attempt structural work on an absurdly large detail. */
source: 1024 * 1024,
/** Replies kept per round, in their original order. */
entries: 32,
/** Spoken text kept per reply. */
text: 2048,
/** Identifier/label fields kept per reply. */
label: 256,
/** Serialized projection ceiling for one round. */
payload: 8 * 1024,
})
export const COMPACT_BOT_ROUND_LIMITS = LIMITS
/** Fields a reply entry may carry; `time` is the only numeric one. */
const REPLY_FIELDS = ['botId', 'name', 'text', 'kind', 'via', 'code', 'status', 'time'] as const
const LABEL_FIELDS = new Set<string>(['botId', 'name', 'kind', 'via', 'code', 'status'])
const object = (value: unknown): value is Record<string, unknown> =>
value !== null && typeof value === 'object' && !Array.isArray(value)
/**
* Project one tool detail to a bounded group-round payload, or `undefined` when
* the text does not carry the ds-bot round contract (the caller keeps its own
* ordinary truncation). Never throws: compact history is a read-only projection,
* so a malformed detail must stay on the generic path.
*/
export function compactBotRound(text: string): string | undefined {
if (typeof text !== 'string' || text.length === 0 || text.length > LIMITS.source) return undefined
const start = text.indexOf(HEADER)
if (start < 0 || start > LIMITS.scan) return undefined
let parsed: unknown
try { parsed = JSON.parse(text.slice(start)) } catch { return undefined }
if (!object(parsed) || !Array.isArray(parsed.replies)) return undefined
const source = parsed.replies
if (source.length === 0) return undefined
const replies: Record<string, unknown>[] = []
let truncated = parsed.truncated === true
for (const entry of source) {
if (replies.length >= LIMITS.entries) { truncated = true; break }
if (!object(entry)) continue
const reply: Record<string, unknown> = {}
for (const field of REPLY_FIELDS) {
const value = entry[field]
if (field === 'time') {
if (typeof value === 'number') reply.time = value
} else if (typeof value === 'string') {
const limit = LABEL_FIELDS.has(field) ? LIMITS.label : LIMITS.text
if (value.length > limit) { reply[field] = value.slice(0, limit); truncated = true }
else reply[field] = value
}
}
// Entries without spoken text or a status kind cannot render; the client
// drops them too, so they must not consume the payload budget.
if (reply.text === undefined && reply.kind === undefined) continue
replies.push(reply)
}
if (replies.length === 0) return undefined
const envelope: Record<string, unknown> = { replies }
if (typeof parsed.passed === 'number') envelope.passed = parsed.passed
if (typeof parsed.failed === 'number') envelope.failed = parsed.failed
const serialize = (cut: boolean): string => JSON.stringify(cut ? { ...envelope, truncated: true } : envelope)
let json = serialize(truncated)
// One reply is always below the payload ceiling because every string field is
// capped above, so dropping trailing replies terminates on its own.
while (json.length > LIMITS.payload && replies.length > 1) {
replies.pop()
truncated = true
json = serialize(true)
}
return json.length > LIMITS.payload ? undefined : json
}