@arbol-ai/cli 3.25.0 → 3.27.0

package/dist/index.js

@@ -18154,6 +18154,113 @@ var commands = {
           "open",
           "closed"
         ]
+      },
+      {
+        name: "period",
+        flag: "period",
+        kind: "string",
+        required: false,
+        description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+        choices: [
+          "today",
+          "7d",
+          "30d",
+          "90d",
+          "365d"
+        ]
+      },
+      {
+        name: "sentiment",
+        flag: "sentiment",
+        kind: "string",
+        required: false,
+        description: "Comma-separated sentiments of the analysis."
+      },
+      {
+        name: "toolName",
+        flag: "tool-name",
+        kind: "string",
+        required: false,
+        description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each."
+      },
+      {
+        name: "toolStatus",
+        flag: "tool-status",
+        kind: "string",
+        required: false,
+        description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+        choices: [
+          "completed",
+          "failed",
+          "denied"
+        ]
+      },
+      {
+        name: "factDefinition",
+        flag: "fact-definition",
+        kind: "string",
+        required: false,
+        description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value."
+      },
+      {
+        name: "factValue",
+        flag: "fact-value",
+        kind: "string",
+        required: false,
+        description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`."
+      },
+      {
+        name: "assessment",
+        flag: "assessment",
+        kind: "string",
+        required: false,
+        description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+        choices: [
+          "failed",
+          "passed"
+        ]
+      },
+      {
+        name: "toReview",
+        flag: "to-review",
+        kind: "boolean",
+        required: false,
+        description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others."
+      },
+      {
+        name: "messagesMin",
+        flag: "messages-min",
+        kind: "integer",
+        required: false,
+        description: "At least this many messages."
+      },
+      {
+        name: "messagesMax",
+        flag: "messages-max",
+        kind: "integer",
+        required: false,
+        description: "At most this many messages."
+      },
+      {
+        name: "durationMin",
+        flag: "duration-min",
+        kind: "integer",
+        required: false,
+        description: "Calls of at least this many seconds."
+      },
+      {
+        name: "durationMax",
+        flag: "duration-max",
+        kind: "integer",
+        required: false,
+        description: "Calls of at most this many seconds."
+      },
+      {
+        name: "groupBy",
+        flag: "group-by",
+        kind: "string",
+        required: false,
+        description: "`outcome`, `status`, `channel` (type), `agent`, `sentiment`, `tool` (each Agent tool and the conversations that used it), `toolError` (failed calls, of `toolName` when given, by error) or `fact:<definition key>` (the current value of that definition, such as the reason for contact)."
       }
     ],
     inputSchema: {
@@ -18296,12 +18403,118 @@ var commands = {
               type: "string"
             }
           ]
+        },
+        period: {
+          description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+          anyOf: [
+            {
+              const: "today",
+              type: "string"
+            },
+            {
+              const: "7d",
+              type: "string"
+            },
+            {
+              const: "30d",
+              type: "string"
+            },
+            {
+              const: "90d",
+              type: "string"
+            },
+            {
+              const: "365d",
+              type: "string"
+            }
+          ]
+        },
+        sentiment: {
+          description: "Comma-separated sentiments of the analysis.",
+          pattern: "^(positive|neutral|negative)(,(positive|neutral|negative))*$",
+          type: "string"
+        },
+        toolName: {
+          description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each.",
+          maxLength: 128,
+          minLength: 1,
+          type: "string"
+        },
+        toolStatus: {
+          description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+          anyOf: [
+            {
+              const: "completed",
+              type: "string"
+            },
+            {
+              const: "failed",
+              type: "string"
+            },
+            {
+              const: "denied",
+              type: "string"
+            }
+          ]
+        },
+        factDefinition: {
+          description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value.",
+          pattern: "^[a-z][a-z0-9_]{0,63}$",
+          type: "string"
+        },
+        factValue: {
+          description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`.",
+          maxLength: 500,
+          minLength: 1,
+          type: "string"
+        },
+        assessment: {
+          description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+          anyOf: [
+            {
+              const: "failed",
+              type: "string"
+            },
+            {
+              const: "passed",
+              type: "string"
+            }
+          ]
+        },
+        toReview: {
+          description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others.",
+          type: "boolean"
+        },
+        messagesMin: {
+          description: "At least this many messages.",
+          minimum: 0,
+          type: "integer"
+        },
+        messagesMax: {
+          description: "At most this many messages.",
+          minimum: 0,
+          type: "integer"
+        },
+        durationMin: {
+          description: "Calls of at least this many seconds.",
+          minimum: 0,
+          type: "integer"
+        },
+        durationMax: {
+          description: "Calls of at most this many seconds.",
+          minimum: 0,
+          type: "integer"
+        },
+        groupBy: {
+          description: "`outcome`, `status`, `channel` (type), `agent`, `sentiment`, `tool` (each Agent tool and the conversations that used it), `toolError` (failed calls, of `toolName` when given, by error) or `fact:<definition key>` (the current value of that definition, such as the reason for contact).",
+          pattern: "^(outcome|status|channel|agent|sentiment|tool|toolError|fact:[a-z][a-z0-9_]{0,63})$",
+          type: "string"
         }
       },
       additionalProperties: false
     },
     title: "Count conversations",
-    description: "Count the conversations `list_conversations` returns for the same filters (every filter it takes, without `sort`), up to 10,000: `capped` then says at least that many match. Use it to answer how many conversations match instead of paging through the list; for volumes per day, Agent or outcome use `get_report`.",
+    description: "Count the conversations `list_conversations` returns for the same filters (every filter it takes, without `sort`), up to 10,000: `capped` then says at least that many match. `averageMessageCount` and `averageDurationSeconds` are their average length. `groupBy` also divides them, largest group first, each with its outcomes: by `outcome`, `status`, `channel`, `agent`, `sentiment`, `tool` (which Agent tools they used, and in how many a tool failed), `toolError` (why calls of `toolName` failed) or `fact:<definition key>` (such as the reason for contact). Use it to answer how many conversations match, or how they divide, instead of paging through the list; for volumes per day use `get_report`.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -18611,6 +18824,106 @@ var commands = {
           "closed"
         ]
       },
