@carrierllc/mcp 0.2.20 → 0.3.1

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   clampUsagePeriod,
   generateStorefrontLogo,
   lastNDaysPeriod
-} from "./chunk-NHQDO2E7.js";
+} from "./chunk-TABEJ7SM.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -773,6 +773,22 @@ var DEFAULT_ERROR_HINTS = [
   "Re-check the arguments: carrier <domain> <command> --help",
   "Or open Claude and ask there with full tool routing"
 ];
+var DEFAULT_MCP_TIMEOUT_MS = 45e3;
+function mcpTimeoutMs() {
+  const parsed = Number(process.env.CARRIER_MCP_TIMEOUT_MS);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_MCP_TIMEOUT_MS;
+}
+var McpTimeoutError = class extends Error {
+  constructor(timeoutMs) {
+    super(`timed out after ${Math.round(timeoutMs / 1e3)}s`);
+    this.timeoutMs = timeoutMs;
+    this.name = "McpTimeoutError";
+  }
+  timeoutMs;
+};
+function isTimeoutish(err) {
+  return err instanceof McpTimeoutError || err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+}
 function parseRpcBody(raw) {
   const trimmed = raw.trim();
   if (!trimmed) return {};
@@ -801,79 +817,113 @@ async function callMcpTool(tool, args, opts = {}) {
     "Content-Type": "application/json",
     Accept: "application/json, text/event-stream"
   };
+  const timeoutMs = mcpTimeoutMs();
+  const controller = new AbortController();
+  let deadlineTimer;
+  const deadline = new Promise((_resolve, reject) => {
+    deadlineTimer = setTimeout(() => {
+      controller.abort();
+      reject(new McpTimeoutError(timeoutMs));
+    }, timeoutMs);
+  });
+  const signal = controller.signal;
   try {
-    const initRes = await fetch(MCP_URL, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 1,
-        method: "initialize",
-        params: {
-          protocolVersion: "2024-11-05",
-          capabilities: {},
-          clientInfo: { name: "carrier-cli", version: CARRIER_VERSION }
+    return await Promise.race([
+      (async () => {
+        const initRes = await fetch(MCP_URL, {
+          method: "POST",
+          headers,
+          signal,
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+              protocolVersion: "2024-11-05",
+              capabilities: {},
+              clientInfo: { name: "carrier-cli", version: CARRIER_VERSION }
+            }
+          })
+        });
+        if (initRes.status === 401 || initRes.status === 403) {
+          return {
+            ok: false,
+            text: withNextStep(`MCP returned ${initRes.status} (auth rejected).`, [
+              "Confirm CARRIER_API_KEY is a valid org key (ak_\u2026) from app.carrier.llc",
+              "Or complete OCS onboarding: https://app.carrier.llc/onboarding",
+              "Interactive: use Claude + OAuth instead of a headless key"
+            ])
+          };
         }
-      })
-    });
-    if (initRes.status === 401 || initRes.status === 403) {
-      return {
-        ok: false,
-        text: withNextStep(`MCP returned ${initRes.status} (auth rejected).`, [
-          "Confirm CARRIER_API_KEY is a valid org key (ak_\u2026) from app.carrier.llc",
-          "Or complete OCS onboarding: https://app.carrier.llc/onboarding",
-          "Interactive: use Claude + OAuth instead of a headless key"
-        ])
-      };
-    }
-    const sessionId = initRes.headers.get("mcp-session-id") ?? initRes.headers.get("Mcp-Session-Id");
-    await initRes.arrayBuffer().catch(() => void 0);
-    if (!sessionId) {
-      return {
-        ok: false,
-        text: withNextStep("MCP initialize did not return a session id.", [
-          "Check network access to https://mcp.carrier.llc/mcp",
-          "Retry later, or use Claude with the registered MCP (OAuth path)"
-        ])
-      };
-    }
-    const sessionHeaders = { ...headers, "Mcp-Session-Id": sessionId };
-    await fetch(MCP_URL, {
-      method: "POST",
-      headers: sessionHeaders,
-      body: JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" })
-    }).catch(() => void 0);
-    const res = await fetch(MCP_URL, {
-      method: "POST",
-      headers: sessionHeaders,
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 2,
-        method: "tools/call",
-        params: { name: tool, arguments: args }
-      })
-    });
-    if (!res.ok) {
-      const snippet = (await res.text().catch(() => "")).slice(0, 240);
-      return {
-        ok: false,
-        text: withNextStep(`MCP call failed (${res.status}). ${snippet}`, [
-          "Check network access to https://mcp.carrier.llc/mcp",
-          "Retry later, or use Claude with the registered MCP (OAuth path)"
-        ])
-      };
-    }
-    const json = parseRpcBody(await res.text());
-    if (json.error?.message) {
+        const sessionId = initRes.headers.get("mcp-session-id") ?? initRes.headers.get("Mcp-Session-Id");
+        await initRes.arrayBuffer().catch(() => void 0);
+        if (!sessionId) {
+          return {
+            ok: false,
+            text: withNextStep("MCP initialize did not return a session id.", [
+              "Check network access to https://mcp.carrier.llc/mcp",
+              "Retry later, or use Claude with the registered MCP (OAuth path)"
+            ])
+          };
+        }
+        const sessionHeaders = { ...headers, "Mcp-Session-Id": sessionId };
+        await fetch(MCP_URL, {
+          method: "POST",
+          headers: sessionHeaders,
+          signal,
+          body: JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" })
+        }).catch(() => void 0);
+        const res = await fetch(MCP_URL, {
+          method: "POST",
+          headers: sessionHeaders,
+          signal,
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 2,
+            method: "tools/call",
+            params: { name: tool, arguments: args }
+          })
+        });
+        if (!res.ok) {
+          const snippet = (await res.text().catch(() => "")).slice(0, 240);
+          return {
+            ok: false,
+            text: withNextStep(`MCP call failed (${res.status}). ${snippet}`, [
+              "Check network access to https://mcp.carrier.llc/mcp",
+              "Retry later, or use Claude with the registered MCP (OAuth path)"
+            ])
+          };
+        }
+        const json = parseRpcBody(await res.text());
+        if (json.error?.message) {
+          return {
+            ok: false,
+            text: withNextStep(json.error.message, opts.errorHints ?? DEFAULT_ERROR_HINTS)
+          };
+        }
+        const parts = json.result?.content ?? [];
+        const text3 = parts.map((p4) => p4.text).filter(Boolean).join("\n").trim() || JSON.stringify(json.result ?? json, null, 2);
+        return { ok: !json.result?.isError, text: text3 };
+      })(),
+      deadline
+    ]);
+  } catch (e) {
+    if (isTimeoutish(e)) {
+      const secs = Math.round(timeoutMs / 1e3);
       return {
         ok: false,
-        text: withNextStep(json.error.message, opts.errorHints ?? DEFAULT_ERROR_HINTS)
+        text: withNextStep(
+          `MCP call to ${tool} timed out after ${secs}s (no response).`,
+          [
+            "The tool is likely returning more data than the MCP transport can deliver \u2014 see issue #663",
+            "Narrow the request (a specific --account-id / --iccid returns far less than a whole-fleet call)",
+            `Raise the deadline for one slow call: CARRIER_MCP_TIMEOUT_MS=${timeoutMs * 2} carrier \u2026`,
+            "Confirm the service is up: check network access to https://mcp.carrier.llc/mcp",
+            "Or open Claude and ask there with full tool routing"
+          ]
+        )
       };
     }
-    const parts = json.result?.content ?? [];
-    const text3 = parts.map((p4) => p4.text).filter(Boolean).join("\n").trim() || JSON.stringify(json.result ?? json, null, 2);
-    return { ok: !json.result?.isError, text: text3 };
-  } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     return {
       ok: false,
@@ -882,6 +932,8 @@ async function callMcpTool(tool, args, opts = {}) {
         "Use the interactive Claude path while offline from this machine"
       ])
     };
+  } finally {
+    if (deadlineTimer !== void 0) clearTimeout(deadlineTimer);
   }
 }
 async function carrierAsk(intent) {
@@ -1188,6 +1240,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 +1495,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 +1698,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 +1776,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 +2065,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 +2579,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");