@compass-ai/nova 1.0.73 → 1.0.74

package/dist/utils/token-counter.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Token counting utilities for API usage calculation.
+ * Uses the official Anthropic tokenizer for accurate token counts.
+ */
+/**
+ * Counts the exact number of tokens in a string using the official Anthropic tokenizer.
+ * This provides accurate token counts that match what the Claude API will use.
+ *
+ * @param text - The text to count tokens for
+ * @returns Exact token count
+ *
+ * @example
+ * ```typescript
+ * estimateTokens("Hello, world!"); // Exact count
+ * estimateTokens("function foo() { return 42; }"); // Exact count
+ * ```
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Counts tokens for a conversation message array.
+ * Accounts for message structure overhead in addition to content tokens.
+ *
+ * @param messages - Array of conversation messages with role and content
+ * @returns Exact total token count for the conversation
+ *
+ * @example
+ * ```typescript
+ * const messages = [
+ *   { role: 'user', content: 'Hello!' },
+ *   { role: 'assistant', content: 'Hi there! How can I help?' }
+ * ];
+ * estimateConversationTokens(messages); // Exact count
+ * ```
+ */
+export declare function estimateConversationTokens(messages: Array<{
+    role: string;
+    content: string;
+}>): number;
+/**
+ * Counts tokens for a system prompt.
+ * System prompts have additional overhead for their special role.
+ *
+ * @param systemPrompt - The system prompt text
+ * @returns Exact token count including overhead
+ *
+ * @example
+ * ```typescript
+ * estimateSystemPromptTokens("You are a helpful assistant."); // Exact count
+ * ```
+ */
+export declare function estimateSystemPromptTokens(systemPrompt: string): number;
+/**
+ * Calculates remaining tokens available in the context window.
+ *
+ * @param contextWindow - Total context window size in tokens
+ * @param usedTokens - Tokens already used
+ * @param reservedForOutput - Tokens reserved for model output (default: 8192)
+ * @returns Number of tokens remaining for new input
+ *
+ * @example
+ * ```typescript
+ * calculateRemainingTokens(200000, 50000, 8192); // 141808
+ * ```
+ */
+export declare function calculateRemainingTokens(contextWindow: number, usedTokens: number, reservedForOutput?: number): number;
+/**
+ * Checks if adding new content would exceed the context window.
+ *
+ * @param contextWindow - Total context window size in tokens
+ * @param currentTokens - Tokens currently used
+ * @param newContentTokens - Tokens in the new content to add
+ * @param reservedForOutput - Tokens reserved for model output (default: 8192)
+ * @returns True if adding the content would exceed the context window
+ *
+ * @example
+ * ```typescript
+ * wouldExceedContext(200000, 190000, 5000, 8192); // true
+ * wouldExceedContext(200000, 100000, 5000, 8192); // false
+ * ```
+ */
+export declare function wouldExceedContext(contextWindow: number, currentTokens: number, newContentTokens: number, reservedForOutput?: number): boolean;
+/**
+ * Formats a token count for display with appropriate suffix (K, M).
+ * Uses compact notation for large numbers.
+ *
+ * @param tokens - Number of tokens to format
+ * @returns Formatted string (e.g., "1.5K", "2.3M", "500")
+ *
+ * @example
+ * ```typescript
+ * formatTokenCount(500); // "500"
+ * formatTokenCount(1500); // "1.5K"
+ * formatTokenCount(1500000); // "1.50M"
+ * ```
+ */
+export declare function formatTokenCount(tokens: number): string;
+/**
+ * Calculates the percentage of context window used.
+ *
+ * @param usedTokens - Number of tokens used
+ * @param contextWindow - Total context window size
+ * @returns Usage percentage (0-100), rounded to nearest integer
+ *
+ * @example
+ * ```typescript
+ * calculateContextUsagePercent(50000, 200000); // 25
+ * calculateContextUsagePercent(180000, 200000); // 90
+ * ```
+ */
+export declare function calculateContextUsagePercent(usedTokens: number, contextWindow: number): number;
+/**
+ * Gets a color indicator based on context usage percentage.
+ * Used for visual feedback in the UI.
+ *
+ * @param percent - Usage percentage (0-100)
+ * @returns Color name: 'green' (<50%), 'yellow' (50-80%), 'red' (>80%)
+ *
+ * @example
+ * ```typescript
+ * getContextUsageColor(30); // 'green'
+ * getContextUsageColor(65); // 'yellow'
+ * getContextUsageColor(85); // 'red'
+ * ```
+ */
+export declare function getContextUsageColor(percent: number): 'green' | 'yellow' | 'red';
+/**
+ * Counts the exact number of tokens in code content using the official Anthropic tokenizer.
+ *
+ * @param code - The code string to count
+ * @param language - Optional language hint (not used, kept for API compatibility)
+ * @returns Exact token count
+ *
+ * @example
+ * ```typescript
+ * estimateCodeTokens("const x = 42;"); // Exact count
+ * estimateCodeTokens("function foo() {\n  return bar;\n}"); // Exact count
+ * ```
+ */
+export declare function estimateCodeTokens(code: string, _language?: string): number;
+/**
+ * Counts the exact token count for a file with its path.
+ * Includes overhead for file path and code block markers.
+ *
+ * @param filePath - The file path
+ * @param content - The file content
+ * @returns Exact total tokens including overhead
+ *
+ * @example
+ * ```typescript
+ * estimateFileTokens("src/index.ts", "export const foo = 42;"); // Exact count
+ * ```
+ */
+export declare function estimateFileTokens(filePath: string, content: string): number;
+/**
+ * Truncates text to fit within a token budget.
+ * Attempts to truncate at word boundaries when possible.
+ *
+ * @param text - The text to truncate
+ * @param maxTokens - Maximum tokens allowed
+ * @param suffix - Suffix to append when truncated (default: "...")
+ * @returns Truncated text that fits within the token budget
+ *
+ * @example
+ * ```typescript
+ * truncateToTokenLimit("This is a long text...", 5); // "This is..."
+ * ```
+ */
+export declare function truncateToTokenLimit(text: string, maxTokens: number, suffix?: string): string;
+/**
+ * Breakdown of context usage by category.
+ * Used for detailed context window analysis.
+ */
+export interface ContextBreakdown {
+    /** Tokens used by the system prompt */
+    systemPrompt: number;
+    /** Tokens used by conversation history */
+    conversationHistory: number;
+    /** Tokens used by file context */
+    fileContext: number;
+    /** Tokens reserved for output */
+    reservedForOutput: number;
+    /** Any other tokens not categorized */
+    other: number;
+}
+/**
+ * Calculates the total tokens from a context breakdown.
+ *
+ * @param breakdown - The context breakdown object
+ * @returns Total tokens used (excluding reserved)
+ *
+ * @example
+ * ```typescript
+ * const breakdown = {
+ *   systemPrompt: 500,
+ *   conversationHistory: 10000,
+ *   fileContext: 5000,
+ *   reservedForOutput: 8192,
+ *   other: 100
+ * };
+ * calculateBreakdownTotal(breakdown); // 15600
+ * ```
+ */
+export declare function calculateBreakdownTotal(breakdown: ContextBreakdown): number;
+/**
+ * Checks if a context breakdown is within acceptable limits.
+ *
+ * @param breakdown - The context breakdown
+ * @param contextWindow - Total context window size
+ * @param warningThreshold - Percentage threshold for warning (default: 80)
+ * @returns Object with status and details
+ *
+ * @example
+ * ```typescript
+ * const result = checkContextHealth(breakdown, 200000);
+ * // { healthy: true, usagePercent: 45, warning: null }
+ * ```
+ */
+export declare function checkContextHealth(breakdown: ContextBreakdown, contextWindow: number, warningThreshold?: number): {
+    healthy: boolean;
+    usagePercent: number;
+    warning: string | null;
+    availableTokens: number;
+};
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/utils/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,MAAM,CAmBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,iBAAiB,GAAE,MAAa,GAC/B,MAAM,CAER;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,GAAE,MAAa,GAC/B,OAAO,CAET;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAKR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAQhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAc,GACrB,MAAM,CA6BR;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAO3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,MAAM,EACrB,gBAAgB,GAAE,MAAW,GAC5B;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,CA0BA"}

