@gravity-rail/cli 0.11.0 → 0.13.0

package/README.md

@@ -196,6 +196,7 @@ cat member.json | gr members update -w $WORKSPACE --id 42 --allow-write
 | `1`  | General error                                                                                      |
 | `2`  | Authentication required (run `gr login` or set `GRAVITY_RAIL_API_KEY`)                             |
 | `3`  | A human-in-the-loop (HITL) interrupt requires out-of-band action before the operation can continue |
+| `4`  | No assistant reply — a `--message` turn made tool calls but returned no final summary, or an inference error occurred with no final message (side effects may have been applied) |
 
 When a concierge command run with `--message` (non-interactive mode) hits a HITL
 interrupt the CLI cannot resolve on its own, it exits `3` and writes a single

package/dist/gr.js

@@ -3247,7 +3247,7 @@ var init_libphonenumber_js = __esm({
   }
 });
 
-// ../sdk/dist/chunk-YESHLUL7.js
+// ../sdk/dist/chunk-MUEM2BLY.js
 function sanitizePhoneForBackend(phoneNumber) {
   try {
     let parsed = parsePhoneNumber4(phoneNumber);
@@ -3313,6 +3313,9 @@ function throwMemberImportError(errorBody, fallback) {
   }
   throw new Error(typeof detail === "string" ? detail : fallback);
 }
+function businessProfilePath(orgUuid, legalEntityUuid) {
+  return legalEntityUuid ? `o/${orgUuid}/legal-entities/${legalEntityUuid}/business-profile` : `o/${orgUuid}/business-profile`;
+}
 function getOAuthPath(providerSlug, action) {
   if (providerSlug === "google_calendar") {
     return `oauth/google/calendar/${action}`;
@@ -4398,6 +4401,7 @@ function bindCustomersMethods(target, customers) {
   target.getMyCustomerAccounts = customers.getMyCustomerAccounts.bind(customers);
   target.getMyCustomerSubscriptions = customers.getMyCustomerSubscriptions.bind(customers);
   target.getMyCustomerInvoices = customers.getMyCustomerInvoices.bind(customers);
+  target.createMyCustomerPortalSession = customers.createMyCustomerPortalSession.bind(customers);
   target.updateMyCustomer = customers.updateMyCustomer.bind(customers);
   target.createMyCustomerSetupIntent = customers.createMyCustomerSetupIntent.bind(customers);
   target.getMyCustomerPaymentMethods = customers.getMyCustomerPaymentMethods.bind(customers);
@@ -4435,8 +4439,8 @@ function bindSupportRequestMethods(target, supportRequests) {
   target.clickWorkspaceSupportRequestResource = supportRequests.clickWorkspaceSupportRequestResource.bind(supportRequests);
 }
 var AbilitiesApi, AccessGrantsApi, AgentTasksApi, AgentsApi, AIModelsApi, ApiKeysApi, AppsApi, AssignmentsApi, VoiceApi, AuthApi, BuildersApi, CalendarsApi, CallsApi, CELApi, ChatsApi, ConfluenceApi, CustomToolkitsApi, DataTypesApi, DiscordBotsApi, SlackAppsApi, EventsApi, FeaturesApi, FhirConnectionsApi, HealthieApi, FilesApi, InboxesApi, InquiriesApi, AppConnectionsApi, McpServersApi, MemberImportValidationError, MembersApi, MilestonesApi, MondayIntegrationApi, NotificationRulesApi, OperatorApi, OrgApi, OAuthConnectionsApi, OAuthApi, PhoneNumbersApi, PronunciationsApi, PromptsApi, PersonasApi, QueriesApi, QualificationsApi, ReportsApi, SalesforceApi, ConnectionSyncApi, HubspotApi, SitesApi, SubscriptionsApi, SupportRequestsApi, CustomersApi, ResellersApi, SupervisorsApi, TasksApi, TemplatesApi, ToolkitsApi, JourneysApi, WorkflowsApi, WorkflowNotesApi, EventRuleEventType, DriverMode, WorkspaceInvitationsApi, WorkspacesApi, DashboardsApi, TeamsAppsApi, ExperimentsApi, PatientSyncConnectionsApi, MotdApi, WORKSPACE_METHOD_NAMES, WORKSPACE_METHOD_NAME_SET, GravityRailClient, WIDGET_SLUGS, CHAT_TYPES, BUILTIN_ASSISTANT_CHAT_TYPES, MEMBER_AGENT_CHAT_TYPES;
-var init_chunk_YESHLUL7 = __esm({
-  "../sdk/dist/chunk-YESHLUL7.js"() {
+var init_chunk_MUEM2BLY = __esm({
+  "../sdk/dist/chunk-MUEM2BLY.js"() {
     init_chunk_FSSXKQR5();
     init_libphonenumber_js();
     AbilitiesApi = class extends BaseApiClient {
@@ -9025,26 +9029,41 @@ var init_chunk_YESHLUL7 = __esm({
         return this.fetch(`o/${orgUuid}/phone-numbers/a2p/status`);
       }
       /**
-       * Start org-level A2P brand registration.
+       * Start A2P brand registration under a legal entity. `legalEntityUuid`
+       * is required — brands register per legal entity (Customer Profile);
+       * there is no primary-entity fallback.
        */
-      async startA2PRegistration(orgUuid, brandName, brandDescription) {
-        return this.fetch(
-          `o/${orgUuid}/phone-numbers/a2p/start`,
-          {
-            method: "POST",
-            body: JSON.stringify({ brandName, brandDescription })
-          }
-        );
+      async startA2PRegistration(orgUuid, legalEntityUuid, brandName, brandDescription) {
+        return this.fetch(`o/${orgUuid}/phone-numbers/a2p/start`, {
+          method: "POST",
+          body: JSON.stringify({ legalEntityUuid, brandName, brandDescription })
+        });
       }
       /**
-       * Approve sample messages for the org's A2P campaign.
+       * Approve sample messages for one brand's A2P campaign. Signals the
+       * brand's registration workflow to create the TCR campaign.
        */
-      async approveA2PMessages(orgUuid, sampleMessages) {
+      async approveA2PMessages(orgUuid, brandUuid, sampleMessages) {
         return this.fetch(`o/${orgUuid}/phone-numbers/a2p/approve-messages`, {
           method: "POST",
-          body: JSON.stringify({ sampleMessages })
+          body: JSON.stringify({ brandUuid, sampleMessages })
         });
       }
+      /**
+       * Activate SMS on a workspace-assigned number: attach it to the given
+       * brand's Messaging Service (A2P 10DLC). Preconditions (412 otherwise):
+       * campaign VERIFIED, brand has a Messaging Service, phone assigned to a
+       * workspace with a Twilio SID.
+       */
+      async activateA2PNumber(orgUuid, providerPhoneUuid, brandUuid) {
+        return this.fetch(
+          `o/${orgUuid}/phone-numbers/a2p/activate-number`,
+          {
+            method: "POST",
+            body: JSON.stringify({ providerPhoneUuid, brandUuid })
+          }
+        );
+      }
       // ============================================================================
       // Organization Business Profile API (Twilio Trust Hub Secondary CP)
       // ============================================================================
@@ -9058,8 +9077,8 @@ var init_chunk_YESHLUL7 = __esm({
        * which is impossible (lifecycle status is one of `draft` /
        * `pending-review` / `in-review` / `twilio-approved` / `twilio-rejected`).
        */
-      async getBusinessProfile(orgUuid) {
-        return this.fetch(`o/${orgUuid}/business-profile`);
+      async getBusinessProfile(orgUuid, legalEntityUuid) {
+        return this.fetch(businessProfilePath(orgUuid, legalEntityUuid));
       }
       /**
        * Upsert the org's business profile. Idempotent via cached SIDs.
@@ -9067,8 +9086,8 @@ var init_chunk_YESHLUL7 = __esm({
        * compliance evaluation result so the frontend can immediately enable
        * Submit without a second round-trip.
        */
-      async updateBusinessProfile(orgUuid, data) {
-        return this.fetch(`o/${orgUuid}/business-profile`, {
+      async updateBusinessProfile(orgUuid, data, legalEntityUuid) {
+        return this.fetch(businessProfilePath(orgUuid, legalEntityUuid), {
           method: "PUT",
           body: JSON.stringify(data)
         });
@@ -9078,20 +9097,70 @@ var init_chunk_YESHLUL7 = __esm({
        * compliance live and returns 412 if the profile is not currently
        * `compliant`; returns 409 if a review is already in flight.
        */
-      async submitBusinessProfile(orgUuid) {
-        return this.fetch(`o/${orgUuid}/business-profile/submit`, {
-          method: "POST"
-        });
+      async submitBusinessProfile(orgUuid, legalEntityUuid) {
+        return this.fetch(
+          `${businessProfilePath(orgUuid, legalEntityUuid)}/submit`,
+          { method: "POST" }
+        );
       }
       /**
        * Cancel an in-flight Twilio review. Resets the cached profile state
        * to `draft` so the user can edit and resubmit.
        */
-      async cancelBusinessProfile(orgUuid) {
-        return this.fetch(`o/${orgUuid}/business-profile/cancel`, {
-          method: "POST"
+      async cancelBusinessProfile(orgUuid, legalEntityUuid) {
+        return this.fetch(
+          `${businessProfilePath(orgUuid, legalEntityUuid)}/cancel`,
+          { method: "POST" }
+        );
+      }
+      // ============================================================================
+      // Legal entities (Twilio Secondary Customer Profiles)
+      // ============================================================================
+      /** List the org's legal entities (one Customer Profile each). */
+      async listLegalEntities(orgUuid) {
+        return this.fetch(`o/${orgUuid}/legal-entities`);
+      }
+      /** Create a legal entity. Its business profile is edited via the entity-scoped business-profile methods. */
+      async createLegalEntity(orgUuid, data) {
+        return this.fetch(`o/${orgUuid}/legal-entities`, {
+          method: "POST",
+          body: JSON.stringify(data)
         });
       }
+      async getLegalEntity(orgUuid, legalEntityUuid) {
+        return this.fetch(`o/${orgUuid}/legal-entities/${legalEntityUuid}`);
+      }
+      /** Cached voice trust product state (CNAM / SHAKEN-STIR / Voice Integrity) for one legal entity. */
+      async getVoiceTrustProducts(orgUuid, legalEntityUuid) {
+        return this.fetch(
+          `o/${orgUuid}/legal-entities/${legalEntityUuid}/trust-products`
+        );
+      }
+      /** Reconcile trust product state against Twilio (discovery + status refresh). */
+      async syncVoiceTrustProducts(orgUuid, legalEntityUuid) {
+        return this.fetch(
+          `o/${orgUuid}/legal-entities/${legalEntityUuid}/trust-products/sync`,
+          // Empty JSON body is the CSRF barrier the route requires (GRA-6284).
+          { method: "POST", body: JSON.stringify({}) }
+        );
+      }
+      /**
+       * Set up + submit one voice trust product for a legal entity. Requires
+       * the entity's business profile to be twilio-approved (412 otherwise).
+       */
+      async setupVoiceTrustProduct(orgUuid, legalEntityUuid, product, data) {
+        return this.fetch(
+          `o/${orgUuid}/legal-entities/${legalEntityUuid}/trust-products/${product}`,
+          { method: "POST", body: JSON.stringify(data) }
+        );
+      }
+      /**
+       * Brand detail with live registration-workflow state (`workflowStatus`,
+       * `pendingSampleMessages`) for the sample-approval step.
+       */
+      async getA2PBrand(orgUuid, brandUuid) {
+        return this.fetch(`o/${orgUuid}/a2p-brands/${brandUuid}`);
+      }
       /**
        * List the org's A2P brands (broker resources). The SMS-consent editor uses
        * this to pick which brand's consent config to edit.
@@ -10405,11 +10474,11 @@ var init_chunk_YESHLUL7 = __esm({
        * customer, and subscription are created on payment by the checkout
        * completion handler.
        */
-      async createCheckoutSession(productId, planPeriod = "month") {
+      async createCheckoutSession(productId, planPeriod = "month", options = {}) {
         return this.fetch(`subscriptions/checkout-session`, {
           method: "POST",
           credentials: "include",
-          body: JSON.stringify({ productId, planPeriod }),
+          body: JSON.stringify({ productId, planPeriod, ...options }),
           headers: { "Content-Type": "application/json" }
         });
       }
@@ -10466,12 +10535,15 @@ var init_chunk_YESHLUL7 = __esm({
         return this.fetch(`subscriptions/${subscriptionId}/items`);
       }
       /** Purchase extra credits on a subscription (org-level). */
-      async purchaseCredits(subscriptionId, amountCents) {
+      async purchaseCredits(subscriptionId, amountCents, idempotencyKey = crypto.randomUUID()) {
         return this.fetch(`subscriptions/${subscriptionId}/purchase-credits`, {
           method: "POST",
           credentials: "include",
           body: JSON.stringify({ amount_cents: amountCents }),
-          headers: { "Content-Type": "application/json" }
+          headers: {
+            "Content-Type": "application/json",
+            "Idempotency-Key": idempotencyKey
+          }
         });
       }
     };
@@ -10588,6 +10660,13 @@ var init_chunk_YESHLUL7 = __esm({
       async getMyCustomerInvoices(uuid) {
         return this.fetch(`customers/${uuid}/invoices`);
       }
+      async createMyCustomerPortalSession(uuid, returnUrl) {
+        return this.fetch(`customers/${uuid}/stripe/portal-session`, {
+          method: "POST",
+          body: JSON.stringify({ returnUrl }),
+          headers: { "Content-Type": "application/json" }
+        });
+      }
       async updateMyCustomer(uuid, data) {
         return this.fetch(`customers/${uuid}`, {
           method: "PUT",
@@ -10605,7 +10684,8 @@ var init_chunk_YESHLUL7 = __esm({
       async attachMyCustomerPaymentMethod(uuid, paymentMethodId, setAsDefault = false) {
         return this.fetch(`customers/${uuid}/stripe/payment-methods/${paymentMethodId}/attach`, {
           method: "POST",
-          body: JSON.stringify({ setAsDefault })
+          body: JSON.stringify({ setAsDefault }),
+          headers: { "Content-Type": "application/json" }
         });
       }
       async detachMyCustomerPaymentMethod(uuid, paymentMethodId) {
@@ -11437,6 +11517,7 @@ var init_chunk_YESHLUL7 = __esm({
       EventRuleEventType2["CALL_STARTED"] = "call:started";
       EventRuleEventType2["CALL_COMPLETED"] = "call:completed";
       EventRuleEventType2["CALL_SUMMARY"] = "call:summary";
+      EventRuleEventType2["VOICEMAIL_RECEIVED"] = "voicemail:received";
       return EventRuleEventType2;
     })(EventRuleEventType || {});
     DriverMode = /* @__PURE__ */ ((DriverMode2) => {
@@ -13826,6 +13907,7 @@ var init_chunk_YESHLUL7 = __esm({
       getMyCustomerAccounts;
       getMyCustomerSubscriptions;
       getMyCustomerInvoices;
+      createMyCustomerPortalSession;
       updateMyCustomer;
       createMyCustomerSetupIntent;
       getMyCustomerPaymentMethods;
@@ -14056,7 +14138,7 @@ var init_chunk_V7ZKEH4V = __esm({
 var SEARCHABLE_EVENT_RULE_SOURCE_FIELDS;
 var init_dist = __esm({
   "../sdk/dist/index.js"() {
-    init_chunk_YESHLUL7();
+    init_chunk_MUEM2BLY();
     init_chunk_V7ZKEH4V();
     init_chunk_FSSXKQR5();
     SEARCHABLE_EVENT_RULE_SOURCE_FIELDS = [
@@ -41558,6 +41640,11 @@ function priceSummary(product) {
   }
   return parts.join(", ") || "\u2014";
 }
+function checkoutPeriod(args) {
+  const value = typeof args.period === "string" ? args.period : "month";
+  if (value === "month" || value === "quarter" || value === "year") return value;
+  throw new Error("Billing period must be 'month', 'quarter', or 'year'");
+}
 var PRODUCT_COLUMNS2 = [
   { header: "ID", getValue: (p) => String(p.id ?? "") },
   { header: "NAME", getValue: (p) => p.name ?? "" },
@@ -41582,6 +41669,14 @@ var SUBSCRIPTION_COLUMNS = [
     getValue: (s) => String(s.customerOrganizationUuid ?? s.organizationUuid ?? "")
   }
 ];
+var CONTRACT_BEARING_STATUSES = /* @__PURE__ */ new Set([
+  "incomplete",
+  "trialing",
+  "active",
+  "past_due",
+  "unpaid",
+  "paused"
+]);
 function isTable(ctx) {
   return (ctx.outputFormat ?? "table") === "table";
 }
@@ -41619,7 +41714,7 @@ var billingDomain = {
         } else {
           hint(ctx, [
             "Next \u2014 buy an organization plan to get started:",
-            "  gr billing checkout --product <id> [--period month|year]"
+            "  gr billing checkout --product <id> [--org <id>|--new-org]"
           ]);
         }
       }
@@ -41631,15 +41726,40 @@ var billingDomain = {
       requiresWorkspace: false,
       args: [
         { name: "product", description: "Product ID of the org plan to buy", required: true },
-        { name: "period", description: "Billing period: 'month' or 'year'", default: "month" }
+        {
+          name: "period",
+          description: "Billing period: 'month', 'quarter', or 'year'",
+          default: "month"
+        },
+        {
+          name: "org",
+          description: "Existing organization ID to own the subscription"
+        },
+        {
+          name: "new-org",
+          description: "Create a new organization for this subscription",
+          isFlag: true
+        }
+      ],
+      examples: [
+        "gr billing checkout --product 12 --period month --org 7",
+        "gr billing checkout --product 12 --period month --new-org"
       ],
-      examples: ["gr billing checkout --product 12 --period month"],
       handler: async ({ ctx, args }) => {
         const productId = Number(requireString(args, "product"));
-        const period = args.period || "month";
+        const period = checkoutPeriod(args);
+        const organizationId = typeof args.org === "string" ? Number(args.org) : void 0;
+        const createNewOrg = args["new-org"] === true;
+        if (organizationId !== void 0 && (!Number.isInteger(organizationId) || organizationId <= 0)) {
+          throw new Error("Organization ID must be a positive integer");
+        }
+        if (organizationId !== void 0 && createNewOrg) {
+          throw new Error("Choose either --org or --new-org, not both");
+        }
         const result3 = await requireAuth(ctx).apiClient.createCheckoutSession(
           productId,
-          period
+          period,
+          organizationId !== void 0 || createNewOrg ? { checkoutContext: { organizationId, createNewOrg } } : void 0
         );
         if (isTable(ctx)) {
           process.stdout.write(
@@ -41666,10 +41786,10 @@ Then check it landed:
       handler: async ({ ctx }) => {
         const subs = await requireAuth(ctx).apiClient.getSubscriptions();
         outputData(subs, ctx, SUBSCRIPTION_COLUMNS);
-        const active = subs.find(
-          (s) => ["active", "trialing"].includes(String(s.status ?? s.subscriptionStatus ?? ""))
+        const contract = subs.find(
+          (s) => CONTRACT_BEARING_STATUSES.has(String(s.status ?? s.subscriptionStatus ?? ""))
         );
-        if (!active) {
+        if (!contract) {
           hint(ctx, [
             "No active subscription yet. To get started:",
             "  gr billing products --type org        # pick a plan",
@@ -41677,8 +41797,16 @@ Then check it landed:
           ]);
           return;
         }
+        const contractStatus = String(contract.status ?? contract.subscriptionStatus ?? "");
+        if (!["active", "trialing"].includes(contractStatus)) {
+          hint(ctx, [
+            `Your subscription is ${contractStatus}; it still represents a live billing contract.`,
+            "Resolve its payment or cancellation status in Gravity Rail billing before starting another checkout."
+          ]);
+          return;
+        }
         const orgUuid = String(
-          active.organizationUuid ?? active.customerOrganizationUuid ?? "<org-uuid>"
+          contract.organizationUuid ?? contract.customerOrganizationUuid ?? "<org-uuid>"
         );
         hint(ctx, [
           "You have an active subscription. Add a workspace:",
@@ -49547,6 +49675,7 @@ var MAX_HITL_ROUNDS = 25;
 async function runConciergeAguiLoop(client, initialMessages, onEvent, opts) {
   let streamText = "";
   let hasToolCalls = false;
+  let errorMessage;
   let resume;
   for (let round = 0; round < MAX_HITL_ROUNDS; round++) {
     let hitlPayload = null;
@@ -49563,8 +49692,11 @@ async function runConciergeAguiLoop(client, initialMessages, onEvent, opts) {
         const type = event.type?.toLowerCase() ?? "";
         if (type === "tool_call_start") hasToolCalls = true;
         const errorMsg = getErrorMessage(event);
-        if (errorMsg) process.stderr.write(`\x1B[31mError: ${errorMsg}\x1B[0m
+        if (errorMsg) {
+          errorMessage = errorMsg;
+          process.stderr.write(`\x1B[31mError: ${errorMsg}\x1B[0m
 `);
+        }
         const hitl = extractHumanInputRequest(event);
         if (hitl) hitlPayload = hitl;
       },
@@ -49593,13 +49725,15 @@ async function runConciergeAguiLoop(client, initialMessages, onEvent, opts) {
       return {
         streamText,
         hasToolCalls,
-        unsupportedHitl: normalizeUnsupportedHitl(hitlPayload)
+        unsupportedHitl: normalizeUnsupportedHitl(hitlPayload),
+        errorMessage
       };
     }
     resume = next;
     streamText = "";
+    errorMessage = void 0;
   }
-  return { streamText, hasToolCalls };
+  return { streamText, hasToolCalls, errorMessage };
 }
 function normalizeUnsupportedHitl(raw) {
   const payload = raw && typeof raw === "object" ? raw : {};
@@ -51164,6 +51298,7 @@ var AudioPlayer = class extends EventEmitter {
 
 // src/lib/chat-session.ts
 var HITL_INTERRUPT_EXIT_CODE = 3;
+var NO_FINAL_RESPONSE_EXIT_CODE = 4;
 async function runChatSession(session, args) {
   const debug = !!args.debug;
   const isVoice = !!args.voice;
@@ -51220,7 +51355,7 @@ async function singleTurnChatSession(session, message, debug, autoApprove = fals
 `);
     }
   };
-  const { streamText, hasToolCalls, unsupportedHitl } = await runConciergeAguiLoop(
+  const { streamText, hasToolCalls, unsupportedHitl, errorMessage } = await runConciergeAguiLoop(
     aguiClient,
     [{ role: "user", content: message }],
     onEvent,
@@ -51274,12 +51409,30 @@ async function singleTurnChatSession(session, message, debug, autoApprove = fals
       } catch {
       }
     }
-    process.stdout.write(`\x1B[32mAssistant:\x1B[0m ${finalText || "(no text response)"}
-`);
-  } else {
-    process.stdout.write(`\x1B[32mAssistant:\x1B[0m (no response)
+    if (finalText) {
+      process.stdout.write(`\x1B[32mAssistant:\x1B[0m ${finalText}
 `);
+      return;
+    }
+    throw noFinalResponseError(
+      errorMessage,
+      /* hadToolCalls */
+      true
+    );
+  }
+  if (errorMessage) {
+    throw noFinalResponseError(
+      errorMessage,
+      /* hadToolCalls */
+      false
+    );
   }
+  process.stdout.write(`\x1B[32mAssistant:\x1B[0m (no response)
+`);
+}
+function noFinalResponseError(errorMessage, hadToolCalls) {
+  const detail = errorMessage ? `inference error: ${errorMessage}` : hadToolCalls ? "the turn ran tool calls but returned no summary (side effects may have been applied)" : "no response from the assistant";
+  return new CLIError(`No assistant reply \u2014 ${detail}`, NO_FINAL_RESPONSE_EXIT_CODE);
 }
 async function interactiveChatSession(session, debug, autoApprove, allowWrite) {
   const aguiClient = new AGUIClient({
@@ -52542,7 +52695,7 @@ init_concierge_api();
 
 // package.json
 var package_default = {
-  version: "0.11.0"};
+  version: "0.13.0"};
 
 // src/gr.ts
 var VERSION = package_default.version;