Skip to content

builtInToolAnnotations

builtInToolAnnotations(toolName): DeclaredToolAnnotations | undefined

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/core/approvals/toolAnnotationSources.ts:218

§4.7.1 — the builtIn half of a DeclaredToolAnnotationLookup: what WE say one of our own tools does.

Keyed off BUILT_IN_TOOL_ANNOTATIONS, our own authored table, and never off the bound tool list. The bound list is the merged set the graph is given, and it contains every MCP server’s tools; a builtIn lookup implemented over it would read a third-party declaration through the trusted-verbatim path — the same “a gate any server can opt itself out of” hole as routing an MCP call to a tool subject, arriving by a different door. §4.7.1 puts it more strongly still: what decides trust is who authored the annotation, so even a tool running in-process whose annotations we did not write does not take this path.

Returns a fresh object, so the table cannot be mutated through the lookup; undefined for anything not in it, which is fail-closed.

string

DeclaredToolAnnotations | undefined