@carrierllc/mcp 0.10.4 → 0.10.6

package/dist/cli.js

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

package/dist/index.js

@@ -18,6 +18,8 @@ import {
   esimStatusPerAccountParams,
   extractDailyUsage,
   extractEsimStatusCounts,
+  extractResellerBalance,
+  extractSubscriberStatus,
   filterActiveSubscribers,
   fleetScreen,
   formatBytes,
@@ -26,17 +28,24 @@ import {
   getLimitForEndpoint,
   getRateLimitWindowCounts,
   imsiFromSubscriberRecord,
+  isActivePackage,
   isTargetId,
   lastNDaysPeriod,
   loadStorefrontBrand,
   locationParams,
   mergeEnvLocal,
+  networkEventRows,
   networkEventsOverPeriodParams,
   normalizePackageTemplate,
   normalizePackageTemplateChanges,
   ocsLocalDateTime,
   packageActivePeriodParams,
+  packageDataLimit,
+  packageDataUsed,
+  packageExpiry,
+  packageName,
   prepaidPackageLimits,
+  prepaidPackageRows,
   probeAll,
   provisionClerk,
   rankTargets,
@@ -48,10 +57,12 @@ import {
   storefrontClerkUrls,
   subscriberIdParams,
   subscriberRows,
+  subscriberSimId,
+  summarizeNetworkEvents,
   usageOverPeriodParams,
   verifyStorefront,
   withOcsListSummary
-} from "./chunk-KC3FPQ7P.js";
+} from "./chunk-DQHSDVIJ.js";
 import "./chunk-SHKKVIIA.js";
 
 // src/index.ts
@@ -313,7 +324,7 @@ async function invokeModelRaw(creds, payload, opts = {}, signal) {
 }
 var PENDING_ASK_PREFIX = "manus_pending_ask:";
 var PENDING_ASK_TTL_SECONDS = 24 * 3600;
-var OCS_DASHBOARD_DEFAULT = "https://ocs.esimvault.cloud";
+var OCS_DASHBOARD_DEFAULT = "https://portal-esimvault.cloud";
 function buildLoginPreamble(dashboardUrl) {
   return `STEP 1 \u2014 LOGIN:
 Navigate to ${dashboardUrl}/login (or the main page if no /login path).
@@ -1824,7 +1835,7 @@ function registerAllTools(server2, ctx) {
     "list_subscriber_packages",
     {
       title: "List Subscriber Packages",
-      description: "Use this to retrieve all prepaid packages currently assigned to a subscriber. Returns each package's allowance (data/voice/SMS), consumed usage, expiry date, status, and packageId. Always call this before any package modification tool (`modify_package_limits`, `modify_package_expiry`, `modify_package_status`, `delete_subscriber_package`) to confirm the correct packageId and current state. Params: `iccid` (subscriber identifier). Returns: `{ summary, prepaidPackage: [...] }` \u2014 package records with `packageId`, `name`, `status`, `dataLimit`, `dataUsed`, `expirationDate` and a `recurring` flag, behind a server-counted `summary.total` and a `summary.breakdown` over status and recurring. Answer 'how many' from `summary`, not by counting rows. Do NOT use this to browse the product catalog \u2014 use `list_package_templates` for that.",
+      description: "Use this to retrieve all prepaid packages currently assigned to a subscriber. Returns each package's allowance (data/voice/SMS), consumed usage, expiry date, status, and packageId. Always call this before any package modification tool (`modify_package_limits`, `modify_package_expiry`, `modify_package_status`, `delete_subscriber_package`) to confirm the correct packageId and current state. Params: `iccid` (subscriber identifier). Returns: `{ summary, packages: [...] }` \u2014 package records with `packageId`, `name`, `status`, `dataLimit`, `dataUsed`, `expirationDate` and a `recurring` flag, behind a server-counted `summary.total` and a `summary.breakdown` over status and recurring. Answer 'how many' from `summary`, not by counting rows. Do NOT use this to browse the product catalog \u2014 use `list_package_templates` for that.",
       inputSchema: { iccid: z.string().describe("The subscriber ICCID") },
       annotations: { readOnlyHint: true }
     },
@@ -4061,57 +4072,44 @@ function registerIntelligenceTools(server2, ctx) {
     const sub = await safeCall(ctx.env, token2, "getSingleSubscriber", { iccid });
     if (sub.error) return result(`Failed to fetch subscriber: ${sub.error}`, true);
     if (!sub.data) return result("Subscriber not found", true);
-    const status = String(sub.data.status ?? "").toUpperCase();
+    const status = (extractSubscriberStatus(sub.data) ?? "").toUpperCase();
     const balance = Number(sub.data.balance ?? 0);
-    if (status !== "ACTIVE") {
+    if (status === "") {
+      findings.push("OCS status could not be read from the subscriber record");
+      if (severity === "healthy") severity = "info";
+    } else if (status !== "ACTIVE") {
       findings.push(`OCS status is ${status} (not ACTIVE)`);
       actions.push(`Reactivate subscriber via modify_subscriber_status`);
       severity = "critical";
     }
-    if (balance <= 0) {
-      findings.push(`Balance is ${balance} \u2014 subscriber may be blocked from usage`);
-      actions.push(`Top up balance via modify_subscriber_balance`);
-      if (severity !== "critical") severity = "warning";
-    }
-    const simId = sub.data.simId ?? sub.data.sim_id ?? sub.data.id;
-    const sim = simId !== void 0 ? await safeCall(ctx.env, token2, "getSimProviderStatus", Number(simId)) : { data: null, error: null };
-    if (sim.data) {
-      const simStatus = String(sim.data.simStatus ?? sim.data.status ?? "").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`);
-        severity = "critical";
-      }
-    }
     const pkgs = await safeCall(ctx.env, token2, "listSubscriberPrepaidPackages", { iccid });
