@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-decisions.d.ts

@@ -0,0 +1,156 @@
+/**
+ * cmos_decisions Tool
+ *
+ * Consolidated decisions tool with action parameter support.
+ * Actions: list, search.
+ * Routes to existing decisions handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-decisions
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type CmosDecisionsListResult } from './cmos-decisions-list';
+import { type CmosDecisionsSearchResult } from './cmos-decisions-search';
+import { type CmosDecisionsUpdateResult } from './cmos-decisions-update';
+import { type CmosDecisionsReviewResult } from './cmos-decisions-review';
+import { type CmosDecisionsBatchUpdateResult } from './cmos-decisions-batch-update';
+export declare const CMOS_DECISIONS_ACTIONS: readonly ["list", "search", "update", "review", "batch_update"];
+export type CmosDecisionsAction = (typeof CMOS_DECISIONS_ACTIONS)[number];
+export type CmosDecisionsResult = CmosDecisionsListResult | CmosDecisionsSearchResult | CmosDecisionsUpdateResult | CmosDecisionsReviewResult | CmosDecisionsBatchUpdateResult;
+export declare const cmosDecisionsSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "search", "update", "review", "batch_update"]>;
+    domain: z.ZodOptional<z.ZodString>;
+    sprintId: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    decisionId: z.ZodOptional<z.ZodNumber>;
+    supersededBy: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    includeApproaching: z.ZodOptional<z.ZodBoolean>;
+    decisionIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "search" | "review" | "list" | "update" | "batch_update";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    domain?: string | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    decisionId?: number | undefined;
+    query?: string | undefined;
+    decisionIds?: number[] | undefined;
+    supersededBy?: number | undefined;
+    includeApproaching?: boolean | undefined;
+}, {
+    action: "search" | "review" | "list" | "update" | "batch_update";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    domain?: string | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    decisionId?: number | undefined;
+    query?: string | undefined;
+    decisionIds?: number[] | undefined;
+    supersededBy?: number | undefined;
+    includeApproaching?: boolean | undefined;
+}>;
+export type CmosDecisionsParams = z.infer<typeof cmosDecisionsSchema>;
+export declare const cmosDecisionsToolDefinition: {
+    readonly name: "cmos_decisions";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "search", "update", "review", "batch_update"];
+                readonly description: "Decisions action: list | search | update";
+            };
+            readonly domain: {
+                readonly type: "string";
+                readonly description: "Filter by domain";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Filter by sprint ID";
+            };
+            readonly since: {
+                readonly type: "string";
+                readonly description: "ISO date lower bound for list action";
+            };
+            readonly until: {
+                readonly type: "string";
+                readonly description: "ISO date upper bound for list action";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Page number for list action";
+            };
+            readonly pageSize: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size for list action";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query for search action";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Maximum results for search action";
+            };
+            readonly decisionId: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Decision ID for update action";
+            };
+            readonly supersededBy: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "ID of the decision that supersedes this one (for update action)";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "superseded", "archived", "stale"];
+                readonly description: "New status for update/batch_update action";
+            };
+            readonly includeApproaching: {
+                readonly type: "boolean";
+                readonly description: "Include decisions approaching staleness in review (default true)";
+            };
+            readonly decisionIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                };
+                readonly description: "Array of decision IDs for batch_update action (max 100)";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function cmosDecisions(params: CmosDecisionsParams): Promise<CmosToolResult<CmosDecisionsResult>>;
+export declare function formatDecisionsForLLM(action: string | undefined, result: CmosToolResult<CmosDecisionsResult>): string;
+//# sourceMappingURL=cmos-decisions.d.ts.map

package/dist/tools/cmos/cmos-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-decisions.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AAEvC,eAAO,MAAM,sBAAsB,iEAMzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,8BAA8B,CAAC;AAEnC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDrB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE9B,CAAC;AAMX,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAgD9C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,mBAAmB,CAAC,GAC1C,MAAM,CAyCR"}

package/dist/tools/cmos/cmos-decisions.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * cmos_decisions Tool
+ *
+ * Consolidated decisions tool with action parameter support.
+ * Actions: list, search.
+ * Routes to existing decisions handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-decisions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosDecisionsToolDefinition = exports.cmosDecisionsSchema = exports.CMOS_DECISIONS_ACTIONS = void 0;
+exports.cmosDecisions = cmosDecisions;
+exports.formatDecisionsForLLM = formatDecisionsForLLM;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const cmos_decisions_list_1 = require("./cmos-decisions-list");
+const cmos_decisions_search_1 = require("./cmos-decisions-search");
+const cmos_decisions_update_1 = require("./cmos-decisions-update");
+const cmos_decisions_review_1 = require("./cmos-decisions-review");
+const cmos_decisions_batch_update_1 = require("./cmos-decisions-batch-update");
+exports.CMOS_DECISIONS_ACTIONS = [
+    'list',
+    'search',
+    'update',
+    'review',
+    'batch_update',
+];
+exports.cmosDecisionsSchema = zod_1.z
+    .object({
+    action: zod_1.z.enum(exports.CMOS_DECISIONS_ACTIONS).describe('Decisions action: list | search | update'),
+    // shared params
+    domain: zod_1.z.string().optional().describe('Filter by domain for list/search actions'),
+    sprintId: zod_1.z.string().optional().describe('Filter by sprint ID for list/search actions'),
+    // list params
+    since: zod_1.z.string().optional().describe('ISO date lower bound for list action'),
+    until: zod_1.z.string().optional().describe('ISO date upper bound for list action'),
+    page: zod_1.z.number().int().positive().optional().describe('Page number for list action'),
+    pageSize: zod_1.z.number().int().positive().max(100).optional().describe('Page size for list action'),
+    // search params
+    query: zod_1.z.string().optional().describe('Search query for search action (required for search)'),
+    limit: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe('Maximum results for search action'),
+    // update params
+    decisionId: zod_1.z.number().int().positive().optional().describe('Decision ID for update action'),
+    supersededBy: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('ID of the decision that supersedes this one (for update action)'),
+    status: zod_1.z
+        .string()
+        .optional()
+        .describe('New status for update/batch_update action (active | superseded | archived | stale)'),
+    // review params
+    includeApproaching: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Include decisions approaching staleness in review (default true)'),
+    // batch_update params
+    decisionIds: zod_1.z
+        .array(zod_1.z.number().int().positive())
+        .optional()
+        .describe('Array of decision IDs for batch_update action (max 100)'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+exports.cmosDecisionsToolDefinition = {
+    name: 'cmos_decisions',
+    description: 'Consolidated decisions tool with action parameter support. ' +
+        'Actions: list, search, update, review, batch_update. ' +
+        'Use review to triage stale decisions with scores and suggested actions. ' +
+        'Use batch_update to archive/supersede multiple decisions at once.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_DECISIONS_ACTIONS],
+                description: 'Decisions action: list | search | update',
+            },
+            domain: { type: 'string', description: 'Filter by domain' },
+            sprintId: { type: 'string', description: 'Filter by sprint ID' },
+            since: { type: 'string', description: 'ISO date lower bound for list action' },
+            until: { type: 'string', description: 'ISO date upper bound for list action' },
+            page: { type: 'number', minimum: 1, description: 'Page number for list action' },
+            pageSize: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Page size for list action',
+            },
+            query: { type: 'string', description: 'Search query for search action' },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Maximum results for search action',
+            },
+            decisionId: {
+                type: 'number',
+                minimum: 1,
+                description: 'Decision ID for update action',
+            },
+            supersededBy: {
+                type: 'number',
+                minimum: 1,
+                description: 'ID of the decision that supersedes this one (for update action)',
+            },
+            status: {
+                type: 'string',
+                enum: ['active', 'superseded', 'archived', 'stale'],
+                description: 'New status for update/batch_update action',
+            },
+            includeApproaching: {
+                type: 'boolean',
+                description: 'Include decisions approaching staleness in review (default true)',
+            },
+            decisionIds: {
+                type: 'array',
+                items: { type: 'number', minimum: 1 },
+                description: 'Array of decision IDs for batch_update action (max 100)',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function isDecisionsAction(value) {
+    return exports.CMOS_DECISIONS_ACTIONS.includes(value);
+}
+async function cmosDecisions(params) {
+    const actionValue = typeof params.action === 'string' ? params.action : '';
+    if (!isDecisionsAction(actionValue)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidAction('cmos_decisions', actionValue, exports.CMOS_DECISIONS_ACTIONS));
+    }
+    switch (actionValue) {
+        case 'list':
+            return (0, cmos_decisions_list_1.cmosDecisionsList)({
+                domain: params.domain,
+                sprintId: params.sprintId,
+                since: params.since,
+                until: params.until,
+                page: params.page,
+                pageSize: params.pageSize,
+                projectRoot: params.projectRoot,
+            });
+        case 'search':
+            return (0, cmos_decisions_search_1.cmosDecisionsSearch)({
+                query: params.query ?? '',
+                domain: params.domain,
+                sprintId: params.sprintId,
+                limit: params.limit,
+                projectRoot: params.projectRoot,
+            });
+        case 'update':
+            return (0, cmos_decisions_update_1.cmosDecisionsUpdate)({
+                decisionId: params.decisionId ?? 0,
+                supersededBy: params.supersededBy,
+                status: params.status,
+                projectRoot: params.projectRoot,
+            });
+        case 'review':
+            return (0, cmos_decisions_review_1.cmosDecisionsReview)({
+                includeApproaching: params.includeApproaching,
+                projectRoot: params.projectRoot,
+            });
+        case 'batch_update':
+            return (0, cmos_decisions_batch_update_1.cmosDecisionsBatchUpdate)({
+                decisionIds: params.decisionIds ?? [],
+                status: params.status ?? '',
+                projectRoot: params.projectRoot,
+            });
+    }
+}
+function formatDecisionsForLLM(action, result) {
+    if (!result.success && result.error?.code === 'INVALID_ACTION') {
+        const availableActions = result.error.availableActions ??
+            result.error.available_actions ??
+            result.error.validValues ??
+            [];
+        const lines = ['❌ Failed to execute cmos_decisions', '', `Error: ${result.error.message}`];
+        if (availableActions.length > 0) {
+            lines.push('');
+            lines.push(`Available actions: ${availableActions.join(', ')}`);
+        }
+        if (result.error.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${result.error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    switch (action) {
+        case 'list':
+            return (0, cmos_decisions_list_1.formatDecisionsListForLLM)(result);
+        case 'search':
+            return (0, cmos_decisions_search_1.formatDecisionsSearchForLLM)(result);
+        case 'update':
+            return (0, cmos_decisions_update_1.formatDecisionsUpdateForLLM)(result);
+        case 'review':
+            return (0, cmos_decisions_review_1.formatDecisionsReviewForLLM)(result);
+        case 'batch_update':
+            return (0, cmos_decisions_batch_update_1.formatDecisionsBatchUpdateForLLM)(result);
+        default:
+            return result.success
+                ? '✓ Decisions action completed'
+                : '❌ Failed to execute cmos_decisions';
+    }
+}
+//# sourceMappingURL=cmos-decisions.js.map

package/dist/tools/cmos/cmos-decisions.js.map

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

package/dist/tools/cmos/cmos-feedback.d.ts

@@ -0,0 +1,127 @@
+/**
+ * cmos_feedback Tool
+ *
+ * Review/triage surface for the agent_feedback standing channel. Agents write
+ * UX feedback via the `agentFeedback` parameter on cmos_session_complete,
+ * cmos_mission_transition, and cmos_agent_onboard. The operator uses this
+ * tool to read, triage, resolve, and archive those entries.
+ *
+ * @module tools/cmos/cmos-feedback
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type AgentFeedbackStatus } from './schema-migrations';
+/** Valid actions on the cmos_feedback consolidated tool. */
+export declare const CMOS_FEEDBACK_ACTIONS: readonly ["list", "triage", "resolve", "archive"];
+export type CmosFeedbackAction = (typeof CMOS_FEEDBACK_ACTIONS)[number];
+/** One agent_feedback row as returned by cmos_feedback(action="list"). */
+export interface AgentFeedbackEntry {
+    id: number;
+    toolName: string;
+    body: string;
+    status: AgentFeedbackStatus;
+    sessionId: string | null;
+    sprintId: string | null;
+    missionId: string | null;
+    projectId: string | null;
+    createdAt: string;
+    resolvedAt: string | null;
+    resolutionNote: string | null;
+}
+export interface CmosFeedbackListResult {
+    /** Entries returned, newest-first. */
+    entries: AgentFeedbackEntry[];
+    /** Count broken down by tool_name for quick triage. */
+    countsByTool: Record<string, number>;
+    /** Count broken down by status across the filtered set. */
+    countsByStatus: Record<string, number>;
+    /** Total entries matching the filter (may exceed entries.length when limit was applied). */
+    totalCount: number;
+    /** Limit that was applied. */
+    limit: number;
+}
+export interface CmosFeedbackMutationResult {
+    /** The feedback row that was mutated. */
+    feedbackId: number;
+    /** Previous status before the mutation. */
+    previousStatus: AgentFeedbackStatus;
+    /** New status after the mutation. */
+    currentStatus: AgentFeedbackStatus;
+    /** Resolution note (only populated for resolve/archive). */
+    resolutionNote: string | null;
+    message: string;
+}
+export type CmosFeedbackResult = CmosFeedbackListResult | CmosFeedbackMutationResult;
+export declare const cmosFeedbackSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "triage", "resolve", "archive"]>;
+    feedbackId: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<["open", "triaged", "resolved", "archived"]>>;
+    toolName: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    resolutionNote: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "list" | "archive" | "triage" | "resolve";
+    projectRoot?: string | undefined;
+    status?: "open" | "archived" | "triaged" | "resolved" | undefined;
+    limit?: number | undefined;
+    feedbackId?: number | undefined;
+    toolName?: string | undefined;
+    resolutionNote?: string | undefined;
+}, {
+    action: "list" | "archive" | "triage" | "resolve";
+    projectRoot?: string | undefined;
+    status?: "open" | "archived" | "triaged" | "resolved" | undefined;
+    limit?: number | undefined;
+    feedbackId?: number | undefined;
+    toolName?: string | undefined;
+    resolutionNote?: string | undefined;
+}>;
+export type CmosFeedbackParams = z.infer<typeof cmosFeedbackSchema>;
+export declare const cmosFeedbackToolDefinition: {
+    readonly name: "cmos_feedback";
+    readonly description: "Review and triage the agent_feedback standing channel. Actions: list (filterable by status + tool_name), triage (mark under review), resolve (close with optional note), archive (hide without resolving).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "triage", "resolve", "archive"];
+                readonly description: "Feedback action: list | triage | resolve | archive";
+            };
+            readonly feedbackId: {
+                readonly type: "number";
+                readonly description: "Target feedback row ID (required for triage/resolve/archive)";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["open", "triaged", "resolved", "archived"];
+                readonly description: "Filter by status on list (default: \"open\")";
+            };
+            readonly toolName: {
+                readonly type: "string";
+                readonly description: "Filter by originating tool name on list";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 200;
+                readonly description: "Max entries to return on list (default 50, max 200)";
+            };
+            readonly resolutionNote: {
+                readonly type: "string";
+                readonly maxLength: 1000;
+                readonly description: "Optional free-text note for resolve/archive actions";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function cmosFeedback(params: CmosFeedbackParams): Promise<CmosToolResult<CmosFeedbackResult>>;
+export declare function formatFeedbackForLLM(action: CmosFeedbackAction, result: CmosToolResult<CmosFeedbackResult>): string;
+//# sourceMappingURL=cmos-feedback.d.ts.map

package/dist/tools/cmos/cmos-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-feedback.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-feedback.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,mDAAoD,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,EAAE,mBAAmB,CAAC;IACpC,qCAAqC;IACrC,aAAa,EAAE,mBAAmB,CAAC;IACnC,4DAA4D;IAC5D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,0BAA0B,CAAC;AAErF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAoCpB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C7B,CAAC;AAgCX,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAkJ7C;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GACzC,MAAM,CA4BR"}