@blazingagents/sdk 0.33.0 → 0.35.0

package/dist/contracts/limitations.d.ts

@@ -10,8 +10,8 @@ export declare const MAX_WORKSPACE_NAME_LENGTH = 80;
 export declare const MAX_SKILL_NAME_LENGTH = 64;
 export declare const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
 export declare const MAX_SKILL_COPY_DESTINATIONS = 30;
-export declare const DEFAULT_PROMPTS_LIST_LIMIT = 50;
-export declare const MAX_PROMPTS_LIST_LIMIT = 100;
+export declare const DEFAULT_RESOURCES_LIST_LIMIT = 50;
+export declare const MAX_RESOURCES_LIST_LIMIT = 100;
 export declare const MAX_PROMPT_TEMPLATE_BYTES: number;
 export declare const MAX_PROMPT_VARIABLES = 10;
 export declare const MAX_PROMPT_NAME_LENGTH = 80;
@@ -38,8 +38,6 @@ export declare const MAX_MCP_ATTACHMENT_METADATA_KEYS = 32;
 export declare const MAX_MCP_ATTACHMENT_METADATA_KEY_LENGTH = 64;
 /** Agents — name ≤ 80, instructions ≤ 3000. */
 export declare const MAX_AGENT_NAME_LENGTH = 80;
-export declare const DEFAULT_AGENTS_LIST_LIMIT = 50;
-export declare const MAX_AGENTS_LIST_LIMIT = 100;
 export declare const MAX_AGENT_INSTRUCTIONS_LENGTH = 3000;
 /** Artifacts — 10 MiB per file. */
 export declare const MAX_ARTIFACT_BYTES: number;

package/dist/contracts/limitations.js

@@ -10,8 +10,8 @@ export const MAX_WORKSPACE_NAME_LENGTH = 80;
 export const MAX_SKILL_NAME_LENGTH = 64;
 export const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
 export const MAX_SKILL_COPY_DESTINATIONS = 30;
-export const DEFAULT_PROMPTS_LIST_LIMIT = 50;
-export const MAX_PROMPTS_LIST_LIMIT = 100;
+export const DEFAULT_RESOURCES_LIST_LIMIT = 50;
+export const MAX_RESOURCES_LIST_LIMIT = 100;
 export const MAX_PROMPT_TEMPLATE_BYTES = 10 * 1024;
 export const MAX_PROMPT_VARIABLES = 10;
 export const MAX_PROMPT_NAME_LENGTH = 80;
@@ -38,8 +38,6 @@ export const MAX_MCP_ATTACHMENT_METADATA_KEYS = 32;
 export const MAX_MCP_ATTACHMENT_METADATA_KEY_LENGTH = 64;
 /** Agents — name ≤ 80, instructions ≤ 3000. */
 export const MAX_AGENT_NAME_LENGTH = 80;
-export const DEFAULT_AGENTS_LIST_LIMIT = 50;
-export const MAX_AGENTS_LIST_LIMIT = 100;
 export const MAX_AGENT_INSTRUCTIONS_LENGTH = 3000;
 /** Artifacts — 10 MiB per file. */
 export const MAX_ARTIFACT_BYTES = 10 * 1024 * 1024;

package/dist/direct-chat-transport.js

@@ -2,6 +2,7 @@ import { lastAssistantMessageIsCompleteWithApprovalResponses, } from "ai";
 import { extractApprovalDecisions } from "./approvals.js";
 import { ChatStreamTransport } from "./chat-stream-transport.js";
 import { sessionIdSchema } from "./contracts/ids.js";
+import { parseClientInput } from "./errors.js";
 /** Connects useChat directly to the SDK, including native streaming fetch clients. */
 export class BlazingAgentsDirectChatTransport extends ChatStreamTransport {
     #options;
@@ -16,7 +17,7 @@ export class BlazingAgentsDirectChatTransport extends ChatStreamTransport {
         this.#sessionId =
             options.sessionId === undefined
                 ? undefined
-                : sessionIdSchema.parse(options.sessionId);
+                : parseClientInput(sessionIdSchema, options.sessionId, "sessionId");
     }
     /**
      * Submits the supplied user messages directly to the SDK chat endpoint.

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import type { BlazingAgentsErrorCode } from "./types.ts";
 declare const BLAZING_AGENTS_ERROR_SYMBOL: unique symbol;
 export declare class BlazingAgentsError extends Error {
@@ -39,4 +40,14 @@ export declare class BlazingAgentsError extends Error {
      */
     static isInstance(error: unknown): error is BlazingAgentsError;
 }