package/dist/utils/token-counter.js

@@ -0,0 +1,332 @@
+/**
+ * Token counting utilities for API usage calculation.
+ * Uses the official Anthropic tokenizer for accurate token counts.
+ */
+import { countTokens } from '@anthropic-ai/tokenizer';
+/**
+ * Average characters per token for English text (used for fallback estimation only).
+ * Claude uses a BPE tokenizer similar to GPT models, averaging ~4 chars/token.
+ */
+const CHARS_PER_TOKEN = 4;
+/**
+ * Overhead tokens per message for role markers and structure.
+ */
+const MESSAGE_OVERHEAD_TOKENS = 4;
+/**
+ * Base overhead for conversation structure.
+ */
+const CONVERSATION_OVERHEAD_TOKENS = 3;
+/**
+ * Counts the exact number of tokens in a string using the official Anthropic tokenizer.
+ * This provides accurate token counts that match what the Claude API will use.
+ *
+ * @param text - The text to count tokens for
+ * @returns Exact token count
+ *
+ * @example
+ * ```typescript
+ * estimateTokens("Hello, world!"); // Exact count
+ * estimateTokens("function foo() { return 42; }"); // Exact count
+ * ```
+ */
+export function estimateTokens(text) {
+    if (!text || text.length === 0) {
+        return 0;
+    }
+    try {
+        return countTokens(text);
+    }
+    catch (error) {
+        // Fallback to character-based estimation if tokenizer fails
+        return Math.ceil(text.length / CHARS_PER_TOKEN);
+    }
+}
+/**
+ * Counts tokens for a conversation message array.
+ * Accounts for message structure overhead in addition to content tokens.
+ *
+ * @param messages - Array of conversation messages with role and content
+ * @returns Exact total token count for the conversation
+ *
+ * @example
+ * ```typescript
+ * const messages = [
+ *   { role: 'user', content: 'Hello!' },
+ *   { role: 'assistant', content: 'Hi there! How can I help?' }
+ * ];
+ * estimateConversationTokens(messages); // Exact count
+ * ```
+ */
+export function estimateConversationTokens(messages) {
+    if (!messages || messages.length === 0) {
+        return 0;
+    }
+    let total = 0;
+    for (const message of messages) {
+        // Add overhead for message structure (role, content markers)
+        total += MESSAGE_OVERHEAD_TOKENS;
+        // Add content tokens
+        total += estimateTokens(message.content);
+    }
+    // Add overhead for overall conversation structure
+    total += CONVERSATION_OVERHEAD_TOKENS;
+    return total;
+}
+/**
+ * Counts tokens for a system prompt.
+ * System prompts have additional overhead for their special role.
+ *
+ * @param systemPrompt - The system prompt text
+ * @returns Exact token count including overhead
+ *
+ * @example
+ * ```typescript
+ * estimateSystemPromptTokens("You are a helpful assistant."); // Exact count
+ * ```
+ */
+export function estimateSystemPromptTokens(systemPrompt) {
+    if (!systemPrompt || systemPrompt.length === 0) {
+        return 0;
+    }
+    // System prompts have overhead for the system role marker
+    return estimateTokens(systemPrompt) + MESSAGE_OVERHEAD_TOKENS;
+}
+/**
+ * Calculates remaining tokens available in the context window.
+ *
+ * @param contextWindow - Total context window size in tokens
+ * @param usedTokens - Tokens already used
+ * @param reservedForOutput - Tokens reserved for model output (default: 8192)
+ * @returns Number of tokens remaining for new input
+ *
+ * @example
+ * ```typescript
+ * calculateRemainingTokens(200000, 50000, 8192); // 141808
+ * ```
+ */
+export function calculateRemainingTokens(contextWindow, usedTokens, reservedForOutput = 8192) {
+    return Math.max(0, contextWindow - usedTokens - reservedForOutput);
+}
+/**
+ * Checks if adding new content would exceed the context window.
+ *
+ * @param contextWindow - Total context window size in tokens
+ * @param currentTokens - Tokens currently used
+ * @param newContentTokens - Tokens in the new content to add
+ * @param reservedForOutput - Tokens reserved for model output (default: 8192)
+ * @returns True if adding the content would exceed the context window
+ *
+ * @example
+ * ```typescript
+ * wouldExceedContext(200000, 190000, 5000, 8192); // true
+ * wouldExceedContext(200000, 100000, 5000, 8192); // false
+ * ```
+ */
+export function wouldExceedContext(contextWindow, currentTokens, newContentTokens, reservedForOutput = 8192) {
+    return currentTokens + newContentTokens + reservedForOutput > contextWindow;
+}
+/**
+ * Formats a token count for display with appropriate suffix (K, M).
+ * Uses compact notation for large numbers.
+ *
+ * @param tokens - Number of tokens to format
+ * @returns Formatted string (e.g., "1.5K", "2.3M", "500")
+ *
+ * @example
+ * ```typescript
+ * formatTokenCount(500); // "500"
+ * formatTokenCount(1500); // "1.5K"
+ * formatTokenCount(1500000); // "1.50M"
+ * ```
+ */
+export function formatTokenCount(tokens) {
+    if (tokens >= 1_000_000) {
+        return `${(tokens / 1_000_000).toFixed(2)}M`;
+    }
+    if (tokens >= 1_000) {
+        return `${(tokens / 1_000).toFixed(1)}K`;
+    }
+    return tokens.toLocaleString();
+}
+/**
+ * Calculates the percentage of context window used.
+ *
+ * @param usedTokens - Number of tokens used
+ * @param contextWindow - Total context window size
+ * @returns Usage percentage (0-100), rounded to nearest integer
+ *
+ * @example
+ * ```typescript
+ * calculateContextUsagePercent(50000, 200000); // 25
+ * calculateContextUsagePercent(180000, 200000); // 90
+ * ```
+ */
+export function calculateContextUsagePercent(usedTokens, contextWindow) {
+    if (contextWindow <= 0) {
+        return 0;
+    }
+    return Math.round((usedTokens / contextWindow) * 100);
+}
+/**
+ * Gets a color indicator based on context usage percentage.
+ * Used for visual feedback in the UI.
+ *
+ * @param percent - Usage percentage (0-100)
+ * @returns Color name: 'green' (<50%), 'yellow' (50-80%), 'red' (>80%)
+ *
+ * @example
+ * ```typescript
+ * getContextUsageColor(30); // 'green'
+ * getContextUsageColor(65); // 'yellow'
+ * getContextUsageColor(85); // 'red'
+ * ```
+ */
+export function getContextUsageColor(percent) {
+    if (percent < 50) {
+        return 'green';
+    }
+    if (percent < 80) {
+        return 'yellow';
+    }
+    return 'red';
+}
+/**
+ * Counts the exact number of tokens in code content using the official Anthropic tokenizer.
+ *
+ * @param code - The code string to count
+ * @param language - Optional language hint (not used, kept for API compatibility)
+ * @returns Exact token count
+ *
+ * @example
+ * ```typescript
+ * estimateCodeTokens("const x = 42;"); // Exact count
+ * estimateCodeTokens("function foo() {\n  return bar;\n}"); // Exact count
+ * ```
+ */
+export function estimateCodeTokens(code, _language) {
+    if (!code || code.length === 0) {
+        return 0;
+    }
+    // Use the official tokenizer for accurate counts
+    return estimateTokens(code);
+}
+/**
+ * Counts the exact token count for a file with its path.
+ * Includes overhead for file path and code block markers.
+ *
+ * @param filePath - The file path
+ * @param content - The file content
+ * @returns Exact total tokens including overhead
+ *
+ * @example
+ * ```typescript
+ * estimateFileTokens("src/index.ts", "export const foo = 42;"); // Exact count
+ * ```
+ */
+export function estimateFileTokens(filePath, content) {
+    // Overhead for file path and formatting
+    const pathTokens = estimateTokens(filePath) + 5; // Extra for "File:" prefix etc.
+    // Overhead for code block markers (```language ... ```)
+    const codeBlockOverhead = 6;
+    // Content tokens
+    const contentTokens = estimateCodeTokens(content);
+    return pathTokens + codeBlockOverhead + contentTokens;
+}
+/**
+ * Truncates text to fit within a token budget.
+ * Attempts to truncate at word boundaries when possible.
+ *
+ * @param text - The text to truncate
+ * @param maxTokens - Maximum tokens allowed
+ * @param suffix - Suffix to append when truncated (default: "...")
+ * @returns Truncated text that fits within the token budget
+ *
+ * @example
+ * ```typescript
+ * truncateToTokenLimit("This is a long text...", 5); // "This is..."
+ * ```
+ */
+export function truncateToTokenLimit(text, maxTokens, suffix = '...') {
+    if (!text || maxTokens <= 0) {
+        return '';
+    }
+    const currentTokens = estimateTokens(text);
+    if (currentTokens <= maxTokens) {
+        return text;
+    }
+    // Estimate characters to keep (rough approximation)
+    const suffixTokens = estimateTokens(suffix);
+    const targetTokens = maxTokens - suffixTokens;
+    const targetChars = Math.floor(targetTokens * CHARS_PER_TOKEN);
+    if (targetChars <= 0) {
+        return suffix;
+    }
+    // Truncate and try to find a word boundary
+    let truncated = text.slice(0, targetChars);
+    // Look for last space to truncate at word boundary
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > targetChars * 0.7) {
+        truncated = truncated.slice(0, lastSpace);
+    }
+    return truncated.trimEnd() + suffix;
+}
+/**
+ * Calculates the total tokens from a context breakdown.
+ *
+ * @param breakdown - The context breakdown object
+ * @returns Total tokens used (excluding reserved)
+ *
+ * @example
+ * ```typescript
+ * const breakdown = {
+ *   systemPrompt: 500,
+ *   conversationHistory: 10000,
+ *   fileContext: 5000,
+ *   reservedForOutput: 8192,
+ *   other: 100
+ * };
+ * calculateBreakdownTotal(breakdown); // 15600
+ * ```
+ */
+export function calculateBreakdownTotal(breakdown) {
+    return (breakdown.systemPrompt +
+        breakdown.conversationHistory +
+        breakdown.fileContext +
+        breakdown.other);
+}
+/**
+ * Checks if a context breakdown is within acceptable limits.
+ *
+ * @param breakdown - The context breakdown
+ * @param contextWindow - Total context window size
+ * @param warningThreshold - Percentage threshold for warning (default: 80)
+ * @returns Object with status and details
+ *
+ * @example
+ * ```typescript
+ * const result = checkContextHealth(breakdown, 200000);
+ * // { healthy: true, usagePercent: 45, warning: null }
+ * ```
+ */
+export function checkContextHealth(breakdown, contextWindow, warningThreshold = 80) {
+    const usedTokens = calculateBreakdownTotal(breakdown);
+    const usagePercent = calculateContextUsagePercent(usedTokens, contextWindow);
+    const availableTokens = calculateRemainingTokens(contextWindow, usedTokens, breakdown.reservedForOutput);
+    let warning = null;
+    let healthy = true;
+    if (usagePercent >= 90) {
+        warning = 'Context window nearly full. Consider using /compact or /clear.';
+        healthy = false;
+    }
+    else if (usagePercent >= warningThreshold) {
+        warning = 'Context usage is high. Consider compacting conversation.';
+        healthy = true; // Still functional but worth noting
+    }
+    return {
+        healthy,
+        usagePercent,
+        warning,
+        availableTokens,
+    };
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/utils/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"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"}

