@aquex/cmos-mcp 1.0.0

package/dist/tools/import-template.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * MCP Tool: import_template
+ *
+ * Exposes the secure template import functionality as an MCP tool
+ * for use in Claude Desktop and other MCP-compatible environments.
+ *
+ * Implements the 6-layer security validation pipeline from R3.2.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importTemplateToolDefinitionDeprecated = exports.createTemplateImportToolDefinition = void 0;
+exports.importTemplate = importTemplate;
+const path_1 = __importDefault(require("path"));
+const zod_1 = require("zod");
+const template_importer_1 = require("../import-export/template-importer");
+const common_1 = require("../validation/common");
+const middleware_1 = require("../validation/middleware");
+const file_path_schema_1 = require("../validation/schemas/file-path-schema");
+const errors_1 = require("../validation/errors");
+/**
+ * Main entry point for the import_template MCP tool
+ */
+async function importTemplate(params) {
+    try {
+        const validated = await validateParams(params);
+        // Determine base directory
+        const baseDir = validated.baseDir
+            ? await (0, common_1.safeFilePath)(path_1.default.resolve(validated.baseDir), { allowRelative: false })
+            : process.cwd();
+        // Build semantic validation rules
+        const semanticRules = {
+            maxResourceMemory: validated.maxResourceMemory,
+            maxResourceCpu: validated.maxResourceCpu,
+            allowedActions: validated.allowedActions ?? [],
+            urlAllowlist: validated.urlAllowlist ?? [],
+        };
+        // Build import options
+        const options = {
+            skipSignatureVerification: validated.skipSignatureVerification || false,
+            semanticRules,
+            trustLevel: validated.trustLevel,
+        };
+        // Create importer
+        const importer = new template_importer_1.TemplateImporter(baseDir, options);
+        // Execute import with full 6-layer validation
+        const sanitizedPath = await (0, common_1.safeFilePath)(validated.templatePath, {
+            allowRelative: true,
+            maxLength: 2048,
+            allowedExtensions: ['.yaml', '.yml'],
+        });
+        const result = await importer.import(sanitizedPath, options);
+        // Convert dependencies map to object for JSON serialization
+        const dependencies = {};
+        result.resolvedDependencies.forEach((template, name) => {
+            dependencies[name] = {
+                name: template.metadata.name,
+                version: template.metadata.version,
+            };
+        });
+        // Build success response
+        return {
+            success: true,
+            template: {
+                name: result.template.metadata.name,
+                version: result.template.metadata.version,
+                author: result.template.metadata.author,
+                apiVersion: result.template.apiVersion,
+                spec: result.template.spec,
+            },
+            validationReport: {
+                valid: result.validationReport.valid,
+                performanceMs: result.validationReport.performanceMs,
+                layers: result.validationReport.layers,
+                errors: result.validationReport.errors,
+                warnings: result.validationReport.warnings,
+            },
+            dependencies: Object.keys(dependencies).length > 0 ? dependencies : undefined,
+            message: `Template "${result.template.metadata.name}" v${result.template.metadata.version} imported successfully in ${result.validationReport.performanceMs}ms`,
+        };
+    }
+    catch (error) {
+        if (error instanceof errors_1.ValidationError) {
+            const maybeMessages = error.data?.messages;
+            const dataMessages = Array.isArray(maybeMessages)
+                ? maybeMessages.filter((message) => typeof message === 'string')
+                : undefined;
+            const detailMessages = dataMessages && dataMessages.length > 0
+                ? dataMessages
+                : error.issues?.map((issue) => issue.message).filter(Boolean);
+            const detail = detailMessages && detailMessages.length > 0 ? detailMessages[0] : error.message;
+            const errorsList = detailMessages && detailMessages.length > 0 ? detailMessages : [detail];
+            return {
+                success: false,
+                validationReport: {
+                    valid: false,
+                    performanceMs: 0,
+                    layers: [],
+                    errors: errorsList,
+                    warnings: [],
+                },
+                message: `Import failed: ${detail}`,
+            };
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            validationReport: {
+                valid: false,
+                performanceMs: 0,
+                layers: [],
+                errors: [errorMessage],
+                warnings: [],
+            },
+            message: `Import failed: ${errorMessage}`,
+        };
+    }
+}
+/**
+ * Validate input parameters
+ */
+const ImportTemplateParamsSchema = zod_1.z
+    .object({
+    templatePath: (0, file_path_schema_1.createFilePathSchema)({
+        allowRelative: true,
+        allowedExtensions: ['.yaml', '.yml'],
+    }),
+    baseDir: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }).optional(),
+    skipSignatureVerification: zod_1.z.boolean().optional(),
+    trustLevel: zod_1.z.enum(['verified-internal', 'signed-known', 'untrusted']).optional(),
+    maxResourceMemory: zod_1.z.number().int().positive().max(32768).optional(),
+    maxResourceCpu: zod_1.z.number().int().positive().max(128).optional(),
+    allowedActions: zod_1.z.array(zod_1.z.string().min(1).max(128)).max(128).optional(),
+    urlAllowlist: zod_1.z.array(zod_1.z.string().url()).max(128).optional(),
+})
+    .strict();
+async function validateParams(params) {
+    const validated = await (0, middleware_1.validateAndSanitize)(params, ImportTemplateParamsSchema);
+    if (validated.skipSignatureVerification) {
+        console.warn('⚠️  WARNING: Signature verification is DISABLED. Only use this for testing!');
+    }
+    return validated;
+}
+/**
+ * MCP Tool Registration
+ * Canonical specification for template import
+ */
+exports.createTemplateImportToolDefinition = {
+    name: 'create_template_import',
+    description: 'Securely import a mission template with 6-layer security validation (path sanitization, safe parsing, schema validation, signature verification, semantic validation, dependency resolution)',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            templatePath: {
+                type: 'string',
+                description: 'Path to the template file to import (YAML format)',
+            },
+            baseDir: {
+                type: 'string',
+                description: 'Base directory for import operations (optional, defaults to current directory)',
+            },
+            skipSignatureVerification: {
+                type: 'boolean',
+                description: 'Skip signature verification (TESTING ONLY - NOT for production use)',
+            },
+            trustLevel: {
+                type: 'string',
+                enum: ['verified-internal', 'signed-known', 'untrusted'],
+                description: 'Trust level for the template: verified-internal (core team), signed-known (known author), untrusted (requires approval)',
+            },
+            maxResourceMemory: {
+                type: 'number',
+                description: 'Maximum allowed memory resource in MB (optional)',
+            },
+            maxResourceCpu: {
+                type: 'number',
+                description: 'Maximum allowed CPU cores (optional)',
+            },
+            allowedActions: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of allowed actions in the template (optional, empty means all allowed)',
+            },
+            urlAllowlist: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of allowed URL domains for dependencies (optional, empty means deny all)',
+            },
+        },
+        required: ['templatePath'],
+    },
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+exports.importTemplateToolDefinitionDeprecated = {
+    ...exports.createTemplateImportToolDefinition,
+    name: 'import_template',
+    description: '[DEPRECATED] Use create_template_import instead. Provides the same secure template import workflow.',
+};
+//# sourceMappingURL=import-template.js.map