+/**
+ * Parses caller input the SDK must check before any request, such as a value
+ * that becomes a header or transport state.
+ * @param schema - Schema the value must satisfy.
+ * @param value - Caller-supplied value.
+ * @param param - Name of the caller parameter, reported on the error.
+ * @returns The parsed value.
+ * @throws BlazingAgentsError - With code `invalid_request` if the value is invalid.
+ */
+export declare function parseClientInput<Schema extends z.ZodType>(schema: Schema, value: unknown, param: string): z.output<Schema>;
 export {};

package/dist/errors.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 /**
  * The SDK's single error class. Server codes remain open for forward
  * compatibility; SDK-local codes distinguish transport, response, abort, and
@@ -53,3 +54,23 @@ export class BlazingAgentsError extends Error {
         return BLAZING_AGENTS_ERROR_SYMBOL in error;
     }
 }
+/**
+ * Parses caller input the SDK must check before any request, such as a value
+ * that becomes a header or transport state.
+ * @param schema - Schema the value must satisfy.
+ * @param value - Caller-supplied value.
+ * @param param - Name of the caller parameter, reported on the error.
+ * @returns The parsed value.
+ * @throws BlazingAgentsError - With code `invalid_request` if the value is invalid.
+ */
+export function parseClientInput(schema, value, param) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        throw new BlazingAgentsError({
+            code: "invalid_request",
+            message: `Invalid ${param}: ${z.prettifyError(parsed.error)}`,
+            param,
+        }, { cause: parsed.error });
+    }
+    return parsed.data;
+}

package/dist/http.d.ts

@@ -2,7 +2,9 @@ import { BlazingAgentsError } from "./errors.ts";
 import type { HttpConfig, RequestOptions } from "./types.ts";
 /**
  * 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 declare function apiPath(template: TemplateStringsArray, ...values: string[]): string;
 /**

package/dist/http.js

@@ -4,11 +4,22 @@ 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.";
+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));
 }
 /**

package/dist/index.d.ts

@@ -17,10 +17,10 @@ export type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBin
 export type { CreatePromptBody, PromptResponse, PromptsListQuery, PromptsResponse, UpdatePromptBody, } from "./contracts/entities/prompts.ts";
 export type { CreateProviderBody, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ProviderType, ThinkingLevelsResponse, UpdateProviderBody, } from "./contracts/entities/providers.ts";
 export type { ChatSteerConsumedEvent, SessionActivity, SessionInput, SessionInputResponse, SessionInputState, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody, } from "./contracts/entities/session-inputs.ts";
-export type { ContinueToolApprovalsBody, SessionForkedFrom, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, TurnInterruptedEvent, } from "./contracts/entities/sessions.ts";
+export type { ContinueToolApprovalsBody, SessionForkedFrom, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, TurnStreamErrorEvent, } from "./contracts/entities/sessions.ts";
 export { sessionResponseSchema } from "./contracts/entities/sessions.ts";
 export type { CreateSkillBody, Skill, SkillArchiveType, SkillCopyResult, SkillCopyResults, SkillDetail, SkillFile, SkillsListResponse, } from "./contracts/entities/skills.ts";
-export type { SpendingLimit, SpendingLimitResponse, SpendingLimitStopDetails, SpendingLimitStopEvent, UpdateSpendingLimitBody, } from "./contracts/entities/spending-limits.ts";
+export type { SpendingLimit, SpendingLimitResponse, SpendingLimitStopDetails, UpdateSpendingLimitBody, } from "./contracts/entities/spending-limits.ts";
 export { nextSpendingLimitReset } from "./contracts/entities/spending-limits.ts";
 export type { SessionUsageQuery, SessionUsageResponse, UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageTotals, } from "./contracts/entities/usage.ts";
 export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetworkPolicy, WorkspacesListResponse, WorkspaceTier, } from "./contracts/entities/workspaces.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.