@blazingagents/sdk 0.30.0 → 0.32.0

package/dist/resources/skills.js

@@ -1,10 +1,10 @@
 import { skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "../contracts/entities/skills.js";
-import { isRequestAborted, requestAbortedError, requestJson, requestStream, } from "../http.js";
+import { apiPath, isRequestAborted, requestAbortedError, requestJson, requestStream, } from "../http.js";
 /**
  * Builds a Skill file URL with encoded Agent, Skill, and file path values.
  */
 function fileUrl(agentId, input) {
-    return `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(input.skillId)}/files?path=${encodeURIComponent(input.path)}`;
+    return apiPath `/v1/agents/${agentId}/skills/${input.skillId}/files?path=${input.path}`;
 }
 /**
  * Builds the Agent Skills operations using the shared HTTP configuration.
@@ -17,19 +17,19 @@ export function createAgentSkillsResource(config, agentId) {
          * Copies skills.
          */
         async copy({ skillId, to, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}/copies`, { json: to, method: "POST", signal: abortSignal }, skillCopyResultsSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}/copies`, { json: to, method: "POST", signal: abortSignal }, skillCopyResultsSchema);
         },
         /**
          * Creates skills.
          */
         async create({ abortSignal, ...body }) {
-            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { json: body, method: "POST", signal: abortSignal }, skillDetailSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/skills`, { json: body, method: "POST", signal: abortSignal }, skillDetailSchema);
         },
         /**
          * Deletes skills.
          */
         async delete({ skillId, abortSignal }) {
-            await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, { method: "DELETE", signal: abortSignal });
+            await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}`, { method: "DELETE", signal: abortSignal });
         },
         /**
          * Deletes a Skill file.
@@ -44,7 +44,7 @@ export function createAgentSkillsResource(config, agentId) {
          * Retrieves skills.
          */
         async get({ skillId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, { signal: abortSignal }, skillDetailSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}`, { signal: abortSignal }, skillDetailSchema);
         },
         /**
          * Reads Skill file bytes.
@@ -67,7 +67,7 @@ export function createAgentSkillsResource(config, agentId) {
          * Lists one page of skills.
          */
         async list({ cursor, limit, abortSignal } = {}) {
-            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { signal: abortSignal, query: { cursor, limit } }, skillsListResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/skills`, { signal: abortSignal, query: { cursor, limit } }, skillsListResponseSchema);
         },
         /**
          * Replaces a Skill file with the supplied content.
@@ -75,6 +75,7 @@ export function createAgentSkillsResource(config, agentId) {
         async putFile({ content, abortSignal, ...input }) {
             return await requestJson(config, fileUrl(agentId, input), {
                 body: content,
+                headers: { "content-type": "application/octet-stream" },
                 method: "PUT",
                 signal: abortSignal,
             }, skillDetailSchema);
@@ -89,7 +90,7 @@ export function createAgentSkillsResource(config, agentId) {
                 ? source.file
                 : new Blob([source.file]);
             form.set("file", file, `skill.${source.type}`);
-            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/upload`, { body: form, method: "POST", signal: abortSignal }, skillDetailSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/upload`, { body: form, method: "POST", signal: abortSignal }, skillDetailSchema);
         },
     };
 }

package/dist/resources/tasks.js

@@ -1,5 +1,5 @@
 import { createTaskResponseSchema, createTaskRunResponseSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunsListResponseSchema, tasksListResponseSchema, } from "../contracts/entities/tasks.js";
-import { requestJson } from "../http.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * `client.tasks` — CRUD + runs over `/v1/tasks`. Runs are listed/get/
  * canceled/transcripted via `/v1/tasks/:taskId/runs/...`. All lists are
@@ -29,8 +29,7 @@ export function createTasksResource(config) {
                     agentId: options.agentId,
                     cursor: options.cursor,
                     limit: options.limit,
-                    // Stryker disable next-line ConditionalExpression: URL serialization omits an undefined query value.
-                    ...(options.userId === undefined ? {} : { userId: options.userId }),
+                    userId: options.userId,
                 },
             }, tasksListResponseSchema);
         },
@@ -38,13 +37,13 @@ export function createTasksResource(config) {
          * Retrieves tasks.
          */
         async get({ taskId, abortSignal }) {
-            return await requestJson(config, `/v1/tasks/${taskId}`, { signal: abortSignal }, taskResponseSchema);
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}`, { signal: abortSignal }, taskResponseSchema);
         },
         /**
          * Updates tasks.
          */
         async update({ taskId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/tasks/${taskId}`, {
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}`, {
                 json: body,
                 signal: abortSignal,
                 method: "PATCH",
@@ -54,7 +53,7 @@ export function createTasksResource(config) {
          * Deletes tasks.
          */
         async delete({ taskId, abortSignal }) {
-            await requestJson(config, `/v1/tasks/${taskId}`, {
+            await requestJson(config, apiPath `/v1/tasks/${taskId}`, {
                 method: "DELETE",
                 signal: abortSignal,
             });
@@ -63,13 +62,13 @@ export function createTasksResource(config) {
          * Creates a Task run.
          */
         async createRun({ taskId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/tasks/${taskId}/runs`, { json: body, method: "POST", signal: abortSignal }, createTaskRunResponseSchema);
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}/runs`, { json: body, method: "POST", signal: abortSignal }, createTaskRunResponseSchema);
         },
         /**
          * Lists one page of Task runs.
          */
         async listRuns({ taskId, ...options }) {
-            return await requestJson(config, `/v1/tasks/${taskId}/runs`, {
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}/runs`, {
                 signal: options.abortSignal,
                 query: { cursor: options.cursor, limit: options.limit },
             }, taskRunsListResponseSchema);