-    if (pkgs.data && Array.isArray(pkgs.data)) {
-      const activePkgs = pkgs.data.filter(
-        (p) => String(p.status ?? "").toUpperCase() === "ACTIVE"
-      );
+    const activePkgs = prepaidPackageRows(pkgs.data).filter(isActivePackage);
+    if (!pkgs.error) {
       if (activePkgs.length === 0) {
         findings.push("No active packages \u2014 subscriber has no data/voice/SMS allowance");
         actions.push("Assign a package via assign_package");
         severity = "critical";
       } else {
         for (const pkg of activePkgs) {
-          const dataUsed = Number(pkg.dataUsed ?? pkg.dataConsumed ?? 0);
-          const dataLimit = Number(pkg.dataLimit ?? pkg.dataAllowance ?? 0);
+          const label = packageName(pkg);
+          const dataUsed = packageDataUsed(pkg);
+          const dataLimit = packageDataLimit(pkg);
           if (dataLimit > 0 && dataUsed >= dataLimit) {
             findings.push(
-              `Package "${pkg.name ?? pkg.packageTemplateId}" data depleted: ${formatBytes(dataUsed)} / ${formatBytes(dataLimit)}`
+              `Package "${label}" data depleted: ${formatBytes(dataUsed)} / ${formatBytes(dataLimit)}`
             );
             actions.push("Assign additional package or increase limits via modify_package_limits");
             if (severity !== "critical") severity = "warning";
           }
-          const expiry = String(pkg.expirationDate ?? pkg.endDate ?? "");
+          const expiry = packageExpiry(pkg);
           if (expiry) {
             const days = daysUntil(expiry);
             if (days < 0) {
-              findings.push(`Package "${pkg.name ?? pkg.packageTemplateId}" expired ${Math.abs(days)} days ago`);
+              findings.push(`Package "${label}" expired ${Math.abs(days)} days ago`);
               actions.push("Remove expired package and assign a new one");
               if (severity !== "critical") severity = "warning";
             } else if (days <= 3) {
-              findings.push(`Package "${pkg.name ?? pkg.packageTemplateId}" expires in ${days} day(s)`);
+              findings.push(`Package "${label}" expires in ${days} day(s)`);
               actions.push("Consider renewing or assigning a recurring package");
               if (severity === "healthy") severity = "info";
             }
@@ -4119,23 +4117,61 @@ function registerIntelligenceTools(server2, ctx) {
         }
       }
     }
+    if (balance <= 0 && activePkgs.length === 0) {
+      findings.push(`Balance is ${balance} \u2014 subscriber may be blocked from usage`);
+      actions.push(`Top up balance via modify_subscriber_balance`);
+      if (severity !== "critical") severity = "warning";
+    }
+    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();
+      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`);
+        severity = "critical";
+      }
+    }
     const now = /* @__PURE__ */ new Date();
     const eventWindow = lastNDaysPeriod(3, now);
     const events = await safeCall(ctx.env, token2, "subscriberNetworkEventsOverPeriod", {
       subscriber: { iccid },
       period: eventWindow
     });
-    if (events.data && Array.isArray(events.data)) {
-      if (events.data.length === 0) {
-        findings.push("No network events in last 48 hours \u2014 device may be powered off or out of coverage");
+    if (!events.error) {
+      const net = summarizeNetworkEvents(networkEventRows(events.data));
+      if (net.total === 0) {
+        findings.push("No network events in last 72 hours \u2014 device may be powered off or out of coverage");
         if (severity === "healthy") severity = "warning";
       } else {
-        const lastEvent = events.data[events.data.length - 1];
-        const lastType = String(lastEvent.eventType ?? lastEvent.type ?? "unknown");
-        findings.push(`Last network event: ${lastType} at ${lastEvent.timestamp ?? lastEvent.date ?? "unknown"}`);
+        if (net.creditLimitReached > 0) {
+          findings.push(
+            `${net.creditLimitReached} data session(s) refused with CreditLimitReached \u2014 bundle is out of credit at the charging layer`
+          );
+          actions.push("Assign a package or raise limits via modify_package_limits");
+          severity = "critical";
+        }
+        if (net.roamingNotAllowed > 0) {
+          findings.push(
+            `${net.roamingNotAllowed} attach(es) rejected 5004 (roaming not allowed) \u2014 operator not permitted for this subscriber`
+          );
+          actions.push("Review the steering list via list_steering_lists and modify_subscriber_steering_list");
+          if (severity !== "critical") severity = "warning";
+        }
+        if (net.mapTimeouts > 0) {
+          findings.push(`${net.mapTimeouts} MAP signalling leg(s) timed out \u2014 2G/3G attach is unreliable here`);
+          if (severity === "healthy") severity = "info";
+        }
+        if (net.operators.length >= 3) {
+          findings.push(
+            `Attached across ${net.operators.length} operators (${net.operators.join(", ")}) \u2014 possible steering ping-pong, sessions may be torn down repeatedly`
+          );
+          if (severity === "healthy") severity = "info";
+        }
+        findings.push(`${net.total} network event(s), last at ${net.lastEventTime || "unknown"}`);
       }
     }
-    const imsiForBitrate = typeof sub.data.imsi === "string" ? sub.data.imsi : null;
+    const imsiForBitrate = imsiFromSubscriberRecord(sub.data) ?? null;
     const bitrate = imsiForBitrate ? await safeCall(ctx.env, token2, "hlrGetBitrate", { imsi: imsiForBitrate }) : { data: null, error: null };
     if (bitrate.data) {
       const rate = Number(bitrate.data.bitrate ?? bitrate.data.maxBitrate ?? 0);
@@ -4164,7 +4200,7 @@ function registerIntelligenceTools(server2, ctx) {
       `## Raw Status`,
       `- OCS Status: ${status}`,
       `- Balance: ${balance}`,
-      `- Active Packages: ${pkgs.data && Array.isArray(pkgs.data) ? pkgs.data.filter((p) => String(p.status ?? "").toUpperCase() === "ACTIVE").length : "unknown"}`
+      `- Active Packages: ${pkgs.error ? "unknown" : activePkgs.length}`
     ].join("\n");
     return result(report);
   });
