@blazingagents/sdk 0.15.0 → 0.17.0

package/dist/resources/agents.js

@@ -1,8 +1,7 @@
-import { agentResponseSchema, agentsResponseSchema, agentVersionSchema, agentVersionsResponseSchema, } from "../contracts/entities/agents.js";
+import { agentResponseSchema, agentsResponseSchema, } from "../contracts/entities/agents.js";
 import { mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, } from "../contracts/entities/mcp-connections.js";
 import { requestJson } from "../http.js";
 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}`, {
         json: body,
         signal: abortSignal,
@@ -36,40 +35,9 @@ export function createAgentsResource(config) {
         async enable({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/enable`, { method: "POST", signal: abortSignal }, agentResponseSchema);
         },
-        getVersion,
-        async listVersions({ agentId, ...options }) {
-            return await requestJson(config, `/v1/agents/${agentId}/versions`, {
-                signal: options.abortSignal,
-                query: { cursor: options.cursor, limit: options.limit },
-            }, agentVersionsResponseSchema);
-        },
         async listMcpAttachments({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/mcp-attachments`, { signal: abortSignal }, mcpAttachmentsResponseSchema);
         },
-        async restoreVersion({ agentId, version: versionNumber, abortSignal }) {
-            const version = await getVersion({
-                agentId,
-                version: versionNumber,
-                abortSignal,
-            });
-            return update({
-                agentId,
-                abortSignal,
-                approvalInChat: version.approvalInChat,
-                approvalInTasks: version.approvalInTasks,
-                name: version.name,
-                model: version.model,
-                thinkingLevel: version.thinkingLevel,
-                autoCompaction: version.autoCompaction,
-                compactionReserveTokens: version.compactionReserveTokens,
-                providerId: version.providerId,
-                memoryInjectionEnabled: version.memoryInjectionEnabled,
-                tools: version.tools,
-                instructions: version.instructions,
-                metadata: version.metadata,
-                mcpConnectionIds: version.mcpConnectionIds,
-            });
-        },
         update,
         async updateMcpAttachment({ agentId, mcpConnectionId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/agents/${agentId}/mcp-attachments/${mcpConnectionId}`, { json: body, method: "PATCH", signal: abortSignal }, mcpAttachmentResponseSchema);

package/dist/resources/providers.js

@@ -36,7 +36,7 @@ export function createProvidersResource(config) {
                 method: "DELETE",
                 signal: abortSignal,
                 query: {
-                    confirmVersionInvalidation: options.confirmVersionInvalidation,
+                    confirmSnapshotInvalidation: options.confirmSnapshotInvalidation,
                 },
             });
         },

package/dist/resources/sessions.d.ts