package/dist/tools/import-template.js.map

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

package/dist/tools/list-domains.d.ts

@@ -0,0 +1,70 @@
+/**
+ * List Domains Tool
+ *
+ * MCP tool implementation for discovering available domain packs.
+ * Returns LLM-optimized list of domains from the registry.
+ *
+ * @module tools/list-domains
+ */
+import { RegistryParser } from '../registry/registry-parser';
+import { DomainInfo } from '../types/tools';
+/**
+ * List Domains Tool Implementation
+ *
+ * Provides domain discovery capabilities for the MCP server.
+ * Reads from the registry and formats output for LLM consumption.
+ */
+export declare class ListDomainsToolImpl {
+    private registry;
+    constructor(registry: RegistryParser);
+    /**
+     * Execute the tool: load registry and return domain info
+     *
+     * @param registryPath - Path to registry.yaml file
+     * @returns Array of domain information
+     * @throws Error if registry cannot be loaded or is invalid
+     */
+    execute(registryPath?: string): Promise<DomainInfo[]>;
+    /**
+     * Convert DomainPackEntry to DomainInfo
+     * Extracts only the information needed for tool output
+     *
+     * @param entry - Full domain pack entry
+     * @returns Simplified domain info
+     */
+    private toDomainInfo;
+    /**
+     * Format domains for LLM readability
+     * Creates a human-friendly description of available domains
+     *
+     * @param domains - Array of domain information
+     * @returns Formatted string optimized for LLM consumption
+     */
+    formatForLLM(domains: DomainInfo[]): string;
+}
+/**
+ * MCP Tool Definition
+ * Canonical specification for retrieving available domains
+ */
+export declare const getAvailableDomainsToolDefinition: {
+    readonly name: "get_available_domains";
+    readonly description: "Get a list of all available domain-specific mission types you can create. Call this when the user asks 'what can you do?' or 'what kinds of missions are there?'.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+export declare const listAvailableDomainsToolDefinitionDeprecated: {
+    readonly name: "list_available_domains";
+    readonly description: "[DEPRECATED] Use get_available_domains instead. Provides the same list of domain-specific mission types.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
+};
+//# sourceMappingURL=list-domains.d.ts.map

