import { type Token } from '@frontmcp/di';
import { type AgentToolDefinition, type ParsedToolResult, type ToolEntry, type ToolMetadata, type ToolRecord, type ToolType } from '../common';
export declare function collectToolMetadata(cls: ToolType): ToolMetadata;
export declare function normalizeTool(item: any): ToolRecord;
/**
 * For graph/cycle detection. Returns dependency tokens that should be graphed.
 * - FUNCTION: get function params without the first argument (the tool input)
 * - CLASS_TOKEN: deps come from the class constructor
 */
export declare function toolDiscoveryDeps(rec: ToolRecord): Token[];
export declare function buildParsedToolResult(descriptor: any, raw: unknown): ParsedToolResult;
/**
 * Build agent tool definitions from tool entries.
 *
 * Converts `ToolEntry[]` to `AgentToolDefinition[]` format suitable for
 * passing to an LLM adapter. This is a simpler format than full MCP Tool
 * definitions, containing only the information needed by the LLM.
 *
 * @param tools - Array of tool entries from the tool registry
 * @returns Array of agent tool definitions
 *
 * @example
 * ```typescript
 * const tools = scope.tools.getTools(true);
 * const definitions = buildAgentToolDefinitions(tools);
 * ```
 */
export declare function buildAgentToolDefinitions(tools: ToolEntry[]): AgentToolDefinition[];
//# sourceMappingURL=tool.utils.d.ts.map