research-powerpack-mcp 3.3.2 → 3.3.4

package/README.md

@@ -624,6 +624,49 @@ npm run typecheck
 
 ---
 
+## 🏗️ Architecture (v3.4.0+)
+
+The codebase uses a **YAML-driven configuration system** with **aggressive LLM optimization** (v3.5.0+):
+
+### Core Architecture
+
+| Component | File | Purpose |
+|-----------|------|---------|
+| **Tool Definitions** | `src/config/yaml/tools.yaml` | Single source of truth for all tool metadata |
+| **Handler Registry** | `src/tools/registry.ts` | Declarative tool registration + `executeTool` wrapper |
+| **YAML Loader** | `src/config/loader.ts` | Parses YAML, generates MCP-compatible definitions |
+| **Shared Utils** | `src/tools/utils.ts` | Common utility functions |
+
+**Adding a new tool:**
+1. Add tool definition to `tools.yaml`
+2. Create handler in `src/tools/`
+3. Register in `src/tools/registry.ts`
+
+See `docs/refactoring/04-migration-guide.md` for detailed instructions.
+
+### LLM Optimization (v3.5.0+)
+
+All tools include **aggressive guidance** to force LLMs to use them optimally:
+
+| Feature | Description |
+|---------|-------------|
+| **Configurable Limits** | All min/max values in YAML (`limits` section) |
+| **BAD vs GOOD Examples** | Every tool shows anti-patterns and perfect usage |
+| **Aggressive Phrasing** | Changed from "you can" to "you MUST" |
+| **Visual Formatting** | Emoji headers (🔥), section dividers (━━━), icons (📊🎯❌✅) |
+| **Templates** | Structured formats for questions, extractions, file descriptions |
+
+**Key Enhancements:**
+- `search_reddit`: Minimum 10 queries (was 3), 10-category formula
+- `deep_research`: 7-section question template, file attachment requirements
+- `scrape_links`: Extraction template with OR statements, use_llm=true push
+- `web_search`: Minimum 3 keywords, search operator examples
+- `file_attachments`: Numbered 5-section description template
+
+See `docs/refactoring/07-llm-optimization-summary.md` for full details.
+
+---
+
 ## 🔥 Common Issues & Quick Fixes
 
 <details>

package/dist/config/index.d.ts

@@ -23,7 +23,7 @@ export declare const SERVER: {
     readonly VERSION: string;
     readonly DESCRIPTION: string;
 };
