@carrierllc/mcp 0.1.0 → 0.2.1

package/dist/tools-backlog.js

@@ -0,0 +1,410 @@
+/**
+ * Carrier MCP — v1.1 backlog tool registrations (9 tools) + v1.2 audit stubs (3 tools).
+ *
+ * These are OCS methods confirmed live in the eSIMVault API docs but not yet
+ * exposed in the v1 server. All 9 v1.1 tools are wired here to close coverage gaps
+ * identified in the 2026-05-12 forensic audit (mango/.planning/research/03-carrier-llc-audit.md).
+ *
+ * v1.2 AUDIT STUBS (feat/ocs-feature-audit, 2026-05-20):
+ *   Registered but throw NotImplementedError — implementation in follow-up PRs.
+ *   These stubs are intentionally NOT added to BACKLOG_TOOL_SCOPES or to the
+ *   carrier_ask tool registry until implemented. The registerAllBacklogTools function
+ *   conditionally registers them only when CARRIER_AUDIT_STUBS_ENABLED=true.
+ *   Stubs: carrier_webhook_config (resolve_cell_location removed — merged into get_subscriber_location_by_cell_id)
+ *   See: docs/research/bridge4ip-ocs-api/UNUSED-FEATURES.md
+ *
+ * Scope assignments (v1.1):
+ *   write  — affect_subscriber_phone_number, modify_subscriber_mobile_plan,
+ *             modify_subscriber_package_active_period, modify_subscriber_voip_plan,
+ *             push_steering_to_subscriber
+ *   read   — get_subscriber_location_by_cell_id, list_destination_lists,
+ *             resolve_cell_location, carrier_webhook_config
+ *   admin  — reset_subscriber_gz_counter
+ *
+ * Schema notes:
+ *   - All ICCID-accepting tools use the subscriber-record lookup cache pattern
+ *     (resolveSubscriberByIccid) for IMSI resolution where required.
+ *   - pushSteeringToSubs is listed as "write" in the live docs; marked write here
+ *     pending confirmation from eSIMVault support (gap G-04).
+ *   - resetSubsGzCounter is admin-scoped; usage counter resets are irreversible.
+ */
+import { z } from "zod";
+import { OcsClient } from "./client.js";
+import { wrapHandler, resolveSubscriberByIccid, getDefaultResellerId, } from "./tools.js";
+const DRY_RUN_FIELD = {
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe("If true, do not call OCS — return the would-be request for confirmation"),
+};
+/** Scope lookup for the v1.1 backlog tools + implemented v1.2 tools. */
+export const BACKLOG_TOOL_SCOPES = {
+    affect_subscriber_phone_number: "write",
+    carrier_webhook_config: "read",
+    get_subscriber_location_by_cell_id: "read",
+    list_destination_lists: "read",
+    modify_subscriber_mobile_plan: "write",
+    modify_subscriber_package_active_period: "write",
+    modify_subscriber_voip_plan: "write",
+    push_steering_to_subscriber: "write",
+    reset_subscriber_gz_counter: "admin",
+};
+export function registerAllBacklogTools(server, ctx) {
+    // =========================================================================
+    // 1. AFFECT SUBSCRIBER PHONE NUMBER
+    //    OCS methods: affectSubscriberFakePhoneNumber / affectSubscriberRealPhoneNumber
+    //    Gap: G-08 (MEDIUM). Merges two OCS methods behind one MCP tool.
+    // =========================================================================
+    server.registerTool("affect_subscriber_phone_number", {
+        title: "Assign Phone Number to Subscriber",
+        description: "Use this to assign a phone number (MSISDN) to a subscriber. Supports both fake/test MSISDNs " +
+            "and real production MSISDNs via the `phone_type` parameter. Required for MSISDN assignment " +
+            "workflows before activating voice services. " +
+            "Params: `iccid` (subscriber identifier), `phone_number` (E.164 format, e.g. +31612345678), " +
+            "`phone_type` ('fake' for test/dev, 'real' for production). " +
+            "Returns: updated subscriber record with the new MSISDN. " +
+            "Do NOT use this to check a subscriber's current MSISDN — use `get_subscriber` instead.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            phone_number: z
+                .string()
+                .describe("E.164 phone number to assign (e.g. +31612345678)"),
+            phone_type: z
+                .enum(["fake", "real"])
+                .describe("'fake' assigns a test/dev MSISDN (affectSubscriberFakePhoneNumber in OCS); " +
+                "'real' assigns a production MSISDN (affectSubscriberRealPhoneNumber in OCS)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("affect_subscriber_phone_number", "affectSubscriberFakePhoneNumber/affectSubscriberRealPhoneNumber", BACKLOG_TOOL_SCOPES["affect_subscriber_phone_number"], ctx, async ({ iccid, phone_number, phone_type }, token) => {
+        const ocsMethod = phone_type === "fake"
+            ? "affectSubscriberFakePhoneNumber"
+            : "affectSubscriberRealPhoneNumber";
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call(ocsMethod, { subscriber: iccid, phoneNumber: phone_number });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 2. GET SUBSCRIBER LOCATION BY CELL ID
+    //    OCS method: getSubscriberLocationByCellId (Bridge4IP GeoSense)
+    //    Gap: G-09 (MEDIUM). Takes a cell tuple — no subscriber identifier needed.
+    // =========================================================================
+    server.registerTool("get_subscriber_location_by_cell_id", {
+        title: "Get Location by Cell ID (GeoSense)",
+        description: "Powered by Bridge4IP GeoSense — cell-level location resolution with sub-cell accuracy where available. " +
+            "Use this to resolve a cell tower tuple (radio type + MCC + MNC + LAC + optional cellId) " +
+            "to a latitude/longitude estimate. " +
+            "No subscriber identifier required — caller supplies cell parameters directly. " +
+            "Useful for fraud detection, roaming cost attribution, and network troubleshooting when " +
+            "you have raw cell info from an external source (e.g. a Relay LU webhook event). " +
+            "Params: `radio_type` ('2G'|'3G'|'4G'|'5G'|'NB-IoT'), `mcc` (int), `mnc` (int), " +
+            "`lac` (int), `cell_id` (int, optional but strongly recommended for accuracy), " +
+            "`signal_strength` (number dBm, optional). " +
+            "Returns: { latitude, longitude, accuracy } — accuracy is median error in meters at 50% confidence. " +
+            "Without cell_id accuracy degrades significantly (>10 km). " +
+            "Do NOT use this for bulk fleet location sweeps — one OCS call per cell tower; " +
+            "use `audit_network_coverage` for fleet-level analysis instead.",
+        inputSchema: {
+            radio_type: z
+                .enum(["2G", "3G", "4G", "5G", "NB-IoT"])
+                .describe("Radio access technology type"),
+            mcc: z.number().int().describe("Mobile Country Code (e.g. 250 for Russia, 234 for UK)"),
+            mnc: z.number().int().describe("Mobile Network Code"),
+            lac: z.number().int().describe("Location Area Code"),
+            cell_id: z
+                .number()
+                .int()
+                .optional()
+                .describe("Cell tower ID — strongly recommended for accuracy"),
+            signal_strength: z
+                .number()
+                .optional()
+                .describe("Signal strength in dBm (e.g. -89). Optional, improves accuracy."),
+        },
+        annotations: { readOnlyHint: true },
+    }, wrapHandler("get_subscriber_location_by_cell_id", "getSubscriberLocationByCellId", BACKLOG_TOOL_SCOPES["get_subscriber_location_by_cell_id"], ctx, async ({ radio_type, mcc, mnc, lac, cell_id, signal_strength, }, token) => {
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const params = { radioType: radio_type, mcc, mnc, lac };
+        if (cell_id !== undefined)
+            params.cellId = cell_id;
+        if (signal_strength !== undefined)
+            params.signalStrength = signal_strength;
+        const result = await client.call("getSubscriberLocationByCellId", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 3. LIST DESTINATION LISTS
+    //    OCS method: listDetailedDestinationList
+    //    Gap: G-13 (MEDIUM). The existing list_destination_prefixes only reads
+    //    prefixes WITHIN a known list ID; this tool returns the list catalog itself.
+    // =========================================================================
+    server.registerTool("list_destination_lists", {
+        title: "List Destination Lists",
+        description: "Use this to retrieve the full catalog of destination lists available to this reseller. " +
+            "A destination list is a named set of phone number prefixes (country codes) that control " +
+            "which numbers a subscriber may call on a voice/SMS package. " +
+            "Returns: array of destination list records, each with `id`, `name`, and prefix count. " +
+            "Do NOT use this to read the prefixes inside a specific list — use `list_destination_prefixes` " +
+            "with a known `destinationListId` for that. " +
+            "Do NOT use this for data-only eSIM products without MOC voice; destination lists only " +
+            "apply to packages with voice/SMS allowances.",
+        inputSchema: {
+            resellerId: z
+                .number()
+                .optional()
+                .describe("Reseller ID (omit to use the token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, wrapHandler("list_destination_lists", "listDetailedDestinationList", BACKLOG_TOOL_SCOPES["list_destination_lists"], ctx, async ({ resellerId }, token) => {
+        const id = resellerId ??
+            (await (async () => {
+                const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+                const info = await client.call("getResellerInfo", {});
+                const resolvedId = info?.id;
+                if (typeof resolvedId !== "number") {
+                    throw new Error("Could not determine resellerId from getResellerInfo");
+                }
+                return resolvedId;
+            })());
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("listDetailedDestinationList", id);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 4. MODIFY SUBSCRIBER MOBILE PLAN
+    //    OCS method: modifySubscriberMobilePlan
+    //    Gap: G-06 (HIGH). Needed to change which pricing plan a subscriber is billed under.
+    // =========================================================================
+    server.registerTool("modify_subscriber_mobile_plan", {
+        title: "Modify Subscriber Mobile Plan",
+        description: "Use this to change the mobile pricing plan assigned to a specific subscriber. " +
+            "The mobile plan determines per-country rates for data, voice, and SMS. Changing the plan " +
+            "takes effect immediately on the next OCS rating cycle. " +
+            "Params: `iccid` (subscriber identifier), `mobile_plan_id` (integer plan ID — obtain valid " +
+            "plan IDs from the OCS reseller settings or `get_tariff`). " +
+            "Returns: updated subscriber record confirming the new plan assignment. " +
+            "Do NOT use this to change package allowances — use `modify_package_limits` for that. " +
+            "Do NOT use this to change account-level pricing — this only affects the individual subscriber.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            mobile_plan_id: z
+                .number()
+                .describe("The mobile pricing plan ID to assign to this subscriber"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("modify_subscriber_mobile_plan", "modifySubscriberMobilePlan", BACKLOG_TOOL_SCOPES["modify_subscriber_mobile_plan"], ctx, async ({ iccid, mobile_plan_id }, token) => {
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("modifySubscriberMobilePlan", { subscriber: iccid, mobilePlanId: mobile_plan_id });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 5. MODIFY SUBSCRIBER PACKAGE ACTIVE PERIOD
+    //    OCS method: modifySubscriberPrepaidPackageActivePeriod
+    //    Gap: G-07 (HIGH). Controls when a package becomes active on a subscriber.
+    // =========================================================================
+    server.registerTool("modify_subscriber_package_active_period", {
+        title: "Modify Subscriber Package Active Period",
+        description: "Use this to change the start and/or end date of a prepaid package's active period for a " +
+            "specific subscriber. This controls WHEN the package runs, not what it contains. " +
+            "Useful for scheduling packages in advance (e.g. activate on arrival date) or extending " +
+            "a package that would otherwise expire while the subscriber is still travelling. " +
+            "Params: `iccid` (subscriber identifier), `package_id` (from `list_subscriber_packages`), " +
+            "`start_date` (ISO 8601 date, optional), `end_date` (ISO 8601 date, optional). " +
+            "Returns: updated package record with new active period. " +
+            "Do NOT use this to change a package's data/voice allowance — use `modify_package_limits`. " +
+            "Do NOT use this to change the expiry date of a package — use `modify_package_expiry`.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            package_id: z
+                .number()
+                .describe("The subscriber package ID (from list_subscriber_packages)"),
+            start_date: z
+                .string()
+                .optional()
+                .describe("New start date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss)"),
+            end_date: z
+                .string()
+                .optional()
+                .describe("New end date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("modify_subscriber_package_active_period", "modifySubscriberPrepaidPackageActivePeriod", BACKLOG_TOOL_SCOPES["modify_subscriber_package_active_period"], ctx, async ({ iccid, package_id, start_date, end_date }, token) => {
+        const params = { subscriber: iccid, packageId: package_id };
+        if (start_date !== undefined)
+            params.startDate = start_date;
+        if (end_date !== undefined)
+            params.endDate = end_date;
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("modifySubscriberPrepaidPackageActivePeriod", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 6. MODIFY SUBSCRIBER VOIP PLAN
+    //    OCS method: modifySubscriberVoipPlan
+    //    Gap: G-11 (MEDIUM). Parallel to modify_subscriber_mobile_plan for VoIP.
+    // =========================================================================
+    server.registerTool("modify_subscriber_voip_plan", {
+        title: "Modify Subscriber VoIP Plan",
+        description: "Use this to change the VoIP pricing plan assigned to a specific subscriber. " +
+            "VoIP plans control billing rates for VoIP calls made through the OCS platform, " +
+            "separate from the standard mobile plan's call rates. " +
+            "Params: `iccid` (subscriber identifier), `voip_plan_id` (integer VoIP plan ID from " +
+            "the OCS reseller settings). " +
+            "Returns: updated subscriber record confirming the new VoIP plan. " +
+            "Do NOT use this for mobile (non-VoIP) plan changes — use `modify_subscriber_mobile_plan`. " +
+            "For data-only eSIM products without VoIP services this tool has no effect.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            voip_plan_id: z
+                .number()
+                .describe("The VoIP pricing plan ID to assign to this subscriber"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("modify_subscriber_voip_plan", "modifySubscriberVoipPlan", BACKLOG_TOOL_SCOPES["modify_subscriber_voip_plan"], ctx, async ({ iccid, voip_plan_id }, token) => {
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("modifySubscriberVoipPlan", { subscriber: iccid, voipPlanId: voip_plan_id });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 7. PUSH STEERING TO SUBSCRIBER
+    //    OCS method: pushSteeringToSubs
+    //    Gap: G-04 (HIGH). Must be called AFTER modify_subscriber_steering_list
+    //    to push the new OPLMN list to the physical device.
+    // =========================================================================
+    server.registerTool("push_steering_to_subscriber", {
+        title: "Push Steering List to Subscriber Device",
+        description: "Use this AFTER `modify_subscriber_steering_list` to actively push the updated OPLMN " +
+            "(operator preference list) to the subscriber's physical eSIM/SIM. " +
+            "Without this call, the steering list assignment change is recorded in OCS but the device " +
+            "continues using the old operator preference list until it performs a network re-registration. " +
+            "This is required for immediate operator switching (e.g. steering a subscriber away from " +
+            "an expensive roaming partner in real time). " +
+            "Params: `iccid` (subscriber identifier). " +
+            "Returns: push confirmation from OCS with delivery status. " +
+            "Do NOT call this without first calling `modify_subscriber_steering_list` — pushing without " +
+            "an assigned steering list is a no-op and wastes an OCS call.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("push_steering_to_subscriber", "pushSteeringToSubs", BACKLOG_TOOL_SCOPES["push_steering_to_subscriber"], ctx, async ({ iccid }, token) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(ctx.env, token, iccid, cache);
+        // OCS pushSteeringToSubs expects subscriber identifier — ICCID confirmed
+        // from live docs. Passing the full subscriber object as fallback.
+        const subscriberId = sub.id ?? sub.subscriberId ?? iccid;
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("pushSteeringToSubs", { subscriber: subscriberId });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 8. RESET SUBSCRIBER GZ COUNTER
+    //    OCS method: resetSubsGzCounter
+    //    Gap: G-10 (MEDIUM). Resets usage counters — used after billing disputes.
+    //    Admin scope — irreversible operation.
+    // =========================================================================
+    server.registerTool("reset_subscriber_gz_counter", {
+        title: "Reset Subscriber Green Zone Counter",
+        description: "ADMIN: Use this to reset the Green Zone (Greenzone) volume counter for a subscriber. " +
+            "The Green Zone counter tracks bytes consumed on the reseller-defined whitelist of " +
+            "hosts/IPs after the subscriber's bundle is depleted — NOT the Diameter Gz/Gy accounting " +
+            "interface. Typically used after a billing dispute or test-cycle reset. " +
+            "This operation is IRREVERSIBLE — volumeOnGZ is permanently zeroed. " +
+            "Params: `iccid` (subscriber identifier). " +
+            "Returns: new counter state with volumeOnGZ (bytes, normally 0 after reset), " +
+            "lastResetDate, lastUpdateDate. " +
+            "Always call `get_subscriber` with `with_gz_counter=true` first to capture the snapshot. " +
+            "Do NOT use this to pause data usage — use `set_subscriber_traffic_restrictions` with " +
+            "`dataAllowed=false` instead.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID (20-digit ICC identifier)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, wrapHandler("reset_subscriber_gz_counter", "resetSubsGzCounter", BACKLOG_TOOL_SCOPES["reset_subscriber_gz_counter"], ctx, async ({ iccid }, token) => {
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        const result = await client.call("resetSubsGzCounter", { subscriber: iccid });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+    // =========================================================================
+    // 10. CARRIER WEBHOOK CONFIG — reads relay + notification flags from
+    //     getResellerInfo.trafficInfo and getResellerInfo.notificationInfo.
+    //     Audit gap S-04 in UNUSED-FEATURES.md — now implemented.
+    //
+    //     trafficInfo shape (live probe against reseller 1170, 2026-05-21):
+    //       { relayGy: boolean, relayCallSms: boolean, relayLU: boolean, relayVoIP: boolean }
+    //     notificationInfo shape: passed through as-is (z.record(z.unknown())) because
+    //       the exact keys vary by OCS configuration and are not documented upstream.
+    // =========================================================================
+    // carrier_webhook_config is now a real tool — registered unconditionally
+    // (no CARRIER_AUDIT_STUBS_ENABLED guard needed after implementation).
+    server.registerTool("carrier_webhook_config", {
+        title: "Carrier Webhook / Relay Flag Status",
+        description: "Use this to check the current Bridge4IP webhook and relay flag configuration for " +
+            "this reseller. Returns the active state of all four traffic relay flags: " +
+            "Relay LU (Update Location — cell tower changes, closest to country-change signal), " +
+            "Relay Gy (mobile data usage events), Relay VoIP (VoIP usage events), " +
+            "Relay calls+SMS (call and SMS events). " +
+            "Also returns which notification webhooks are enabled (prepaid package usage threshold, " +
+            "reseller low credit, ES2 eSIM status, recurring packages) as a passthrough object. " +
+            "All relay/notification configuration is done in the OCS portal UI — this tool is " +
+            "READ-ONLY and reflects current state. " +
+            "Relay LU is the highest-value flag: when active, Bridge4IP pushes real-time Update " +
+            "Location events (mcc, mnc, lac, cellId) to the configured HTTP endpoint.",
+        inputSchema: {
+            reseller_id: z
+                .number()
+                .int()
+                .optional()
+                .describe("Reseller ID (omit to use the token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, wrapHandler("carrier_webhook_config", "getResellerInfo", BACKLOG_TOOL_SCOPES["carrier_webhook_config"], ctx, async ({ reseller_id }, token) => {
+        const client = new OcsClient(ctx.env.CARRIER_OCS_BASE_URL, token);
+        // Resolve reseller ID: explicit arg → token owner's reseller
+        let resellerId = reseller_id;
+        if (resellerId === undefined) {
+            resellerId = await getDefaultResellerId(ctx.env, token);
+        }
+        const params = {};
+        if (resellerId !== undefined)
+            params.resellerId = resellerId;
+        const raw = await client.call("getResellerInfo", params);
+        const traffic = raw.trafficInfo ?? {};
+        const notification = raw.notificationInfo ?? {};
+        const result = {
+            resellerId: raw.id ?? resellerId,
+            traffic: {
+                relayGy: traffic.relayGy === true,
+                relayCallSms: traffic.relayCallSms === true,
+                relayLU: traffic.relayLU === true,
+                relayVoIP: traffic.relayVoIP === true,
+            },
+            notification,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }));
+}
+//# sourceMappingURL=tools-backlog.js.map

package/dist/tools-backlog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-backlog.js","sourceRoot":"","sources":["../src/tools-backlog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,oBAAoB,GAErB,MAAM,YAAY,CAAC;AAGpB,MAAM,aAAa,GAAG;IACpB,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,yEAAyE,CAC1E;CACJ,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D,8BAA8B,EAAE,OAAO;IACvC,sBAAsB,EAAE,MAAM;IAC9B,kCAAkC,EAAE,MAAM;IAC1C,sBAAsB,EAAE,MAAM;IAC9B,6BAA6B,EAAE,OAAO;IACtC,uCAAuC,EAAE,OAAO;IAChD,2BAA2B,EAAE,OAAO;IACpC,2BAA2B,EAAE,OAAO;IACpC,2BAA2B,EAAE,OAAO;CACrC,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,GAAgB;IAEhB,4EAA4E;IAC5E,oCAAoC;IACpC,oFAAoF;IACpF,qEAAqE;IACrE,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,gCAAgC,EAChC;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,8FAA8F;YAC9F,6FAA6F;YAC7F,8CAA8C;YAC9C,6FAA6F;YAC7F,6DAA6D;YAC7D,0DAA0D;YAC1D,wFAAwF;QAC1F,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBACtB,QAAQ,CACP,6EAA6E;gBAC7E,6EAA6E,CAC9E;YACH,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,gCAAgC,EAChC,iEAAiE,EACjE,mBAAmB,CAAC,gCAAgC,CAAE,EACtD,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAA+D,EAAE,KAAa,EAAE,EAAE;QACxH,MAAM,SAAS,GACb,UAAU,KAAK,MAAM;YACnB,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,iCAAiC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9F,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,wCAAwC;IACxC,oEAAoE;IACpE,+EAA+E;IAC/E,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,oCAAoC,EACpC;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,yGAAyG;YACzG,0FAA0F;YAC1F,oCAAoC;YACpC,gFAAgF;YAChF,yFAAyF;YACzF,kFAAkF;YAClF,iFAAiF;YACjF,gFAAgF;YAChF,4CAA4C;YAC5C,qGAAqG;YACrG,4DAA4D;YAC5D,gFAAgF;YAChF,gEAAgE;QAClE,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;iBACxC,QAAQ,CAAC,8BAA8B,CAAC;YAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACvF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACrD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACpD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;YAChE,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,WAAW,CACT,oCAAoC,EACpC,+BAA+B,EAC/B,mBAAmB,CAAC,oCAAoC,CAAE,EAC1D,GAAG,EACH,KAAK,EACH,EACE,UAAU,EACV,GAAG,EACH,GAAG,EACH,GAAG,EACH,OAAO,EACP,eAAe,GAQhB,EACD,KAAa,EACb,EAAE;QACF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAA4B,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACjF,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;QACnD,IAAI,eAAe,KAAK,SAAS;YAAE,MAAM,CAAC,cAAc,GAAG,eAAe,CAAC;QAC3E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC;QAC1E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,4BAA4B;IAC5B,6CAA6C;IAC7C,2EAA2E;IAC3E,iFAAiF;IACjF,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,yFAAyF;YACzF,0FAA0F;YAC1F,8DAA8D;YAC9D,wFAAwF;YACxF,gGAAgG;YAChG,6CAA6C;YAC7C,wFAAwF;YACxF,8CAA8C;QAChD,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,WAAW,CACT,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,CAAC,wBAAwB,CAAE,EAC9C,GAAG,EACH,KAAK,EAAE,EAAE,UAAU,EAA2B,EAAE,KAAa,EAAE,EAAE;QAC/D,MAAM,EAAE,GACN,UAAU;YACV,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;gBACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;gBAClE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAkB,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBACvE,MAAM,UAAU,GAAG,IAAI,EAAE,EAAE,CAAC;gBAC5B,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO,UAAU,CAAC;YACpB,CAAC,CAAC,EAAE,CAAC,CAAC;QACR,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,mCAAmC;IACnC,4CAA4C;IAC5C,yFAAyF;IACzF,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,+BAA+B,EAC/B;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,gFAAgF;YAChF,2FAA2F;YAC3F,yDAAyD;YACzD,4FAA4F;YAC5F,4DAA4D;YAC5D,yEAAyE;YACzE,uFAAuF;YACvF,gGAAgG;QAClG,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,CAAC,yDAAyD,CAAC;YACtE,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,+BAA+B,EAC/B,4BAA4B,EAC5B,mBAAmB,CAAC,+BAA+B,CAAE,EACrD,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAA6C,EAAE,KAAa,EAAE,EAAE;QAC5F,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,4BAA4B,EAC5B,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,CACpD,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,6CAA6C;IAC7C,4DAA4D;IAC5D,+EAA+E;IAC/E,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,yCAAyC,EACzC;QACE,KAAK,EAAE,yCAAyC;QAChD,WAAW,EACT,0FAA0F;YAC1F,kFAAkF;YAClF,yFAAyF;YACzF,kFAAkF;YAClF,2FAA2F;YAC3F,gFAAgF;YAChF,0DAA0D;YAC1D,4FAA4F;YAC5F,uFAAuF;QACzF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,2DAA2D,CAAC;YACxE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uEAAuE,CAAC;YACpF,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qEAAqE,CAAC;YAClF,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,yCAAyC,EACzC,4CAA4C,EAC5C,mBAAmB,CAAC,yCAAyC,CAAE,EAC/D,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAiF,EAAE,KAAa,EAAE,EAAE;QAClJ,MAAM,MAAM,GAA4B,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QACrF,IAAI,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC;QAC5D,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,4CAA4C,EAC5C,MAAM,CACP,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,iCAAiC;IACjC,0CAA0C;IAC1C,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,8EAA8E;YAC9E,iFAAiF;YACjF,uDAAuD;YACvD,qFAAqF;YACrF,8BAA8B;YAC9B,mEAAmE;YACnE,4FAA4F;YAC5F,4EAA4E;QAC9E,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,uDAAuD,CAAC;YACpE,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,6BAA6B,EAC7B,0BAA0B,EAC1B,mBAAmB,CAAC,6BAA6B,CAAE,EACnD,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAA2C,EAAE,KAAa,EAAE,EAAE;QACxF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,0BAA0B,EAC1B,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,CAChD,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,iCAAiC;IACjC,oCAAoC;IACpC,4EAA4E;IAC5E,wDAAwD;IACxD,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,yCAAyC;QAChD,WAAW,EACT,sFAAsF;YACtF,oEAAoE;YACpE,2FAA2F;YAC3F,gGAAgG;YAChG,0FAA0F;YAC1F,8CAA8C;YAC9C,2CAA2C;YAC3C,4DAA4D;YAC5D,6FAA6F;YAC7F,8DAA8D;QAChE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,CAAC,6BAA6B,CAAE,EACnD,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAqB,EAAE,KAAa,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACzE,yEAAyE;QACzE,kEAAkE;QAClE,MAAM,YAAY,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,oBAAoB,EACpB,EAAE,UAAU,EAAE,YAAY,EAAE,CAC7B,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,iCAAiC;IACjC,oCAAoC;IACpC,8EAA8E;IAC9E,2CAA2C;IAC3C,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,uFAAuF;YACvF,oFAAoF;YACpF,0FAA0F;YAC1F,yEAAyE;YACzE,qEAAqE;YACrE,2CAA2C;YAC3C,8EAA8E;YAC9E,iCAAiC;YACjC,0FAA0F;YAC1F,uFAAuF;YACvF,8BAA8B;QAChC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,GAAG,aAAa;SACjB;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,WAAW,CACT,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,CAAC,6BAA6B,CAAE,EACnD,GAAG,EACH,KAAK,EAAE,EAAE,KAAK,EAAqB,EAAE,KAAa,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CACF,CAAC;IAEF,4EAA4E;IAC5E,qEAAqE;IACrE,wEAAwE;IACxE,8DAA8D;IAC9D,EAAE;IACF,wEAAwE;IACxE,0FAA0F;IAC1F,mFAAmF;IACnF,kFAAkF;IAClF,4EAA4E;IAE5E,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,mFAAmF;YACnF,2EAA2E;YAC3E,qFAAqF;YACrF,uEAAuE;YACvE,yCAAyC;YACzC,yFAAyF;YACzF,qFAAqF;YACrF,mFAAmF;YACnF,wCAAwC;YACxC,qFAAqF;YACrF,0EAA0E;QAC5E,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,WAAW,CACT,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,CAAC,wBAAwB,CAAE,EAC9C,GAAG,EACH,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAElE,6DAA6D;QAC7D,IAAI,UAAU,GAAG,WAAW,CAAC;QAC7B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,UAAU,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAS1B,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAE9B,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,GAAG,CAAC,EAAE,IAAI,UAAU;YAChC,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;gBACjC,YAAY,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;gBAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;gBACjC,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI;aACtC;YACD,YAAY;SACb,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tools-carrier-ask.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Carrier MCP — carrier_ask + carrier_ask_describe (v2.0 live routing).
+ *
+ * IMPLEMENTATION STATUS: LIVE (Phase 2)
+ * carrier_ask now routes via Claude Haiku 4.5 on AWS Bedrock tool-use.
+ * The router receives the full TOOL_REGISTRY as its tool catalog and returns
+ * a single tool_use block identifying the best matching tool + extracted params.
+ *
+ * ACTIVATION:
+ *   - Requires AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY in Doppler carrier/dev+stg+prd.
+ *   - Set CARRIER_ASK_ENABLED=true in Doppler to activate per-env.
+ *   - Without the credentials/flag, carrier_ask gracefully degrades to routing_pending.
+ *
+ * DESIGN CHOICES:
+ *   - Router model: Claude Haiku 4.5 on Bedrock (us.anthropic.claude-haiku-4-5-20251001-v1:0).
+ *   - Auth: SigV4 via aws4fetch — no AWS SDK bundle (CF Worker compatible).
+ *   - tool_choice: { type: "any" } — forces a tool_use response.
+ *   - Ambiguous/no-match: sentinel "carrier_clarify" tool for Haiku to signal.
+ *   - HARD_BLOCK_TOOLS: always return confirm_token; never auto-execute.
+ *   - Confirm token TTL: 120s. Single-use (deleted on consume).
+ *   - Intent hashing: SHA-256, hex. Not stored verbatim (PII guard).
+ *   - Audit log: Analytics Engine, fire-and-forget. Extended schema for router.
+ *   - Rate-limit (429): returns friendly retry hint, never crashes.
+ *
+ * SAFETY FLOORS (non-negotiable):
+ *   - Resolved tool name validated against TOOL_REGISTRY — no hallucination.
+ *   - HARD_BLOCK_TOOLS always require confirm_token round-trip.
+ *   - No-match / ambiguous: structured response, never fabricated tool call.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext } from "./tools.js";
+declare const TOOL_REGISTRY: ReadonlySet<string>;
+declare const HARD_BLOCK_TOOLS: ReadonlySet<string>;
+export declare function hashIntent(intent: string): string;
+type RouteResult = {
+    match: "confirmed";
+    resolved_tool: string;
+    resolved_params: Record<string, unknown>;
+    confidence: number;
+    confirm_required: false;
+    execution_note: string;
+} | {
+    match: "pending_confirm";
+    resolved_tool: string;
+    resolved_params: Record<string, unknown>;
+    confidence: number;
+    confirm_required: true;
+    confirm_token: string;
+    confirm_expires_in_seconds: number;
+    dry_run_preview?: string;
+    safety_note: string;
+} | {
+    match: "ambiguous";
+    candidates: Array<{
+        tool: string;
+        reason: string;
+    }>;
+    clarifying_question: string;
+} | {
+    match: "none";
+    closest: Array<{
+        tool: string;
+        reason: string;
+    }>;
+    suggestion: string;
+} | {
+    match: "routing_pending";
+    intent_received: string;
+    note: string;
+    scaffold_version: string;
+} | {
+    match: "rate_limited";
+    retry_after_seconds: number;
+    suggestion: string;
+};
+interface BedrockTool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+interface BedrockPayload {
+    anthropic_version: "bedrock-2023-05-31";
+    max_tokens: number;
+    system: string;
+    messages: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    tools: BedrockTool[];
+    tool_choice: {
+        type: "any";
+    };
+}
+interface BedrockToolUseBlock {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+interface BedrockTextBlock {
+    type: "text";
+    text: string;
+}
+interface BedrockResponse {
+    content: Array<BedrockToolUseBlock | BedrockTextBlock>;
+    stop_reason: string;
+}
+type RoutedResult = Extract<RouteResult, {
+    match: "confirmed";
+}> | Extract<RouteResult, {
+    match: "pending_confirm";
+}> | Extract<RouteResult, {
+    match: "ambiguous";
+}> | Extract<RouteResult, {
+    match: "none";
+}> | Extract<RouteResult, {
+    match: "routing_pending";
+}> | Extract<RouteResult, {
+    match: "rate_limited";
+}>;
+export declare function callBedrock(env: {
+    AWS_ACCESS_KEY_ID: string;
+    AWS_SECRET_ACCESS_KEY: string;
+    AWS_REGION?: string;
+    BEDROCK_MODEL_ID?: string;
+}, payload: BedrockPayload): Promise<BedrockResponse>;
+export declare function _routeIntent(intent: string, context: {
+    iccid?: string;
+    account_id?: number;
+    reseller_id?: number;
+}, env: ToolContext["env"]): Promise<RoutedResult>;
+export declare function registerAllCarrierAskTools(server: McpServer, ctx: ToolContext): void;
+export { TOOL_REGISTRY, HARD_BLOCK_TOOLS };
+//# sourceMappingURL=tools-carrier-ask.d.ts.map

package/dist/tools-carrier-ask.d.ts.map

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