@blazingagents/sdk 0.14.0 → 0.16.0

package/dist/index.d.ts

@@ -6,18 +6,20 @@
 export type { UIMessage } from "ai";
 export { BlazingAgentsChatTransport, type BlazingAgentsChatTransportOptions, } from "./chat-transport.ts";
 export { BlazingAgents } from "./client.ts";
-export type { ApprovalDecision, ApprovalPolicy, ToolReference, } from "./contracts/entities/agent-approval.ts";
-export type { Agent, AgentResponse, AgentsResponse, AgentVersion, AgentVersionsListQuery, AgentVersionsResponse, CreateAgentBody, UpdateAgentBody, } from "./contracts/entities/agents.ts";
+export type { ApprovalDecision, ApprovalPolicy, ToolExecutionReference, ToolReference, } from "./contracts/entities/agent-approval.ts";
+export type { Agent, AgentResponse, AgentsListQuery, AgentsResponse, AgentVersion, AgentVersionsListQuery, AgentVersionsResponse, CreateAgentBody, UpdateAgentBody, } from "./contracts/entities/agents.ts";
 export type { ArtifactDownloadUrlResponse, ArtifactListItem, ArtifactsListResponse, } from "./contracts/entities/artifacts.ts";
 export type { ChatConfiguration, ChatConnection, ChatConnectionsResponse, ChatCredentials, ChatDeliveriesResponse, ChatDelivery, ChatDeliveryListStatus, ChatDeliveryStatus, ChatHealth, ChatIdentity, CreateChatConnectionBody, RotateChatConnectionBody, TenantChatDelivery, UpdateChatConnectionBody, } from "./contracts/entities/chat-connections.ts";
 export type { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResponse, McpConnectionAuthType, McpConnectionOauthConnectResponse, McpConnectionReconnectResult, McpConnectionResponse, McpConnectionStatus, McpConnectionTestResponse, ReconnectMcpConnectionBody, UpdateMcpAttachmentBody, UpdateMcpConnectionBody, } from "./contracts/entities/mcp-connections.ts";
 export type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBindingsResponse, MerchantConnection, MerchantConnectionResponse, MerchantCustomerBinding, MerchantGuard, MerchantProviderKind, MerchantUsageEvent, MerchantUsageEventResponse, MerchantUsageEventStatus, MerchantUsageEventsResponse, MerchantUsageSummary, MerchantUsageSummaryResponse, UpdateMerchantConnectionBody, UpsertMerchantBindingBody, } from "./contracts/entities/merchant.ts";
+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 { ToolApprovalDecisionResponse, ToolApprovalState, ToolApprovalsResponse, } from "./contracts/entities/sessions.ts";
 export type { CreateSkillBody, Skill, SkillArchiveType, SkillCopyResult, SkillCopyResults, SkillDetail, SkillFile, SkillsListResponse, } from "./contracts/entities/skills.ts";
-export type { UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageTotals, } from "./contracts/entities/usage.ts";
+export type { SessionUsageQuery, SessionUsageResponse, UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageTotals, } from "./contracts/entities/usage.ts";
 export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetworkPolicy, WorkspacesListResponse, } from "./contracts/entities/workspaces.ts";
 export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransportOptions, } from "./direct-chat-transport.ts";
 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, AgentVersionsListOptions, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";
+export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, AgentVersionsListOptions, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, ResumeChatInput, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";

package/dist/index.js

@@ -8,4 +8,5 @@ export { BlazingAgentsChatTransport, } from "./chat-transport.js";
 export { BlazingAgents } from "./client.js";
 export { BlazingAgentsDirectChatTransport, } from "./direct-chat-transport.js";
 export { BlazingAgentsError } from "./errors.js";
+export { defineFunction, } from "./functions.js";
 export { createChatRelay, createCompletionRelay, } from "./relay.js";

package/dist/relay.d.ts

@@ -1,6 +1,9 @@
 import type { BlazingAgents } from "./client.ts";