-interface Capabilities {
+export interface Capabilities {
     reddit: boolean;
     search: boolean;
     scraping: boolean;

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoDH,UAAU,SAAS;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAgB,QAAQ,IAAI,SAAS,CAOpC;AAMD,eAAO,MAAM,QAAQ;;;;;;;;CAUX,CAAC;AAQX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAMX,UAAU,YAAY;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,MAAM,CAS3E;AAMD,eAAO,MAAM,OAAO;;;;;;;;;CASV,CAAC;AAMX,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWrC,CAAC;AAMX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoDH,UAAU,SAAS;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAgB,QAAQ,IAAI,SAAS,CAOpC;AAMD,eAAO,MAAM,QAAQ;;;;;;;;CAUX,CAAC;AAQX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,MAAM,CAS3E;AAMD,eAAO,MAAM,OAAO;;;;;;;;;CASV,CAAC;AAMX,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWrC,CAAC;AAMX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * YAML Configuration Loader
+ * Loads tools.yaml and generates MCP-compatible tool definitions
+ */
+import { z } from 'zod';
+import type { YamlConfig, YamlToolConfig, YamlParameter, McpTool, LoadedTool } from './types.js';
+/**
+ * Recursively convert YAML parameter to Zod schema
+ */
+declare function yamlParamToZod(param: YamlParameter): z.ZodTypeAny;
+/**
+ * Convert YAML parameters to Zod object schema
+ */
+declare function yamlParamsToZodSchema(params: Record<string, YamlParameter>): z.ZodObject<Record<string, z.ZodTypeAny>>;
+/**
+ * Load and parse tools.yaml
+ */
+export declare function loadYamlConfig(): YamlConfig;
+/**
+ * Load all tools from YAML configuration
+ */
+export declare function loadToolsFromYaml(): LoadedTool[];
+/**
+ * Get tool configuration by name
+ */
+export declare function getToolConfig(name: string): YamlToolConfig | undefined;
+/**
+ * Get schema descriptions for a tool (for injecting into existing Zod schemas)
+ */
+export declare function getSchemaDescriptions(name: string): Record<string, string> | undefined;
+/**
+ * Get Zod schema by reference name
+ */
+export declare function getZodSchemaByRef(ref: string): z.ZodTypeAny | undefined;
+/**
+ * Generate complete MCP tools list with all schemas resolved
+ */
+export declare function generateMcpTools(): McpTool[];
+export { yamlParamsToZodSchema, yamlParamToZod };
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EAEb,OAAO,EACP,UAAU,EACX,MAAM,YAAY,CAAC;AA2DpB;;GAEG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,CAAC,CAAC,UAAU,CAqE1D;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAU3C;AAyBD;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAI3C;AAwCD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAYhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAGtF;AAmBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,UAAU,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,EAAE,CA+B5C;AAMD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC"}

package/dist/config/loader.js

@@ -0,0 +1,300 @@
+/**
+ * YAML Configuration Loader
+ * Loads tools.yaml and generates MCP-compatible tool definitions
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+// Get directory of this file for relative YAML path
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ============================================================================
+// YAML to Zod Schema Conversion
+// ============================================================================
+/**
+ * Convert YAML validation rules to Zod string schema
+ */
+function applyStringValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.minLength !== undefined)
+        result = result.min(validation.minLength);
+    if (validation.maxLength !== undefined)
+        result = result.max(validation.maxLength);
+    if (validation.pattern)
+        result = result.regex(new RegExp(validation.pattern));
+    if (validation.format === 'uri')
+        result = result.url();
+    if (validation.format === 'email')
+        result = result.email();
+    if (validation.format === 'uuid')
+        result = result.uuid();
+    return result;
+}
+/**
+ * Convert YAML validation rules to Zod number schema
+ */
+function applyNumberValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.min !== undefined)
+        result = result.min(validation.min);
+    if (validation.max !== undefined)
+        result = result.max(validation.max);
+    if (validation.int)
+        result = result.int();
+    if (validation.positive)
+        result = result.positive();
+    if (validation.negative)
+        result = result.negative();
+    return result;
+}
+/**
+ * Convert YAML validation rules to Zod array schema
+ */
+function applyArrayValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.minItems !== undefined)
+        result = result.min(validation.minItems);
+    if (validation.maxItems !== undefined)
+        result = result.max(validation.maxItems);
+    return result;
+}
+/**
+ * Recursively convert YAML parameter to Zod schema
+ */
+function yamlParamToZod(param) {
+    let schema;
+    switch (param.type) {
+        case 'string': {
+            let strSchema = z.string();
+            strSchema = applyStringValidation(strSchema, param.validation);
+            if (param.description)
+                strSchema = strSchema.describe(param.description);
+            schema = strSchema;
+            break;
+        }
+        case 'number': {
+            let numSchema = z.number();
+            numSchema = applyNumberValidation(numSchema, param.validation);
+            if (param.description)
+                numSchema = numSchema.describe(param.description);
+            schema = numSchema;
+            break;
+        }
+        case 'boolean': {
+            let boolSchema = z.boolean();
+            if (param.description)
+                boolSchema = boolSchema.describe(param.description);
+            schema = boolSchema;
+            break;
+        }
+        case 'array': {
+            if (!param.items) {
+                throw new Error('Array parameter must have items definition');
+            }
+            const itemSchema = yamlParamToZod(param.items);
+            let arrSchema = z.array(itemSchema);
+            arrSchema = applyArrayValidation(arrSchema, param.validation);
+            if (param.description)
+                arrSchema = arrSchema.describe(param.description);
+            schema = arrSchema;
+            break;
+        }
+        case 'object': {
+            if (!param.properties) {
+                throw new Error('Object parameter must have properties definition');
+            }
+            const shape = {};
+            for (const [key, propDef] of Object.entries(param.properties)) {
+                let propSchema = yamlParamToZod(propDef);
+                if (propDef.required === false) {
+                    propSchema = propSchema.optional();
+                }
+                shape[key] = propSchema;
+            }
+            let objSchema = z.object(shape);
+            if (param.description)
+                objSchema = objSchema.describe(param.description);
+            schema = objSchema;
+            break;
+        }
+        default:
+            throw new Error(`Unknown parameter type: ${param.type}`);
+    }
+    // Apply optional/default
+    if (param.required === false && param.default !== undefined) {
+        schema = schema.default(param.default);
+    }
+    else if (param.required === false) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+/**
+ * Convert YAML parameters to Zod object schema
+ */
+function yamlParamsToZodSchema(params) {
+    const shape = {};
+    for (const [key, param] of Object.entries(params)) {
+        let schema = yamlParamToZod(param);
+        // Note: required is handled in yamlParamToZod via optional()
+        shape[key] = schema;
+    }
+    return z.object(shape);
+}
+/**
+ * Convert Zod schema to JSON Schema for MCP inputSchema
+ */
+function zodToMcpInputSchema(schema) {
+    const jsonSchema = zodToJsonSchema(schema, { $refStrategy: 'none' });
+    // Extract properties and required from JSON Schema
+    if (typeof jsonSchema === 'object' && jsonSchema !== null) {
+        const obj = jsonSchema;
+        return {
+            type: 'object',
+            properties: obj.properties || {},
+            required: obj.required,
+        };
+    }
+    return { type: 'object', properties: {} };
+}
+// ============================================================================
+// Tool Loading
+// ============================================================================
+/**
+ * Load and parse tools.yaml
+ */
+export function loadYamlConfig() {
+    const yamlPath = join(__dirname, 'yaml', 'tools.yaml');
+    const yamlContent = readFileSync(yamlPath, 'utf8');
+    return parseYaml(yamlContent);
+}
+/**
+ * Convert a single YAML tool config to MCP Tool
+ * For tools with inline parameters only
+ */
+function yamlToolToMcpTool(toolConfig) {
+    if (!toolConfig.parameters) {
+        throw new Error(`Tool ${toolConfig.name} must have parameters or useZodSchema`);
+    }
+    const zodSchema = yamlParamsToZodSchema(toolConfig.parameters);
+    const inputSchema = zodToMcpInputSchema(zodSchema);
+    return {
+        name: toolConfig.name,
+        description: toolConfig.description.trim(),
+        inputSchema,
+        category: toolConfig.category,
+        capability: toolConfig.capability,
+        useZodSchema: false,
+    };
+}
+/**
+ * Create placeholder for tools using existing Zod schemas
+ * These will be enriched with actual schemas at runtime
+ */
+function createZodSchemaPlaceholder(toolConfig) {
+    return {
+        name: toolConfig.name,
+        description: toolConfig.description.trim(),
+        inputSchema: { type: 'object', properties: {} }, // Placeholder
+        category: toolConfig.category,
+        capability: toolConfig.capability,
+        useZodSchema: true,
+        zodSchemaRef: toolConfig.zodSchemaRef,
+    };
+}
+/**
+ * Load all tools from YAML configuration
+ */
+export function loadToolsFromYaml() {
+    const config = loadYamlConfig();
+    return config.tools.map((toolConfig) => {
+        if (toolConfig.useZodSchema) {
+            // Tool uses existing Zod schema - return placeholder
+            return createZodSchemaPlaceholder(toolConfig);
+        }
+        else {
+            // Tool has inline parameters - generate schema from YAML
+            return yamlToolToMcpTool(toolConfig);
+        }
+    });
+}
+/**
+ * Get tool configuration by name
+ */
+export function getToolConfig(name) {
+    const config = loadYamlConfig();
+    return config.tools.find((t) => t.name === name);
+}
+/**
+ * Get schema descriptions for a tool (for injecting into existing Zod schemas)
+ */
+export function getSchemaDescriptions(name) {
+    const tool = getToolConfig(name);
+    return tool?.schemaDescriptions;
+}
+// ============================================================================
+// Zod Schema Registry (for tools using existing schemas)
+// ============================================================================
+import { deepResearchParamsSchema } from '../schemas/deep-research.js';
+import { scrapeLinksParamsSchema } from '../schemas/scrape-links.js';
+import { webSearchParamsSchema } from '../schemas/web-search.js';
+/**
+ * Registry of existing Zod schemas for complex tools
+ */
+const zodSchemaRegistry = {
+    deepResearchParamsSchema,
+    scrapeLinksParamsSchema,
+    webSearchParamsSchema,
+};
+/**
+ * Get Zod schema by reference name
+ */
+export function getZodSchemaByRef(ref) {
+    return zodSchemaRegistry[ref];
+}
+/**
+ * Generate complete MCP tools list with all schemas resolved
+ */
+export function generateMcpTools() {
+    const loadedTools = loadToolsFromYaml();
+    return loadedTools.map((tool) => {
+        if (tool.useZodSchema && tool.zodSchemaRef) {
+            // Resolve the actual Zod schema
+            const schema = getZodSchemaByRef(tool.zodSchemaRef);
+            if (!schema) {
+                console.error(`[Loader] Schema not found: ${tool.zodSchemaRef}`);
+                return {
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: { type: 'object', properties: {} },
+                };
+            }
+            const inputSchema = zodToMcpInputSchema(schema);
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema,
+            };
+        }
+        // Tool already has generated inputSchema
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        };
+    });
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { yamlParamsToZodSchema, yamlParamToZod };
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * TypeScript interfaces for YAML tool configuration
+ * Matches structure defined in yaml/tools.yaml
+ */
+import type { Capabilities } from './index.js';
+/**
+ * Validation rules for parameters
+ */
+export interface YamlValidation {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: 'uri' | 'email' | 'uuid';
+    min?: number;
+    max?: number;
+    int?: boolean;
+    positive?: boolean;
+    negative?: boolean;
+    minItems?: number;
+    maxItems?: number;
+    nonempty?: boolean;
+}
+/**
+ * Parameter definition in YAML
+ */
+export interface YamlParameter {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    validation?: YamlValidation;
+    items?: YamlParameter;
+    properties?: Record<string, YamlParameter>;
+}
+/**
+ * Tool definition in YAML
+ */
+export interface YamlToolConfig {
+    name: string;
+    category?: string;
+    capability?: keyof Capabilities;
+    description: string;
+    parameters?: Record<string, YamlParameter>;
+    useZodSchema?: boolean;
+    zodSchemaRef?: string;
+    schemaDescriptions?: Record<string, string>;
+}
+/**
+ * Root YAML configuration structure
+ */
+export interface YamlConfig {
+    version: string;
+    metadata: {
+        name: string;
+        description: string;
+    };
+    tools: YamlToolConfig[];
+}
+/**
+ * MCP Tool definition (matches SDK)
+ */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Loaded tool with additional metadata
+ */
+export interface LoadedTool extends McpTool {
+    category?: string;
+    capability?: keyof Capabilities;
+    useZodSchema?: boolean;
+    zodSchemaRef?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAGlC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAG5B,KAAK,CAAC,EAAE,aAAa,CAAC;IAGtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAG3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/config/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces for YAML tool configuration
+ * Matches structure defined in yaml/tools.yaml
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}