mnehmos.trace.mcp 1.0.0

package/dist/tools/contract-comments.js

@@ -0,0 +1,130 @@
+/**
+ * Contract Comments Tool
+ * Adds cross-reference comments to producer and consumer code
+ * when a contract is validated as working.
+ */
+import { Project, SyntaxKind } from 'ts-morph';
+/**
+ * Generate cross-reference comments for a validated contract
+ */
+export function generateContractComments(options) {
+    const { match, producer, consumer, style = 'block', includeTimestamp = true, prefix = '@trace-contract' } = options;
+    const timestamp = includeTimestamp ? ` | Validated: ${new Date().toISOString().split('T')[0]}` : '';
+    // Producer comment points to consumer
+    const producerComment = formatComment({
+        style,
+        lines: [
+            `${prefix} PRODUCER`,
+            `Tool: ${match.toolName}`,
+            `Consumer: ${consumer.callSite.file}:${consumer.callSite.line}`,
+            `Args: ${Object.keys(consumer.argumentsProvided).join(', ')}`,
+            `Expected Props: ${consumer.expectedProperties.slice(0, 5).join(', ')}${consumer.expectedProperties.length > 5 ? '...' : ''}`,
+            timestamp ? `Validated: ${timestamp}` : '',
+        ].filter(Boolean),
+    });
+    // Consumer comment points to producer  
+    const consumerComment = formatComment({
+        style,
+        lines: [
+            `${prefix} CONSUMER`,
+            `Tool: ${match.toolName}`,
+            `Producer: ${producer.location.file}:${producer.location.line}`,
+            `Required Args: ${producer.inputSchema.required?.join(', ') || 'none'}`,
+            `Schema Props: ${Object.keys(producer.inputSchema.properties || {}).join(', ')}`,
+            timestamp ? `Validated: ${timestamp}` : '',
+        ].filter(Boolean),
+    });
+    return { producerComment, consumerComment };
+}
+/**
+ * Format a comment based on style
+ */
+function formatComment(options) {
+    const { style, lines } = options;
+    switch (style) {
+        case 'jsdoc':
+            return `/**\n${lines.map(l => ` * ${l}`).join('\n')}\n */`;
+        case 'inline':
+            return lines.map(l => `// ${l}`).join('\n');
+        case 'block':
+        default:
+            return `/*\n${lines.map(l => ` * ${l}`).join('\n')}\n */`;
+    }
+}
+/**
+ * Add contract comments to source files
+ * WARNING: This modifies files! Use with caution.
+ */
+export async function addContractComments(options) {
+    const { match, producer, consumer } = options;
+    const { producerComment, consumerComment } = generateContractComments(options);
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+    });
+    try {
+        // Add comment to producer file
+        const producerFile = project.addSourceFileAtPath(producer.location.file);
+        const producerNode = findNodeAtLine(producerFile, producer.location.line);
+        if (producerNode) {
+            // Add comment before the tool definition
+            producerNode.replaceWithText(`${producerComment}\n${producerNode.getText()}`);
+        }
+        // Add comment to consumer file
+        const consumerFile = project.addSourceFileAtPath(consumer.callSite.file);
+        const consumerNode = findNodeAtLine(consumerFile, consumer.callSite.line);
+        if (consumerNode) {
+            // Add comment before the callTool invocation
+            consumerNode.replaceWithText(`${consumerComment}\n${consumerNode.getText()}`);
+        }
+        // Save changes
+        await project.save();
+        return {
+            success: true,
+            producerFile: producer.location.file,
+            consumerFile: consumer.callSite.file,
+            producerComment,
+            consumerComment,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            producerFile: producer.location.file,
+            consumerFile: consumer.callSite.file,
+            producerComment,
+            consumerComment,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Find the statement node at a specific line
+ */
+function findNodeAtLine(sourceFile, line) {
+    let targetNode = null;
+    sourceFile.forEachDescendant((node) => {
+        if (node.getStartLineNumber() === line) {
+            // Prefer statement-level nodes
+            const parent = node.getParent();
+            if (parent && parent.getKind() === SyntaxKind.ExpressionStatement) {
+                targetNode = parent;
+            }
+            else if (!targetNode) {
+                targetNode = node;
+            }
+        }
+    });
+    return targetNode;
+}
+/**
+ * Preview what comments would be added without modifying files
+ */
+export function previewContractComments(options) {
+    const { producerComment, consumerComment } = generateContractComments(options);
+    const { producer, consumer } = options;
+    return {
+        producerPreview: `// At ${producer.location.file}:${producer.location.line}\n${producerComment}`,
+        consumerPreview: `// At ${consumer.callSite.file}:${consumer.callSite.line}\n${consumerComment}`,
+    };
+}
+//# sourceMappingURL=contract-comments.js.map

package/dist/tools/contract-comments.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tools module exports
+ */
+export { generateContractComments, addContractComments, previewContractComments, type ContractCommentOptions, type CommentResult, } from './contract-comments.js';
+export { scaffoldConsumerFromProducer, scaffoldProducerFromConsumer, type ScaffoldOptions, type ScaffoldResult, } from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+/**
+ * Tools module exports
+ */
+export { generateContractComments, addContractComments, previewContractComments, } from './contract-comments.js';
+export { scaffoldConsumerFromProducer, scaffoldProducerFromConsumer, } from './scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,GAGxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAG7B,MAAM,eAAe,CAAC"}

package/dist/tools/scaffold.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Contract Scaffold Tool
+ * Generate consumer code from producer schema (or vice versa)
+ */
+import type { ProducerSchema, ConsumerSchema } from '../types.js';
+export interface ScaffoldOptions {
+    /** Output language/framework */
+    target: 'typescript' | 'javascript' | 'react-hook' | 'zustand-action';
+    /** Include error handling */
+    includeErrorHandling?: boolean;
+    /** Include TypeScript types */
+    includeTypes?: boolean;
+    /** Function name prefix */
+    functionPrefix?: string;
+    /** Add JSDoc comments */
+    includeJSDoc?: boolean;
+}
+export interface ScaffoldResult {
+    /** Generated code */
+    code: string;
+    /** Suggested filename */
+    suggestedFilename: string;
+    /** TypeScript type definitions (if applicable) */
+    types?: string;
+    /** Usage example */
+    example: string;
+}
+/**
+ * Generate consumer code from a producer schema
+ */
+export declare function scaffoldConsumerFromProducer(producer: ProducerSchema, options?: ScaffoldOptions): ScaffoldResult;
+/**
+ * Generate producer schema stub from consumer usage
+ */
+export declare function scaffoldProducerFromConsumer(consumer: ConsumerSchema, options?: {
+    includeHandler?: boolean;
+}): ScaffoldResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/tools/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACtE,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,eAA0C,GAClD,cAAc,CAyChB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,cAAc,CA2ChB"}

package/dist/tools/scaffold.js

@@ -0,0 +1,373 @@
+/**
+ * Contract Scaffold Tool
+ * Generate consumer code from producer schema (or vice versa)
+ */
+/**
+ * Generate consumer code from a producer schema
+ */
+export function scaffoldConsumerFromProducer(producer, options = { target: 'typescript' }) {
+    const { target, includeErrorHandling = true, includeTypes = true, functionPrefix = '', includeJSDoc = true } = options;
+    const toolName = producer.toolName;
+    const functionName = `${functionPrefix}${toCamelCase(toolName)}`;
+    const inputProps = producer.inputSchema.properties || {};
+    const requiredArgs = producer.inputSchema.required || [];
+    // Generate TypeScript interface for args
+    const argsInterface = generateArgsInterface(toolName, inputProps, requiredArgs);
+    // Generate the function based on target
+    let code;
+    let types;
+    let example;
+    switch (target) {
+        case 'react-hook':
+            ({ code, types, example } = generateReactHook(toolName, functionName, inputProps, requiredArgs, { includeErrorHandling, includeTypes, includeJSDoc, producer }));
+            break;
+        case 'zustand-action':
+            ({ code, types, example } = generateZustandAction(toolName, functionName, inputProps, requiredArgs, { includeErrorHandling, includeTypes, includeJSDoc, producer }));
+            break;
+        case 'javascript':
+            const jsResult = generateJavaScript(toolName, functionName, inputProps, requiredArgs, { includeErrorHandling, includeJSDoc, producer });
+            code = jsResult.code;
+            example = jsResult.example;
+            types = undefined;
+            break;
+        case 'typescript':
+        default:
+            ({ code, types, example } = generateTypeScript(toolName, functionName, inputProps, requiredArgs, { includeErrorHandling, includeTypes, includeJSDoc, producer }));
+            break;
+    }
+    return {
+        code,
+        suggestedFilename: `use-${toKebabCase(toolName)}.${target === 'javascript' ? 'js' : 'ts'}`,
+        types,
+        example,
+    };
+}
+/**
+ * Generate producer schema stub from consumer usage
+ */
+export function scaffoldProducerFromConsumer(consumer, options = {}) {
+    const { includeHandler = true } = options;
+    const toolName = consumer.toolName;
+    const args = consumer.argumentsProvided;
+    // Infer types from argument values (basic inference)
+    const inferredSchema = inferSchemaFromArgs(args);
+    const code = `
+import { z } from 'zod';
+
+// Tool: ${toolName}
+// Scaffolded from consumer at ${consumer.callSite.file}:${consumer.callSite.line}
+// @trace-contract PRODUCER (scaffolded)
+
+server.tool(
+  '${toolName}',
+  'TODO: Add description',
+  {
+${Object.entries(inferredSchema)
+        .map(([key, type]) => `    ${key}: ${type},`)
+        .join('\n')}
+  },
+${includeHandler ? `  async (args) => {
+    // TODO: Implement handler
+    // Consumer expects these properties: ${consumer.expectedProperties.join(', ')}
+    return {
+      content: [{
+        type: 'text',
+        text: JSON.stringify({
+${consumer.expectedProperties.map(p => `          ${p}: null, // TODO`).join('\n')}
+        })
+      }]
+    };
+  }` : '  async (args) => { /* TODO */ }'}
+);
+`.trim();
+    return {
+        code,
+        suggestedFilename: `${toKebabCase(toolName)}-tool.ts`,
+        example: `// This tool is called by:\n// ${consumer.callSite.file}:${consumer.callSite.line}`,
+    };
+}
+// ============================================================================
+// Generator Functions
+// ============================================================================
+function generateTypeScript(toolName, functionName, inputProps, requiredArgs, options) {
+    const { includeErrorHandling, includeTypes, includeJSDoc, producer } = options;
+    const argsType = `${toPascalCase(toolName)}Args`;
+    const resultType = `${toPascalCase(toolName)}Result`;
+    const types = includeTypes ? `
+export interface ${argsType} {
+${Object.entries(inputProps)
+        .map(([key, schema]) => `  ${key}${requiredArgs.includes(key) ? '' : '?'}: ${jsonSchemaToTsType(schema)};`)
+        .join('\n')}
+}
+
+export interface ${resultType} {
+  // TODO: Define based on actual response
+  [key: string]: unknown;
+}
+`.trim() : undefined;
+    const jsdoc = includeJSDoc ? `
+/**
+ * ${producer.description || `Call the ${toolName} tool`}
+ * @trace-contract CONSUMER
+ * Producer: ${producer.location.file}:${producer.location.line}
+ */` : '';
+    const code = `
+${jsdoc}
+export async function ${functionName}(
+  client: McpClient,
+  args: ${includeTypes ? argsType : `{ ${Object.keys(inputProps).join(', ')} }`}
+): Promise<${includeTypes ? resultType : 'unknown'}> {
+${includeErrorHandling ? `  try {
+    const result = await client.callTool('${toolName}', args);
+    return JSON.parse(result.content[0].text);
+  } catch (error) {
+    console.error('Error calling ${toolName}:', error);
+    throw error;
+  }` : `  const result = await client.callTool('${toolName}', args);
+  return JSON.parse(result.content[0].text);`}
+}
+`.trim();
+    const example = `
+// Usage:
+const result = await ${functionName}(client, {
+${requiredArgs.map(arg => `  ${arg}: /* ${jsonSchemaToTsType(inputProps[arg])} */,`).join('\n')}
+});
+`.trim();
+    return { code, types, example };
+}
+function generateJavaScript(toolName, functionName, inputProps, requiredArgs, options) {
+    const { includeErrorHandling, includeJSDoc, producer } = options;
+    const jsdoc = includeJSDoc ? `
+/**
+ * ${producer.description || `Call the ${toolName} tool`}
+ * @param {Object} client - MCP client
+ * @param {Object} args - Tool arguments
+${Object.entries(inputProps)
+        .map(([key, schema]) => ` * @param {${jsonSchemaToJsType(schema)}} args.${key}`)
+        .join('\n')}
+ * @returns {Promise<Object>}
+ */` : '';
+    const code = `
+${jsdoc}
+export async function ${functionName}(client, args) {
+${includeErrorHandling ? `  try {
+    const result = await client.callTool('${toolName}', args);
+    return JSON.parse(result.content[0].text);
+  } catch (error) {
+    console.error('Error calling ${toolName}:', error);
+    throw error;
+  }` : `  const result = await client.callTool('${toolName}', args);
+  return JSON.parse(result.content[0].text);`}
+}
+`.trim();
+    const example = `
+// Usage:
+const result = await ${functionName}(client, {
+${requiredArgs.map(arg => `  ${arg}: /* value */,`).join('\n')}
+});
+`.trim();
+    return { code, example };
+}
+function generateReactHook(toolName, _functionName, inputProps, requiredArgs, options) {
+    const { includeTypes, producer } = options;
+    const hookName = `use${toPascalCase(toolName)}`;
+    const argsType = `${toPascalCase(toolName)}Args`;
+    const types = includeTypes ? `
+export interface ${argsType} {
+${Object.entries(inputProps)
+        .map(([key, schema]) => `  ${key}${requiredArgs.includes(key) ? '' : '?'}: ${jsonSchemaToTsType(schema)};`)
+        .join('\n')}
+}
+`.trim() : undefined;
+    const code = `
+import { useState, useCallback } from 'react';
+import { useMcpClient } from './mcp-context'; // Adjust import
+
+/**
+ * ${producer.description || `Hook for ${toolName} tool`}
+ * @trace-contract CONSUMER (React Hook)
+ * Producer: ${producer.location.file}:${producer.location.line}
+ */
+export function ${hookName}() {
+  const client = useMcpClient();
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+  const [data, setData] = useState<unknown>(null);
+
+  const execute = useCallback(async (args: ${includeTypes ? argsType : 'Record<string, unknown>'}) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.callTool('${toolName}', args);
+      const parsed = JSON.parse(result.content[0].text);
+      setData(parsed);
+      return parsed;
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+
+  return { execute, loading, error, data };
+}
+`.trim();
+    const example = `
+// Usage in React component:
+function MyComponent() {
+  const { execute, loading, error, data } = ${hookName}();
+  
+  const handleClick = async () => {
+    await execute({
+${requiredArgs.map(arg => `      ${arg}: /* value */,`).join('\n')}
+    });
+  };
+  
+  if (loading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+  return <div>{JSON.stringify(data)}</div>;
+}
+`.trim();
+    return { code, types, example };
+}
+function generateZustandAction(toolName, _functionName, inputProps, requiredArgs, options) {
+    const { includeTypes, producer } = options;
+    const actionName = toCamelCase(toolName);
+    const argsType = `${toPascalCase(toolName)}Args`;
+    const types = includeTypes ? `
+export interface ${argsType} {
+${Object.entries(inputProps)
+        .map(([key, schema]) => `  ${key}${requiredArgs.includes(key) ? '' : '?'}: ${jsonSchemaToTsType(schema)};`)
+        .join('\n')}
+}
+`.trim() : undefined;
+    const code = `
+/**
+ * Zustand action for ${toolName}
+ * @trace-contract CONSUMER (Zustand)
+ * Producer: ${producer.location.file}:${producer.location.line}
+ */
+export const create${toPascalCase(toolName)}Slice = (set: any, get: any) => ({
+  ${actionName}Loading: false,
+  ${actionName}Error: null as Error | null,
+  ${actionName}Data: null as unknown,
+  
+  ${actionName}: async (args: ${includeTypes ? argsType : 'Record<string, unknown>'}) => {
+    const { mcpClient } = get();
+    set({ ${actionName}Loading: true, ${actionName}Error: null });
+    
+    try {
+      const result = await mcpClient.callTool('${toolName}', args);
+      const data = JSON.parse(result.content[0].text);
+      set({ ${actionName}Data: data, ${actionName}Loading: false });
+      return data;
+    } catch (error) {
+      set({ 
+        ${actionName}Error: error instanceof Error ? error : new Error(String(error)),
+        ${actionName}Loading: false 
+      });
+      throw error;
+    }
+  },
+});
+`.trim();
+    const example = `
+// Add to your Zustand store:
+import { create } from 'zustand';
+
+const useStore = create((set, get) => ({
+  mcpClient: null,
+  setMcpClient: (client) => set({ mcpClient: client }),
+  ...create${toPascalCase(toolName)}Slice(set, get),
+}));
+
+// Usage:
+const { ${actionName}, ${actionName}Loading, ${actionName}Data } = useStore();
+await ${actionName}({
+${requiredArgs.map(arg => `  ${arg}: /* value */,`).join('\n')}
+});
+`.trim();
+    return { code, types, example };
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function generateArgsInterface(toolName, props, required) {
+    const lines = Object.entries(props).map(([key, schema]) => {
+        const optional = required.includes(key) ? '' : '?';
+        const type = jsonSchemaToTsType(schema);
+        return `  ${key}${optional}: ${type};`;
+    });
+    return `interface ${toPascalCase(toolName)}Args {\n${lines.join('\n')}\n}`;
+}
+function jsonSchemaToTsType(schema) {
+    if (!schema.type)
+        return 'unknown';
+    switch (schema.type) {
+        case 'string':
+            if (schema.enum && Array.isArray(schema.enum)) {
+                return schema.enum.map((v) => `'${v}'`).join(' | ');
+            }
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'array':
+            return `${jsonSchemaToTsType(schema.items || {})}[]`;
+        case 'object':
+            return 'Record<string, unknown>';
+        default:
+            return 'unknown';
+    }
+}
+function jsonSchemaToJsType(schema) {
+    if (!schema.type)
+        return '*';
+    switch (schema.type) {
+        case 'string': return 'string';
+        case 'number':
+        case 'integer': return 'number';
+        case 'boolean': return 'boolean';
+        case 'array': return 'Array';
+        case 'object': return 'Object';
+        default: return '*';
+    }
+}
+function inferSchemaFromArgs(args) {
+    const schema = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === 'string' || value === '<value>') {
+            schema[key] = 'z.string()';
+        }
+        else if (typeof value === 'number') {
+            schema[key] = 'z.number()';
+        }
+        else if (typeof value === 'boolean') {
+            schema[key] = 'z.boolean()';
+        }
+        else if (Array.isArray(value)) {
+            schema[key] = 'z.array(z.unknown())';
+        }
+        else if (typeof value === 'object') {
+            schema[key] = 'z.object({})';
+        }
+        else {
+            schema[key] = 'z.unknown()';
+        }
+    }
+    return schema;
+}
+function toCamelCase(str) {
+    return str.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function toPascalCase(str) {
+    const camel = toCamelCase(str);
+    return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+function toKebabCase(str) {
+    return str.replace(/_/g, '-').toLowerCase();
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/tools/scaffold.js.map

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

package/dist/trace/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Trace MCP - Consumer Tracer
+ * Thin wrapper that delegates to language-specific parsers
+ */
+import type { ConsumerSchema } from '../types.js';
+export interface TracerOptions {
+    /** Root directory of the consumer source */
+    rootDir: string;
+    /** Language of the source files */
+    language?: string;
+    /** Patterns to identify MCP client calls */
+    callPatterns?: string[];
+    /** Glob patterns to include */
+    include?: string[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+}
+/**
+ * Trace MCP tool usage in consumer code
+ * Defaults to TypeScript parser for backward compatibility
+ */
+export declare function traceConsumerUsage(options: TracerOptions): Promise<ConsumerSchema[]>;
+/**
+ * Trace usage from a single file
+ * Defaults to TypeScript parser for backward compatibility
+ */
+export declare function traceFromFile(filePath: string, language?: string): Promise<ConsumerSchema[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CAmB3B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAsBlG"}