+import type { ChatFunctions } from "./functions.ts";
 export interface RelayContext {
     agentId: string;
+    /** Handlers for this authenticated request; they also resume approved continuations. */
+    functions?: ChatFunctions;
     metadata?: Record<string, unknown>;
     userId: string;
     version?: number;
@@ -9,12 +12,16 @@ export interface SessionOwnershipStore {
     ownerOf(sessionId: string): Promise<string | undefined>;
     recordOwner(sessionId: string, userId: string): Promise<void>;
 }
-interface RelayOptions {
-    client: Pick<BlazingAgents, "chat" | "completion">;
+interface RelayOptions<Method extends keyof BlazingAgents> {
+    client: Pick<BlazingAgents, Method>;
     resolveContext(request: Request): Promise<RelayContext | null>;
 }
-export declare function createChatRelay(options: RelayOptions & {
+/**
+ * Relays useChat submissions. An assistant message carrying approval
+ * responses records each decision and then streams the continuation.
+ */
+export declare function createChatRelay(options: RelayOptions<"chat" | "resumeChat" | "sessions"> & {
     sessions: SessionOwnershipStore;
 }): (request: Request) => Promise<Response>;
-export declare function createCompletionRelay(options: RelayOptions): (request: Request) => Promise<Response>;
+export declare function createCompletionRelay(options: RelayOptions<"completion">): (request: Request) => Promise<Response>;
 export {};

package/dist/relay.js

@@ -1,5 +1,6 @@
 import { safeValidateUIMessages } from "ai";
 import { z } from "zod";
+import { decideApprovalResponses } from "./approvals.js";
 import { sessionIdSchema } from "./contracts/ids.js";
 import { BlazingAgentsError } from "./errors.js";
 const chatBodySchema = z.object({
@@ -11,6 +12,10 @@ const chatBodySchema = z.object({
         .default("submit-message"),
 });
 const completionBodySchema = z.object({ prompt: z.string().trim().min(1) });
+/**
+ * Relays useChat submissions. An assistant message carrying approval
+ * responses records each decision and then streams the continuation.
+ */
 export function createChatRelay(options) {
     return async (request) => {
         try {
@@ -29,9 +34,20 @@ export function createChatRelay(options) {
                 (await options.sessions.ownerOf(body.sessionId)) !== context.userId) {
                 return errorResponse(403, "forbidden", "Session is not available.");
             }
+            const message = validated.data[0];
+            if (message.role === "assistant") {
+                return await relayApprovalResponses(options.client, {
+                    agentId: context.agentId,
+                    functions: context.functions,
+                    message,
+                    request,
+                    sessionId: body.sessionId,
+                });
+            }
             const chatInput = {
                 agentId: context.agentId,
-                message: validated.data[0],
+                functions: context.functions,
+                message,
                 messageId: body.messageId,
                 metadata: context.metadata,
                 abortSignal: request.signal,
@@ -68,6 +84,30 @@ export function createChatRelay(options) {
         }
     };
 }
+async function relayApprovalResponses(client, { functions, message, request, ...input }) {
+    if (input.sessionId === undefined) {
+        return errorResponse(400, "invalid_request", "Tool approval requires an existing Session.");
+    }
+    const target = {
+        agentId: input.agentId,
+        sessionId: input.sessionId,
+        abortSignal: request.signal,
+    };
+    const continuationId = await decideApprovalResponses(client, {
+        ...target,
+        message,
+    });
+    if (continuationId === undefined) {
+        return errorResponse(400, "invalid_request", "The message has no tool approval responses.");
+    }
+    /** An absent registry still resumes, so missing handlers become tool errors instead of a stalled observer. */
+    const continuation = await client.resumeChat({
+        ...target,
+        continuationId,
+        functions: functions ?? {},
+    });
+    return continuation.toResponse();
+}
 export function createCompletionRelay(options) {
     return async (request) => {
         try {

package/dist/resources/agents.d.ts

@@ -1,8 +1,2 @@
 import type { AgentsResource, HttpConfig } from "../types.ts";
-/**
- * `client.agents` — full CRUD over `/v1/agents`. The list endpoint is
- * unpaginated (bounded by the 100/tenant cap); create/update bodies are
- * the core zod contracts' input shapes. Responses are parsed against the
- * core wire schemas (parse-on-read).
- */
 export declare function createAgentsResource(config: HttpConfig): AgentsResource;

package/dist/resources/agents.js

@@ -1,12 +1,6 @@
 import { agentResponseSchema, agentsResponseSchema, agentVersionSchema, agentVersionsResponseSchema, } from "../contracts/entities/agents.js";
 import { mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, } from "../contracts/entities/mcp-connections.js";
 import { requestJson } from "../http.js";
-/**
- * `client.agents` — full CRUD over `/v1/agents`. The list endpoint is
- * unpaginated (bounded by the 100/tenant cap); create/update bodies are
- * the core zod contracts' input shapes. Responses are parsed against the
- * core wire schemas (parse-on-read).
- */
 export function createAgentsResource(config) {
     const getVersion = async ({ agentId, version, abortSignal, }) => requestJson(config, `/v1/agents/${agentId}/versions/${version}`, { signal: abortSignal }, agentVersionSchema);
     const update = async ({ agentId, abortSignal, ...body }) => requestJson(config, `/v1/agents/${agentId}`, {
@@ -26,6 +20,8 @@ export function createAgentsResource(config) {
             return await requestJson(config, "/v1/agents", {
                 signal: options.abortSignal,
                 query: {
+                    cursor: options.cursor,
+                    limit: options.limit,
                     userId: options.userId,
                     workspaceId: options.workspaceId,
                 },

package/dist/resources/prompts.d.ts

@@ -1,6 +1,2 @@
 import type { HttpConfig, PromptsResource } from "../types.ts";
-/**
- * `client.prompts` — CRUD over `/v1/prompts`. The list endpoint is
- * unpaginated (bounded by the 100/tenant cap).
- */
 export declare function createPromptsResource(config: HttpConfig): PromptsResource;

package/dist/resources/prompts.js

@@ -1,9 +1,5 @@
 import { promptResponseSchema, promptsResponseSchema, } from "../contracts/entities/prompts.js";
 import { requestJson } from "../http.js";
-/**
- * `client.prompts` — CRUD over `/v1/prompts`. The list endpoint is
- * unpaginated (bounded by the 100/tenant cap).
- */
 export function createPromptsResource(config) {
     return {
         async create({ abortSignal, ...body }) {
@@ -13,10 +9,10 @@ export function createPromptsResource(config) {
                 method: "POST",
             }, promptResponseSchema);
         },
-        async list({ userId, agentId, abortSignal } = {}) {
+        async list({ userId, agentId, cursor, limit, abortSignal } = {}) {
             return await requestJson(config, "/v1/prompts", {
                 signal: abortSignal,
-                query: { userId, agentId },
+                query: { userId, agentId, cursor, limit },
             }, promptsResponseSchema);
         },
         async get({ promptId, abortSignal }) {

package/dist/resources/sessions.js

@@ -1,5 +1,6 @@
 import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
-import { buildTerminalStreamResult } from "../generation.js";
+import { stripFunctionEvents } from "../functions.js";
+import { buildTerminalStreamResult, withFilteredBody } from "../generation.js";
 import { requestJson, requestStream } from "../http.js";
 /**
  * `client.sessions` — list/get-messages/delete over
@@ -53,7 +54,8 @@ export function createSessionsResource(config) {
         },
         async joinToolApprovalContinuation({ agentId, sessionId, continuationId, abortSignal, }) {
             const response = await requestStream(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approval-continuations/${continuationId}`, { signal: abortSignal });
-            return buildTerminalStreamResult(response, "continuation");
+            /** Observers never execute calls; private events are removed unclaimed. */
+            return buildTerminalStreamResult(withFilteredBody(response, stripFunctionEvents), "continuation");
         },
         async toolApprovals({ agentId, sessionId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals`, { signal: abortSignal }, toolApprovalsResponseSchema);

package/dist/resources/usage.js

@@ -1,4 +1,4 @@
-import { usageOverviewResponseSchemaForQuery, usageResponseSchema, } from "../contracts/entities/usage.js";
+import { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewResponseSchemaForQuery, usageResponseSchema, } from "../contracts/entities/usage.js";
 import { requestJson } from "../http.js";
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
@@ -7,6 +7,14 @@ import { requestJson } from "../http.js";
  */
 export function createUsageResource(config) {
     return {
+        async sessions({ abortSignal, ...input }) {
+            const body = sessionUsageQuerySchema.parse(input);
+            return await requestJson(config, "/v1/usage/sessions", {
+                method: "POST",
+                json: body,
+                signal: abortSignal,
+            }, sessionUsageResponseSchema);
+        },
         async get({ abortSignal, ...query } = {}) {
             return await requestJson(config, "/v1/usage", {
                 query,

package/dist/types.d.ts

@@ -13,8 +13,9 @@ import type { DecideToolApprovalBody, LatestSessionsListResponse, SessionMessage
 import type { CreateSkillBody, SkillArchiveType, SkillCopyResults, SkillDetail, SkillsListResponse } from "./contracts/entities/skills.ts";
 import type { CreateTaskBody, CreateTaskResponse, CreateTaskRunBody, CreateTaskRunResponse, TaskResponse, TaskRunMessagesResponse, TaskRunResponse, TaskRunsListResponse, TasksListResponse, UpdateTaskBody } from "./contracts/entities/tasks.ts";
 import type { TenantSettingsResponse, UpdateTenantSettingsBody } from "./contracts/entities/tenants.ts";
-import type { UsageOverviewQuery, UsageOverviewResponse, UsageQuery, UsageResponse } from "./contracts/entities/usage.ts";
+import type { SessionUsageQuery, SessionUsageResponse, UsageOverviewQuery, UsageOverviewResponse, UsageQuery, UsageResponse } from "./contracts/entities/usage.ts";
 import type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspacesListResponse } from "./contracts/entities/workspaces.ts";
+import type { ChatFunctions } from "./functions.ts";
 export type KnownBlazingAgentsErrorCode = ApiErrorCode | "invalid_response" | "network_error" | "request_aborted" | "stream_error";
 export type BlazingAgentsErrorCode = KnownBlazingAgentsErrorCode | (string & {});
 export type BlazingAgentsFetch = (input: string, init?: BlazingAgentsRequestInit) => Promise<Response>;
@@ -46,6 +47,7 @@ export interface HttpConfig {
     clientRequestId?: string;
     fetch?: BlazingAgentsFetch;
     onResponse?: ((response: ResponseObservation) => void) | undefined;
+    scopeUserId?: string;
 }
 export interface BlazingAgentsOptions {
     apiKey: string;
@@ -57,6 +59,24 @@ export interface BlazingAgentsOptions {
 export interface BlazingAgentsRequestOptions {
     clientRequestId: string;
 }
+export interface UserClient {
+    agent(input: {
+        agentId: string;
+    }): AgentClient;
+    readonly agents: AgentsResource;
+    readonly artifacts: ArtifactsResource;
+    chat(input: ChatInput): Promise<ChatResult>;
+    completion(input: CompletionInput): Promise<CompletionResult>;
+    readonly memories: MemoriesResource;
+    object(input: ObjectInput): Promise<ObjectResult>;
+    readonly prompts: PromptsResource;
+    resumeChat(input: ResumeChatInput): Promise<ChatResult>;
+    readonly sessions: SessionsResource;
+    readonly tasks: TasksResource;
+    readonly usage: Pick<UsageResource, "get" | "sessions">;
+    withOptions(options: BlazingAgentsRequestOptions): UserClient;
+    readonly workspaces: WorkspacesResource;
+}
 export interface ResponseObservation {
     clientRequestId?: string;
     durationMs: number;
@@ -94,6 +114,8 @@ type ChatSessionInput = NewSessionInput | ExistingSessionInput;
 interface ChatMessageContentInput extends AttributionInput, CorrelatedRequestInput {
     abortSignal?: AbortSignal;
     agentId: string;
+    /** Caller-local functions for this invocation; handlers run in this process. */
+    functions?: ChatFunctions;
     message: UIMessage;
     messageId?: string;
     promptId?: never;
@@ -102,6 +124,8 @@ interface ChatMessageContentInput extends AttributionInput, CorrelatedRequestInp
 interface ChatPromptContentInput extends AttributionInput, CorrelatedRequestInput {
     abortSignal?: AbortSignal;
     agentId: string;
+    /** Caller-local functions for this invocation; handlers run in this process. */
+    functions?: ChatFunctions;
     message?: never;
     messageId?: string;
     promptId: string;
@@ -110,6 +134,15 @@ interface ChatPromptContentInput extends AttributionInput, CorrelatedRequestInpu
 export type ChatMessageInput = ChatMessageContentInput & ChatSessionInput;
 export type ChatPromptInput = ChatPromptContentInput & ChatSessionInput;
 export type ChatInput = ChatMessageInput | ChatPromptInput;
+/** Reattaches handlers to a Session's tool-approval continuation. */
+export interface ResumeChatInput extends CorrelatedRequestInput {
+    abortSignal?: AbortSignal;
+    agentId: string;
+    /** The decided continuation; omitted, the Session's queued or running one is resumed. */
+    continuationId?: string;
+    functions: ChatFunctions;
+    sessionId: string;
+}
 export interface ChatResult {
     requestId?: string;
     /**
@@ -234,6 +267,8 @@ export interface AgentClient {
     readonly skills: AgentSkillsResource;
 }
 export interface AgentsListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
     userId?: string;
     workspaceId?: string;
 }
@@ -313,6 +348,8 @@ export interface PromptsResource {
     list(input?: {
         userId?: string;
         agentId?: string;
+        cursor?: string;
+        limit?: number;
     } & ResourceRequestOptions): Promise<PromptsResponse>;
     update(input: UpdatePromptBody & {
         promptId: string;
@@ -506,6 +543,7 @@ export interface UsageResource {
     } & ResourceRequestOptions): Promise<UsageResponse>;
     /** Returns totals, daily usage, and bounded Agent, user, and model rankings. */
     overview(input?: Partial<UsageOverviewQuery> & ResourceRequestOptions): Promise<UsageOverviewResponse>;
+    sessions(input: SessionUsageQuery & ResourceRequestOptions): Promise<SessionUsageResponse>;
 }
 /**
  * `client.merchantConnection` — the tenant's own Polar/Dodo merchant

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazingagents/sdk",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "TypeScript SDK for the Blazing Agents API",
   "homepage": "https://docs.blazingagents.com",
   "bugs": {
@@ -35,26 +35,28 @@
     "lint": "ultracite check",
     "prepack": "npm run build",
     "test": "vitest run --coverage",
-    "test:consumer": "npm run build && tsc -p tsconfig.consumer.json && vitest run -c vitest.consumer.config.mts",
+    "test:consumer": "node test-consumer.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.tests.json"
   },
   "dependencies": {
     "croner": "10.0.1",
     "nanoid": "6.0.1",
-    "yaml": "2.9.0",
-    "zod": "4.5.4"
+    "yaml": "2.9.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.8",
+    "@types/json-schema": "7.0.15",
     "@types/node": "^26.4.0",
     "@vitest/coverage-v8": "^4.1.10",
     "ai": "^7.0.84",
     "typescript": "^7.0.2",
     "ultracite": "^7.10.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "zod": "4.5.4"
   },
   "peerDependencies": {
-    "ai": "^7.0.84"
+    "ai": "^7.0.84",
+    "zod": "^4.5.4"
   },
   "engines": {
     "node": ">=24"