@aquex/cmos-mcp 1.0.0

package/dist/tools/create-mission.js

@@ -0,0 +1,453 @@
+"use strict";
+/**
+ * create_mission MCP Tool
+ *
+ * Creates a new mission by combining generic template with optional domain-specific fields.
+ * Returns validated mission YAML ready for execution.
+ *
+ * Algorithm:
+ * 1. Load generic mission template
+ * 2. Generate unique mission ID
+ * 3. Populate core fields from params
+ * 4. If domain specified, load and merge domainFields
+ * 5. Validate final mission against schema
+ * 6. Return YAML string
+ *
+ * @module tools/create-mission
+ * @version 1.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateMissionToolImpl = exports.createMissionToolDefinition = void 0;
+const YAML = __importStar(require("yaml"));
+const generic_mission_1 = require("../schemas/generic-mission");
+const ajv_1 = __importDefault(require("ajv"));
+const validation_error_1 = require("../errors/validation-error");
+const handler_1 = require("../errors/handler");
+const domain_error_1 = require("../errors/domain-error");
+const mission_protocol_json_1 = require("./formatters/mission-protocol-json");
+/**
+ * MCP Tool Definition for create_mission
+ */
+exports.createMissionToolDefinition = {
+    name: 'create_mission',
+    description: "Use this tool to create a new mission based on a user's request. You must provide a clear and concise objective. You can optionally specify a domain from the list provided by get_available_domains (formerly list_available_domains). If no domain is specified, a generic mission will be created.\n\nOutput formats:\n- yaml (default): Rich YAML template for human editing\n- json: Structured JSON for database ingestion (e.g., CMOS)\n\nWhen using json format, Mission Protocol provides a suggested_id and clean structure. The consuming system handles ID assignment, defaults, and storage validation.",
+    inputSchema: {
+        type: 'object',
+        required: ['objective'],
+        properties: {
+            objective: {
+                type: 'string',
+                description: 'Clear, concise mission goal describing what success looks like',
+            },
+            domain: {
+                type: 'string',
+                description: 'Optional domain pack name (use get_available_domains to see available options)',
+            },
+            successCriteria: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional array of measurable success conditions',
+            },
+            constraints: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional array of limitations or boundaries',
+            },
+            outputFormat: {
+                type: 'string',
+                enum: ['yaml', 'json'],
+                description: 'Output format: yaml (default) for templates, json for database ingestion',
+            },
+            missionId: {
+                type: 'string',
+                description: 'Optional mission ID (used as suggested_id in JSON format)',
+            },
+            sprintId: {
+                type: 'string',
+                description: 'Optional sprint ID (included in JSON output if provided)',
+            },
+            context: {
+                type: 'string',
+                description: 'Optional context description (included in JSON output if provided)',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+/**
+ * CreateMissionToolImpl
+ *
+ * Main implementation class for mission creation
+ */
+class CreateMissionToolImpl {
+    constructor(packLoader, merger, registry, loader) {
+        this.packLoader = packLoader;
+        this.merger = merger;
+        this.registry = registry;
+        this.loader = loader;
+        this.ajv = new ajv_1.default({ allErrors: true, strict: false });
+    }
+    /**
+     * Execute mission creation
+     *
+     * @param params - Mission creation parameters
+     * @param registryEntries - Available domain pack entries
+     * @returns Formatted mission (YAML or JSON) depending on outputFormat
+     * @throws Error if validation fails or domain not found
+     */
+    async execute(params, registryEntries) {
+        const contextData = this.buildContextFromParams(params);
+        try {
+            // Validate input parameters
+            this.validateParams(params);
+            // 1. Load generic template
+            const genericTemplate = await this.loadGenericTemplate();
+            // 2. Generate mission ID
+            const missionId = this.generateMissionId();
+            // 3. Populate core fields from params
+            let mission = this.populateCoreFields(genericTemplate, params, missionId);
+            // 4. If domain specified, load and merge domainFields
+            if (params.domain) {
+                mission = await this.mergeWithDomain(mission, params.domain, registryEntries);
+            }
+            // 5. Validate final mission
+            this.validateMission(mission);
+            // 6. Format output based on requested format
+            const format = params.outputFormat || 'yaml';
+            if (format === 'json') {
+                return this.toJSON(mission, params);
+            }
+            // Default: YAML (backwards compatible)
+            return this.toYAML(mission);
+        }
+        catch (error) {
+            throw handler_1.ErrorHandler.wrap(error, 'tools.create_mission.execute', {
+                module: 'tools/create-mission',
+                data: contextData,
+            });
+        }
+    }
+    /**
+     * Validate input parameters
+     *
+     * @param params - Parameters to validate
+     * @throws Error if validation fails
+     */
+    validateParams(params) {
+        if (!params.objective || params.objective.trim().length === 0) {
+            throw new validation_error_1.ValidationError('objective is required and cannot be empty', {
+                context: { field: 'objective' },
+            });
+        }
+        if (params.domain !== undefined && params.domain.trim().length === 0) {
+            throw new validation_error_1.ValidationError('domain cannot be empty if provided', {
+                context: { field: 'domain' },
+            });
+        }
+        if (params.successCriteria !== undefined && !Array.isArray(params.successCriteria)) {
+            throw new validation_error_1.ValidationError('successCriteria must be an array', {
+                context: { field: 'successCriteria' },
+            });
+        }
+        if (params.constraints !== undefined && !Array.isArray(params.constraints)) {
+            throw new validation_error_1.ValidationError('constraints must be an array', {
+                context: { field: 'constraints' },
+            });
+        }
+    }
+    buildContextFromParams(params) {
+        return {
+            hasObjective: Boolean(params.objective?.trim()),
+            objectiveLength: params.objective?.length ?? 0,
+            domain: params.domain ?? null,
+            successCriteriaCount: params.successCriteria?.length ?? 0,
+            constraintsCount: params.constraints?.length ?? 0,
+            outputFormat: params.outputFormat ?? 'yaml',
+            hasMissionId: Boolean(params.missionId),
+            hasSprintId: Boolean(params.sprintId),
+            hasContext: Boolean(params.context),
+        };
+    }
+    /**
+     * Generate unique mission ID using timestamp and random suffix
+     *
+     * Format: mission-YYYYMMDD-HHmmss-rrr
+     *
+     * @returns Unique mission ID
+     */
+    generateMissionId() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        // Add random suffix for uniqueness when called rapidly
+        const random = String(Math.floor(Math.random() * 1000)).padStart(3, '0');
+        return `mission-${year}${month}${day}-${hours}${minutes}${seconds}-${random}`;
+    }
+    /**
+     * Load generic mission template from templates directory
+     *
+     * @returns Generic mission template object
+     * @throws Error if template cannot be loaded
+     */
+    async loadGenericTemplate() {
+        try {
+            // Load without schema validation to avoid readonly type issues
+            const template = await this.loader.load('generic_mission.yaml');
+            // Ensure template has required structure
+            if (!(0, generic_mission_1.isGenericMission)(template)) {
+                throw new validation_error_1.ValidationError('Generic template does not match required structure', {
+                    context: { template: 'generic_mission.yaml' },
+                });
+            }
+            return template;
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : 'Unknown error';
+            throw new validation_error_1.ValidationError(`Failed to load generic template: ${reason}`, {
+                context: { template: 'generic_mission.yaml' },
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Populate core fields from parameters
+     *
+     * @param template - Base generic template
+     * @param params - User-provided parameters
+     * @param missionId - Generated mission ID
+     * @returns Mission with populated core fields
+     */
+    populateCoreFields(template, params, missionId) {
+        // Create a new mission object (no mutation)
+        const mission = {
+            ...template,
+            missionId,
+            objective: params.objective,
+            context: {
+                ...template.context,
+                constraints: params.constraints || template.context.constraints || [],
+            },
+            // Ensure successCriteria is never empty (requirement from schema)
+            successCriteria: params.successCriteria && params.successCriteria.length > 0
+                ? params.successCriteria
+                : ['Mission objective achieved'],
+            // Ensure deliverables is never empty (requirement from schema)
+            deliverables: ['Mission completion report'],
+        };
+        return mission;
+    }
+    /**
+     * Merge mission with domain-specific fields
+     *
+     * @param mission - Base mission object
+     * @param domainName - Name of domain pack to merge
+     * @param registryEntries - Available registry entries
+     * @returns Mission with merged domain fields
+     * @throws Error if domain not found or merge fails
+     */
+    async mergeWithDomain(mission, domainName, registryEntries) {
+        try {
+            // Load domain pack
+            const domainPack = await this.packLoader.loadPack(domainName, registryEntries);
+            // Create extension object with domainFields
+            const extension = {
+                domainFields: domainPack.template,
+            };
+            // Merge using deep merge logic
+            const merged = this.merger.merge(mission, extension);
+            return merged;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('not found in registry')) {
+                throw new domain_error_1.DomainError(`Domain pack "${domainName}" not found. Use get_available_domains (legacy alias: list_available_domains) to see available options.`, {
+                    code: 'DOMAIN_NOT_FOUND',
+                    context: { domainName },
+                });
+            }
+            throw handler_1.ErrorHandler.wrap(error, 'tools.create_mission.merge_with_domain', {
+                module: 'tools/create-mission',
+                data: { domainName },
+            }, {
+                userMessage: `Unable to merge domain "${domainName}" into mission.`,
+            });
+        }
+    }
+    /**
+     * Validate mission against schema
+     *
+     * @param mission - Mission object to validate
+     * @throws Error if validation fails
+     */
+    validateMission(mission) {
+        // Use type guard for validation instead of ajv to avoid readonly type issues
+        if (!(0, generic_mission_1.isGenericMission)(mission)) {
+            throw new validation_error_1.ValidationError('Mission does not match GenericMission structure', {
+                context: { check: 'isGenericMission' },
+            });
+        }
+        // Additional structural validation
+        if (!mission.schemaType || mission.schemaType !== 'Mission') {
+            throw new validation_error_1.ValidationError('Invalid schemaType', {
+                context: { expected: 'Mission', actual: mission.schemaType },
+            });
+        }
+        if (!mission.schemaVersion || mission.schemaVersion !== '2.0') {
+            throw new validation_error_1.ValidationError('Invalid schemaVersion', {
+                context: { expected: '2.0', actual: mission.schemaVersion },
+            });
+        }
+        if (!mission.missionId || mission.missionId.length === 0) {
+            throw new validation_error_1.ValidationError('Invalid missionId', {
+                context: { missionIdLength: mission.missionId?.length ?? 0 },
+            });
+        }
+        if (!mission.objective || mission.objective.length === 0) {
+            throw new validation_error_1.ValidationError('Invalid objective', {
+                context: { objectiveLength: mission.objective?.length ?? 0 },
+            });
+        }
+        if (!Array.isArray(mission.successCriteria) || mission.successCriteria.length === 0) {
+            throw new validation_error_1.ValidationError('successCriteria must be a non-empty array', {
+                context: {
+                    successCriteriaCount: Array.isArray(mission.successCriteria)
+                        ? mission.successCriteria.length
+                        : 0,
+                },
+            });
+        }
+        if (!Array.isArray(mission.deliverables) || mission.deliverables.length === 0) {
+            throw new validation_error_1.ValidationError('deliverables must be a non-empty array', {
+                context: {
+                    deliverablesCount: Array.isArray(mission.deliverables) ? mission.deliverables.length : 0,
+                },
+            });
+        }
+    }
+    /**
+     * Convert mission object to YAML string
+     *
+     * @param mission - Mission object to serialize
+     * @returns Formatted YAML string
+     */
+    toYAML(mission) {
+        try {
+            // Use YAML.stringify for clean output
+            const yamlString = YAML.stringify(mission, {
+                indent: 2,
+                lineWidth: 0, // Prevent line wrapping
+                defaultStringType: 'QUOTE_DOUBLE',
+            });
+            return yamlString;
+        }
+        catch (error) {
+            throw handler_1.ErrorHandler.wrap(error, 'tools.create_mission.to_yaml', {
+                module: 'tools/create-mission',
+                data: {
+                    missionId: mission.missionId,
+                },
+            }, {
+                userMessage: 'Unable to serialize mission to YAML.',
+            });
+        }
+    }
+    /**
+     * Convert mission object to JSON format
+     *
+     * @param mission - Mission object to format
+     * @param params - Original parameters (for optional fields)
+     * @returns Formatted JSON string
+     */
+    toJSON(mission, params) {
+        try {
+            const formatter = new mission_protocol_json_1.MissionProtocolJsonFormatter();
+            // Build formatter params from create_mission params
+            const formatterParams = {
+                missionId: params.missionId,
+                sprintId: params.sprintId,
+                context: params.context,
+                domain: params.domain,
+            };
+            // Format to JSON envelope
+            const jsonOutput = formatter.format(mission, formatterParams);
+            // Return pretty-printed JSON
+            return JSON.stringify(jsonOutput, null, 2);
+        }
+        catch (error) {
+            throw handler_1.ErrorHandler.wrap(error, 'tools.create_mission.to_json', {
+                module: 'tools/create-mission',
+                data: {
+                    missionId: mission.missionId,
+                },
+            }, {
+                userMessage: 'Unable to serialize mission to JSON.',
+            });
+        }
+    }
+    /**
+     * Format mission YAML for LLM consumption
+     *
+     * Adds helpful context and formatting for Claude to understand the output
+     *
+     * @param yamlString - YAML string to format
+     * @returns Formatted string for LLM
+     */
+    formatForLLM(yamlString) {
+        return `# Mission Created Successfully
+
+The following mission has been created and validated:
+
+\`\`\`yaml
+${yamlString}
+\`\`\`
+
+This mission is ready to be saved and executed. The structure follows the ICEV pattern:
+- **Intent**: Defined in the objective
+- **Context**: Background, dependencies, and constraints
+- **Execution**: Implementation details (in domainFields if domain-specific)
+- **Verification**: Success criteria and deliverables
+
+You can now save this mission to a file or modify it as needed.`;
+    }
+}
+exports.CreateMissionToolImpl = CreateMissionToolImpl;
+//# sourceMappingURL=create-mission.js.map

package/dist/tools/create-mission.js.map

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

package/dist/tools/export-template.d.ts

@@ -0,0 +1,175 @@
+/**
+ * MCP Tool: export_template
+ *
+ * Exposes the template export functionality as an MCP tool
+ * for use in Claude Desktop and other MCP-compatible environments.
+ *
+ * Exports templates in Strict YAML format (safe for import).
+ */
+import { MissionTemplate } from '../import-export/types';
+/**
+ * MCP Tool Interface for Template Export
+ */
+export interface ExportTemplateParams {
+    /** Template object to export (must conform to mission-template.v1 schema) */
+    template: MissionTemplate;
+    /** Output file path (relative to baseDir) */
+    outputPath: string;
+    /** Optional: Base directory for export operations (defaults to current directory) */
+    baseDir?: string;
+    /** Optional: Export format (yaml or json, defaults to yaml) */
+    format?: 'yaml' | 'json';
+    /** Optional: Include header comments (defaults to true for YAML) */
+    includeComments?: boolean;
+    /** Optional: Pretty print output (defaults to true) */
+    pretty?: boolean;
+}
+/**
+ * Result returned by export_template tool
+ */
+export interface ExportTemplateResult {
+    success: boolean;
+    outputPath?: string;
+    format?: string;
+    message: string;
+    preview?: string;
+}
+/**
+ * Main entry point for the export_template MCP tool
+ */
+export declare function exportTemplate(params: ExportTemplateParams): Promise<ExportTemplateResult>;
+/**
+ * Helper function to create a template from mission data
+ * Useful for converting existing mission files to templates
+ */
+export declare function createTemplateFromMission(missionData: Record<string, unknown>, metadata: {
+    name: string;
+    version: string;
+    author: string;
+    signature: {
+        keyId: string;
+        algorithm: string;
+        value: string;
+    };
+}): MissionTemplate;
+/**
+ * MCP Tool Registration
+ * This would be called by the MCP server to register the tool
+ */
+export declare const getTemplateExportToolDefinition: {
+    readonly name: "get_template_export";
+    readonly description: "Export a mission template to Strict YAML or JSON format. Uses safe serialization with no language-specific tags.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly template: {
+                readonly type: "object";
+                readonly description: "Mission template object conforming to mission-template.v1 schema";
+                readonly required: readonly ["apiVersion", "kind", "metadata", "spec"];
+                readonly properties: {
+                    readonly apiVersion: {
+                        readonly type: "string";
+                        readonly const: "mission-template.v1";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly const: "MissionTemplate";
+                    };
+                    readonly metadata: {
+                        readonly type: "object";
+                        readonly description: "Template metadata including name, version, author, and signature";
+                    };
+                    readonly spec: {
+                        readonly type: "object";
+                        readonly description: "Mission specification (business logic)";
+                    };
+                    readonly dependencies: {
+                        readonly type: "array";
+                        readonly description: "Optional array of template dependencies";
+                    };
+                };
+            };
+            readonly outputPath: {
+                readonly type: "string";
+                readonly description: "Output file path (relative to baseDir)";
+            };
+            readonly baseDir: {
+                readonly type: "string";
+                readonly description: "Base directory for export operations (optional, defaults to current directory)";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+                readonly description: "Export format: yaml (default) or json";
+            };
+            readonly includeComments: {
+                readonly type: "boolean";
+                readonly description: "Include header comments in YAML output (default: true)";
+            };
+            readonly pretty: {
+                readonly type: "boolean";
+                readonly description: "Pretty print output (default: true)";
+            };
+        };
+        readonly required: readonly ["template", "outputPath"];
+    };
+};
+export declare const exportTemplateToolDefinitionDeprecated: {
+    readonly name: "export_template";
+    readonly description: "[DEPRECATED] Use get_template_export instead. Provides the same strict serialization workflow.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly template: {
+                readonly type: "object";
+                readonly description: "Mission template object conforming to mission-template.v1 schema";
+                readonly required: readonly ["apiVersion", "kind", "metadata", "spec"];
+                readonly properties: {
+                    readonly apiVersion: {
+                        readonly type: "string";
+                        readonly const: "mission-template.v1";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly const: "MissionTemplate";
+                    };
+                    readonly metadata: {
+                        readonly type: "object";
+                        readonly description: "Template metadata including name, version, author, and signature";
+                    };
+                    readonly spec: {
+                        readonly type: "object";
+                        readonly description: "Mission specification (business logic)";
+                    };
+                    readonly dependencies: {
+                        readonly type: "array";
+                        readonly description: "Optional array of template dependencies";
+                    };
+                };
+            };
+            readonly outputPath: {
+                readonly type: "string";
+                readonly description: "Output file path (relative to baseDir)";
+            };
+            readonly baseDir: {
+                readonly type: "string";
+                readonly description: "Base directory for export operations (optional, defaults to current directory)";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+                readonly description: "Export format: yaml (default) or json";
+            };
+            readonly includeComments: {
+                readonly type: "boolean";
+                readonly description: "Include header comments in YAML output (default: true)";
+            };
+            readonly pretty: {
+                readonly type: "boolean";
+                readonly description: "Pretty print output (default: true)";
+            };
+        };
+        readonly required: readonly ["template", "outputPath"];
+    };
+};
+//# sourceMappingURL=export-template.d.ts.map

package/dist/tools/export-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-template.d.ts","sourceRoot":"","sources":["../../src/tools/export-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAiB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOxE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,EAAE,eAAe,CAAC;IAE1B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuGhG;AAwBD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE;IACR,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,GACA,eAAe,CAQjB;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DlC,CAAC;AAEX,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKzC,CAAC"}