@arbol-ai/cli 3.13.0 → 3.15.0

package/dist/index.js

@@ -14213,12 +14213,12 @@ var commands = {
             }
           ]
         },
-        integrationSkills: {
-          description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+        integrationProcedures: {
+          description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
           maxItems: 32,
           type: "array",
           items: {
-            $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+            $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
           }
         },
         integrationTools: {
@@ -14251,18 +14251,18 @@ var commands = {
           pattern: "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
           type: "string"
         },
-        settings: {
-          $ref: "#/components/schemas/RaizAgentSettingsInput",
-          description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
-        },
-        skills: {
-          maxItems: 32,
-          description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
+        procedures: {
+          description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+          maxItems: 64,
           type: "array",
           items: {
-            $ref: "#/components/schemas/RaizAgentSkill"
+            $ref: "#/components/schemas/RaizAgentProcedureInput"
           }
         },
+        settings: {
+          $ref: "#/components/schemas/RaizAgentSettingsInput",
+          description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
+        },
         status: {
           description: "A paused Agent answers nothing and places no calls.",
           anyOf: [
@@ -14313,7 +14313,7 @@ var commands = {
       }
     },
     title: "Create an Agent",
-    description: "Create an Agent that talks to the organization's contacts. Choose `modality` (`voice`: phone calls; `text`: WhatsApp and web chat) and a `name`; then give it `instructions` (role, goal, limits), and optionally a `firstMessage`, `language`, `timeZone`, `settings`, Knowledge (`knowledgeDocumentIds` of ready documents from `list_knowledge_documents`) and `integrationTools` (connection + tool pairs of the organization's connections in Account, checked live: INTEGRATION_TOOL_UNAVAILABLE), and for a text Agent `integrationSkills` (connection + skill pairs a connection publishes, checked live: INTEGRATION_SKILL_UNAVAILABLE). Next: assign it to a channel with `update_channel`; a voice Agent is published in the background, so check `synced` with `get_agent`. Read the `create-agent` skill (`get_skill`) first.",
+    description: "Create an Agent that talks to the organization's contacts. Choose `modality` (`voice`: phone calls; `text`: WhatsApp and web chat) and a `name`; then give it `instructions` (role, goal, limits), and optionally a `firstMessage`, `language`, `timeZone`, `settings`, Knowledge (`knowledgeDocumentIds` of ready documents from `list_knowledge_documents`) and `integrationTools` (connection + tool pairs of the organization's connections in Account, checked live: INTEGRATION_TOOL_UNAVAILABLE), `procedures` (each a trigger plus free-form Markdown or structured steps, with inline references to the Agent's tools, Knowledge and other procedures: AGENT_PROCEDURES_INVALID says where one is wrong), and for a text Agent `integrationProcedures` (connection + procedure pairs a connection publishes, checked live: INTEGRATION_PROCEDURE_UNAVAILABLE). Next: assign it to a channel with `update_channel`; a voice Agent is published in the background, so check `synced` with `get_agent`. Read the `create-agent` skill (`get_skill`) first.",
     effect: "write",
     confirmation: null,
     hidden: false
@@ -14345,7 +14345,7 @@ var commands = {
       additionalProperties: false
     },
     title: "Get an Agent",
-    description: "Read one Agent's complete setup: instructions, first message, language, time zone, settings, integration tools (each with its connection and effect), Knowledge document ids, text-only skills and their references, and channels. `ready` says whether it can hold conversations; for a voice Agent, `synced` says whether its phone line already runs this version, and `syncErrorCode` why not. Read it before `update_agent` and send its `version` as `expectedVersion`.",
+    description: "Read one Agent's complete setup: instructions, first message, language, time zone, settings, integration tools (each with its connection and effect), Knowledge document ids, procedures (trigger plus free-form instructions or structured steps) and connection procedures, and channels. `ready` says whether it can hold conversations; for a voice Agent, `synced` says whether its phone line already runs this version, and `syncErrorCode` why not. Read it before `update_agent` and send its `version` as `expectedVersion`.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -14624,12 +14624,12 @@ var commands = {
             }
           ]
         },
-        integrationSkills: {
-          description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+        integrationProcedures: {
+          description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
           maxItems: 32,
           type: "array",
           items: {
-            $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+            $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
           }
         },
         integrationTools: {
@@ -14662,18 +14662,18 @@ var commands = {
           pattern: "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
           type: "string"
         },
-        settings: {
-          $ref: "#/components/schemas/RaizAgentSettingsInput",
-          description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
-        },
-        skills: {
-          maxItems: 32,
-          description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
+        procedures: {
+          description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+          maxItems: 64,
           type: "array",
           items: {
-            $ref: "#/components/schemas/RaizAgentSkill"
+            $ref: "#/components/schemas/RaizAgentProcedureInput"
           }
         },
+        settings: {
+          $ref: "#/components/schemas/RaizAgentSettingsInput",
+          description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
+        },
         status: {
           description: "A paused Agent answers nothing and places no calls.",
           anyOf: [
@@ -14745,7 +14745,7 @@ var commands = {
       }
     },
     title: "Update an Agent",
-    description: "Change an Agent: instructions, first message, name, language, time zone, settings, integration tools, Knowledge, text-only skills, connection skills or status. Omitted fields stay and `null` clears one; `settings`, `integrationTools`, `integrationSkills`, `skills` and `knowledgeDocumentIds` replace the whole value when given, so read the Agent with `get_agent` first and send its `version` as `expectedVersion` (VERSION_CONFLICT: read it again). `status: paused` stops it from answering and calling. `modality` changes only while it has no channels and no published voice line (AGENT_MODALITY_LOCKED). A voice Agent republishes in the background: check `synced`.",
+    description: "Change an Agent: instructions, first message, name, language, time zone, settings, integration tools, Knowledge, procedures, connection procedures or status. Omitted fields stay and `null` clears one; `settings`, `integrationTools`, `integrationProcedures`, `procedures` and `knowledgeDocumentIds` replace the whole value when given (keep each existing procedure's `id`), so read the Agent with `get_agent` first and send its `version` as `expectedVersion` (VERSION_CONFLICT: read it again). `status: paused` stops it from answering and calling. `modality` changes only while it has no channels and no published voice line (AGENT_MODALITY_LOCKED). A voice Agent republishes in the background: check `synced`.",
     effect: "write",
     confirmation: null,
     hidden: false
@@ -19820,7 +19820,7 @@ var commands = {
           type: "string"
         },
         candidate: {
-          description: "The candidate version: what changes in what the model reads. Omitted fields keep the live Agent's; `integrationSkills` and `skills` are complete sets, as in `updateAgent`.",
+          description: "The candidate version: what changes in what the model reads. Omitted fields keep the live Agent's; `integrationProcedures` and `procedures` are complete sets, as in `updateAgent`.",
           additionalProperties: false,
           type: "object",
           properties: {
@@ -19837,12 +19837,12 @@ var commands = {
                 }
               ]
             },
-            integrationSkills: {
-              description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+            integrationProcedures: {
+              description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
               maxItems: 32,
               type: "array",
               items: {
-                $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+                $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
               }
             },
             model: {
@@ -19873,6 +19873,14 @@ var commands = {
                 }
               ]
             },
+            procedures: {
+              description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+              maxItems: 64,
+              type: "array",
+              items: {
+                $ref: "#/components/schemas/RaizAgentProcedureInput"
+              }
+            },
             reasoningEffort: {
               anyOf: [
                 {
@@ -19904,14 +19912,6 @@ var commands = {
                   type: "null"
                 }
               ]
-            },
-            skills: {
-              maxItems: 32,
-              description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
-              type: "array",
-              items: {
-                $ref: "#/components/schemas/RaizAgentSkill"
-              }
             }
           }
         },
@@ -19946,7 +19946,7 @@ var commands = {
       }
     },
     title: "Replay evaluation cases on a candidate",
-    description: "With feedbackCaseId, prepare conditional guidance from that kept correction and test it with the Agent’s newest kept cases, always including the source. Do not combine feedbackCaseId with candidate or caseIds. This does not publish. Requires conversation read access. Voice Agents use a spoken-content rehearsal with an independent model (evaluationMode voice_text), not the live voice model, audio, interruptions or telephony. A person must review its applicability to calls before approval. Otherwise measure a candidate version on its kept evaluation cases before publishing it: the WhatsApp Agent rewrites each case's reply with the candidate's `instructions`, `skills`, `integrationSkills`, `model` and `reasoningEffort` (omitted ones stay as the live Agent has them), without running any integration tool (each answers with what it answered in the original conversation) and without sending anything; then a judge model compares each new reply with what the team expects. Replays every kept case, or `caseIds`, at most 50. It calls paid models, so it needs `confirmCost: true`. Follow it with `getEvalRun`; with the Agent's `settings.evalGate`, `updateAgent` publishes exactly this content with `evalRunId`. EVAL_CASES_UNAVAILABLE: no kept case to replay. Not an AI tool.",
+    description: "With feedbackCaseId, prepare conditional guidance from that kept correction and test it with the Agent’s newest kept cases, always including the source. Do not combine feedbackCaseId with candidate or caseIds. This does not publish. Requires conversation read access. Voice Agents use a spoken-content rehearsal with an independent model (evaluationMode voice_text), not the live voice model, audio, interruptions or telephony. A person must review its applicability to calls before approval. Otherwise measure a candidate version on its kept evaluation cases before publishing it: the WhatsApp Agent rewrites each case's reply with the candidate's `instructions`, `procedures`, `integrationProcedures`, `model` and `reasoningEffort` (omitted ones stay as the live Agent has them), without running any integration tool (each answers with what it answered in the original conversation) and without sending anything; then a judge model compares each new reply with what the team expects. Replays every kept case, or `caseIds`, at most 50. It calls paid models, so it needs `confirmCost: true`. Follow it with `getEvalRun`; with the Agent's `settings.evalGate`, `updateAgent` publishes exactly this content with `evalRunId`. EVAL_CASES_UNAVAILABLE: no kept case to replay. Not an AI tool.",
     effect: "write",
     confirmation: null,
     hidden: false
@@ -23263,7 +23263,7 @@ var commands = {
       }
     },
     title: "Look up an exact IPS invoice reference",
-    description: "Look up one exact invoice prefix and number in the active billing connection’s institution. Returns only the number of matching report rows. A successful empty report does not establish rejection, payment or a filing receipt.",
+    description: "Look up one exact invoice prefix and number in the active billing connection’s institution. Returns the number of matching rows. Outside the provider’s live reporting hours, REPORTING_WINDOW_CLOSED gives the opening hour (inclusive), closing hour (exclusive) and time zone. Payment or rejection requires separate evidence.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -67002,11 +67002,11 @@ var schemaComponents = {
       "version",
       "channels",
       "instructions",
-      "integrationSkills",
+      "integrationProcedures",
       "integrationTools",
       "knowledgeDocumentIds",
-      "settings",
-      "skills"
+      "procedures",
+      "settings"
     ],
     properties: {
       channelCount: {
@@ -67211,8 +67211,8 @@ var schemaComponents = {
           }
         ]
       },
-      integrationSkills: {
-        description: "The skills the Agent takes from its connections, each saved with the text its connection published then. Offered beside `skills`.",
+      integrationProcedures: {
+        description: "The procedures the Agent takes from its connections, each saved with the text its connection published then. They run as free-form procedures beside `procedures`.",
         maxItems: 32,
         type: "array",
         items: {
@@ -67221,7 +67221,7 @@ var schemaComponents = {
           required: [
             "connectionId",
             "digest",
-            "skill"
+            "procedure"
           ],
           properties: {
             connectionId: {
@@ -67232,13 +67232,13 @@ var schemaComponents = {
               type: "string"
             },
             digest: {
-              description: "The digest of the skill the Agent was saved with. When the connection's skill (`listConnections`) has another digest, it changed: the Agent keeps this text until it is saved again.",
+              description: "The digest of the procedure the Agent was saved with. When the connection's procedure (`listConnections`) has another digest, it changed: the Agent keeps this text until it is saved again.",
               maxLength: 64,
               minLength: 1,
               type: "string"
             },
-            skill: {
-              description: "The skill's name, as its connection lists it.",
+            procedure: {
+              description: "The procedure's name, as its connection lists it.",
               maxLength: 64,
               minLength: 1,
               pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
@@ -67315,16 +67315,16 @@ var schemaComponents = {
           type: "string"
         }
       },
-      settings: {
-        $ref: "#/components/schemas/RaizAgentSettings"
-      },
-      skills: {
-        maxItems: 32,
-        description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
+      procedures: {
+        description: "The Agent's procedures. The model reads only the triggers until a conversation matches one, then loads that procedure. In an update, the complete new set.",
+        maxItems: 64,
         type: "array",
         items: {
-          $ref: "#/components/schemas/RaizAgentSkill"
+          $ref: "#/components/schemas/RaizAgentProcedure"
         }
+      },
+      settings: {
+        $ref: "#/components/schemas/RaizAgentSettings"
       }
     }
   },
@@ -67399,12 +67399,12 @@ var schemaComponents = {
       }
     ]
   },
-  RaizAgentIntegrationSkillInput: {
+  RaizAgentIntegrationProcedureInput: {
     additionalProperties: false,
     type: "object",
     required: [
       "connectionId",
-      "skill"
+      "procedure"
     ],
     properties: {
       connectionId: {
@@ -67414,8 +67414,8 @@ var schemaComponents = {
         pattern: "^[A-Za-z0-9_-]+$",
         type: "string"
       },
-      skill: {
-        description: "The skill's name, as its connection lists it.",
+      procedure: {
+        description: "The procedure's name, as its connection lists it.",
         maxLength: 64,
         minLength: 1,
         pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
@@ -67540,451 +67540,2574 @@ var schemaComponents = {
       }
     }
   },
-  RaizAgentSettings: {
+  RaizAgentProcedure: {
     additionalProperties: false,
     type: "object",
     required: [
-      "humanEscalation",
-      "recoveryManager",
-      "automaticKnowledge",
-      "attachmentReader",
-      "budgetExhaustedMessage",
-      "closingMessage",
-      "evalGate",
-      "followUpAfterMinutes",
-      "followUpMessage",
-      "greeting",
-      "handoffMessage",
-      "humanReplyTimeoutMinutes",
-      "investigationsEnabled",
-      "model",
-      "modelTrial",
-      "monthlyTokenBudget",
-      "pauseOnHumanReply",
-      "policy",
-      "pollPendingOperations",
-      "reasoningEffort",
-      "replyChoices",
-      "sessionCloseAfterMinutes",
-      "temperature",
-      "toolDiscovery",
-      "voice"
+      "content",
+      "id",
+      "name",
+      "status",
+      "steps",
+      "trigger",
+      "type"
     ],
     properties: {
-      humanEscalation: {
-        anyOf: [
-          {
-            description: "Per-Agent human escalation policy. Instructions apply to voice and text. Null keeps the default instructions. A WhatsApp handoff stays with the team until a person explicitly resumes AI; no timeout resumes it.",
-            additionalProperties: false,
-            type: "object",
-            required: [
-              "instructions"
-            ],
-            properties: {
-              instructions: {
-                anyOf: [
-                  {
-                    maxLength: 4000,
-                    description: "When this Agent should ask the business's team to intervene, using only its available handoff capabilities. Null keeps the default instructions; an explicit request for a person is always respected.",
-                    type: "string"
-                  },
-                  {
-                    type: "null"
-                  }
-                ]
-              }
-            }
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      recoveryManager: {
-        anyOf: [
-          {
-            description: "Optional WhatsApp recovery advisor. Null or enabled=false disables it. A journaled evidence check precedes any paid review. One tool-free model call per turn before autonomous escalation or after terminal provider failure; unresolved terminal recovery hands off. Completed handoffs and conservatively recognized human requests bypass generation. Model selects the existing provider route. Prices must be conservative upper bounds including provider overhead; missing or invalid prices disable recovery. The cost bound covers only the advisor. No tools or automatic provider retries.",
-            additionalProperties: false,
-            type: "object",
-            required: [
-              "enabled",
-              "model",
-              "maxAttempts",
-              "timeoutMs",
-              "maxInputTokens",
-              "maxOutputTokens",
-              "maxCostUsd",
-              "inputUsdPerMillion",
-              "outputUsdPerMillion"
-            ],
-            properties: {
-              enabled: {
-                type: "boolean"
-              },
-              instructions: {
-                anyOf: [
-                  {
-                    maxLength: 4000,
-                    description: "Operator criteria for when the recovery advisor should help or leave the case to a person. They never override consent, tool permissions, unknown-write fences or an explicit human request. Null keeps the default criteria.",
-                    type: "string"
-                  },
-                  {
-                    type: "null"
-                  }
-                ]
-              },
-              advisorAgentId: {
-                anyOf: [
-                  {
-                    description: "Optional active text Agent in the same organization, other than this Agent, whose instructions and skills provide specialist guidance. The configured recovery model and cost bounds stay unchanged; no specialist tools or conversation history are accessed.",
-                    examples: [
-                      "agt_01m45h8q2rf3t9w6y7z0b1c2d3"
-                    ],
-                    pattern: "^agt_(?:[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"
-                  },
-                  {
-                    type: "null"
-                  }
-                ]
-              },
-              model: {
-                description: "`arbolito/agile`: quickest and least expensive, for direct conversations. `arbolito/balanced`: more deliberate answers at moderate cost. `arbolito/advanced`: strong reasoning for complex instructions and many tools, with an adjustable `reasoningEffort`. `arbolito/top`: the most capable, for the hardest cases, with an adjustable `reasoningEffort` up to `xhigh`. Every tier reads images and PDF documents.",
-                anyOf: [
-                  {
-                    const: "arbolito/agile",
-                    type: "string"
-                  },
-                  {
-                    const: "arbolito/balanced",
-                    type: "string"
-                  },
-                  {
-                    const: "arbolito/advanced",
-                    type: "string"
-                  },
-                  {
-                    const: "arbolito/top",
-                    type: "string"
-                  }
-                ]
-              },
-              maxAttempts: {
-                const: 1,
-                type: "number"
-              },
-              timeoutMs: {
-                minimum: 100,
-                maximum: 15000,
-                type: "integer"
-              },
-              maxInputTokens: {
-                minimum: 4096,
-                maximum: 131072,
-                type: "integer"
-              },
-              maxOutputTokens: {
-                minimum: 128,
-                maximum: 1024,
-                type: "integer"
-              },
-              maxCostUsd: {
-                exclusiveMinimum: 0,
-                maximum: 1,
-                type: "number"
-              },
-              inputUsdPerMillion: {
-                exclusiveMinimum: 0,
-                maximum: 1000,
-                type: "number"
-              },
-              outputUsdPerMillion: {
-                exclusiveMinimum: 0,
-                maximum: 1000,
-                type: "number"
-              }
-            }
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      automaticKnowledge: {
-        anyOf: [
-          {
-            description: "Text Agents. Retrieve relevant passages from this Agent's active Knowledge before a substantive contact message, without a model tool call. Null or false: on-demand search only. Does not store contact memories or learn unreviewed answers.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      attachmentReader: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp. Who reads an image or PDF when the Agent calls `read_attachment`: `vision` (a vision model describes and transcribes it, with a stronger one when the first reads nothing) or `ocr` (text recognition, which also answers the `fields` the Agent asks for, each null when absent or unclear; the vision model reads the file when recognition cannot). With `ocr` the Agent sees files as markers and reads them with `read_attachment`; with `vision`, tiers that read files themselves see the original. Null: `vision`.",
-            anyOf: [
-              {
-                const: "vision",
-                type: "string"
-              },
-              {
-                const: "ocr",
-                type: "string"
-              }
-            ]
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      budgetExhaustedMessage: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp. What the contact reads when the Agent has used its `monthlyTokenBudget`: the conversation then goes to the team, as an escalation does, and the Agent writes nothing until the budget is raised or the month ends. Null: `handoffMessage`, including an empty notice when disabled.",
-            maxLength: 1000,
-            minLength: 1,
-            type: "string"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      closingMessage: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp. After a reply that completed an action (an integration tool that changes data succeeded), explicitly finished the case with end_conversation and left nothing pending (no question, no offered choices, no handoff), a contact message that only thanks or closes («gracias», «ok», «listo», an emoji) gets this text at once, without the model; the Agent still reads both in its next turn. Write it in the Agent's language and ask nothing in it. Null: the Agent answers such messages itself.",
-            maxLength: 1000,
-            minLength: 1,
-            type: "string"
-          },
-          {
-            type: "null"
-          }
-        ]
+      content: {
+        description: 'Free-form procedures: what to do, in Markdown, with inline references such as `[tool id="buscar_citas"]`, `[kb id="kdc_…"]`, `[procedure id="prc_…"]`, `[system_tool id="end_conversation"]` and `{{contact_name}}`. Empty for structured procedures.',
+        maxLength: 50000,
+        type: "string"
       },
-      evalGate: {
-        anyOf: [
-          {
-            description: "Text and voice Agents. When true, an `updateAgent` that changes what the model reads (instructions, skills, connection skills, `model` or `reasoningEffort`) must send `evalRunId`: a completed `createEvalRun` of this Agent with exactly that content, in which every case passed (EVAL_GATE_UNMET otherwise). Null: no requirement.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
+      id: {
+        description: "The procedure's id (`prc_…`), stable for the Agent's life.",
+        examples: [
+          "prc_01k8f3w2pqv6xs9mhdr0tz7n3b"
+        ],
+        pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+        type: "string"
       },
-      followUpAfterMinutes: {
-        anyOf: [
-          {
-            description: "Text Agents. When the Agent spoke last and asked something, send `followUpMessage` once after this many minutes of silence (WhatsApp only, inside its 24-hour window). Null disables follow-ups.",
-            maximum: 1440,
-            minimum: 1,
-            type: "integer"
-          },
-          {
-            type: "null"
-          }
-        ]
+      name: {
+        description: "A short label for people. The model never reads it.",
+        maxLength: 120,
+        minLength: 1,
+        type: "string"
       },
-      followUpMessage: {
+      status: {
+        description: "A paused procedure runs on no channel.",
         anyOf: [
           {
-            description: "Text Agents. The follow-up text. Null uses a short default in the Agent's language.",
-            maxLength: 1000,
-            minLength: 1,
+            const: "active",
             type: "string"
           },
           {
-            type: "null"
-          }
-        ]
-      },
-      greeting: {
-        anyOf: [
-          {
-            $ref: "#/components/schemas/RaizAgentGreeting",
-            description: "Text Agents on WhatsApp. How the Agent answers when a contact opens a conversation and nobody from the business has answered it yet. Null: the Agent answers the first message with its own instructions alone."
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      handoffMessage: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp. The notice appended after an escalation or a requested human handoff. Null: the current localized review notice or the case-specific notice supplied under the Agent's instructions. An empty string disables the notice; the handoff and pause still happen. The model does not write this notice.",
-            maxLength: 1000,
+            const: "paused",
             type: "string"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      humanReplyTimeoutMinutes: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp. After a manual takeover, resume automatic replies when the contact's newest message waits this many minutes. An Agent handoff always stays with the team until a person explicitly resumes AI. Null: only a person resumes automatic replies.",
-            maximum: 1440,
-            minimum: 1,
-            type: "integer"
-          },
-          {
-            type: "null"
           }
         ]
       },
-      investigationsEnabled: {
-        anyOf: [
-          {
-            description: "Opt this Agent into internal root-cause investigations of tool failures, human escalations, failed outcomes and negative feedback. Incidents are grouped only with participating Agents in the same organization. Null or false: disabled. Turning this off stops new events and pending dispatch when no participating Agent remains; an already active investigation may finish.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      model: {
-        anyOf: [
-          {
-            description: "Text Agents. The tier that writes replies. `arbolito/agile`: quickest and least expensive, for direct conversations. `arbolito/balanced`: more deliberate answers at moderate cost. `arbolito/advanced`: strong reasoning for complex instructions and many tools, with an adjustable `reasoningEffort`. `arbolito/top`: the most capable, for the hardest cases, with an adjustable `reasoningEffort` up to `xhigh`. Every tier reads images and PDF documents. Null: the default, as `arbolito/agile`.",
-            anyOf: [
-              {
-                const: "arbolito/agile",
-                type: "string"
-              },
-              {
-                const: "arbolito/balanced",
-                type: "string"
-              },
-              {
-                const: "arbolito/advanced",
-                type: "string"
-              },
-              {
-                const: "arbolito/top",
-                type: "string"
+      steps: {
+        description: "Structured procedures: the steps, in order. Empty for free-form procedures.",
+        maxItems: 40,
+        type: "array",
+        items: {
+          anyOf: [
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "instruction",
+                "type"
+              ],
+              properties: {
+                instruction: {
+                  description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                type: {
+                  const: "ask",
+                  type: "string"
+                }
               }
-            ]
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      modelTrial: {
-        anyOf: [
-          {
-            $ref: "#/components/schemas/RaizAgentModelTrial",
-            description: "Text Agents on WhatsApp. Answer a stable share of the Agent's new conversations with another tier, to compare it with `model` on real traffic. A conversation keeps the tier its first reply used while the trial lasts (one already open when the trial starts stays on `model`); removing the trial returns every conversation to `model`. Null: no trial."
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      monthlyTokenBudget: {
-        anyOf: [
-          {
-            description: "Text Agents. Tokens (input, cached input included, plus output) the Agent may use per calendar month (UTC), on every channel. On WhatsApp, a reply that would start past it does not run: the contact reads `budgetExhaustedMessage` and the team continues; at 80 % the API logs an alert once a month. Null: no limit.",
-            maximum: 1000000000000,
-            minimum: 1e4,
-            type: "integer"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      pauseOnHumanReply: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp: pause automatic replies when a live WhatsApp Business App message that says something (not a reaction, an edit or a deletion) proves a person took over. Null: disabled. The recipient stays paused until resumed or until that conversation closes; their next conversation starts with the AI.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      policy: {
-        anyOf: [
-          {
-            $ref: "#/components/schemas/RaizAgentTurnPolicy",
-            description: "Text Agents on WhatsApp. Limits on each reply: model calls, output, writes per step, repeated reads, cached reads and deferred tools. Null keeps every default."
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      pollPendingOperations: {
-        anyOf: [
-          {
-            description: "Text Agents on WhatsApp: when a reply ends while an integration answered that its work is still pending (`status: pending` with an `operationId`) and the same connection offers `getOperation`, Raíz checks it again on its own and the Agent answers with the result, without waiting for the contact to write. Null: disabled.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      reasoningEffort: {
-        anyOf: [
-          {
-            description: "Text Agents whose tier reasons (`arbolito/advanced`, `arbolito/top`, or an Agent already running a model that reasons): `none` answers fastest, `high` deliberates most, and `xhigh`, on `arbolito/advanced` and `arbolito/top`, deliberates past it. Null: the tier's default. A tier that does not reason refuses it (AGENT_SETTINGS_INVALID).",
-            anyOf: [
-              {
-                const: "none",
-                type: "string"
-              },
-              {
-                const: "low",
-                type: "string"
-              },
-              {
-                const: "medium",
-                type: "string"
-              },
-              {
-                const: "high",
-                type: "string"
-              },
-              {
-                const: "xhigh",
-                type: "string"
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "instruction",
+                "type"
+              ],
+              properties: {
+                instruction: {
+                  description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                type: {
+                  const: "tell",
+                  type: "string"
+                }
               }
-            ]
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      replyChoices: {
-        anyOf: [
-          {
-            description: "Text Agents. Let the Agent offer tap-to-answer options (WhatsApp buttons and lists, web reply options). Null: allowed.",
-            type: "boolean"
-          },
-          {
-            type: "null"
-          }
-        ]
-      },
-      sessionCloseAfterMinutes: {
-        anyOf: [
-          {
-            description: "Text Agents. Close a conversation after this many minutes without messages. Null: 1440 on WhatsApp, 30 on web.",
-            maximum: 10080,
-            minimum: 5,
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "message",
+                "type"
+              ],
+              properties: {
+                message: {
+                  description: "What to say, word for word.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                translations: {
+                  description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                  type: "object",
+                  patternProperties: {
+                    "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                      maxLength: 2000,
+                      minLength: 1,
+                      type: "string"
+                    }
+                  }
+                },
+                type: {
+                  const: "say",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "tool",
+                "type"
+              ],
+              properties: {
+                arguments: {
+                  description: "Parameters whose value is fixed, by name; the model fills the others.",
+                  type: "object",
+                  patternProperties: {
+                    "^[A-Za-z0-9_.-]{1,128}$": {
+                      anyOf: [
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "value"
+                          ],
+                          properties: {
+                            value: {
+                              description: "Always this value."
+                            }
+                          }
+                        },
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "variable"
+                          ],
+                          properties: {
+                            variable: {
+                              description: "The current value of this runtime variable.",
+                              pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                              type: "string"
+                            }
+                          }
+                        },
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "omit"
+                          ],
+                          properties: {
+                            omit: {
+                              description: "Leave the parameter out of the call.",
+                              const: true,
+                              type: "boolean"
+                            }
+                          }
+                        }
+                      ]
+                    }
+                  }
+                },
+                instruction: {
+                  description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                  maxLength: 2000,
+                  type: "string"
+                },
+                onFailure: {
+                  description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                  maxItems: 40,
+                  type: "array",
+                  items: {
+                    anyOf: [
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "ask",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "tell",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "message",
+                          "type"
+                        ],
+                        properties: {
+                          message: {
+                            description: "What to say, word for word.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          translations: {
+                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                            type: "object",
+                            patternProperties: {
+                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                maxLength: 2000,
+                                minLength: 1,
+                                type: "string"
+                              }
+                            }
+                          },
+                          type: {
+                            const: "say",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "procedureId",
+                          "type"
+                        ],
+                        properties: {
+                          procedureId: {
+                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "procedure",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                        type: "object",
+                        required: [
+                          "type"
+                        ],
+                        properties: {
+                          type: {
+                            const: "end",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                        type: "object",
+                        required: [
+                          "maxRetries",
+                          "type"
+                        ],
+                        properties: {
+                          maxRetries: {
+                            description: "Calls of the tool after the first one.",
+                            maximum: 3,
+                            minimum: 1,
+                            type: "integer"
+                          },
+                          type: {
+                            const: "retry",
+                            type: "string"
+                          }
+                        }
+                      }
+                    ]
+                  }
+                },
+                tool: {
+                  description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                  pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                  type: "string"
+                },
+                type: {
+                  const: "tool",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              description: "The first condition that holds runs its steps; then the procedure continues after the branch.",
+              type: "object",
+              required: [
+                "branches",
+                "type"
+              ],
+              properties: {
+                branches: {
+                  maxItems: 8,
+                  minItems: 1,
+                  type: "array",
+                  items: {
+                    additionalProperties: false,
+                    type: "object",
+                    required: [
+                      "steps",
+                      "when"
+                    ],
+                    properties: {
+                      steps: {
+                        maxItems: 40,
+                        minItems: 1,
+                        type: "array",
+                        items: {
+                          anyOf: [
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "instruction",
+                                "type"
+                              ],
+                              properties: {
+                                instruction: {
+                                  description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "ask",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "instruction",
+                                "type"
+                              ],
+                              properties: {
+                                instruction: {
+                                  description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "tell",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "message",
+                                "type"
+                              ],
+                              properties: {
+                                message: {
+                                  description: "What to say, word for word.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                translations: {
+                                  description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                  type: "object",
+                                  patternProperties: {
+                                    "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                type: {
+                                  const: "say",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "tool",
+                                "type"
+                              ],
+                              properties: {
+                                arguments: {
+                                  description: "Parameters whose value is fixed, by name; the model fills the others.",
+                                  type: "object",
+                                  patternProperties: {
+                                    "^[A-Za-z0-9_.-]{1,128}$": {
+                                      anyOf: [
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "value"
+                                          ],
+                                          properties: {
+                                            value: {
+                                              description: "Always this value."
+                                            }
+                                          }
+                                        },
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "variable"
+                                          ],
+                                          properties: {
+                                            variable: {
+                                              description: "The current value of this runtime variable.",
+                                              pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                                              type: "string"
+                                            }
+                                          }
+                                        },
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "omit"
+                                          ],
+                                          properties: {
+                                            omit: {
+                                              description: "Leave the parameter out of the call.",
+                                              const: true,
+                                              type: "boolean"
+                                            }
+                                          }
+                                        }
+                                      ]
+                                    }
+                                  }
+                                },
+                                instruction: {
+                                  description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                                  maxLength: 2000,
+                                  type: "string"
+                                },
+                                onFailure: {
+                                  description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                                  maxItems: 40,
+                                  type: "array",
+                                  items: {
+                                    anyOf: [
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "instruction",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          instruction: {
+                                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "ask",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "instruction",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          instruction: {
+                                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "tell",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "message",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          message: {
+                                            description: "What to say, word for word.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          translations: {
+                                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                            type: "object",
+                                            patternProperties: {
+                                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                                maxLength: 2000,
+                                                minLength: 1,
+                                                type: "string"
+                                              }
+                                            }
+                                          },
+                                          type: {
+                                            const: "say",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "procedureId",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          procedureId: {
+                                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "procedure",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                                        type: "object",
+                                        required: [
+                                          "type"
+                                        ],
+                                        properties: {
+                                          type: {
+                                            const: "end",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                                        type: "object",
+                                        required: [
+                                          "maxRetries",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          maxRetries: {
+                                            description: "Calls of the tool after the first one.",
+                                            maximum: 3,
+                                            minimum: 1,
+                                            type: "integer"
+                                          },
+                                          type: {
+                                            const: "retry",
+                                            type: "string"
+                                          }
+                                        }
+                                      }
+                                    ]
+                                  }
+                                },
+                                tool: {
+                                  description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                                  pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "tool",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "procedureId",
+                                "type"
+                              ],
+                              properties: {
+                                procedureId: {
+                                  description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                  pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "procedure",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                              type: "object",
+                              required: [
+                                "type"
+                              ],
+                              properties: {
+                                type: {
+                                  const: "end",
+                                  type: "string"
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      when: {
+                        description: "A condition the Agent judges from the conversation, such as: The contact says the order already shipped.",
+                        maxLength: 2000,
+                        minLength: 1,
+                        type: "string"
+                      }
+                    }
+                  }
+                },
+                otherwise: {
+                  description: "What to do when no condition holds; omitted or empty continues.",
+                  maxItems: 40,
+                  type: "array",
+                  items: {
+                    anyOf: [
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "ask",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "tell",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "message",
+                          "type"
+                        ],
+                        properties: {
+                          message: {
+                            description: "What to say, word for word.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          translations: {
+                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                            type: "object",
+                            patternProperties: {
+                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                maxLength: 2000,
+                                minLength: 1,
+                                type: "string"
+                              }
+                            }
+                          },
+                          type: {
+                            const: "say",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "tool",
+                          "type"
+                        ],
+                        properties: {
+                          arguments: {
+                            description: "Parameters whose value is fixed, by name; the model fills the others.",
+                            type: "object",
+                            patternProperties: {
+                              "^[A-Za-z0-9_.-]{1,128}$": {
+                                anyOf: [
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "value"
+                                    ],
+                                    properties: {
+                                      value: {
+                                        description: "Always this value."
+                                      }
+                                    }
+                                  },
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "variable"
+                                    ],
+                                    properties: {
+                                      variable: {
+                                        description: "The current value of this runtime variable.",
+                                        pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                                        type: "string"
+                                      }
+                                    }
+                                  },
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "omit"
+                                    ],
+                                    properties: {
+                                      omit: {
+                                        description: "Leave the parameter out of the call.",
+                                        const: true,
+                                        type: "boolean"
+                                      }
+                                    }
+                                  }
+                                ]
+                              }
+                            }
+                          },
+                          instruction: {
+                            description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                            maxLength: 2000,
+                            type: "string"
+                          },
+                          onFailure: {
+                            description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                            maxItems: 40,
+                            type: "array",
+                            items: {
+                              anyOf: [
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "instruction",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    instruction: {
+                                      description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "ask",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "instruction",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    instruction: {
+                                      description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "tell",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "message",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    message: {
+                                      description: "What to say, word for word.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    translations: {
+                                      description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                      type: "object",
+                                      patternProperties: {
+                                        "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                          maxLength: 2000,
+                                          minLength: 1,
+                                          type: "string"
+                                        }
+                                      }
+                                    },
+                                    type: {
+                                      const: "say",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "procedureId",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    procedureId: {
+                                      description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                      pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "procedure",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                                  type: "object",
+                                  required: [
+                                    "type"
+                                  ],
+                                  properties: {
+                                    type: {
+                                      const: "end",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                                  type: "object",
+                                  required: [
+                                    "maxRetries",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    maxRetries: {
+                                      description: "Calls of the tool after the first one.",
+                                      maximum: 3,
+                                      minimum: 1,
+                                      type: "integer"
+                                    },
+                                    type: {
+                                      const: "retry",
+                                      type: "string"
+                                    }
+                                  }
+                                }
+                              ]
+                            }
+                          },
+                          tool: {
+                            description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                            pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "tool",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "procedureId",
+                          "type"
+                        ],
+                        properties: {
+                          procedureId: {
+                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "procedure",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                        type: "object",
+                        required: [
+                          "type"
+                        ],
+                        properties: {
+                          type: {
+                            const: "end",
+                            type: "string"
+                          }
+                        }
+                      }
+                    ]
+                  }
+                },
+                type: {
+                  const: "branch",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "procedureId",
+                "type"
+              ],
+              properties: {
+                procedureId: {
+                  description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                  pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                  type: "string"
+                },
+                type: {
+                  const: "procedure",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+              type: "object",
+              required: [
+                "type"
+              ],
+              properties: {
+                type: {
+                  const: "end",
+                  type: "string"
+                }
+              }
+            }
+          ]
+        }
+      },
+      trigger: {
+        description: "When it applies, from the contact's side: When the contact asks to book or move an appointment. Empty makes a sub-procedure, which only runs when another procedure references it.",
+        maxLength: 1000,
+        type: "string"
+      },
+      type: {
+        description: "`free_form`: instructions the Agent adapts. `structured`: steps that run the same way every time. Fixed once created.",
+        anyOf: [
+          {
+            const: "free_form",
+            type: "string"
+          },
+          {
+            const: "structured",
+            type: "string"
+          }
+        ]
+      }
+    }
+  },
+  RaizAgentProcedureInput: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "name",
+      "type"
+    ],
+    properties: {
+      content: {
+        description: 'Free-form procedures: what to do, in Markdown, with inline references such as `[tool id="buscar_citas"]`, `[kb id="kdc_…"]`, `[procedure id="prc_…"]`, `[system_tool id="end_conversation"]` and `{{contact_name}}`. Empty for structured procedures.',
+        maxLength: 50000,
+        type: "string"
+      },
+      id: {
+        description: "The procedure's id (`prc_…`), stable for the Agent's life.",
+        examples: [
+          "prc_01k8f3w2pqv6xs9mhdr0tz7n3b"
+        ],
+        pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+        type: "string"
+      },
+      name: {
+        description: "A short label for people. The model never reads it.",
+        maxLength: 120,
+        minLength: 1,
+        type: "string"
+      },
+      status: {
+        description: "A paused procedure runs on no channel.",
+        anyOf: [
+          {
+            const: "active",
+            type: "string"
+          },
+          {
+            const: "paused",
+            type: "string"
+          }
+        ]
+      },
+      steps: {
+        description: "Structured procedures: the steps, in order. Empty for free-form procedures.",
+        maxItems: 40,
+        type: "array",
+        items: {
+          anyOf: [
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "instruction",
+                "type"
+              ],
+              properties: {
+                instruction: {
+                  description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                type: {
+                  const: "ask",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "instruction",
+                "type"
+              ],
+              properties: {
+                instruction: {
+                  description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                type: {
+                  const: "tell",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "message",
+                "type"
+              ],
+              properties: {
+                message: {
+                  description: "What to say, word for word.",
+                  maxLength: 2000,
+                  minLength: 1,
+                  type: "string"
+                },
+                translations: {
+                  description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                  type: "object",
+                  patternProperties: {
+                    "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                      maxLength: 2000,
+                      minLength: 1,
+                      type: "string"
+                    }
+                  }
+                },
+                type: {
+                  const: "say",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "tool",
+                "type"
+              ],
+              properties: {
+                arguments: {
+                  description: "Parameters whose value is fixed, by name; the model fills the others.",
+                  type: "object",
+                  patternProperties: {
+                    "^[A-Za-z0-9_.-]{1,128}$": {
+                      anyOf: [
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "value"
+                          ],
+                          properties: {
+                            value: {
+                              description: "Always this value."
+                            }
+                          }
+                        },
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "variable"
+                          ],
+                          properties: {
+                            variable: {
+                              description: "The current value of this runtime variable.",
+                              pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                              type: "string"
+                            }
+                          }
+                        },
+                        {
+                          additionalProperties: false,
+                          type: "object",
+                          required: [
+                            "omit"
+                          ],
+                          properties: {
+                            omit: {
+                              description: "Leave the parameter out of the call.",
+                              const: true,
+                              type: "boolean"
+                            }
+                          }
+                        }
+                      ]
+                    }
+                  }
+                },
+                instruction: {
+                  description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                  maxLength: 2000,
+                  type: "string"
+                },
+                onFailure: {
+                  description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                  maxItems: 40,
+                  type: "array",
+                  items: {
+                    anyOf: [
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "ask",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "tell",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "message",
+                          "type"
+                        ],
+                        properties: {
+                          message: {
+                            description: "What to say, word for word.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          translations: {
+                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                            type: "object",
+                            patternProperties: {
+                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                maxLength: 2000,
+                                minLength: 1,
+                                type: "string"
+                              }
+                            }
+                          },
+                          type: {
+                            const: "say",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "procedureId",
+                          "type"
+                        ],
+                        properties: {
+                          procedureId: {
+                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "procedure",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                        type: "object",
+                        required: [
+                          "type"
+                        ],
+                        properties: {
+                          type: {
+                            const: "end",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                        type: "object",
+                        required: [
+                          "maxRetries",
+                          "type"
+                        ],
+                        properties: {
+                          maxRetries: {
+                            description: "Calls of the tool after the first one.",
+                            maximum: 3,
+                            minimum: 1,
+                            type: "integer"
+                          },
+                          type: {
+                            const: "retry",
+                            type: "string"
+                          }
+                        }
+                      }
+                    ]
+                  }
+                },
+                tool: {
+                  description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                  pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                  type: "string"
+                },
+                type: {
+                  const: "tool",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              description: "The first condition that holds runs its steps; then the procedure continues after the branch.",
+              type: "object",
+              required: [
+                "branches",
+                "type"
+              ],
+              properties: {
+                branches: {
+                  maxItems: 8,
+                  minItems: 1,
+                  type: "array",
+                  items: {
+                    additionalProperties: false,
+                    type: "object",
+                    required: [
+                      "steps",
+                      "when"
+                    ],
+                    properties: {
+                      steps: {
+                        maxItems: 40,
+                        minItems: 1,
+                        type: "array",
+                        items: {
+                          anyOf: [
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "instruction",
+                                "type"
+                              ],
+                              properties: {
+                                instruction: {
+                                  description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "ask",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "instruction",
+                                "type"
+                              ],
+                              properties: {
+                                instruction: {
+                                  description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "tell",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "message",
+                                "type"
+                              ],
+                              properties: {
+                                message: {
+                                  description: "What to say, word for word.",
+                                  maxLength: 2000,
+                                  minLength: 1,
+                                  type: "string"
+                                },
+                                translations: {
+                                  description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                  type: "object",
+                                  patternProperties: {
+                                    "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                type: {
+                                  const: "say",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "tool",
+                                "type"
+                              ],
+                              properties: {
+                                arguments: {
+                                  description: "Parameters whose value is fixed, by name; the model fills the others.",
+                                  type: "object",
+                                  patternProperties: {
+                                    "^[A-Za-z0-9_.-]{1,128}$": {
+                                      anyOf: [
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "value"
+                                          ],
+                                          properties: {
+                                            value: {
+                                              description: "Always this value."
+                                            }
+                                          }
+                                        },
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "variable"
+                                          ],
+                                          properties: {
+                                            variable: {
+                                              description: "The current value of this runtime variable.",
+                                              pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                                              type: "string"
+                                            }
+                                          }
+                                        },
+                                        {
+                                          additionalProperties: false,
+                                          type: "object",
+                                          required: [
+                                            "omit"
+                                          ],
+                                          properties: {
+                                            omit: {
+                                              description: "Leave the parameter out of the call.",
+                                              const: true,
+                                              type: "boolean"
+                                            }
+                                          }
+                                        }
+                                      ]
+                                    }
+                                  }
+                                },
+                                instruction: {
+                                  description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                                  maxLength: 2000,
+                                  type: "string"
+                                },
+                                onFailure: {
+                                  description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                                  maxItems: 40,
+                                  type: "array",
+                                  items: {
+                                    anyOf: [
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "instruction",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          instruction: {
+                                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "ask",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "instruction",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          instruction: {
+                                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "tell",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "message",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          message: {
+                                            description: "What to say, word for word.",
+                                            maxLength: 2000,
+                                            minLength: 1,
+                                            type: "string"
+                                          },
+                                          translations: {
+                                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                            type: "object",
+                                            patternProperties: {
+                                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                                maxLength: 2000,
+                                                minLength: 1,
+                                                type: "string"
+                                              }
+                                            }
+                                          },
+                                          type: {
+                                            const: "say",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        type: "object",
+                                        required: [
+                                          "procedureId",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          procedureId: {
+                                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                            type: "string"
+                                          },
+                                          type: {
+                                            const: "procedure",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                                        type: "object",
+                                        required: [
+                                          "type"
+                                        ],
+                                        properties: {
+                                          type: {
+                                            const: "end",
+                                            type: "string"
+                                          }
+                                        }
+                                      },
+                                      {
+                                        additionalProperties: false,
+                                        description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                                        type: "object",
+                                        required: [
+                                          "maxRetries",
+                                          "type"
+                                        ],
+                                        properties: {
+                                          maxRetries: {
+                                            description: "Calls of the tool after the first one.",
+                                            maximum: 3,
+                                            minimum: 1,
+                                            type: "integer"
+                                          },
+                                          type: {
+                                            const: "retry",
+                                            type: "string"
+                                          }
+                                        }
+                                      }
+                                    ]
+                                  }
+                                },
+                                tool: {
+                                  description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                                  pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "tool",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              type: "object",
+                              required: [
+                                "procedureId",
+                                "type"
+                              ],
+                              properties: {
+                                procedureId: {
+                                  description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                  pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                  type: "string"
+                                },
+                                type: {
+                                  const: "procedure",
+                                  type: "string"
+                                }
+                              }
+                            },
+                            {
+                              additionalProperties: false,
+                              description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                              type: "object",
+                              required: [
+                                "type"
+                              ],
+                              properties: {
+                                type: {
+                                  const: "end",
+                                  type: "string"
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      when: {
+                        description: "A condition the Agent judges from the conversation, such as: The contact says the order already shipped.",
+                        maxLength: 2000,
+                        minLength: 1,
+                        type: "string"
+                      }
+                    }
+                  }
+                },
+                otherwise: {
+                  description: "What to do when no condition holds; omitted or empty continues.",
+                  maxItems: 40,
+                  type: "array",
+                  items: {
+                    anyOf: [
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "ask",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "instruction",
+                          "type"
+                        ],
+                        properties: {
+                          instruction: {
+                            description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          type: {
+                            const: "tell",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "message",
+                          "type"
+                        ],
+                        properties: {
+                          message: {
+                            description: "What to say, word for word.",
+                            maxLength: 2000,
+                            minLength: 1,
+                            type: "string"
+                          },
+                          translations: {
+                            description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                            type: "object",
+                            patternProperties: {
+                              "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                maxLength: 2000,
+                                minLength: 1,
+                                type: "string"
+                              }
+                            }
+                          },
+                          type: {
+                            const: "say",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "tool",
+                          "type"
+                        ],
+                        properties: {
+                          arguments: {
+                            description: "Parameters whose value is fixed, by name; the model fills the others.",
+                            type: "object",
+                            patternProperties: {
+                              "^[A-Za-z0-9_.-]{1,128}$": {
+                                anyOf: [
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "value"
+                                    ],
+                                    properties: {
+                                      value: {
+                                        description: "Always this value."
+                                      }
+                                    }
+                                  },
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "variable"
+                                    ],
+                                    properties: {
+                                      variable: {
+                                        description: "The current value of this runtime variable.",
+                                        pattern: "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
+                                        type: "string"
+                                      }
+                                    }
+                                  },
+                                  {
+                                    additionalProperties: false,
+                                    type: "object",
+                                    required: [
+                                      "omit"
+                                    ],
+                                    properties: {
+                                      omit: {
+                                        description: "Leave the parameter out of the call.",
+                                        const: true,
+                                        type: "boolean"
+                                      }
+                                    }
+                                  }
+                                ]
+                              }
+                            }
+                          },
+                          instruction: {
+                            description: "How to fill the tool's parameters; omitted leaves it to the model.",
+                            maxLength: 2000,
+                            type: "string"
+                          },
+                          onFailure: {
+                            description: "What to do when the call fails. Omitted or empty: the procedure stops and the Agent handles the failure under its instructions.",
+                            maxItems: 40,
+                            type: "array",
+                            items: {
+                              anyOf: [
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "instruction",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    instruction: {
+                                      description: "What to ask, and when an answer counts. The procedure waits here until the contact answers.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "ask",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "instruction",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    instruction: {
+                                      description: "What to convey, in the Agent's own words. The procedure continues without waiting.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "tell",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "message",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    message: {
+                                      description: "What to say, word for word.",
+                                      maxLength: 2000,
+                                      minLength: 1,
+                                      type: "string"
+                                    },
+                                    translations: {
+                                      description: "The exact message in other languages, by BCP 47 tag, for an Agent that speaks several.",
+                                      type: "object",
+                                      patternProperties: {
+                                        "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$": {
+                                          maxLength: 2000,
+                                          minLength: 1,
+                                          type: "string"
+                                        }
+                                      }
+                                    },
+                                    type: {
+                                      const: "say",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  type: "object",
+                                  required: [
+                                    "procedureId",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    procedureId: {
+                                      description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                                      pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      const: "procedure",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                                  type: "object",
+                                  required: [
+                                    "type"
+                                  ],
+                                  properties: {
+                                    type: {
+                                      const: "end",
+                                      type: "string"
+                                    }
+                                  }
+                                },
+                                {
+                                  additionalProperties: false,
+                                  description: "Call the failed tool again and, if it fails again, run its failure steps again. Only the last step of a failure handler.",
+                                  type: "object",
+                                  required: [
+                                    "maxRetries",
+                                    "type"
+                                  ],
+                                  properties: {
+                                    maxRetries: {
+                                      description: "Calls of the tool after the first one.",
+                                      maximum: 3,
+                                      minimum: 1,
+                                      type: "integer"
+                                    },
+                                    type: {
+                                      const: "retry",
+                                      type: "string"
+                                    }
+                                  }
+                                }
+                              ]
+                            }
+                          },
+                          tool: {
+                            description: "One of the Agent's integration tools by its tool name, or one of Raíz's own tools (`search_knowledge`, `escalate_to_team`, `transfer_to_human`).",
+                            pattern: "^[A-Za-z0-9_.-]{1,128}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "tool",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        type: "object",
+                        required: [
+                          "procedureId",
+                          "type"
+                        ],
+                        properties: {
+                          procedureId: {
+                            description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                            pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                            type: "string"
+                          },
+                          type: {
+                            const: "procedure",
+                            type: "string"
+                          }
+                        }
+                      },
+                      {
+                        additionalProperties: false,
+                        description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+                        type: "object",
+                        required: [
+                          "type"
+                        ],
+                        properties: {
+                          type: {
+                            const: "end",
+                            type: "string"
+                          }
+                        }
+                      }
+                    ]
+                  }
+                },
+                type: {
+                  const: "branch",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              type: "object",
+              required: [
+                "procedureId",
+                "type"
+              ],
+              properties: {
+                procedureId: {
+                  description: "Another structured procedure of this Agent. It runs to its end, then this procedure continues.",
+                  pattern: "^prc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
+                  type: "string"
+                },
+                type: {
+                  const: "procedure",
+                  type: "string"
+                }
+              }
+            },
+            {
+              additionalProperties: false,
+              description: "Finish the conversation after this reply (on a call, hang up). Always the last step of its list.",
+              type: "object",
+              required: [
+                "type"
+              ],
+              properties: {
+                type: {
+                  const: "end",
+                  type: "string"
+                }
+              }
+            }
+          ]
+        }
+      },
+      trigger: {
+        description: "When it applies, from the contact's side: When the contact asks to book or move an appointment. Empty makes a sub-procedure, which only runs when another procedure references it.",
+        maxLength: 1000,
+        type: "string"
+      },
+      type: {
+        description: "`free_form`: instructions the Agent adapts. `structured`: steps that run the same way every time. Fixed once created.",
+        anyOf: [
+          {
+            const: "free_form",
+            type: "string"
+          },
+          {
+            const: "structured",
+            type: "string"
+          }
+        ]
+      }
+    }
+  },
+  RaizAgentSettings: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "humanEscalation",
+      "recoveryManager",
+      "automaticKnowledge",
+      "attachmentReader",
+      "budgetExhaustedMessage",
+      "closingMessage",
+      "evalGate",
+      "followUpAfterMinutes",
+      "followUpMessage",
+      "greeting",
+      "handoffMessage",
+      "humanReplyTimeoutMinutes",
+      "investigationsEnabled",
+      "model",
+      "modelTrial",
+      "monthlyTokenBudget",
+      "pauseOnHumanReply",
+      "policy",
+      "pollPendingOperations",
+      "reasoningEffort",
+      "replyChoices",
+      "sessionCloseAfterMinutes",
+      "temperature",
+      "toolDiscovery",
+      "voice"
+    ],
+    properties: {
+      humanEscalation: {
+        anyOf: [
+          {
+            description: "Per-Agent human escalation policy. Instructions apply to voice and text. Null keeps the default instructions. A WhatsApp handoff stays with the team until a person explicitly resumes AI; no timeout resumes it.",
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "instructions"
+            ],
+            properties: {
+              instructions: {
+                anyOf: [
+                  {
+                    maxLength: 4000,
+                    description: "When this Agent should ask the business's team to intervene, using only its available handoff capabilities. Null keeps the default instructions; an explicit request for a person is always respected.",
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              }
+            }
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      recoveryManager: {
+        anyOf: [
+          {
+            description: "Optional WhatsApp recovery advisor. Null or enabled=false disables it. A journaled evidence check precedes any paid review. One tool-free model call per turn before autonomous escalation or after terminal provider failure; unresolved terminal recovery hands off. Completed handoffs and conservatively recognized human requests bypass generation. Model selects the existing provider route. Prices must be conservative upper bounds including provider overhead; missing or invalid prices disable recovery. The cost bound covers only the advisor. No tools or automatic provider retries.",
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "enabled",
+              "model",
+              "maxAttempts",
+              "timeoutMs",
+              "maxInputTokens",
+              "maxOutputTokens",
+              "maxCostUsd",
+              "inputUsdPerMillion",
+              "outputUsdPerMillion"
+            ],
+            properties: {
+              enabled: {
+                type: "boolean"
+              },
+              instructions: {
+                anyOf: [
+                  {
+                    maxLength: 4000,
+                    description: "Operator criteria for when the recovery advisor should help or leave the case to a person. They never override consent, tool permissions, unknown-write fences or an explicit human request. Null keeps the default criteria.",
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              advisorAgentId: {
+                anyOf: [
+                  {
+                    description: "Optional active text Agent in the same organization, other than this Agent, whose instructions and procedures provide specialist guidance. The configured recovery model and cost bounds stay unchanged; no specialist tools or conversation history are accessed.",
+                    examples: [
+                      "agt_01m45h8q2rf3t9w6y7z0b1c2d3"
+                    ],
+                    pattern: "^agt_(?:[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"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              model: {
+                description: "`arbolito/agile`: quickest and least expensive, for direct conversations. `arbolito/balanced`: more deliberate answers at moderate cost. `arbolito/advanced`: strong reasoning for complex instructions and many tools, with an adjustable `reasoningEffort`. `arbolito/top`: the most capable, for the hardest cases, with an adjustable `reasoningEffort` up to `xhigh`. Every tier reads images and PDF documents.",
+                anyOf: [
+                  {
+                    const: "arbolito/agile",
+                    type: "string"
+                  },
+                  {
+                    const: "arbolito/balanced",
+                    type: "string"
+                  },
+                  {
+                    const: "arbolito/advanced",
+                    type: "string"
+                  },
+                  {
+                    const: "arbolito/top",
+                    type: "string"
+                  }
+                ]
+              },
+              maxAttempts: {
+                const: 1,
+                type: "number"
+              },
+              timeoutMs: {
+                minimum: 100,
+                maximum: 15000,
+                type: "integer"
+              },
+              maxInputTokens: {
+                minimum: 4096,
+                maximum: 131072,
+                type: "integer"
+              },
+              maxOutputTokens: {
+                minimum: 128,
+                maximum: 1024,
+                type: "integer"
+              },
+              maxCostUsd: {
+                exclusiveMinimum: 0,
+                maximum: 1,
+                type: "number"
+              },
+              inputUsdPerMillion: {
+                exclusiveMinimum: 0,
+                maximum: 1000,
+                type: "number"
+              },
+              outputUsdPerMillion: {
+                exclusiveMinimum: 0,
+                maximum: 1000,
+                type: "number"
+              }
+            }
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      automaticKnowledge: {
+        anyOf: [
+          {
+            description: "Text Agents. Retrieve relevant passages from this Agent's active Knowledge before a substantive contact message, without a model tool call. Null or false: on-demand search only. Does not store contact memories or learn unreviewed answers.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      attachmentReader: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp. Who reads an image or PDF when the Agent calls `read_attachment`: `vision` (a vision model describes and transcribes it, with a stronger one when the first reads nothing) or `ocr` (text recognition, which also answers the `fields` the Agent asks for, each null when absent or unclear; the vision model reads the file when recognition cannot). With `ocr` the Agent sees files as markers and reads them with `read_attachment`; with `vision`, tiers that read files themselves see the original. Null: `vision`.",
+            anyOf: [
+              {
+                const: "vision",
+                type: "string"
+              },
+              {
+                const: "ocr",
+                type: "string"
+              }
+            ]
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      budgetExhaustedMessage: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp. What the contact reads when the Agent has used its `monthlyTokenBudget`: the conversation then goes to the team, as an escalation does, and the Agent writes nothing until the budget is raised or the month ends. Null: `handoffMessage`, including an empty notice when disabled.",
+            maxLength: 1000,
+            minLength: 1,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      closingMessage: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp. After a reply that completed an action (an integration tool that changes data succeeded), explicitly finished the case with end_conversation and left nothing pending (no question, no offered choices, no handoff), a contact message that only thanks or closes («gracias», «ok», «listo», an emoji) gets this text at once, without the model; the Agent still reads both in its next turn. Write it in the Agent's language and ask nothing in it. Null: the Agent answers such messages itself.",
+            maxLength: 1000,
+            minLength: 1,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      evalGate: {
+        anyOf: [
+          {
+            description: "Text and voice Agents. When true, an `updateAgent` that changes what the model reads (instructions, procedures, connection procedures, `model` or `reasoningEffort`) must send `evalRunId`: a completed `createEvalRun` of this Agent with exactly that content, in which every case passed (EVAL_GATE_UNMET otherwise). Null: no requirement.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      followUpAfterMinutes: {
+        anyOf: [
+          {
+            description: "Text Agents. When the Agent spoke last and asked something, send `followUpMessage` once after this many minutes of silence (WhatsApp only, inside its 24-hour window). Null disables follow-ups.",
+            maximum: 1440,
+            minimum: 1,
+            type: "integer"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      followUpMessage: {
+        anyOf: [
+          {
+            description: "Text Agents. The follow-up text. Null uses a short default in the Agent's language.",
+            maxLength: 1000,
+            minLength: 1,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      greeting: {
+        anyOf: [
+          {
+            $ref: "#/components/schemas/RaizAgentGreeting",
+            description: "Text Agents on WhatsApp. How the Agent answers when a contact opens a conversation and nobody from the business has answered it yet. Null: the Agent answers the first message with its own instructions alone."
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      handoffMessage: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp. The notice appended after an escalation or a requested human handoff. Null: the current localized review notice or the case-specific notice supplied under the Agent's instructions. An empty string disables the notice; the handoff and pause still happen. The model does not write this notice.",
+            maxLength: 1000,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      humanReplyTimeoutMinutes: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp. After a manual takeover, resume automatic replies when the contact's newest message waits this many minutes. An Agent handoff always stays with the team until a person explicitly resumes AI. Null: only a person resumes automatic replies.",
+            maximum: 1440,
+            minimum: 1,
+            type: "integer"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      investigationsEnabled: {
+        anyOf: [
+          {
+            description: "Opt this Agent into internal root-cause investigations of tool failures, human escalations, failed outcomes and negative feedback. Incidents are grouped only with participating Agents in the same organization. Null or false: disabled. Turning this off stops new events and pending dispatch when no participating Agent remains; an already active investigation may finish.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      model: {
+        anyOf: [
+          {
+            description: "Text Agents. The tier that writes replies. `arbolito/agile`: quickest and least expensive, for direct conversations. `arbolito/balanced`: more deliberate answers at moderate cost. `arbolito/advanced`: strong reasoning for complex instructions and many tools, with an adjustable `reasoningEffort`. `arbolito/top`: the most capable, for the hardest cases, with an adjustable `reasoningEffort` up to `xhigh`. Every tier reads images and PDF documents. Null: the default, as `arbolito/agile`.",
+            anyOf: [
+              {
+                const: "arbolito/agile",
+                type: "string"
+              },
+              {
+                const: "arbolito/balanced",
+                type: "string"
+              },
+              {
+                const: "arbolito/advanced",
+                type: "string"
+              },
+              {
+                const: "arbolito/top",
+                type: "string"
+              }
+            ]
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      modelTrial: {
+        anyOf: [
+          {
+            $ref: "#/components/schemas/RaizAgentModelTrial",
+            description: "Text Agents on WhatsApp. Answer a stable share of the Agent's new conversations with another tier, to compare it with `model` on real traffic. A conversation keeps the tier its first reply used while the trial lasts (one already open when the trial starts stays on `model`); removing the trial returns every conversation to `model`. Null: no trial."
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      monthlyTokenBudget: {
+        anyOf: [
+          {
+            description: "Text Agents. Tokens (input, cached input included, plus output) the Agent may use per calendar month (UTC), on every channel. On WhatsApp, a reply that would start past it does not run: the contact reads `budgetExhaustedMessage` and the team continues; at 80 % the API logs an alert once a month. Null: no limit.",
+            maximum: 1000000000000,
+            minimum: 1e4,
+            type: "integer"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      pauseOnHumanReply: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp: pause automatic replies when a live WhatsApp Business App message that says something (not a reaction, an edit or a deletion) proves a person took over. Null: disabled. The recipient stays paused until resumed or until that conversation closes; their next conversation starts with the AI.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      policy: {
+        anyOf: [
+          {
+            $ref: "#/components/schemas/RaizAgentTurnPolicy",
+            description: "Text Agents on WhatsApp. Limits on each reply: model calls, output, writes per step, repeated reads, cached reads and deferred tools. Null keeps every default."
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      pollPendingOperations: {
+        anyOf: [
+          {
+            description: "Text Agents on WhatsApp: when a reply ends while an integration answered that its work is still pending (`status: pending` with an `operationId`) and the same connection offers `getOperation`, Raíz checks it again on its own and the Agent answers with the result, without waiting for the contact to write. Null: disabled.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      reasoningEffort: {
+        anyOf: [
+          {
+            description: "Text Agents whose tier reasons (`arbolito/advanced`, `arbolito/top`, or an Agent already running a model that reasons): `none` answers fastest, `high` deliberates most, and `xhigh`, on `arbolito/advanced` and `arbolito/top`, deliberates past it. Null: the tier's default. A tier that does not reason refuses it (AGENT_SETTINGS_INVALID).",
+            anyOf: [
+              {
+                const: "none",
+                type: "string"
+              },
+              {
+                const: "low",
+                type: "string"
+              },
+              {
+                const: "medium",
+                type: "string"
+              },
+              {
+                const: "high",
+                type: "string"
+              },
+              {
+                const: "xhigh",
+                type: "string"
+              }
+            ]
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      replyChoices: {
+        anyOf: [
+          {
+            description: "Text Agents. Let the Agent offer tap-to-answer options (WhatsApp buttons and lists, web reply options). Null: allowed.",
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      sessionCloseAfterMinutes: {
+        anyOf: [
+          {
+            description: "Text Agents. Close a conversation after this many minutes without messages. Null: 1440 on WhatsApp, 30 on web.",
+            maximum: 10080,
+            minimum: 5,
             type: "integer"
           },
           {
@@ -68098,7 +70221,7 @@ var schemaComponents = {
               advisorAgentId: {
                 anyOf: [
                   {
-                    description: "Optional active text Agent in the same organization, other than this Agent, whose instructions and skills provide specialist guidance. The configured recovery model and cost bounds stay unchanged; no specialist tools or conversation history are accessed.",
+                    description: "Optional active text Agent in the same organization, other than this Agent, whose instructions and procedures provide specialist guidance. The configured recovery model and cost bounds stay unchanged; no specialist tools or conversation history are accessed.",
                     examples: [
                       "agt_01m45h8q2rf3t9w6y7z0b1c2d3"
                     ],
@@ -68244,7 +70367,7 @@ var schemaComponents = {
       evalGate: {
         anyOf: [
           {
-            description: "Text and voice Agents. When true, an `updateAgent` that changes what the model reads (instructions, skills, connection skills, `model` or `reasoningEffort`) must send `evalRunId`: a completed `createEvalRun` of this Agent with exactly that content, in which every case passed (EVAL_GATE_UNMET otherwise). Null: no requirement.",
+            description: "Text and voice Agents. When true, an `updateAgent` that changes what the model reads (instructions, procedures, connection procedures, `model` or `reasoningEffort`) must send `evalRunId`: a completed `createEvalRun` of this Agent with exactly that content, in which every case passed (EVAL_GATE_UNMET otherwise). Null: no requirement.",
             type: "boolean"
           },
           {
@@ -68503,83 +70626,6 @@ var schemaComponents = {
       }
     }
   },
-  RaizAgentSkill: {
-    additionalProperties: false,
-    type: "object",
-    required: [
-      "name",
-      "description",
-      "instructions",
-      "status",
-      "resources"
-    ],
-    properties: {
-      name: {
-        minLength: 1,
-        maxLength: 64,
-        pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
-        type: "string"
-      },
-      description: {
-        minLength: 1,
-        maxLength: 500,
-        pattern: "^[^\\r\\n]+$",
-        type: "string"
-      },
-      instructions: {
-        minLength: 1,
-        maxLength: 30000,
-        type: "string"
-      },
-      status: {
-        anyOf: [
-          {
-            const: "active",
-            type: "string"
-          },
-          {
-            const: "paused",
-            type: "string"
-          }
-        ]
-      },
-      tools: {
-        description: "WhatsApp: while this skill is active in a reply, the model is offered only these tools plus Raíz's own (choices, attachments, skills, escalation). Omitted: every tool stays offered. Narrowing changes the request's tool list, so the provider's cached prefix restarts for that reply.",
-        maxItems: 32,
-        uniqueItems: true,
-        type: "array",
-        items: {
-          pattern: "^[A-Za-z0-9_-]{1,64}$",
-          type: "string"
-        }
-      },
-      resources: {
-        maxItems: 16,
-        type: "array",
-        items: {
-          additionalProperties: false,
-          type: "object",
-          required: [
-            "path",
-            "content"
-          ],
-          properties: {
-            path: {
-              minLength: 1,
-              maxLength: 200,
-              pattern: "^references/[a-zA-Z0-9_-]+(?:/[a-zA-Z0-9_-]+)*\\.(?:md|txt|json|csv)$",
-              type: "string"
-            },
-            content: {
-              minLength: 1,
-              maxLength: 20000,
-              type: "string"
-            }
-          }
-        }
-      }
-    }
-  },
   RaizAgentTurnPolicy: {
     additionalProperties: false,
     type: "object",
@@ -70328,7 +72374,7 @@ var schemaComponents = {
       "kind",
       "name",
       "status",
-      "skills",
+      "procedures",
       "summary",
       "tools",
       "toolsVersion"
@@ -70379,8 +72425,8 @@ var schemaComponents = {
           }
         ]
       },
-      skills: {
-        description: "The procedures a custom server publishes beside its tools. An Agent pins the ones it uses (`integrationSkills`).",
+      procedures: {
+        description: "The procedures a custom server publishes beside its tools. An Agent pins the ones it uses (`integrationProcedures`).",
         maxItems: 64,
         type: "array",
         items: {
@@ -70393,17 +72439,17 @@ var schemaComponents = {
           ],
           properties: {
             description: {
-              description: "One line: what the procedure achieves and when to load it.",
+              description: "One line: what the procedure achieves and when it applies. It is the procedure's trigger.",
               type: "string"
             },
             digest: {
-              description: "A digest of the skill (its name, description and procedure). Equal digests, equal skills.",
+              description: "A digest of the procedure (its name, description and instructions). Equal digests, equal procedures.",
               maxLength: 64,
               minLength: 1,
               type: "string"
             },
             name: {
-              description: "The skill's name, as its connection lists it.",
+              description: "The procedure's name, as its connection lists it.",
               maxLength: 64,
               minLength: 1,
               pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
@@ -73092,7 +75138,7 @@ var schemaComponents = {
         ]
       },
       contentSha256: {
-        description: "SHA-256 of the candidate's content (instructions, skills, connection skills, model, reasoning effort): what `settings.evalGate` compares with an update's.",
+        description: "SHA-256 of the candidate's content (instructions, procedures, connection procedures, model, reasoning effort): what `settings.evalGate` compares with an update's.",
         pattern: "^[a-f0-9]{64}$",
         type: "string"
       },
@@ -75724,11 +77770,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "AGENT_SKILLS_INVALID",
+                const: "AGENT_PROCEDURES_INVALID",
                 type: "string"
               },
               message: {
-                const: "Skills require a text Agent, unique names and resource paths, nonempty instructions, and at most 256 KiB in total.",
+                const: "A procedure is incomplete, references a tool, document or procedure the Agent does not have, or breaks the structured step rules. `issues` says where.",
                 type: "string"
               },
               retryable: {
@@ -75738,7 +77784,33 @@ var schemaComponents = {
               data: {
                 additionalProperties: false,
                 type: "object",
-                properties: {}
+                required: [
+                  "issues"
+                ],
+                properties: {
+                  issues: {
+                    maxItems: 20,
+                    type: "array",
+                    items: {
+                      additionalProperties: false,
+                      type: "object",
+                      required: [
+                        "code",
+                        "path"
+                      ],
+                      properties: {
+                        code: {
+                          description: "Why, as a label: content_required, steps_required, unknown_tool, unknown_knowledge, unknown_procedure, sub_procedure_not_structured, consecutive_branches, end_not_last, retry_not_last, type_changed, procedure_cycle, reference_not_allowed, unsupported_on_calls…",
+                          type: "string"
+                        },
+                        path: {
+                          description: "RFC 6901 pointer to the refused field, such as `/procedures/2/steps/1`.",
+                          type: "string"
+                        }
+                      }
+                    }
+                  }
+                }
               }
             }
           },
@@ -76014,11 +78086,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "INTEGRATION_SKILL_UNAVAILABLE",
+                const: "INTEGRATION_PROCEDURE_UNAVAILABLE",
                 type: "string"
               },
               message: {
-                const: "A skill does not exist in this organization's connections, Raíz cannot run its connection, or its name repeats one of the Agent's skills.",
+                const: "A procedure does not exist in this organization's connections, Raíz cannot run its connection, or the Agent is not a text Agent.",
                 type: "string"
               },
               retryable: {
@@ -82637,30 +84709,44 @@ var schemaComponents = {
     }
   },
   SaludTotalInvoiceLookupResult: {
-    additionalProperties: false,
-    type: "object",
-    required: [
-      "status",
-      "recordCount"
-    ],
-    properties: {
-      status: {
-        anyOf: [
-          {
+    anyOf: [
+      {
+        additionalProperties: false,
+        type: "object",
+        required: [
+          "status",
+          "recordCount"
+        ],
+        properties: {
+          status: {
             const: "no_match",
             type: "string"
           },
-          {
+          recordCount: {
+            const: 0,
+            type: "number"
+          }
+        }
+      },
+      {
+        additionalProperties: false,
+        type: "object",
+        required: [
+          "status",
+          "recordCount"
+        ],
+        properties: {
+          status: {
             const: "records_found",
             type: "string"
+          },
+          recordCount: {
+            minimum: 1,
+            type: "integer"
           }
-        ]
-      },
-      recordCount: {
-        minimum: 0,
-        type: "integer"
+        }
       }
-    }
+    ]
   },
   SaludTotalInvoiceLookupResultResponse: {
     type: "object",
@@ -83438,6 +85524,9 @@ var schemaComponents = {
   },
   SaludTotalLookupInvoiceConflictFailure: {
     oneOf: [
+      {
+        $ref: "#/components/schemas/SaludTotalReportingWindowClosedFailure"
+      },
       {
         $ref: "#/components/schemas/SaludTotalConnectionUnavailableFailure"
       },
@@ -83457,6 +85546,7 @@ var schemaComponents = {
     discriminator: {
       propertyName: "code",
       mapping: {
+        REPORTING_WINDOW_CLOSED: "#/components/schemas/SaludTotalReportingWindowClosedFailure",
         CONNECTION_UNAVAILABLE: "#/components/schemas/SaludTotalConnectionUnavailableFailure",
         SESSION_CLOSED: "#/components/schemas/SaludTotalSessionClosedFailure",
         INTERACTIVE_VERIFICATION_REQUIRED: "#/components/schemas/SaludTotalInteractiveVerificationRequiredFailure",
@@ -83884,6 +85974,65 @@ var schemaComponents = {
       }
     }
   },
+  SaludTotalReportingWindowClosedFailure: {
+    type: "object",
+    description: "Invoice reporting is closed. Retry during the provider’s reporting hours.",
+    additionalProperties: false,
+    required: [
+      "code",
+      "message",
+      "retryable",
+      "data"
+    ],
+    properties: {
+      code: {
+        type: "string",
+        enum: [
+          "REPORTING_WINDOW_CLOSED"
+        ],
+        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: [
+          true
+        ],
+        description: "Whether repeating the same request may succeed."
+      },
+      data: {
+        $ref: "#/components/schemas/SaludTotalReportingWindowClosedFailureData"
+      }
+    }
+  },
+  SaludTotalReportingWindowClosedFailureData: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "opensAtHour",
+      "closesAtHour",
+      "timeZone"
+    ],
+    properties: {
+      opensAtHour: {
+        minimum: 0,
+        maximum: 23,
+        type: "integer"
+      },
+      closesAtHour: {
+        minimum: 1,
+        maximum: 24,
+        type: "integer"
+      },
+      timeZone: {
+        const: "America/Bogota",
+        type: "string"
+      }
+    }
+  },
   SaludTotalScopedDayLookup: {
     additionalProperties: false,
     type: "object",
@@ -105086,12 +107235,12 @@ var schemaComponents = {
           }
         ]
       },
-      integrationSkills: {
-        description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+      integrationProcedures: {
+        description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
         maxItems: 32,
         type: "array",
         items: {
-          $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+          $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
         }
       },
       integrationTools: {
@@ -105124,18 +107273,18 @@ var schemaComponents = {
         pattern: "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
         type: "string"
       },
-      settings: {
-        $ref: "#/components/schemas/RaizAgentSettingsInput",
-        description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
-      },
-      skills: {
-        maxItems: 32,
-        description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
+      procedures: {
+        description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+        maxItems: 64,
         type: "array",
         items: {
-          $ref: "#/components/schemas/RaizAgentSkill"
+          $ref: "#/components/schemas/RaizAgentProcedureInput"
         }
       },
+      settings: {
+        $ref: "#/components/schemas/RaizAgentSettingsInput",
+        description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
+      },
       status: {
         description: "A paused Agent answers nothing and places no calls.",
         anyOf: [
@@ -105246,12 +107395,12 @@ var schemaComponents = {
           }
         ]
       },
-      integrationSkills: {
-        description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+      integrationProcedures: {
+        description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
         maxItems: 32,
         type: "array",
         items: {
-          $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+          $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
         }
       },
       integrationTools: {
@@ -105284,18 +107433,18 @@ var schemaComponents = {
         pattern: "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
         type: "string"
       },
-      settings: {
-        $ref: "#/components/schemas/RaizAgentSettingsInput",
-        description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
-      },
-      skills: {
-        maxItems: 32,
-        description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
+      procedures: {
+        description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+        maxItems: 64,
         type: "array",
         items: {
-          $ref: "#/components/schemas/RaizAgentSkill"
+          $ref: "#/components/schemas/RaizAgentProcedureInput"
         }
       },
+      settings: {
+        $ref: "#/components/schemas/RaizAgentSettingsInput",
+        description: "How the Agent behaves. In an update, the complete new settings: keys left out return to their default. Text and voice settings apply only to Agents of that modality."
+      },
       status: {
         description: "A paused Agent answers nothing and places no calls.",
         anyOf: [
@@ -108246,7 +110395,7 @@ var schemaComponents = {
         type: "string"
       },
       candidate: {
-        description: "The candidate version: what changes in what the model reads. Omitted fields keep the live Agent's; `integrationSkills` and `skills` are complete sets, as in `updateAgent`.",
+        description: "The candidate version: what changes in what the model reads. Omitted fields keep the live Agent's; `integrationProcedures` and `procedures` are complete sets, as in `updateAgent`.",
         additionalProperties: false,
         type: "object",
         properties: {
@@ -108263,12 +110412,12 @@ var schemaComponents = {
               }
             ]
           },
-          integrationSkills: {
-            description: "Text Agents. Skills a connection publishes (`listConnections`, checked live in Account), each saved with its current text and offered beside `skills`; names must differ from the Agent's own skills. In an update, the complete new set.",
+          integrationProcedures: {
+            description: "Text Agents. Procedures a connection publishes (`listConnections`, checked live in Account), each saved with its current text and run as a free-form procedure beside `procedures`. In an update, the complete new set.",
             maxItems: 32,
             type: "array",
             items: {
-              $ref: "#/components/schemas/RaizAgentIntegrationSkillInput"
+              $ref: "#/components/schemas/RaizAgentIntegrationProcedureInput"
             }
           },
           model: {
@@ -108299,6 +110448,14 @@ var schemaComponents = {
               }
             ]
           },
+          procedures: {
+            description: "The Agent's procedures, as a complete set: a procedure left out is removed. Keep each existing procedure's `id`; a new one may omit it.",
+            maxItems: 64,
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/RaizAgentProcedureInput"
+            }
+          },
           reasoningEffort: {
             anyOf: [
               {
@@ -108330,14 +110487,6 @@ var schemaComponents = {
                 type: "null"
               }
             ]
-          },
-          skills: {
-            maxItems: 32,
-            description: "Text-only procedures and references loaded on demand. Names and resource paths must be unique; the complete set is limited to 256 KiB. In an update, this replaces the whole set. Skills never grant additional business tools or execute scripts.",
-            type: "array",
-            items: {
-              $ref: "#/components/schemas/RaizAgentSkill"
-            }
           }
         }
       },
@@ -114039,9 +116188,9 @@ var schemaComponents = {
 // src/generated/generation.json
 var generation_default = {
   formatVersion: 6,
-  release: "1.20261031.231351",
-  openapiSha256: "8fa3a94dd756c3979d4396836eeef6a41068fdcc3d61365d7fd7fc64121755dc",
-  openapiContentSha256: "4890ffbf2df6526c63f819d997c3e4bbce5f010efd1492b2079be9e8e12e80f6",
+  release: "1.20261101.1149",
+  openapiSha256: "93cc9ff7bde9c4d0011413c408e08dc907b2701c78831042f93bff6d66c2f019",
+  openapiContentSha256: "ea84a99894927badee6af4fd1b9b6e39e845eb87fe5b2b8bcedb20bce67e956d",
   forge: {
     repository: "https://github.com/cloudflare/forge",
     commit: "7f86447210b7bea3779bfdab3cd5655eade0eadb",
@@ -114054,7 +116203,7 @@ var generation_default = {
   outputs: [
     {
       path: "src/generated/commands.ts",
-      sha256: "bd7c06262d60aec72bdec72b8fa04a6e4db3e8f71502b75989f947d53db76f4a"
+      sha256: "d6df1959c27aa72de66834304545b639ea07f829876399a8e120c592c3209f59"
     }
   ]
 };
@@ -114409,7 +116558,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "3.13.0";
+var VERSION = "3.15.0";
 var RELEASE = generation_default.release;
 var SDK_PATHS = new Map(Object.values(commands).map((command) => [command.operation, command.sdkPath]));
 var SERVICES = [...new Set(Object.keys(commands).map((name) => name.split(" ")[0]))].toSorted();