@blazingagents/sdk 0.3.0 → 0.5.0

package/README.md

@@ -158,3 +158,14 @@ client.agent({ agentId }).skills.list({ abortSignal: signal });
 
 `ResourceRequestOptions` replaces `ResourceReadOptions`. Cancellation stops the
 request; it does not roll back a mutation already accepted by the server.
+
+## Interactive resend
+
+Successful interactive exchanges are saved together. Failed or canceled execution
+leaves saved history unchanged, including the previous answer during regeneration;
+executed usage and Tool effects remain. Retain submitted text/images until success
+and resend edited or unchanged input through ordinary chat with a fresh message ID.
+Stop requests cancellation; a lost response can hide a saved exchange. Reuse the
+returned Session ID and load history normally on return. No outcome polling or
+automatic generation retry is needed. See the [chatbot guide](https://docs.blazingagents.com/getting-started/chatbot)
+and [working examples](https://github.com/blazingagents/examples).

package/dist/contracts/entities/sessions.d.ts

@@ -29,6 +29,49 @@ export declare const sessionsListResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * `GET /v1/sessions/latest` list item — one per Agent: the Agent's most
+ * recently updated Session (optionally among one end user's Sessions).
+ * Carries `agentId` and the Agent's current model, Thinking level, and status,
+ * independently of the Session's pinned Version.
+ */
+export declare const latestSessionListItemSchema: z.ZodObject<{
+    agentVersion: z.ZodNullable<z.ZodNumber>;
+    id: z.ZodString;
+    messageCount: z.ZodNumber;
+    lastMessagePreview: z.ZodNullable<z.ZodString>;
+    userId: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    agentId: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    thinkingLevel: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        disabled: "disabled";
+    }>;
+}, z.core.$strip>;
+export declare const latestSessionsListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        agentVersion: z.ZodNullable<z.ZodNumber>;
+        id: z.ZodString;
+        messageCount: z.ZodNumber;
+        lastMessagePreview: z.ZodNullable<z.ZodString>;
+        userId: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        agentId: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        thinkingLevel: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            active: "active";
+            disabled: "disabled";
+        }>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
 /**
  * `GET /v1/agents/{agentId}/sessions/{sessionId}/messages` — transcript as
  * `UIMessage[]` verbatim, paginated backwards (newest page first) with an
@@ -146,6 +189,8 @@ export declare const toolApprovalDecisionResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SessionListItem = z.infer<typeof sessionListItemSchema>;
 export type SessionsListResponse = z.infer<typeof sessionsListResponseSchema>;
+export type LatestSessionListItem = z.infer<typeof latestSessionListItemSchema>;
+export type LatestSessionsListResponse = z.infer<typeof latestSessionsListResponseSchema>;
 export type SessionMessage = z.infer<typeof sessionMessageSchema>;
 export type SessionMessagesResponse = z.infer<typeof sessionMessagesResponseSchema>;
 export type SessionMessagesQuery = z.infer<typeof sessionMessagesQuerySchema>;

package/dist/contracts/entities/sessions.js

@@ -1,8 +1,8 @@
 import { z } from "zod";
 import { paginatedResponseSchema } from "../api.js";
-import { sessionIdSchema } from "../ids.js";
+import { agentIdSchema, sessionIdSchema } from "../ids.js";
 import { DEFAULT_SESSION_MESSAGES_LIMIT, MAX_SESSION_MESSAGES_LIMIT, } from "../limitations.js";
-import { agentVersionNumberSchema } from "./agents.js";
+import { agentSchema, agentVersionNumberSchema } from "./agents.js";
 import { metadataSchema, userIdSchema } from "./attribution.js";
 /**
  * `GET /v1/agents/{agentId}/sessions` list item — the public wire shape:
@@ -24,6 +24,21 @@ export const sessionListItemSchema = z
 })
     .strip();
 export const sessionsListResponseSchema = paginatedResponseSchema(sessionListItemSchema);
+/**
+ * `GET /v1/sessions/latest` list item — one per Agent: the Agent's most
+ * recently updated Session (optionally among one end user's Sessions).
+ * Carries `agentId` and the Agent's current model, Thinking level, and status,
+ * independently of the Session's pinned Version.
+ */
+export const latestSessionListItemSchema = sessionListItemSchema
+    .extend({
+    agentId: agentIdSchema,
+    model: agentSchema.shape.model,
+    thinkingLevel: agentSchema.shape.thinkingLevel,
+    status: agentSchema.shape.status,
+})
+    .strip();
+export const latestSessionsListResponseSchema = paginatedResponseSchema(latestSessionListItemSchema);
 /**
  * `GET /v1/agents/{agentId}/sessions/{sessionId}/messages` — transcript as
  * `UIMessage[]` verbatim, paginated backwards (newest page first) with an

package/dist/contracts/index.d.ts

@@ -10,7 +10,7 @@ export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchem
 export { createPromptBodySchema, promptResponseSchema, promptSchema, promptsResponseSchema, updatePromptBodySchema, } from "./entities/prompts.ts";
 export { createProviderBodySchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.ts";
 export type { ToolApprovalDecisionResponse, ToolApprovalsResponse, } from "./entities/sessions.ts";
-export { decideToolApprovalBodySchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.ts";
+export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.ts";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.ts";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskListItemSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.ts";
 export { quotaSchema, subscriptionStatusSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.ts";

package/dist/contracts/index.js

@@ -9,7 +9,7 @@ export { approveMcpOauthAuthorizationBodySchema, createMcpConnectionBodySchema,
 export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchema, memorySchema, updateMemoryBodySchema, } from "./entities/memories.js";
 export { createPromptBodySchema, promptResponseSchema, promptSchema, promptsResponseSchema, updatePromptBodySchema, } from "./entities/prompts.js";
 export { createProviderBodySchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.js";
-export { decideToolApprovalBodySchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.js";
+export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.js";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.js";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskListItemSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.js";
 export { quotaSchema, subscriptionStatusSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.js";

package/dist/index.d.ts

@@ -18,4 +18,4 @@ export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetw
 export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransportOptions, } from "./direct-chat-transport.ts";
 export { BlazingAgentsError } from "./errors.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, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, McpConnectionsResource, MemoriesListOptions, MemoriesResource, 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, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";

package/dist/resources/sessions.js

@@ -1,4 +1,4 @@
-import { sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
+import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
 import { buildTerminalStreamResult } from "../generation.js";
 import { requestJson, requestStream } from "../http.js";
 /**
@@ -27,6 +27,17 @@ export function createSessionsResource(config) {
                 },
             }, sessionsListResponseSchema);
         },
+        async listLatest(options = {}) {
+            return await requestJson(config, "/v1/sessions/latest", {
+                signal: options.abortSignal,
+                query: {
+                    cursor: options.cursor,
+                    limit: options.limit,
+                    // Stryker disable next-line ConditionalExpression: URL serialization omits an undefined query value.
+                    ...(options.userId === undefined ? {} : { userId: options.userId }),
+                },
+            }, latestSessionsListResponseSchema);
+        },
         async messages({ agentId, sessionId, ...options }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/messages`, {
                 signal: options.abortSignal,

package/dist/types.d.ts

@@ -7,7 +7,7 @@ import type { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResp
 import type { CreateMemoryBody, MemoriesListResponse, MemoryResponse, UpdateMemoryBody } from "./contracts/entities/memories.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, SessionMessagesResponse, SessionsListResponse, ToolApprovalDecisionResponse, ToolApprovalsResponse } from "./contracts/entities/sessions.ts";
+import type { DecideToolApprovalBody, LatestSessionsListResponse, SessionMessagesResponse, 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";
@@ -371,6 +371,11 @@ export interface SessionsListOptions extends ResourceRequestOptions {
     limit?: number;
     userId?: string;
 }
+export interface LatestSessionsListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
+    userId?: string;
+}
 export interface SessionMessagesOptions extends ResourceRequestOptions {
     after?: string;
     cursor?: string;
@@ -395,6 +400,12 @@ export interface SessionsResource {
     list(input: {
         agentId: string;
     } & SessionsListOptions): Promise<SessionsListResponse>;
+    /**
+     * `GET /v1/sessions/latest` — each Agent's most recently updated Session
+     * across the Tenant, one item per Agent, newest first. `userId` narrows
+     * the candidate Sessions to one end user's before picking the latest.
+     */
+    listLatest(input?: LatestSessionsListOptions): Promise<LatestSessionsListResponse>;
     messages(input: {
         agentId: string;
         sessionId: string;

package/package.json

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