@@ -78,13 +77,13 @@ export function createTasksResource(config) {
          * Retrieves a Task run.
          */
         async getRun({ taskId, runId, abortSignal }) {
-            return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}`, { signal: abortSignal }, taskRunResponseSchema);
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}/runs/${runId}`, { signal: abortSignal }, taskRunResponseSchema);
         },
         /**
          * Lists one page of Task run messages.
          */
         async runMessages({ taskId, runId, ...options }) {
-            return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/messages`, {
+            return await requestJson(config, apiPath `/v1/tasks/${taskId}/runs/${runId}/messages`, {
                 signal: options.abortSignal,
                 query: {
                     cursor: options.cursor,
@@ -97,7 +96,7 @@ export function createTasksResource(config) {
          * Requests cancellation of a Task run.
          */
         async cancelRun({ taskId, runId, abortSignal }) {
-            await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/cancel`, { method: "POST", signal: abortSignal });
+            await requestJson(config, apiPath `/v1/tasks/${taskId}/runs/${runId}/cancel`, { method: "POST", signal: abortSignal });
         },
     };
 }

package/dist/resources/usage.js

@@ -1,5 +1,5 @@
 import { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewResponseSchemaForQuery, usageResponseSchema, } from "../contracts/entities/usage.js";
-import { requestJson } from "../http.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
  * `/v1/agents/:agentId/usage` (per-agent). The query shape is `UsageQuery`;
