@blazingagents/sdk 0.34.0 → 0.36.0

package/dist/http.js

@@ -4,11 +4,38 @@ const DIAGNOSTIC_BODY_LIMIT_BYTES = 64 * 1024;
 const INVALID_RESPONSE_MESSAGE = "The server returned an invalid response.";
 const NETWORK_ERROR_MESSAGE = "Network request failed (fetch threw before any HTTP exchange).";
 const REQUEST_ABORTED_MESSAGE = "The request was aborted before any HTTP response.";
+/** Fields no credential-bearing operation's response may contain. */
+const CREDENTIAL_KEYS = new Set([
+    "apiKey",
+    "api_key",
+    "botToken",
+    "bot_token",
+    "signingSecret",
+    "signing_secret",
+    "webhookSecret",
+    "webhook_secret",
+    "bearerToken",
+    "bearer_token",
+    "clientSecret",
+    "client_secret",
+    "credential",
+]);
+const DOT_OR_EMPTY_SEGMENTS = new Set(["", ".", ".."]);
 /**
  * Builds an endpoint path, encoding each interpolated value so it stays inside
- * one path segment or query value.
+ * one path segment. `encodeURIComponent` leaves `.` and `..` unchanged, and
+ * URL normalization would resolve them against the parent path, so those and
+ * the empty segment are rejected.
  */
 export function apiPath(template, ...values) {
+    for (const value of values) {
+        if (DOT_OR_EMPTY_SEGMENTS.has(value)) {
+            throw new BlazingAgentsError({
+                code: "invalid_request",
+                message: `Invalid path segment ${JSON.stringify(value)}.`,
+            });
+        }
+    }
     return String.raw({ raw: template }, ...values.map(encodeURIComponent));
 }
 /**
@@ -59,14 +86,59 @@ export async function requestJson(config, path, options = {}, schema) {
         }
         throw invalidResponseError(headers, response.status, read.diagnosticBody, true, read.cause);
     }
+    let json;
+    try {
+        json = JSON.parse(read.bodyText);
+    }
+    catch (cause) {
+        throw invalidResponseError(headers, response.status, read.diagnosticBody, read.diagnosticBodyTruncated, cause);
+    }
+    const echoed = options.credentialBearing
+        ? findCredentialKey(json)
+        : undefined;
+    if (echoed !== undefined) {
+        throw new BlazingAgentsError({
+            code: "credential_echo",
+            details: { field: echoed },
+            headers,
+            message: `The server echoed credential field ${JSON.stringify(echoed)}; the response body was discarded.`,
+            requestId: headers.get("x-request-id") ?? undefined,
+            status: response.status,
+        });
+    }
     try {
-        const json = JSON.parse(read.bodyText);
         return schema === undefined ? json : schema.parse(json);
     }
     catch (cause) {
         throw invalidResponseError(headers, response.status, read.diagnosticBody, read.diagnosticBodyTruncated, cause);
     }
 }
+/**
+ * Returns the first credential field found anywhere in a decoded JSON value.
+ */
+function findCredentialKey(value) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const key = findCredentialKey(item);
+            if (key !== undefined) {
+                return key;
+            }
+        }
+        return;
+    }
+    if (value === null || typeof value !== "object") {
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (CREDENTIAL_KEYS.has(key)) {
+            return key;
+        }
+        const nested = findCredentialKey(item);
+        if (nested !== undefined) {
+            return nested;
+        }
+    }
+}
 /**
  * Performs a request and returns the raw `Response` for streaming paths.
  * Non-2xx bodies are decoded before a caller can observe a streaming body.

package/dist/index.d.ts

@@ -28,4 +28,21 @@ export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransport
 export { BlazingAgentsError } from "./errors.ts";
 export { type ChatFunction, type ChatFunctionContext, type ChatFunctions, defineFunction, } from "./functions.ts";
 export { createChatRelay, createCompletionRelay, type RelayContext, type SessionOwnershipStore, } from "./relay.ts";
-export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, BlazingAgentsUIMessageData, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserAgentsResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";
+export type { AgentsListOptions, AgentsResource, UserAgentsResource, } from "./resources/agents.ts";
+export type { ArtifactsResource } from "./resources/artifacts.ts";
+export type { ChatConnectionsResource } from "./resources/chat-connections.ts";
+export type { ChatDeliveriesListOptions, ChatDeliveriesResource, } from "./resources/chat-deliveries.ts";
+export type { McpConnectionsResource } from "./resources/mcp-connections.ts";
+export type { MemoriesListOptions, MemoriesResource, } from "./resources/memories.ts";
+export type { MerchantBindingsListOptions, MerchantBindingsResource, } from "./resources/merchant-bindings.ts";
+export type { MerchantConnectionResource } from "./resources/merchant-connection.ts";
+export type { MerchantUsageEventsListOptions, MerchantUsageEventsResource, } from "./resources/merchant-usage-events.ts";
+export type { PromptsResource } from "./resources/prompts.ts";
+export type { ProvidersResource } from "./resources/providers.ts";
+export type { LatestSessionsListOptions, SessionsResource, } from "./resources/sessions.ts";
+export type { AgentSkillsResource, SkillsListOptions, } from "./resources/skills.ts";
+export type { TasksResource } from "./resources/tasks.ts";
+export type { TenantResource } from "./resources/tenant.ts";
+export type { UsageResource } from "./resources/usage.ts";
+export type { WorkspacesListOptions, WorkspacesResource, } from "./resources/workspaces.ts";
+export type { AgentClient, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, BlazingAgentsUIMessageData, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, ResourceRequestOptions, ResponseObservation, TerminalStreamResult, UserClient, } from "./types.ts";

package/dist/resources/agents.d.ts

@@ -1,4 +1,123 @@
-import type { AgentsResource, HttpConfig, UserAgentsResource } from "../types.ts";
+import { type Agent, type AgentsResponse, type CreateAgentBody, type UpdateAgentBody } from "../contracts/entities/agents.ts";
+import { type McpAttachmentResponse, type McpAttachmentsResponse, type UpdateMcpAttachmentBody } from "../contracts/entities/mcp-connections.ts";
+import { type SpendingLimitResponse, type UpdateSpendingLimitBody } from "../contracts/entities/spending-limits.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+/** Agent operations on a user-scoped client, which has no spending limits. */
+export type UserAgentsResource = Omit<AgentsResource, "getSpendingLimit" | "updateSpendingLimit">;
+export interface AgentsResource {
+    /**
+     * Creates the Agent. Omitting `workspaceId` creates a Core Workspace by default. `workspaceTier` selects its immutable tier and conflicts with `workspaceId`.
+     * @param input - creation fields; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    create(input: CreateAgentBody & ResourceRequestOptions): Promise<Agent>;
+    /**
+     * Deletes the Agent while preserving its attached Workspace.
+     * @param input - `agentId`; optional abortSignal; includeArtifacts controls Artifact deletion.
+     * @returns Resolves when the operation completes.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    delete(input: {
+        agentId: string;
+        includeArtifacts: boolean;
+    } & ResourceRequestOptions): Promise<void>;
+    /**
+     * Disables the Agent.
+     * @param input - `agentId`; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    disable(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<Agent>;
+    /**
+     * Enables the Agent.
+     * @param input - `agentId`; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    enable(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<Agent>;
+    /**
+     * Retrieves the Agent.
+     * @param input - `agentId`; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<Agent>;
+    /** Retrieves the Agent model spending limit. Requires tenant authority. */
+    getSpendingLimit(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<SpendingLimitResponse>;
+    /**
+     * Lists available Agent records.
+     * @param input - filters and pagination options.
+     * @returns Matching Agents. This response has no pagination cursor.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    list(input?: AgentsListOptions): Promise<AgentsResponse>;
+    /**
+     * Lists the Agent MCP attachments.
+     * @param input - `agentId`; optional abortSignal.
+     * @returns The mcp attachments response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    listMcpAttachments(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<McpAttachmentsResponse>;
+    /**
+     * Removes the Agent avatar.
+     * @param input - `agentId`; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    removeAvatar(input: {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<Agent>;
+    /**
+     * Updates the Agent. A concrete `workspaceId` switches the Agent; detachment is unsupported.
+     * @param input - `agentId`; fields to change; optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    update(input: UpdateAgentBody & {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<Agent>;
+    /**
+     * Updates one Agent MCP attachment.
+     * @param input - `agentId`, `mcpConnectionId`; fields to change; optional abortSignal.
+     * @returns The mcp attachment response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    updateMcpAttachment(input: UpdateMcpAttachmentBody & {
+        agentId: string;
+        mcpConnectionId: string;
+    } & ResourceRequestOptions): Promise<McpAttachmentResponse>;
+    /** Sets the Agent model spending limit. Pass null to disable it. Requires tenant authority. */
+    updateSpendingLimit(input: UpdateSpendingLimitBody & {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<SpendingLimitResponse>;
+    /**
+     * Uploads an Agent avatar as multipart form data.
+     * @param input - Target `agentId`, image `file`, and optional abortSignal.
+     * @returns The agent.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    uploadAvatar(input: {
+        agentId: string;
+        file: File;
+    } & ResourceRequestOptions): Promise<Agent>;
+}
+export interface AgentsListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
+    userId?: string;
+    workspaceId?: string;
+}
 /**
  * Builds the Agents operations, including the spending limits that need tenant authority.
  * @param config - Shared authentication and transport configuration.

package/dist/resources/agents.js

@@ -1,6 +1,6 @@
 import { agentResponseSchema, agentsResponseSchema, } from "../contracts/entities/agents.js";
 import { mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, } from "../contracts/entities/mcp-connections.js";
-import { spendingLimitResponseSchema } from "../contracts/entities/spending-limits.js";
+import { spendingLimitResponseSchema, } from "../contracts/entities/spending-limits.js";
 import { apiPath, requestJson } from "../http.js";
 /**
  * Builds the Agents operations, including the spending limits that need tenant authority.
@@ -10,11 +10,9 @@ import { apiPath, requestJson } from "../http.js";
 export function createAgentsResource(config) {
     return {
         ...createUserAgentsResource(config),
-        /** Retrieves the model spending limit using tenant authority. */
         async getSpendingLimit({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/spending-limit`, { signal: abortSignal }, spendingLimitResponseSchema);
         },
-        /** Sets the model spending limit. Null disables it. Requires tenant authority. */
         async updateSpendingLimit({ agentId, abortSignal, ...body }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/spending-limit`, { method: "PUT", json: body, signal: abortSignal }, spendingLimitResponseSchema);
         },
@@ -35,9 +33,6 @@ export function createUserAgentsResource(config) {
         method: "PUT",
     }, agentResponseSchema);
     return {
-        /**
-         * Creates agents.
-         */
         async create({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/agents", {
                 json: body,
@@ -45,9 +40,6 @@ export function createUserAgentsResource(config) {
                 method: "POST",
             }, agentResponseSchema);
         },
-        /**
-         * Lists one page of agents.
-         */
         async list(options = {}) {
             return await requestJson(config, "/v1/agents", {
                 signal: options.abortSignal,
@@ -59,40 +51,22 @@ export function createUserAgentsResource(config) {
                 },
             }, agentsResponseSchema);
         },
-        /**
-         * Retrieves agents.
-         */
         async get({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}`, { signal: abortSignal }, agentResponseSchema);
         },
-        /**
-         * Disables agents.
-         */
         async disable({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/disable`, { method: "POST", signal: abortSignal }, agentResponseSchema);
         },
-        /**
-         * Enables agents.
-         */
         async enable({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/enable`, { method: "POST", signal: abortSignal }, agentResponseSchema);
         },
-        /**
-         * Lists the Agent MCP attachments.
-         */
         async listMcpAttachments({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/mcp-attachments`, { signal: abortSignal }, mcpAttachmentsResponseSchema);
         },
         update,
-        /**
-         * Updates one Agent MCP attachment.
-         */
         async updateMcpAttachment({ agentId, mcpConnectionId, abortSignal, ...body }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/mcp-attachments/${mcpConnectionId}`, { json: body, method: "PATCH", signal: abortSignal }, mcpAttachmentResponseSchema);
         },
-        /**
-         * Deletes agents.
-         */
         async delete({ agentId, includeArtifacts, abortSignal }) {
             await requestJson(config, apiPath `/v1/agents/${agentId}`, {
                 method: "DELETE",
@@ -100,9 +74,6 @@ export function createUserAgentsResource(config) {
                 signal: abortSignal,
             });
         },
-        /**
-         * Uploads an Agent avatar as multipart form data.
-         */
         async uploadAvatar({ agentId, file, abortSignal }) {
             const form = new FormData();
             form.append("file", file);
@@ -112,9 +83,6 @@ export function createUserAgentsResource(config) {
                 method: "POST",
             }, agentResponseSchema);
         },
-        /**
-         * Removes the Agent avatar.
-         */
         async removeAvatar({ agentId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/agents/${agentId}/avatar`, { method: "DELETE", signal: abortSignal }, agentResponseSchema);
         },

package/dist/resources/artifacts.d.ts

@@ -1,4 +1,45 @@
-import type { ArtifactsResource, HttpConfig } from "../types.ts";
+import { type ArtifactDownloadUrlResponse, type ArtifactListItem, type ArtifactsListResponse } from "../contracts/entities/artifacts.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+export interface ArtifactsListOptions extends ResourceRequestOptions {
+    agentId?: string;
+    cursor?: string;
+    sessionId?: string;
+}
+export interface ArtifactsResource {
+    /**
+     * Creates a temporary Artifact download URL.
+     * @param input - `artifactId`; optional abortSignal.
+     * @returns The artifact download url response.
+     */
+    createDownloadUrl(input: {
+        artifactId: string;
+    } & ResourceRequestOptions): Promise<ArtifactDownloadUrlResponse>;
+    /**
+     * Deletes the Artifact.
+     * @param input - `artifactId`; optional abortSignal.
+     * @returns Resolves when the operation completes.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    delete(input: {
+        artifactId: string;
+    } & ResourceRequestOptions): Promise<void>;
+    /**
+     * Retrieves the Artifact.
+     * @param input - `artifactId`; optional abortSignal.
+     * @returns The artifact list item.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input: {
+        artifactId: string;
+    } & ResourceRequestOptions): Promise<ArtifactListItem>;
+    /**
+     * Lists one page of Artifact records.
+     * @param input - filters and pagination options.
+     * @returns The artifacts list response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    list(input?: ArtifactsListOptions): Promise<ArtifactsListResponse>;
+}
 /**
  * `client.artifacts` — Tenant-level metadata and direct download URLs.
  * @param config - Shared authentication and transport configuration.

package/dist/resources/artifacts.js

@@ -7,21 +7,12 @@ import { apiPath, requestJson } from "../http.js";
  */
 export function createArtifactsResource(config) {
     return {
-        /**
-         * Creates a temporary Artifact download URL.
-         */
         async createDownloadUrl({ artifactId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/artifacts/${artifactId}/download-url`, { method: "POST", signal: abortSignal }, artifactDownloadUrlResponseSchema);
         },
-        /**
-         * Retrieves artifacts.
-         */
         async get({ artifactId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/artifacts/${artifactId}`, { signal: abortSignal }, artifactListItemSchema);
         },
-        /**
-         * Lists one page of artifacts.
-         */
         async list({ abortSignal, ...options } = {}) {
             return await requestJson(config, "/v1/artifacts", {
                 signal: abortSignal,
@@ -32,9 +23,6 @@ export function createArtifactsResource(config) {
                 },
             }, artifactsListResponseSchema);
         },
-        /**
-         * Deletes artifacts.
-         */
         async delete({ artifactId, abortSignal }) {
             await requestJson(config, apiPath `/v1/artifacts/${artifactId}`, {
                 method: "DELETE",

package/dist/resources/chat-connections.d.ts

@@ -1,4 +1,113 @@
-import type { ChatConnectionsResource, HttpConfig } from "../types.ts";
+import { type ChatConnection, type ChatConnectionsResponse, type ChatDeliveryList, type ChatDeliveryResult, type CreateChatConnectionBody, type RepairChatDeliveryBody, type RotateChatConnectionBody, type UpdateChatConnectionBody } from "../contracts/entities/chat-connections.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+export interface ChatConnectionsResource {
+    /**
+     * Checks the Chat Connection health.
+     * @param input - `chatConnectionId`; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    checkHealth(input: {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Creates the Chat Connection.
+     * @param input - creation fields; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    create(input: CreateChatConnectionBody & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Deletes the Chat Connection.
+     * @param input - `chatConnectionId`; optional abortSignal.
+     * @returns Resolves when the operation completes.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    delete(input: {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<void>;
+    /**
+     * Disables the Chat Connection.
+     * @param input - `chatConnectionId`; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    disable(input: {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Enables the Chat Connection.
+     * @param input - `chatConnectionId`; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    enable(input: {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Retrieves the Chat Connection.
+     * @param input - `chatConnectionId`; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input: {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Lists available Chat Connection records.
+     * @param input - optional abortSignal.
+     * @returns The chat connections response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    list(input?: ResourceRequestOptions): Promise<ChatConnectionsResponse>;
+    /**
+     * Lists one page of the replies and approval cards the Chat Connection has
+     * sent or tried to send, newest first, in every status. Pass `nextCursor`
+     * as `cursor` to fetch older records.
+     * @param input - `chatConnectionId`; optional `cursor`, `limit` (1 to 100, default 100), and abortSignal.
+     * @returns The page of chat deliveries.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    listDeliveries(input: {
+        chatConnectionId: string;
+        cursor?: string;
+        limit?: number;
+    } & ResourceRequestOptions): Promise<ChatDeliveryList>;
+    /**
+     * Sends a stuck reply or approval card again, without running a turn or
+     * tool. Use it when the previous send stopped before its outcome was known.
+     * Pass the delivery's current `attempt` as `expectedAttempt`; the repair is
+     * refused if it has changed. `previousSenderStopped` and
+     * `acceptDuplicateRisk` must be `true`: the message can appear twice. The
+     * connection must be enabled. Check `status` in the result, because a
+     * successful request does not by itself mean the message was delivered.
+     * @param input - `chatConnectionId`, `deliveryId`, the repair confirmations, and optional abortSignal.
+     * @returns The delivery outcome.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    repairDelivery(input: RepairChatDeliveryBody & {
+        chatConnectionId: string;
+        deliveryId: string;
+    } & ResourceRequestOptions): Promise<ChatDeliveryResult>;
+    /**
+     * Replaces the Chat Connection credentials.
+     * @param input - `chatConnectionId`; fields to change; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    rotateCredentials(input: RotateChatConnectionBody & {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+    /**
+     * Updates the Chat Connection.
+     * @param input - `chatConnectionId`; fields to change; optional abortSignal.
+     * @returns The chat connection.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    update(input: UpdateChatConnectionBody & {
+        chatConnectionId: string;
+    } & ResourceRequestOptions): Promise<ChatConnection>;
+}
 /**
  * Builds the Chat Connections operations using the shared HTTP configuration.
  * @param config - Shared authentication and transport configuration.

package/dist/resources/chat-connections.js

@@ -7,71 +7,58 @@ import { apiPath, requestJson } from "../http.js";
  */
 export function createChatConnectionsResource(config) {
     return {
-        /**
-         * Lists one page of chat connections.
-         */
         async list({ abortSignal } = {}) {
-            return await requestJson(config, "/v1/chat-connections", { signal: abortSignal }, chatConnectionsResponseSchema);
+            return await requestJson(config, "/v1/chat-connections", { credentialBearing: true, signal: abortSignal }, chatConnectionsResponseSchema);
         },
-        /**
-         * Creates chat connections.
-         */
         async create({ abortSignal, ...body }) {
-            return await requestJson(config, "/v1/chat-connections", { signal: abortSignal, method: "POST", json: body }, chatConnectionSchema);
+            return await requestJson(config, "/v1/chat-connections", {
+                credentialBearing: true,
+                signal: abortSignal,
+                method: "POST",
+                json: body,
+            }, chatConnectionSchema);
         },
-        /**
-         * Retrieves chat connections.
-         */
         async get({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "GET" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { credentialBearing: true, signal: abortSignal, method: "GET" }, chatConnectionSchema);
         },
-        /**
-         * Updates chat connections.
-         */
         async update({ chatConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "PATCH", json: body }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, {
+                credentialBearing: true,
+                signal: abortSignal,
+                method: "PATCH",
+                json: body,
+            }, chatConnectionSchema);
         },
-        /**
-         * Replaces the Chat Connection credentials.
-         */
         async rotateCredentials({ chatConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/credentials`, { signal: abortSignal, method: "POST", json: body }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/credentials`, {
+                credentialBearing: true,
+                signal: abortSignal,
+                method: "POST",
+                json: body,
+            }, chatConnectionSchema);
         },
-        /**
-         * Checks the Chat Connection health.
-         */
         async checkHealth({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/health`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/health`, { credentialBearing: true, signal: abortSignal, method: "POST" }, chatConnectionSchema);
         },
-        /**
-         * Lists one page of the Chat Connection's deliveries.
-         */
         async listDeliveries({ chatConnectionId, abortSignal, ...query }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries`, { signal: abortSignal, query }, chatDeliveryListSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries`, { credentialBearing: true, signal: abortSignal, query }, chatDeliveryListSchema);
         },
-        /**
-         * Sends a stuck Chat delivery again.
-         */
         async repairDelivery({ chatConnectionId, deliveryId, abortSignal, ...body }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries/${deliveryId}/repair`, { signal: abortSignal, method: "POST", json: body }, chatDeliveryResultSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries/${deliveryId}/repair`, {
+                credentialBearing: true,
+                signal: abortSignal,
+                method: "POST",
+                json: body,
+            }, chatDeliveryResultSchema);
         },
-        /**
-         * Enables chat connections.
-         */
         async enable({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/enable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/enable`, { credentialBearing: true, signal: abortSignal, method: "POST" }, chatConnectionSchema);
         },
-        /**
-         * Disables chat connections.
-         */
         async disable({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/disable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/disable`, { credentialBearing: true, signal: abortSignal, method: "POST" }, chatConnectionSchema);
         },
-        /**
-         * Deletes chat connections.
-         */
         async delete({ chatConnectionId, abortSignal }) {
-            await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "DELETE" });
+            await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { credentialBearing: true, signal: abortSignal, method: "DELETE" });
         },
     };
 }