@arbol-ai/cli 3.41.0 → 3.43.0

package/dist/index.js

@@ -18943,7 +18943,7 @@ var commands = {
       ]
     },
     title: "Create a campaign",
-    description: "Prepare a campaign with up to 10000 recipients, each a phone `address` with an optional `contactId` and `variables`. A call campaign (the default) has a voice Agent call each one. With `channelType: whatsapp` and an approved `template`, each one is sent the template, its `parameters` filled from their `variables` (`{{name}}`), and its text Agent answers whoever replies. Nobody is reached until it is started. A list adds nobody to the organization's contacts: a recipient becomes the contact it names, or the owner of its number (created when none exists), when the campaign first reaches them. A longer list continues with `updateCampaign` and `addRecipients`. Nothing happens outside `contactHours` (in `timeZone`, the organization's by default) or outside `scheduledStartAt` and `scheduledEndAt`; each recipient gets up to `maxAttempts` attempts, `retryAfterMinutes` apart, after the results in `retryOn`. Read it with `expand=readiness` to see whether it can start. Starting it (REST `POST /v1/campaigns/{campaignId}/start`) is not an AI tool. Read the `run-a-campaign` skill.",
+    description: "Prepare a campaign with up to 10000 recipients, each a phone `address` with an optional `contactId` and `variables`. A call campaign (the default) has a voice Agent call each one. With `channelType: whatsapp` and an approved `template`, each one is sent the template, its `parameters` filled from their `variables` (`{{name}}`) and, when its header is a document, image or video, their own `header` file; its text Agent answers whoever replies. Nobody is reached until it is started. A list adds nobody to the organization's contacts: a recipient becomes the contact it names, or the owner of its number (created when none exists), when the campaign first reaches them. A longer list continues with `updateCampaign` and `addRecipients`. Nothing happens outside `contactHours` (in `timeZone`, the organization's by default) or outside `scheduledStartAt` and `scheduledEndAt`; each recipient gets up to `maxAttempts` attempts, `retryAfterMinutes` apart, after the results in `retryOn`. Read it with `expand=readiness` to see whether it can start. Starting it (REST `POST /v1/campaigns/{campaignId}/start`) is not an AI tool. Read the `run-a-campaign` skill.",
     effect: "write",
     confirmation: null,
     hidden: false
