@arbol-ai/cli 2.5.0 → 2.6.0

package/dist/index.js

@@ -20541,6 +20541,14 @@ var commands = {
           "CC"
         ]
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -20584,6 +20592,11 @@ var commands = {
             }
           ]
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -20695,6 +20708,14 @@ var commands = {
         required: true,
         description: "The appointment's hour as HH:MM, exactly as list_appointments returned it."
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -20861,6 +20882,11 @@ var commands = {
           description: "The appointment's hour as HH:MM, exactly as list_appointments returned it.",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -20981,6 +21007,14 @@ var commands = {
         required: true,
         description: "The hour the caller agreed to, as HH:MM on a 24-hour clock, exactly as it appeared in find_availability's times[]."
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -21154,6 +21188,11 @@ var commands = {
           description: "The hour the caller agreed to, as HH:MM on a 24-hour clock, exactly as it appeared in find_availability's times[].",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -21259,6 +21298,14 @@ var commands = {
         description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
         default: 25
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -21409,6 +21456,11 @@ var commands = {
           type: "integer",
           default: 25
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -21461,7 +21513,7 @@ var commands = {
         flag: "date",
         kind: "string",
         required: false,
-        description: `A day to look at, as YYYY-MM-DD. Omit it for the soonest day with room. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`
+        description: `A day the person asked for, as YYYY-MM-DD. Its openings come first; when it has none, the openings nearest to it on either side are offered instead and requestedDateAvailable is false. Omit it for the soonest openings. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`
       },
       {
         name: "documentNumber",
@@ -21506,7 +21558,7 @@ var commands = {
         flag: "allow-other-professionals",
         kind: "string",
         required: false,
-        description: "When true, a requested doctor with no openings falls back automatically to other doctors of the same service. Present their names and obtain consent before booking.",
+        description: "Whether other doctors of this service may be offered when the named doctor has no opening in the searched window. Defaults to true: the named doctor's openings come first, and only when that doctor has none are the other doctors' nearest openings returned, with requestedProfessionalAvailable false. Name the actual doctor of each option and obtain consent before booking. False keeps the named doctor as a strict filter.",
         choices: [
           "true",
           "false"
@@ -21517,7 +21569,7 @@ var commands = {
         flag: "from-date",
         kind: "string",
         required: false,
-        description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date only for an exact day."
+        description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date for a specific day."
       },
       {
         name: "timeFrom",
@@ -21568,7 +21620,7 @@ var commands = {
         flag: "professional",
         kind: "string",
         required: false,
-        description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest."
+        description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest."
       },
       {
         name: "serviceId",
@@ -21577,6 +21629,14 @@ var commands = {
         required: true,
         description: "Exact service in the order or a previously returned service ID. Names are resolved internally against the live catalog; do not call list_services first or invent IDs. Preserve consultation/control and pediatric qualifiers."
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -21618,7 +21678,7 @@ var commands = {
           ]
         },
         date: {
-          description: `A day to look at, as YYYY-MM-DD. Omit it for the soonest day with room. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
+          description: `A day the person asked for, as YYYY-MM-DD. Its openings come first; when it has none, the openings nearest to it on either side are offered instead and requestedDateAvailable is false. Omit it for the soonest openings. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
           anyOf: [
             {
               type: "string"
@@ -21726,7 +21786,7 @@ var commands = {
           description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
         },
         allowOtherProfessionals: {
-          description: "When true, a requested doctor with no openings falls back automatically to other doctors of the same service. Present their names and obtain consent before booking.",
+          description: "Whether other doctors of this service may be offered when the named doctor has no opening in the searched window. Defaults to true: the named doctor's openings come first, and only when that doctor has none are the other doctors' nearest openings returned, with requestedProfessionalAvailable false. Name the actual doctor of each option and obtain consent before booking. False keeps the named doctor as a strict filter.",
           anyOf: [
             {
               const: "true",
@@ -21742,7 +21802,7 @@ var commands = {
           ]
         },
         fromDate: {
-          description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date only for an exact day.",
+          description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date for a specific day.",
           anyOf: [
             {
               type: "string"
@@ -21822,7 +21882,7 @@ var commands = {
           ]
         },
         professional: {
-          description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest.",
+          description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest.",
           anyOf: [
             {
               type: "string"
@@ -21836,6 +21896,11 @@ var commands = {
           description: "Exact service in the order or a previously returned service ID. Names are resolved internally against the live catalog; do not call list_services first or invent IDs. Preserve consultation/control and pediatric qualifiers.",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -21907,6 +21972,14 @@ var commands = {
         required: true,
         description: "Issuer code before the hyphen in the authorization identifier."
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -21960,6 +22033,11 @@ var commands = {
           description: "Issuer code before the hyphen in the authorization identifier.",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -22057,7 +22135,7 @@ var commands = {
         flag: "professional",
         kind: "string",
         required: false,
-        description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest."
+        description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest."
       },
       {
         name: "serviceId",
@@ -22066,6 +22144,14 @@ var commands = {
         required: true,
         description: `What the appointment is for: either an id from list_services or the service's own name, in the caller's words ("neurología", "control"). A name that matches more than one service is answered with the choices, so you can ask which one instead of guessing.`
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -22215,7 +22301,7 @@ var commands = {
           description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
         },
         professional: {
-          description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest.",
+          description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest.",
           anyOf: [
             {
               type: "string"
@@ -22229,6 +22315,11 @@ var commands = {
           description: `What the appointment is for: either an id from list_services or the service's own name, in the caller's words ("neurología", "control"). A name that matches more than one service is answered with the choices, so you can ask which one instead of guessing.`,
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -22268,7 +22359,16 @@ var commands = {
       "delete"
     ],
     pathField: "id",
-    fields: [],
+    fields: [
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      }
+    ],
     inputSchema: {
       additionalProperties: false,
       type: "object",
@@ -22282,6 +22382,11 @@ var commands = {
           pattern: "^[A-Za-z0-9_-]+$",
           description: "The connection's id, as Account lists it; it must be one of the caller's own organization's.",
           type: "string"
+        },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
         }
       }
     },
@@ -22299,7 +22404,16 @@ var commands = {
       "get"
     ],
     pathField: "id",
-    fields: [],
+    fields: [
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      }
+    ],
     inputSchema: {
       additionalProperties: false,
       type: "object",
@@ -22313,6 +22427,11 @@ var commands = {
           pattern: "^[A-Za-z0-9_-]+$",
           description: "The connection's id, as Account lists it; it must be one of the caller's own organization's.",
           type: "string"
+        },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
         }
       }
     },
@@ -22357,6 +22476,14 @@ var commands = {
         required: false,
         description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
         default: 25
+      },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
       }
     ],
     inputSchema: {
@@ -22388,6 +22515,11 @@ var commands = {
           description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
           type: "integer",
           default: 25
+        },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
         }
       }
     },
@@ -22406,6 +22538,14 @@ var commands = {
     ],
     pathField: "connectionId",
     fields: [
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "name",
         flag: "name",
@@ -22441,6 +22581,11 @@ var commands = {
         "logins"
       ],
       properties: {
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           minLength: 1,
           maxLength: 128,
@@ -22551,6 +22696,14 @@ var commands = {
         required: true,
         description: "Explicit four-digit year for copay history, from 2000 to 2099."
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -22599,6 +22752,11 @@ var commands = {
           description: "Explicit four-digit year for copay history, from 2000 to 2099.",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -22639,6 +22797,14 @@ var commands = {
     ],
     pathField: "operationId",
     fields: [
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -22670,6 +22836,11 @@ var commands = {
           description: "The operationId of the pending answer, exactly as it was returned.",
           type: "string"
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -22748,6 +22919,14 @@ var commands = {
           "TI"
         ]
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -22873,6 +23052,11 @@ var commands = {
           ],
           description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -22904,6 +23088,168 @@ var commands = {
     confirmation: null,
     hidden: false
   },
+  "sura professionals list": {
+    operation: "sura.professionals.list",
+    sdkPath: [
+      "sura",
+      "professionals",
+      "list"
+    ],
+    pathField: null,
+    fields: [
+      {
+        name: "areaId",
+        flag: "area-id",
+        kind: "string",
+        required: false,
+        description: "The areaId list_services returned beside that service. Pass it with an exact serviceId to skip a catalog lookup; omit it whenever you are naming the service in words."
+      },
+      {
+        name: "serviceId",
+        flag: "service-id",
+        kind: "string",
+        required: true,
+        description: "Exact numeric service id returned by list_services. This directory is not filtered by patient coverage or available appointments."
+      },
+      {
+        name: "cursor",
+        flag: "cursor",
+        kind: "string",
+        required: false,
+        description: "Opaque cursor returned by pageInfo; omit it to request the first page."
+      },
+      {
+        name: "direction",
+        flag: "direction",
+        kind: "string",
+        required: false,
+        description: "Direction to traverse the stable keyset ordering from the supplied cursor.",
+        choices: [
+          "forward",
+          "backward"
+        ],
+        default: "forward"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        kind: "integer",
+        required: false,
+        description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
+        default: 25
+      },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
+      {
+        name: "connectionId",
+        flag: "connection-id",
+        kind: "string",
+        required: false,
+        description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several."
+      },
+      {
+        name: "channel",
+        flag: "channel",
+        kind: "string",
+        required: false,
+        description: "The channel the caller is waiting on, which sets how long it waits before an answer comes back pending, and puts a phone call's reads ahead of others. Defaults to web.",
+        choices: [
+          "voice",
+          "whatsapp",
+          "web"
+        ]
+      }
+    ],
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      required: [
+        "serviceId"
+      ],
+      properties: {
+        areaId: {
+          description: "The areaId list_services returned beside that service. Pass it with an exact serviceId to skip a catalog lookup; omit it whenever you are naming the service in words.",
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        serviceId: {
+          description: "Exact numeric service id returned by list_services. This directory is not filtered by patient coverage or available appointments.",
+          pattern: "^[0-9]{1,20}$",
+          type: "string"
+        },
+        cursor: {
+          description: "Opaque cursor returned by pageInfo; omit it to request the first page.",
+          type: "string"
+        },
+        direction: {
+          description: "Direction to traverse the stable keyset ordering from the supplied cursor.",
+          anyOf: [
+            {
+              const: "forward",
+              type: "string"
+            },
+            {
+              const: "backward",
+              type: "string"
+            }
+          ],
+          default: "forward"
+        },
+        limit: {
+          minimum: 1,
+          maximum: 100,
+          description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
+          type: "integer",
+          default: 25
+        },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
+        connectionId: {
+          description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
+          maxLength: 128,
+          minLength: 1,
+          type: "string"
+        },
+        channel: {
+          anyOf: [
+            {
+              const: "voice",
+              type: "string"
+            },
+            {
+              const: "whatsapp",
+              type: "string"
+            },
+            {
+              const: "web",
+              type: "string"
+            }
+          ],
+          description: "The channel the caller is waiting on, which sets how long it waits before an answer comes back pending, and puts a phone call's reads ahead of others. Defaults to web."
+        }
+      }
+    },
+    title: "List registered professionals",
+    description: "List SURA's registered professionals for a service at this connection's institution, including doctors without published or free appointments. First obtain serviceId and optionally areaId from list_services. No patient identity is needed. Follow pageInfo.nextCursor while hasNextPage is true before concluding a name is absent from this scoped directory. Absence does not establish that a doctor does not exist or works nowhere else. Registration does not establish coverage, authorization, or availability: use prepare_appointment with the patient's evidence and the requested professional name to find actual slots. Never substitute another doctor without the patient's agreement. An unreadable or incomplete provider directory is a technical failure, not an empty list.",
+    effect: "read",
+    confirmation: null,
+    hidden: false
+  },
   "sura services list": {
     operation: "sura.services.list",
     sdkPath: [
@@ -22947,6 +23293,14 @@ var commands = {
         description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
         default: 25
       },
+      {
+        name: "agentMode",
+        flag: "agent-mode",
+        kind: "boolean",
+        required: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        default: false
+      },
       {
         name: "connectionId",
         flag: "connection-id",
@@ -23008,6 +23362,11 @@ var commands = {
           type: "integer",
           default: 25
         },
+        agentMode: {
+          default: false,
+          description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+          type: "boolean"
+        },
         connectionId: {
           description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
           maxLength: 128,
@@ -56863,6 +57222,14 @@ var schemaComponents = {
         description: "False when the bounded search stopped before establishing the requested nearest options.",
         type: "boolean"
       },
+      requestedProfessionalAvailable: {
+        description: "Present when a professional was named: true when the options are that doctor's, false when that doctor had no opening in the searched window and any options are other doctors' of the same service.",
+        type: "boolean"
+      },
+      requestedDateAvailable: {
+        description: "Present when a date was given: true when an option falls on that day, false when it had none and any options are the nearest days to it.",
+        type: "boolean"
+      },
       appointments: {
         description: "The patient's pending appointments of the requested service.",
         type: "array",
@@ -57162,6 +57529,14 @@ var schemaComponents = {
         description: "False when the bounded search stopped before establishing the requested nearest options.",
         type: "boolean"
       },
+      requestedProfessionalAvailable: {
+        description: "Present when a professional was named: true when the options are that doctor's, false when that doctor had no opening in the searched window and any options are other doctors' of the same service.",
+        type: "boolean"
+      },
+      requestedDateAvailable: {
+        description: "Present when a date was given: true when an option falls on that day, false when it had none and any options are the nearest days to it.",
+        type: "boolean"
+      },
       appointments: {
         description: "The patient's pending appointments of the requested service.",
         type: "array",
@@ -57217,6 +57592,72 @@ var schemaComponents = {
       }
     }
   },
+  SuraProfessional: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "id",
+      "name",
+      "areaId",
+      "serviceId",
+      "serviceName",
+      "registered",
+      "availabilityChecked"
+    ],
+    properties: {
+      id: {
+        description: "Opaque directory identity. Use name, not this id, when requesting availability.",
+        type: "string"
+      },
+      name: {
+        type: "string"
+      },
+      areaId: {
+        type: "string"
+      },
+      serviceId: {
+        type: "string"
+      },
+      serviceName: {
+        type: "string"
+      },
+      registered: {
+        const: true,
+        type: "boolean"
+      },
+      availabilityChecked: {
+        const: false,
+        type: "boolean"
+      }
+    }
+  },
+  SuraProfessionalPage: {
+    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/SuraProfessional"
+        }
+      },
+      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."
+      }
+    }
+  },
   SuraRefusal: {
     additionalProperties: false,
     type: "object",
@@ -69863,6 +70304,11 @@ var schemaComponents = {
           }
         ]
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70041,6 +70487,11 @@ var schemaComponents = {
         description: "The hour the caller agreed to, as HH:MM on a 24-hour clock, exactly as it appeared in find_availability's times[].",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70196,6 +70647,11 @@ var schemaComponents = {
         type: "integer",
         default: 25
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70367,6 +70823,11 @@ var schemaComponents = {
         description: "The appointment's hour as HH:MM, exactly as list_appointments returned it.",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70413,7 +70874,7 @@ var schemaComponents = {
         ]
       },
       date: {
-        description: `A day to look at, as YYYY-MM-DD. Omit it for the soonest day with room. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
+        description: `A day the person asked for, as YYYY-MM-DD. Its openings come first; when it has none, the openings nearest to it on either side are offered instead and requestedDateAvailable is false. Omit it for the soonest openings. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
         anyOf: [
           {
             type: "string"
@@ -70521,7 +70982,7 @@ var schemaComponents = {
         description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
       },
       allowOtherProfessionals: {
-        description: "When true, a requested doctor with no openings falls back automatically to other doctors of the same service. Present their names and obtain consent before booking.",
+        description: "Whether other doctors of this service may be offered when the named doctor has no opening in the searched window. Defaults to true: the named doctor's openings come first, and only when that doctor has none are the other doctors' nearest openings returned, with requestedProfessionalAvailable false. Name the actual doctor of each option and obtain consent before booking. False keeps the named doctor as a strict filter.",
         anyOf: [
           {
             const: "true",
@@ -70537,7 +70998,7 @@ var schemaComponents = {
         ]
       },
       fromDate: {
-        description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date only for an exact day.",
+        description: "Search from this day onward (YYYY-MM-DD), using the live calendar. Omit for today. Use date for a specific day.",
         anyOf: [
           {
             type: "string"
@@ -70617,7 +71078,7 @@ var schemaComponents = {
         ]
       },
       professional: {
-        description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest.",
+        description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest.",
         anyOf: [
           {
             type: "string"
@@ -70631,6 +71092,11 @@ var schemaComponents = {
         description: "Exact service in the order or a previously returned service ID. Names are resolved internally against the live catalog; do not call list_services first or invent IDs. Preserve consultation/control and pediatric qualifiers.",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70689,6 +71155,11 @@ var schemaComponents = {
         description: "Issuer code before the hyphen in the authorization identifier.",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70843,7 +71314,7 @@ var schemaComponents = {
         description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
       },
       professional: {
-        description: "Doctor's name, or part of it, when the caller asked for someone specific. Omit it to see whoever has room soonest.",
+        description: "Doctor's name, or part of it, when the caller asked for someone specific. Use list_professionals to check the service's registered doctors independently of available slots; absence from an open-agenda selector does not mean the doctor does not exist. Omit it to see whoever has room soonest.",
         anyOf: [
           {
             type: "string"
@@ -70857,6 +71328,11 @@ var schemaComponents = {
         description: `What the appointment is for: either an id from list_services or the service's own name, in the caller's words ("neurología", "control"). A name that matches more than one service is answered with the choices, so you can ask which one instead of guessing.`,
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -70911,6 +71387,11 @@ var schemaComponents = {
         description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
         type: "integer",
         default: 25
+      },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
       }
     }
   },
@@ -70923,6 +71404,11 @@ var schemaComponents = {
       "logins"
     ],
     properties: {
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         minLength: 1,
         maxLength: 128,
@@ -71007,6 +71493,11 @@ var schemaComponents = {
         pattern: "^[A-Za-z0-9_-]+$",
         description: "The connection's id, as Account lists it; it must be one of the caller's own organization's.",
         type: "string"
+      },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
       }
     }
   },
@@ -71023,6 +71514,11 @@ var schemaComponents = {
         pattern: "^[A-Za-z0-9_-]+$",
         description: "The connection's id, as Account lists it; it must be one of the caller's own organization's.",
         type: "string"
+      },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
       }
     }
   },
@@ -71054,6 +71550,11 @@ var schemaComponents = {
         description: "Explicit four-digit year for copay history, from 2000 to 2099.",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -71090,6 +71591,11 @@ var schemaComponents = {
         description: "The operationId of the pending answer, exactly as it was returned.",
         type: "string"
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -71220,6 +71726,89 @@ var schemaComponents = {
         ],
         description: "Patient document type read legibly from the original or explicitly supplied. Ask only if unknown or genuinely conflicting; never infer it from age or number length."
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
+      connectionId: {
+        description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
+        maxLength: 128,
+        minLength: 1,
+        type: "string"
+      },
+      channel: {
+        anyOf: [
+          {
+            const: "voice",
+            type: "string"
+          },
+          {
+            const: "whatsapp",
+            type: "string"
+          },
+          {
+            const: "web",
+            type: "string"
+          }
+        ],
+        description: "The channel the caller is waiting on, which sets how long it waits before an answer comes back pending, and puts a phone call's reads ahead of others. Defaults to web."
+      }
+    }
+  },
+  SuraProfessionalsListInput: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "serviceId"
+    ],
+    properties: {
+      areaId: {
+        description: "The areaId list_services returned beside that service. Pass it with an exact serviceId to skip a catalog lookup; omit it whenever you are naming the service in words.",
+        anyOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      serviceId: {
+        description: "Exact numeric service id returned by list_services. This directory is not filtered by patient coverage or available appointments.",
+        pattern: "^[0-9]{1,20}$",
+        type: "string"
+      },
+      cursor: {
+        description: "Opaque cursor returned by pageInfo; omit it to request the first page.",
+        type: "string"
+      },
+      direction: {
+        description: "Direction to traverse the stable keyset ordering from the supplied cursor.",
+        anyOf: [
+          {
+            const: "forward",
+            type: "string"
+          },
+          {
+            const: "backward",
+            type: "string"
+          }
+        ],
+        default: "forward"
+      },
+      limit: {
+        minimum: 1,
+        maximum: 100,
+        description: "Maximum items returned in one page. Defaults to 25; larger reads require another cursor.",
+        type: "integer",
+        default: 25
+      },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -71286,6 +71875,11 @@ var schemaComponents = {
         type: "integer",
         default: 25
       },
+      agentMode: {
+        default: false,
+        description: "Set agentMode=true when calling this tool for an AI agent. The answer is concise Spanish text instead of JSON. Omit it for structured machine data. This changes presentation only, never authorization, consent or idempotency.",
+        type: "boolean"
+      },
       connectionId: {
         description: "Which of the organization's SURA connections to run on, by its id. Optional while the organization has one; required when it has several.",
         maxLength: 128,
@@ -72424,9 +73018,9 @@ var schemaComponents = {
 // src/generated/generation.json
 var generation_default = {
   formatVersion: 6,
-  release: "1.20261021.142621",
-  openapiSha256: "9ee7f470f970025948f315a5f014385c35fe2adf8c88f65cc48ded8ce39329dc",
-  openapiContentSha256: "38b2a1f8990668b3b55c4da7ee4ecc6b906464cb5fd58e3dd448889b6145fd36",
+  release: "1.20261022.214640",
+  openapiSha256: "07df005c83ee996aeac081f6291a06b976ca88cb57bc00e30a533b19bc844e61",
+  openapiContentSha256: "7ab911484cc0f05d9a2ef6b4851b369b666ccfdb43cb7086b6f91f60755f855a",
   forge: {
     repository: "https://github.com/cloudflare/forge",
     commit: "7f86447210b7bea3779bfdab3cd5655eade0eadb",
@@ -72439,7 +73033,7 @@ var generation_default = {
   outputs: [
     {
       path: "src/generated/commands.ts",
-      sha256: "60141edcfd08e09bba48673c2ddc2e7dba98c907d07a2f41469bb8d9c8406e1b"
+      sha256: "007c9676e6634b3837c94b4e43c465919f3db316e538838066fc806949f560ea"
     }
   ]
 };
@@ -72794,7 +73388,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "2.5.0";
+var VERSION = "2.6.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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbol-ai/cli",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "The Arbol CLI: the Arbol API from your terminal, with commands generated by Cloudflare Forge from the public OpenAPI.",
   "keywords": [
     "arbol",
@@ -44,7 +44,7 @@
     "verify": "bun run typecheck && bun run test && bun run build"
   },
   "dependencies": {
-    "@arbol-ai/sdk": "2.6.0",
+    "@arbol-ai/sdk": "2.7.0",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "oauth4webapi": "3.8.8"
@@ -59,8 +59,8 @@
   "packageManager": "bun@1.4.3",
   "arbol": {
     "openapi": {
-      "release": "1.20261021.142621",
-      "sha256": "38b2a1f8990668b3b55c4da7ee4ecc6b906464cb5fd58e3dd448889b6145fd36"
+      "release": "1.20261022.214640",
+      "sha256": "7ab911484cc0f05d9a2ef6b4851b369b666ccfdb43cb7086b6f91f60755f855a"
     }
   }
 }