@carrierllc/mcp 0.2.20 → 0.3.0

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   clampUsagePeriod,
   generateStorefrontLogo,
   lastNDaysPeriod
-} from "./chunk-NHQDO2E7.js";
+} from "./chunk-ZII4CD4U.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -1188,6 +1188,169 @@ var CLI_DOMAINS = [
           }
         ],
         write: true
+      },
+      {
+        name: "sim-status show",
+        tool: "get_sim_provider_status",
+        summary: "SIM/eSIM status at the SIM provider level, distinct from OCS status.",
+        options: [ICCID]
+      },
+      {
+        name: "sim-status set",
+        tool: "change_sim_status",
+        summary: "Change the SIM/eSIM status at the SIM provider level. DELETED is irreversible.",
+        options: [
+          ICCID,
+          {
+            flags: "--status <status>",
+            description: "New SIM status: ENABLED, DISABLED or DELETED (irreversible)",
+            arg: "simStatus",
+            type: "string",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "phone-number set",
+        tool: "affect_subscriber_phone_number",
+        summary: "Assign a phone number (MSISDN) to a subscriber.",
+        options: [
+          ICCID,
+          {
+            flags: "--phone-number <e164>",
+            description: "E.164 phone number to assign, e.g. +31612345678",
+            arg: "phone_number",
+            type: "string",
+            required: true
+          },
+          {
+            flags: "--phone-type <type>",
+            description: "'fake' for test/dev MSISDNs, 'real' for production",
+            arg: "phone_type",
+            type: "string",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "contact set",
+        tool: "modify_subscriber_contact_info",
+        summary: "Update contact details on a subscriber. Omitted fields stay unchanged.",
+        options: [
+          ICCID,
+          { flags: "--first-name <name>", description: "First name", arg: "firstName", type: "string" },
+          { flags: "--last-name <name>", description: "Last name", arg: "lastName", type: "string" },
+          { flags: "--company <name>", description: "Company name", arg: "company", type: "string" },
+          { flags: "--email <email>", description: "Email address", arg: "email", type: "string" },
+          { flags: "--phone-number <number>", description: "Phone number", arg: "phoneNumber", type: "string" }
+        ],
+        write: true
+      },
+      {
+        name: "mobile-plan set",
+        tool: "modify_subscriber_mobile_plan",
+        summary: "Change the mobile pricing plan a subscriber is billed under.",
+        options: [
+          ICCID,
+          {
+            flags: "--plan-id <id>",
+            description: "Mobile pricing plan ID",
+            arg: "mobile_plan_id",
+            type: "number",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "voip-plan set",
+        tool: "modify_subscriber_voip_plan",
+        summary: "Change the VoIP pricing plan assigned to a subscriber.",
+        options: [
+          ICCID,
+          {
+            flags: "--plan-id <id>",
+            description: "VoIP pricing plan ID",
+            arg: "voip_plan_id",
+            type: "number",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "traffic set",
+        tool: "set_subscriber_traffic_restrictions",
+        summary: "Enable or disable data, calls and SMS per traffic type. Omit a flag to leave it unchanged.",
+        options: [
+          ICCID,
+          { flags: "--data <bool>", description: "Allow data traffic (true or false)", arg: "dataAllowed", type: "boolean" },
+          { flags: "--moc <bool>", description: "Allow outbound calls (true or false)", arg: "mocAllowed", type: "boolean" },
+          { flags: "--mtc <bool>", description: "Allow inbound calls (true or false)", arg: "mtcAllowed", type: "boolean" },
+          { flags: "--sms <bool>", description: "Allow outbound SMS (true or false)", arg: "smsMoAllowed", type: "boolean" }
+        ],
+        write: true
+      },
+      {
+        name: "bitrate show",
+        tool: "hlr_get_bitrate",
+        summary: "Current HLR-level bandwidth cap for a subscriber.",
+        options: [ICCID]
+      },
+      {
+        name: "bitrate set",
+        tool: "hlr_set_bitrate",
+        summary: "Set an HLR-level bandwidth cap. Pass a numeric bps value or an OCS level.",
+        options: [
+          ICCID,
+          {
+            flags: "--bitrate <bps>",
+            description: "Max bitrate in bits per second (0 removes the limit)",
+            arg: "bitrate",
+            type: "number"
+          },
+          {
+            flags: "--bitrate-string <level>",
+            description: "OCS bitrate level, e.g. KB_256, KB_1024, UNLIMITED (instead of --bitrate)",
+            arg: "bitrate_string",
+            type: "string"
+          }
+        ],
+        write: true,
+        requireOneOf: ["bitrate", "bitrate_string"]
+      },
+      {
+        name: "greenzone reset",
+        tool: "reset_subscriber_gz_counter",
+        summary: "Reset the Green Zone byte counter to zero. Irreversible.",
+        options: [ICCID],
+        write: true
+      },
+      {
+        name: "cell-location",
+        tool: "get_subscriber_location_by_cell_id",
+        summary: "Resolve a raw cell tower tuple to coordinates (Bridge4IP GeoSense).",
+        options: [
+          {
+            flags: "--radio-type <type>",
+            description: "Radio type: 2G, 3G, 4G, 5G or NB-IoT",
+            arg: "radio_type",
+            type: "string",
+            required: true
+          },
+          { flags: "--mcc <mcc>", description: "Mobile Country Code", arg: "mcc", type: "number", required: true },
+          { flags: "--mnc <mnc>", description: "Mobile Network Code", arg: "mnc", type: "number", required: true },
+          { flags: "--lac <lac>", description: "Location Area Code", arg: "lac", type: "number", required: true },
+          { flags: "--cell-id <id>", description: "Cell tower ID (strongly recommended)", arg: "cell_id", type: "number" },
+          {
+            flags: "--signal-strength <dbm>",
+            description: "Signal strength in dBm, e.g. -89 (improves accuracy)",
+            arg: "signal_strength",
+            type: "number"
+          }
+        ]
       }
     ]
   },
@@ -1280,6 +1443,87 @@ var CLI_DOMAINS = [
         ],
         write: true
       },
+      {
+        name: "assign-recurring",
+        tool: "assign_recurring_package",
+        summary: "Assign an auto-renewing package from a recurring-enabled template.",
+        options: [
+          ICCID,
+          {
+            flags: "--template-id <id>",
+            description: "Recurring package template ID from `carrier templates list`",
+            arg: "packageTemplateId",
+            type: "number",
+            required: true
+          },
+          {
+            flags: "--activate-at-first-use",
+            description: "Activate on first network usage (instead of --start-time)",
+            arg: "activation_at_first_use",
+            type: "boolean"
+          },
+          {
+            flags: "--start-time <iso>",
+            description: "Scheduled activation, ISO 8601 UTC (instead of --activate-at-first-use)",
+            arg: "start_time_utc",
+            type: "string"
+          }
+        ],
+        write: true
+      },
+      {
+        name: "recurring set",
+        tool: "stop_resume_recurring_package",
+        summary: "Pause or restart the auto-renewal of a recurring package.",
+        options: [
+          ICCID,
+          PACKAGE_ID,
+          {
+            flags: "--action <action>",
+            description: "'stop' halts future renewals, 'resume' re-enables them",
+            arg: "action",
+            type: "string",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "active-period set",
+        tool: "modify_subscriber_package_active_period",
+        summary: "Move the start and/or end of a package's active period.",
+        options: [
+          ICCID,
+          {
+            flags: "--package-id <id>",
+            description: "Package ID from `carrier packages list`",
+            arg: "package_id",
+            type: "number",
+            required: true
+          },
+          {
+            flags: "--start <date>",
+            description: "New start date, ISO 8601 (e.g. 2026-09-01)",
+            arg: "start_date",
+            type: "string"
+          },
+          {
+            flags: "--end <date>",
+            description: "New end date, ISO 8601 (e.g. 2026-09-30)",
+            arg: "end_date",
+            type: "string"
+          }
+        ],
+        write: true,
+        requireOneOf: ["start_date", "end_date"]
+      },
+      {
+        name: "clean",
+        tool: "clean_all_packages",
+        summary: "Remove ALL packages from a subscriber. Irreversible.",
+        options: [ICCID],
+        write: true
+      },
       {
         name: "delete",
         tool: "delete_subscriber_package",
@@ -1402,6 +1646,28 @@ var CLI_DOMAINS = [
         ],
         write: true
       },
+      {
+        name: "network-profile set",
+        tool: "change_network_profile_of_location_zone",
+        summary: "Attach or change the network profile on an existing location zone.",
+        options: [
+          {
+            flags: "--zone-id <id>",
+            description: "Location zone ID from `carrier zones list`",
+            arg: "location_zone_id",
+            type: "number",
+            required: true
+          },
+          {
+            flags: "--network-profile-id <id>",
+            description: "Network profile ID from `carrier network-profiles list`",
+            arg: "network_profile_id",
+            type: "number",
+            required: true
+          }
+        ],
+        write: true
+      },
       {
         name: "destinations",
         tool: "list_destination_lists",
@@ -1458,6 +1724,193 @@ var CLI_DOMAINS = [
       }
     ]
   },
+  {
+    name: "accounts",
+    summary: "Reseller accounts: balances and subscriber moves.",
+    commands: [
+      {
+        name: "list",
+        tool: "list_reseller_accounts",
+        summary: "Accounts under a reseller with name, balance and type.",
+        options: [RESELLER_ID]
+      },
+      {
+        name: "balance set",
+        tool: "modify_account_balance",
+        summary: "Add to or replace an account's monetary balance.",
+        options: [
+          { ...ACCOUNT_ID("Account ID from `carrier accounts list`"), required: true },
+          {
+            flags: "--amount <amount>",
+            description: "Amount to add (adapt) or set to (set)",
+            arg: "amount",
+            type: "number",
+            required: true
+          },
+          {
+            flags: "--mode <mode>",
+            description: "'adapt' adds or subtracts, 'set' replaces",
+            arg: "mode",
+            type: "string",
+            required: true
+          }
+        ],
+        write: true
+      },
+      {
+        name: "move-subscribers",
+        tool: "move_subscriber_range_to_account",
+        summary: "Move a contiguous ICCID range of subscribers to another account.",
+        options: [
+          {
+            flags: "--iccid-from <iccid>",
+            description: "Start ICCID of the range (inclusive)",
+            arg: "iccidFrom",
+            type: "string",
+            required: true
+          },
+          {
+            flags: "--iccid-to <iccid>",
+            description: "End ICCID of the range (inclusive)",
+            arg: "iccidTo",
+            type: "string",
+            required: true
+          },
+          { ...ACCOUNT_ID("Target account ID from `carrier accounts list`"), required: true }
+        ],
+        write: true
+      }
+    ]
+  },
+  {
+    name: "reseller",
+    summary: "The reseller the token belongs to.",
+    commands: [
+      {
+        name: "show",
+        tool: "get_reseller_info",
+        summary: "Full reseller record: balance, pricing plans, contact and traffic config.",
+        options: [RESELLER_ID]
+      }
+    ]
+  },
+  {
+    name: "tariff",
+    summary: "Wholesale tariffs: mobile and VoIP rates.",
+    commands: [
+      {
+        name: "show",
+        tool: "get_tariff",
+        summary: "Per-country wholesale rates for data, voice and SMS.",
+        options: [RESELLER_ID]
+      },
+      {
+        name: "voip",
+        tool: "list_subscriber_voip_tariff",
+        summary: "VoIP tariff catalog for a reseller.",
+        options: [
+          {
+            flags: "--reseller-id <id>",
+            description: "Reseller ID (omit for the token owner's reseller)",
+            arg: "reseller_id",
+            type: "number"
+          }
+        ]
+      },
+      {
+        name: "voip-rules",
+        tool: "list_voip_tariff_rule",
+        summary: "Rate rules inside one VoIP plan.",
+        options: [
+          {
+            flags: "--voip-plan-id <id>",
+            description: "VoIP plan ID from `carrier tariff voip`",
+            arg: "voip_plan_id",
+            type: "number",
+            required: true
+          }
+        ]
+      }
+    ]
+  },
+  {
+    name: "sms",
+    summary: "Mobile-terminated SMS to subscribers.",
+    commands: [
+      {
+        name: "send",
+        tool: "send_sms",
+        summary: "Send an MT SMS to one subscriber.",
+        options: [
+          ICCID,
+          {
+            flags: "--msisdn <msisdn>",
+            description: "Target MSISDN in E.164 format",
+            arg: "msisdn",
+            type: "string",
+            required: true
+          },
+          {
+            flags: "--message <text>",
+            description: "SMS text (160 chars GSM-7; 70 with emoji or non-Latin scripts)",
+            arg: "message",
+            type: "string",
+            required: true
+          },
+          {
+            flags: "--sender <sender>",
+            description: "Sender ID or number shown on the device",
+            arg: "sender",
+            type: "string"
+          }
+        ],
+        write: true
+      }
+    ]
+  },
+  {
+    name: "sponsors",
+    summary: "Sponsor networks backing the eSIM profiles.",
+    commands: [
+      {
+        name: "list",
+        tool: "list_sponsors",
+        summary: "Sponsor carriers available to this reseller.",
+        options: [RESELLER_ID]
+      }
+    ]
+  },
+  {
+    name: "network-profiles",
+    summary: "Roaming configuration profiles for zones and provisioning.",
+    commands: [
+      {
+        name: "list",
+        tool: "list_network_profiles",
+        summary: "Network profiles available to this reseller.",
+        options: []
+      }
+    ]
+  },
+  {
+    name: "webhooks",
+    summary: "Bridge4IP webhook and relay flag status.",
+    commands: [
+      {
+        name: "show",
+        tool: "carrier_webhook_config",
+        summary: "Current relay flags (LU, Gy, VoIP, calls+SMS) and notification webhooks.",
+        options: [
+          {
+            flags: "--reseller-id <id>",
+            description: "Reseller ID (omit for the token owner's reseller)",
+            arg: "reseller_id",
+            type: "number"
+          }
+        ]
+      }
+    ]
+  },
   {
     name: "intelligence",
     summary: "Composite reports over the fleet.",
@@ -1560,7 +2013,13 @@ function setArg(target, path, value) {
   node[parts[parts.length - 1]] = value;
 }
 function coerce(opt, raw) {
-  if (opt.type === "boolean") return { value: raw === true };
+  if (opt.type === "boolean") {
+    if (raw === true) return { value: true };
+    const text3 = String(raw).toLowerCase();
+    if (text3 === "true") return { value: true };
+    if (text3 === "false") return { value: false };
+    return { error: `${opt.flags} expects true or false, got "${String(raw)}"` };
+  }
   if (opt.type === "number") {
     const n = Number(raw);
     if (!Number.isFinite(n)) return { error: `${opt.flags} expects a number, got "${String(raw)}"` };
@@ -2068,8 +2527,21 @@ program.command("ask").description(
 });
 for (const domain of CLI_DOMAINS) {
   const group = program.command(domain.name).description(domain.summary);
+  const subgroups = /* @__PURE__ */ new Map();
   for (const cmd of domain.commands) {
-    const sub = group.command(cmd.name).description(cmd.write ? `${cmd.summary} Dry run unless --commit.` : cmd.summary);
+    const parts = cmd.name.split(" ");
+    let parent = group;
+    let prefix = "";
+    for (const part of parts.slice(0, -1)) {
+      prefix = prefix ? `${prefix} ${part}` : part;
+      let nested = subgroups.get(prefix);
+      if (!nested) {
+        nested = parent.command(part).description(`${part} subcommands`);
+        subgroups.set(prefix, nested);
+      }
+      parent = nested;
+    }
+    const sub = parent.command(parts[parts.length - 1]).description(cmd.write ? `${cmd.summary} Dry run unless --commit.` : cmd.summary);
     for (const opt of cmd.options) sub.option(opt.flags, opt.description);
     sub.option("--json", "Print the raw tool response on stdout and nothing else");
     if (cmd.write) sub.option("--commit", "Apply the change instead of previewing it");