@kernel4632/agent-core 0.25.0 → 0.27.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 +64 -12
- package/dist/agent-core.d.ts +14 -4
- package/dist/agent-core.js +89 -82
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -601,6 +601,14 @@ const agent = Agent.create({
|
|
|
601
601
|
})
|
|
602
602
|
```
|
|
603
603
|
|
|
604
|
+
**人机审批的推荐结构**(实战里每个应用都会撞到的问题):
|
|
605
|
+
|
|
606
|
+
- 等用户点击的实现是"返回一个挂起的 Promise"——包保证取消信号一到就不再等它,但**等多久、谁来唤醒**由你的回调决定。常见做法:按 `toolCallId` 存一张 `Map<id, resolve>`,审批接口收到决定后 `resolve(true/false)`。
|
|
607
|
+
- **等待期间 `send` 仍处于"正在运行"**:想允许用户在审批时发新消息顶掉任务,按 `send` 的既有语义处理(新 send 会先 stop 旧的)。
|
|
608
|
+
- **服务重启会丢掉挂起的审批**:`Map` 在内存里。重启后要么给会话补发一条审批请求(凭 history 里的 assistant 工具调用就能还原 `toolCallId`),要么在启动时把该会话标记为"已中断"。
|
|
609
|
+
- **务必给每条路径都 `return`**:非布尔返回值一律按拒绝处理(0.26 起),漏 return 会让这次调用被静默拒绝。
|
|
610
|
+
- **拒绝/取消/无效调用现在也会触发 `onToolResult`**(0.27 起),`output.type` 分别是 `execution-denied` / `error-text`——界面统一从这一个回调翻状态即可,不用再监听 `onPermission` 补通知。
|
|
611
|
+
|
|
604
612
|
---
|
|
605
613
|
|
|
606
614
|
## API 参考
|
|
@@ -641,7 +649,8 @@ import Agent from '@kernel4632/agent-core'
|
|
|
641
649
|
| `mediaFallback` | `'error'` | 媒体能力关闭时的处理方式;改成 `'strip'` 后保留文字并丢掉不支持的媒体 |
|
|
642
650
|
| `provider` | `{}` | AI SDK 的生成参数,整份交给 AI SDK;不设时用模型自己的默认值 |
|
|
643
651
|
| `maxToolOutput` | `undefined` | 默认不截断工具输出;主动设置后超出部分从中间截断并告知模型 |
|
|
644
|
-
| `
|
|
652
|
+
| `maxContextTokens` | `128000` | 上下文预算,**默认开启自动压缩**:估算的上下文超过预算的 `compactThreshold` 比例时就压缩一次。设 `Infinity` 关闭 |
|
|
653
|
+
| `maxTokens` | `undefined` | 单次生成的最大输出 token,映射到请求体的 `maxOutputTokens`;不设=不限。`provider.maxOutputTokens` 显式设置时优先于它 |
|
|
645
654
|
| `compactThreshold` | `0.8` | 压缩触发比例,0.8 表示到达 80% 时压缩 |
|
|
646
655
|
| `compact` | `undefined` | 压缩单独用一套模型时写在这里,例如 `{ model: '便宜的小模型' }`;不写就和主模型共用 |
|
|
647
656
|
| `output` | `undefined` | 结构化输出格式,例如 `Agent.output.object({ schema })`;不写就返回普通文字 |
|
|
@@ -716,7 +725,7 @@ const agent = Agent.create({
|
|
|
716
725
|
})
|
|
717
726
|
```
|
|
718
727
|
|
|
719
|
-
在 `agent.send({ input, config: { ... } })` 里传入的配置会**写回 Agent**、之后的 send 继续生效。合并规则分三种:`provider` 和 `retry` **整份替换**(传了就只用新的,未写的字段不再保留);`capabilities` 和 `compact` **按字段浅合并**(只传其中一项不丢另外的);其余字段直接覆盖。`maxTokens`
|
|
728
|
+
在 `agent.send({ input, config: { ... } })` 里传入的配置会**写回 Agent**、之后的 send 继续生效。合并规则分三种:`provider` 和 `retry` **整份替换**(传了就只用新的,未写的字段不再保留);`capabilities` 和 `compact` **按字段浅合并**(只传其中一项不丢另外的);其余字段直接覆盖。`maxContextTokens` 是上下文预算,`maxTokens` 是单次生成的最大输出(会映射成请求体的 `maxOutputTokens`),两者不是一回事。
|
|
720
729
|
|
|
721
730
|
`cache` 默认开启。四种协议各按自己的方式让服务端复用固定的开头(system、工具描述、历史),命中后那部分不再重新计算,长会话能明显变快、变便宜:
|
|
722
731
|
|
|
@@ -794,10 +803,10 @@ console.log(answer.text)
|
|
|
794
803
|
| `onPermission` | 工具执行前 | `{ toolName, input, sessionId, toolCallId, signal }` → 返回 `true/false` |
|
|
795
804
|
| `onToolCall` | 工具即将执行 | `{ toolCallId, toolName, input }` |
|
|
796
805
|
| `onToolOutput` | 工具有流式输出 | `{ toolName, stream, data, toolCallId, input? }`;`data` 是工具 yield / 打印出来的原值,类型不定 |
|
|
797
|
-
| `onToolResult` |
|
|
798
|
-
| `onStep` | 一轮模型和工具都完成后 | `{ step, result, toolCalls, toolResults }` |
|
|
806
|
+
| `onToolResult` | 工具执行完成(拒绝/取消/无效调用也触发) | `{ toolName, toolCallId, output, ... }` |
|
|
807
|
+
| `onStep` | 一轮模型和工具都完成后 | `{ step, result, toolCalls, toolResults }`;`toolResults` 是完整结果对象(`call` + `output`),和 `onToolResult` 同一种形状 |
|
|
799
808
|
| `onRetry` | 请求失败重试 | `{ attempt, error, delay }`(主请求和压缩请求共用) |
|
|
800
|
-
| `onCompact` | 上下文压缩 | `compact-start` / AI SDK
|
|
809
|
+
| `onCompact` | 上下文压缩 | `compact-start` / AI SDK 事件(统一带 `request: 'compact'` 标记)/ `compact-finish`(带 `usage`,即压缩这一笔的用量) |
|
|
801
810
|
|
|
802
811
|
除了 `onPermission`,所有回调都只是通知:回调自己抛错会被忽略,任务照常进行,工具结果也不会被改写。`onPermission` 的返回值决定放不放行,所以它抛错时这次 `send` 会失败,交给你的 `.catch()`。注意它按"非 `true` 即拒绝"处理:**每个分支都要显式 `return true`**,忘了返回会让那次工具被拒。
|
|
803
812
|
|
|
@@ -823,6 +832,7 @@ const result = await agent.send({
|
|
|
823
832
|
// result.steps → 这次 send 一共请求了模型几轮
|
|
824
833
|
// result.usage → 整次 send 的用量合计:{ inputTokens, outputTokens, totalTokens, cacheReadTokens, cacheWriteTokens }
|
|
825
834
|
// 算钱、看缓存命中直接读这里;cacheReadTokens / inputTokens 就是缓存命中率
|
|
835
|
+
// 自动压缩那一笔的用量也计在合计里(0.27 起)——压缩也是真实的模型请求
|
|
826
836
|
// result.reason:
|
|
827
837
|
// 'finished' → 没注册工具,或结构化输出已校验成功:这就是最终回答
|
|
828
838
|
// 'no-tool' → 有工具,但连续 noToolRounds 轮(默认 3)没调用工具才结束
|
|
@@ -867,6 +877,18 @@ await agent.send({
|
|
|
867
877
|
await agent.stop() // 等待完全停止后返回 { ok: true };Agent 空闲时返回 { ok: false }
|
|
868
878
|
```
|
|
869
879
|
|
|
880
|
+
#### `agent.resume(options?)`
|
|
881
|
+
|
|
882
|
+
不发新消息,用现有历史的末尾接着跑——典型场景是停止后继续被中断的回复。它不往 `history` 里写任何东西:模型看到的末尾就是中断前的最后一条(assistant 或 tool 消息),所以**不会**出现"续跑后历史里多出一条假的用户消息"。
|
|
883
|
+
|
|
884
|
+
```js
|
|
885
|
+
const answer = await agent.resume() // 从上次停下的地方继续,返回值和 send 相同
|
|
886
|
+
const answer = await agent.resume({ config: { model: '新模型' } }) // 也可以像 send 一样按次覆盖 config / callbacks
|
|
887
|
+
```
|
|
888
|
+
|
|
889
|
+
- 历史末尾必须是 `assistant` 或 `tool` 消息(有"没说完的话"可续),否则直接报错;想发新内容用 `send`。
|
|
890
|
+
- `resume` 不接受 `input`;传了会报错,防止把"继续"误写成新指令。
|
|
891
|
+
|
|
870
892
|
#### 流式与网页实时推送
|
|
871
893
|
|
|
872
894
|
`send` 内部默认就是流式(`config.stream` 默认 `true`),`await` 拿到的是和流式一样的结果。想实时拿到每一块,用 `onLLMEvent`:模型每吐一段就调用一次,事件是包内 AI SDK 的原生事件。
|
|
@@ -985,7 +1007,33 @@ Agent.tool.adopt(await mcpClient.tools())
|
|
|
985
1007
|
|
|
986
1008
|
`inputSchema` 可以是裸 JSON Schema、zod,或 AI SDK 的 `jsonSchema()`。`execute(input, { abortSignal })` 会收到取消信号(也接受别名 `signal`)。
|
|
987
1009
|
|
|
988
|
-
文件工具和内存工具可以合并:`Agent.tool.merge(await Agent.tool.scan('./tools'), Agent.tool.adopt(mcpTools))`,或者直接用 `Agent.tool.from('./tools', mcpTools)
|
|
1010
|
+
文件工具和内存工具可以合并:`Agent.tool.merge(await Agent.tool.scan('./tools'), Agent.tool.adopt(mcpTools))`,或者直接用 `Agent.tool.from('./tools', mcpTools)`(见上)。想从集合里取子集,用 `pick` / `omit`:
|
|
1011
|
+
|
|
1012
|
+
```js
|
|
1013
|
+
const readonly = Agent.tool.pick(tools, ['read', 'glob']) // 只留这两个工具
|
|
1014
|
+
const safe = Agent.tool.omit(tools, ['shell', 'write']) // 去掉这些,其余全留
|
|
1015
|
+
const agent = Agent.create({ config, tools: safe })
|
|
1016
|
+
```
|
|
1017
|
+
|
|
1018
|
+
`pick` / `omit` 的 `names` 是字符串数组,`schema` 和 `handlers` 会**一起筛**,不会出现"模型看不见、却还能被执行"的隐蔽状态。返回的是新集合,可以直接交给 `create` / `send` / `merge`,也可以继续 `pick` / `omit`。空集合或 `undefined` 集合也安全(返回空集合)。
|
|
1019
|
+
|
|
1020
|
+
#### 工具集合里有什么
|
|
1021
|
+
|
|
1022
|
+
`scan` / `adopt` / `merge` / `pick` / `omit` 都返回同一种 `{ schema, handlers }`,里面的东西:
|
|
1023
|
+
|
|
1024
|
+
| 位置 | 是什么 |
|
|
1025
|
+
|------|--------|
|
|
1026
|
+
| `schema[name].name` | 工具名 |
|
|
1027
|
+
| `schema[name].description` | 给模型看的工具说明 |
|
|
1028
|
+
| `schema[name].source` | **来源标记**:`'file'`(目录扫描)或 `'memory'`(内存工具,MCP 工具走这里)。应用判断"这个工具从哪来"读它,别靠工具名前缀猜 |
|
|
1029
|
+
| `schema[name].inputSchema` | **已编译的校验器**(AI SDK 的 `jsonSchema()` 形态);原始 JSON Schema 在 `inputSchema.jsonSchema` 里 |
|
|
1030
|
+
| `handlers[name]` | 执行器内部形状(文件工具是 `url`,内存工具是 `execute` 等);**不要自己构造**,原样传回 `merge` / `pick` / `omit` 或 `Agent.tool.execute` |
|
|
1031
|
+
|
|
1032
|
+
工具对象上的额外字段会被 `scan` / `adopt` 原样带进 `schema[name]`:比如工具自己声明 `touchesFiles: ['path']`,应用层就能从 `tools.schema[name].touchesFiles` 读到。注意 `schema` 是发给模型的那一份,别把不想让模型看到的内部标记放进去(`execute`、`toModelOutput`、`timeout` 不会被带进去,它们只留在 `handlers`)。**想要"只在宿主用、不进 schema"的字段**(比如内部钩子),把工具包一层、从闭包里取,别写在工具对象上:
|
|
1033
|
+
|
|
1034
|
+
```js
|
|
1035
|
+
const wrap = (tool, host) => ({ ...tool, execute: (input, options) => tool.execute(input, { ...options, host }) }) // host 从闭包取,不进 schema
|
|
1036
|
+
```
|
|
989
1037
|
|
|
990
1038
|
**MCP 工具直接可用,不需要包装**:`@ai-sdk/mcp` 的 `client.tools()` 自带 `execute` 和 `toModelOutput`,核心按 AI SDK 的签名调用它们,文字、图片都会正确交给模型。完整接入例子见前面的[「接入 MCP 和技能」](#接入-mcp-和技能)。
|
|
991
1039
|
|
|
@@ -995,11 +1043,15 @@ Agent.tool.adopt(await mcpClient.tools())
|
|
|
995
1043
|
>
|
|
996
1044
|
> 从 0.19 升级:`onPermission` 的 `arguments` 字段改名为 `input`;结束原因多了一个 `'finished'`(没注册工具、或结构化输出已校验成功,原先是 `'no-tool'`)。工具对象的 `execute(input, { abortSignal })`、`toModelOutput({ output, input })` 现在按 AI SDK 签名调用。
|
|
997
1045
|
>
|
|
998
|
-
> 从 0.21 升级:去掉了 `gpt-tokenizer`,上下文 token 改用**自校准估算**(字符数 × 每字符 token 比,比例由真实 `usage` 学到,跟着模型走);`
|
|
1046
|
+
> 从 0.21 升级:去掉了 `gpt-tokenizer`,上下文 token 改用**自校准估算**(字符数 × 每字符 token 比,比例由真实 `usage` 学到,跟着模型走);`maxContextTokens` 默认变为 `128000`,**自动压缩默认开启**(想关掉设 `maxContextTokens: Infinity`)。产物从 ~3.9 MB 降到 ~1.3 MB。
|
|
999
1047
|
>
|
|
1000
|
-
> 从 0.22 升级:内存工具声明的 `timeout` 现在真的生效;新增 `capabilities.usage`(关掉流式请求里的 `include_usage`);`compactThreshold`、字符串型 `
|
|
1048
|
+
> 从 0.22 升级:内存工具声明的 `timeout` 现在真的生效;新增 `capabilities.usage`(关掉流式请求里的 `include_usage`);`compactThreshold`、字符串型 `maxContextTokens` 等非法配置现在会在 `send` 入口报错。
|
|
1001
1049
|
>
|
|
1002
1050
|
> 从 0.23 升级:内存工具(`Agent.tool.adopt`)现在也支持 `async *execute` 流式输出,和文件工具一致;`Tool.from` 接受一组目录(字符串数组);取消错误统一带 `error.kind === 'aborted'`。
|
|
1051
|
+
>
|
|
1052
|
+
> 从 0.25 升级(破坏性改名):上下文预算 `maxTokens` 改名为 **`maxContextTokens`**;`maxTokens` 现在指**单次生成的最大输出** token(映射到请求体的 `maxOutputTokens`)。这是把名字拨回 OpenAI / Anthropic 的习惯(它们的 `max_tokens` 就是输出上限,不是上下文)。另外:`onPermission` 现在要求**严格返回布尔**——非 `true`(含对象、漏 `return`)一律按拒绝处理;新增 `Agent.tool.pick` / `Agent.tool.omit` 用来取工具子集(做只读模式用 `omit` 去掉写工具)。
|
|
1053
|
+
>
|
|
1054
|
+
> 从 0.27 升级:`Compact.run` 的返回值从总结文本变成 `{ content, usage }`(单独用 `Agent.compact` 时注意解构);`onCompact` 的流事件统一带 `request: 'compact'` 标记、`compact-finish` 带 `usage`;工具被拒绝/取消/无效调用也触发 `onToolResult`,`onStep` 的 `toolResults` 是完整结果对象;自动压缩的用量计进 `send().usage`;新增 `agent.resume()` 从历史末尾续跑;工具的 `schema[name]` 带来源标记 `source: 'file' | 'memory'`;文件工具(子进程路径)的 `execute(input, options)` 现在也能拿到 `options.abortSignal`(取消即杀进程不变,信号仅供工具优雅收尾)。
|
|
1003
1055
|
|
|
1004
1056
|
#### `Agent.tool.execute(options)`
|
|
1005
1057
|
|
|
@@ -1140,7 +1192,7 @@ History.turns(agent.history) // 折成回合:[[user], [assistant, tool], [us
|
|
|
1140
1192
|
| `maxToolConcurrency` | 不限制 | 默认不限文件工具并发:模型偶尔一轮返回几十个工具调用,会瞬间起几十个进程。设个上限,比如 `8`。 |
|
|
1141
1193
|
| `requestTimeout` | 不限制 | 默认不限单笔时长:卡住的请求会一直等下去。设毫秒数,到点中断这一笔。 |
|
|
1142
1194
|
| `retryMaxElapsed` | 不限制 | 默认重试所有错误且无总上限,等于无限重试。生产建议设毫秒数收口,或用 `retry` 过滤掉不该重试的错误(如 `auth`、`request`)。 |
|
|
1143
|
-
| `
|
|
1195
|
+
| `maxContextTokens` | `128000` | 上下文预算,要按你模型的窗口调。比窗口大会撑爆,比需求小会频繁压缩。 |
|
|
1144
1196
|
|
|
1145
1197
|
## 可观测性
|
|
1146
1198
|
|
|
@@ -1244,7 +1296,7 @@ const agent = Agent.create({ config: { /* ... */ }, tools })
|
|
|
1244
1296
|
|---|---|
|
|
1245
1297
|
| `Agent.version` | 包版本,排查问题时报得出来 |
|
|
1246
1298
|
| `Agent.create(...)` | 创建 Agent 实例 |
|
|
1247
|
-
| `Agent.tool` | `.from()` / `.scan()` / `.adopt()` / `.execute()` / `.merge()` |
|
|
1299
|
+
| `Agent.tool` | `.from()` / `.scan()` / `.adopt()` / `.execute()` / `.merge()` / `.pick()` / `.omit()` |
|
|
1248
1300
|
| `Agent.history` | `.user()` / `.assistant()` / `.tool()` / `.compact()` 造消息块;`.turns()` / `.render()` 读历史 |
|
|
1249
1301
|
| `Agent.context` | `.build()` |
|
|
1250
1302
|
| `Agent.compact` | `.run()` |
|
|
@@ -1316,7 +1368,7 @@ const agent = Agent.create({ config: { /* ... */ }, tools })
|
|
|
1316
1368
|
|
|
1317
1369
|
**Q:上下文太长会怎样?**
|
|
1318
1370
|
|
|
1319
|
-
上下文超过 `config.
|
|
1371
|
+
上下文超过 `config.maxContextTokens` 的 `compactThreshold`(默认 0.8,即 80%)时,Loop 会自动调用 Compact 把历史压缩成一段总结,然后继续运行。**默认就开着**:`maxContextTokens` 默认 `128000`,不配置也会在接近上限时自动压缩,避免把上下文撑爆。你的模型窗口比这小就把它调小;想彻底关掉设 `maxContextTokens: Infinity`。
|
|
1320
1372
|
|
|
1321
1373
|
**上下文 token 怎么估**:不装分词器,用"字符数 × 每字符多少 token"。这个比例是**会自校准**的——每轮模型都会回 `usage.inputTokens`(这次请求真实的输入 token 数),拿它反推这个模型真实的"每字符 token 比"记下来给下一轮。换模型(`config.compact` 的压缩模型、`send` 时覆盖 `model`、换 provider)就换一条记录,越用越准,也不怕分词器对不上模型。
|
|
1322
1374
|
|
|
@@ -1333,7 +1385,7 @@ config: {
|
|
|
1333
1385
|
|
|
1334
1386
|
不写 `compact` 就和主模型共用。自动压缩和手动 `agent.compact()` 用的都是这一套。
|
|
1335
1387
|
|
|
1336
|
-
> 用更小的小模型做压缩时注意:那笔压缩请求的**大小是由主模型的 `
|
|
1388
|
+
> 用更小的小模型做压缩时注意:那笔压缩请求的**大小是由主模型的 `maxContextTokens` 决定的**,跟压缩模型自己的窗口无关。如果压缩模型的窗口比主模型预算小,压缩请求会先在小模型这边撑爆。让压缩模型的窗口 ≥ 主模型预算,或把 `maxContextTokens` 调小。
|
|
1337
1389
|
|
|
1338
1390
|
**最新的那条总结会折进 `system`,而不是当成一条用户消息塞进对话里**,并且带一句"这是你自己之前做过的工作,数据已由工具确认"。裸的 `role:'user'` 总结会被模型读成"用户塞给我一张表",于是它从头重做整个任务——真实端点实测 `gpt-oss-120b` 改之前 1/6 能正确续跑,改之后 6/6。
|
|
1339
1391
|
|
package/dist/agent-core.d.ts
CHANGED
|
@@ -53,7 +53,8 @@ export interface Config {
|
|
|
53
53
|
mediaFallback?: 'error' | 'strip'
|
|
54
54
|
provider?: Record<string, any>
|
|
55
55
|
maxToolOutput?: number
|
|
56
|
-
maxTokens?: number
|
|
56
|
+
maxTokens?: number // 单次生成的最大输出 token,映射到请求体的 maxOutputTokens;不设=不限。provider.maxOutputTokens 显式设置时优先。
|
|
57
|
+
maxContextTokens?: number // 上下文预算;估算的上下文达到它的 compactThreshold 比例时自动压缩。默认 128000,设 Infinity 关闭自动压缩。
|
|
57
58
|
compactThreshold?: number
|
|
58
59
|
compact?: Partial<Config>
|
|
59
60
|
output?: any
|
|
@@ -103,18 +104,24 @@ export interface Callbacks {
|
|
|
103
104
|
onCompact?: (event: any) => void | Promise<void>
|
|
104
105
|
}
|
|
105
106
|
|
|
106
|
-
// --- 工具集合:scan / adopt / merge 都返回这个形状 ---
|
|
107
|
+
// --- 工具集合:scan / adopt / merge / pick / omit 都返回这个形状 ---
|
|
107
108
|
export interface ToolSet {
|
|
108
|
-
schema: Record<string, any>
|
|
109
|
-
handlers: Record<string, any>
|
|
109
|
+
schema: Record<string, { name?: string; description?: string; inputSchema?: any; [key: string]: any }>
|
|
110
|
+
handlers: Record<string, any> // 执行器内部形状,不要自己构造,原样传回 merge/pick/omit
|
|
110
111
|
}
|
|
111
112
|
|
|
113
|
+
// scan / adopt 会在每个工具的 schema 里盖上来源标记:file(目录扫描)/ memory(内存工具)。
|
|
114
|
+
// 应用判断"这个工具从哪来"读它,不要再靠工具名前缀猜(名字是应用拼的,拼法一变判断就失效)。
|
|
115
|
+
export type ToolSourceKind = 'file' | 'memory'
|
|
116
|
+
|
|
112
117
|
// 内存工具对象的形状(AI SDK tool() 产物、MCP client.tools() 的单项都符合这个形状)
|
|
113
118
|
export interface ToolLike {
|
|
114
119
|
name?: string // 数组形式必填;record 形式从键名取;单个对象直接传时也必填
|
|
115
120
|
description?: string
|
|
116
121
|
inputSchema?: any // 裸 JSON Schema / zod / AI SDK jsonSchema() 三种都认
|
|
117
122
|
execute: (input: any, options?: { signal?: AbortSignal; abortSignal?: AbortSignal }) => any | Promise<any>
|
|
123
|
+
// 两条路径的契约一致:内存工具和文件工具(子进程)的 execute 都拿得到第二参 { signal, abortSignal }。
|
|
124
|
+
// 注意:文件工具的"取消即杀进程"仍由包负责,signal 只是让工具能优雅收尾(比如通知孙进程清理)。
|
|
118
125
|
toModelOutput?: (options: { output: any; input?: any; toolCallId?: string }) => any
|
|
119
126
|
timeout?: number
|
|
120
127
|
[key: string]: any
|
|
@@ -146,6 +153,8 @@ export interface ToolModule {
|
|
|
146
153
|
concurrency?: number
|
|
147
154
|
}) => Promise<{ output: any; stop?: boolean; error?: string; interrupted?: boolean }>
|
|
148
155
|
merge: (...sets: ToolSet[]) => ToolSet
|
|
156
|
+
pick: (set: ToolSet, names: string[]) => ToolSet
|
|
157
|
+
omit: (set: ToolSet, names: string[]) => ToolSet
|
|
149
158
|
}
|
|
150
159
|
|
|
151
160
|
// --- 历史块 ---
|
|
@@ -218,6 +227,7 @@ export interface AgentInstance {
|
|
|
218
227
|
(input: string | any[], options?: Omit<SendOptions, 'input'>): Promise<Answer>
|
|
219
228
|
(options: SendOptions & { input: string | any[] }): Promise<Answer>
|
|
220
229
|
}
|
|
230
|
+
resume: (options?: Omit<SendOptions, 'input'>) => Promise<Answer> // 不发新消息,用现有历史末尾续跑(历史末尾须是 assistant/tool)
|
|
221
231
|
stop: () => Promise<{ ok: boolean }>
|
|
222
232
|
compact: (options?: { onCompact?: Callbacks['onCompact']; onRetry?: Callbacks['onRetry']; signal?: AbortSignal }) => Promise<string>
|
|
223
233
|
}
|