@kernel4632/agent-core 0.33.0 → 0.34.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/dist/agent-core.d.ts +2 -1
- package/dist/agent-core.js +52 -52
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -808,7 +808,7 @@ console.log(answer.text)
|
|
|
808
808
|
| `onStep` | 一轮模型和工具都完成后 | `{ step, result, toolCalls, toolResults }`;`toolResults` 是完整结果对象(`call` + `output`),和 `onToolResult` 同一种形状 |
|
|
809
809
|
| `onRetry` | 请求失败重试 | `{ attempt, error, delay }`(主请求和压缩请求共用) |
|
|
810
810
|
| `onInject` | 每轮请求前(压缩之后) | `{ tokens, budget, compactThreshold }` → 返回字符串就临时附在本次请求末尾;返回其它值不注入 |
|
|
811
|
-
| `onCompact` | 上下文压缩 | `compact-start`(`messages` + `reason` / `token` / `budget` / `compactThreshold` / `ratio`)/ AI SDK 事件(统一带 `request: 'compact'` 标记)/ `compact-finish`(带 `usage`,即压缩这一笔的用量) |
|
|
811
|
+
| `onCompact` | 上下文压缩 | `compact-start`(`messages` + `reason` / `token` / `budget` / `compactThreshold` / `ratio` / `chars` / `media` / `calibrated`)/ AI SDK 事件(统一带 `request: 'compact'` 标记)/ `compact-finish`(带 `usage`,即压缩这一笔的用量) |
|
|
812
812
|
|
|
813
813
|
除了 `onPermission` 和 `onInject`,所有回调都只是通知:回调自己抛错会被忽略,任务照常进行,工具结果也不会被改写。`onPermission` 的返回值决定放不放行,所以它抛错时这次 `send` 会失败,交给你的 `.catch()`。注意它按"非 `true` 即拒绝"处理:**每个分支都要显式 `return true`**,忘了返回会让那次工具被拒。`onInject` 抛错只当这一轮不注入,不打断任务。
|
|
814
814
|
|
|
@@ -821,9 +821,13 @@ console.log(answer.text)
|
|
|
821
821
|
| `budget` | `config.maxContextTokens`(上下文预算,不是模型窗口) |
|
|
822
822
|
| `compactThreshold` | 触发比例 |
|
|
823
823
|
| `ratio` | 这次用的"每字符多少 token"比例(按模型自校准的那个值) |
|
|
824
|
+
| `chars` / `media` | `token` 的两个组成部分:文字字符数、媒体块数(`token = ceil(chars × ratio) + media × 1200`) |
|
|
825
|
+
| `calibrated` | `ratio` 是不是从真实 usage 学来的。`false` = 还在用默认值 |
|
|
824
826
|
|
|
825
827
|
判断"是不是估算误判"就看 `token` 和 `budget × compactThreshold` 的关系,以及 `ratio` 是不是明显偏离你的内容(中文 ≈ 1,英文 ≈ 0.25)。注意 `token` 是**这一轮开始时**的估算:上一次真实请求之后又写进来的工具结果也在里面,所以它会比"上一次请求的 input"大。
|
|
826
828
|
|
|
829
|
+
`calibrated: false` 有两个常见原因:一是进程刚起、还没成功跑完过一笔请求;二是上游没在响应里回 `usage`(流式请求需要 `stream_options.include_usage`,个别中转站不支持,可以用 `capabilities.usage: false` 关掉这个字段,但那样估算就只能一直用默认比例)。**校准是每个进程从零开始的**:重启后恢复一份很大的 history 时,第一个 `send` 用的仍是默认比例,可能因此多压一次——把 `token / chars / ratio` 记下来就能确认。想据此折算真实比例:`真实 token ÷ chars`。
|
|
830
|
+
|
|
827
831
|
#### 宿主注入临时提示(`onInject`)
|
|
828
832
|
|
|
829
833
|
想在"下一次模型请求"里临时补一句话,用 `onInject`:每轮请求前调一次,返回的文字作为一条 `user` 消息附在请求末尾,**不写进 `history`**,请求发完就没了。`tokens` 是这一轮压缩之后的估算值。
|
package/dist/agent-core.d.ts
CHANGED
|
@@ -194,7 +194,8 @@ export interface HistoryModule {
|
|
|
194
194
|
|
|
195
195
|
// --- 上下文、压缩、底层 LLM ---
|
|
196
196
|
export interface ContextModule {
|
|
197
|
-
build: (options: { history: Message[]; system?: string; tools?: Record<string, any>; budget?: number; ratio?: number; capabilities?: Capabilities; mediaFallback?: 'error' | 'strip'; keep?: ContextKeep }) =>
|
|
197
|
+
build: (options: { history: Message[]; system?: string; tools?: Record<string, any>; budget?: number; ratio?: number; capabilities?: Capabilities; mediaFallback?: 'error' | 'strip'; keep?: ContextKeep }) =>
|
|
198
|
+
{ messages: any[]; readonly token: number; readonly chars: number; readonly media: number } // chars / media 是 token 的两个组成部分,诊断估算时用。
|
|
198
199
|
}
|
|
199
200
|
export interface CompactModule {
|
|
200
201
|
// 返回总结文本和这一笔压缩请求的用量(0.27 起带 usage:压缩也是真实请求,钱要计进合计)。
|