@arbol-ai/cli 3.34.0 → 3.36.0

package/dist/index.js

@@ -24999,7 +24999,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 to look at, as YYYY-MM-DD. Omit it to start from the professional's next day with an agenda. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`
       },
       {
         name: "documentNumber",
@@ -25102,7 +25102,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 to look at, as YYYY-MM-DD. Omit it to start from the professional's next day with an agenda. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
           anyOf: [
             {
               type: "string"
@@ -25255,7 +25255,7 @@ var commands = {
       }
     },
     title: "Find availability",
-    description: "Find the free appointment times for one patient and one service. With no date it answers with the soonest day that has room; with a date it answers for that day. times[] are the hours you may book, otherDates[] are other days that month with room, and otherProfessionals[] are the other doctors who see this service. Offer two or three times, never the whole list.",
+    description: "Find the free appointment times for one patient and one service. With a date it answers for that day. With no date it answers for the professional's next day with an agenda, which can be full. times[] are the hours you may book, and only free ones are ever listed; otherDates[] are other days that month with room; days[] says how every day of that month stands (available, full or no_agenda); reserved says the day's only free slot is held back; and otherProfessionals[] are the other doctors who see this service. An empty times[] does not mean the whole agenda is full: prepare_appointment searches other months. Offer two or three times, never the whole list.",
     effect: "read",
     confirmation: null,
     hidden: false
@@ -26599,6 +26599,131 @@ var commands = {
     confirmation: null,
     hidden: false
   },
+  "sura schedules lookup": {
+    operation: "sura.schedules.lookup",
+    sdkPath: [
+      "sura",
+      "schedules",
+      "lookup"
+    ],
+    pathField: null,
+    fields: [
+      {
+        name: "professional",
+        flag: "professional",
+        kind: "string",
+        required: true,
+        description: "The professional name or an unambiguous part of it. Resolved against this connection’s registered directory; never a patient identity."
+      },
+      {
+        name: "date",
+        flag: "date",
+        kind: "string",
+        required: true,
+        description: "The calendar day to inspect, YYYY-MM-DD, in the clinic’s timezone."
+      },
+      {
+        name: "serviceId",
+        flag: "service-id",
+        kind: "string",
+        required: false,
+        description: "Optional exact service id or unambiguous service name. Omit to inspect every service in which this professional is registered at this connection’s institution."
+      },
+      {
+        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: [
+        "professional",
+        "date"
+      ],
+      properties: {
+        professional: {
+          minLength: 1,
+          maxLength: 200,
+          description: "The professional name or an unambiguous part of it. Resolved against this connection’s registered directory; never a patient identity.",
+          type: "string"
+        },
+        date: {
+          format: "date",
+          description: "The calendar day to inspect, YYYY-MM-DD, in the clinic’s timezone.",
+          type: "string"
+        },
+        serviceId: {
+          description: "Optional exact service id or unambiguous service name. Omit to inspect every service in which this professional is registered at this connection’s institution.",
+          anyOf: [
+            {
+              maxLength: 200,
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        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: "Look up a professional schedule",
+    description: "Read a professional’s generated schedule and capacity on one date without a patient document. Omit serviceId to inspect all their registered services at the connection’s institution. Distinguishes a full day from no schedule, an ungenerated period, blocked capacity and a generated period not offered. Returns real configured hours and created, offered, assigned, available and blocked counts. Counts are administrative capacity, never patient eligibility or a booking proposal. Does not create periods, change hours, book or cancel appointments. Use bookingOptions.lookup with the patient before offering a bookable slot. A technical failure never means no schedule.",
+    effect: "read",
+    confirmation: null,
+    hidden: false
+  },
   "sura services list": {
     operation: "sura.services.list",
     sdkPath: [
@@ -87915,6 +88040,17 @@ var schemaComponents = {
         items: {
           type: "string"
         }
+      },
+      days: {
+        description: "Every day of that month for this professional, so a day with no hours says why. Empty only when SURA's calendar could not be read. Absent on older saved results; absence does not establish a day state.",
+        type: "array",
+        items: {
+          $ref: "#/components/schemas/SuraCalendarDay"
+        }
+      },
+      reserved: {
+        description: "True when the day's only free slot is held for the primary-care IPS until 24 hours before it; times leaves it out. Absent on older saved results; absence does not mean false.",
+        type: "boolean"
       }
     }
   },
@@ -88375,6 +88511,37 @@ var schemaComponents = {
       }
     }
   },
+  SuraCalendarDay: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "date",
+      "status"
+    ],
+    properties: {
+      date: {
+        description: "YYYY-MM-DD.",
+        type: "string"
+      },
+      status: {
+        anyOf: [
+          {
+            const: "available",
+            type: "string"
+          },
+          {
+            const: "full",
+            type: "string"
+          },
+          {
+            const: "no_agenda",
+            type: "string"
+          }
+        ],
+        description: "available: it has free slots. full: it has an agenda with none free. no_agenda: the professional has no agenda that day."
+      }
+    }
+  },
   SuraCancelAppointmentBadGatewayError: {
     type: "object",
     description: "A failed answer.",
@@ -89280,7 +89447,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 to look at, as YYYY-MM-DD. Omit it to start from the professional's next day with an agenda. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
         anyOf: [
           {
             type: "string"
@@ -89648,6 +89815,10 @@ var schemaComponents = {
         $ref: "#/components/schemas/SuraAvailability",
         description: "The free times for one patient and one service on one day."
       },
+      {
+        $ref: "#/components/schemas/SuraSchedule",
+        description: "The professional’s administrative schedule and current capacity, without patient data. Not a patient-specific booking offer."
+      },
       {
         $ref: "#/components/schemas/SuraPreparationExistingAppointment",
         description: "An appointment of the requested service already exists; nothing new was searched."
@@ -91151,6 +91322,205 @@ var schemaComponents = {
       }
     }
   },
+  SuraLookupScheduleBadGatewayError: {
+    type: "object",
+    description: "A failed answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          false
+        ]
+      },
+      data: {
+        const: null
+      },
+      error: {
+        $ref: "#/components/schemas/SuraLookupScheduleBadGatewayFailure"
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  SuraLookupScheduleBadGatewayFailure: {
+    oneOf: [
+      {
+        $ref: "#/components/schemas/OutcomeUnknownFailure"
+      },
+      {
+        $ref: "#/components/schemas/SuraPortalCredentialsRejectedFailure"
+      },
+      {
+        $ref: "#/components/schemas/SuraPortalUnavailableFailure"
+      }
+    ],
+    discriminator: {
+      propertyName: "code",
+      mapping: {
+        OUTCOME_UNKNOWN: "#/components/schemas/OutcomeUnknownFailure",
+        PORTAL_CREDENTIALS_REJECTED: "#/components/schemas/SuraPortalCredentialsRejectedFailure",
+        PORTAL_UNAVAILABLE: "#/components/schemas/SuraPortalUnavailableFailure"
+      }
+    }
+  },
+  SuraLookupScheduleBody: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "professional",
+      "date"
+    ],
+    properties: {
+      professional: {
+        minLength: 1,
+        maxLength: 200,
+        description: "The professional name or an unambiguous part of it. Resolved against this connection’s registered directory; never a patient identity.",
+        type: "string"
+      },
+      date: {
+        format: "date",
+        description: "The calendar day to inspect, YYYY-MM-DD, in the clinic’s timezone.",
+        type: "string"
+      },
+      serviceId: {
+        description: "Optional exact service id or unambiguous service name. Omit to inspect every service in which this professional is registered at this connection’s institution.",
+        anyOf: [
+          {
+            maxLength: 200,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      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."
+      }
+    }
+  },
+  SuraLookupScheduleConflictError: {
+    type: "object",
+    description: "A failed answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          false
+        ]
+      },
+      data: {
+        const: null
+      },
+      error: {
+        $ref: "#/components/schemas/SuraLookupScheduleConflictFailure"
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
+  SuraLookupScheduleConflictFailure: {
+    oneOf: [
+      {
+        $ref: "#/components/schemas/SuraPortalSessionConflictFailure"
+      },
+      {
+        $ref: "#/components/schemas/SuraConnectionNotConfiguredFailure"
+      }
+    ],
+    discriminator: {
+      propertyName: "code",
+      mapping: {
+        PORTAL_SESSION_CONFLICT: "#/components/schemas/SuraPortalSessionConflictFailure",
+        CONNECTION_NOT_CONFIGURED: "#/components/schemas/SuraConnectionNotConfiguredFailure"
+      }
+    }
+  },
+  SuraLookupScheduleResult: {
+    anyOf: [
+      {
+        $ref: "#/components/schemas/SuraPendingResult",
+        description: "The connection is still running the call; it continues if the caller stops waiting."
+      },
+      {
+        $ref: "#/components/schemas/SuraRefusal",
+        description: "An expected refusal. Nothing was booked or cancelled unless errorCode says the outcome is unconfirmed."
+      },
+      {
+        $ref: "#/components/schemas/SuraSchedule",
+        description: "The professional’s administrative schedule and current capacity, without patient data. Not a patient-specific booking offer."
+      }
+    ]
+  },
+  SuraLookupScheduleResultResponse: {
+    type: "object",
+    description: "A successful answer.",
+    additionalProperties: false,
+    required: [
+      "success",
+      "data",
+      "error",
+      "metadata"
+    ],
+    properties: {
+      success: {
+        type: "boolean",
+        enum: [
+          true
+        ]
+      },
+      data: {
+        $ref: "#/components/schemas/SuraLookupScheduleResult"
+      },
+      error: {
+        const: null
+      },
+      metadata: {
+        $ref: "#/components/schemas/ResponseMetadata"
+      }
+    }
+  },
   SuraNoContract: {
     additionalProperties: false,
     type: "object",
@@ -92683,6 +93053,10 @@ var schemaComponents = {
       place: {
         type: "string"
       },
+      plan: {
+        description: "The plan a refusal about coverage was judged on.",
+        type: "string"
+      },
       professionals: {
         type: "array",
         items: {
@@ -92719,6 +93093,161 @@ var schemaComponents = {
       }
     }
   },
+  SuraSchedule: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "ok",
+      "ai_hint",
+      "date",
+      "observedAt",
+      "institutionId",
+      "professional",
+      "status",
+      "capacity",
+      "services"
+    ],
+    properties: {
+      ok: {
+        const: true,
+        type: "boolean"
+      },
+      ai_hint: {
+        description: "Spanish guidance for the model: what to do next.",
+        type: "string"
+      },
+      date: {
+        format: "date",
+        type: "string"
+      },
+      observedAt: {
+        format: "date-time",
+        type: "string"
+      },
+      institutionId: {
+        type: "string"
+      },
+      professional: {
+        type: "string"
+      },
+      status: {
+        $ref: "#/components/schemas/SuraScheduleStatus"
+      },
+      capacity: {
+        $ref: "#/components/schemas/SuraScheduleCapacity"
+      },
+      services: {
+        type: "array",
+        items: {
+          $ref: "#/components/schemas/SuraServiceSchedule"
+        }
+      }
+    }
+  },
+  SuraScheduleCapacity: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "createdCount",
+      "offeredCount",
+      "assignedCount",
+      "availableCount",
+      "blockedCount"
+    ],
+    properties: {
+      createdCount: {
+        minimum: 0,
+        maximum: 1e7,
+        type: "integer"
+      },
+      offeredCount: {
+        minimum: 0,
+        maximum: 1e7,
+        type: "integer"
+      },
+      assignedCount: {
+        minimum: 0,
+        maximum: 1e7,
+        type: "integer"
+      },
+      availableCount: {
+        minimum: 0,
+        maximum: 1e7,
+        type: "integer"
+      },
+      blockedCount: {
+        minimum: 0,
+        maximum: 1e7,
+        type: "integer"
+      }
+    }
+  },
+  SuraScheduleHours: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "dayOfWeek",
+      "timeFrom",
+      "timeUntil",
+      "durationMinutes",
+      "patientsPerSlot",
+      "generated"
+    ],
+    properties: {
+      dayOfWeek: {
+        minimum: 0,
+        maximum: 6,
+        type: "integer"
+      },
+      timeFrom: {
+        type: "string"
+      },
+      timeUntil: {
+        type: "string"
+      },
+      durationMinutes: {
+        minimum: 1,
+        maximum: 1440,
+        type: "integer"
+      },
+      patientsPerSlot: {
+        minimum: 1,
+        maximum: 200,
+        type: "integer"
+      },
+      generated: {
+        type: "boolean"
+      }
+    }
+  },
+  SuraScheduleStatus: {
+    anyOf: [
+      {
+        const: "available",
+        type: "string"
+      },
+      {
+        const: "full",
+        type: "string"
+      },
+      {
+        const: "blocked",
+        type: "string"
+      },
+      {
+        const: "not_scheduled",
+        type: "string"
+      },
+      {
+        const: "not_generated",
+        type: "string"
+      },
+      {
+        const: "not_offered",
+        type: "string"
+      }
+    ]
+  },
   SuraSearchedDay: {
     additionalProperties: false,
     type: "object",
@@ -92828,6 +93357,80 @@ var schemaComponents = {
       }
     }
   },
+  SuraServiceSchedule: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "serviceId",
+      "serviceName",
+      "status",
+      "capacity",
+      "periods"
+    ],
+    properties: {
+      serviceId: {
+        type: "string"
+      },
+      serviceName: {
+        type: "string"
+      },
+      status: {
+        $ref: "#/components/schemas/SuraScheduleStatus"
+      },
+      capacity: {
+        $ref: "#/components/schemas/SuraScheduleCapacity"
+      },
+      periods: {
+        type: "array",
+        items: {
+          additionalProperties: false,
+          type: "object",
+          required: [
+            "fromDate",
+            "untilDate",
+            "generated",
+            "generationStatus",
+            "hours"
+          ],
+          properties: {
+            fromDate: {
+              format: "date",
+              type: "string"
+            },
+            untilDate: {
+              format: "date",
+              type: "string"
+            },
+            generated: {
+              type: "boolean"
+            },
+            generationStatus: {
+              anyOf: [
+                {
+                  const: "generated",
+                  type: "string"
+                },
+                {
+                  const: "not_generated",
+                  type: "string"
+                },
+                {
+                  const: "partially_generated",
+                  type: "string"
+                }
+              ]
+            },
+            hours: {
+              type: "array",
+              items: {
+                $ref: "#/components/schemas/SuraScheduleHours"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
   SuraToolRefusedError: {
     type: "object",
     description: "A failed answer.",
@@ -111347,7 +111950,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 to look at, as YYYY-MM-DD. Omit it to start from the professional's next day with an agenda. Resolve relative dates like "mañana" against the clinic's own timezone before calling.`,
         anyOf: [
           {
             type: "string"
@@ -112244,6 +112847,67 @@ var schemaComponents = {
       }
     }
   },
+  SuraSchedulesLookupInput: {
+    additionalProperties: false,
+    type: "object",
+    required: [
+      "professional",
+      "date"
+    ],
+    properties: {
+      professional: {
+        minLength: 1,
+        maxLength: 200,
+        description: "The professional name or an unambiguous part of it. Resolved against this connection’s registered directory; never a patient identity.",
+        type: "string"
+      },
+      date: {
+        format: "date",
+        description: "The calendar day to inspect, YYYY-MM-DD, in the clinic’s timezone.",
+        type: "string"
+      },
+      serviceId: {
+        description: "Optional exact service id or unambiguous service name. Omit to inspect every service in which this professional is registered at this connection’s institution.",
+        anyOf: [
+          {
+            maxLength: 200,
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      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."
+      }
+    }
+  },
   SuraServicesListInput: {
     additionalProperties: false,
     type: "object",
@@ -113376,9 +114040,9 @@ var schemaComponents = {
 // src/generated/generation.json
 var generation_default = {
   formatVersion: 6,
-  release: "1.20261105.5813",
-  openapiSha256: "8a0603c6dd411a09b4c92e3c5f1028f92f92bb3d5378de5fb42067f1549bc537",
-  openapiContentSha256: "608afec9826be487c1894d6251251afa6b6f329d8145fb1d1f26a306a8b7be26",
+  release: "1.20261105.41647",
+  openapiSha256: "8da0a84e0f042302fe6d2a0e7571b9c4ef1fde2251cb85ee4369ab9783974616",
+  openapiContentSha256: "9f4c514a6aa7f95ada90b3e20fcdd34835193d5190e350bad35061dac279115c",
   forge: {
     repository: "https://github.com/cloudflare/forge",
     commit: "7f86447210b7bea3779bfdab3cd5655eade0eadb",
@@ -113391,7 +114055,7 @@ var generation_default = {
   outputs: [
     {
       path: "src/generated/commands.ts",
-      sha256: "40e6ed69c4bc86bcd015097de0b7b67dfe4b708c1978465dcd26da7bf3d56b01"
+      sha256: "5e4b32f99efd8971fa3dd4bb7fbef0651530921c106d4ee237d311ee75e0c6e2"
     }
   ]
 };
@@ -113746,7 +114410,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "3.34.0";
+var VERSION = "3.36.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": "3.34.0",
+  "version": "3.36.0",
   "description": "The Arbol CLI: the Arbol API from your terminal, with commands generated by Cloudflare Forge from the public OpenAPI.",
   "keywords": [
     "arbol",
@@ -45,7 +45,7 @@
     "verify:with-tests": "bun run typecheck && bun run test && bun run build"
   },
   "dependencies": {
-    "@arbol-ai/sdk": "5.33.0",
+    "@arbol-ai/sdk": "5.35.0",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "oauth4webapi": "3.8.8"
@@ -60,8 +60,8 @@
   "packageManager": "bun@1.4.3",
   "arbol": {
     "openapi": {
-      "release": "1.20261105.5813",
-      "sha256": "608afec9826be487c1894d6251251afa6b6f329d8145fb1d1f26a306a8b7be26"
+      "release": "1.20261105.41647",
+      "sha256": "9f4c514a6aa7f95ada90b3e20fcdd34835193d5190e350bad35061dac279115c"
     }
   }
 }