+      {
+        name: "period",
+        flag: "period",
+        kind: "string",
+        required: false,
+        description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+        choices: [
+          "today",
+          "7d",
+          "30d",
+          "90d",
+          "365d"
+        ]
+      },
+      {
+        name: "sentiment",
+        flag: "sentiment",
+        kind: "string",
+        required: false,
+        description: "Comma-separated sentiments of the analysis."
+      },
+      {
+        name: "toolName",
+        flag: "tool-name",
+        kind: "string",
+        required: false,
+        description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each."
+      },
+      {
+        name: "toolStatus",
+        flag: "tool-status",
+        kind: "string",
+        required: false,
+        description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+        choices: [
+          "completed",
+          "failed",
+          "denied"
+        ]
+      },
+      {
+        name: "factDefinition",
+        flag: "fact-definition",
+        kind: "string",
+        required: false,
+        description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value."
+      },
+      {
+        name: "factValue",
+        flag: "fact-value",
+        kind: "string",
+        required: false,
+        description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`."
+      },
+      {
+        name: "assessment",
+        flag: "assessment",
+        kind: "string",
+        required: false,
+        description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+        choices: [
+          "failed",
+          "passed"
+        ]
+      },
+      {
+        name: "toReview",
+        flag: "to-review",
+        kind: "boolean",
+        required: false,
+        description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others."
+      },
+      {
+        name: "messagesMin",
+        flag: "messages-min",
+        kind: "integer",
+        required: false,
+        description: "At least this many messages."
+      },
+      {
+        name: "messagesMax",
+        flag: "messages-max",
+        kind: "integer",
+        required: false,
+        description: "At most this many messages."
+      },
+      {
+        name: "durationMin",
+        flag: "duration-min",
+        kind: "integer",
+        required: false,
+        description: "Calls of at least this many seconds."
+      },
+      {
+        name: "durationMax",
+        flag: "duration-max",
+        kind: "integer",
+        required: false,
+        description: "Calls of at most this many seconds."
+      },
       {
         name: "sort",
         flag: "sort",
@@ -18791,6 +19104,107 @@ var commands = {
             }
           ]
         },
+        period: {
+          description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+          anyOf: [
+            {
+              const: "today",
+              type: "string"
+            },
+            {
+              const: "7d",
+              type: "string"
+            },
+            {
+              const: "30d",
+              type: "string"
+            },
+            {
+              const: "90d",
+              type: "string"
+            },
+            {
+              const: "365d",
+              type: "string"
+            }
+          ]
+        },
+        sentiment: {
+          description: "Comma-separated sentiments of the analysis.",
+          pattern: "^(positive|neutral|negative)(,(positive|neutral|negative))*$",
+          type: "string"
+        },
+        toolName: {
+          description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each.",
+          maxLength: 128,
+          minLength: 1,
+          type: "string"
+        },
+        toolStatus: {
+          description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+          anyOf: [
+            {
+              const: "completed",
+              type: "string"
+            },
+            {
+              const: "failed",
+              type: "string"
+            },
+            {
+              const: "denied",
+              type: "string"
+            }
+          ]
+        },
+        factDefinition: {
+          description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value.",
+          pattern: "^[a-z][a-z0-9_]{0,63}$",
+          type: "string"
+        },
+        factValue: {
+          description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`.",
+          maxLength: 500,
+          minLength: 1,
+          type: "string"
+        },
+        assessment: {
+          description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+          anyOf: [
+            {
+              const: "failed",
+              type: "string"
+            },
+            {
+              const: "passed",
+              type: "string"
+            }
+          ]
+        },
+        toReview: {
+          description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others.",
+          type: "boolean"
+        },
+        messagesMin: {
+          description: "At least this many messages.",
+          minimum: 0,
+          type: "integer"
+        },
+        messagesMax: {
+          description: "At most this many messages.",
+          minimum: 0,
+          type: "integer"
+        },
+        durationMin: {
+          description: "Calls of at least this many seconds.",
+          minimum: 0,
+          type: "integer"
+        },
+        durationMax: {
+          description: "Calls of at most this many seconds.",
+          minimum: 0,
+          type: "integer"
+        },
         sort: {
           default: "started",
           description: "`started` (newest first), `last_message` (most recent activity first) or `changed`: the changed feed, oldest change first, with deleted conversations as tombstones; a forward page's `pageInfo.nextCursor` is always a position to save and poll from.",
@@ -18813,7 +19227,7 @@ var commands = {
       additionalProperties: false
     },
     title: "List conversations",
-    description: "Find calls, WhatsApp chats and web chats. Filter by `contactId` (as counterpart or subject), `agentId`, `channelId`, `channelType`, `status`, `conversationDirection`, `origin`, `outcome`, `handling` (`ai` or `team`: whether the AI takes part; `escalated`: handed to the team by the AI), `worker` (`ai` or `team`: who answers it now), `campaignId`, `profileId`, `requestedBy` and start time (`startedAfter`, `startedBefore`); `q` searches participant identities (names, profile names, usernames, phones, emails and documents), visible messages, titles, summaries and exact conversation references; `count_conversations` counts every match. Each item already carries its title, summary, outcome, sentiment and workers, often enough to answer. `sort`: `started` (newest first), `last_message` (latest activity first) or `changed`, the feed of status, outcome and analysis changes, oldest first, that systems poll from a saved `pageInfo.nextCursor` (a deleted conversation appears once with `deletedAt`). Next: `get_conversation` for a transcript.",
+    description: "Find calls, WhatsApp chats and web chats. Filter by `contactId` (as counterpart or subject), `agentId`, `channelId`, `channelType`, `status`, `conversationDirection`, `origin`, `outcome`, `sentiment`, `handling` (`ai` or `team`: whether the AI takes part; `escalated`: handed to the team by the AI), `worker` (`ai` or `team`: who answers it now), the Agent's tools (`toolName`, `toolStatus`: which tool it called and how the call ended), a captured fact (`factDefinition`, `factValue`), `assessment` (`failed` or `passed`), `toReview` (what needs a person's look: not resolved, or handed to the team), length (`messagesMin`, `messagesMax`, `durationMin`, `durationMax`), `campaignId`, `profileId`, `requestedBy` and start time (`startedAfter`, `startedBefore`); `q` searches participant identities (names, profile names, usernames, phones, emails and documents), visible messages, titles, summaries and exact conversation references; `count_conversations` counts every match. Each item already carries its title, summary, outcome, sentiment, workers and tool calls (how many, how many failed, the latest failure), often enough to answer. `sort`: `started` (newest first), `last_message` (latest activity first) or `changed`, the feed of status, outcome and analysis changes, oldest first, that systems poll from a saved `pageInfo.nextCursor` (a deleted conversation appears once with `deletedAt`). Next: `get_conversation` for a transcript.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -73695,7 +74109,7 @@ var schemaComponents = {
         type: "string"
       },
       resourceType: {
-        description: "What changed: `contact`, `contact_point`, `contact_identifier`, `agent`, `agent_tool` (its id is the Agent's), `channel`, `definition`, `knowledge_document`, `campaign`, `suppression`, `bulletin`, `provider_account`, `fact`, `task` (a person cancelled or retried it).",
+        description: "What changed: `contact`, `contact_point`, `contact_identifier`, `agent`, `agent_tool` (its id is the Agent's), `channel`, `definition`, `knowledge_document`, `campaign`, `suppression`, `bulletin`, `conversation_view`, `provider_account`, `fact`, `task` (a person cancelled or retried it).",
         type: "string"
       },
       sourceId: {
@@ -75230,6 +75644,7 @@ var schemaComponents = {
       "updatedAt",
       "version",
       "workers",
+      "toolCalls",
       "analysisErrorCode",
       "facts"
     ],
@@ -75811,6 +76226,9 @@ var schemaComponents = {
           description: "Who works the conversation for the organization."
         }
       },