@@ -33,7 +33,7 @@ export function createUsageResource(config) {
          * Retrieves usage for one Agent.
          */
         async getForAgent({ agentId, abortSignal, ...query }) {
-            return await requestJson(config, `/v1/agents/${agentId}/usage`, { query, signal: abortSignal }, usageResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/usage`, { query, signal: abortSignal }, usageResponseSchema);
         },
         /**
          * Retrieves usage totals, daily usage, and bounded rankings.

package/dist/resources/workspaces.js

@@ -1,5 +1,5 @@
 import { workspaceSchema, workspacesListResponseSchema, } from "../contracts/entities/workspaces.js";
-import { requestJson, requestStream } from "../http.js";
+import { apiPath, requestJson, requestStream } from "../http.js";
 /**
  * Builds the Workspaces operations using the shared HTTP configuration.
  * @param config - Shared authentication and transport configuration.
@@ -21,14 +21,14 @@ export function createWorkspacesResource(config) {
          * Deletes workspaces.
          */
         async delete({ workspaceId, abortSignal }) {
-            const response = await requestStream(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { method: "DELETE", signal: abortSignal });
+            const response = await requestStream(config, apiPath `/v1/workspaces/${workspaceId}`, { method: "DELETE", signal: abortSignal });
             return response.status === 202 ? "pending" : "completed";
         },
         /**
          * Retrieves workspaces.
          */
         async get({ workspaceId, abortSignal }) {
-            return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { signal: abortSignal }, workspaceSchema);
+            return await requestJson(config, apiPath `/v1/workspaces/${workspaceId}`, { signal: abortSignal }, workspaceSchema);
         },
         /**
          * Lists one page of workspaces.
@@ -47,7 +47,7 @@ export function createWorkspacesResource(config) {
          * Updates workspaces.
          */
         async update({ workspaceId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { json: body, signal: abortSignal, method: "PUT" }, workspaceSchema);
+            return await requestJson(config, apiPath `/v1/workspaces/${workspaceId}`, { json: body, signal: abortSignal, method: "PUT" }, workspaceSchema);
         },
     };
 }

package/dist/types.d.ts

@@ -3,7 +3,7 @@ import type { ApiErrorCode } from "./contracts/api.ts";
 import type { Agent, AgentsResponse, CreateAgentBody, UpdateAgentBody } from "./contracts/entities/agents.ts";
 import type { ArtifactDownloadUrlResponse, ArtifactListItem, ArtifactsListResponse } from "./contracts/entities/artifacts.ts";
 import type { BlazingAgentsChatMessageMetadata } from "./contracts/entities/chat.ts";
-import type { ChatConnection, ChatConnectionsResponse, ChatDeliveriesResponse, ChatDeliveryListStatus, CreateChatConnectionBody, RotateChatConnectionBody, UpdateChatConnectionBody } from "./contracts/entities/chat-connections.ts";
+import type { ChatConnection, ChatConnectionsResponse, ChatDeliveriesResponse, ChatDeliveryList, ChatDeliveryListStatus, ChatDeliveryResult, CreateChatConnectionBody, RepairChatDeliveryBody, RotateChatConnectionBody, UpdateChatConnectionBody } from "./contracts/entities/chat-connections.ts";
 import type { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResponse, McpConnectionOauthConnectResponse, McpConnectionReconnectResult, McpConnectionResponse, McpConnectionsResponse, McpConnectionTestResponse, ReconnectMcpConnectionBody, UpdateMcpAttachmentBody, UpdateMcpConnectionBody } from "./contracts/entities/mcp-connections.ts";
 import type { CreateMemoryBody, MemoriesListResponse, MemoryResponse, UpdateMemoryBody } from "./contracts/entities/memories.ts";
 import type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBindingsResponse, MerchantConnectionResponse, MerchantUsageEventResponse, MerchantUsageEventStatus, MerchantUsageEventsResponse, MerchantUsageSummaryResponse, UpdateMerchantConnectionBody, UpsertMerchantBindingBody } from "./contracts/entities/merchant.ts";
@@ -61,24 +61,8 @@ export interface BlazingAgentsOptions {
 export interface BlazingAgentsRequestOptions {
     clientRequestId: string;
 }
-/**
- * Agent operations on a user-scoped client. The API refuses the spending limit
- * methods for user-scoped callers.
- */
-export interface UserAgentsResource extends Omit<AgentsResource, "getSpendingLimit" | "updateSpendingLimit"> {
-    /**
-     * @deprecated The API always refuses this for user-scoped callers with
-     * `forbidden` (403). Call it on the tenant client instead. It is removed
-     * from user-scoped clients in a later release.
-     */
-    getSpendingLimit: AgentsResource["getSpendingLimit"];
-    /**
-     * @deprecated The API always refuses this for user-scoped callers with
-     * `forbidden` (403). Call it on the tenant client instead. It is removed
-     * from user-scoped clients in a later release.
-     */
-    updateSpendingLimit: AgentsResource["updateSpendingLimit"];
-}
+/** Agent operations on a user-scoped client, which has no spending limits. */
+export type UserAgentsResource = Omit<AgentsResource, "getSpendingLimit" | "updateSpendingLimit">;
 export interface UserClient {
     /**
      * Returns the Skill operations for the selected Agent.
@@ -673,7 +657,9 @@ export interface ProvidersResource {
 }
 export interface McpConnectionsResource {
     /**
-     * Starts OAuth authorization for the MCP Connection.
+     * Starts OAuth authorization for the MCP Connection. The API serves this
+     * route only to a dashboard session (`DashboardJwt`) and refuses an API
+     * key, so a client built with an API key gets an error.
      * @param input - `mcpConnectionId`; optional abortSignal.
      * @returns The mcp connection oauth connect response.
      * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
@@ -1307,6 +1293,35 @@ export interface ChatConnectionsResource {
      * @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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazingagents/sdk",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "TypeScript SDK for the Blazing Agents API",
   "homepage": "https://docs.blazingagents.com",
   "bugs": {
@@ -35,7 +35,7 @@
     "fix": "ultracite fix",
     "lint": "ultracite check",
     "prepack": "npm run build",
-    "test": "vitest run --coverage",
+    "test": "node scripts/check-test-imports.ts && vitest run --coverage",
     "test:consumer": "node test-consumer.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.tests.json",
     "unused": "knip && knip --production --include exports,types,duplicates"