@arbol-ai/sdk 2.14.0 → 2.16.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/account/connections/models.d.ts

@@ -62,7 +62,7 @@ export interface AccountConnection {
             path: string;
         };
         rpcMethod?: string | null;
-        runtimeInputs?: ("connectionId" | "channel")[];
+        runtimeInputs?: ("connectionId" | "channel" | "conversationUrl")[];
         writesThrough?: string[];
     }[];
     /**

package/dist/account/invitations/client.d.ts

@@ -11,10 +11,10 @@ export interface Client {
     /**
      * Invite someone to a product
      *
-     * Invites someone not yet in the organization by email with a role in Raíz,
+     * Invites someone without an Arbol account by email with a role in Raíz,
      * Agenda, Ámbar or Account. The invitation email comes from the product's own
-     * application, so its link opens that product. Someone already in the
-     * organization is given the role with `members.create`.
+     * application. Existing accounts receive access with `members.create` and
+     * sign in with their current password.
      */
     create(request: CreateRequest, options?: RequestOptions): Promise<CreateResponse>;
     /**
@@ -36,7 +36,7 @@ export declare function createClient(options: ClientOptions): Client;
 export declare function bind(transport: Transport): Client;
 export interface CreateRequest {
     /**
-     * Who to invite: someone not yet in the organization.
+     * Who to invite: someone who does not have an Arbol account yet.
      */
     email: string;
     /**

package/dist/account/members/client.d.ts

@@ -11,8 +11,10 @@ export interface Client {
     /**
      * Give a member a role in a product
      *
-     * Gives someone already in the organization a role in Raíz, Agenda, Ámbar or
-     * Account, by their email. Anyone else is invited with `invitations.create`.
+     * Gives someone with an existing Arbol account a role in Raíz, Agenda, Ámbar
+     * or Account, joining them to this organization when needed. They sign in
+     * with their current password. Someone without an account is invited with
+     * `invitations.create`.
      */
     create(request: CreateRequest, options?: RequestOptions): Promise<CreateResponse>;
     /**
@@ -41,7 +43,8 @@ export declare function createClient(options: ClientOptions): Client;
 export declare function bind(transport: Transport): Client;
 export interface CreateRequest {
     /**
-     * The email of someone already in the organization.
+     * The email of someone with an existing Arbol account, in this organization
+     * or another.
      */
     email: string;
     /**

package/dist/account/models.d.ts

@@ -141,6 +141,13 @@ export interface AccountFailureResponse {
         };
         message: "This person is already a member.";
         retryable: false;
+    } | {
+        code: "ACCOUNT_EXISTS";
+        data: {
+            [key: string]: unknown;
+        };
+        message: "This person already has an Arbol account. Give them access with members.create.";
+        retryable: false;
     } | {
         code: "INVITATION_EXISTS";
         data: {
@@ -160,7 +167,7 @@ export interface AccountFailureResponse {
         data: {
             [key: string]: unknown;
         };
-        message: "This person is not a member.";
+        message: "No existing Arbol account was found.";
         retryable: false;
     } | {
         code: "INVITATION_NOT_FOUND";

package/dist/account/permissions/models.d.ts

@@ -8,7 +8,7 @@ export interface AccountPermission {
     /**
      * The product or integration the permission belongs to.
      */
-    group: "raiz" | "agenda" | "ambar" | "sura" | "visoft" | "account";
+    group: "raiz" | "agenda" | "ambar" | "sura" | "visoft" | "nueva-eps" | "account";
     value: string;
 }
 export interface AccountPermissionPage {

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,41 @@ 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
+     * 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. For agent calls, the platform supplies conversationUrl
+     * from the invoking conversation; omit that field. Direct callers may supply
+     * the referring conversation link so the team can reopen it. 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 +85,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 +118,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.16.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.230100",
+      "sha256": "821b642463ce46413eb98de5ae447705d8d3559284cfda5e63341c7bcf56d1f8"
     }
   }
 }