@gravity-rail/cli 0.15.0 → 0.16.0

package/dist/lib.js

@@ -1215,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",
@@ -1231,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"
       ]
     })
@@ -2205,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}]
@@ -2232,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
@@ -7511,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"],
@@ -7524,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();
@@ -7533,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();
@@ -7542,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();
@@ -14147,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 }) => {