@aalis/api-tools 0.11.0 → 0.12.1
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/dist/index.d.ts +56 -34
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/package.json +5 -5
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import type { CapabilityConfirm, CapabilityRisk, CapabilityVisibility, ExecutionGuard, InboundTurn } from '@aalis/api-authority';
|
|
1
|
+
import type { CapabilityConfirm, CapabilityRisk, CapabilityVisibility, ExecutionGuard, InboundTurn, UserIdentity, Verdict } from '@aalis/api-authority';
|
|
2
|
+
import type { TextRef } from '@aalis/schema-i18n';
|
|
2
3
|
export interface ToolFunction {
|
|
3
4
|
name: string;
|
|
4
5
|
strict?: boolean;
|
|
@@ -16,33 +17,28 @@ export interface ToolDefinition {
|
|
|
16
17
|
}
|
|
17
18
|
export interface ToolCallContext {
|
|
18
19
|
sessionId: string;
|
|
19
|
-
/**
|
|
20
|
+
/**
|
|
21
|
+
* 物理发言者（会话语义）：这一轮各条输入的发言者相同时是他，不同时没有；续做的一轮没有发言者时取起它的那一轮的（工具眼里
|
|
22
|
+
* 是起它的人在调）。授权身份见 participants
|
|
23
|
+
*/
|
|
20
24
|
userId?: string;
|
|
21
|
-
/** 会话所属平台（路由/分流语义；授权身份见
|
|
25
|
+
/** 会话所属平台（路由/分流语义；授权身份见 participants） */
|
|
22
26
|
platform?: string;
|
|
23
27
|
/**
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* 否则 actor 与会话不在同一平台时（如以 webui 身份发往 QQ 群的定时任务、WebUI 会话里
|
|
28
|
-
* 经 workflow_run 调起、节点投向 onebot 会话的 workflow）会把定时任务归属、平台档继承、
|
|
29
|
-
* 记忆平台域全部路由到发起者平台。
|
|
30
|
-
* 缺省 = 授权身份就是 (platform, userId) 本身。
|
|
28
|
+
* 这一轮的参与者（授权身份，与 platform/userId 解耦）：agent 按 api-authority 的 originTurnOf 算，权限守卫对每个参与者各
|
|
29
|
+
* 裁决一次。不在入站回合里的调用方填它自己的身份（编排的运行身份、mcp-server 的客户端），没有身份的填一个无主体
|
|
30
|
+
* （账号为空串）。经审批放行的调用，交给处理函数的上下文里参与者换成批的人。要记一个人的取 {@link actingIdentity}
|
|
31
31
|
*/
|
|
32
|
-
|
|
33
|
-
platform: string;
|
|
34
|
-
userId: string;
|
|
35
|
-
};
|
|
32
|
+
participants: readonly UserIdentity[];
|
|
36
33
|
/** 当前平台启用的工具分组（供 search_tools 等工具过滤用） */
|
|
37
34
|
enabledGroups?: string[];
|
|
38
35
|
/**
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
* 退回文字结果，而不是交出一份只剩说明文字的空壳。
|
|
36
|
+
* 这次调用的主模型能亲眼看图（agent 按模型服务登记的能力填）。不能看时能出图的工具退回文字结果，调用方也不把
|
|
37
|
+
* {@link ToolExecutionResult.images} 交给模型；缺省 false：mcp-server / workflow 等只读 content 的调用方拿不到图。
|
|
42
38
|
*/
|
|
43
39
|
acceptsImages?: boolean;
|
|
44
40
|
/**
|
|
45
|
-
* 中止信号。调用方传回合的（agent
|
|
41
|
+
* 中止信号。调用方传回合的（agent 工具循环传入）：守卫等审批期间回合被停下（停止键、禁言、停机等）时，
|
|
46
42
|
* 审批撤销、工具服务据此放弃执行。缺省 = 不可中止。
|
|
47
43
|
* 可转后台的工具（{@link RegisteredTool.background}）拿到的是执行器给这次调用的信号：在前台时随回合一并中止，
|
|
48
44
|
* 转到后台之后只随停止、工具撤回登记与执行器停用中止。
|
|
@@ -61,12 +57,31 @@ export interface ToolCallContext {
|
|
|
61
57
|
*/
|
|
62
58
|
callId?: string;
|
|
63
59
|
/**
|
|
64
|
-
*
|
|
65
|
-
*
|
|
66
|
-
*
|
|
60
|
+
* 执行中的输出口，执行器给每次调用一份，调用方不填。在入站回合里（inbound 在）且有 turnId 与 callId 时转成
|
|
61
|
+
* `tool:output` 推给界面；可转后台的调用另留进这次调用的输出缓冲（只留末尾），后台任务的最后一行、最后输出时间与
|
|
62
|
+
* 取输出都取它。工具结果照旧在调用结束时一次给出
|
|
67
63
|
*/
|
|
68
64
|
output?: (text: string) => void;
|
|
65
|
+
/**
|
|
66
|
+
* 取用判定，执行器给每次调用一份。取别的会话的东西、不属于任何会话的本机文件时用：check 判「只有这一位参与者时能不能取」，
|
|
67
|
+
* 执行器按这次调用的参与者交给权限守卫，与等级裁决同一条三分：都过放行；有人过不了时发一道参与者审批，能批的是过得了的人，
|
|
68
|
+
* 事实是这次调用的工具与参数；都过不了回原因（一位参与者时是它的，几位时是第一位的）。守卫不在、调用不在回合里或已转到后台
|
|
69
|
+
* （要求立即转后台的从一开始）时只按参与者都过判、不出审批：可转后台的工具等审批时不转后台。审批随 signal 撤销。批过只放行
|
|
70
|
+
* 这一次取用，不换这次调用的参与者。check 要同步、不抛错
|
|
71
|
+
*/
|
|
72
|
+
approveFor(check: (who: UserIdentity) => Verdict): Promise<Verdict>;
|
|
69
73
|
}
|
|
74
|
+
/** 调用方交给执行器的上下文（{@link ToolService.execute}、agent 的工具钩子）：取用判定 approveFor 由执行器给每次调用一份 */
|
|
75
|
+
export type ToolCallRequest = Omit<ToolCallContext, 'approveFor'>;
|
|
76
|
+
/**
|
|
77
|
+
* 要记一个人时这次调用的授权身份（定时任务的创建者、编排的调用者，以及不挂审批的取别的会话的东西）：参与者
|
|
78
|
+
* 只有一个时是他，有几个（或没有）时是无主体，账号为空串，与 schema-message 的 selfInitiatedActor 同形（本包不依赖
|
|
79
|
+
* schema-message，照写一份）。批过的调用参与者已换成批的人，记的就是批的人
|
|
80
|
+
*/
|
|
81
|
+
export declare function actingIdentity(ctx: {
|
|
82
|
+
platform?: string;
|
|
83
|
+
participants: readonly UserIdentity[];
|
|
84
|
+
}): UserIdentity;
|
|
70
85
|
/** 工具调用状态通知（WebUI 等前端订阅展示用）。只由 agent 工具循环发出，开始与结束按 callId 配对 */
|
|
71
86
|
export interface ToolExecuteMessage {
|
|
72
87
|
sessionId: string;
|
|
@@ -173,13 +188,18 @@ export interface ToolSummary {
|
|
|
173
188
|
description: string;
|
|
174
189
|
groups?: string[];
|
|
175
190
|
}
|
|
176
|
-
/**
|
|
191
|
+
/**
|
|
192
|
+
* 工具分组信息。给人看的 label、summary 可以是文字对象（@aalis/schema-i18n），出口按读者语言渲染；label 也进能力目录给模型，
|
|
193
|
+
* 那一侧取 toSource
|
|
194
|
+
*/
|
|
177
195
|
export interface ToolGroupInfo {
|
|
178
196
|
/** 分组标识（如 'system'、'onebot'、'search'） */
|
|
179
197
|
name: string;
|
|
180
198
|
/** 显示名称（如 '系统工具'、'OneBot 工具'） */
|
|
181
|
-
label: string;
|
|
182
|
-
/**
|
|
199
|
+
label: string | TextRef;
|
|
200
|
+
/** 给人看的一句概述（WebUI 的分组选项）；没有时界面不显示概述 */
|
|
201
|
+
summary?: string | TextRef;
|
|
202
|
+
/** 分组描述：只给模型（能力目录与工具搜索），不进界面 */
|
|
183
203
|
description?: string;
|
|
184
204
|
/** 注册该分组的插件 */
|
|
185
205
|
pluginName: string;
|
|
@@ -212,12 +232,17 @@ export interface ToolService {
|
|
|
212
232
|
visibility: CapabilityVisibility;
|
|
213
233
|
/** 生效确认要求（轴 B）；缺省=不确认 */
|
|
214
234
|
confirm?: CapabilityConfirm;
|
|
215
|
-
/** 原始风险声明（透传，供 authority
|
|
235
|
+
/** 原始风险声明（透传，供 authority 派生最低等级：safe 0、sensitive 1、dangerous 2） */
|
|
216
236
|
risk?: CapabilityRisk;
|
|
217
237
|
groups?: string[];
|
|
218
238
|
display?: ToolDisplay;
|
|
219
239
|
}>;
|
|
220
|
-
execute(toolName: string, args: Record<string, unknown>, callCtx:
|
|
240
|
+
execute(toolName: string, args: Record<string, unknown>, callCtx: ToolCallRequest): Promise<ToolExecutionResult>;
|
|
241
|
+
/**
|
|
242
|
+
* 这个会话启用的工具分组（会话设置「工具分组」的生效值，`'*'` 为全部分组）；platform 是入口平台，只对没有出生平台的会话
|
|
243
|
+
* 起作用。空列表即只给不属于任何分组的工具
|
|
244
|
+
*/
|
|
245
|
+
sessionGroups(sessionId: string, platform?: string): string[];
|
|
221
246
|
/** 注入执行守卫，用于能力裁决与确认；传 undefined 摘掉，需要更高等级或确认的工具退回 fail-closed */
|
|
222
247
|
setExecutionGuard(guard: ExecutionGuard | undefined): void;
|
|
223
248
|
/** 注册工具分组 */
|
|
@@ -270,8 +295,11 @@ export interface BackgroundTask {
|
|
|
270
295
|
lastLine?: string;
|
|
271
296
|
/** 最后一次有输出的时刻 */
|
|
272
297
|
lastOutputAt?: number;
|
|
273
|
-
/**
|
|
274
|
-
|
|
298
|
+
/**
|
|
299
|
+
* 失败或中断的一句原因：失败的取自结果里的 error（原文字符串），中断的是宿主写的文字对象（出口按读者语言渲染）。
|
|
300
|
+
* 交给模型的取 toSource
|
|
301
|
+
*/
|
|
302
|
+
reason?: string | TextRef;
|
|
275
303
|
/** 命令的退出码：工具声明了 command 种类的展示、结束时从结果里取得到才有；随登记落盘 */
|
|
276
304
|
exitCode?: number;
|
|
277
305
|
/** 结束的任务：工具的结果。不落盘，Aalis 重启前结束的没有 */
|
|
@@ -330,10 +358,4 @@ export interface BoundTools extends ToolService {
|
|
|
330
358
|
/** 给一份 tools 绑定接口加默认分组：经它登记的工具自动带上这些分组（一组工具共用分组时用） */
|
|
331
359
|
export declare function withToolGroups(bound: BoundTools, groups: string[]): BoundTools;
|
|
332
360
|
export declare const tools: import("@aalis/core").ServiceDescriptor<ToolService, BoundTools>;
|
|
333
|
-
declare module '@aalis/api-session-manager' {
|
|
334
|
-
interface SessionConfig {
|
|
335
|
-
/** 启用的工具分组，`'*'` 为全部分组；没设置或为空时只给不属于任何分组的工具 */
|
|
336
|
-
enabledToolGroups?: string[];
|
|
337
|
-
}
|
|
338
|
-
}
|
|
339
361
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,WAAW,EACZ,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// 本包提供工具系统的全部"非实现"契约：
|
|
4
4
|
// - LLM 函数声明协议类型（ToolDefinition / ToolFunction）
|
|
5
5
|
// - 工具/分组数据结构（RegisteredTool / ToolGroupInfo / ToolSummary），可转后台的执行器参数名（takenBackgroundParams）
|
|
6
|
-
// - 工具调用上下文（ToolCallContext）——
|
|
6
|
+
// - 工具调用上下文（ToolCallContext，调用方交的是 ToolCallRequest）—— 平台/会话语义与这一轮的参与者，actingIdentity
|
|
7
7
|
// - 工具执行通知（ToolExecuteMessage）与执行中的流式输出（ToolOutputMessage）
|
|
8
8
|
// - 工具结果的结局（toolFailed、integerIn）
|
|
9
9
|
// - 服务接口（ToolService）
|
|
@@ -16,6 +16,14 @@
|
|
|
16
16
|
//
|
|
17
17
|
// 实现见 @aalis/plugin-tools。
|
|
18
18
|
import { defineService } from '@aalis/core';
|
|
19
|
+
/**
|
|
20
|
+
* 要记一个人时这次调用的授权身份（定时任务的创建者、编排的调用者，以及不挂审批的取别的会话的东西）：参与者
|
|
21
|
+
* 只有一个时是他，有几个（或没有）时是无主体，账号为空串，与 schema-message 的 selfInitiatedActor 同形（本包不依赖
|
|
22
|
+
* schema-message，照写一份）。批过的调用参与者已换成批的人，记的就是批的人
|
|
23
|
+
*/
|
|
24
|
+
export function actingIdentity(ctx) {
|
|
25
|
+
return ctx.participants.length === 1 ? ctx.participants[0] : { platform: ctx.platform ?? '', userId: '' };
|
|
26
|
+
}
|
|
19
27
|
/** 执行器给可转后台的工具补的两项参数 */
|
|
20
28
|
const BACKGROUND_PARAMS = ['runInBackground', 'waitSeconds'];
|
|
21
29
|
/**
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,sBAAsB;AACtB,gDAAgD;AAChD,+FAA+F;AAC/F,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aalis/api-tools",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -19,16 +19,16 @@
|
|
|
19
19
|
"dist"
|
|
20
20
|
],
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@aalis/api-authority": ">=0.
|
|
23
|
-
"@aalis/
|
|
22
|
+
"@aalis/api-authority": ">=0.12.0 <1.0.0",
|
|
23
|
+
"@aalis/schema-i18n": ">=0.1.0 <1.0.0"
|
|
24
24
|
},
|
|
25
25
|
"devDependencies": {
|
|
26
26
|
"@types/node": "^22.0.0",
|
|
27
27
|
"typescript": "^5.7.0",
|
|
28
|
-
"@aalis/core": "0.
|
|
28
|
+
"@aalis/core": "0.21.0"
|
|
29
29
|
},
|
|
30
30
|
"peerDependencies": {
|
|
31
|
-
"@aalis/core": ">=0.
|
|
31
|
+
"@aalis/core": ">=0.21.0 <1.0.0"
|
|
32
32
|
},
|
|
33
33
|
"keywords": [
|
|
34
34
|
"aalis",
|