@arbol-ai/sdk 2.14.0 → 2.15.0

package/README.md

@@ -118,3 +118,9 @@ repository and project-arbol-cli. npm publishing uses the organization secret `N
 ## License
 
 [Apache License 2.0](LICENSE)
+
+### Publishing a prepared source commit
+
+The Publish workflow accepts an existing main-branch `ref` to publish without creating
+a release commit. Set `announce` to false when coordinating the CLI release separately.
+This path uses the existing npm publisher and static verification; it does not run tests.

package/dist/agenda/bookings/models.d.ts

@@ -70,6 +70,16 @@ export interface AgendaBookableOffering {
      * duration; null means no separate duration.
      */
     occupationMinutes: number | null;
+    /**
+     * Human-readable service hours and closures. Availability remains
+     * authoritative.
+     */
+    scheduleSummary: string;
+    /**
+     * IANA timezones of the agendas in this bounded projection; hours are
+     * interpreted locally.
+     */
+    scheduleTimezones: string[];
     /**
      * Current service policy and patient instructions; this projection does not
      * establish payer coverage.

package/dist/agenda/models.d.ts

@@ -243,7 +243,7 @@ export interface AgendaFailureResponse {
         data: {
             [key: string]: unknown;
         };
-        message: "The requested operation does not exist.";
+        message: "The requested resource does not exist.";
         retryable: false;
     } | {
         code: "HTTP_METHOD_NOT_ALLOWED";
@@ -377,13 +377,6 @@ export interface AgendaFailureResponse {
         };
         message: "The integration service is temporarily unavailable. Retry later.";
         retryable: true;
-    } | {
-        code: "AUTHORIZATION_FAILED";
-        data: {
-            [key: string]: unknown;
-        };
-        message: "The identity provider could not authorize this action.";
-        retryable: false;
     } | {
         code: "DURATION_CHANGE_OFF";
         data: {
@@ -496,13 +489,6 @@ export interface AgendaFailureResponse {
         };
         message: "Configure the required organization role before inviting a member.";
         retryable: false;
-    } | {
-        code: "SCHEDULING_CONFLICT";
-        data: {
-            [key: string]: unknown;
-        };
-        message: "The schedule changed or this action conflicts with its current state. Refresh before retrying.";
-        retryable: false;
     } | {
         code: "SELF_DEMOTION";
         data: {
@@ -846,6 +832,20 @@ export interface AgendaFailureResponse {
         };
         message: "The waitlist entry changed; reload before saving.";
         retryable: false;
+    } | {
+        code: "REMOVAL_WORKFLOW_UNAVAILABLE";
+        data: {
+            [key: string]: unknown;
+        };
+        message: "Durable removal is unavailable here; use the bounded manual removal operations.";
+        retryable: false;
+    } | {
+        code: "REMOVAL_JOB_CONFLICT";
+        data: {
+            [key: string]: unknown;
+        };
+        message: "A removal is already active, or this idempotency key belongs to another decision.";
+        retryable: false;
     } | {
         code: "INVALID_BODY";
         data: {

package/dist/agenda/offerings/client.d.ts

@@ -45,7 +45,8 @@ export interface CreateRequest {
      */
     bufferBeforeMinutes?: number;
     /**
-     * Maximum concurrent units this resource or offering can accept.
+     * Legacy concurrent-session limit above 1; details.maxConcurrent takes
+     * precedence. The historical default 1 delegates to resource capacity.
      */
     capacity?: number;
     /**
@@ -149,7 +150,8 @@ export interface UpdateRequest {
      */
     bufferBeforeMinutes?: number;
     /**
-     * Maximum concurrent units this resource or offering can accept.
+     * Legacy concurrent-session limit above 1; details.maxConcurrent takes
+     * precedence. The historical default 1 delegates to resource capacity.
      */
     capacity?: number;
     /**
@@ -177,6 +179,16 @@ export interface UpdateRequest {
      * Display name of this catalog or configuration record.
      */
     name?: string;
+    /**
+     * Complete replacement for future bookings. Existing appointment and hold
+     * allocations stay unchanged.
+     */
+    resourceRequirements?: {
+        alternatives?: string[];
+        kind: "practitioner" | "assistant" | "room" | "chair" | "equipment" | "location" | "team" | "generic";
+        quantity?: number;
+        required?: boolean;
+    }[];
     /**
      * Minute spacing between candidate appointment start times.
      */

package/dist/agenda/offerings/models.d.ts

@@ -13,7 +13,8 @@ export interface AgendaOffering {
      */
     bufferBeforeMinutes: number;
     /**
-     * Maximum concurrent units this resource or offering can accept.
+     * Legacy offering concurrency limit when above one and details.maxConcurrent
+     * is absent; one defers to resource capacity.
      */
     capacity: number;
     /**

package/dist/agenda/waitlist/client.d.ts

@@ -12,22 +12,40 @@ export interface Client {
     /**
      * Add a patient to the waiting list
      *
-     * Put a patient on the clinic's waiting list for the team to act on. Use
-     * reason 'payer_review' instead of booking when the patient's payer (EPS) has
-     * bookingPolicy 'staff_only' in get_intake_settings (create_appointment
-     * refuses them): the team coordinates with the doctor and books it. Use
-     * reason 'priority' right after create_appointment when the patient asked for
-     * a priority (urgent) appointment: pass that appointment's id as
-     * appointmentId so the team can bring it forward. Always pass
-     * conversationUrl: this conversation's link in Arbol's Contactabilidad
-     * (https://raiz.getarbol.com/conversations/…), so the team opens it there.
-     * Pass the patient's name, document and documentType, phone, serviceId (and
-     * resourceId only when the patient asked for one professional) and the payer
-     * as the patient said it. Calling again for the same patient, service and
-     * reason returns the same entry. Then tell the patient the clinic's team will
-     * contact them.
+     * Put a patient on the clinic's waiting list for the team to act on, only
+     * with the person's consent. Use reason 'payer_review' instead of booking
+     * when the patient's payer (EPS) has bookingPolicy 'staff_only' in
+     * get_intake_settings (create_appointment refuses them): the team coordinates
+     * with the doctor and books it. Use reason 'priority' right after
+     * create_appointment when the patient asked for a priority (urgent)
+     * appointment: pass that appointment's id as appointmentId so the team can
+     * bring it forward. Always pass conversationUrl: this conversation's link in
+     * Arbol's Contactabilidad (https://raiz.getarbol.com/conversations/…), so the
+     * team opens it there. Pass the patient's name, document and documentType,
+     * phone, serviceId and the payer as the patient said it. Use resourceId only
+     * for the professional the person requested. Calling again for the same
+     * patient, service and reason returns the same open entry and updates
+     * supplied consented preferences, note, payer, conversation or appointment
+     * association. A supplied confirmed phone replaces the patient contact phone;
+     * omitted or null phone preserves it. Omitted fields preserve their values;
+     * resourceId:null explicitly accepts any professional. When supplying
+     * preferences, send the complete consented date/time window; null fields
+     * clear those limits. Identical repeats do not change the version. Staff
+     * status, priority and original queue position are preserved. A closed entry
+     * is not reopened. This registers a waiting-list request, never an
+     * appointment. Then tell the patient the clinic's team will contact them.
      */
     join(request: JoinRequest, options?: RequestOptions): Promise<JoinResponse>;
+    /**
+     * List Waitlist
+     *
+     * List the organization’s waitlist entries: open ones first (urgent, then the
+     * longest waiting), then closed ones, most recently changed first, up to 500.
+     * Narrow them by serviceId and resourceId (the agenda an entry asked for);
+     * offeringId finds only entries from before services and agendas were chosen
+     * separately.
+     */
+    list(request?: ListRequest, options?: RequestOptions): Promise<ListResponse>;
 }
 export declare function createClient(options: ClientOptions): Client;
 export declare function bind(transport: Transport): Client;
@@ -66,9 +84,18 @@ export interface JoinRequest {
      */
     payer?: string | null;
     /**
-     * Patient contact telephone number; null when no number was recorded.
+     * The contact phone supplied or confirmed by the person for this request.
+     * Replaces their stored contact phone; omitted or null preserves it.
      */
     phone?: string | null;
+    /**
+     * Patient availability preferences retained with the waiting-list entry.
+     */
+    preferences?: {
+        from?: Temporal.PlainDate | null;
+        times?: string | null;
+        to?: Temporal.PlainDate | null;
+    };
     /**
      * manual records a consented waitlist request after no suitable availability;
      * payer_review asks staff to coordinate a restricted payer; priority asks
@@ -90,3 +117,29 @@ export interface JoinResponse {
     metadata: ResponseMetadata;
     success: true;
 }
+export interface ListRequest {
+    /**
+     * Only entries recorded for this exact offering, which only entries from
+     * before services and agendas were chosen separately have; newer entries
+     * carry serviceId and resourceId instead.
+     */
+    offeringId?: string;
+    /**
+     * Only entries that asked for this professional or agenda; entries open to
+     * any agenda (resourceId null) are left out.
+     */
+    resourceId?: string;
+    /**
+     * Only entries for this service, whichever agenda they asked for.
+     */
+    serviceId?: string;
+}
+export interface ListResponse {
+    data: {
+        data: AgendaWaitlistEntry[];
+        object: "list";
+    };
+    error: null;
+    metadata: ResponseMetadata;
+    success: true;
+}

package/dist/agenda/waitlist/client.js

@@ -1,6 +1,6 @@
 // Code generated by forge. DO NOT EDIT.
 /* eslint-disable */
-import { Transport, object, } from "../../_/index.js";
+import { Transport, array, date, object, } from "../../_/index.js";
 import { AgendaWaitlistEntryCodec, } from "./models.js";
 export function createClient(options) {
     return bind(new Transport(options));
@@ -8,12 +8,21 @@ export function createClient(options) {
 export function bind(transport) {
     return {
         join: (request, options) => transport.send(JoinOperation, request, options),
+        list: (request, options) => transport.send(ListOperation, request, options),
     };
 }
 const JoinOperation = {
     method: "POST",
     route: "/v1/agenda/waitlist/join",
     body: "flat",
+    request: object([["preferences", null, object([["from", null, date], ["to", null, date]])]]),
     response: object([["data", null, () => AgendaWaitlistEntryCodec]]),
     errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "409": true, "413": true, "415": true, "426": true, "429": true, "500": true, "502": true, "503": true, "504": true },
 };
+const ListOperation = {
+    method: "GET",
+    route: "/v1/agenda/waitlist",
+    query: { offeringId: "offeringId", resourceId: "resourceId", serviceId: "serviceId" },
+    response: object([["data", null, object([["data", null, array(() => AgendaWaitlistEntryCodec)]])]]),
+    errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "409": true, "413": true, "415": true, "426": true, "429": true, "500": true, "502": true, "503": true, "504": true },
+};

package/dist/agenda/waitlist/index.d.ts

@@ -1,5 +1,5 @@
 export { ApiError } from "../../_/index.js";
 export type { RequestOptions } from "../../_/index.js";
 export { createClient } from "./client.js";
-export type { Client, ClientOptions, JoinRequest, JoinResponse, } from "./client.js";
+export type { Client, ClientOptions, JoinRequest, JoinResponse, ListRequest, ListResponse, } from "./client.js";
 export type { AgendaWaitlistEntry } from "./models.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbol-ai/sdk",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "The Arbol API for TypeScript and JavaScript, generated by Cloudflare Forge from the platform's public OpenAPI.",
   "keywords": [
     "arbol",
@@ -50,8 +50,8 @@
   "packageManager": "bun@1.4.3",
   "arbol": {
     "openapi": {
-      "release": "1.20261028.154640",
-      "sha256": "472217811eecc0bec1e867938c2520765a603f3c97917a2523904bb68e072998"
+      "release": "1.20261028.202015",
+      "sha256": "268d85ea2cea9f6a0cc5de011c11912128724fb1e1a101e2b12cb628a5e2c13d"
     }
   }
 }