import type { SubAgentType } from "./sub-agent-types.js";

export declare const DEFAULT_TOOL_CATEGORY = "default";

export declare const SUB_AGENT_MANAGEMENT_TOOL_NAMES: Set<string>;

export declare const AGENT_IDENTITY_MCP_RESTRICTED_TOOLS: Set<string>;

export declare function isAgentIdentityRestrictedTool(tool: AllocatableToolShape): boolean;

export declare function mergeAllocatableTools<T extends {
    exposedName: string;
}>(base: readonly T[], extra: readonly T[]): T[];

export interface AllocatableToolShape {
    kind: "builtin" | "mcp";
    toolName: string;
    exposedName: string;
    
    serverName?: string;
    
    category?: string;
}

export declare function toolAllocationCategory(tool: AllocatableToolShape): string;

export declare function rebindDefaultAgentId<T extends AllocatableToolShape>(tools: readonly T[], agentId: string): T[];

export declare function toolAllocationAliases(tool: AllocatableToolShape): string[];

export declare function normalizeAllocationPattern(pattern: string): string;

export declare function matchesToolAllocation(tool: AllocatableToolShape, patterns: readonly string[]): boolean;

export interface ToolCatalogEntry {
    
    category: string;
    
    kind: "builtin" | "mcp";
    
    tools: string[];
}

export declare function buildToolCatalog(tools: readonly AllocatableToolShape[]): ToolCatalogEntry[];

export declare const EXPLORE_READONLY_DENIED_TOOLS: Set<string>;

export declare const SUB_AGENT_ALLOWED_MCP_TOOLS: Set<string>;

export declare const PRESET_EXPLORE = "explore";

export declare const PRESET_CORE = "core";

export declare const TYPE_LABEL_CUSTOM = "custom";

export declare class ToolAllocationError extends Error {
}

export declare function expandPreset(preset: SubAgentType, catalog: readonly ToolCatalogEntry[]): string[];

export interface ResolvedToolAllocation {
    
    patterns: string[];
    
    label: SubAgentType;
}

export declare function resolveToolAllocation(subagentType: SubAgentType, rawTools: readonly string[], catalog: readonly ToolCatalogEntry[]): ResolvedToolAllocation;