@blazingagents/sdk 0.15.0 → 0.16.0

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/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/types.d.ts

@@ -15,6 +15,7 @@ import type { CreateTaskBody, CreateTaskResponse, CreateTaskRunBody, CreateTaskR
 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">;
@@ -112,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;
@@ -120,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;
@@ -128,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;
     /**

package/package.json

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