@blazingagents/sdk 0.16.0 → 0.18.0

package/dist/relay.js

@@ -57,7 +57,6 @@ export function createChatRelay(options) {
                 ? {
                     ...chatInput,
                     trigger: "submit-message",
-                    version: context.version,
                 }
                 : {
                     ...chatInput,
@@ -122,7 +121,6 @@ export function createCompletionRelay(options) {
                 prompt: body.prompt,
                 abortSignal: request.signal,
                 userId: context.userId,
-                version: context.version,
             });
             return result.toResponse();
         }

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,15 +1,62 @@
-import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
-import { stripFunctionEvents } from "../functions.js";
+import { resumeSessionInputsResponseSchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputsResponseSchema, stopSessionResponseSchema, } from "../contracts/entities/session-inputs.js";
+import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
+import { agentIdSchema, sessionIdSchema, turnIdSchema, } from "../contracts/ids.js";
+import { dispatchChatFunctions, stripFunctionEvents, toChatFunctionDefinitions, } 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 joinInputTurn({ agentId, sessionId, turnId, functions, abortSignal, }) {
+            const response = await requestStream(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/input-turns/${turnIdSchema.parse(turnId)}`, { signal: abortSignal });
+            return buildTerminalStreamResult(response, "input Turn", (body) => functions
+                ? dispatchChatFunctions(config, { agentId, sessionId, functions, abortSignal }, body)
+                : stripFunctionEvents(body));
+        },
+        async runInputs({ agentId, sessionId, functions, abortSignal }) {
+            const response = await requestStream(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/run`, {
+                method: "POST",
+                json: functions === undefined
+                    ? {}
+                    : { functions: toChatFunctionDefinitions(functions) },
+                signal: abortSignal,
+            });
+            return buildTerminalStreamResult(response, "input Turn", (body) => functions
+                ? dispatchChatFunctions(config, { agentId, sessionId, functions, abortSignal }, body)
+                : stripFunctionEvents(body));
+        },
+        async submitInput({ agentId, sessionId, abortSignal, ...body }) {
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs`, { method: "POST", json: body, signal: abortSignal }, sessionInputResponseSchema);
+        },
+        async inputs({ agentId, sessionId, abortSignal, ...query }) {
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs`, { query, signal: abortSignal }, sessionInputsResponseSchema);
+        },
+        async promoteInput({ agentId, sessionId, requestId, abortSignal }) {
+            const inputId = sessionInputRequestIdSchema.parse(requestId);
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/${encodeURIComponent(inputId)}/promote`, { method: "POST", signal: abortSignal }, sessionInputResponseSchema);
+        },
+        async deleteInput({ agentId, sessionId, requestId, abortSignal }) {
+            const inputId = sessionInputRequestIdSchema.parse(requestId);
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/${encodeURIComponent(inputId)}`, { method: "DELETE", signal: abortSignal }, sessionInputResponseSchema);
+        },
+        async stop({ agentId, sessionId, turnId, abortSignal }) {
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/stop`, {
+                method: "POST",
+                json: { turnId: turnIdSchema.parse(turnId) },
+                signal: abortSignal,
+            }, stopSessionResponseSchema);
+        },
+        async resumeInputs({ agentId, sessionId, abortSignal }) {
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/resume`, { method: "POST", signal: abortSignal }, resumeSessionInputsResponseSchema);
+        },
+        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,

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,7 +9,8 @@ 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 { ResumeSessionInputsResponse, SessionInputResponse, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody } from "./contracts/entities/session-inputs.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";
@@ -103,12 +104,10 @@ 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 {
@@ -162,9 +161,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;
@@ -231,25 +228,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;
@@ -290,10 +275,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;
@@ -424,6 +405,27 @@ export interface SessionsResource {
         sessionId: string;
         deleteArtifacts: boolean;
     } & ResourceRequestOptions): Promise<void>;
+    deleteInput(input: {
+        agentId: string;
+        sessionId: string;
+        requestId: string;
+    } & ResourceRequestOptions): Promise<SessionInputResponse>;
+    get(input: {
+        agentId: string;
+        sessionId: string;
+    } & ResourceRequestOptions): Promise<SessionResponse>;
+    /** Poll from the first page for state changes; cursor only paginates receipts. */
+    inputs(input: {
+        agentId: string;
+        sessionId: string;
+    } & SessionInputsQuery & ResourceRequestOptions): Promise<SessionInputsResponse>;
+    /** Replays an admitted input Turn. Supplying functions opts into executor claims. */
+    joinInputTurn(input: {
+        agentId: string;
+        sessionId: string;
+        turnId: string;
+        functions?: ChatFunctions;
+    } & ResourceRequestOptions): Promise<TerminalStreamResult>;
     joinToolApprovalContinuation(input: {
         agentId: string;
         sessionId: string;
@@ -442,6 +444,33 @@ export interface SessionsResource {
         agentId: string;
         sessionId: string;
     } & SessionMessagesOptions): Promise<SessionMessagesResponse>;
+    promoteInput(input: {
+        agentId: string;
+        sessionId: string;
+        requestId: string;
+    } & ResourceRequestOptions): Promise<SessionInputResponse>;
+    /** Resume accepted inputs after a pause. Uncertain inputs are never replayed. */
+    resumeInputs(input: {
+        agentId: string;
+        sessionId: string;
+    } & ResourceRequestOptions): Promise<ResumeSessionInputsResponse>;
+    /** Admits the pending batch without resubmitting its messages. */
+    runInputs(input: {
+        agentId: string;
+        sessionId: string;
+        functions?: ChatFunctions;
+    } & ResourceRequestOptions): Promise<TerminalStreamResult>;
+    /** Wait for settlement of the named Turn. A queued Turn may already be running. */
+    stop(input: {
+        agentId: string;
+        sessionId: string;
+    } & StopSessionBody & ResourceRequestOptions): Promise<StopSessionResponse>;
+    /** Retry an uncertain acknowledgement with the same requestId and payload. */
+    submitInput(input: Omit<SubmitSessionInputBody, "message"> & {
+        agentId: string;
+        sessionId: string;
+        message: UIMessage;
+    } & ResourceRequestOptions): Promise<SessionInputResponse>;
     toolApprovals(input: {
         agentId: string;
         sessionId: string;

package/package.json

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