package/dist/tools/list-domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-domains.d.ts","sourceRoot":"","sources":["../../src/tools/list-domains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,cAAc;IAIpC;;;;;;OAMG;IACG,OAAO,CAAC,YAAY,GAAE,MAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkB5E;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;CAqB5C;AAED;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;CASpC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4CAA4C;;;;;;;;CAK/C,CAAC"}

package/dist/tools/list-domains.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * List Domains Tool
+ *
+ * MCP tool implementation for discovering available domain packs.
+ * Returns LLM-optimized list of domains from the registry.
+ *
+ * @module tools/list-domains
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listAvailableDomainsToolDefinitionDeprecated = exports.getAvailableDomainsToolDefinition = exports.ListDomainsToolImpl = void 0;
+/**
+ * List Domains Tool Implementation
+ *
+ * Provides domain discovery capabilities for the MCP server.
+ * Reads from the registry and formats output for LLM consumption.
+ */
+class ListDomainsToolImpl {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Execute the tool: load registry and return domain info
+     *
+     * @param registryPath - Path to registry.yaml file
+     * @returns Array of domain information
+     * @throws Error if registry cannot be loaded or is invalid
+     */
+    async execute(registryPath = 'registry.yaml') {
+        try {
+            // Load all domain entries from registry
+            const entries = await this.registry.loadRegistry(registryPath);
+            // Convert to simplified DomainInfo format
+            return entries.map((entry) => this.toDomainInfo(entry));
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                (error.message.includes('File not found') || error.message.includes('ENOENT'))) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Convert DomainPackEntry to DomainInfo
+     * Extracts only the information needed for tool output
+     *
+     * @param entry - Full domain pack entry
+     * @returns Simplified domain info
+     */
+    toDomainInfo(entry) {
+        const info = {
+            name: entry.name,
+            description: entry.description,
+            version: entry.version,
+        };
+        if (entry.author) {
+            info.author = entry.author;
+        }
+        return info;
+    }
+    /**
+     * Format domains for LLM readability
+     * Creates a human-friendly description of available domains
+     *
+     * @param domains - Array of domain information
+     * @returns Formatted string optimized for LLM consumption
+     */
+    formatForLLM(domains) {
+        if (domains.length === 0) {
+            return 'No domain packs are currently available in the registry.';
+        }
+        const lines = [
+            `Found ${domains.length} domain pack${domains.length === 1 ? '' : 's'}:`,
+            '',
+        ];
+        domains.forEach((domain, index) => {
+            lines.push(`${index + 1}. **${domain.name}** (v${domain.version})`);
+            lines.push(`   ${domain.description}`);
+            if (domain.author) {
+                lines.push(`   Author: ${domain.author}`);
+            }
+            lines.push(''); // Blank line between entries
+        });
+        return lines.join('\n');
+    }
+}
+exports.ListDomainsToolImpl = ListDomainsToolImpl;
+/**
+ * MCP Tool Definition
+ * Canonical specification for retrieving available domains
+ */
+exports.getAvailableDomainsToolDefinition = {
+    name: 'get_available_domains',
+    description: "Get a list of all available domain-specific mission types you can create. Call this when the user asks 'what can you do?' or 'what kinds of missions are there?'.",
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false,
+    },
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+exports.listAvailableDomainsToolDefinitionDeprecated = {
+    ...exports.getAvailableDomainsToolDefinition,
+    name: 'list_available_domains',
+    description: '[DEPRECATED] Use get_available_domains instead. Provides the same list of domain-specific mission types.',
+};
+//# sourceMappingURL=list-domains.js.map

package/dist/tools/list-domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-domains.js","sourceRoot":"","sources":["../../src/tools/list-domains.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAMH;;;;;GAKG;AACH,MAAa,mBAAmB;IAG9B,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,eAAuB,eAAe;QAClD,IAAI,CAAC;YACH,wCAAwC;YACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAE/D,0CAA0C;YAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,KAAK,YAAY,KAAK;gBACtB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAC9E,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,KAAsB;QACzC,MAAM,IAAI,GAAe;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;QAEF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,OAAqB;QAChC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,0DAA0D,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAa;YACtB,SAAS,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;YACxE,EAAE;SACH,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,6BAA6B;QAC/C,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAjFD,kDAiFC;AAED;;;GAGG;AACU,QAAA,iCAAiC,GAAG;IAC/C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,mKAAmK;IACrK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC;AAEX;;GAEG;AACU,QAAA,4CAA4C,GAAG;IAC1D,GAAG,yCAAiC;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,0GAA0G;CACpG,CAAC"}

package/dist/tools/optimize-tokens.d.ts

@@ -0,0 +1,190 @@
+/**
+ * update_token_optimization (alias optimize_tokens) MCP Tool
+ *
+ * Optimizes mission content for token efficiency using model-aware compression.
+ * Implements the 4-pass pipeline from R4.1 research.
+ *
+ * Algorithm:
+ * 1. Load mission file
+ * 2. Apply multi-pass compression (sanitization, structural, linguistic, model-specific)
+ * 3. Calculate compression statistics
+ * 4. Return optimized content and stats
+ *
+ * @module tools/optimize-tokens
+ * @version 1.0
+ */
+import { TokenOptimizer } from '../intelligence/token-optimizer';
+import { SupportedModel, CompressionLevel } from '../intelligence/types';
+import { ToolExecutionOptions } from './tool-execution';
+/**
+ * Parameters for optimize_tokens tool
+ */
+export interface OptimizeTokensParams {
+    /** Path to mission file to optimize */
+    missionFile: string;
+    /** Target model (claude, gpt, or gemini) */
+    targetModel: SupportedModel;
+    /** Compression level (conservative, balanced, or aggressive) */
+    compressionLevel?: CompressionLevel;
+    /** Dry run mode - preview changes without applying */
+    dryRun?: boolean;
+    /** Custom preserve tags */
+    preserveTags?: string[];
+}
+/**
+ * MCP Tool Definition for token optimization
+ */
+export declare const updateTokenOptimizationToolDefinition: {
+    readonly name: "update_token_optimization";
+    readonly description: "Optimize mission content for token efficiency. Applies model-aware compression using a 4-pass pipeline: sanitization, structural refactoring, linguistic simplification, and model-specific templating. Target reduction: 20-30% tokens while maintaining semantic integrity.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["missionFile", "targetModel"];
+        readonly properties: {
+            readonly missionFile: {
+                readonly type: "string";
+                readonly description: "Path to the mission file to optimize (YAML format)";
+            };
+            readonly targetModel: {
+                readonly type: "string";
+                readonly enum: readonly ["claude", "gpt", "gemini"];
+                readonly description: "Target AI model for optimization (determines output format)";
+            };
+            readonly compressionLevel: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "balanced", "aggressive"];
+                readonly description: "Compression level (default: balanced)";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly description: "Preview mode - shows stats without applying changes (default: false)";
+            };
+            readonly preserveTags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Custom XML tags to preserve from compression (e.g., [\"critical\", \"exact\"])";
+            };
+        };
+    };
+};
+/**
+ * Backwards-compatible export preserving the historical optimize_tokens identifier.
+ * Points to the canonical tool definition to avoid contract drift across releases.
+ */
+export declare const optimizeTokensToolDefinition: {
+    readonly name: "update_token_optimization";
+    readonly description: "Optimize mission content for token efficiency. Applies model-aware compression using a 4-pass pipeline: sanitization, structural refactoring, linguistic simplification, and model-specific templating. Target reduction: 20-30% tokens while maintaining semantic integrity.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["missionFile", "targetModel"];
+        readonly properties: {
+            readonly missionFile: {
+                readonly type: "string";
+                readonly description: "Path to the mission file to optimize (YAML format)";
+            };
+            readonly targetModel: {
+                readonly type: "string";
+                readonly enum: readonly ["claude", "gpt", "gemini"];
+                readonly description: "Target AI model for optimization (determines output format)";
+            };
+            readonly compressionLevel: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "balanced", "aggressive"];
+                readonly description: "Compression level (default: balanced)";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly description: "Preview mode - shows stats without applying changes (default: false)";
+            };
+            readonly preserveTags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Custom XML tags to preserve from compression (e.g., [\"critical\", \"exact\"])";
+            };
+        };
+    };
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+export declare const optimizeTokensToolDefinitionDeprecated: {
+    readonly name: "optimize_tokens";
+    readonly description: "[DEPRECATED] Use update_token_optimization instead. Applies the same multi-pass token compression pipeline.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["missionFile", "targetModel"];
+        readonly properties: {
+            readonly missionFile: {
+                readonly type: "string";
+                readonly description: "Path to the mission file to optimize (YAML format)";
+            };
+            readonly targetModel: {
+                readonly type: "string";
+                readonly enum: readonly ["claude", "gpt", "gemini"];
+                readonly description: "Target AI model for optimization (determines output format)";
+            };
+            readonly compressionLevel: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "balanced", "aggressive"];
+                readonly description: "Compression level (default: balanced)";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly description: "Preview mode - shows stats without applying changes (default: false)";
+            };
+            readonly preserveTags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Custom XML tags to preserve from compression (e.g., [\"critical\", \"exact\"])";
+            };
+        };
+    };
+};
+/**
+ * OptimizeTokensToolImpl
+ */
+export declare class OptimizeTokensToolImpl {
+    private optimizer;
+    constructor(optimizer?: TokenOptimizer);
+    /**
+     * Execute the optimize_tokens tool
+     */
+    execute(params: OptimizeTokensParams, options?: ToolExecutionOptions): Promise<{
+        success: boolean;
+        optimizedContent?: string;
+        stats?: {
+            originalTokens: number;
+            compressedTokens: number;
+            reductionPercentage: number;
+            compressionRatio: number;
+            passesApplied: string[];
+        };
+        tokenUsage?: {
+            model: SupportedModel;
+            original: {
+                count: number;
+                estimatedCost?: number;
+            };
+            optimized: {
+                count: number;
+                estimatedCost?: number;
+            };
+            savings: number;
+            compressionRatio: number;
+        };
+        warnings?: string[];
+        error?: string;
+    }>;
+}
+export type OptimizeTokensExecutionResult = Awaited<ReturnType<OptimizeTokensToolImpl['execute']>>;
+/**
+ * Export tool handler
+ */
+export declare function handleOptimizeTokens(params: OptimizeTokensParams): Promise<OptimizeTokensExecutionResult>;
+//# sourceMappingURL=optimize-tokens.d.ts.map

package/dist/tools/optimize-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/optimize-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,WAAW,EAAE,cAAc,CAAC;IAE5B,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCxC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKzC,CAAC;AAEX;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,CAAC,EAAE,cAAc;IAItC;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,KAAK,CAAC,EAAE;YACN,cAAc,EAAE,MAAM,CAAC;YACvB,gBAAgB,EAAE,MAAM,CAAC;YACzB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,gBAAgB,EAAE,MAAM,CAAC;YACzB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,UAAU,CAAC,EAAE;YACX,KAAK,EAAE,cAAc,CAAC;YACtB,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM,CAAC;gBACd,aAAa,CAAC,EAAE,MAAM,CAAC;aACxB,CAAC;YACF,SAAS,EAAE;gBACT,KAAK,EAAE,MAAM,CAAC;gBACd,aAAa,CAAC,EAAE,MAAM,CAAC;aACxB,CAAC;YACF,OAAO,EAAE,MAAM,CAAC;YAChB,gBAAgB,EAAE,MAAM,CAAC;SAC1B,CAAC;QACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CAiFH;AAED,MAAM,MAAM,6BAA6B,GAAG,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEnG;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,6BAA6B,CAAC,CAGxC"}