package/dist/utils/tool-mapper.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool name mapping utility for cross-compatibility with Roo-Cline/Claude.dev.
+ *
+ * Maps external tool names (from Roo-Cline/Claude.dev) to Nova's internal tool names.
+ * Supports both allowedTools and disallowedTools in agent configurations.
+ */
+/**
+ * Normalizes a tool name to Nova's internal format.
+ *
+ * Handles:
+ * - External tool names (Roo-Cline/Claude.dev format like "Read", "Bash")
+ * - Nova tool names (already in correct format like "read_file")
+ * - Case-insensitive matching
+ *
+ * @param toolName - Tool name in any supported format
+ * @returns Array of Nova tool names, or empty array if no mapping exists
+ *
+ * @example
+ * normalizeToolName('Read') // ['read_file', 'read_multiple_files']
+ * normalizeToolName('read_file') // ['read_file']
+ * normalizeToolName('bash') // ['execute_command', 'execute_and_verify', 'execute_background']
+ * normalizeToolName('UnknownTool') // []
+ */
+export declare function normalizeToolName(toolName: string): string[];
+/**
+ * Normalizes a list of tool names to Nova's internal format.
+ *
+ * @param toolNames - Array of tool names (can be external or Nova format)
+ * @param warnOnUnknown - If true, logs warnings for unknown tools
+ * @returns Array of normalized Nova tool names (duplicates removed)
+ *
+ * @example
+ * normalizeToolsList(['Read', 'Write', 'bash'])
+ * // ['read_file', 'read_multiple_files', 'write_file', 'execute_command', 'execute_and_verify', 'execute_background']
+ */
+export declare function normalizeToolsList(toolNames: string[] | undefined, warnOnUnknown?: boolean): string[] | undefined;
+/**
+ * Gets the external (Roo-Cline/Claude.dev) name for a Nova tool.
+ * Useful for displaying tool names in a user-friendly format.
+ *
+ * @param novaTool - Nova tool name
+ * @returns External tool name, or the original Nova name if no mapping exists
+ *
+ * @example
+ * getExternalToolName('read_file') // 'Read'
+ * getExternalToolName('execute_command') // 'Bash'
+ * getExternalToolName('git_status') // 'git_status' (no external mapping)
+ */
+export declare function getExternalToolName(novaTool: string): string;
+/**
+ * Checks if a tool name is valid (either Nova or external format).
+ *
+ * @param toolName - Tool name to validate
+ * @returns True if the tool name can be mapped to a Nova tool
+ */
+export declare function isValidToolName(toolName: string): boolean;
+/**
+ * Gets all supported external tool names.
+ * Useful for documentation and validation.
+ *
+ * @returns Array of external tool names
+ */
+export declare function getSupportedExternalTools(): string[];
+/**
+ * Gets all valid Nova tool names.
+ *
+ * @returns Array of Nova tool names
+ */
+export declare function getSupportedNovaTools(): string[];
+//# sourceMappingURL=tool-mapper.d.ts.map

package/dist/utils/tool-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-mapper.d.ts","sourceRoot":"","sources":["../../src/utils/tool-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8IH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,aAAa,UAAQ,GACpB,MAAM,EAAE,GAAG,SAAS,CAuBtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}