コンテンツにスキップ
tansr 资料站

AssembleToolingOptions

このコンテンツはまだ日本語訳がありません。

assembleTooling 的选项:cwd / 会话归属 / 配置 + 工具、能力位、skills、MCP、权限与裁决人材料

属性

Section titled “属性”

adjudication?

Section titled “adjudication?”
optional adjudication?: AssembleToolingAdjudication;

裁决人:kernel 分类器配置 + 生效姿态 + 生效资格档(assembleBundleAdjudicator 产物三件,治理旋钮已叠加)。 在场即 PermissionEngine({ mode: modeUnderAdjudicator({ posture, tier }), classifier })——模式由 kernel 单点推导(无人环姿态 × tier none 不切 auto,维持 default;其余 auto):「本应 ask」的调用经裁决人终裁 (判危险按 rejectEffect 落 ask/deny,判安全且资格半径覆盖 → allow);与 permission.mode 同现 fail-fast。 缺席 = 现状(无分类器路径,模式沿 permission.mode / 配置缺省)。

capabilities?

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

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

cwd

Section titled “cwd”
cwd: string;

权限规则路径锚定与工具执行 cwd(两者必须一致)

egress?

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

出网客户端(三层 SSRF 防护 × 代理复合)——WebFetch / Http 与托管档 hooks http 执行体同经此出网。 缺省进程级共享实例(sdkEgressClient);宿主 / 测试可注入。

emit?

Section titled “emit?”
optional emit?: (body, source) => void;

装配层合成事件出口(hook 可观测事件 / todo 台账变更)。createSession 接会话队列(重打包络入流);单轮 query 托管档省略——合成事件丢弃, gate 决策语义不受影响(hooks 仍参与决策,仅损失 hook.* 可观测事件)。

参数

Section titled “参数”
body
Section titled “body”

EventBody

source
Section titled “source”

string

返回

Section titled “返回”

void

imageInput?

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

Read 工具图片分支的模型能力谓词。createSession / query 以会话当前模型的 imageInputMode 绑 getter (setModel 热切换即时生效);缺席 = 未接线 = 图片径 fail-closed 恒拒并如实说明未接线。

返回

Section titled “返回”

InputModalityMode | undefined

loaded

Section titled “loaded”
loaded: LoadedConfig | null;

五层配置(permissions/hooks 段来源);注入档无配置为 null(hooks 不装)

mcp?

Section titled “mcp?”
optional mcp?: McpSessionOption;

MCP 外接(host 实例 = 应用级共享,选项对象 = 会话级临时 host)

onDecision?

Section titled “onDecision?”
optional onDecision?: (record) => void;

每次经门终局的审计记录出口(kernel 执行器 onDecision 缝;ToolDecisionRecord 与 cli decisions.jsonl 行同形,含机器放行 classifier / mode)。缺省实现:source === 'classifier' 的记录经 warn 通报 permission_decided(平台源;令牌档无本地盘,事件流已由 kernel 门面 decided{allow} 帧覆盖,本缝是 开发者审计半边);传自己的写入器即接管;传 () => {} 即静默。

参数

Section titled “参数”
record
Section titled “record”

ToolDecisionRecord

返回

Section titled “返回”

void

onRollback?

Section titled “onRollback?”
optional onRollback?: (resources, cause) => never;

私有所有权移交：query在回滚开始接管资源及统一观察预算；session保留缺省回滚。

参数

Section titled “参数”
resources
Section titled “resources”

OwnedResources

cause
Section titled “cause”

unknown

返回

Section titled “返回”

never

permission?

Section titled “permission?”
optional permission?: PermissionOptions;

platformContext?

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

环3 平台工具材料(令牌档由 createSession/query 注入,其余档恒缺席)

promptChannel?

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

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

sessionId

Section titled “sessionId”
sessionId: string;

hooks 引擎的会话归属

skills?

Section titled “skills?”
optional skills?: SdkSkillsOptions;

skills 注入(受 skills 能力位——位关而材料在场 fail-fast)

tools?

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

三环工具入口(内置 / 自定义 / 平台;缺席 = 装配能力位放行的全部内置工具)

warn?

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

告警通道(createSession 注入;装配期非致命提示如 tools_platform_deprecated 经此出;缺席静默)

参数

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

SdkWarning

返回

Section titled “返回”

void