跳转到内容
tansr 资料站

BuildSdkToolSetOptions

buildSdkToolSet 的输入:三环工具选择 + 能力位档 + 各内置工具所需材料(交互通道 / 平台材料 / 出网客户端 …)

属性

Section titled “属性”

allowedAuthEnvVars?

Section titled “allowedAuthEnvVars?”
optional allowedAuthEnvVars?: readonly string[];

Http 工具 auth 可引用的环境变量名单(托管档 = 配置段 http.allowedAuthEnvVars, assembleTooling 以 httpAllowlistForTool(loaded.http) 展开传入,与 HookEngine allowedHeaderEnvVars 同一键)。缺席 = 不限(令牌 / 注入档无本地配置来源;hard-safety 兜底)。

capabilities?

Section titled “capabilities?”
optional capabilities?: AppCapabilities;

能力位档;缺省 DEFAULT_APP_CAPABILITIES(令牌档由 bundle 供给)

egress?

Section titled “egress?”
optional egress?: EgressClient;

出网客户端(三层 SSRF × 代理复合;WebFetch / Http 同经此出网)。缺省进程级 共享实例(sdkEgressClient);宿主 / 测试可注入。

imageInput?

Section titled “imageInput?”
optional imageInput?: () => InputModalityMode | undefined;

Read 图片分支的模型能力谓词(kernel 门 2)。装配层把当前会话 模型的 imageInputMode 以 getter 注入(setModel 热切换即时生效;取值在工具执行时点); 缺席 = 未接线 = Read 图片径 fail-closed 恒拒并如实说明「capability: unknown」。

返回

Section titled “返回”

InputModalityMode | undefined

onWarning?

Section titled “onWarning?”
optional onWarning?: (warning) => void;

装配期告警回调(通用告警通道,createSession 注入 warn):目前只出 tools_platform_deprecated(tools.platform 兼容别名弃用提示,每次装配一条, detail.names = 别名里的媒体名)。缺席 = 静默(低阶 runAgent / query 径无通道)。

参数

Section titled “参数”
warning
Section titled “warning”

SdkWarning

返回

Section titled “返回”

void

platformContext?

Section titled “platformContext?”
optional platformContext?: PlatformToolContext;

平台通道材料(令牌档注入;缺席 = 显式选择媒体四名即 fail-fast 指引令牌档)

promptChannel?

Section titled “promptChannel?”
optional promptChannel?: PromptChannel;

AskUser 交互通道;缺省 UnavailableChannel(结构化降级,不挂起)

store?

Section titled “store?”
optional store?: TodoStore;

TodoWrite 台账;缺省自建(会话级内存态);onChange 由 session 装配注入

tools?

Section titled “tools?”
optional tools?: SdkToolsOptions;

三环工具入口;缺席 = 只装能力位放行的内置工具