Function buildModelToolSurfaceInventory

src/surfaceInventory.ts:143–189

(
  tools: readonly ToolLike[],
  syntheticOutputToolName: string,
)

}

export function buildModelToolSurfaceInventory(
  tools: readonly ToolLike[],
  syntheticOutputToolName: string,
): ModelToolSurfaceEntry[] {
  const entries = new Map<string, ModelToolSurfaceEntry>()

  for (const tool of tools) {
    entries.set(tool.name, toModelToolSurfaceEntry(tool))
  }

  entries.set(syntheticOutputToolName, {
    name: syntheticOutputToolName,
    aliases: [],
    kind: 'synthetic_tool',
    source: 'dynamic',
    policyTier: getToolPolicy('SyntheticOutput')?.tier ?? null,
    internalBuildOnly: false,
    notes:
      'Structured-output pseudo-tool synthesized when noninteractive JSON output is requested.',
  })

  entries.set('mcp__<server>__authenticate', {
    name: 'mcp__<server>__authenticate',
    aliases: [],
    kind: 'dynamic_tool_family',
    source: 'dynamic',
    policyTier: null,
    internalBuildOnly: false,
    notes: 'Dynamic MCP auth pseudo-tool family.',
  })

  for (const name of ALLOWED_IDE_TOOLS) {
    if (!entries.has(name)) {
      entries.set(name, {
        name,
        aliases: [],
        kind: 'dynamic_tool_family',
        source: 'dynamic',
        policyTier: null,
        internalBuildOnly: false,
        notes: 'Dynamic IDE MCP tool allowlisted by the NCode MCP client.',
      })
    }
  }

  return sortByName([...entries.values()])
}

export function buildCommandSurfaceInventory(
  commands: readonly CommandLike[],