@gravity-rail/cli 0.14.0 → 0.16.0

package/dist/lib.js

@@ -15,6 +15,7 @@ import {
   formatPaginationWarning,
   getConciergeChat,
   getConciergeChatMessages,
+  hint,
   isCursorPaginatedResponse,
   isListResult,
   isPagePaginatedResponse,
@@ -31,7 +32,7 @@ import {
   startAccountPhoneVerify,
   stderr,
   unwrapItems
-} from "./chunk-M4XMXS5D.js";
+} from "./chunk-EITDLX75.js";
 import {
   AGUIClient,
   formatTimestamp,
@@ -1214,6 +1215,43 @@ var agentTasksDomain = {
 
 // src/domains/agents.ts
 var COLUMNS = [COL.id(), COL.uuid(), COL.name(), COL.status(), COL.created()];
+var AGENT_FIELD_REFERENCE = `
+Field reference for --data JSON (create/update):
+
+Required on create
+  name (string)                         Display name
+  chatModelId (string)                  Text chat model ID (see \`gr ai-models chat\`)
+                                        e.g. "aws:bedrock:claude-4-5-haiku"
+
+Optional
+  description (string)                  Short summary shown in listings
+  systemPrompt (string)                 Base instructions / identity
+  chatModelConfig (object|null)         Chat model overrides (temperature, thinking, \u2026)
+  realtimeModelId (string|null)         Voice/realtime model (see \`gr ai-models realtime\`)
+                                        e.g. "xai:realtime:voice-agent-2" (Grok Voice Think Fast 2)
+                                        Native models auto-fill tts=native + default voice when
+                                        realtimeModelConfig is omitted.
+  realtimeModelConfig (object|null)     Realtime config. Native example:
+                                        {"ttsModel":"native","voiceModel":"xai:voice:eve"}
+                                        Composable (custom:realtime:composable) needs
+                                        voiceModel + ttsModel + inferenceModel.
+  memberRoleId (number)                 Role id (omit to use the default Agent role)
+  email / phone / externalId            Optional contact fields
+  labelIds (number[])                   Member label ids
+  codeInterpreterEnabled (bool)
+  maxDailyActions (number|null)
+
+Attach an agent\u2019s models/identity to a workflow (draft), then publish:
+  gr workflows update --id <wf> -d '{"copyFromAgentId": <agentId>}'
+  gr workflows publish --id <wf>
+
+One-shot workflow voice WITHOUT creating an agent (preferred for "use Grok Voice 2"):
+  gr workflows update --id <wf> -d '{"realtimeModelId":"xai:realtime:voice-agent-2"}'
+  gr workflows publish --id <wf>
+
+List models:
+  gr ai-models chat | realtime | voice
+`;
 var agentsDomain = {
   name: "agents",
   description: "Manage agents",
@@ -1230,9 +1268,16 @@ var agentsDomain = {
       unarchiveMethod: "unarchiveAgent",
       columns: COLUMNS,
       paginationSupport: "full",
-      updateHelp: "Update an agent. Body schema (JSON via --data/--file/stdin), all fields optional:\n  name              string   display name\n  description       string   short summary shown in listings\n  systemPrompt      string   base instructions for the agent\n  model             string   AI model slug (see `gr ai-models list`)\n  temperature       number   sampling temperature (0-2)\n  avatarFileId      number   workspace file ID for the avatar\n  config            object   AgentConfig overrides (advanced)\nWorkflow abilities are managed with `gr abilities`.",
+      createHelp: `Create an agent
+${AGENT_FIELD_REFERENCE}`,
+      updateHelp: `Update an agent. All fields optional.
+${AGENT_FIELD_REFERENCE}`,
+      createExamples: [
+        `gr agents create -d '{"name":"Support","chatModelId":"aws:bedrock:claude-4-5-haiku","realtimeModelId":"xai:realtime:voice-agent-2"}'`,
+        "gr agents create --file agent.json"
+      ],
       updateExamples: [
-        `gr agents update --id 42 --data '{"name":"Scheduler","temperature":0.4}'`,
+        `gr agents update --id 42 -d '{"realtimeModelId":"xai:realtime:voice-agent-2"}'`,
         "gr agents update --id 42 --file agent.json"
       ]
     })
@@ -2204,8 +2249,26 @@ Core
   name (string)                         Display name
   description (string, optional)
   defaultPhoneNumberId (number|null)    Outbound caller ID (workspace phone id)
+  defaultInboxId (number|null)          Default inbox for inbound messaging
   permissions (object, optional)        Workflow-level permission flags
 
+Assistant / models (live on the DRAFT revision \u2014 publish to go live)
+  assistantName (string)                Display name for the workflow assistant
+  assistantIdentity (string)            Persona / identity instructions
+  chatModelId (string)                  Text chat model (see \`gr ai-models chat\`)
+  chatModelConfig (object|null)         Chat model overrides
+  realtimeModelId (string|null)         Voice/realtime model (see \`gr ai-models realtime\`)
+                                        One-shot voice example:
+                                        {"realtimeModelId":"xai:realtime:voice-agent-2"}
+                                        Native models auto-fill tts=native + default voice
+                                        (xAI \u2192 xai:voice:eve). Optional explicit config:
+                                        {"realtimeModelId":"xai:realtime:voice-agent-2",
+                                         "realtimeModelConfig":{"ttsModel":"native",
+                                           "voiceModel":"xai:voice:ara"}}
+  realtimeModelConfig (object|null)     Realtime config; omit for provider defaults
+  copyFromAgentId (number)              Copy full assistant settings from an agent
+  copyFromWorkflowRevisionId (number)   Copy assistant settings from a revision
+
 Member role access (memberRoleAccess)
   Array of objects, NOT bare role ids:
   [{"memberRoleId": 6, "accessMode": 1}]
@@ -2231,6 +2294,9 @@ Use the dedicated commands:
   workflows revisions edit     Branch a published revision back into the draft
   workflows revisions diff     Compare two revisions
   workflows revisions update   Edit a revision's label / publish notes
+
+After changing assistant/realtime fields, publish so live traffic picks them up:
+  gr workflows publish --id <workflowId>
 `;
 
 // src/domains/workflows.ts
@@ -2857,7 +2923,15 @@ var COLUMNS6 = [
   COL.status(),
   COL.created()
 ];
-var PRODUCT_COLUMNS = [COL.id(), COL.uuid(), COL.name(), COL.status()];
+var PRODUCT_COLUMNS = [
+  COL.id(),
+  COL.uuid(),
+  COL.name(),
+  COL.status(),
+  // The plan a flow picks when it cannot ask (the signup funnel's workspace step,
+  // for one). One per type per catalogue — see `gr workspaces products set-default`.
+  { header: "DEFAULT", getValue: (item) => item.isDefault ? "yes" : "\u2014" }
+];
 var INVITATION_COLUMNS = [
   COL.id(),
   { header: "EMAIL", getValue: (item) => item.email ?? "" },
@@ -3293,6 +3367,40 @@ Provisioning started. Watch it come up with:
         outputSingle(result2, ctx, PRODUCT_COLUMNS);
       }
     },
+    {
+      path: ["workspaces", "products", "set-default"],
+      description: "Make a plan the one flows pick when they can't ask",
+      mutates: true,
+      requiresWorkspace: true,
+      args: [
+        { name: "id", description: "Product ID", required: true },
+        {
+          name: "unset",
+          description: "Clear the flag instead, leaving the catalogue with no default",
+          isFlag: true
+        }
+      ],
+      examples: [
+        "gr workspaces products set-default --id 21",
+        "gr workspaces products set-default --id 21 --unset"
+      ],
+      handler: async ({ ctx, args, workspace }) => {
+        const id = requireNumber(args, "id");
+        const isDefault = !args["unset"];
+        const result2 = await requireAuth(ctx).apiClient.updateProduct(workspace, id, {
+          isDefault
+        });
+        outputSingle(result2, ctx, PRODUCT_COLUMNS);
+        hint(ctx, [
+          isDefault ? "Any other plan of this type in the catalogue is no longer the default." : (
+            // Only this plan's flag is cleared. Claiming the catalogue now has
+            // no default would be wrong when a different plan holds it — the
+            // response cannot tell us whether this one was the holder.
+            "This plan no longer holds the default flag. Check which plan does:\n  gr workspaces products list"
+          )
+        ]);
+      }
+    },
     // Invitations — workspace-scoped admin methods
     {
       path: ["workspaces", "invitations", "list"],
@@ -7468,7 +7576,7 @@ var COLUMNS14 = [
 ];
 var aiModelsDomain = {
   name: "ai-models",
-  description: "List available AI models",
+  description: `List available AI models (chat, realtime/voice stacks, speaker voices). Use realtime ids as workflow/agent realtimeModelId; voice ids go in realtimeModelConfig.voiceModel. One-shot workflow voice: gr workflows update -d '{"realtimeModelId":"xai:realtime:voice-agent-2"}' then publish.`,
   commands: [
     {
       path: ["ai-models", "list"],
@@ -7481,7 +7589,7 @@ var aiModelsDomain = {
     },
     {
       path: ["ai-models", "chat"],
-      description: "List chat models",
+      description: "List chat models (use as chatModelId on agents/workflows)",
       requiresWorkspace: false,
       handler: async ({ ctx }) => {
         const result2 = await requireAuth(ctx).apiClient.getChatModels();
@@ -7490,7 +7598,7 @@ var aiModelsDomain = {
     },
     {
       path: ["ai-models", "realtime"],
-      description: "List realtime models",
+      description: "List realtime/voice stacks (use as realtimeModelId). e.g. xai:realtime:voice-agent-2 = Grok Voice Think Fast 2",
       requiresWorkspace: false,
       handler: async ({ ctx }) => {
         const result2 = await requireAuth(ctx).apiClient.getRealtimeModels();
@@ -7499,7 +7607,7 @@ var aiModelsDomain = {
     },
     {
       path: ["ai-models", "voice"],
-      description: "List voice models",
+      description: "List speaker voices (use as realtimeModelConfig.voiceModel). Match provider to the realtime model (xai:voice:* with xAI realtime)",
       requiresWorkspace: false,
       handler: async ({ ctx }) => {
         const result2 = await requireAuth(ctx).apiClient.getVoiceModels();
@@ -7911,6 +8019,13 @@ var PRODUCT_COLUMNS2 = [
       const days = p.trialPeriodDays ?? 0;
       return days > 0 ? `${days}d` : "\u2014";
     }
+  },
+  // Which plan a flow picks when it cannot ask — the signup funnel's workspace
+  // step, for one. Invisible without this: the flag decides what customers get
+  // started on, so reading the catalogue should show it.
+  {
+    header: "DEFAULT",
+    getValue: (p) => p.isDefault ? "yes" : "\u2014"
   }
 ];
 var SUBSCRIPTION_COLUMNS = [
@@ -7935,10 +8050,6 @@ var CONTRACT_BEARING_STATUSES = /* @__PURE__ */ new Set([
 function isTable(ctx) {
   return (ctx.outputFormat ?? "table") === "table";
 }
-function hint(ctx, lines) {
-  if (!isTable(ctx)) return;
-  process.stdout.write("\n" + lines.join("\n") + "\n");
-}
 function productType(args) {
   const t = args.type ?? args["product-type"];
   if (t === "org" || t === "workspace") return t;
@@ -9801,7 +9912,41 @@ function simulateInboundRouting(phone, opts = {}) {
     steps.push({ step: "inbound_call_handling", outcome: "play_message" });
     return finish("play_message_hangup", false, false, steps, recommendations, callerRole);
   }
-  steps.push({ step: "inbound_call_handling", outcome: "ai_path" });
+  if (inboundCallHandling === "ring_operators") {
+    const operatorGroupId = phone.operatorGroupId;
+    const ringWorkflowId = phone.defaultWorkflowId;
+    if (!operatorGroupId || ringWorkflowId === null || ringWorkflowId === void 0) {
+      steps.push({
+        step: "inbound_call_handling",
+        outcome: "ai_path",
+        detail: "ring_operators skipped \u2014 needs BOTH operatorGroupId and defaultWorkflowId"
+      });
+      recommendations.push(
+        "ring_operators is configured but inert: set operatorGroupId (gr operator-groups list -w $WID) and defaultWorkflowId, or the line silently answers with AI"
+      );
+    } else {
+      const noAnswer = phone.operatorNoAnswerAction ?? "voicemail";
+      const timeout = phone.operatorRingTimeoutSeconds ?? 30;
+      steps.push({
+        step: "inbound_call_handling",
+        outcome: "ring_operators",
+        detail: `group=${operatorGroupId} timeout=${timeout}s no_answer=${noAnswer}`
+      });
+      steps.push({
+        step: "operator_presence",
+        outcome: "runtime_dependent",
+        detail: `live operators are resolved at call time \u2014 not simulatable. If none are live, or none answer within ${timeout}s, the call falls back to: ${noAnswer}`
+      });
+      if (noAnswer === "ai") {
+        recommendations.push(
+          "operatorNoAnswerAction=ai \u2014 an unanswered ring lands on the AI assistant, so callers may reach the AI rather than voicemail"
+        );
+      }
+      return finish("ring_operators", true, true, steps, recommendations, callerRole);
+    }
+  } else {
+    steps.push({ step: "inbound_call_handling", outcome: "ai_path" });
+  }
   const workflowId = phone.defaultWorkflowId;
   if (workflowId === null || workflowId === void 0) {
     steps.push({
@@ -9859,7 +10004,8 @@ function finish(code, createsChat, createsPhoneCall, steps, recommendations, cal
     fax_receive: "Create fax chat + receive document",
     no_inbound_workflow: "Play unavailable message (no inbound workflow)",
     workflow_member_role_denied: "Reject \u2014 caller member role lacks workflow USE (memberRoleAccess)",
-    ai_voice_chat: "Create chat + connect AI voice"
+    ai_voice_chat: "Create chat + connect AI voice",
+    ring_operators: "Ring live operators (falls back if none answer)"
   };
   return {
     callerRole: callerRole ?? "unknown",
@@ -14066,7 +14212,7 @@ var widgetDomainsDomain = {
         }
       ],
       examples: [
-        "gr widget-domains enable -w $WID --domain <uuid> --widgets chat,operator --allow-write",
+        "gr widget-domains enable -w $WID --domain <uuid> --widgets chat,operator-tools --allow-write",
         "gr widget-domains enable -w $WID --domain <uuid> --widgets chat --allow-subdomains --port 4444 --allow-write"
       ],
       handler: async ({ ctx, workspace, args }) => {
@@ -19390,7 +19536,7 @@ var topLevelCommands = [
     mutates: true,
     args: [{ name: "phone", description: "E.164 phone number (optional; prompts if omitted)" }],
     handler: async (hctx) => {
-      const { accountVerifyPhoneCommand } = await import("./account-verify-phone-UA5OUOOR.js");
+      const { accountVerifyPhoneCommand } = await import("./account-verify-phone-Q2NIRSX4.js");
       await accountVerifyPhoneCommand(hctx);
     }
   },