+      toolCalls: {
+        $ref: "#/components/schemas/RaizConversationToolCalls"
+      },
       analysisErrorCode: {
         anyOf: [
           {
@@ -75851,6 +76269,68 @@ var schemaComponents = {
       }
     }
   },
+  RaizConversationCount: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "capped",
+      "count",
+      "averageDurationSeconds",
+      "averageMessageCount",
+      "groups"
+    ],
+    properties: {
+      capped: {
+        description: "True when the count reached 10000: at least that many match.",
+        type: "boolean"
+      },
+      count: {
+        description: "How many match the filters, counted up to 10000.",
+        maximum: 1e4,
+        minimum: 0,
+        type: "integer"
+      },
+      averageDurationSeconds: {
+        anyOf: [
+          {
+            description: "The average duration of the calls among them, in seconds; null when none has one.",
+            minimum: 0,
+            type: "number"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      averageMessageCount: {
+        anyOf: [
+          {
+            description: "Their average number of messages; null when there are none.",
+            minimum: 0,
+            type: "number"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      groups: {
+        anyOf: [
+          {
+            description: "With `groupBy`: the counted conversations by group, largest first, at most 100. A conversation counts once per group; with `tool`, once in each tool it used.",
+            maxItems: 100,
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/RaizConversationGroup"
+            }
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    }
+  },
   RaizConversationDiagnostics: {
     additionalProperties: false,
     type: "object",
@@ -75998,6 +76478,116 @@ var schemaComponents = {
       }
     }
   },
+  RaizConversationGroup: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "averageDurationSeconds",
+      "averageMessageCount",
+      "count",
+      "failed",
+      "key",
+      "label",
+      "outcomes"
+    ],
+    properties: {
+      averageDurationSeconds: {
+        anyOf: [
+          {
+            description: "The average duration of the calls among them, in seconds; null when none has one.",
+            minimum: 0,
+            type: "number"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      averageMessageCount: {
+        anyOf: [
+          {
+            description: "Their average number of messages; null when there are none.",
+            minimum: 0,
+            type: "number"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      count: {
+        description: "Conversations in the group.",
+        minimum: 0,
+        type: "integer"
+      },
+      failed: {
+        anyOf: [
+          {
+            description: "For `tool`: conversations where a call of the tool failed. Null for other groupings.",
+            minimum: 0,
+            type: "integer"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      key: {
+        anyOf: [
+          {
+            description: "The group's value: an outcome, status, channel type, Agent id, sentiment, tool name, error code (or message, when a failure has no code) or fact value (an option's key or the text). Null: conversations without one (not analyzed, no Agent, no value).",
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      label: {
+        anyOf: [
+          {
+            description: "The value's name when the records have one: the Agent's name, the option's label, the most frequent error message.",
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      outcomes: {
+        $ref: "#/components/schemas/RaizConversationOutcomeCounts"
+      }
+    }
+  },
+  RaizConversationOutcomeCounts: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "failure",
+      "pending",
+      "success",
+      "unknown"
+    ],
+    properties: {
+      failure: {
+        minimum: 0,
+        type: "integer"
+      },
+      pending: {
+        description: "Not analyzed yet.",
+        minimum: 0,
+        type: "integer"
+      },
+      success: {
+        minimum: 0,
+        type: "integer"
+      },
+      unknown: {
+        minimum: 0,
+        type: "integer"
+      }
+    }
+  },
   RaizConversationPage: {
     additionalProperties: false,
     type: "object",
@@ -76025,6 +76615,458 @@ var schemaComponents = {
       }
     }
   },
+  RaizConversationToolCalls: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "count",
+      "failed",
+      "lastFailure"
+    ],
+    properties: {
+      count: {
+        description: "The Agent's tool calls in the conversation.",
+        minimum: 0,
+        type: "integer"
+      },
+      failed: {
+        description: "How many of them failed.",
+        minimum: 0,
+        type: "integer"
+      },
+      lastFailure: {
+        anyOf: [
+          {
+            $ref: "#/components/schemas/RaizConversationToolFailure",
+            description: "The conversation's latest failed tool call; null when none failed."
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    }
+  },
+  RaizConversationToolFailure: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "errorCode",
+      "errorMessage",
+      "toolName"
+    ],
+    properties: {
+      errorCode: {
+        anyOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      errorMessage: {
+        anyOf: [
+          {
+            description: "What the tool answered when it failed, up to 500 characters; the transcript has all of it.",
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      toolName: {
+        type: "string"
+      }
+    }
+  },
+  RaizConversationView: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "columns",
+      "createdAt",
+      "filters",
+      "groupBy",
+      "id",
+      "layout",
+      "mine",
+      "name",
+      "position",
+      "shared",
+      "sort",
+      "updatedAt",
+      "version"
+    ],
+    properties: {
+      columns: {
+        description: "The client's own column keys, in the order it shows them; empty for its default columns.",
+        maxItems: 24,
+        type: "array",
+        items: {
+          maxLength: 64,
+          minLength: 1,
+          pattern: "^[A-Za-z][A-Za-z0-9_.:-]*$",
+          type: "string"
+        }
+      },
+      createdAt: {
+        description: "An instant in RFC 3339 format, in UTC.",
+        format: "date-time",
+        type: "string"
+      },
+      filters: {
+        $ref: "#/components/schemas/RaizConversationViewFilters",
+        description: "The filters of `list_conversations` under the same names, passed to it and to `count_conversations` as they are. A rolling `period` keeps the view moving with the calendar; `startedAfter`/`startedBefore` fix it to dates."
+      },
+      groupBy: {
+        anyOf: [
+          {
+            description: "How the view groups its conversations: `outcome`, `status`, `channel`, `agent`, `sentiment`, `tool` or `fact:<definition key>` (such as the reason for contact); `count_conversations` takes the same value as `groupBy`.",
+            pattern: "^(outcome|status|channel|agent|sentiment|tool|fact:[a-z][a-z0-9_]{0,63})$",
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      id: {
+        description: "Saved view id.",
+        examples: [
+          "cvw_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^cvw_(?:[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"
+      },
+      layout: {
+        description: "`table`: rows with columns; `reading`: the list beside one conversation, to read them one after another.",
+        anyOf: [
+          {
+            const: "table",
+            type: "string"
+          },
+          {
+            const: "reading",
+            type: "string"
+          }
+        ]
+      },
+      mine: {
+        description: "The caller saved it.",
+        type: "boolean"
+      },
+      name: {
+        type: "string"
+      },
+      position: {
+        description: "Where the view goes in the list of views, lowest first; views with the same position keep the order they were saved in.",
+        maximum: 1e5,
+        minimum: 0,
+        type: "integer"
+      },
+      shared: {
+        description: "`true`: everyone in the organization sees and can change it; `false`: only the person who saved it.",
+        type: "boolean"
+      },
+      sort: {
+        description: "`started` (newest first) or `last_message` (latest activity first).",
+        anyOf: [
+          {
+            const: "started",
+            type: "string"
+          },
+          {
+            const: "last_message",
+            type: "string"
+          }
+        ]
+      },
+      updatedAt: {
+        description: "An instant in RFC 3339 format, in UTC.",
+        format: "date-time",
+        type: "string"
+      },
+      version: {
+        minimum: 1,
+        type: "integer"
+      }
+    }
+  },
+  RaizConversationViewFilters: {
+    additionalProperties: false,
+    type: "object",
+    properties: {
+      agentId: {
+        description: "Agent id.",
+        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"
+      },
+      campaignId: {
+        description: "Attempts of this campaign.",
+        examples: [
+          "cmp_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^cmp_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$",
+        type: "string"
+      },
+      channelId: {
+        description: "Channel id.",
+        examples: [
+          "chn_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^(?:chn_(?:[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}))|(?:agc)_(?:[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"
+      },
+      channelType: {
+        description: "Comma-separated channel types.",
+        pattern: "^(voice|whatsapp|web)(,(voice|whatsapp|web))*$",
+        type: "string"
+      },
+      contactId: {
+        description: "Conversations with this contact as counterpart or subject. A merged duplicate's id lists the survivor's.",
+        examples: [
+          "cnt_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^cnt_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$",
+        type: "string"
+      },
+      conversationDirection: {
+        description: "`inbound`: the contact started it; `outbound`: the organization did. It matches each conversation's `direction` (the query field `direction` pages the list).",
+        anyOf: [
+          {
+            const: "inbound",
+            type: "string"
+          },
+          {
+            const: "outbound",
+            type: "string"
+          }
+        ]
+      },
+      handling: {
+        description: "`ai`: conversations the AI takes part in (calls and web chats, and WhatsApp conversations the AI handles or answered). `team`: WhatsApp conversations the organization's people handle on their own. `escalated`: conversations the AI handed to the team (a request it could not resolve, a contact who asked for a person, or a spent budget), also once the team gave them back to the AI; the ones `conversations_daily` counts in `escalatedCount`. A trial is not one, nor a conversation that opens while the AI is still paused for the number after an earlier handoff.",
+        anyOf: [
+          {
+            const: "ai",
+            type: "string"
+          },
+          {
+            const: "team",
+            type: "string"
+          },
+          {
+            const: "escalated",
+            type: "string"
+          }
+        ]
+      },
+      worker: {
+        description: "Who works the conversation now. `ai`: calls and web chats, open WhatsApp conversations the AI answers (assigned to it and not paused), and closed ones the AI answered. `team`: open WhatsApp conversations the organization's people answer (not assigned to the AI, or paused) and closed ones they answered. Unlike `handling`, a conversation the AI answered and then handed to people is `team` while open.",
+        anyOf: [
+          {
+            const: "ai",
+            type: "string"
+          },
+          {
+            const: "team",
+            type: "string"
+          }
+        ]
+      },
+      origin: {
+        description: "Comma-separated origins.",
+        pattern: "^(inbound|manual|api|campaign|import|test)(,(inbound|manual|api|campaign|import|test))*$",
+        type: "string"
+      },
+      outcome: {
+        description: "Comma-separated outcomes of the analysis.",
+        pattern: "^(success|failure|unknown)(,(success|failure|unknown))*$",
+        type: "string"
+      },
+      metadataReference: {
+        description: "Conversations whose `metadata.reference` is exactly this value: the reference a caller gave `createConversation`, to find a conversation whose answer it did not receive.",
+        maxLength: 500,
+        minLength: 1,
+        type: "string"
+      },
+      profileId: {
+        description: "Conversations started from this communication profile.",
+        examples: [
+          "prf_01m45h8q2rf3t9w6y7z0b1c2d3"
+        ],
+        pattern: "^prf_(?:[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"
+      },
+      q: {
+        description: "Search participant names, channel profile names, usernames, phones, emails, identity documents, visible message text, conversation ids and exact external references. Ignores accents/case and phone/document formatting. Also searches titles and summaries with Spanish stemming (quoted phrases, `or` and `-word` apply there). Attachments without stored transcription and tool payloads are not searched.",
+        maxLength: 200,
+        minLength: 1,
+        type: "string"
+      },
+      requestedBy: {
+        description: "Conversations started with `createConversation` by this token subject (exact match): a machine client reads its own requests with `<client id>@clients`.",
+        maxLength: 255,
+        minLength: 1,
+        type: "string"
+      },
+      startedAfter: {
+        description: "Started at or after this instant (RFC 3339).",
+        format: "date-time",
+        type: "string"
+      },
+      startedBefore: {
+        description: "Started before this instant (RFC 3339).",
+        format: "date-time",
+        type: "string"
+      },
+      status: {
+        anyOf: [
+          {
+            const: "open",
+            type: "string"
+          },
+          {
+            const: "closed",
+            type: "string"
+          }
+        ]
+      },
+      period: {
+        description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+        anyOf: [
+          {
+            const: "today",
+            type: "string"
+          },
+          {
+            const: "7d",
+            type: "string"
+          },
+          {
+            const: "30d",
+            type: "string"
+          },
+          {
+            const: "90d",
+            type: "string"
+          },
+          {
+            const: "365d",
+            type: "string"
+          }
+        ]
+      },
+      sentiment: {
+        description: "Comma-separated sentiments of the analysis.",
+        pattern: "^(positive|neutral|negative)(,(positive|neutral|negative))*$",
+        type: "string"
+      },
+      toolName: {
+        description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each.",
+        maxLength: 128,
+        minLength: 1,
+        type: "string"
+      },
+      toolStatus: {
+        description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+        anyOf: [
+          {
+            const: "completed",
+            type: "string"
+          },
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "denied",
+            type: "string"
+          }
+        ]
+      },
+      factDefinition: {
+        description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value.",
+        pattern: "^[a-z][a-z0-9_]{0,63}$",
+        type: "string"
+      },
+      factValue: {
+        description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`.",
+        maxLength: 500,
+        minLength: 1,
+        type: "string"
+      },
+      assessment: {
+        description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+        anyOf: [
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "passed",
+            type: "string"
+          }
+        ]
+      },
+      toReview: {
+        description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others.",
+        type: "boolean"
+      },
+      messagesMin: {
+        description: "At least this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      messagesMax: {
+        description: "At most this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMin: {
+        description: "Calls of at least this many seconds.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMax: {
+        description: "Calls of at most this many seconds.",
+        minimum: 0,
+        type: "integer"
+      }
+    }
+  },
+  RaizConversationViewPage: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "data",
+      "object",
+      "pageInfo"
+    ],
+    properties: {
+      data: {
+        description: "Items admitted by this resource contract within the verified organization.",
+        type: "array",
+        items: {
+          $ref: "#/components/schemas/RaizConversationView"
+        }
+      },
+      object: {
+        description: "Discriminator for a resource list response.",
+        const: "list",
+        type: "string"
+      },
+      pageInfo: {
+        $ref: "#/components/schemas/PageInfo",
+        description: "Opaque navigation cursors for this page’s stable keyset order."
+      }
+    }
+  },
   RaizConversationWorker: {
     anyOf: [
       {
@@ -77185,6 +78227,7 @@ var schemaComponents = {
         required: [
           "id",
           "key",
+          "kind",
           "name",
           "valueType"
         ],
@@ -77200,6 +78243,27 @@ var schemaComponents = {
           key: {
             type: "string"
           },
+          kind: {
+            description: "What the definition captures: an `attribute` (a datum), an `assessment` (a yes/no check of the conversation), a `category` (a classification such as the reason for contact) or a `metric`.",
+            anyOf: [
+              {
+                const: "attribute",
+                type: "string"
+              },
+              {
+                const: "assessment",
+                type: "string"
+              },
+              {
+                const: "category",
+                type: "string"
+              },
+              {
+                const: "metric",
+                type: "string"
+              }
+            ]
+          },
           name: {
             type: "string"
           },
@@ -77870,11 +78934,98 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DAILY_REPORT_IN_PROGRESS",
+                const: "DAILY_REPORT_IN_PROGRESS",
+                type: "string"
+              },
+              message: {
+                const: "The daily report you asked for is still on its way; it arrives within a minute.",
+                type: "string"
+              },
+              retryable: {
+                const: false,
+                type: "boolean"
+              },
+              data: {
+                additionalProperties: false,
+                type: "object",
+                properties: {}
+              }
+            }
+          },
+          {
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "code",
+              "message",
+              "retryable",
+              "data"
+            ],
+            properties: {
+              code: {
+                const: "DAILY_REPORT_RECIPIENTS_MISSING",
+                type: "string"
+              },
+              message: {
+                const: "The daily report has no recipients. Add them in `settings.dailyReport.recipients` first.",
+                type: "string"
+              },
+              retryable: {
+                const: false,
+                type: "boolean"
+              },
+              data: {
+                additionalProperties: false,
+                type: "object",
+                properties: {}
+              }
+            }
+          },
+          {
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "code",
+              "message",
+              "retryable",
+              "data"
+            ],
+            properties: {
+              code: {
+                const: "DEFINITION_NOT_ACTIVE",
+                type: "string"
+              },
+              message: {
+                const: "Facts can be asserted only under an active definition.",
+                type: "string"
+              },
+              retryable: {
+                const: false,
+                type: "boolean"
+              },
+              data: {
+                additionalProperties: false,
+                type: "object",
+                properties: {}
+              }
+            }
+          },
+          {
+            additionalProperties: false,
+            type: "object",
+            required: [
+              "code",
+              "message",
+              "retryable",
+              "data"
+            ],
+            properties: {
+              code: {
+                const: "DEFINITION_OPTIONS_INVALID",
                 type: "string"
               },
               message: {
-                const: "The daily report you asked for is still on its way; it arrives within a minute.",
+                const: "Only a definition whose value type is `option` has options; it needs at least one, and option keys must be unique.",
                 type: "string"
               },
               retryable: {
@@ -77899,11 +79050,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DAILY_REPORT_RECIPIENTS_MISSING",
+                const: "DEFINITION_RETIRED",
                 type: "string"
               },
               message: {
-                const: "The daily report has no recipients. Add them in `settings.dailyReport.recipients` first.",
+                const: "The definition is retired and can no longer change.",
                 type: "string"
               },
               retryable: {
@@ -77928,11 +79079,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DEFINITION_NOT_ACTIVE",
+                const: "DEFINITION_TYPE_LOCKED",
                 type: "string"
               },
               message: {
-                const: "Facts can be asserted only under an active definition.",
+                const: "The value type and subject of a definition cannot change once it has facts. Retire it and create a new one instead.",
                 type: "string"
               },
               retryable: {
@@ -77957,11 +79108,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DEFINITION_OPTIONS_INVALID",
+                const: "FACT_SUBJECT_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "Only a definition whose value type is `option` has options; it needs at least one, and option keys must be unique.",
+                const: "The fact's subject (a contact or a conversation) does not match what its definition describes.",
                 type: "string"
               },
               retryable: {
@@ -77986,11 +79137,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DEFINITION_RETIRED",
+                const: "FACT_VALUE_INVALID",
                 type: "string"
               },
               message: {
-                const: "The definition is retired and can no longer change.",
+                const: "The value does not match the definition's value type, or names no active option.",
                 type: "string"
               },
               retryable: {
@@ -78015,11 +79166,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "DEFINITION_TYPE_LOCKED",
+                const: "HANDOFF_ALREADY_CONTINUED",
                 type: "string"
               },
               message: {
-                const: "The value type and subject of a definition cannot change once it has facts. Retire it and create a new one instead.",
+                const: "This handoff was already given back to the AI to continue. It continues once per handoff; a new escalation can be given back again.",
                 type: "string"
               },
               retryable: {
@@ -78044,15 +79195,15 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "FACT_SUBJECT_MISMATCH",
+                const: "REPLY_IN_PROGRESS",
                 type: "string"
               },
               message: {
-                const: "The fact's subject (a contact or a conversation) does not match what its definition describes.",
+                const: "The Agent is still replying in this conversation. Try again once the reply is delivered.",
                 type: "string"
               },
               retryable: {
-                const: false,
+                const: true,
                 type: "boolean"
               },
               data: {
@@ -78073,11 +79224,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "FACT_VALUE_INVALID",
+                const: "IMPORT_FILE_INVALID",
                 type: "string"
               },
               message: {
-                const: "The value does not match the definition's value type, or names no active option.",
+                const: "The import file is not valid base64 of UTF-8 text. Save the spreadsheet as CSV UTF-8 and try again.",
                 type: "string"
               },
               retryable: {
@@ -78102,11 +79253,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "HANDOFF_ALREADY_CONTINUED",
+                const: "IMPORT_FILE_TOO_LARGE",
                 type: "string"
               },
               message: {
-                const: "This handoff was already given back to the AI to continue. It continues once per handoff; a new escalation can be given back again.",
+                const: "The import file is larger than 12 MB. Split it into several files.",
                 type: "string"
               },
               retryable: {
@@ -78131,15 +79282,15 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "REPLY_IN_PROGRESS",
+                const: "IP_NETWORK_INVALID",
                 type: "string"
               },
               message: {
-                const: "The Agent is still replying in this conversation. Try again once the reply is delivered.",
+                const: "The IP network is not a valid IPv4 or IPv6 address or CIDR block.",
                 type: "string"
               },
               retryable: {
-                const: true,
+                const: false,
                 type: "boolean"
               },
               data: {
@@ -78160,11 +79311,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "IMPORT_FILE_INVALID",
+                const: "OUTSIDE_CONTACT_HOURS",
                 type: "string"
               },
               message: {
-                const: "The import file is not valid base64 of UTF-8 text. Save the spreadsheet as CSV UTF-8 and try again.",
+                const: "The profile's contact hours do not allow starting a conversation now. Try again within them.",
                 type: "string"
               },
               retryable: {
@@ -78189,11 +79340,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "IMPORT_FILE_TOO_LARGE",
+                const: "PROFILE_VARIABLE_MISSING",
                 type: "string"
               },
               message: {
-                const: "The import file is larger than 12 MB. Split it into several files.",
+                const: "The profile's template parameters reference a variable that `variables` does not give.",
                 type: "string"
               },
               retryable: {
@@ -78218,11 +79369,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "IP_NETWORK_INVALID",
+                const: "PROVIDER_ACCOUNT_EXISTS",
                 type: "string"
               },
               message: {
-                const: "The IP network is not a valid IPv4 or IPv6 address or CIDR block.",
+                const: "This provider account is already registered.",
                 type: "string"
               },
               retryable: {
@@ -78247,11 +79398,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "OUTSIDE_CONTACT_HOURS",
+                const: "PROVIDER_ACCOUNT_IN_USE",
                 type: "string"
               },
               message: {
-                const: "The profile's contact hours do not allow starting a conversation now. Try again within them.",
+                const: "Channels or Agents still use this provider account. Move them to another account first.",
                 type: "string"
               },
               retryable: {
@@ -78276,11 +79427,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "PROFILE_VARIABLE_MISSING",
+                const: "REPORT_FILTER_UNSUPPORTED",
                 type: "string"
               },
               message: {
-                const: "The profile's template parameters reference a variable that `variables` does not give.",
+                const: "A filter does not apply to the selected report.",
                 type: "string"
               },
               retryable: {
@@ -78305,11 +79456,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "PROVIDER_ACCOUNT_EXISTS",
+                const: "REPORT_RANGE_INVALID",
                 type: "string"
               },
               message: {
-                const: "This provider account is already registered.",
+                const: "The report range is invalid: `from` must not be after `to`.",
                 type: "string"
               },
               retryable: {
@@ -78334,11 +79485,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "PROVIDER_ACCOUNT_IN_USE",
+                const: "SOURCE_CONVERSATION_OPEN",
                 type: "string"
               },
               message: {
-                const: "Channels or Agents still use this provider account. Move them to another account first.",
+                const: "A fact can cite only a closed conversation as its source.",
                 type: "string"
               },
               retryable: {
@@ -78363,11 +79514,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "REPORT_FILTER_UNSUPPORTED",
+                const: "SUPPRESSION_EXISTS",
                 type: "string"
               },
               message: {
-                const: "A filter does not apply to the selected report.",
+                const: "This organization already has this suppression rule.",
                 type: "string"
               },
               retryable: {
@@ -78392,11 +79543,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "REPORT_RANGE_INVALID",
+                const: "TASK_NOT_RETRYABLE",
                 type: "string"
               },
               message: {
-                const: "The report range is invalid: `from` must not be after `to`.",
+                const: "This task cannot be retried: its kind never retries, or it already used every attempt. Start it again from its resource.",
                 type: "string"
               },
               retryable: {
@@ -78421,11 +79572,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "SOURCE_CONVERSATION_OPEN",
+                const: "TIME_ZONE_UNKNOWN",
                 type: "string"
               },
               message: {
-                const: "A fact can cite only a closed conversation as its source.",
+                const: "The time zone is not in the IANA time zone database.",
                 type: "string"
               },
               retryable: {
@@ -78450,11 +79601,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "SUPPRESSION_EXISTS",
+                const: "CHANNEL_AGENT_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "This organization already has this suppression rule.",
+                const: "This Agent cannot serve this channel: voice channels need a voice Agent; WhatsApp and web channels need a text Agent.",
                 type: "string"
               },
               retryable: {
@@ -78479,11 +79630,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TASK_NOT_RETRYABLE",
+                const: "CHANNEL_CREATION_IN_APP",
                 type: "string"
               },
               message: {
-                const: "This task cannot be retried: its kind never retries, or it already used every attempt. Start it again from its resource.",
+                const: "An AI tool creates website chats and forms only. A person adds WhatsApp numbers and phone numbers in Settings → Channels, or through the REST API.",
                 type: "string"
               },
               retryable: {
@@ -78508,11 +79659,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "TIME_ZONE_UNKNOWN",
+                const: "CHANNEL_AGENT_REQUIRED",
                 type: "string"
               },
               message: {
-                const: "The time zone is not in the IANA time zone database.",
+                const: "Inbound traffic requires an assigned Agent. Outbound traffic requires one except on WhatsApp notification channels.",
                 type: "string"
               },
               retryable: {
@@ -78537,11 +79688,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_AGENT_MISMATCH",
+                const: "CHANNEL_ENDPOINT_IN_USE",
                 type: "string"
               },
               message: {
-                const: "This Agent cannot serve this channel: voice channels need a voice Agent; WhatsApp and web channels need a text Agent.",
+                const: "Another channel already uses this number or endpoint.",
                 type: "string"
               },
               retryable: {
@@ -78566,11 +79717,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_CREATION_IN_APP",
+                const: "CHANNEL_NOT_READY",
                 type: "string"
               },
               message: {
-                const: "An AI tool creates website chats and forms only. A person adds WhatsApp numbers and phone numbers in Settings → Channels, or through the REST API.",
+                const: "The channel is not connected yet, or this kind of traffic is not enabled on it.",
                 type: "string"
               },
               retryable: {
@@ -78595,11 +79746,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_AGENT_REQUIRED",
+                const: "CHANNEL_TYPE_MISMATCH",
                 type: "string"
               },
               message: {
-                const: "Inbound traffic requires an assigned Agent. Outbound traffic requires one except on WhatsApp notification channels.",
+                const: "This operation or field does not apply to this channel's type.",
                 type: "string"
               },
               retryable: {
@@ -78624,11 +79775,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_ENDPOINT_IN_USE",
+                const: "CONVERSATION_VIEW_AUTHOR_ONLY",
                 type: "string"
               },
               message: {
-                const: "Another channel already uses this number or endpoint.",
+                const: "Only the person who saved this view can make it private; it would disappear for the rest of the team.",
                 type: "string"
               },
               retryable: {
@@ -78653,11 +79804,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_NOT_READY",
+                const: "CONVERSATION_VIEW_LIMIT_REACHED",
                 type: "string"
               },
               message: {
-                const: "The channel is not connected yet, or this kind of traffic is not enabled on it.",
+                const: "The organization already has 200 saved views. Delete one before saving another.",
                 type: "string"
               },
               retryable: {
@@ -78682,11 +79833,11 @@ var schemaComponents = {
             ],
             properties: {
               code: {
-                const: "CHANNEL_TYPE_MISMATCH",
+                const: "CONVERSATION_VIEW_NAME_TAKEN",
                 type: "string"
               },
               message: {
-                const: "This operation or field does not apply to this channel's type.",
+                const: "Another saved view already has this name. Choose a different name.",
                 type: "string"
               },
               retryable: {
@@ -111722,6 +112873,107 @@ var schemaComponents = {
           }
         ]
       },
+      period: {
+        description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+        anyOf: [
+          {
+            const: "today",
+            type: "string"
+          },
+          {
+            const: "7d",
+            type: "string"
+          },
+          {
+            const: "30d",
+            type: "string"
+          },
+          {
+            const: "90d",
+            type: "string"
+          },
+          {
+            const: "365d",
+            type: "string"
+          }
+        ]
+      },
+      sentiment: {
+        description: "Comma-separated sentiments of the analysis.",
+        pattern: "^(positive|neutral|negative)(,(positive|neutral|negative))*$",
+        type: "string"
+      },
+      toolName: {
+        description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each.",
+        maxLength: 128,
+        minLength: 1,
+        type: "string"
+      },
+      toolStatus: {
+        description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+        anyOf: [
+          {
+            const: "completed",
+            type: "string"
+          },
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "denied",
+            type: "string"
+          }
+        ]
+      },
+      factDefinition: {
+        description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value.",
+        pattern: "^[a-z][a-z0-9_]{0,63}$",
+        type: "string"
+      },
+      factValue: {
+        description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`.",
+        maxLength: 500,
+        minLength: 1,
+        type: "string"
+      },
+      assessment: {
+        description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+        anyOf: [
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "passed",
+            type: "string"
+          }
+        ]
+      },
+      toReview: {
+        description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others.",
+        type: "boolean"
+      },
+      messagesMin: {
+        description: "At least this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      messagesMax: {
+        description: "At most this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMin: {
+        description: "Calls of at least this many seconds.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMax: {
+        description: "Calls of at most this many seconds.",
+        minimum: 0,
+        type: "integer"
+      },
       sort: {
         default: "started",
         description: "`started` (newest first), `last_message` (most recent activity first) or `changed`: the changed feed, oldest change first, with deleted conversations as tombstones; a forward page's `pageInfo.nextCursor` is always a position to save and poll from.",
@@ -112073,6 +113325,112 @@ var schemaComponents = {
             type: "string"
           }
         ]
+      },
+      period: {
+        description: "Started today or in the last 7, 30, 90 or 365 days including today, counting days in the organization's time zone as `get_report` does. A saved view keeps its period this way, so it moves with the calendar.",
+        anyOf: [
+          {
+            const: "today",
+            type: "string"
+          },
+          {
+            const: "7d",
+            type: "string"
+          },
+          {
+            const: "30d",
+            type: "string"
+          },
+          {
+            const: "90d",
+            type: "string"
+          },
+          {
+            const: "365d",
+            type: "string"
+          }
+        ]
+      },
+      sentiment: {
+        description: "Comma-separated sentiments of the analysis.",
+        pattern: "^(positive|neutral|negative)(,(positive|neutral|negative))*$",
+        type: "string"
+      },
+      toolName: {
+        description: "Conversations where the Agent called this tool: its exact name, as the transcript's tool parts show it (`toolName`). `count_conversations` with `groupBy=tool` lists the names with how many conversations used each.",
+        maxLength: 128,
+        minLength: 1,
+        type: "string"
+      },
+      toolStatus: {
+        description: "With `toolName`, a call of that tool ended this way; alone, a call of any tool did (`failed`: conversations where a tool failed).",
+        anyOf: [
+          {
+            const: "completed",
+            type: "string"
+          },
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "denied",
+            type: "string"
+          }
+        ]
+      },
+      factDefinition: {
+        description: "Conversations whose current fact of this definition (its `key`) is known: about the conversation, or about its contact for a contact definition. With `factValue`, equal to that value.",
+        pattern: "^[a-z][a-z0-9_]{0,63}$",
+        type: "string"
+      },
+      factValue: {
+        description: "With `factDefinition`: an option's key or label, a text (ignoring case), a number, a date (YYYY-MM-DD) or `true`/`false`.",
+        maxLength: 500,
+        minLength: 1,
+        type: "string"
+      },
+      assessment: {
+        description: "The conversation's yes/no assessments: `failed`, at least one answered no; `passed`, at least one answered and every answered one yes.",
+        anyOf: [
+          {
+            const: "failed",
+            type: "string"
+          },
+          {
+            const: "passed",
+            type: "string"
+          }
+        ]
+      },
+      toReview: {
+        description: "`true`: conversations to review, as `get_report` counts them in `toReviewCount`: the analysis says the request was not resolved, or the AI handed the conversation to the team. `false`: the others.",
+        type: "boolean"
+      },
+      messagesMin: {
+        description: "At least this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      messagesMax: {
+        description: "At most this many messages.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMin: {
+        description: "Calls of at least this many seconds.",
+        minimum: 0,
+        type: "integer"
+      },
+      durationMax: {
+        description: "Calls of at most this many seconds.",
+        minimum: 0,
+        type: "integer"
+      },
+      groupBy: {
+        description: "`outcome`, `status`, `channel` (type), `agent`, `sentiment`, `tool` (each Agent tool and the conversations that used it), `toolError` (failed calls, of `toolName` when given, by error) or `fact:<definition key>` (the current value of that definition, such as the reason for contact).",
+        pattern: "^(outcome|status|channel|agent|sentiment|tool|toolError|fact:[a-z][a-z0-9_]{0,63})$",
+        type: "string"
       }
     },
     additionalProperties: false
@@ -118537,9 +119895,9 @@ var schemaComponents = {
 // src/generated/generation.json
 var generation_default = {
   formatVersion: 6,
-  release: "1.20261101.50133",
-  openapiSha256: "8d21074b9ddd85fdc62f5e87426ea93caa0b71de564823fe856a4fb91ec75f83",
-  openapiContentSha256: "b5391b5c8b2e6b4cb27f0005a1fdb1b50531d5f455fb868b039f51e7587e03da",
+  release: "1.20261101.92027",
+  openapiSha256: "abc86d5374ddfc56957e7ae9960f95a6682aa3886c075a1c17ba8d9d51cd2490",
+  openapiContentSha256: "e9be828ee9b2d19b0f340ec445d812a85a2a24ab2ccb9577e74bdfc058336af2",
   forge: {
     repository: "https://github.com/cloudflare/forge",
     commit: "7f86447210b7bea3779bfdab3cd5655eade0eadb",
@@ -118552,7 +119910,7 @@ var generation_default = {
   outputs: [
     {
       path: "src/generated/commands.ts",
-      sha256: "8a2743d6daadceddc6436c7df70ffeb94ae53fc351ebce56b4717938555b24a7"
+      sha256: "7ce6fc11bc507fc2f1370c2e7b4ae31605eb62606e37e2d3b4230abdc1f2ae80"
     }
   ]
 };
@@ -118907,7 +120265,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "3.25.0";
+var VERSION = "3.27.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();