Function buildToolInventory

src/tools/toolInventory.ts:87–134

({
  baseTools,
  enabledTools,
  replPrimitiveTools,
}: ToolInventoryInputs)

}

export function buildToolInventory({
  baseTools,
  enabledTools,
  replPrimitiveTools,
}: ToolInventoryInputs): ToolInventoryEntry[] {
  const baseByName = new Map(baseTools.map(tool => [tool.name, tool]))
  const enabledByName = new Map(enabledTools.map(tool => [tool.name, tool]))
  const replByName = new Map(replPrimitiveTools.map(tool => [tool.name, tool]))

  const toolNames = sortToolNames([
    ...Object.keys(TOOL_POLICY_BY_NAME),
    ...baseByName.keys(),
    ...enabledByName.keys(),
    ...replByName.keys(),
  ])

  return toolNames.map(name => {
    const policy = getToolPolicy(name)
    const baseTool = baseByName.get(name)
    const enabledTool = enabledByName.get(name)
    const replTool = replByName.get(name)
    const tool = enabledTool ?? baseTool ?? replTool
    const turnOneOrDeferred: ToolAdvertisedSurface =
      enabledTool === undefined
        ? 'not_exposed'
        : isDeferredTool(enabledTool)
          ? 'deferred'
          : 'turn_one'

    return {
      name,
      tier: policy?.tier ?? null,
      rationale: policy?.rationale ?? null,
      policyDefined: policy !== undefined,
      compiled: baseTool !== undefined || replTool !== undefined,
      baseRegistered: baseTool !== undefined,
      enabled: enabledTool !== undefined,
      turnOneOrDeferred,
      replExposed: replTool !== undefined,
      shouldDefer: tool?.shouldDefer === true,
      alwaysLoad: tool?.alwaysLoad === true,
      isMcp: tool?.isMcp === true,
      aliases: tool?.aliases ?? [],
      searchHint: tool?.searchHint ?? null,
      userFacingName: resolveUserFacingName(tool),
    }
  })
}

export function collectToolInventory(
  permissionContext: ToolPermissionContext = getEmptyToolPermissionContext(),