@defai.digital/ax-cli 3.15.26 → 4.0.0

package/dist/tools/definitions/design.js

@@ -0,0 +1,368 @@
+/**
+ * Design Tools Definitions - Claude Code Quality
+ *
+ * Figma integration tools for design-to-code workflows.
+ */
+export const figmaMapTool = {
+    name: 'figma_map',
+    displayName: 'Figma Map',
+    description: `Map a Figma file structure to see its pages, frames, and components.
+
+Use this to explore the structure of a Figma design file. Returns a hierarchical view of the file's organization including pages, frames, components, and their relationships.
+
+Requires FIGMA_ACCESS_TOKEN environment variable to be set.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            file_key: {
+                type: 'string',
+                description: 'Figma file key (from the URL: figma.com/file/FILE_KEY/...)',
+                examples: ['abc123xyz', 'FigmaFileKey123'],
+            },
+            depth: {
+                type: 'number',
+                description: 'Maximum depth to traverse (optional)',
+                default: 3,
+            },
+            format: {
+                type: 'string',
+                enum: ['tree', 'json', 'flat'],
+                description: 'Output format (default: tree)',
+                default: 'tree',
+            },
+            show_ids: {
+                type: 'boolean',
+                description: 'Include node IDs in output',
+                default: false,
+            },
+            show_types: {
+                type: 'boolean',
+                description: 'Include node types in output',
+                default: true,
+            },
+            frames_only: {
+                type: 'boolean',
+                description: 'Show only frames and components',
+                default: false,
+            },
+        },
+        required: ['file_key'],
+    },
+    usageNotes: [
+        'Get file_key from Figma URL: figma.com/file/FILE_KEY/...',
+        'Use tree format for visual hierarchy overview',
+        'Use json format for programmatic processing',
+        'Set frames_only: true to focus on main containers',
+        'Increase depth for detailed component inspection',
+    ],
+    constraints: [
+        'Requires FIGMA_ACCESS_TOKEN environment variable',
+        'Large files may take longer to process',
+        'Deep traversal may hit API rate limits',
+    ],
+    antiPatterns: [
+        'Not setting FIGMA_ACCESS_TOKEN before use',
+        'Setting very high depth for large files',
+    ],
+    examples: [
+        {
+            description: 'Map file structure',
+            scenario: 'Explore a design file organization',
+            input: { file_key: 'abc123xyz', format: 'tree', depth: 2 },
+            expectedBehavior: 'Returns tree view of pages and frames',
+        },
+    ],
+    tokenCost: 350,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_tokens', 'figma_search', 'figma_audit'],
+};
+export const figmaTokensTool = {
+    name: 'figma_tokens',
+    displayName: 'Figma Tokens',
+    description: `Extract design tokens (colors, spacing, radii) from a Figma file's variables.
+
+Use this to generate design tokens from Figma variables in various formats for use in code. Supports CSS, SCSS, Tailwind, and JSON output formats.
+
+Requires FIGMA_ACCESS_TOKEN environment variable to be set.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            file_key: {
+                type: 'string',
+                description: 'Figma file key containing design tokens/variables',
+            },
+            format: {
+                type: 'string',
+                enum: ['json', 'tailwind', 'css', 'scss'],
+                description: 'Output format (default: json)',
+                default: 'json',
+            },
+            color_format: {
+                type: 'string',
+                enum: ['hex', 'rgb', 'hsl'],
+                description: 'Color output format (default: hex)',
+                default: 'hex',
+            },
+            dimension_unit: {
+                type: 'string',
+                enum: ['px', 'rem'],
+                description: 'Dimension unit (default: px)',
+                default: 'px',
+            },
+            rem_base: {
+                type: 'number',
+                description: 'Base value for rem conversion (default: 16)',
+                default: 16,
+            },
+        },
+        required: ['file_key'],
+    },
+    usageNotes: [
+        'Use tailwind format for Tailwind CSS configuration',
+        'Use css format for CSS custom properties',
+        'Use scss format for SCSS variables',
+        'Set rem for dimension_unit for responsive designs',
+        'Adjust rem_base to match your project settings',
+    ],
+    constraints: [
+        'Requires FIGMA_ACCESS_TOKEN environment variable',
+        'Only extracts published variables',
+        'Complex variable modes may not be fully supported',
+    ],
+    antiPatterns: [
+        'Using px units when rem is more appropriate',
+        'Not matching color_format to project standards',
+    ],
+    examples: [
+        {
+            description: 'Extract tokens for Tailwind',
+            scenario: 'Generate Tailwind config from Figma',
+            input: { file_key: 'abc123xyz', format: 'tailwind', dimension_unit: 'rem' },
+            expectedBehavior: 'Returns Tailwind-compatible token configuration',
+        },
+    ],
+    tokenCost: 350,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_map', 'figma_audit'],
+};
+export const figmaAuditTool = {
+    name: 'figma_audit',
+    displayName: 'Figma Audit',
+    description: `Run a design audit on a Figma file to check for naming conventions, missing auto-layout, and other best practices.
+
+Use this to analyze a Figma file for design system compliance and best practices. Returns a list of issues with severity and recommendations.
+
+Requires FIGMA_ACCESS_TOKEN environment variable to be set.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            file_key: {
+                type: 'string',
+                description: 'Figma file key to audit',
+            },
+            depth: {
+                type: 'number',
+                description: 'Maximum depth to traverse (optional)',
+            },
+            rules: {
+                type: 'array',
+                description: "Specific rules to run (e.g., ['layer-naming', 'missing-autolayout']). Runs all by default.",
+                items: { type: 'string' },
+            },
+            exclude_rules: {
+                type: 'array',
+                description: 'Rules to exclude from the audit',
+                items: { type: 'string' },
+            },
+        },
+        required: ['file_key'],
+    },
+    usageNotes: [
+        'Run without rules parameter to check all rules',
+        'Use exclude_rules to skip known intentional violations',
+        'Focus on high-severity issues first',
+        'Common rules: layer-naming, missing-autolayout, color-consistency',
+    ],
+    constraints: [
+        'Requires FIGMA_ACCESS_TOKEN environment variable',
+        'Large files may take longer to audit',
+        'Custom rules are not supported',
+    ],
+    antiPatterns: [
+        'Ignoring all audit results without review',
+        'Running on very large files without depth limit',
+    ],
+    examples: [
+        {
+            description: 'Full design audit',
+            scenario: 'Check file for all best practices',
+            input: { file_key: 'abc123xyz' },
+            expectedBehavior: 'Returns list of issues with severity levels',
+        },
+        {
+            description: 'Focused audit',
+            scenario: 'Check only naming conventions',
+            input: { file_key: 'abc123xyz', rules: ['layer-naming'] },
+            expectedBehavior: 'Returns only naming convention issues',
+        },
+    ],
+    tokenCost: 350,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_map', 'figma_tokens'],
+};
+export const figmaSearchTool = {
+    name: 'figma_search',
+    displayName: 'Figma Search',
+    description: `Search for nodes in a Figma file by name, type, or text content.
+
+Use this to find specific elements within a Figma design file. Can search by node name, node type, or text content.
+
+Requires FIGMA_ACCESS_TOKEN environment variable to be set.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            file_key: {
+                type: 'string',
+                description: 'Figma file key to search in',
+            },
+            name: {
+                type: 'string',
+                description: 'Search by node name (partial match)',
+            },
+            type: {
+                type: 'string',
+                description: 'Filter by node type (e.g., FRAME, TEXT, COMPONENT)',
+            },
+            text: {
+                type: 'string',
+                description: 'Search text nodes by content',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum results to return (default: 10)',
+                default: 10,
+            },
+        },
+        required: ['file_key'],
+    },
+    usageNotes: [
+        'At least one search parameter (name, type, or text) is recommended',
+        'Combine parameters to narrow results',
+        'Common types: FRAME, TEXT, COMPONENT, INSTANCE, GROUP',
+        'Name search is case-insensitive partial match',
+    ],
+    constraints: [
+        'Requires FIGMA_ACCESS_TOKEN environment variable',
+        'Large files may have many matches',
+        'Limit results for faster response',
+    ],
+    antiPatterns: [
+        'Searching without any filter parameters',
+        'Setting very high limit on large files',
+    ],
+    examples: [
+        {
+            description: 'Find buttons',
+            scenario: 'Search for all button components',
+            input: { file_key: 'abc123xyz', name: 'button', type: 'COMPONENT' },
+            expectedBehavior: 'Returns button components matching the name',
+        },
+        {
+            description: 'Find specific text',
+            scenario: 'Find nodes containing specific copy',
+            input: { file_key: 'abc123xyz', text: 'Sign up' },
+            expectedBehavior: 'Returns text nodes containing "Sign up"',
+        },
+    ],
+    tokenCost: 300,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_map'],
+};
+export const figmaAliasListTool = {
+    name: 'figma_alias_list',
+    displayName: 'Figma Alias List',
+    description: `List all saved Figma design aliases (shortcuts to specific files/nodes).
+
+Aliases are saved shortcuts that map a friendly name to a Figma file key and optional node ID. Use this to see all configured aliases.`,
+    parameters: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    usageNotes: [
+        'Returns all configured Figma aliases',
+        'Aliases simplify referencing frequently used designs',
+        'Use figma_alias_resolve to get the actual file key from an alias',
+    ],
+    constraints: ['Aliases must be configured in project settings'],
+    antiPatterns: [],
+    examples: [
+        {
+            description: 'List all aliases',
+            scenario: 'See available design shortcuts',
+            input: {},
+            expectedBehavior: 'Returns list of alias names and descriptions',
+        },
+    ],
+    tokenCost: 150,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_alias_resolve', 'figma_map'],
+};
+export const figmaAliasResolveTool = {
+    name: 'figma_alias_resolve',
+    displayName: 'Figma Alias Resolve',
+    description: `Resolve a design alias to its Figma file key and node ID.
+
+Use this to convert a friendly alias name into the actual Figma file key and optional node ID for use with other Figma tools.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            alias: {
+                type: 'string',
+                description: 'Alias name to resolve',
+                examples: ['main-design', 'component-library', 'icons'],
+            },
+        },
+        required: ['alias'],
+    },
+    usageNotes: [
+        'Use figma_alias_list first to see available aliases',
+        'Resolved file_key can be used with other figma_* tools',
+        'Node ID is optional and points to a specific element',
+    ],
+    constraints: [
+        'Alias must exist in project configuration',
+        'Returns error for unknown aliases',
+    ],
+    antiPatterns: ['Guessing alias names without checking figma_alias_list'],
+    examples: [
+        {
+            description: 'Resolve an alias',
+            scenario: 'Get file key for the main design',
+            input: { alias: 'main-design' },
+            expectedBehavior: 'Returns file_key and optional node_id',
+        },
+    ],
+    tokenCost: 150,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['design'],
+    alternatives: [],
+    relatedTools: ['figma_alias_list', 'figma_map'],
+};
+//# sourceMappingURL=design.js.map

package/dist/tools/definitions/design.js.map

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

package/dist/tools/definitions/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Tool Definitions - Barrel Export
+ *
+ * This file exports all tool definitions and provides the TOOL_DEFINITIONS array
+ * which is the single source of truth for all tool metadata.
+ */
+import type { ToolDefinition } from '../types.js';
+export { bashTool } from './bash.js';
+export { bashOutputTool } from './bash-output.js';
+export { viewFileTool } from './view-file.js';
+export { createFileTool } from './create-file.js';
+export { strReplaceEditorTool } from './str-replace-editor.js';
+export { multiEditTool } from './multi-edit.js';
+export { searchTool } from './search.js';
+export { createTodoListTool, updateTodoListTool } from './todo.js';
+export { askUserTool } from './ask-user.js';
+export { axAgentTool } from './ax-agent.js';
+export { figmaMapTool, figmaTokensTool, figmaAuditTool, figmaSearchTool, figmaAliasListTool, figmaAliasResolveTool, } from './design.js';
+/**
+ * All tool definitions - Single Source of Truth
+ *
+ * This array contains all rich tool definitions with Claude Code-quality
+ * descriptions, usage notes, constraints, and examples.
+ *
+ * OpenAI and Anthropic formats are DERIVED from these definitions using
+ * the format generators.
+ */
+export declare const TOOL_DEFINITIONS: ToolDefinition[];
+/**
+ * Get a tool definition by name
+ */
+export declare function getToolDefinition(name: string): ToolDefinition | undefined;
+/**
+ * Get tool definitions by category
+ */
+export declare function getToolsByCategory(category: string): ToolDefinition[];
+/**
+ * Get tool definitions by safety level
+ */
+export declare function getToolsBySafetyLevel(level: 'safe' | 'moderate' | 'dangerous'): ToolDefinition[];
+/**
+ * Get tool definitions that require confirmation
+ */
+export declare function getToolsRequiringConfirmation(): ToolDefinition[];
+/**
+ * Calculate total token cost for all tools
+ */
+export declare function getTotalTokenCost(): number;

package/dist/tools/definitions/index.js

@@ -0,0 +1,96 @@
+/**
+ * Tool Definitions - Barrel Export
+ *
+ * This file exports all tool definitions and provides the TOOL_DEFINITIONS array
+ * which is the single source of truth for all tool metadata.
+ */
+// Core tools
+export { bashTool } from './bash.js';
+export { bashOutputTool } from './bash-output.js';
+export { viewFileTool } from './view-file.js';
+export { createFileTool } from './create-file.js';
+export { strReplaceEditorTool } from './str-replace-editor.js';
+export { multiEditTool } from './multi-edit.js';
+export { searchTool } from './search.js';
+export { createTodoListTool, updateTodoListTool } from './todo.js';
+export { askUserTool } from './ask-user.js';
+export { axAgentTool } from './ax-agent.js';
+export { figmaMapTool, figmaTokensTool, figmaAuditTool, figmaSearchTool, figmaAliasListTool, figmaAliasResolveTool, } from './design.js';
+// Import all tools for the array
+import { bashTool } from './bash.js';
+import { bashOutputTool } from './bash-output.js';
+import { viewFileTool } from './view-file.js';
+import { createFileTool } from './create-file.js';
+import { strReplaceEditorTool } from './str-replace-editor.js';
+import { multiEditTool } from './multi-edit.js';
+import { searchTool } from './search.js';
+import { createTodoListTool, updateTodoListTool } from './todo.js';
+import { askUserTool } from './ask-user.js';
+import { axAgentTool } from './ax-agent.js';
+import { figmaMapTool, figmaTokensTool, figmaAuditTool, figmaSearchTool, figmaAliasListTool, figmaAliasResolveTool, } from './design.js';
+/**
+ * All tool definitions - Single Source of Truth
+ *
+ * This array contains all rich tool definitions with Claude Code-quality
+ * descriptions, usage notes, constraints, and examples.
+ *
+ * OpenAI and Anthropic formats are DERIVED from these definitions using
+ * the format generators.
+ */
+export const TOOL_DEFINITIONS = [
+    // File operations
+    viewFileTool,
+    createFileTool,
+    strReplaceEditorTool,
+    multiEditTool,
+    // Command execution
+    bashTool,
+    bashOutputTool,
+    // Search
+    searchTool,
+    // Task management
+    createTodoListTool,
+    updateTodoListTool,
+    // User interaction
+    askUserTool,
+    // Agent delegation
+    axAgentTool,
+    // Design tools
+    figmaMapTool,
+    figmaTokensTool,
+    figmaAuditTool,
+    figmaSearchTool,
+    figmaAliasListTool,
+    figmaAliasResolveTool,
+];
+/**
+ * Get a tool definition by name
+ */
+export function getToolDefinition(name) {
+    return TOOL_DEFINITIONS.find((t) => t.name === name);
+}
+/**
+ * Get tool definitions by category
+ */
+export function getToolsByCategory(category) {
+    return TOOL_DEFINITIONS.filter((t) => t.categories.includes(category));
+}
+/**
+ * Get tool definitions by safety level
+ */
+export function getToolsBySafetyLevel(level) {
+    return TOOL_DEFINITIONS.filter((t) => t.safetyLevel === level);
+}
+/**
+ * Get tool definitions that require confirmation
+ */
+export function getToolsRequiringConfirmation() {
+    return TOOL_DEFINITIONS.filter((t) => t.requiresConfirmation);
+}
+/**
+ * Calculate total token cost for all tools
+ */
+export function getTotalTokenCost() {
+    return TOOL_DEFINITIONS.reduce((sum, t) => sum + t.tokenCost, 0);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/definitions/index.js.map

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

package/dist/tools/definitions/multi-edit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Multi Edit Tool Definition - Claude Code Quality
+ *
+ * Make multiple edits to a single file in one atomic operation.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const multiEditTool: ToolDefinition;

package/dist/tools/definitions/multi-edit.js

@@ -0,0 +1,123 @@
+/**
+ * Multi Edit Tool Definition - Claude Code Quality
+ *
+ * Make multiple edits to a single file in one atomic operation.
+ */
+export const multiEditTool = {
+    name: 'multi_edit',
+    displayName: 'Multi Edit',
+    description: `Make multiple edits to a single file in one atomic operation.
+
+Use this instead of multiple str_replace_editor calls when you need to make several changes to the same file. Edits are applied sequentially and the operation fails entirely if any edit is invalid (all-or-nothing).
+
+Each edit in the array operates on the result of the previous edit. This means:
+1. The first edit modifies the original file
+2. The second edit operates on the result after the first edit
+3. And so on...
+
+This is useful for:
+- Making multiple related changes to a file
+- Refactoring that requires several coordinated changes
+- Adding imports AND using them in the same operation`,
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to the file to edit',
+                format: 'file-path',
+            },
+            edits: {
+                type: 'array',
+                description: 'Array of edits to apply sequentially. Each edit operates on the result of the previous edit.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        old_str: {
+                            type: 'string',
+                            description: 'Text to replace',
+                        },
+                        new_str: {
+                            type: 'string',
+                            description: 'Replacement text',
+                        },
+                    },
+                    required: ['old_str', 'new_str'],
+                },
+            },
+        },
+        required: ['path', 'edits'],
+    },
+    usageNotes: [
+        'Use when making 2+ changes to the same file',
+        'More efficient than multiple str_replace_editor calls',
+        'Edits are applied sequentially - order matters!',
+        'Later edits operate on the result of earlier edits',
+        'All edits succeed or none do (atomic operation)',
+        'Always view_file first to see current content',
+        'Plan the edit order carefully when edits might affect each other',
+    ],
+    constraints: [
+        'File must exist',
+        'All old_str values must be found (in sequence)',
+        'If any edit fails, the entire operation is rolled back',
+        'Each edit must find its old_str in the content after previous edits',
+    ],
+    antiPatterns: [
+        'Using for a single edit (use str_replace_editor instead)',
+        'Not reading the file first',
+        'Not considering how earlier edits affect later ones',
+        'Edits that conflict or overlap',
+    ],
+    examples: [
+        {
+            description: 'Add import and use it',
+            scenario: 'Import a function and add a call to it',
+            input: {
+                path: '/project/src/app.ts',
+                edits: [
+                    {
+                        old_str: "import { existingFn } from './utils';",
+                        new_str: `import { existingFn } from './utils';
+import { newFn } from './helpers';`,
+                    },
+                    {
+                        old_str: 'existingFn();',
+                        new_str: `existingFn();
+newFn();`,
+                    },
+                ],
+            },
+            expectedBehavior: 'Adds import and uses the new function',
+        },
+        {
+            description: 'Refactor multiple related items',
+            scenario: 'Rename a constant and update its usages',
+            input: {
+                path: '/project/src/config.ts',
+                edits: [
+                    {
+                        old_str: 'const OLD_NAME = 100;',
+                        new_str: 'const NEW_NAME = 100;',
+                    },
+                    {
+                        old_str: 'console.log(OLD_NAME);',
+                        new_str: 'console.log(NEW_NAME);',
+                    },
+                    {
+                        old_str: 'return OLD_NAME * 2;',
+                        new_str: 'return NEW_NAME * 2;',
+                    },
+                ],
+            },
+            expectedBehavior: 'Renames constant and updates all usages atomically',
+        },
+    ],
+    tokenCost: 450,
+    safetyLevel: 'moderate',
+    requiresConfirmation: false,
+    categories: ['file-operations'],
+    alternatives: ['str_replace_editor'],
+    relatedTools: ['view_file', 'str_replace_editor'],
+};
+//# sourceMappingURL=multi-edit.js.map

package/dist/tools/definitions/multi-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-edit.js","sourceRoot":"","sources":["../../../src/tools/definitions/multi-edit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IAEzB,WAAW,EAAE;;;;;;;;;;;;sDAYuC;IAEpD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;gBACvC,MAAM,EAAE,WAAW;aACpB;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,8FAA8F;gBAChG,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kBAAkB;yBAChC;qBACF;oBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;iBACjC;aACF;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;IAED,UAAU,EAAE;QACV,6CAA6C;QAC7C,uDAAuD;QACvD,iDAAiD;QACjD,oDAAoD;QACpD,iDAAiD;QACjD,+CAA+C;QAC/C,kEAAkE;KACnE;IAED,WAAW,EAAE;QACX,iBAAiB;QACjB,gDAAgD;QAChD,wDAAwD;QACxD,qEAAqE;KACtE;IAED,YAAY,EAAE;QACZ,0DAA0D;QAC1D,4BAA4B;QAC5B,qDAAqD;QACrD,gCAAgC;KACjC;IAED,QAAQ,EAAE;QACR;YACE,WAAW,EAAE,uBAAuB;YACpC,QAAQ,EAAE,wCAAwC;YAClD,KAAK,EAAE;gBACL,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,EAAE;oBACL;wBACE,OAAO,EAAE,uCAAuC;wBAChD,OAAO,EAAE;mCACc;qBACxB;oBACD;wBACE,OAAO,EAAE,eAAe;wBACxB,OAAO,EAAE;SACZ;qBACE;iBACF;aACF;YACD,gBAAgB,EAAE,uCAAuC;SAC1D;QACD;YACE,WAAW,EAAE,iCAAiC;YAC9C,QAAQ,EAAE,yCAAyC;YACnD,KAAK,EAAE;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE;oBACL;wBACE,OAAO,EAAE,uBAAuB;wBAChC,OAAO,EAAE,uBAAuB;qBACjC;oBACD;wBACE,OAAO,EAAE,wBAAwB;wBACjC,OAAO,EAAE,wBAAwB;qBAClC;oBACD;wBACE,OAAO,EAAE,sBAAsB;wBAC/B,OAAO,EAAE,sBAAsB;qBAChC;iBACF;aACF;YACD,gBAAgB,EAAE,oDAAoD;SACvE;KACF;IAED,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,UAAU;IACvB,oBAAoB,EAAE,KAAK;IAE3B,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,YAAY,EAAE,CAAC,oBAAoB,CAAC;IACpC,YAAY,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;CAClD,CAAC"}

package/dist/tools/definitions/search.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Search Tool Definition - Claude Code Quality
+ *
+ * Unified search tool for finding text content or files in the codebase.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const searchTool: ToolDefinition;