@carrierllc/mcp 0.13.30 → 0.13.31

package/README.md

@@ -29,6 +29,41 @@ carrier exec -- bash        # real child terminal with CARRIER_API_KEY in its en
 **Entry A:** register `https://mcp.carrier.llc/mcp` with no token. The first tool
 call in Claude/Cursor opens Clerk OAuth (Google / GitHub / email).
 
+### Natural-language answers
+
+`carrier ask "how many subscribers are there?"` and the interactive home's
+**Ask the fleet** action present executed tool results as readable answers.
+Known OCS list summaries use the server's authoritative `summary.total`, not a
+recount of the displayed rows. That number describes the result/page, not
+necessarily the entire fleet; paging, missing rows and shortened display are
+reported explicitly. Nested subscriber status and SIM inventory status remain
+separate. A server facet that could not read nested status is not a claim that
+subscriber status is missing.
+
+This is deterministic presentation, not another AI/model call. The original
+question distinguishes counts from requested lists/status/details. Unsupported
+predictions and judgements receive an explicit limitation rather than unrelated
+records. Current subscriber status uses the shared OCS open-period normalizer,
+with its maintained closed-history fallback; SIM inventory remains separate.
+
+Default JSON presentation uses typed scalar allowlists and explicit shallow
+account/result wrappers. Unknown fields, nested shapes, and wrong field types
+are omitted with a safe limitation; they are never recursively dumped. Safe
+ordinary scalar facts remain readable. Empty or unsupported summary facets are
+omitted. Plain-text tool answers are passed through, shortened only at whole
+sentence/row boundaries; this is not a general redaction guarantee for arbitrary
+prose. Oversized indivisible rows are omitted entirely with the raw-output hint.
+
+```bash
+carrier ask "how many subscribers are there?" --json
+```
+
+`--json` is explicit raw access: complete JSON stdout, no banner/spinner; plain
+text is encoded as a JSON string. Raw output may contain sensitive data. Failures
+remain nonzero with errors on stderr. The MCP machine contract and domain
+commands are unchanged. Ambiguous intents and confirmation-required mutations
+still do not execute a resolved tool.
+
 ### OAuth and terminal handoff
 
 Carrier commands, status and Ask the Fleet share credential resolution. Explicit

package/dist/{chunk-ZJY7H2QW.js → chunk-EHJEAI4V.js}

@@ -1855,7 +1855,7 @@ function storefrontScreen(input) {
 // package.json
 var package_default = {
   name: "@carrierllc/mcp",
-  version: "0.13.30",
+  version: "0.13.31",
   description: "Carrier MCP \u2014 natural-language control of MVNO/eSIM fleets via eSIMVault OCS. Stdio mode for direct integration with Claude Desktop, Cursor, Windsurf, and MCP-compatible clients. Ships the `carrier` CLI (plugin install + white-label eSIM storefront scaffold).",
   license: "MIT",
   author: "Carrier (Lifecycle Innovations Limited)",
@@ -4352,6 +4352,32 @@ function ocsArray(data, keys) {
   }
   return [];
 }
+function subscriberIccid(row) {
+  if (row === null || typeof row !== "object") return "";
+  const r = row;
+  const imsiList = r.imsiList;
+  if (Array.isArray(imsiList)) {
+    for (const entry of imsiList) {
+      if (entry && typeof entry === "object") {
+        const v = entry.iccid;
+        if (typeof v === "string" && v.length > 0) return v;
+        if (typeof v === "number") return String(v);
+      }
+    }
+  }
+  for (const key of ["iccid", "ICCID"]) {
+    const v = r[key];
+    if (typeof v === "string" && v.length > 0) return v;
+    if (typeof v === "number") return String(v);
+  }
+  const sim = r.sim;
+  if (sim && typeof sim === "object") {
+    const v = sim.iccid;
+    if (typeof v === "string" && v.length > 0) return v;
+    if (typeof v === "number") return String(v);
+  }
+  return "";
+}
 var FACET_TALLY_MAX = 25;
 var OCS_LIST_FACETS = {
   templates: [
@@ -5426,6 +5452,8 @@ export {
   recordToolDescription,
   buildRouterCatalog,
   ROUTER_RULES,
+  OCS_LIST_KEYS,
+  subscriberIccid,
   withOcsListSummary,
   extractDailyUsage,
   daysUntil,
@@ -5491,4 +5519,4 @@ export {
   package_default,
   CARRIER_VERSION
 };
-//# sourceMappingURL=chunk-ZJY7H2QW.js.map
+//# sourceMappingURL=chunk-EHJEAI4V.js.map