@@ -4249,9 +4285,7 @@ High suspension rate (${totalSuspended} suspended vs ${totalActive} active)`);
       const criticalZero = accounts.filter(
         (a) => a.packageOnly === false && Number(a.balance ?? 0) <= 0
       );
-      const resellerRaw = resellerInfoResult?.data ?? null;
-      const rawBalance = resellerRaw?.getResellerInfo?.balance;
-      const resellerBalance = rawBalance === void 0 || rawBalance === null ? null : Number(rawBalance);
+      const resellerBalance = extractResellerBalance(resellerInfoResult?.data);
       const resellerOutOfCredit = resellerBalance !== null && resellerBalance <= 0;
       sections.push(`
 ## Account Summary`);
@@ -5860,6 +5894,20 @@ function registerAllUiAgentTools(server2, ctx, runtime, optIn = readPortalOptIn(
         };
       }
       const resellerId = args.reseller_id ?? ctx.props.reseller_id;
+      if (typeof resellerId !== "number" || !Number.isFinite(resellerId)) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                error: "reseller_id_unresolved",
+                message: "Could not resolve a reseller id from the session. Pass reseller_id explicitly."
+              })
+            }
+          ]
+        };
+      }
       const requested = [
         args.relay_gy === void 0 ? null : `Relay Gy: ${args.relay_gy ? "enable" : "disable"}`,
         args.relay_calls_sms === void 0 ? null : `Calls/SMS relay: ${args.relay_calls_sms ? "enable" : "disable"}`,
@@ -10390,10 +10438,14 @@ async function listRecentOcsEvents(iccid, limit, eventTypes, since, kv) {
 var ALLOWED_EVENT_TYPES = [
   "esim.activated",
   "esim.disabled",
-  "package.expiry_warning",
+  "esim.enabled",
+  "package.low_balance",
+  "package.low_quota",
+  "package.expiring",
+  "package.expired",
   "location.changed",
   "country.entered",
-  "balance.low"
+  "usage.anomaly"
 ];
 var listRecentOcsEventsSchema = {
   iccid: z12.string().regex(/^\d{19,20}$/).describe("ICCID, 19 or 20 digits, ITU-T E.118 format"),