@carrierllc/mcp 0.13.9 → 0.13.11

package/dist/cli.js

@@ -39,7 +39,7 @@ import {
   verifyStorefront,
   walletScreen,
   which
-} from "./chunk-DF2PGR5H.js";
+} from "./chunk-ZLPXWOYO.js";
 import {
   copyTree,
   exists,

package/dist/index.js

@@ -19,6 +19,7 @@ import {
   extractDailyUsage,
   extractEsimStatusCounts,
   extractResellerBalance,
+  extractSimProviderStatus,
   extractSubscriberStatus,
   filterActiveSubscribers,
   fleetScreen,
@@ -37,6 +38,7 @@ import {
   locationZoneCreateParams,
   mccToIso,
   mergeEnvLocal,
+  modifySubscriberStatusParams,
   networkEventRows,
   networkEventsOverPeriodParams,
   ocsHlrBitrate,
@@ -69,7 +71,7 @@ import {
   usageOverPeriodParams,
   verifyStorefront,
   withOcsListSummary
-} from "./chunk-DF2PGR5H.js";
+} from "./chunk-ZLPXWOYO.js";
 import "./chunk-SHKKVIIA.js";
 
 // src/index.ts
@@ -1200,7 +1202,7 @@ var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   // S6 live-smoke gap fill (CAR-105)
   "change_network_profile_of_location_zone"
 ]);
