@arbol-ai/sdk 2.8.0 → 2.10.0

package/dist/raiz/conversations/client.d.ts

@@ -1,5 +1,5 @@
 import { type BaseClientOptions, type RequestOptions, Transport } from "../../_/index.js";
-import type { ResponseMetadata } from "../../models.js";
+import type { DeletedObject, ResponseMetadata } from "../../models.js";
 import type { RaizCount } from "../models.js";
 import { type RaizConversation, type RaizConversationPage } from "./models.js";
 export interface ClientOptions extends BaseClientOptions {
@@ -32,6 +32,14 @@ export interface Client {
      * use `get_report`.
      */
     count(request?: CountRequest, options?: RequestOptions): Promise<CountResponse>;
+    /**
+     * Delete a conversation
+     *
+     * Delete a closed conversation: it leaves every list and report, its
+     * transcript and facts are kept, and the history records who deleted it. Not
+     * an AI tool.
+     */
+    delete(request: DeleteRequest, options?: RequestOptions): Promise<DeleteResponse>;
     /**
      * Get a conversation
      *
@@ -197,6 +205,18 @@ export interface CountResponse {
     metadata: ResponseMetadata;
     success: true;
 }
+export interface DeleteRequest {
+    /**
+     * Conversation id.
+     */
+    conversationId: string;
+}
+export interface DeleteResponse {
+    data: DeletedObject;
+    error: null;
+    metadata: ResponseMetadata;
+    success: true;
+}
 export interface GetRequest {
     /**
      * Conversation id.

package/dist/raiz/conversations/client.js

@@ -9,6 +9,7 @@ export function bind(transport) {
     return {
         continue: (request, options) => transport.send(ContinueOperation, request, options),
         count: (request, options) => transport.send(CountOperation, request, options),
+        delete: (request, options) => transport.send(DeleteOperation, request, options),
         get: (request, options) => transport.send(GetOperation, request, options),
         list: (request, options) => transport.send(ListOperation, request, options),
         update: (request, options) => transport.send(UpdateOperation, request, options),
@@ -28,6 +29,13 @@ const CountOperation = {
     response: null,
     errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
 };
+const DeleteOperation = {
+    method: "DELETE",
+    route: "/v1/raiz/conversations/delete",
+    body: "flat",
+    response: null,
+    errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "409": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
+};
 const GetOperation = {
     method: "GET",
     route: "/v1/raiz/conversations/get",

package/dist/raiz/conversations/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, ContinueRequest, ContinueResponse, CountRequest, CountResponse, GetRequest, GetResponse, ListRequest, ListResponse, UpdateRequest, UpdateResponse, } from "./client.js";
+export type { Client, ClientOptions, ContinueRequest, ContinueResponse, CountRequest, CountResponse, DeleteRequest, DeleteResponse, GetRequest, GetResponse, ListRequest, ListResponse, UpdateRequest, UpdateResponse, } from "./client.js";
 export type { RaizConversation, RaizConversationPage, RaizConversationWorker, RaizMessage, RaizMessagePage, RaizSignedUrl, } from "./models.js";

package/dist/raiz/evalCases/client.d.ts

@@ -8,15 +8,26 @@ export interface ClientOptions extends BaseClientOptions {
     baseUrl: string;
 }
 export interface Client {
+    /**
+     * Record Agent feedback
+     *
+     * Record internal feedback on one completed WhatsApp Agent reply: what should
+     * be preserved or changed, a preferred response, and whether it was
+     * incorrect, incomplete or could be simpler. Requires conversation write and
+     * Agent read access. Does not contact anyone or change live instructions.
+     * Repeating creation returns the existing authored case; edit it with
+     * updateEvalCase and expectedVersion.
+     */
+    create(request: CreateRequest, options?: RequestOptions): Promise<CreateResponse>;
     /**
      * List evaluation cases
      *
-     * The Agents' evaluation cases, newest first: each is a WhatsApp reply the
-     * model wrote after which a person from the business wrote in the
-     * conversation (`correction`), with the Agent version that wrote it. Filter
-     * by `agentId` or `status` (`open` not reviewed yet, `kept`, `dismissed`).
-     * Read the conversation with its own operations to judge a case. Not an AI
-     * tool.
+     * The Agents' evaluation cases, newest first: completed WhatsApp replies with
+     * explicit internal team feedback (`authored`) or a following team message
+     * (`correction`), and the Agent version that wrote each reply. Filter by
+     * agentId, replyMessageId, source or status (`open`, `kept`, `dismissed`).
+     * Requires conversation read authority as well as Agent read authority. Read
+     * the conversation with its own operations to judge a case. Not an AI tool.
      */
     list(request?: ListRequest, options?: RequestOptions): Promise<ListResponse>;
     /**
@@ -31,6 +42,33 @@ export interface Client {
 }
 export declare function createClient(options: ClientOptions): Client;
 export declare function bind(transport: Transport): Client;
+export interface CreateRequest {
+    /**
+     * Conversation id.
+     */
+    conversationId: string;
+    /**
+     * What the Agent should have done instead, for whoever replays the case: a
+     * short rubric, never the contact's personal data.
+     */
+    expectation: string;
+    feedbackKind: "incorrect" | "simpler" | "incomplete";
+    /**
+     * The team's preferred reply or procedure. Private evidence, never
+     * automatically instructions.
+     */
+    preferredResponse: string;
+    /**
+     * Message id.
+     */
+    replyMessageId: string;
+}
+export interface CreateResponse {
+    data: RaizEvalCase;
+    error: null;
+    metadata: ResponseMetadata;
+    success: true;
+}
 export interface ListRequest {
     /**
      * Opaque cursor returned by pageInfo; omit it to request the first page.
@@ -55,6 +93,11 @@ export interface ListRequest {
      * example).
      */
     status?: "open" | "kept" | "dismissed";
+    /**
+     * Message id.
+     */
+    replyMessageId?: string;
+    source?: "correction" | "sample" | "authored";
 }
 export interface ListResponse {
     data: RaizEvalCasePage;
@@ -68,6 +111,13 @@ export interface UpdateRequest {
      */
     evalCaseId: string;
     expectation?: string | null;
+    /**
+     * The `version` you read. When present, the change applies only if nobody
+     * changed the resource since; otherwise it fails with VERSION_CONFLICT.
+     */
+    expectedVersion?: number;
+    feedbackKind?: "incorrect" | "simpler" | "incomplete";
+    preferredResponse?: string | null;
     /**
      * `open`: not reviewed yet. `kept`: a candidate version must handle it.
      * `dismissed`: not a case (the person only continued after a handoff, for

package/dist/raiz/evalCases/client.js

@@ -7,14 +7,22 @@ export function createClient(options) {
 }
 export function bind(transport) {
     return {
+        create: (request, options) => transport.send(CreateOperation, request, options),
         list: (request, options) => transport.send(ListOperation, request, options),
         update: (request, options) => transport.send(UpdateOperation, request, options),
     };
 }
+const CreateOperation = {
+    method: "POST",
+    route: "/v1/raiz/eval-cases/create",
+    body: "flat",
+    response: object([["data", null, () => RaizEvalCaseCodec]]),
+    errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
+};
 const ListOperation = {
     method: "GET",
     route: "/v1/raiz/eval-cases",
-    query: { cursor: "cursor", direction: "direction", limit: "limit", agentId: "agentId", status: "status" },
+    query: { cursor: "cursor", direction: "direction", limit: "limit", agentId: "agentId", status: "status", replyMessageId: "replyMessageId", source: "source" },
     response: object([["data", null, () => RaizEvalCasePageCodec]]),
     errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
 };
@@ -23,5 +31,5 @@ const UpdateOperation = {
     route: "/v1/raiz/eval-cases/update",
     body: "flat",
     response: object([["data", null, () => RaizEvalCaseCodec]]),
-    errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
+    errors: { "400": true, "401": true, "403": true, "404": true, "405": true, "409": true, "413": true, "415": true, "429": true, "500": true, "502": true, "503": true, "504": true },
 };

package/dist/raiz/evalCases/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, ListRequest, ListResponse, UpdateRequest, UpdateResponse, } from "./client.js";
+export type { Client, ClientOptions, CreateRequest, CreateResponse, ListRequest, ListResponse, UpdateRequest, UpdateResponse, } from "./client.js";
 export type { RaizEvalCase, RaizEvalCasePage, } from "./models.js";

package/dist/raiz/evalCases/models.d.ts

@@ -15,17 +15,20 @@ export interface RaizEvalCase {
      */
     createdAt: Temporal.Instant;
     expectation: string | null;
+    feedbackKind: "incorrect" | "simpler" | "incomplete" | null;
     /**
      * Evaluation case id.
      */
     id: string;
+    latestRunId: string | null;
+    preferredResponse: string | null;
     /**
      * Message id.
      */
     replyMessageId: string;
     /**
-     * `correction`: a person wrote right after the reply. `sample` and `authored`
-     * are reserved for sampled and hand-written cases.
+     * `correction`: a person wrote right after the reply. `authored`: explicit
+     * internal team feedback. `sample`: a sampled reply.
      */
     source: "correction" | "sample" | "authored";
     /**
@@ -38,6 +41,7 @@ export interface RaizEvalCase {
      * An instant in RFC 3339 format, in UTC.
      */
     updatedAt: Temporal.Instant;
+    version: number;
 }
 export interface RaizEvalCasePage {
     /**

package/dist/raiz/evalRuns/client.d.ts

@@ -12,9 +12,13 @@ export interface Client {
     /**
      * Replay evaluation cases on a candidate
      *
-     * Measure a candidate version of a text Agent on its kept evaluation cases
-     * before publishing it: the WhatsApp Agent rewrites each case's reply with
-     * the candidate's `instructions`, `skills`, `integrationSkills`, `model` and
+     * With feedbackCaseId, prepare conditional guidance from that kept correction
+     * and test it with the Agent’s newest kept cases, always including the
+     * source. Do not combine feedbackCaseId with candidate or caseIds. This does
+     * not publish. Requires conversation read access. Otherwise measure a
+     * candidate version of a text Agent on its kept evaluation cases before
+     * publishing it: the WhatsApp Agent rewrites each case's reply with the
+     * candidate's `instructions`, `skills`, `integrationSkills`, `model` and
      * `reasoningEffort` (omitted ones stay as the live Agent has them), without
      * running any integration tool (each answers with what it answered in the
      * original conversation) and without sending anything; then a judge model
@@ -65,6 +69,10 @@ export interface CreateRequest {
      * reply, then a small judge model per case. Send `true` to accept that cost.
      */
     confirmCost: true;
+    /**
+     * Evaluation case id.
+     */
+    feedbackCaseId?: string;
 }
 export interface CreateResponse {
     data: RaizEvalRun;

package/dist/raiz/evalRuns/models.d.ts

@@ -3,6 +3,7 @@ export interface RaizEvalRun {
      * Agent id.
      */
     agentId: string;
+    baseVersion: number | null;
     baseVersionId: string | null;
     caseIds: string[];
     /**
@@ -22,11 +23,20 @@ export interface RaizEvalRun {
      */
     errors: number;
     failed: number;
+    feedbackCaseId: string | null;
+    feedbackCaseVersion: number | null;
     /**
      * Evaluation run id.
      */
     id: string;
     passed: number;
+    proposal: {
+        appliesWhen: string;
+        exceptions: string;
+        guidance: string;
+        replaceText?: string | null;
+    } | null;
+    proposedInstructions: string | null;
     results: {
         caseId: string;
         createdAt: Temporal.Instant;

package/dist/raiz/models.d.ts

@@ -741,6 +741,13 @@ export interface RaizFailureResponse {
         };
         message: "A bulletin must end after it starts, and a new one must end in the future.";
         retryable: false;
+    } | {
+        code: "FEEDBACK_PROPOSAL_UNAVAILABLE";
+        data: {
+            [key: string]: unknown;
+        };
+        message: "A usable improvement could not be prepared. The Agent has not changed. Try again later.";
+        retryable: true;
     } | {
         code: "EVAL_CASES_UNAVAILABLE";
         data: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbol-ai/sdk",
-  "version": "2.8.0",
+  "version": "2.10.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.20261023.13947",
-      "sha256": "1c5faf8f909599f3c67cb00c9370946d6ffd505ee2885a7d62170f253b3c736d"
+      "release": "1.20261023.60554",
+      "sha256": "c05fa12d8b1bed4efd2d1e6a0e29a7dae23ee0e665b8117d08c7dc1d458876d4"
     }
   }
 }