@@ -18962,7 +18962,7 @@ var commands = {
         flag: "expand",
         kind: "string",
         required: false,
-        description: "Related data to include, comma-separated: `recipients`, `readiness`."
+        description: "Related data to include, comma-separated: `recipients`, `readiness`, `results`."
       },
       {
         name: "recipientsCursor",
@@ -18998,6 +18998,13 @@ var commands = {
         required: false,
         description: "With `expand=recipients`: only those whose number contains these digits or whose name contains this text."
       },
+      {
+        name: "recipientsResult",
+        flag: "recipients-result",
+        kind: "string",
+        required: false,
+        description: "With `expand=recipients`: `definitionKey=optionKey`, only those whose latest answer is that option; `definitionKey=`, only those with no answer yet."
+      },
       {
         name: "recipientsStatus",
         flag: "recipients-status",
@@ -19025,11 +19032,11 @@ var commands = {
           type: "string"
         },
         expand: {
-          description: "Related data to include, comma-separated: `recipients`, `readiness`.",
+          description: "Related data to include, comma-separated: `recipients`, `readiness`, `results`.",
           examples: [
-            "recipients,readiness"
+            "recipients,readiness,results"
           ],
-          pattern: "^(recipients|readiness)(,(recipients|readiness))*$",
+          pattern: "^(recipients|readiness|results)(,(recipients|readiness|results))*$",
           type: "string"
         },
         recipientsCursor: {
@@ -19064,6 +19071,11 @@ var commands = {
           minLength: 1,
           type: "string"
         },
+        recipientsResult: {
+          description: "With `expand=recipients`: `definitionKey=optionKey`, only those whose latest answer is that option; `definitionKey=`, only those with no answer yet.",
+          pattern: "^[a-z][a-z0-9_]{0,63}=([a-z][a-z0-9_]{0,63})?$",
+          type: "string"
+        },
         recipientsStatus: {
           description: "`pending`: waiting for its (next) call or message. `in_progress`: being called, or on WhatsApp waiting for a reply until a reminder is due. `completed`: an attempt succeeded; on WhatsApp, the message arrived. `failed`: its attempts ran out, or it cannot be reached.",
           anyOf: [
@@ -19096,7 +19108,7 @@ var commands = {
       additionalProperties: false
     },
     title: "Get a campaign",
-    description: "Read one campaign: Agent, schedule, contact hours, retries, progress and, in `errorCode`, why it cannot reach anyone now. `expand=recipients` adds its recipients in the order they were added, each with attempts, next attempt, error and latest call or message; continue with `recipientsCursor` (`recipientsDirection` reads the other way). `expand=readiness` says whether it can start and lists what has to be fixed first, without reaching anyone. Read it before `update_campaign` and send `expectedVersion`.",
+    description: "Read one campaign: Agent, schedule, contact hours, retries, progress and, in `errorCode`, why it cannot reach anyone now. `expand=recipients` adds its recipients in the order they were added, each with attempts, next attempt, error and latest call or message; continue with `recipientsCursor` (`recipientsDirection` reads the other way). `expand=readiness` says whether it can start and lists what has to be fixed first, without reaching anyone. `expand=results` counts what people answered, by the Agent's data definitions with options; each recipient also says their own. Read it before `update_campaign` and send `expectedVersion`.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -19258,6 +19270,38 @@ var commands = {
     confirmation: null,
     hidden: false
   },
+  "raiz campaigns start": {
+    operation: "raiz.campaigns.start",
+    sdkPath: [
+      "raiz",
+      "campaigns",
+      "start"
+    ],
+    pathField: "campaignId",
+    fields: [],
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      required: [
+        "campaignId"
+      ],
+      properties: {
+        campaignId: {
+          description: "Campaign id.",
+          examples: [
+            "cmp_01m45h8q2rf3t9w6y7z0b1c2d3"
+          ],
+          pattern: "^cmp_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$",
+          type: "string"
+        }
+      }
+    },
+    title: "Start a campaign",
+    description: "Start reaching people: from now on the campaign's due recipients are called, at most `settings.channels.maxConcurrentOutboundCalls` (five by default) at once across the organization, or sent their message, one after another, about 30 a minute. A call campaign needs an active, published voice Agent (VOICE_AGENT_NOT_READY). A WhatsApp campaign needs an active text Agent (CAMPAIGN_AGENT_NOT_READY), a line that can send (CHANNEL_NOT_READY), an approved template whose parameters fit (a `TEMPLATE_*` code), a value for every variable (CAMPAIGN_VARIABLE_MISSING) and, when the template's header is a document, image or video, the first pending recipient's own `header` file (CAMPAIGN_HEADER_MISSING). A recipient must be pending (CAMPAIGN_NO_RECIPIENTS). `get_campaign` with `expand=readiness` lists all of this beforehand. A campaign starts once: starting a running one changes nothing, and a paused one resumes with `update_campaign` and `paused: false`. Not an AI tool: it reaches real people.",
+    effect: "write",
+    confirmation: null,
+    hidden: false
+  },
   "raiz campaigns update": {
     operation: "raiz.campaigns.update",
     sdkPath: [
@@ -19553,7 +19597,7 @@ var commands = {
       }
     },
     title: "Update a campaign",
-    description: "Change a campaign. Omitted fields stay. `paused: true` pauses a started campaign (no new call or message starts; those in progress finish) and `paused: false` resumes it, with the same checks as starting. Before the start, `recipients` is the complete set, replacing whoever was there; once started it only adds. `addRecipients` adds at any moment, which is how a list longer than one request arrives: a number the campaign already has is skipped, so repeating a part reaches nobody twice. The Agent changes only before the start, and a completed campaign accepts only its name and metadata. A change lifts the wait of a campaign held by `errorCode`: fixing a template and sending it here tries again at once.",
+    description: "Change a campaign. Omitted fields stay. `paused: true` pauses a started campaign (no new call or message starts; those in progress finish) and `paused: false` resumes it, with the same checks as starting. Before the start, `recipients` is the complete set, replacing whoever was there; once started it only adds. `addRecipients` adds at any moment, which is how a list longer than one request arrives: a number the campaign already has is skipped, so repeating a part reaches nobody twice, and a recipient's `header` file is stored only when its row has none (CAMPAIGN_HEADER_NOT_STORED says some were not: send those recipients again). The Agent changes only before the start, and a completed campaign accepts only its name and metadata. A change lifts the wait of a campaign held by `errorCode`: fixing a template and sending it here tries again at once.",
     effect: "write",
     confirmation: null,
     hidden: false
@@ -31027,6 +31071,59 @@ var commands = {
     confirmation: null,
     hidden: false
   },
+  "visoft appointment-receipts lookup": {
+    operation: "visoft.appointmentReceipts.lookup",
+    sdkPath: [
+      "visoft",
+      "appointmentReceipts",
+      "lookup"
+    ],
+    pathField: null,
+    fields: [
+      {
+        name: "connectionId",
+        flag: "connection-id",
+        kind: "string",
+        required: false,
+        description: "The connection to run on. Optional when the organization has one Visoft connection; required when it has several. Another organization's connection is CONNECTION_NOT_FOUND."
+      },
+      {
+        name: "reference",
+        flag: "reference",
+        kind: "string",
+        required: true,
+        description: "The appointment's opaque reference, as visoft.appointments.list answered it."
+      }
+    ],
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      required: [
+        "reference"
+      ],
+      properties: {
+        connectionId: {
+          minLength: 5,
+          maxLength: 68,
+          pattern: "^con_[0-9A-Za-z]+$",
+          description: "The connection to run on. Optional when the organization has one Visoft connection; required when it has several. Another organization's connection is CONNECTION_NOT_FOUND.",
+          type: "string"
+        },
+        reference: {
+          minLength: 1,
+          maxLength: 300,
+          pattern: "^[A-Za-z0-9:._-]+(?:=[A-Za-z0-9:._-]*){8,24}$",
+          description: "The appointment's opaque reference, as visoft.appointments.list answered it.",
+          type: "string"
+        }
+      }
+    },
+    title: "Look up an appointment receipt",
+    description: "SIIPS's own printed receipt (ticket) of one assigned appointment, by the reference visoft.appointments.list answered: the PDF SIIPS's print action serves, unchanged, base64. It is answered only when its text names the appointment's day, hour and patient; otherwise APPOINTMENT_RECEIPT_UNAVAILABLE. Never cached. Printing changes no appointment and sends nothing to the patient.",
+    effect: "read",
+    confirmation: null,
+    hidden: false
+  },
   "visoft appointments cancel": {
     operation: "visoft.appointments.cancel",
     sdkPath: [
@@ -31547,7 +31644,7 @@ var commands = {
       }
     },
     title: "List assigned appointments",
-    description: "Read assigned appointments for one day at a cost centre, ordered by moment and reference, with the contact phone SIIPS records. Never cached. A full upstream page that cannot prove completeness is PROVIDER_UNAVAILABLE; narrow by professionalId rather than treating a partial agenda as complete. This operation changes no appointment and sends no message.",
+    description: "Read assigned appointments for one day at a cost centre, ordered by moment and reference, with the contact phone and the state (`status`) SIIPS records. Never cached. A full upstream page that cannot prove completeness is PROVIDER_UNAVAILABLE; narrow by professionalId rather than treating a partial agenda as complete. This operation changes no appointment and sends no message.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -88361,6 +88458,14 @@ var schemaComponents = {
       recipients: {
         $ref: "#/components/schemas/RaizCampaignRecipientPage",
         description: "The campaign's recipients in the order they were added, each with its latest attempt. Present only when expanded."
+      },
+      results: {
+        description: "What people answered, for each data definition with options their Agent collects that has an answer yet. Answers arrive when a conversation closes and is analyzed, so they can keep arriving after the campaign ends.",
+        maxItems: 100,
+        type: "array",
+        items: {
+          $ref: "#/components/schemas/RaizCampaignResult"
+        }
       }
     }
   },
@@ -88572,6 +88677,10 @@ var schemaComponents = {
           }
         ]
       },