-function wrapHandler(toolName, ocsMethod, requiredScope, ctx, handler) {
+function wrapHandler(toolName, ocsMethod, requiredScope, ctx, handler, options) {
   return async (args) => {
     const start = Date.now();
     const isDryRun = args.dry_run === true;
@@ -1253,11 +1255,12 @@ function wrapHandler(toolName, ocsMethod, requiredScope, ctx, handler) {
         dry_run: true,
         duration_ms: 0
       });
+      const preview = options?.dryRunPayload ? options.dryRunPayload(args) : args;
       return {
         content: [
           {
             type: "text",
-            text: `[dry_run=true] Would execute '${toolName}' (OCS method '${ocsMethod}') with args: ${JSON.stringify(args)}. No changes made.`
+            text: `[dry_run=true] Would execute '${toolName}' (OCS method '${ocsMethod}') with args: ${JSON.stringify(preview)}. No changes made.`
           }
         ]
       };
@@ -1458,7 +1461,7 @@ function registerAllTools(server2, ctx) {
     "list_steering_lists",
     {
       title: "List Steering Lists",
-      description: "Use this to retrieve all network steering lists configured for this reseller. A steering list is a named configuration of excluded and priority mobile operators that controls which networks an eSIM prefers to roam onto \u2014 the primary mechanism for network quality optimisation and cost control. Call this before `modify_subscriber_steering_list` to obtain valid steering list IDs. Params: `resellerId` (integer, optional \u2014 omit to use the token owner's reseller). Returns: array of steering list records with `steeringListId`, `name`, and configured operators. Do NOT use this to assign a steering list to a subscriber \u2014 use `modify_subscriber_steering_list`. Do NOT use this to push a steering change to a device \u2014 use `push_steering_to_subscriber` after assignment.",
+      description: "Use this to retrieve all network steering lists configured for this reseller. A steering list is a named configuration of excluded and priority mobile operators that controls which networks an eSIM prefers to roam onto \u2014 the primary mechanism for network quality optimisation and cost control. Call this before `modify_subscriber_steering_list` to obtain valid steering list IDs. Params: `resellerId` (integer, optional \u2014 omit to use the token owner's reseller). Returns: an array of steering list records with `steeringListId`, `name`, and configured operators. An empty catalog is `[]`. When OCS answers a successful list with null, that null is this empty array, not an error. Do NOT use this to assign a steering list to a subscriber \u2014 use `modify_subscriber_steering_list`. Do NOT use this to push a steering change to a device \u2014 use `push_steering_to_subscriber` after assignment.",
       inputSchema: {
         resellerId: z.number().optional().describe("Reseller ID (omit to use token owner's reseller)")
       },
@@ -1576,7 +1579,7 @@ function registerAllTools(server2, ctx) {
     "modify_subscriber_status",
     {
       title: "Modify Subscriber Status",
-      description: "Use this to change the OCS lifecycle status of a subscriber. Common transitions: ACTIVE \u2192 SUSPENDED (pause without losing packages), SUSPENDED \u2192 ACTIVE (reactivate), ACTIVE/SUSPENDED \u2192 TERMINATED (irreversible). WARNING: TERMINATED status is permanent \u2014 the subscriber record cannot be reactivated. \u26A0 Setting status to END_OF_LIFE is irreversible. The subscriber becomes read-only (OCS error 17 on subsequent mutations). Confirm before calling. Params: `iccid` (subscriber identifier), `status` (new status string, e.g. 'ACTIVE', 'SUSPENDED', 'TERMINATED', 'END_OF_LIFE'). Returns: updated subscriber record with the new status. Do NOT use this to disable the SIM card at the network level \u2014 use `change_sim_status` for that. Always call `get_subscriber` first to confirm current status before modifying.",
+      description: "Use this to change the OCS lifecycle status of a subscriber. Common transitions: ACTIVE \u2192 SUSPENDED (pause without losing packages), SUSPENDED \u2192 ACTIVE (reactivate), ACTIVE/SUSPENDED \u2192 TERMINATED (irreversible). WARNING: TERMINATED status is permanent \u2014 the subscriber record cannot be reactivated. \u26A0 Setting status to END_OF_LIFE is irreversible. The subscriber becomes read-only (OCS error 17 on subsequent mutations). Confirm before calling. Params: `iccid` (subscriber identifier), `status` (new status string, e.g. 'ACTIVE', 'SUSPENDED', 'TERMINATED', 'END_OF_LIFE'). OCS receives `{ subscriber: { iccid }, newStatus }`. `subscriber` is a SubscriberId object, never a bare ICCID string. Returns: updated subscriber record with the new status. Do NOT use this to disable the SIM card at the network level \u2014 use `change_sim_status` for that. Always call `get_subscriber` first to confirm current status before modifying.",
       inputSchema: {
         iccid: z.string().describe("The subscriber ICCID"),
         status: z.string().describe("New status value"),
@@ -1589,10 +1592,15 @@ function registerAllTools(server2, ctx) {
       "modifySubscriberStatus",
       TOOL_SCOPES["modify_subscriber_status"],
       ctx,
-      async ({ iccid, status }, token2) => ocsCall(ctx.env, token2, "modifySubscriberStatus", {
-        subscriber: iccid,
-        newStatus: status
-      })
+      async ({ iccid, status }, token2) => ocsCall(
+        ctx.env,
+        token2,
+        "modifySubscriberStatus",
+        modifySubscriberStatusParams(iccid, status)
+      ),
+      {
+        dryRunPayload: ({ iccid, status }) => modifySubscriberStatusParams(iccid, status)
+      }
     )
   );
   server2.registerTool(
@@ -1640,7 +1648,7 @@ function registerAllTools(server2, ctx) {
     "get_sim_provider_status",
     {
       title: "Get SIM Provider Status",
-      description: "Use this to check the physical SIM/eSIM card status at the SIM provider level (ENABLED, DISABLED, DELETED) \u2014 distinct from the OCS subscriber status. Useful when `get_subscriber` shows ACTIVE but connectivity is broken; the SIM may be DISABLED at the provider level. Internally resolves ICCID \u2192 numeric simId. Params: `iccid` (subscriber identifier). Returns: provider status object with `simStatus`, `activationDate`, `lastStatusChange`. Do NOT use this to change the SIM status \u2014 use `change_sim_status` for that.",
+      description: "Use this to check the physical SIM/eSIM card status at the SIM provider level (ENABLED, DISABLED, DELETED) \u2014 distinct from the OCS subscriber status. Useful when `get_subscriber` shows ACTIVE but connectivity is broken; the SIM may be DISABLED at the provider level. Internally resolves ICCID \u2192 numeric simId. Params: `iccid` (subscriber identifier). Returns: an array of provider status periods. Each entry has `status`, `start`, `end`, `profileType`, and `statusModification`. Do NOT use this to change the SIM status \u2014 use `change_sim_status` for that.",
       inputSchema: {
         iccid: z.string().describe("The subscriber ICCID")
       },
@@ -2042,7 +2050,7 @@ function registerAllTools(server2, ctx) {
     "modify_package_status",
     {
       title: "Modify Package Status",
-      description: "Use this to activate or deactivate a specific prepaid package on a subscriber without removing it. A deactivated package retains its allowances and can be reactivated later. Params: `iccid` (subscriber identifier), `packageId` (integer from `list_subscriber_packages`), `status` (new package status string, e.g. 'ACTIVE', 'INACTIVE'). Returns: updated package record with the new status. Do NOT use this to delete a package \u2014 use `delete_subscriber_package` for permanent removal. Do NOT use this to change the subscriber's overall account status \u2014 use `modify_subscriber_status`.",
+      description: "Use this to activate or deactivate a specific prepaid package on a subscriber without removing it. A deactivated package retains its allowances and can be reactivated later. Params: `iccid` (subscriber identifier), `packageId` (integer from `list_subscriber_packages`), `status` (new package status string, e.g. 'ACTIVE', 'INACTIVE'). Returns: confirmation `{ updated: true, subsPrepaidPackageId, active, status }` where `status` is `ACTIVE` or `INACTIVE`. OCS accepts the write and returns no package body, so a null response is this confirmation rather than a missing record. Do NOT use this to delete a package \u2014 use `delete_subscriber_package` for permanent removal. Do NOT use this to change the subscriber's overall account status \u2014 use `modify_subscriber_status`.",
       inputSchema: {
         iccid: z.string().describe("The subscriber ICCID"),
         packageId: z.number().describe("The active package ID"),
@@ -3756,7 +3764,7 @@ function registerIntelligenceTools(server2, ctx) {
     const simId = subscriberSimId(sub.data);
     const sim = simId !== void 0 ? await safeCall(ctx.env, token2, "getSimProviderStatus", simId) : { data: null, error: null };
     if (sim.data) {
-      const simStatus = String(sim.data.simStatus ?? sim.data.status ?? "").toUpperCase();
+      const simStatus = (extractSimProviderStatus(sim.data) ?? "").toUpperCase();
       if (simStatus && !["ENABLED", "ACTIVE", "ACTIVATED"].includes(simStatus)) {
         findings.push(`SIM provider status is ${simStatus} \u2014 SIM may be disabled at network level`);
         actions.push(`Enable SIM via change_sim_status`);