@carrierllc/mcp 0.0.1 → 0.1.0

package/dist/tools.js

@@ -0,0 +1,702 @@
+/**
+ * Carrier MCP stdio — OCS tool registrations (43 tools).
+ *
+ * Stdio variant: no scope enforcement, no audit hook, no Sentry.
+ * Single-user — token held in OcsClient class, not passed per-call.
+ *
+ * All 16 schema fixes from PR #10 are preserved:
+ *   Fix #1:  getSimProviderStatus  — ICCID → simId lookup → bare integer
+ *   Fix #2:  hlrGetBitrate         — ICCID → IMSI lookup → { imsi }
+ *   Fix #3:  hlrSetBitrate         — ICCID → IMSI + bitrate → limit rename
+ *   Fix #4:  subscriberUsageOverPeriod       — { subscriber: { iccid }, period }
+ *   Fix #5:  subscriberNetworkEventsOverPeriod — same nested shape
+ *   Fix #6:  modifySubscriberStatus          — { subscriber, newStatus }
+ *   Fix #7:  modifySubscriberBalance         — { subscriber, amount|setBalance }
+ *   Fix #8:  changeSimStatus                 — ICCID → simId + newStatus
+ *   Fix #9:  modifySubscriberContactInfo     — name/mail/phone field names
+ *   Fix #10: setSubscriberTrafficRestrictions — typed booleans
+ *   Fix #11: sendMtSms                       — ICCID→IMSI, message→text, sender→senderId
+ *   Fix #12: listSponsor                     — bare integer (resellerId)
+ *   Fix #13: listSteeringList                — bare integer (resellerId)
+ *   Fix #14: getCustomerTariff               — bare integer + listTariffRule key
+ *   Fix #15: listDetailedLocationZone        — bare integer (resellerId)
+ *   Fix #16: modifySubscriberSteeringList    — { subscriber, steeringListId }
+ */
+import { z } from "zod";
+import { OcsApiError } from "./client.js";
+const DRY_RUN_FIELD = {
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe("If true, do not call OCS — return the would-be request for confirmation"),
+};
+export const DESTRUCTIVE_TOOLS = new Set([
+    "modify_account_balance",
+    "modify_subscriber_balance",
+    "modify_subscriber_status",
+    "change_sim_status",
+    "modify_subscriber_contact_info",
+    "set_subscriber_traffic_restrictions",
+    "modify_subscriber_steering_list",
+    "move_subscriber_range_to_account",
+    "hlr_set_bitrate",
+    "assign_package",
+    "assign_recurring_package",
+    "modify_package_limits",
+    "modify_package_expiry",
+    "modify_package_status",
+    "stop_resume_recurring_package",
+    "delete_subscriber_package",
+    "clean_all_packages",
+    "modify_template_core",
+    "modify_template_recurring",
+    "modify_template_throttling",
+    "create_package_template",
+    "create_location_zone",
+    "send_sms",
+]);
+async function ocsCall(client, method, params = {}) {
+    const result = await client.call(method, params);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+async function resolveSubscriberByIccid(client, iccid, cache) {
+    const hit = cache.get(iccid);
+    if (hit)
+        return hit;
+    const record = await client.call("getSingleSubscriber", { iccid });
+    cache.set(iccid, record);
+    return record;
+}
+async function getDefaultResellerId(client) {
+    const info = await client.call("getResellerInfo", {});
+    const id = info?.id;
+    if (typeof id !== "number") {
+        throw new Error("Could not determine resellerId from getResellerInfo");
+    }
+    return id;
+}
+function makeHandler(toolName, _client, fn) {
+    return async (args) => {
+        if (args.dry_run === true && DESTRUCTIVE_TOOLS.has(toolName)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `[dry_run=true] Would execute '${toolName}' with args: ${JSON.stringify(args)}. No changes made.`,
+                    },
+                ],
+            };
+        }
+        try {
+            return await fn(args);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const prefix = err instanceof OcsApiError ? `OCS ${err.code}: ` : "";
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: ${prefix}${message}` }],
+            };
+        }
+    };
+}
+export function registerAllTools(server, client) {
+    // =========================================================================
+    // 1. RESELLER TOOLS
+    // =========================================================================
+    server.registerTool("list_reseller_accounts", {
+        title: "List Reseller Accounts",
+        description: "List all accounts across all resellers, or filter by a specific reseller ID. Returns account names, balances, and package-only status.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Filter to a specific reseller by ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_reseller_accounts", client, async ({ resellerId }) => {
+        const params = {};
+        if (resellerId !== undefined)
+            params.resellerId = resellerId;
+        return ocsCall(client, "listResellerAccount", params);
+    }));
+    server.registerTool("modify_account_balance", {
+        title: "Modify Account Balance",
+        description: "Adjust or set the balance of a reseller account. 'adapt' adds/subtracts from current balance; 'set' replaces it.",
+        inputSchema: {
+            accountId: z.number().describe("The account ID to modify"),
+            amount: z.number().describe("Amount to add (adapt) or set to (set)"),
+            mode: z.enum(["adapt", "set"]).describe("'adapt' adds/subtracts, 'set' replaces the balance"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_account_balance", client, async ({ accountId, amount, mode }) => {
+        const params = { accountId };
+        if (mode === "adapt")
+            params.adaptBalance = amount;
+        else
+            params.setBalance = amount;
+        return ocsCall(client, "modifyAccountBalance", params);
+    }));
+    server.registerTool("get_reseller_info", {
+        title: "Get Reseller Info",
+        description: "Retrieve detailed information about a reseller. If no ID provided, returns info for the reseller owning the API token.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Reseller ID (omit for token owner)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("get_reseller_info", client, async ({ resellerId }) => {
+        const params = {};
+        if (resellerId !== undefined)
+            params.resellerId = resellerId;
+        return ocsCall(client, "getResellerInfo", params);
+    }));
+    server.registerTool("esim_status_per_account", {
+        title: "eSIM Status Per Account",
+        description: "Get eSIM status breakdown per account — active, suspended, inventory counts.",
+        inputSchema: {
+            accountId: z.number().optional().describe("Filter to a specific account"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("esim_status_per_account", client, async ({ accountId }) => {
+        const params = {};
+        if (accountId !== undefined)
+            params.accountId = accountId;
+        return ocsCall(client, "esimStatusPerAccount", params);
+    }));
+    // Fix #12: bare integer
+    server.registerTool("list_sponsors", {
+        title: "List Sponsors",
+        description: "List all sponsor networks available to this reseller. Pass resellerId explicitly or omit to use the token owner's reseller.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Reseller ID (omit to use token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_sponsors", client, async ({ resellerId }) => {
+        const id = resellerId ?? (await getDefaultResellerId(client));
+        return ocsCall(client, "listSponsor", id);
+    }));
+    // Fix #13: bare integer
+    server.registerTool("list_steering_lists", {
+        title: "List Steering Lists",
+        description: "List all network steering lists for this reseller. Steering lists control which networks eSIMs prefer to connect to.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Reseller ID (omit to use token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_steering_lists", client, async ({ resellerId }) => {
+        const id = resellerId ?? (await getDefaultResellerId(client));
+        return ocsCall(client, "listSteeringList", id);
+    }));
+    // =========================================================================
+    // 2. SUBSCRIBER TOOLS
+    // =========================================================================
+    server.registerTool("get_subscriber", {
+        title: "Get Single Subscriber",
+        description: "Retrieve full details for a single subscriber by ICCID or MSISDN.",
+        inputSchema: {
+            iccid: z.string().optional().describe("The ICCID of the subscriber"),
+            msisdn: z.string().optional().describe("The MSISDN (phone number) of the subscriber"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("get_subscriber", client, async ({ iccid, msisdn }) => {
+        const params = {};
+        if (iccid)
+            params.iccid = iccid;
+        if (msisdn)
+            params.msisdn = msisdn;
+        return ocsCall(client, "getSingleSubscriber", params);
+    }));
+    server.registerTool("list_subscribers", {
+        title: "List Subscribers",
+        description: "List subscribers with optional filters. Supports pagination.",
+        inputSchema: {
+            accountId: z.number().optional().describe("Filter by account ID"),
+            status: z.string().optional().describe("Filter by status"),
+            offset: z.number().optional().describe("Pagination offset"),
+            limit: z.number().optional().describe("Max results to return"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_subscribers", client, async (args) => {
+        const params = {};
+        if (args.accountId !== undefined)
+            params.accountId = args.accountId;
+        if (args.status)
+            params.status = args.status;
+        if (args.offset !== undefined)
+            params.offset = args.offset;
+        if (args.limit !== undefined)
+            params.limit = args.limit;
+        return ocsCall(client, "listSubscriber", params);
+    }));
+    // Fix #7: { subscriber, amount } or { subscriber, setBalance }
+    server.registerTool("modify_subscriber_balance", {
+        title: "Modify Subscriber Balance",
+        description: "Adjust or set the balance of an individual subscriber. 'adapt' adds/subtracts; 'set' replaces.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            amount: z.number().describe("Amount to add (adapt) or set to (set)"),
+            mode: z.enum(["adapt", "set"]).describe("'adapt' adds/subtracts, 'set' replaces"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_subscriber_balance", client, async ({ iccid, amount, mode }) => {
+        const params = { subscriber: iccid };
+        if (mode === "adapt")
+            params.amount = amount;
+        else
+            params.setBalance = amount;
+        return ocsCall(client, "modifySubscriberBalance", params);
+    }));
+    // Fix #6: { subscriber, newStatus }
+    server.registerTool("modify_subscriber_status", {
+        title: "Modify Subscriber Status",
+        description: "Change a subscriber's status (e.g., activate, suspend, terminate).",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            status: z.string().describe("New status value"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_subscriber_status", client, async ({ iccid, status }) => ocsCall(client, "modifySubscriberStatus", { subscriber: iccid, newStatus: status })));
+    // Fix #8: ICCID → simId → { simId, newStatus }
+    server.registerTool("change_sim_status", {
+        title: "Change SIM Status",
+        description: "Change the SIM card status at the provider level (enable/disable/delete). Internally resolves ICCID to simId before calling OCS.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            simStatus: z.string().describe("New SIM status (e.g. ENABLED, DISABLED, DELETED)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("change_sim_status", client, async ({ iccid, simStatus }) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(client, iccid, cache);
+        const simId = sub.simId ?? sub.sim_id ?? sub.id;
+        if (simId === undefined) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Could not resolve simId for ICCID ${iccid}` }],
+            };
+        }
+        return ocsCall(client, "changeSimStatus", { simId: Number(simId), newStatus: simStatus });
+    }));
+    // Fix #1: ICCID → simId → bare integer
+    server.registerTool("get_sim_provider_status", {
+        title: "Get SIM Provider Status",
+        description: "Check the SIM provider-level status for a subscriber. Accepts ICCID; resolves to the numeric simId required by OCS internally.",
+        inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("get_sim_provider_status", client, async ({ iccid }) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(client, iccid, cache);
+        const simId = sub.simId ?? sub.sim_id ?? sub.id;
+        if (simId === undefined) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Could not resolve simId for ICCID ${iccid}` }],
+            };
+        }
+        return ocsCall(client, "getSimProviderStatus", Number(simId));
+    }));
+    server.registerTool("get_subscriber_location", {
+        title: "Get Subscriber Location",
+        description: "Get the last known location of a subscriber.",
+        inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("get_subscriber_location", client, async ({ iccid }) => ocsCall(client, "getSubscriberLocation", { iccid })));
+    // Fix #9: name/mail/phone field names
+    server.registerTool("modify_subscriber_contact_info", {
+        title: "Modify Subscriber Contact Info",
+        description: "Update contact information (name, email, etc.) for a subscriber.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            firstName: z.string().optional().describe("First name"),
+            lastName: z.string().optional().describe("Last name"),
+            company: z.string().optional().describe("Company name"),
+            email: z.string().optional().describe("Email address"),
+            phoneNumber: z.string().optional().describe("Phone number"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_subscriber_contact_info", client, async ({ iccid, firstName, lastName, company, email, phoneNumber }) => {
+        const params = { subscriber: iccid };
+        const nameParts = [firstName, lastName].filter(Boolean);
+        if (nameParts.length > 0)
+            params.name = nameParts.join(" ");
+        if (company !== undefined)
+            params.company = company;
+        if (phoneNumber !== undefined)
+            params.phone = phoneNumber;
+        if (email !== undefined)
+            params.mail = email;
+        return ocsCall(client, "modifySubscriberContactInfo", params);
+    }));
+    // Fix #10: typed booleans
+    server.registerTool("set_subscriber_traffic_restrictions", {
+        title: "Set Traffic Restrictions",
+        description: "Configure traffic restrictions for a subscriber — control allowed/blocked traffic types (data, voice MO/MT, SMS MO).",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            mtcAllowed: z.boolean().optional().describe("Allow mobile-terminated calls"),
+            smsMoAllowed: z.boolean().optional().describe("Allow SMS mobile-originated"),
+            dataAllowed: z.boolean().optional().describe("Allow data traffic"),
+            mocAllowed: z.boolean().optional().describe("Allow mobile-originated calls"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("set_subscriber_traffic_restrictions", client, async ({ iccid, mtcAllowed, smsMoAllowed, dataAllowed, mocAllowed }) => {
+        const params = { subscriber: iccid };
+        if (mtcAllowed !== undefined)
+            params.mtcAllowed = mtcAllowed;
+        if (smsMoAllowed !== undefined)
+            params.smsMoAllowed = smsMoAllowed;
+        if (dataAllowed !== undefined)
+            params.dataAllowed = dataAllowed;
+        if (mocAllowed !== undefined)
+            params.mocAllowed = mocAllowed;
+        return ocsCall(client, "setSubscriberTrafficRestrictions", params);
+    }));
+    // Fix #16: { subscriber, steeringListId }
+    server.registerTool("modify_subscriber_steering_list", {
+        title: "Modify Subscriber Steering List",
+        description: "Change the network steering list assigned to a subscriber.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            steeringListId: z.number().describe("The steering list ID to assign"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_subscriber_steering_list", client, async ({ iccid, steeringListId }) => ocsCall(client, "modifySubscriberSteeringList", { subscriber: iccid, steeringListId })));
+    server.registerTool("move_subscriber_range_to_account", {
+        title: "Move Subscribers to Account",
+        description: "Move a range of subscribers to a different account.",
+        inputSchema: {
+            iccidFrom: z.string().describe("Start ICCID of range"),
+            iccidTo: z.string().describe("End ICCID of range"),
+            accountId: z.number().describe("Target account ID"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("move_subscriber_range_to_account", client, async ({ iccidFrom, iccidTo, accountId }) => ocsCall(client, "moveSubscriberRangeToAccount", { iccidFrom, iccidTo, accountId })));
+    // Fix #3: ICCID → IMSI + bitrate → limit
+    server.registerTool("hlr_set_bitrate", {
+        title: "Set HLR Bitrate",
+        description: "Set the maximum data bitrate for a subscriber at the HLR level. Accepts ICCID; resolves to IMSI required by OCS internally.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            bitrate: z.number().describe("Max bitrate in bps"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("hlr_set_bitrate", client, async ({ iccid, bitrate }) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(client, iccid, cache);
+        const imsi = sub.imsi;
+        if (typeof imsi !== "string" || imsi.length === 0) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Could not resolve IMSI for ICCID ${iccid}` }],
+            };
+        }
+        return ocsCall(client, "hlrSetBitrate", { imsi, limit: bitrate });
+    }));
+    // Fix #2: ICCID → IMSI
+    server.registerTool("hlr_get_bitrate", {
+        title: "Get HLR Bitrate",
+        description: "Get the current HLR bitrate setting for a subscriber. Accepts ICCID; resolves to IMSI required by OCS internally.",
+        inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("hlr_get_bitrate", client, async ({ iccid }) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(client, iccid, cache);
+        const imsi = sub.imsi;
+        if (typeof imsi !== "string" || imsi.length === 0) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Could not resolve IMSI for ICCID ${iccid}` }],
+            };
+        }
+        return ocsCall(client, "hlrGetBitrate", { imsi });
+    }));
+    // =========================================================================
+    // 3. PACKAGE TOOLS
+    // =========================================================================
+    server.registerTool("list_subscriber_packages", {
+        title: "List Subscriber Packages",
+        description: "List all prepaid packages assigned to a subscriber. Shows allowances, usage, expiry, status.",
+        inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_subscriber_packages", client, async ({ iccid }) => ocsCall(client, "listSubscriberPrepaidPackages", { iccid })));
+    server.registerTool("assign_package", {
+        title: "Assign Package to Subscriber",
+        description: "Assign a prepaid package template to a subscriber.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageTemplateId: z.number().describe("The package template ID to assign"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("assign_package", client, async ({ iccid, packageTemplateId }) => ocsCall(client, "affectPackageToSubscriber", { subscriber: iccid, packageTemplateId })));
+    server.registerTool("assign_recurring_package", {
+        title: "Assign Recurring Package",
+        description: "Assign a recurring (auto-renewing) prepaid package to a subscriber.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageTemplateId: z.number().describe("The package template ID"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("assign_recurring_package", client, async ({ iccid, packageTemplateId }) => ocsCall(client, "affectRecurringPackageToSubscriber", { subscriber: iccid, packageTemplateId })));
+    server.registerTool("modify_package_limits", {
+        title: "Modify Package Limits",
+        description: "Change the data/voice/SMS limits on an active subscriber package.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageId: z.number().describe("The active package ID"),
+            limits: z.string().describe("New limits as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_package_limits", client, async ({ iccid, packageId, limits }) => ocsCall(client, "modifySubscriberPrepaidPackageLimits", {
+        iccid,
+        packageId,
+        ...JSON.parse(limits),
+    })));
+    server.registerTool("modify_package_expiry", {
+        title: "Modify Package Expiry Date",
+        description: "Change the expiration date of an active subscriber package.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageId: z.number().describe("The active package ID"),
+            expirationDate: z.string().describe("New expiry date (ISO 8601 format)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_package_expiry", client, async ({ iccid, packageId, expirationDate }) => ocsCall(client, "modifySubscriberPrepaidPackageExpDate", { iccid, packageId, expirationDate })));
+    server.registerTool("modify_package_status", {
+        title: "Modify Package Status",
+        description: "Activate or deactivate a subscriber's prepaid package.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageId: z.number().describe("The active package ID"),
+            status: z.string().describe("New package status"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_package_status", client, async ({ iccid, packageId, status }) => ocsCall(client, "modifySubscriberPrepaidPackageStatus", { iccid, packageId, status })));
+    server.registerTool("stop_resume_recurring_package", {
+        title: "Stop/Resume Recurring Package",
+        description: "Stop or resume a recurring package's auto-renewal.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageId: z.number().describe("The recurring package ID"),
+            action: z.enum(["stop", "resume"]).describe("Whether to stop or resume"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("stop_resume_recurring_package", client, async ({ iccid, packageId, action }) => ocsCall(client, "stopResumeSubsRecurringPackage", { iccid, packageId, action })));
+    server.registerTool("delete_subscriber_package", {
+        title: "Delete Subscriber Package",
+        description: "Remove a package from a subscriber entirely.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            packageId: z.number().describe("The package ID to delete"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("delete_subscriber_package", client, async ({ iccid, packageId }) => ocsCall(client, "deleteSubscriberPackage", { iccid, packageId })));
+    server.registerTool("clean_all_packages", {
+        title: "Clean All Subscriber Packages",
+        description: "Remove ALL packages from a subscriber. Use with caution.",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("clean_all_packages", client, async ({ iccid }) => ocsCall(client, "cleanSubscriberAllPackages", { iccid })));
+    // =========================================================================
+    // 4. PACKAGE TEMPLATE TOOLS
+    // =========================================================================
+    server.registerTool("list_package_templates", {
+        title: "List Package Templates",
+        description: "List all available prepaid package templates.",
+        inputSchema: {
+            accountId: z.number().optional().describe("Filter templates by account ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_package_templates", client, async ({ accountId }) => {
+        const params = {};
+        if (accountId !== undefined)
+            params.accountId = accountId;
+        return ocsCall(client, "listPrepaidPackageTemplate", params);
+    }));
+    server.registerTool("create_package_template", {
+        title: "Create Package Template",
+        description: "Create a new prepaid package template. Define allowances, pricing, zones, and validity.",
+        inputSchema: {
+            template: z.string().describe("Full template configuration as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("create_package_template", client, async ({ template }) => ocsCall(client, "createPrepaidPackageTemplate", JSON.parse(template))));
+    server.registerTool("modify_template_core", {
+        title: "Modify Template Core Settings",
+        description: "Modify core settings of a package template (name, limits, pricing).",
+        inputSchema: {
+            templateId: z.number().describe("The template ID"),
+            changes: z.string().describe("Core fields to modify as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_template_core", client, async ({ templateId, changes }) => ocsCall(client, "modifyPPTCore", { templateId, ...JSON.parse(changes) })));
+    server.registerTool("modify_template_recurring", {
+        title: "Modify Template Recurring Settings",
+        description: "Modify recurring/renewal settings of a package template.",
+        inputSchema: {
+            templateId: z.number().describe("The template ID"),
+            changes: z.string().describe("Recurring fields to modify as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_template_recurring", client, async ({ templateId, changes }) => ocsCall(client, "modifyPPTRecurring", { templateId, ...JSON.parse(changes) })));
+    server.registerTool("modify_template_throttling", {
+        title: "Modify Template Throttling",
+        description: "Modify throttling/speed settings of a package template.",
+        inputSchema: {
+            templateId: z.number().describe("The template ID"),
+            changes: z.string().describe("Throttling fields to modify as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("modify_template_throttling", client, async ({ templateId, changes }) => ocsCall(client, "modifyPPTThrottling", { templateId, ...JSON.parse(changes) })));
+    server.registerTool("list_location_zones", {
+        title: "List Location Zone Elements",
+        description: "List countries/networks in a location zone.",
+        inputSchema: {
+            locationZoneId: z.number().optional().describe("Filter by zone ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_location_zones", client, async ({ locationZoneId }) => {
+        const params = {};
+        if (locationZoneId !== undefined)
+            params.locationZoneId = locationZoneId;
+        return ocsCall(client, "listLocationZoneElement", params);
+    }));
+    // Fix #15: bare integer
+    server.registerTool("list_detailed_location_zones", {
+        title: "List Detailed Location Zones",
+        description: "Get detailed location zone definitions with included countries/networks. Pass resellerId explicitly or omit to use the token owner's reseller.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Reseller ID (omit to use token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_detailed_location_zones", client, async ({ resellerId }) => {
+        const id = resellerId ?? (await getDefaultResellerId(client));
+        return ocsCall(client, "listDetailedLocationZone", id);
+    }));
+    server.registerTool("list_destination_prefixes", {
+        title: "List Destination List Prefixes",
+        description: "List phone number prefixes in destination lists (for voice/SMS routing).",
+        inputSchema: {
+            destinationListId: z.number().optional().describe("Filter by destination list ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_destination_prefixes", client, async ({ destinationListId }) => {
+        const params = {};
+        if (destinationListId !== undefined)
+            params.destinationListId = destinationListId;
+        return ocsCall(client, "listDestinationListPrefix", params);
+    }));
+    server.registerTool("create_location_zone", {
+        title: "Create Location Zone",
+        description: "Create a new location zone for use in package templates.",
+        inputSchema: {
+            zone: z.string().describe("Zone configuration as JSON string"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("create_location_zone", client, async ({ zone }) => ocsCall(client, "createLocationZone", JSON.parse(zone))));
+    // =========================================================================
+    // 5. STATISTICS TOOLS
+    // =========================================================================
+    // Fix #4: { subscriber: { iccid }, period: { start, end } }
+    server.registerTool("subscriber_usage", {
+        title: "Subscriber Usage Over Period",
+        description: "Get daily data/voice/SMS usage for a subscriber over a date range (max 7 days).",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            startDate: z.string().describe("Start date (YYYY-MM-DD, inclusive)"),
+            endDate: z.string().describe("End date (YYYY-MM-DD, inclusive, max 7 days from start)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("subscriber_usage", client, async ({ iccid, startDate, endDate }) => ocsCall(client, "subscriberUsageOverPeriod", {
+        subscriber: { iccid },
+        period: { start: startDate, end: endDate },
+    })));
+    // Fix #5: same nested shape
+    server.registerTool("subscriber_network_events", {
+        title: "Subscriber Network Events",
+        description: "Get network events (attach, detach, location updates) for a subscriber over a period (max 7 days).",
+        inputSchema: {
+            iccid: z.string().describe("The subscriber ICCID"),
+            startDate: z.string().describe("Start date (YYYY-MM-DD, inclusive)"),
+            endDate: z.string().describe("End date (YYYY-MM-DD, inclusive)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("subscriber_network_events", client, async ({ iccid, startDate, endDate }) => ocsCall(client, "subscriberNetworkEventsOverPeriod", {
+        subscriber: { iccid },
+        period: { start: startDate, end: endDate },
+    })));
+    server.registerTool("subscriber_active_period", {
+        title: "Get Subscriber Active Period",
+        description: "Get the active period (first to last use) for a subscriber.",
+        inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("subscriber_active_period", client, async ({ iccid }) => ocsCall(client, "getSubscriberActivePeriod", { iccid })));
+    // =========================================================================
+    // 6. MISC TOOLS
+    // =========================================================================
+    // Fix #14: bare integer, listTariffRule response key
+    server.registerTool("get_tariff", {
+        title: "Get Customer Tariff",
+        description: "Retrieve the tariff/pricing table for this reseller (per-country, per-traffic-type rates). Pass resellerId explicitly or omit to use the token owner's reseller.",
+        inputSchema: {
+            resellerId: z.number().optional().describe("Reseller ID (omit to use token owner's reseller)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, makeHandler("get_tariff", client, async ({ resellerId }) => {
+        const id = resellerId ?? (await getDefaultResellerId(client));
+        return ocsCall(client, "getCustomerTariff", id);
+    }));
+    // Fix #11: ICCID→IMSI, message→text, sender→senderId
+    server.registerTool("send_sms", {
+        title: "Send MT SMS",
+        description: "Send a mobile-terminated SMS to a subscriber. Accepts ICCID; resolves to IMSI required by OCS internally.",
+        inputSchema: {
+            iccid: z.string().describe("The target subscriber ICCID"),
+            msisdn: z.string().describe("The target MSISDN"),
+            message: z.string().describe("SMS text content"),
+            sender: z.string().optional().describe("Sender ID/number (senderId in OCS)"),
+            ...DRY_RUN_FIELD,
+        },
+        annotations: { destructiveHint: true },
+    }, makeHandler("send_sms", client, async ({ iccid, msisdn, message, sender }) => {
+        const cache = new Map();
+        const sub = await resolveSubscriberByIccid(client, iccid, cache);
+        const imsi = sub.imsi;
+        if (typeof imsi !== "string" || imsi.length === 0) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Could not resolve IMSI for ICCID ${iccid}` }],
+            };
+        }
+        const params = { imsi, msisdn, text: message };
+        if (sender)
+            params.senderId = sender;
+        return ocsCall(client, "sendMtSms", params);
+    }));
+    server.registerTool("list_network_profiles", {
+        title: "List Network Profiles",
+        description: "List all available network profiles.",
+        annotations: { readOnlyHint: true },
+    }, makeHandler("list_network_profiles", client, async (_args) => ocsCall(client, "listNetworkProfile")));
+}
+//# sourceMappingURL=tools.js.map