+      header: {
+        $ref: "#/components/schemas/RaizTemplateHeaderFile",
+        description: "WhatsApp only: this recipient's file for a template whose header is a document, image or video (an appointment's receipts, a ticket), shown above its text. Kept privately with the campaign and sent with this recipient's message; a number the campaign already has keeps its first file, and replacing the whole list replaces them. A request carries at most 2 MiB: send a long list with files in parts with `addRecipients`."
+      },
       instructions: {
         anyOf: [
           {
@@ -88586,7 +88695,7 @@ var schemaComponents = {
         ]
       },
       variables: {
-        description: "Values for the `{{name}}` variables a WhatsApp template's parameters, or the Agent's instructions, first message or this campaign's texts on a call, reference. Raíz always provides `contact_name`, `contact_given_name` and `contact_phone`, and on a call also `contact_id`, `conversation_id` and `bulletins` (the business bulletins in force); a recipient's values never replace them.",
+        description: "Values for the `{{name}}` variables a WhatsApp template's parameters, or the Agent's instructions, first message or this campaign's texts on a call, reference. A reference means the variable that is the same word, whatever its accents and case: `{{País}}` reads `pais`, and an exact name wins. Raíz always provides `contact_name`, `contact_given_name` and `contact_phone`, and on a call also `contact_id`, `conversation_id` and `bulletins` (the business bulletins in force); a recipient's values never replace them.",
         maxProperties: 30,
         type: "object",
         patternProperties: {
@@ -88616,6 +88725,7 @@ var schemaComponents = {
           required: [
             "address",
             "attemptCount",
+            "contact",
             "contactId",
             "createdAt",
             "deliveredAt",
@@ -88629,6 +88739,7 @@ var schemaComponents = {
             "nextAttemptAt",
             "readAt",
             "repliedAt",
+            "results",
             "status",
             "updatedAt",
             "variables"
@@ -88641,6 +88752,43 @@ var schemaComponents = {
               minimum: 0,
               type: "integer"
             },
+            contact: {
+              anyOf: [
+                {
+                  description: "The contact this person is: the one the list named, else the one that owns the number. Null when the organization has none yet; the campaign creates it when it reaches them.",
+                  additionalProperties: false,
+                  type: "object",
+                  required: [
+                    "id",
+                    "name"
+                  ],
+                  properties: {
+                    id: {
+                      description: "Contact id.",
+                      examples: [
+                        "cnt_01m45h8q2rf3t9w6y7z0b1c2d3"
+                      ],
+                      pattern: "^cnt_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$",
+                      type: "string"
+                    },
+                    name: {
+                      anyOf: [
+                        {
+                          description: "Their saved name, else the name they show on WhatsApp; null when the organization has neither.",
+                          type: "string"
+                        },
+                        {
+                          type: "null"
+                        }
+                      ]
+                    }
+                  }
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
             contactId: {
               anyOf: [
                 {
@@ -88735,7 +88883,7 @@ var schemaComponents = {
             lastAttempt: {
               anyOf: [
                 {
-                  description: "The latest call or message to this recipient; its transcript is `getConversation`.",
+                  description: "The latest call or message to this recipient, or their answer when it came after that conversation closed; its transcript is `getConversation`.",
                   additionalProperties: false,
                   type: "object",
                   required: [
@@ -88836,6 +88984,34 @@ var schemaComponents = {
                 }
               ]
             },
+            results: {
+              description: "What this person answered, from their conversations: the latest for each data definition with options their Agent collects. Empty until a conversation they answered closes and is analyzed.",
+              maxItems: 100,
+              type: "array",
+              items: {
+                additionalProperties: false,
+                type: "object",
+                required: [
+                  "definitionKey",
+                  "label",
+                  "value"
+                ],
+                properties: {
+                  definitionKey: {
+                    description: "The key of the data definition that read it.",
+                    type: "string"
+                  },
+                  label: {
+                    description: "The answer, as people read it.",
+                    type: "string"
+                  },
+                  value: {
+                    description: "The key of the answer's option.",
+                    type: "string"
+                  }
+                }
+              }
+            },
             status: {
               description: "`pending`: waiting for its (next) call or message. `in_progress`: being called, or on WhatsApp waiting for a reply until a reminder is due. `completed`: an attempt succeeded; on WhatsApp, the message arrived. `failed`: its attempts ran out, or it cannot be reached.",
               anyOf: [
@@ -88867,7 +89043,7 @@ var schemaComponents = {
               type: "string"
             },
             variables: {
-              description: "Values for the `{{name}}` variables a WhatsApp template's parameters, or the Agent's instructions, first message or this campaign's texts on a call, reference. Raíz always provides `contact_name`, `contact_given_name` and `contact_phone`, and on a call also `contact_id`, `conversation_id` and `bulletins` (the business bulletins in force); a recipient's values never replace them.",
+              description: "Values for the `{{name}}` variables a WhatsApp template's parameters, or the Agent's instructions, first message or this campaign's texts on a call, reference. A reference means the variable that is the same word, whatever its accents and case: `{{País}}` reads `pais`, and an exact name wins. Raíz always provides `contact_name`, `contact_given_name` and `contact_phone`, and on a call also `contact_id`, `conversation_id` and `bulletins` (the business bulletins in force); a recipient's values never replace them.",
               maxProperties: 30,
               type: "object",
               patternProperties: {
@@ -88891,6 +89067,60 @@ var schemaComponents = {
       }
     }
   },
+  RaizCampaignResult: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "definition",
+      "values"
+    ],
+    properties: {
+      definition: {
+        additionalProperties: false,
+        type: "object",
+        required: [
+          "key",
+          "name"
+        ],
+        properties: {
+          key: {
+            type: "string"
+          },
+          name: {
+            type: "string"
+          }
+        }
+      },
+      values: {
+        maxItems: 100,
+        type: "array",
+        items: {
+          additionalProperties: false,
+          type: "object",
+          required: [
+            "key",
+            "label",
+            "people"
+          ],
+          properties: {
+            key: {
+              description: "The key of the answer's option.",
+              type: "string"
+            },
+            label: {
+              description: "The answer, as people read it.",
+              type: "string"
+            },
+            people: {
+              description: "How many recipients it is the latest answer of. Each counts once, however many conversations they had.",
+              minimum: 1,
+              type: "integer"
+            }
+          }
+        }
+      }
+    }
+  },
   RaizCampaignTemplate: {
     additionalProperties: false,
     type: "object",
@@ -88907,7 +89137,7 @@ var schemaComponents = {
         type: "string"
       },
       name: {
-        description: "An approved template of the line's WhatsApp Business Account. Its body may have variables; a file in its header and button parameters cannot be used in a campaign.",
+        description: "An approved template of the line's WhatsApp Business Account. Its body may have variables; when its header is a document, image or video, each recipient brings its own file (`header`). Button parameters cannot be used in a campaign.",
         maxLength: 512,
         minLength: 1,
         type: "string"
@@ -88938,7 +89168,7 @@ var schemaComponents = {
         type: "string"
       },
       name: {
-        description: "An approved template of the line's WhatsApp Business Account. Its body may have variables; a file in its header and button parameters cannot be used in a campaign.",
+        description: "An approved template of the line's WhatsApp Business Account. Its body may have variables; when its header is a document, image or video, each recipient brings its own file (`header`). Button parameters cannot be used in a campaign.",
         maxLength: 512,
         minLength: 1,
         type: "string"
@@ -94713,11 +94943,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CAMPAIGN_NO_RECIPIENTS",
+                const: "CAMPAIGN_HEADER_MISSING",
                 type: "string"
               },
               message: {
-                const: "The campaign has nobody left to reach. Add recipients first.",
+                const: "A recipient has no file that fits the template's header (a PDF for a document, JPEG or PNG for an image, MP4 for a video). Each recipient brings its own as `header`.",
                 type: "string"
               },
               retryable: {
@@ -94742,11 +94972,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CAMPAIGN_VARIABLE_MISSING",
+                const: "CAMPAIGN_HEADER_NOT_STORED",
                 type: "string"
               },
               message: {
-                const: "A recipient has no value for a variable the template's parameters use. An empty value cannot be sent on WhatsApp.",
+                const: "The campaign and its recipients were saved, but some recipients' files were not. Send those recipients again with `addRecipients` on this campaign: their numbers are kept and their files stored. Do not create the campaign again.",
                 type: "string"
               },
               retryable: {
@@ -94757,16 +94987,11 @@ var schemaComponents = {
                 additionalProperties: false,
                 type: "object",
                 required: [
-                  "address",
-                  "variable"
+                  "campaignId"
                 ],
                 properties: {
-                  address: {
-                    description: "The first recipient that lacks the value.",
-                    type: "string"
-                  },
-                  variable: {
-                    description: "The variable of the template's parameters it lacks.",
+                  campaignId: {
+                    description: "The campaign, saved with its recipients.",
                     type: "string"
                   }
                 }
@@ -94784,11 +95009,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_AGENT_MISMATCH",
+                const: "CAMPAIGN_NO_RECIPIENTS",
                 type: "string"
               },
               message: {
-                const: "This Agent cannot serve this channel: voice channels need a voice Agent; WhatsApp and web channels need a text Agent.",
+                const: "The campaign has nobody left to reach. Add recipients first.",
                 type: "string"
               },
               retryable: {
@@ -94813,11 +95038,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_CREATION_IN_APP",
+                const: "CAMPAIGN_VARIABLE_MISSING",
                 type: "string"
               },
               message: {
-                const: "An AI tool creates website chats and forms only. A person adds WhatsApp numbers and phone numbers in Settings → Channels, or through the REST API.",
+                const: "A recipient has no value for a variable the template's parameters use. An empty value cannot be sent on WhatsApp.",
                 type: "string"
               },
               retryable: {
@@ -94827,7 +95052,20 @@ var schemaComponents = {
               data: {
                 additionalProperties: false,
                 type: "object",
-                properties: {}
+                required: [
+                  "address",
+                  "variable"
+                ],
+                properties: {
+                  address: {
+                    description: "The first recipient that lacks the value.",
+                    type: "string"
+                  },
+                  variable: {
+                    description: "The variable of the template's parameters it lacks.",
+                    type: "string"
+                  }
+                }
               }
             }
           },
@@ -94842,11 +95080,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_AGENT_REQUIRED",
+                const: "CHANNEL_AGENT_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "Inbound traffic requires an assigned Agent. Outbound traffic requires one except on WhatsApp notification channels.",
+                const: "This Agent cannot serve this channel: voice channels need a voice Agent; WhatsApp and web channels need a text Agent.",
                 type: "string"
               },
               retryable: {
@@ -94871,11 +95109,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_ENDPOINT_IN_USE",
+                const: "CHANNEL_CREATION_IN_APP",
                 type: "string"
               },
               message: {
-                const: "Another channel already uses this number or endpoint.",
+                const: "An AI tool creates website chats and forms only. A person adds WhatsApp numbers and phone numbers in Settings → Channels, or through the REST API.",
                 type: "string"
               },
               retryable: {
@@ -94900,11 +95138,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_NOT_READY",
+                const: "CHANNEL_AGENT_REQUIRED",
                 type: "string"
               },
               message: {
-                const: "The channel is not connected yet, or this kind of traffic is not enabled on it.",
+                const: "Inbound traffic requires an assigned Agent. Outbound traffic requires one except on WhatsApp notification channels.",
                 type: "string"
               },
               retryable: {
@@ -94929,11 +95167,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_TYPE_MISMATCH",
+                const: "CHANNEL_ENDPOINT_IN_USE",
                 type: "string"
               },
               message: {
-                const: "This operation or field does not apply to this channel's type.",
+                const: "Another channel already uses this number or endpoint.",
                 type: "string"
               },
               retryable: {
@@ -94958,11 +95196,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CONVERSATION_VIEW_AUTHOR_ONLY",
+                const: "CHANNEL_NOT_READY",
                 type: "string"
               },
               message: {
-                const: "Only the person who saved this view can make it private; it would disappear for the rest of the team.",
+                const: "The channel is not connected yet, or this kind of traffic is not enabled on it.",
                 type: "string"
               },
               retryable: {
@@ -94987,11 +95225,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CONVERSATION_VIEW_LIMIT_REACHED",
+                const: "CHANNEL_TYPE_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "The organization already has 200 saved views. Delete one before saving another.",
+                const: "This operation or field does not apply to this channel's type.",
                 type: "string"
               },
               retryable: {
@@ -95016,11 +95254,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CONVERSATION_VIEW_NAME_TAKEN",
+                const: "CONVERSATION_VIEW_AUTHOR_ONLY",
                 type: "string"
               },
               message: {
-                const: "Another saved view already has this name. Choose a different name.",
+                const: "Only the person who saved this view can make it private; it would disappear for the rest of the team.",
                 type: "string"
               },
               retryable: {
@@ -95045,11 +95283,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TEMPLATE_HEADER_MISMATCH",
+                const: "CONVERSATION_VIEW_LIMIT_REACHED",
                 type: "string"
               },
               message: {
-                const: "The header file does not fit the template: a document header takes a PDF, an image header a JPEG or PNG, a video header an MP4, and a template without a media header takes no file.",
+                const: "The organization already has 200 saved views. Delete one before saving another.",
                 type: "string"
               },
               retryable: {
@@ -95074,11 +95312,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TEMPLATE_HEADER_REQUIRED",
+                const: "CONVERSATION_VIEW_NAME_TAKEN",
                 type: "string"
               },
               message: {
-                const: "The template's header is a document, image or video: send its file with the template.",
+                const: "Another saved view already has this name. Choose a different name.",
                 type: "string"
               },
               retryable: {
@@ -95103,11 +95341,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TEMPLATE_NOT_APPROVED",
+                const: "TEMPLATE_HEADER_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "The template is not approved for sending: it is pending review, rejected, paused or disabled.",
+                const: "The header file does not fit the template: a document header takes a PDF, an image header a JPEG or PNG, a video header an MP4, and a template without a media header takes no file.",
                 type: "string"
               },
               retryable: {
@@ -95132,11 +95370,69 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TEMPLATE_NOT_FOUND",
+                const: "TEMPLATE_HEADER_REQUIRED",
                 type: "string"
               },
               message: {
-                const: "The template does not exist in this channel's WhatsApp Business Account.",
+                const: "The template's header is a document, image or video: send its file with the template.",
+                type: "string"
+              },
+              retryable: {
+                const: false,
+                type: "boolean"
+              },
+              data: {
+                additionalProperties: false,
+                type: "object",
+                properties: {}
+              }
+            }
+          },
+          {
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "code",
+              "message",
+              "retryable",
+              "data"
+            ],
+            properties: {
+              code: {
+                const: "TEMPLATE_NOT_APPROVED",
+                type: "string"
+              },
+              message: {
+                const: "The template is not approved for sending: it is pending review, rejected, paused or disabled.",
+                type: "string"
+              },
+              retryable: {
+                const: false,
+                type: "boolean"
+              },
+              data: {
+                additionalProperties: false,
+                type: "object",
+                properties: {}
+              }
+            }
+          },
+          {
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "code",
+              "message",
+              "retryable",
+              "data"
+            ],
+            properties: {
+              code: {
+                const: "TEMPLATE_NOT_FOUND",
+                type: "string"
+              },
+              message: {
+                const: "The template does not exist in this channel's WhatsApp Business Account.",
                 type: "string"
               },
               retryable: {
@@ -114045,6 +114341,7 @@ var schemaComponents = {
       "startsAt",
       "admissionNumber",
       "attended",
+      "status",
       "purpose",
       "resource",
       "subCostCenter",
@@ -114111,6 +114408,10 @@ var schemaComponents = {
         description: "SIIPS's attendance mark.",
         type: "string"
       },
+      status: {
+        description: "SIIPS's state of the appointment (its agenda's Estado), as stored: `S` for one requested.",
+        type: "string"
+      },
       purpose: {
         description: "The purpose SIIPS records.",
         type: "string"
@@ -114175,6 +114476,108 @@ var schemaComponents = {
       }
     }
   },
+  VisoftAppointmentReceipt: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "reference",
+      "fileName",
+      "mediaType",
+      "sizeBytes",
+      "sha256",
+      "data"
+    ],
+    properties: {
+      reference: {
+        description: "The reference the receipt was printed for.",
+        type: "string"
+      },
+      fileName: {
+        description: "A file name made of the appointment's day and hour; never the patient's.",
+        type: "string"
+      },
+      mediaType: {
+        const: "application/pdf",
+        type: "string"
+      },
+      sizeBytes: {
+        minimum: 1,
+        type: "integer"
+      },
+      sha256: {
+        pattern: "^[0-9a-f]{64}$",
+        description: "The SHA-256 of the bytes, hexadecimal.",
+        type: "string"
+      },
+      data: {
+        contentEncoding: "base64",
+        description: "The PDF, unchanged, base64.",
+        type: "string"
+      }
+    }
+  },
+  VisoftAppointmentReceiptResponse: {
+    type: "object",
+    description: "A successful answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          true
+        ]
+      },
+      data: {
+        $ref: "#/components/schemas/VisoftAppointmentReceipt"
+      },
+      error: {
+        const: null
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  VisoftAppointmentReceiptUnavailableFailure: {
+    type: "object",
+    description: "SIIPS printed no receipt naming this appointment's day, hour and patient. Read the day's appointments again for a current reference.",
+    additionalProperties: false,
+    required: [
+      "code",
+      "message",
+      "retryable",
+      "data"
+    ],
+    properties: {
+      code: {
+        type: "string",
+        enum: [
+          "APPOINTMENT_RECEIPT_UNAVAILABLE"
+        ],
+        description: "The failure code, stable across releases."
+      },
+      message: {
+        type: "string",
+        description: "What went wrong, for people; it never contains input values."
+      },
+      retryable: {
+        type: "boolean",
+        enum: [
+          false
+        ],
+        description: "Whether repeating the same request may succeed."
+      },
+      data: {
+        $ref: "#/components/schemas/Empty"
+      }
+    }
+  },
   VisoftAppointmentReferenceInvalidFailure: {
     type: "object",
     description: "The reference is not one a patient's appointments answered. Nothing was cancelled.",
@@ -114270,6 +114673,7 @@ var schemaComponents = {
       "patientName",
       "phone",
       "service",
+      "status",
       "attended"
     ],
     properties: {
@@ -114304,6 +114708,10 @@ var schemaComponents = {
       service: {
         type: "string"
       },
+      status: {
+        description: "SIIPS's state of the appointment (its agenda's Estado), as stored: `S` for one requested and still to be attended.",
+        type: "string"
+      },
       attended: {
         description: "SIIPS's attendance flag, as stored.",
         type: "string"
@@ -117145,6 +117553,164 @@ var schemaComponents = {
       }
     }
   },
+  VisoftLookupAppointmentReceiptBadGatewayError: {
+    type: "object",
+    description: "A failed answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          false
+        ]
+      },
+      data: {
+        const: null
+      },
+      error: {
+        $ref: "#/components/schemas/VisoftLookupAppointmentReceiptBadGatewayFailure"
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptBadGatewayFailure: {
+    oneOf: [
+      {
+        $ref: "#/components/schemas/OutcomeUnknownFailure"
+      },
+      {
+        $ref: "#/components/schemas/VisoftProviderUnavailableFailure"
+      }
+    ],
+    discriminator: {
+      propertyName: "code",
+      mapping: {
+        OUTCOME_UNKNOWN: "#/components/schemas/OutcomeUnknownFailure",
+        PROVIDER_UNAVAILABLE: "#/components/schemas/VisoftProviderUnavailableFailure"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptBody: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "reference"
+    ],
+    properties: {
+      connectionId: {
+        minLength: 5,
+        maxLength: 68,
+        pattern: "^con_[0-9A-Za-z]+$",
+        description: "The connection to run on. Optional when the organization has one Visoft connection; required when it has several. Another organization's connection is CONNECTION_NOT_FOUND.",
+        type: "string"
+      },
+      reference: {
+        minLength: 1,
+        maxLength: 300,
+        pattern: "^[A-Za-z0-9:._-]+(?:=[A-Za-z0-9:._-]*){8,24}$",
+        description: "The appointment's opaque reference, as visoft.appointments.list answered it.",
+        type: "string"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptNotFoundError: {
+    type: "object",
+    description: "A failed answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          false
+        ]
+      },
+      data: {
+        const: null
+      },
+      error: {
+        $ref: "#/components/schemas/VisoftLookupAppointmentReceiptNotFoundFailure"
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptNotFoundFailure: {
+    oneOf: [
+      {
+        $ref: "#/components/schemas/ConnectionNotFoundFailure"
+      },
+      {
+        $ref: "#/components/schemas/VisoftAppointmentReceiptUnavailableFailure"
+      }
+    ],
+    discriminator: {
+      propertyName: "code",
+      mapping: {
+        CONNECTION_NOT_FOUND: "#/components/schemas/ConnectionNotFoundFailure",
+        APPOINTMENT_RECEIPT_UNAVAILABLE: "#/components/schemas/VisoftAppointmentReceiptUnavailableFailure"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptUnprocessableContentError: {
+    type: "object",
+    description: "A failed answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          false
+        ]
+      },
+      data: {
+        const: null
+      },
+      error: {
+        $ref: "#/components/schemas/VisoftLookupAppointmentReceiptUnprocessableContentFailure"
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  VisoftLookupAppointmentReceiptUnprocessableContentFailure: {
+    oneOf: [
+      {
+        $ref: "#/components/schemas/VisoftCredentialsRejectedFailure"
+      },
+      {
+        $ref: "#/components/schemas/VisoftAgencyNotServedFailure"
+      }
+    ],
+    discriminator: {
+      propertyName: "code",
+      mapping: {
+        CREDENTIALS_REJECTED: "#/components/schemas/VisoftCredentialsRejectedFailure",
+        AGENCY_NOT_SERVED: "#/components/schemas/VisoftAgencyNotServedFailure"
+      }
+    }
+  },
   VisoftLookupAvailabilityBadGatewayError: {
     type: "object",
     description: "A failed answer.",
@@ -128434,11 +129000,11 @@ var schemaComponents = {
         type: "string"
       },
       expand: {
-        description: "Related data to include, comma-separated: `recipients`, `readiness`.",
+        description: "Related data to include, comma-separated: `recipients`, `readiness`, `results`.",
         examples: [
-          "recipients,readiness"
+          "recipients,readiness,results"
         ],
-        pattern: "^(recipients|readiness)(,(recipients|readiness))*$",
+        pattern: "^(recipients|readiness|results)(,(recipients|readiness|results))*$",
         type: "string"
       },
       recipientsCursor: {
@@ -128473,6 +129039,11 @@ var schemaComponents = {
         minLength: 1,
         type: "string"
       },
+      recipientsResult: {
+        description: "With `expand=recipients`: `definitionKey=optionKey`, only those whose latest answer is that option; `definitionKey=`, only those with no answer yet.",
+        pattern: "^[a-z][a-z0-9_]{0,63}=([a-z][a-z0-9_]{0,63})?$",
+        type: "string"
+      },
       recipientsStatus: {
         description: "`pending`: waiting for its (next) call or message. `in_progress`: being called, or on WhatsApp waiting for a reply until a reminder is due. `completed`: an attempt succeeded; on WhatsApp, the message arrived. `failed`: its attempts ran out, or it cannot be reached.",
         anyOf: [
@@ -128692,6 +129263,23 @@ var schemaComponents = {
       }
     }
   },
+  RaizCampaignsStartInput: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "campaignId"
+    ],
+    properties: {
+      campaignId: {
+        description: "Campaign id.",
+        examples: [
+          "cmp_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^cmp_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$",
+        type: "string"
+      }
+    }
+  },
   RaizChangesListInput: {
     type: "object",
     properties: {
@@ -135431,6 +136019,29 @@ var schemaComponents = {
       }
     }
   },
+  VisoftAppointmentReceiptsLookupInput: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "reference"
+    ],
+    properties: {
+      connectionId: {
+        minLength: 5,
+        maxLength: 68,
+        pattern: "^con_[0-9A-Za-z]+$",
+        description: "The connection to run on. Optional when the organization has one Visoft connection; required when it has several. Another organization's connection is CONNECTION_NOT_FOUND.",
+        type: "string"
+      },
+      reference: {
+        minLength: 1,
+        maxLength: 300,
+        pattern: "^[A-Za-z0-9:._-]+(?:=[A-Za-z0-9:._-]*){8,24}$",
+        description: "The appointment's opaque reference, as visoft.appointments.list answered it.",
+        type: "string"
+      }
+    }
+  },
   VisoftAppointmentsCreateInput: {
     additionalProperties: false,
     type: "object",
@@ -136548,9 +137159,9 @@ var schemaComponents = {
 // src/generated/generation.json
 var generation_default = {
   formatVersion: 6,
-  release: "1.20261106.171439",
-  openapiSha256: "3dde2e71d41c041ea8a06dcad793712321720bccfd252ba901b8575274e4d042",
-  openapiContentSha256: "e7c2c8058a6f848070f1d5933ea788446ac39acb99aa97b4f6eed2f83162f71f",
+  release: "1.20261106.211734",
+  openapiSha256: "4175207787b9909be1c8404cfc24c4f18230bf12e8fd96074241b11a8a928863",
+  openapiContentSha256: "ef2bacbc6bbda25bcbb2bb78972e717f3a5d4e7efef6d308b1f5718f2c08a2ff",
   forge: {
     repository: "https://github.com/cloudflare/forge",
     commit: "7f86447210b7bea3779bfdab3cd5655eade0eadb",
@@ -136563,7 +137174,7 @@ var generation_default = {
   outputs: [
     {
       path: "src/generated/commands.ts",
-      sha256: "6ae733a2be6cc4395d26c710ecbfe0ac6c569f63abcb4630629aa45cef3aeec5"
+      sha256: "d69498a3fbbf7bb5af95810cd76ba97eecd5dfb668a53df88d0c20e8c6db499a"
     }
   ]
 };
@@ -138163,7 +138774,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "3.41.0";
+var VERSION = "3.43.0";
 var RELEASE = generation_default.release;
 var commands2 = { ...commands, ...accountOperatorCommands };
 var SDK_PATHS = new Map(Object.values(commands2).map((command) => [command.operation, command.sdkPath]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbol-ai/cli",
-  "version": "3.41.0",
+  "version": "3.43.0",
   "description": "The Arbol CLI: the Arbol API from your terminal, with commands generated by Cloudflare Forge from the public OpenAPI.",
   "keywords": [
     "arbol",
@@ -45,7 +45,7 @@
     "verify:with-tests": "bun run typecheck && bun run test && bun run build"
   },
   "dependencies": {
-    "@arbol-ai/sdk": "5.41.0",
+    "@arbol-ai/sdk": "5.43.0",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "oauth4webapi": "3.8.8"
@@ -60,8 +60,8 @@
   "packageManager": "bun@1.4.3",
   "arbol": {
     "openapi": {
-      "release": "1.20261106.171439",
-      "sha256": "e7c2c8058a6f848070f1d5933ea788446ac39acb99aa97b4f6eed2f83162f71f"
+      "release": "1.20261106.211734",
+      "sha256": "ef2bacbc6bbda25bcbb2bb78972e717f3a5d4e7efef6d308b1f5718f2c08a2ff"
     }
   }
 }