@@ -1,6 +1,6 @@
 import type { HttpConfig, SessionsResource } from "../types.ts";
 /**
- * `client.sessions` — list/get-messages/delete over
+ * `client.sessions` reads, paginates, and deletes Sessions under
  * `/v1/agents/:agentId/sessions`. Pagination is manual: the SDK returns
  * the page as-is (`{ data, nextCursor }` verbatim); the caller passes
  * `nextCursor` back as `cursor` on the next call.

package/dist/resources/sessions.js

@@ -1,14 +1,18 @@
-import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
-import { buildTerminalStreamResult } from "../generation.js";
+import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.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
+ * `client.sessions` reads, paginates, and deletes Sessions under
  * `/v1/agents/:agentId/sessions`. Pagination is manual: the SDK returns
  * the page as-is (`{ data, nextCursor }` verbatim); the caller passes
  * `nextCursor` back as `cursor` on the next call.
  */
 export function createSessionsResource(config) {
     return {
+        async get({ agentId, sessionId, abortSignal }) {
+            return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}`, { signal: abortSignal }, sessionResponseSchema);
+        },
         async decideToolApproval({ agentId, sessionId, approvalId, abortSignal, ...decision }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals/${approvalId}`, {
                 json: decision,
@@ -53,7 +57,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/types.d.ts

@@ -1,6 +1,6 @@
 import type { UIMessage, UIMessageChunk } from "ai";
 import type { ApiErrorCode } from "./contracts/api.ts";
-import type { Agent, AgentsResponse, AgentVersion, AgentVersionsResponse, CreateAgentBody, UpdateAgentBody } from "./contracts/entities/agents.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";
@@ -9,12 +9,13 @@ import type { CreateMemoryBody, MemoriesListResponse, MemoryResponse, UpdateMemo
 import type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBindingsResponse, MerchantConnectionResponse, MerchantUsageEventResponse, MerchantUsageEventStatus, MerchantUsageEventsResponse, MerchantUsageSummaryResponse, UpdateMerchantConnectionBody, UpsertMerchantBindingBody } from "./contracts/entities/merchant.ts";
 import type { CreatePromptBody, PromptResponse, PromptsResponse, UpdatePromptBody } from "./contracts/entities/prompts.ts";
 import type { CreateProviderBody, DeleteProviderOptions, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ThinkingLevelsResponse, UpdateProviderBody } from "./contracts/entities/providers.ts";
-import type { DecideToolApprovalBody, LatestSessionsListResponse, SessionMessagesResponse, SessionsListResponse, ToolApprovalDecisionResponse, ToolApprovalsResponse } from "./contracts/entities/sessions.ts";
+import type { DecideToolApprovalBody, LatestSessionsListResponse, SessionMessagesResponse, SessionResponse, SessionsListResponse, ToolApprovalDecisionResponse, ToolApprovalsResponse } from "./contracts/entities/sessions.ts";
 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 { 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>;
@@ -69,6 +70,7 @@ export interface UserClient {
     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">;
@@ -101,17 +103,17 @@ interface CorrelatedRequestInput {
 interface NewSessionInput {
     sessionId?: never;
     trigger?: "submit-message";
-    version?: number;
 }
 interface ExistingSessionInput {
     sessionId: string;
     trigger?: ChatTrigger;
-    version?: never;
 }
 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;
@@ -120,6 +122,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;
@@ -128,6 +132,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;
     /**
@@ -147,9 +160,7 @@ export interface TerminalStreamResult {
     /** Claims the SSE bytes once, without constructing a Response. Shares ownership with toResponse(). */
     toStream: () => ReadableStream<Uint8Array>;
 }
-interface StatelessGenerationInput extends AttributionInput, CorrelatedRequestInput {
-    version?: number;
-}
+type StatelessGenerationInput = AttributionInput & CorrelatedRequestInput;
 export interface CompletionPromptInput extends StatelessGenerationInput {
     abortSignal?: AbortSignal;
     agentId: string;
@@ -216,25 +227,13 @@ export interface AgentsResource {
     get(input: {
         agentId: string;
     } & ResourceRequestOptions): Promise<Agent>;
-    getVersion(input: {
-        agentId: string;
-        version: number;
-    } & ResourceRequestOptions): Promise<AgentVersion>;
     list(input?: AgentsListOptions): Promise<AgentsResponse>;
     listMcpAttachments(input: {
         agentId: string;
     } & ResourceRequestOptions): Promise<McpAttachmentsResponse>;
-    listVersions(input: {
-        agentId: string;
-    } & AgentVersionsListOptions): Promise<AgentVersionsResponse>;
     removeAvatar(input: {
         agentId: string;
     } & ResourceRequestOptions): Promise<Agent>;
-    /** Copies an immutable Version into the Agent, creating a new latest Version. */
-    restoreVersion(input: {
-        agentId: string;
-        version: number;
-    } & ResourceRequestOptions): Promise<Agent>;
     /** A concrete `workspaceId` switches the Agent; detachment is unsupported. */
     update(input: UpdateAgentBody & {
         agentId: string;
@@ -275,10 +274,6 @@ export interface WorkspacesListOptions extends ResourceRequestOptions {
     limit?: number;
     userId?: string;
 }
-export interface AgentVersionsListOptions extends ResourceRequestOptions {
-    cursor?: string;
-    limit?: number;
-}
 export interface ArtifactsListOptions extends ResourceRequestOptions {
     agentId?: string;
     cursor?: string;
@@ -409,6 +404,10 @@ export interface SessionsResource {
         sessionId: string;
         deleteArtifacts: boolean;
     } & ResourceRequestOptions): Promise<void>;
+    get(input: {
+        agentId: string;
+        sessionId: string;
+    } & ResourceRequestOptions): Promise<SessionResponse>;
     joinToolApprovalContinuation(input: {
         agentId: string;
         sessionId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazingagents/sdk",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "TypeScript SDK for the Blazing Agents API",
   "homepage": "https://docs.blazingagents.com",
   "bugs": {