@simpletoolsindiaorg/engi-mcp 1.0.0

package/dist/resources/resources.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOURCE_LIST = exports.RESOURCE_URIS = void 0;
+exports.buildArchitectureMap = buildArchitectureMap;
+exports.buildModuleIndex = buildModuleIndex;
+exports.buildSymbolIndex = buildSymbolIndex;
+exports.buildTestMap = buildTestMap;
+exports.buildDocMap = buildDocMap;
+exports.buildPatterns = buildPatterns;
+exports.buildGlossary = buildGlossary;
+exports.readResource = readResource;
+const indexer_js_1 = require("../core/indexer/indexer.js");
+// ============================================================================
+// Resource URI constants
+// ============================================================================
+exports.RESOURCE_URIS = {
+    ARCHITECTURE_MAP: 'repo://architecture-map',
+    MODULE_INDEX: 'repo://module-index',
+    SYMBOL_INDEX: 'repo://symbol-index',
+    TEST_MAP: 'repo://test-map',
+    DOC_MAP: 'repo://doc-map',
+    PATTERNS: 'repo://patterns',
+    GLOSSARY: 'repo://glossary'
+};
+// ============================================================================
+// Resource metadata list (for ListResources)
+// ============================================================================
+exports.RESOURCE_LIST = [
+    {
+        uri: exports.RESOURCE_URIS.ARCHITECTURE_MAP,
+        name: 'Architecture Map',
+        description: 'Compact high-level module structure and dependency graph of the repository',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.MODULE_INDEX,
+        name: 'Module Index',
+        description: 'Index of all top-level modules with file counts, types, and export summaries',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.SYMBOL_INDEX,
+        name: 'Symbol Index',
+        description: 'Compact index of exported functions, classes, interfaces, and types',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.TEST_MAP,
+        name: 'Test Map',
+        description: 'Map of test files with their types and target source files',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.DOC_MAP,
+        name: 'Documentation Map',
+        description: 'Map of documentation files with section summaries',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.PATTERNS,
+        name: 'Code Patterns',
+        description: 'Common patterns detected in the repository (singletons, factories, handlers, etc.)',
+        mimeType: 'application/json'
+    },
+    {
+        uri: exports.RESOURCE_URIS.GLOSSARY,
+        name: 'Project Glossary',
+        description: 'Key terms, symbol names, file names, and module names in this repository',
+        mimeType: 'application/json'
+    }
+];
+// ============================================================================
+// Resource Builders
+// ============================================================================
+function requireIndex() {
+    return (0, indexer_js_1.getIndexer)().getIndex();
+}
+/**
+ * repo://architecture-map
+ * High-level module structure: dependencies between top-level modules
+ */
+function buildArchitectureMap() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed. Use repo_scope_find with repoPath first.' };
+    // Group files by top-level module
+    const modules = {};
+    for (const [filePath, file] of index.files) {
+        const module = filePath.split('/')[0] ?? 'root';
+        if (!modules[module]) {
+            modules[module] = { files: 0, sourceFiles: 0, testFiles: 0, exports: [], imports: [] };
+        }
+        modules[module].files++;
+        if (file.type === 'source')
+            modules[module].sourceFiles++;
+        if (file.type === 'test')
+            modules[module].testFiles++;
+        modules[module].exports.push(...file.exports.slice(0, 5));
+        modules[module].imports.push(...file.imports.map(i => i.split('/')[0] ?? i).filter(i => !i.startsWith('.')));
+    }
+    // Deduplicate
+    for (const mod of Object.values(modules)) {
+        mod.exports = [...new Set(mod.exports)].slice(0, 10);
+        mod.imports = [...new Set(mod.imports)].slice(0, 10);
+    }
+    // Build inter-module dependency edges
+    const edges = [];
+    for (const edge of index.imports) {
+        const fromModule = edge.from.split('/')[0] ?? 'root';
+        const toModule = edge.to.split('/')[0] ?? 'root';
+        if (fromModule !== toModule && !edges.some(e => e.from === fromModule && e.to === toModule)) {
+            edges.push({ from: fromModule, to: toModule });
+        }
+    }
+    return {
+        rootPath: index.rootPath,
+        lastIndexed: new Date(index.lastIndexed).toISOString(),
+        totalFiles: index.files.size,
+        modules,
+        dependencyEdges: edges
+    };
+}
+/**
+ * repo://module-index
+ * Flat index of modules with file/symbol counts
+ */
+function buildModuleIndex() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    const modules = {};
+    for (const [filePath, file] of index.files) {
+        const parts = filePath.split('/');
+        const module = parts.length > 1 ? parts[0] : 'root';
+        if (!modules[module]) {
+            modules[module] = { path: module, fileCount: 0, sourceFileCount: 0, topExports: [], language: file.language };
+        }
+        modules[module].fileCount++;
+        if (file.type === 'source') {
+            modules[module].sourceFileCount++;
+            modules[module].topExports.push(...file.exports.slice(0, 3));
+        }
+    }
+    for (const mod of Object.values(modules)) {
+        mod.topExports = [...new Set(mod.topExports)].slice(0, 10);
+    }
+    return { modules };
+}
+/**
+ * repo://symbol-index
+ * Compact index of all exported symbols
+ */
+function buildSymbolIndex() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    const exported = [];
+    for (const [, symbols] of index.symbols) {
+        for (const sym of symbols) {
+            if (sym.exported) {
+                exported.push({ name: sym.name, type: sym.type, file: sym.file, line: sym.line });
+            }
+        }
+    }
+    return {
+        totalSymbols: exported.length,
+        symbols: exported.slice(0, 200) // cap at 200 for compactness
+    };
+}
+/**
+ * repo://test-map
+ * Map of test files and their targets
+ */
+function buildTestMap() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    return {
+        totalTests: index.tests.length,
+        tests: index.tests.map(t => ({
+            path: t.path,
+            type: t.type,
+            targetFile: t.targetFile ?? null
+        }))
+    };
+}
+/**
+ * repo://doc-map
+ * Map of documentation files
+ */
+function buildDocMap() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    return {
+        totalDocs: index.docs.length,
+        docs: index.docs.map(d => ({
+            path: d.path,
+            type: d.type,
+            sections: d.sections.slice(0, 5)
+        }))
+    };
+}
+/**
+ * repo://patterns
+ * Detect common code patterns in the repo
+ */
+function buildPatterns() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    const singletons = [];
+    const factories = [];
+    const handlers = [];
+    const schemas = [];
+    for (const [filePath, symbols] of index.symbols) {
+        for (const sym of symbols) {
+            const nameLower = sym.name.toLowerCase();
+            if (nameLower.startsWith('get') && sym.type === 'function') {
+                singletons.push(`${sym.name} (${filePath})`);
+            }
+            if (nameLower.includes('factory') || nameLower.includes('create')) {
+                factories.push(`${sym.name} (${filePath})`);
+            }
+            if (nameLower.includes('handler') || nameLower.includes('middleware')) {
+                handlers.push(`${sym.name} (${filePath})`);
+            }
+            if (nameLower.includes('schema') || nameLower.includes('validator')) {
+                schemas.push(`${sym.name} (${filePath})`);
+            }
+        }
+    }
+    return {
+        singletonGetters: singletons.slice(0, 20),
+        factories: factories.slice(0, 20),
+        handlers: handlers.slice(0, 20),
+        schemas: schemas.slice(0, 20)
+    };
+}
+/**
+ * repo://glossary
+ * Key names (symbols, files, modules) for quick reference
+ */
+function buildGlossary() {
+    const index = requireIndex();
+    if (!index)
+        return { error: 'No repository indexed.' };
+    const modules = new Set();
+    const fileNames = new Set();
+    const exportedSymbols = new Set();
+    for (const [filePath, file] of index.files) {
+        const mod = filePath.split('/')[0];
+        if (mod)
+            modules.add(mod);
+        fileNames.add(file.name);
+        file.exports.forEach(e => exportedSymbols.add(e));
+    }
+    return {
+        modules: [...modules].sort(),
+        fileNames: [...fileNames].sort().slice(0, 100),
+        exportedSymbols: [...exportedSymbols].sort().slice(0, 200)
+    };
+}
+// ============================================================================
+// Resource Router
+// ============================================================================
+function readResource(uri) {
+    const builders = {
+        [exports.RESOURCE_URIS.ARCHITECTURE_MAP]: buildArchitectureMap,
+        [exports.RESOURCE_URIS.MODULE_INDEX]: buildModuleIndex,
+        [exports.RESOURCE_URIS.SYMBOL_INDEX]: buildSymbolIndex,
+        [exports.RESOURCE_URIS.TEST_MAP]: buildTestMap,
+        [exports.RESOURCE_URIS.DOC_MAP]: buildDocMap,
+        [exports.RESOURCE_URIS.PATTERNS]: buildPatterns,
+        [exports.RESOURCE_URIS.GLOSSARY]: buildGlossary
+    };
+    const builder = builders[uri];
+    if (!builder)
+        return null;
+    return {
+        content: JSON.stringify(builder(), null, 2),
+        mimeType: 'application/json'
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources/resources.js.map

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

package/dist/utils/formatter.d.ts

@@ -0,0 +1,26 @@
+import { Verbosity } from '../core/types.js';
+/**
+ * Filter object fields based on verbosity level.
+ * minimal: only include key fields
+ * standard: include most fields
+ * detailed: include everything
+ */
+export declare function filterByVerbosity<T extends object>(obj: T, verbosity: Verbosity, minimalFields: (keyof T)[], standardFields: (keyof T)[]): Partial<T>;
+/**
+ * Format a list of items, truncating if too many for the verbosity level
+ */
+export declare function formatList(items: string[], verbosity: Verbosity, label?: string): string;
+/**
+ * Format a compact summary string from key-value pairs
+ */
+export declare function formatCompact(pairs: Record<string, string | number | boolean | undefined>): string;
+/**
+ * Wrap a tool result with verbosity metadata for downstream use
+ */
+export interface VerboseResult<T> {
+    data: T;
+    verbosity: Verbosity;
+    tokenEstimate?: number;
+}
+export declare function wrapResult<T>(data: T, verbosity: Verbosity): VerboseResult<T>;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAC1B,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,SAAS,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,MAAM,CAKlG;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAE7E"}

package/dist/utils/formatter.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterByVerbosity = filterByVerbosity;
+exports.formatList = formatList;
+exports.formatCompact = formatCompact;
+exports.wrapResult = wrapResult;
+/**
+ * Filter object fields based on verbosity level.
+ * minimal: only include key fields
+ * standard: include most fields
+ * detailed: include everything
+ */
+function filterByVerbosity(obj, verbosity, minimalFields, standardFields) {
+    if (verbosity === 'detailed') {
+        return obj;
+    }
+    const fields = verbosity === 'minimal' ? minimalFields : standardFields;
+    const result = {};
+    for (const field of fields) {
+        if (field in obj) {
+            result[field] = obj[field];
+        }
+    }
+    return result;
+}
+/**
+ * Format a list of items, truncating if too many for the verbosity level
+ */
+function formatList(items, verbosity, label) {
+    const limits = {
+        minimal: 3,
+        standard: 10,
+        detailed: items.length
+    };
+    const limit = limits[verbosity];
+    const shown = items.slice(0, limit);
+    const remaining = items.length - shown.length;
+    let result = shown.join(', ');
+    if (remaining > 0) {
+        result += ` (+${remaining} more)`;
+    }
+    return label ? `${label}: ${result}` : result;
+}
+/**
+ * Format a compact summary string from key-value pairs
+ */
+function formatCompact(pairs) {
+    return Object.entries(pairs)
+        .filter(([, v]) => v !== undefined && v !== null && v !== '')
+        .map(([k, v]) => `${k}=${v}`)
+        .join(' | ');
+}
+function wrapResult(data, verbosity) {
+    return { data, verbosity };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/utils/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":";;AASA,8CAkBC;AAKD,gCAmBC;AAKD,sCAKC;AAWD,gCAEC;AAvED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,GAAM,EACN,SAAoB,EACpB,aAA0B,EAC1B,cAA2B;IAE3B,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;IACxE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CACxB,KAAe,EACf,SAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAA8B;QACxC,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC,MAAM;KACvB,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE9C,IAAI,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,MAAM,SAAS,QAAQ,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAA4D;IACxF,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAWD,SAAgB,UAAU,CAAI,IAAO,EAAE,SAAoB;IACzD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { logger } from './logger.js';
+export type { LogLevel, LogEntry } from './logger.js';
+export { estimateTokens, estimateObjectTokens, truncateToTokenBudget, checkTokenBudget } from './token-counter.js';
+export type { TokenBudgetSummary } from './token-counter.js';
+export { filterByVerbosity, formatList, formatCompact, wrapResult } from './formatter.js';
+export type { VerboseResult } from './formatter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapResult = exports.formatCompact = exports.formatList = exports.filterByVerbosity = exports.checkTokenBudget = exports.truncateToTokenBudget = exports.estimateObjectTokens = exports.estimateTokens = exports.logger = void 0;
+// Utils module exports
+var logger_js_1 = require("./logger.js");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_js_1.logger; } });
+var token_counter_js_1 = require("./token-counter.js");
+Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return token_counter_js_1.estimateTokens; } });
+Object.defineProperty(exports, "estimateObjectTokens", { enumerable: true, get: function () { return token_counter_js_1.estimateObjectTokens; } });
+Object.defineProperty(exports, "truncateToTokenBudget", { enumerable: true, get: function () { return token_counter_js_1.truncateToTokenBudget; } });
+Object.defineProperty(exports, "checkTokenBudget", { enumerable: true, get: function () { return token_counter_js_1.checkTokenBudget; } });
+var formatter_js_1 = require("./formatter.js");
+Object.defineProperty(exports, "filterByVerbosity", { enumerable: true, get: function () { return formatter_js_1.filterByVerbosity; } });
+Object.defineProperty(exports, "formatList", { enumerable: true, get: function () { return formatter_js_1.formatList; } });
+Object.defineProperty(exports, "formatCompact", { enumerable: true, get: function () { return formatter_js_1.formatCompact; } });
+Object.defineProperty(exports, "wrapResult", { enumerable: true, get: function () { return formatter_js_1.wrapResult; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AAGf,uDAK4B;AAJ1B,kHAAA,cAAc,OAAA;AACd,wHAAA,oBAAoB,OAAA;AACpB,yHAAA,qBAAqB,OAAA;AACrB,oHAAA,gBAAgB,OAAA;AAIlB,+CAKwB;AAJtB,iHAAA,iBAAiB,OAAA;AACjB,0GAAA,UAAU,OAAA;AACV,6GAAA,aAAa,OAAA;AACb,0GAAA,UAAU,OAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,21 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: number;
+    args?: unknown[];
+}
+declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    private format;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    setLevel(level: LogLevel): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;gBAEZ,KAAK,GAAE,QAAiB;IAIpC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,MAAM;IAMd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGhC;AAGD,eAAO,MAAM,MAAM,QAElB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+class Logger {
+    level;
+    constructor(level = 'info') {
+        this.level = level;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    format(level, message, args) {
+        const timestamp = new Date().toISOString();
+        const argsStr = args.length > 0 ? ' ' + args.map(a => typeof a === 'object' ? JSON.stringify(a) : String(a)).join(' ') : '';
+        return `[${timestamp}] [${level.toUpperCase()}] ${message}${argsStr}`;
+    }
+    debug(message, ...args) {
+        if (this.shouldLog('debug')) {
+            process.stderr.write(this.format('debug', message, args) + '\n');
+        }
+    }
+    info(message, ...args) {
+        if (this.shouldLog('info')) {
+            process.stderr.write(this.format('info', message, args) + '\n');
+        }
+    }
+    warn(message, ...args) {
+        if (this.shouldLog('warn')) {
+            process.stderr.write(this.format('warn', message, args) + '\n');
+        }
+    }
+    error(message, ...args) {
+        if (this.shouldLog('error')) {
+            process.stderr.write(this.format('error', message, args) + '\n');
+        }
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+}
+// Singleton logger
+exports.logger = new Logger(process.env.LOG_LEVEL ?? 'info');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAUA,MAAM,MAAM;IACF,KAAK,CAAW;IAExB,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,OAAe,EAAE,IAAe;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5H,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,mBAAmB;AACN,QAAA,MAAM,GAAG,IAAI,MAAM,CAC7B,OAAO,CAAC,GAAG,CAAC,SAAkC,IAAI,MAAM,CAC1D,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Rough token estimation: ~4 chars per token for English text
+ * This is a fast approximation — good enough for budgeting purposes.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Estimate tokens for a JSON-serializable object
+ */
+export declare function estimateObjectTokens(obj: unknown): number;
+/**
+ * Truncate text to fit within a token budget
+ */
+export declare function truncateToTokenBudget(text: string, maxTokens: number): string;
+/**
+ * Token budget summary for a response object
+ */
+export interface TokenBudgetSummary {
+    estimated: number;
+    withinBudget: boolean;
+    budget: number;
+    efficiency: number;
+}
+export declare function checkTokenBudget(obj: unknown, budget?: number): TokenBudgetSummary;
+//# 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":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAa,GAAG,kBAAkB,CAQxF"}

package/dist/utils/token-counter.js

@@ -0,0 +1,49 @@
+"use strict";
+// Token counter utility - estimates token usage to help minimize context usage
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateTokens = estimateTokens;
+exports.estimateObjectTokens = estimateObjectTokens;
+exports.truncateToTokenBudget = truncateToTokenBudget;
+exports.checkTokenBudget = checkTokenBudget;
+/**
+ * Rough token estimation: ~4 chars per token for English text
+ * This is a fast approximation — good enough for budgeting purposes.
+ */
+function estimateTokens(text) {
+    if (!text)
+        return 0;
+    // Words count more accurately: avg 1.3 tokens per word
+    const words = text.trim().split(/\s+/).filter(w => w.length > 0);
+    const chars = text.length;
+    // Use the average of char-based and word-based estimates
+    const charEstimate = Math.ceil(chars / 4);
+    const wordEstimate = Math.ceil(words.length * 1.3);
+    return Math.ceil((charEstimate + wordEstimate) / 2);
+}
+/**
+ * Estimate tokens for a JSON-serializable object
+ */
+function estimateObjectTokens(obj) {
+    return estimateTokens(JSON.stringify(obj));
+}
+/**
+ * Truncate text to fit within a token budget
+ */
+function truncateToTokenBudget(text, maxTokens) {
+    const current = estimateTokens(text);
+    if (current <= maxTokens)
+        return text;
+    // Estimate how many chars we can keep
+    const charBudget = Math.floor(maxTokens * 4);
+    return text.slice(0, charBudget) + '... [truncated]';
+}
+function checkTokenBudget(obj, budget = 2000) {
+    const estimated = estimateObjectTokens(obj);
+    return {
+        estimated,
+        withinBudget: estimated <= budget,
+        budget,
+        efficiency: Math.min(budget / Math.max(estimated, 1), 1)
+    };
+}
+//# 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":";AAAA,+EAA+E;;AAM/E,wCASC;AAKD,oDAEC;AAKD,sDAOC;AAYD,4CAQC;AApDD;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,uDAAuD;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,yDAAyD;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,IAAY,EAAE,SAAiB;IACnE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAEtC,sCAAsC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAAC;AACvD,CAAC;AAYD,SAAgB,gBAAgB,CAAC,GAAY,EAAE,SAAiB,IAAI;IAClE,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO;QACL,SAAS;QACT,YAAY,EAAE,SAAS,IAAI,MAAM;QACjC,MAAM;QACN,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC"}