@blazingagents/sdk 0.19.0 → 0.21.0

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

@@ -24,6 +24,10 @@ export declare const sessionsListResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+export declare const sessionForkedFromSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    messageId: z.ZodString;
+}, z.core.$strip>;
 export declare const sessionResponseSchema: z.ZodObject<{
     id: z.ZodString;
     messageCount: z.ZodNumber;
@@ -127,6 +131,10 @@ export declare const sessionResponseSchema: z.ZodObject<{
         metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         mcpConnectionIds: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
+    forkedFrom: z.ZodNullable<z.ZodObject<{
+        sessionId: z.ZodString;
+        messageId: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * `GET /v1/sessions/latest` list item — one per Agent: the Agent's most
@@ -181,6 +189,7 @@ export declare const sessionMessageSchema: z.ZodObject<{
         system: "system";
         user: "user";
     }>;
+    branchable: z.ZodBoolean;
     parts: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
     }, z.core.$loose>>;
@@ -203,6 +212,7 @@ export declare const sessionMessagesResponseSchema: z.ZodObject<{
             system: "system";
             user: "user";
         }>;
+        branchable: z.ZodBoolean;
         parts: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
         }, z.core.$loose>>;
@@ -216,14 +226,14 @@ export declare const sessionMessagesQuerySchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     after: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
-/** Decision-only input for one server-owned Tool approval. */
-export declare const decideToolApprovalBodySchema: z.ZodObject<{
+/** One decision in the current Tool approval round. */
+export declare const toolApprovalDecisionSchema: z.ZodObject<{
+    approvalId: z.ZodString;
     approved: z.ZodBoolean;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const toolApprovalContinuationStateSchema: z.ZodEnum<{
     failed: "failed";
-    queued: "queued";
     running: "running";
     succeeded: "succeeded";
     waiting: "waiting";
@@ -273,7 +283,6 @@ export declare const toolApprovalContinuationSchema: z.ZodObject<{
     id: z.ZodString;
     state: z.ZodEnum<{
         failed: "failed";
-        queued: "queued";
         running: "running";
         succeeded: "succeeded";
         waiting: "waiting";
@@ -325,24 +334,25 @@ export declare const toolApprovalsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         state: z.ZodEnum<{
             failed: "failed";
-            queued: "queued";
             running: "running";
             succeeded: "succeeded";
             waiting: "waiting";
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare const toolApprovalDecisionResponseSchema: z.ZodObject<{
-    continuationId: z.ZodString;
-    state: z.ZodEnum<{
-        failed: "failed";
-        queued: "queued";
-        running: "running";
-        succeeded: "succeeded";
-        waiting: "waiting";
-    }>;
-}, z.core.$strip>;
+export declare const continueToolApprovalsBodySchema: z.ZodObject<{
+    decisions: z.ZodArray<z.ZodObject<{
+        approvalId: z.ZodString;
+        approved: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        inputSchema: z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
 export type SessionListItem = z.infer<typeof sessionListItemSchema>;
+export type SessionForkedFrom = z.infer<typeof sessionForkedFromSchema>;
 export type SessionResponse = z.infer<typeof sessionResponseSchema>;
 export type SessionsListResponse = z.infer<typeof sessionsListResponseSchema>;
 export type LatestSessionListItem = z.infer<typeof latestSessionListItemSchema>;
@@ -350,8 +360,8 @@ export type LatestSessionsListResponse = z.infer<typeof latestSessionsListRespon
 export type SessionMessage = z.infer<typeof sessionMessageSchema>;
 export type SessionMessagesResponse = z.infer<typeof sessionMessagesResponseSchema>;
 export type SessionMessagesQuery = z.infer<typeof sessionMessagesQuerySchema>;
-export type DecideToolApprovalBody = z.infer<typeof decideToolApprovalBodySchema>;
+export type ToolApprovalDecision = z.infer<typeof toolApprovalDecisionSchema>;
+export type ContinueToolApprovalsBody = z.infer<typeof continueToolApprovalsBodySchema>;
 export type ToolApprovalContinuationState = z.infer<typeof toolApprovalContinuationStateSchema>;
 export type ToolApprovalState = z.infer<typeof toolApprovalStateSchema>;
 export type ToolApprovalsResponse = z.infer<typeof toolApprovalsResponseSchema>;
-export type ToolApprovalDecisionResponse = z.infer<typeof toolApprovalDecisionResponseSchema>;

package/dist/contracts/entities/sessions.js

@@ -5,6 +5,7 @@ import { DEFAULT_SESSION_MESSAGES_LIMIT, MAX_SESSION_MESSAGES_LIMIT, } from "../
 import { toolExecutionReferenceSchema } from "./agent-approval.js";
 import { agentConfigSchema, agentSchema } from "./agents.js";
 import { metadataSchema, userIdSchema } from "./attribution.js";
+import { chatFunctionDefinitionsSchema } from "./chat.js";
 /**
  * `GET /v1/agents/{agentId}/sessions` list item. `agentId`/`tenantId` never
  * leak to the wire; `userId`/`metadata` come from the first successful Turn.
@@ -21,8 +22,17 @@ export const sessionListItemSchema = z
 })
     .strip();
 export const sessionsListResponseSchema = paginatedResponseSchema(sessionListItemSchema);
+export const sessionForkedFromSchema = z
+    .object({
+    sessionId: sessionIdSchema,
+    messageId: z.string().min(1),
+})
+    .strip();
 export const sessionResponseSchema = sessionListItemSchema
-    .extend({ agentConfig: agentConfigSchema })
+    .extend({
+    agentConfig: agentConfigSchema,
+    forkedFrom: sessionForkedFromSchema.nullable(),
+})
     .strip();
 /**
  * `GET /v1/sessions/latest` list item — one per Agent: the Agent's most
@@ -48,6 +58,7 @@ export const sessionMessageSchema = z
     .object({
     id: z.string().min(1),
     role: z.enum(["system", "user", "assistant"]),
+    branchable: z.boolean(),
     parts: z
         .array(z
         .object({
@@ -90,16 +101,16 @@ export const sessionMessagesQuerySchema = z
     message: "cursor and after are mutually exclusive.",
     path: ["after"],
 });
-/** Decision-only input for one server-owned Tool approval. */
-export const decideToolApprovalBodySchema = z
+/** One decision in the current Tool approval round. */
+export const toolApprovalDecisionSchema = z
     .object({
+    approvalId: z.string().min(1),
     approved: z.boolean(),
     reason: z.string().trim().min(1).max(1000).optional(),
 })
     .strict();
 export const toolApprovalContinuationStateSchema = z.enum([
     "waiting",
-    "queued",
     "running",
     "succeeded",
     "failed",
@@ -130,9 +141,13 @@ export const toolApprovalsResponseSchema = z
     continuation: toolApprovalContinuationSchema.nullable(),
 })
     .strip();
-export const toolApprovalDecisionResponseSchema = z
+export const continueToolApprovalsBodySchema = z
     .object({
-    continuationId: z.string().min(1),
-    state: toolApprovalContinuationStateSchema,
+    decisions: z
+        .array(toolApprovalDecisionSchema)
+        .min(1)
+        .refine((decisions) => new Set(decisions.map((decision) => decision.approvalId)).size ===
+        decisions.length, { message: "Approval IDs must be distinct." }),
+    functions: chatFunctionDefinitionsSchema.optional(),
 })
-    .strip();
+    .strict();

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

@@ -151,6 +151,9 @@ export interface SkillMarkdownFrontmatterParseFailure {
     success: false;
 }
 export type SkillMarkdownFrontmatterParseResult = SkillMarkdownFrontmatterParseSuccess | SkillMarkdownFrontmatterParseFailure;
+/**
+ * Parses and validates YAML frontmatter from Skill Markdown.
+ */
 export declare function parseSkillMarkdownFrontmatter(content: string): SkillMarkdownFrontmatterParseResult;
 export type Skill = z.infer<typeof skillSchema>;
 export type SkillDetail = z.infer<typeof skillDetailSchema>;

package/dist/contracts/entities/skills.js

@@ -126,6 +126,9 @@ export const skillCopyResultSchema = z.discriminatedUnion("status", [
 ]);
 export const skillCopyResultsSchema = z.array(skillCopyResultSchema);
 const frontmatterPattern = /^---\n([\s\S]*?)\n---(?:\n|$)/;
+/**
+ * Parses and validates YAML frontmatter from Skill Markdown.
+ */
 export function parseSkillMarkdownFrontmatter(content) {
     const normalized = content.replaceAll("\r\n", "\n");
     const match = frontmatterPattern.exec(normalized);

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

@@ -716,6 +716,7 @@ export declare const taskRunMessagesResponseSchema: z.ZodObject<{
             system: "system";
             user: "user";
         }>;
+        branchable: z.ZodBoolean;
         parts: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
         }, z.core.$loose>>;

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

@@ -175,7 +175,10 @@ export declare const usageOverviewResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     activeAgentCount: z.ZodNumber;
 }, z.core.$strip>;
-/** Applies the request-dependent ranking and daily-series guarantees. */
+/**
+ * Applies the request-dependent ranking and daily-series guarantees.
+ * @param query - Ranking limit and date range used to validate the response.
+ */
 export declare function usageOverviewResponseSchemaForQuery(query?: Partial<UsageOverviewQuery>): z.ZodObject<{
     totals: z.ZodObject<{
         inputTokens: z.ZodNumber;

package/dist/contracts/entities/usage.js

@@ -3,6 +3,9 @@ import { agentIdSchema, sessionIdSchema } from "../ids.js";
 import { DEFAULT_USAGE_OVERVIEW_TOP_N, DEFAULT_USAGE_RANGE_DAYS, DEFAULT_USAGE_SESSION_TOP_N, MAX_USAGE_OVERVIEW_TOP_N, MAX_USAGE_RANGE_DAYS, MAX_USAGE_SESSION_TOP_N, } from "../limitations.js";
 import { hasUniqueValues } from "../utils.js";
 import { userIdSchema } from "./attribution.js";
+/**
+ * Adds a validation issue when the usage date range is invalid.
+ */
 function validateUsageRange(value, ctx) {
     if ((value.from === undefined) !== (value.to === undefined)) {
         ctx.addIssue({
@@ -185,7 +188,10 @@ export const usageOverviewResponseSchema = z
         });
     }
 });
-/** Applies the request-dependent ranking and daily-series guarantees. */
+/**
+ * Applies the request-dependent ranking and daily-series guarantees.
+ * @param query - Ranking limit and date range used to validate the response.
+ */
 export function usageOverviewResponseSchemaForQuery(query = {}) {
     const limit = query.limit ?? DEFAULT_USAGE_OVERVIEW_TOP_N;
     const expectedDays = query.from && query.to

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

@@ -1,10 +1,9 @@
 import { z } from "zod";
 export declare const workspaceNameSchema: z.ZodString;
-export declare const workspaceBackupSchema: z.ZodObject<{
-    dir: z.ZodLiteral<"/workspace">;
-    id: z.ZodUUID;
-    localBucket: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
+export declare const workspaceTierSchema: z.ZodEnum<{
+    core: "core";
+    plus: "plus";
+}>;
 export declare const workspaceNetworkPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     mode: z.ZodLiteral<"unrestricted">;
 }, z.core.$strict>, z.ZodObject<{
@@ -16,6 +15,10 @@ export declare const workspaceNetworkPolicySchema: z.ZodDiscriminatedUnion<[z.Zo
 export declare const workspaceSchema: z.ZodObject<{
     id: z.ZodString;
     tenantId: z.ZodString;
+    tier: z.ZodEnum<{
+        core: "core";
+        plus: "plus";
+    }>;
     name: z.ZodNullable<z.ZodString>;
     userId: z.ZodString;
     metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -32,6 +35,10 @@ export declare const workspaceSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const createWorkspaceBodySchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
+    tier: z.ZodDefault<z.ZodEnum<{
+        core: "core";
+        plus: "plus";
+    }>>;
     userId: z.ZodDefault<z.ZodString>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     networkPolicy: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -64,6 +71,10 @@ export declare const workspacesListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         tenantId: z.ZodString;
+        tier: z.ZodEnum<{
+            core: "core";
+            plus: "plus";
+        }>;
         name: z.ZodNullable<z.ZodString>;
         userId: z.ZodString;
         metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -81,7 +92,7 @@ export declare const workspacesListResponseSchema: z.ZodObject<{
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type Workspace = z.infer<typeof workspaceSchema>;
-export type WorkspaceBackup = z.infer<typeof workspaceBackupSchema>;
+export type WorkspaceTier = z.infer<typeof workspaceTierSchema>;
 export type WorkspaceNetworkPolicy = z.infer<typeof workspaceNetworkPolicySchema>;
 export type CreateWorkspaceBody = z.input<typeof createWorkspaceBodySchema>;
 export type UpdateWorkspaceBody = z.infer<typeof updateWorkspaceBodySchema>;

package/dist/contracts/entities/workspaces.js

@@ -9,13 +9,7 @@ export const workspaceNameSchema = z
     .trim()
     .min(1)
     .max(MAX_WORKSPACE_NAME_LENGTH);
-export const workspaceBackupSchema = z
-    .object({
-    dir: z.literal("/workspace"),
-    id: z.uuid(),
-    localBucket: z.boolean().optional(),
-})
-    .strict();
+export const workspaceTierSchema = z.enum(["core", "plus"]);
 export const workspaceNetworkPolicySchema = z.discriminatedUnion("mode", [
     z.object({ mode: z.literal("unrestricted") }).strict(),
     z
@@ -35,6 +29,7 @@ export const workspaceSchema = z
     .object({
     id: workspaceIdSchema,
     tenantId: tenantIdSchema,
+    tier: workspaceTierSchema,
     name: workspaceNameSchema.nullable(),
     userId: userIdSchema,
     metadata: metadataSchema,
@@ -46,6 +41,7 @@ export const workspaceSchema = z
 export const createWorkspaceBodySchema = z
     .object({
     name: workspaceNameSchema.optional(),
+    tier: workspaceTierSchema.default("core"),
     userId: userIdSchema.default(""),
     metadata: metadataSchema.default({}),
     networkPolicy: workspaceNetworkPolicySchema.default({

package/dist/contracts/ids.d.ts

@@ -1,20 +1,42 @@
 import { z } from "zod";
 export declare const ADMIN_AGENT_ID_PREFIX = "ag_adm";
+/** Creates a Tenant ID with a 16-character base62 body. */
 export declare const createTenantId: () => string;
+/**
+ * Creates an Agent ID outside the reserved administrator prefix.
+ */
 export declare const createAgentId: () => string;
+/**
+ * Creates an Agent ID with the reserved administrator prefix.
+ */
 export declare const mintAdminAgentId: () => string;
+/** Creates a Session ID with a 16-character base62 body. */
 export declare const createSessionId: () => string;
+/** Creates a Api Key ID with a 16-character base62 body. */
 export declare const createApiKeyId: () => string;
+/** Creates a Provider ID with a 16-character base62 body. */
 export declare const createProviderId: () => string;
+/** Creates a Mcp Connection ID with a 16-character base62 body. */
 export declare const createMcpConnectionId: () => string;
+/** Creates a Workspace ID with a 16-character base62 body. */
 export declare const createWorkspaceId: () => string;
+/** Creates a Artifact ID with a 16-character base62 body. */
 export declare const createArtifactId: () => string;
+/** Creates a Task ID with a 16-character base62 body. */
 export declare const createTaskId: () => string;
+/** Creates a Task Run ID with a 16-character base62 body. */
 export declare const createTaskRunId: () => string;
+/** Creates a Memory ID with a 16-character base62 body. */
 export declare const createMemoryId: () => string;
+/** Creates a Prompt ID with a 16-character base62 body. */
 export declare const createPromptId: () => string;
+/** Creates a Request ID with a 16-character base62 body. */
 export declare const createRequestId: () => string;
+/** Creates a Checkout Attempt ID with a 16-character base62 body. */
 export declare const createCheckoutAttemptId: () => string;
+/**
+ * Creates a Skill ID with a 16-character base62 body.
+ */
 export declare const createSkillId: () => string;
 /**
  * API keys — `ba_` + 40 base62 chars (~230 bits entropy). The full token is
@@ -22,14 +44,23 @@ export declare const createSkillId: () => string;
  * are stored. (docs/adr/0004-unified-v1-dual-credential-auth.md)
  */
 export declare const API_KEY_TOKEN_PREFIX = "ba_";
+/**
+ * Creates an API key token with a 40-character random base62 body.
+ * @returns A ba_ token with 40 random base62 characters.
+ */
 export declare function createApiKeyToken(): string;
 /**
  * The display fragment is `ba_` + the first 2 chars of the random body —
  * safe to store (~12 of ~230 bits revealed).
+ * @param token - API key token with the ba_ prefix.
+ * @returns The prefix and first two characters of the token body.
  */
 export declare function apiKeyFragmentFromToken(token: string): string;
 export declare const tenantIdSchema: z.ZodString;
 export declare const agentIdSchema: z.ZodString;
+/**
+ * Checks the administrator prefix and validates the complete Agent ID.
+ */
 export declare const isAdminAgentId: (id: string) => boolean;
 export declare const sessionIdSchema: z.ZodString;
 export declare const apiKeyIdSchema: z.ZodString;

package/dist/contracts/ids.js

@@ -12,22 +12,47 @@ const createNanoId13 = customAlphabet(BASE62, 13);
 const createAgentIdFirstChar = customAlphabet(BASE62.replace("a", ""), 1);
 const createNanoId15 = customAlphabet(BASE62, 15);
 const createNanoId40 = customAlphabet(BASE62, 40);
+/**
+ * Creates a generator for prefixed IDs with a 16-character base62 body.
+ */
 const platformId = (prefix) => () => `${prefix}_${createNanoId16()}`;
+/** Creates a Tenant ID with a 16-character base62 body. */
 export const createTenantId = platformId("ten");
+/**
+ * Creates an Agent ID outside the reserved administrator prefix.
+ */
 export const createAgentId = () => `ag_${createAgentIdFirstChar()}${createNanoId15()}`;
+/**
+ * Creates an Agent ID with the reserved administrator prefix.
+ */
 export const mintAdminAgentId = () => `${ADMIN_AGENT_ID_PREFIX}${createNanoId13()}`;
+/** Creates a Session ID with a 16-character base62 body. */
 export const createSessionId = platformId("ss");
+/** Creates a Api Key ID with a 16-character base62 body. */
 export const createApiKeyId = platformId("ak");
+/** Creates a Provider ID with a 16-character base62 body. */
 export const createProviderId = platformId("prv");
+/** Creates a Mcp Connection ID with a 16-character base62 body. */
 export const createMcpConnectionId = platformId("mcp");
+/** Creates a Workspace ID with a 16-character base62 body. */
 export const createWorkspaceId = platformId("ws");
+/** Creates a Artifact ID with a 16-character base62 body. */
 export const createArtifactId = platformId("at");
+/** Creates a Task ID with a 16-character base62 body. */
 export const createTaskId = platformId("tk");
+/** Creates a Task Run ID with a 16-character base62 body. */
 export const createTaskRunId = platformId("tr");
+/** Creates a Memory ID with a 16-character base62 body. */
 export const createMemoryId = platformId("mem");
+/** Creates a Prompt ID with a 16-character base62 body. */
 export const createPromptId = platformId("prompt");
+/** Creates a Request ID with a 16-character base62 body. */
 export const createRequestId = platformId("req");
+/** Creates a Checkout Attempt ID with a 16-character base62 body. */
 export const createCheckoutAttemptId = platformId("ca");
+/**
+ * Creates a Skill ID with a 16-character base62 body.
+ */
 export const createSkillId = () => `skill_${createNanoId16()}`;
 /**
  * API keys — `ba_` + 40 base62 chars (~230 bits entropy). The full token is
@@ -35,12 +60,18 @@ export const createSkillId = () => `skill_${createNanoId16()}`;
  * are stored. (docs/adr/0004-unified-v1-dual-credential-auth.md)
  */
 export const API_KEY_TOKEN_PREFIX = "ba_";
+/**
+ * Creates an API key token with a 40-character random base62 body.
+ * @returns A ba_ token with 40 random base62 characters.
+ */
 export function createApiKeyToken() {
     return `${API_KEY_TOKEN_PREFIX}${createNanoId40()}`;
 }
 /**
  * The display fragment is `ba_` + the first 2 chars of the random body —
  * safe to store (~12 of ~230 bits revealed).
+ * @param token - API key token with the ba_ prefix.
+ * @returns The prefix and first two characters of the token body.
  */
 export function apiKeyFragmentFromToken(token) {
     if (!token.startsWith(API_KEY_TOKEN_PREFIX)) {
@@ -52,6 +83,9 @@ export function apiKeyFragmentFromToken(token) {
 // Schemas — one per id prefix, mirroring the migration check constraints.
 export const tenantIdSchema = z.string().regex(/^ten_[0-9A-Za-z]{16}$/);
 export const agentIdSchema = z.string().regex(/^ag_[0-9A-Za-z]{16}$/);
+/**
+ * Checks the administrator prefix and validates the complete Agent ID.
+ */
 export const isAdminAgentId = (id) => id.startsWith(ADMIN_AGENT_ID_PREFIX) && z.validate(agentIdSchema, id);
 export const sessionIdSchema = z.string().regex(/^ss_[0-9A-Za-z]{16}$/);
 export const apiKeyIdSchema = z.string().regex(/^ak_[0-9A-Za-z]{16}$/);

package/dist/contracts/index.d.ts

@@ -7,21 +7,22 @@ export { agentConfigSchema, agentResponseSchema, agentSchema, agentStatusSchema,
 export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "./entities/artifacts.ts";
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.ts";
 export type { ChatFunctionCallEvent, ChatFunctionDefinition, ChatFunctionDefinitions, ChatFunctionOutcome, ClaimChatFunctionBody, PromptVariables, ResolveChatFunctionBody, UsageSummary, } from "./entities/chat.ts";
-export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, resumeToolApprovalContinuationBodySchema, usageSummarySchema, } from "./entities/chat.ts";
+export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, usageSummarySchema, } from "./entities/chat.ts";
 export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListStatusSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.ts";
 export { approveMcpOauthAuthorizationBodySchema, createMcpConnectionBodySchema, mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, mcpConnectionAuthTypeSchema, mcpConnectionOauthConnectResponseSchema, mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionStatusSchema, mcpConnectionsResponseSchema, mcpConnectionTestErrorCodeSchema, mcpConnectionTestResponseSchema, mcpOauthAuthorizationLaunchResponseSchema, reconnectMcpConnectionBodySchema, updateMcpAttachmentBodySchema, updateMcpConnectionBodySchema, } from "./entities/mcp-connections.ts";
 export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchema, memorySchema, updateMemoryBodySchema, } from "./entities/memories.ts";
 export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merchantBindingsResponseSchema, merchantConnectionResponseSchema, merchantConnectionSchema, merchantConnectionStatusSchema, merchantCustomerBindingSchema, merchantEnvironmentSchema, merchantGuardSchema, merchantProviderSchema, merchantUsageEventNextAction, merchantUsageEventNextActionSchema, merchantUsageEventSchema, merchantUsageEventStatusSchema, merchantUsageEventsResponseSchema, merchantUsageSummaryQuerySchema, merchantUsageSummaryResponseSchema, merchantUsageSummarySchema, merchantWorkflowIssueSchema, updateMerchantConnectionBodySchema, upsertMerchantBindingBodySchema, } from "./entities/merchant.ts";
 export { createPromptBodySchema, parsePromptVariables, promptResponseSchema, promptSchema, promptsListQuerySchema, promptsResponseSchema, promptTemplateSchema, renderPromptTemplate, updatePromptBodySchema, } from "./entities/prompts.ts";
 export { createProviderBodySchema, providerListItemSchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.ts";
-export type { ResumeSessionInputsResponse, RunSessionInputsBody, SessionActivity, SessionInput, SessionInputMode, SessionInputResponse, SessionInputState, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody, } from "./entities/session-inputs.ts";
-export { resumeSessionInputsResponseSchema, runSessionInputsBodySchema, sessionActivitySchema, sessionInputModeSchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputSchema, sessionInputStateSchema, sessionInputsQuerySchema, sessionInputsResponseSchema, stopSessionBodySchema, stopSessionResponseSchema, submitSessionInputBodySchema, } from "./entities/session-inputs.ts";
-export type { ToolApprovalDecisionResponse, ToolApprovalsResponse, } from "./entities/sessions.ts";
-export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.ts";
+export type { ChatSteerConsumedEvent, SessionActivity, SessionInput, SessionInputResponse, SessionInputState, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody, } from "./entities/session-inputs.ts";
+export { chatSteerConsumedEventSchema, sessionActivitySchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputSchema, sessionInputStateSchema, sessionInputsQuerySchema, sessionInputsResponseSchema, stopSessionBodySchema, stopSessionResponseSchema, submitSessionInputBodySchema, } from "./entities/session-inputs.ts";
+export type { ContinueToolApprovalsBody, SessionForkedFrom, ToolApprovalContinuationState, ToolApprovalDecision, ToolApprovalsResponse, } from "./entities/sessions.ts";
+export { continueToolApprovalsBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionForkedFromSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.ts";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.ts";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskCronConfigSchema, taskIntervalConfigSchema, taskListItemSchema, taskOnceConfigSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleInputSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.ts";
 export { quotaSchema, subscriptionStatusSchema, tenantDeletionSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.ts";
 export type { SessionUsageQuery, SessionUsageResponse, UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageResponse, UsageTotals, } from "./entities/usage.ts";
 export { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewQuerySchema, usageOverviewResponseSchema, usageResponseSchema, } from "./entities/usage.ts";
-export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, } from "./entities/workspaces.ts";
+export type { WorkspaceTier } from "./entities/workspaces.ts";
+export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, workspaceTierSchema, } from "./entities/workspaces.ts";
 export { agentIdSchema, apiKeyTokenSchema, functionCallIdSchema, isAdminAgentId, promptIdSchema, sessionIdSchema, } from "./ids.ts";

package/dist/contracts/index.js

@@ -6,18 +6,18 @@ export { chatFunctionNameSchema } from "./entities/agent-tools.js";
 export { agentConfigSchema, agentResponseSchema, agentSchema, agentStatusSchema, agentsListQuerySchema, agentsResponseSchema, createAgentBodySchema, updateAgentBodySchema, } from "./entities/agents.js";
 export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "./entities/artifacts.js";
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.js";
-export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, resumeToolApprovalContinuationBodySchema, usageSummarySchema, } from "./entities/chat.js";
+export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, usageSummarySchema, } from "./entities/chat.js";
 export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListStatusSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.js";
 export { approveMcpOauthAuthorizationBodySchema, createMcpConnectionBodySchema, mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, mcpConnectionAuthTypeSchema, mcpConnectionOauthConnectResponseSchema, mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionStatusSchema, mcpConnectionsResponseSchema, mcpConnectionTestErrorCodeSchema, mcpConnectionTestResponseSchema, mcpOauthAuthorizationLaunchResponseSchema, reconnectMcpConnectionBodySchema, updateMcpAttachmentBodySchema, updateMcpConnectionBodySchema, } from "./entities/mcp-connections.js";
 export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchema, memorySchema, updateMemoryBodySchema, } from "./entities/memories.js";
 export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merchantBindingsResponseSchema, merchantConnectionResponseSchema, merchantConnectionSchema, merchantConnectionStatusSchema, merchantCustomerBindingSchema, merchantEnvironmentSchema, merchantGuardSchema, merchantProviderSchema, merchantUsageEventNextAction, merchantUsageEventNextActionSchema, merchantUsageEventSchema, merchantUsageEventStatusSchema, merchantUsageEventsResponseSchema, merchantUsageSummaryQuerySchema, merchantUsageSummaryResponseSchema, merchantUsageSummarySchema, merchantWorkflowIssueSchema, updateMerchantConnectionBodySchema, upsertMerchantBindingBodySchema, } from "./entities/merchant.js";
 export { createPromptBodySchema, parsePromptVariables, promptResponseSchema, promptSchema, promptsListQuerySchema, promptsResponseSchema, promptTemplateSchema, renderPromptTemplate, updatePromptBodySchema, } from "./entities/prompts.js";
 export { createProviderBodySchema, providerListItemSchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.js";
-export { resumeSessionInputsResponseSchema, runSessionInputsBodySchema, sessionActivitySchema, sessionInputModeSchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputSchema, sessionInputStateSchema, sessionInputsQuerySchema, sessionInputsResponseSchema, stopSessionBodySchema, stopSessionResponseSchema, submitSessionInputBodySchema, } from "./entities/session-inputs.js";
-export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.js";
+export { chatSteerConsumedEventSchema, sessionActivitySchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputSchema, sessionInputStateSchema, sessionInputsQuerySchema, sessionInputsResponseSchema, stopSessionBodySchema, stopSessionResponseSchema, submitSessionInputBodySchema, } from "./entities/session-inputs.js";
+export { continueToolApprovalsBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionForkedFromSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.js";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.js";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskCronConfigSchema, taskIntervalConfigSchema, taskListItemSchema, taskOnceConfigSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleInputSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.js";
 export { quotaSchema, subscriptionStatusSchema, tenantDeletionSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.js";
 export { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewQuerySchema, usageOverviewResponseSchema, usageResponseSchema, } from "./entities/usage.js";
-export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, } from "./entities/workspaces.js";
+export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, workspaceTierSchema, } from "./entities/workspaces.js";
 export { agentIdSchema, apiKeyTokenSchema, functionCallIdSchema, isAdminAgentId, promptIdSchema, sessionIdSchema, } from "./ids.js";

package/dist/contracts/utils.d.ts

@@ -1,3 +1,13 @@
 export declare const atLeastOneFieldMessage = "At least one field must be provided.";
+/**
+ * Checks whether the object has at least one own enumerable key.
+ * @param value - Value to inspect.
+ * @returns Whether at least one own enumerable key exists.
+ */
 export declare function hasObjectKeys(value: object): boolean;
+/**
+ * Checks whether every string in the array is unique.
+ * @param values - Values to inspect or substitute.
+ * @returns Whether no string occurs more than once.
+ */
 export declare function hasUniqueValues(values: string[]): boolean;

package/dist/contracts/utils.js

@@ -1,7 +1,17 @@
 export const atLeastOneFieldMessage = "At least one field must be provided.";
+/**
+ * Checks whether the object has at least one own enumerable key.
+ * @param value - Value to inspect.
+ * @returns Whether at least one own enumerable key exists.
+ */
 export function hasObjectKeys(value) {
     return Object.keys(value).length > 0;
 }
+/**
+ * Checks whether every string in the array is unique.
+ * @param values - Values to inspect or substitute.
+ * @returns Whether no string occurs more than once.
+ */
 export function hasUniqueValues(values) {
     return new Set(values).size === values.length;
 }

package/dist/direct-chat-transport.d.ts

@@ -5,9 +5,16 @@ export type BlazingAgentsDirectChatTransportOptions = {
     agentId: string;
     /** Caller-local functions for every Turn and approved continuation of this chat. */
     functions?: ChatFunctions;
+    /**
+     * Returns the authenticated SDK client for the current request.
+     * @returns The SDK client for this request.
+     */
     getClient: () => BlazingAgents | Promise<BlazingAgents>;
     metadata?: Record<string, unknown>;
-    /** Receives the Session ID before the response stream is consumed. */
+    /**
+     * Receives the Session ID before the response stream is consumed.
+     * @param sessionId - Session to look up or record.
+     */
     onSessionId?: (sessionId: string) => Promise<void> | void;
     sessionId?: string;
     userId?: string;
@@ -21,10 +28,30 @@ export type BlazingAgentsDirectChatTransportOptions = {
 /** Connects useChat directly to the SDK, including native streaming fetch clients. */
 export declare class BlazingAgentsDirectChatTransport<UI_MESSAGE extends UIMessage = UIMessage> extends DefaultChatTransport<UI_MESSAGE> {
     #private;
+    /**
+     * Creates a chat transport and validates any supplied Session ID.
+     * @param options - Configuration for this operation.
+     */
     constructor(options: BlazingAgentsDirectChatTransportOptions);
-    runInputs(input?: {
+    /**
+     * Submits the supplied user messages directly to the SDK chat endpoint.
+     * @param input - Operation input and optional cancellation signal.
+     * @returns The decoded AI SDK message-chunk stream.
+     */
+    sendUserMessages(input: {
+        messages: UI_MESSAGE[];
         abortSignal?: AbortSignal;
     }): Promise<ReadableStream<import("ai").UIMessageChunk<unknown, import("ai").UIDataTypes>>>;
+    /**
+     * Submits the latest user message or complete assistant approval round to the chat.
+     * @param input - Operation input and optional cancellation signal.
+     * @returns The decoded AI SDK message-chunk stream.
+     */
     sendMessages(input: Parameters<ChatTransport<UI_MESSAGE>["sendMessages"]>[0]): Promise<ReadableStream<import("ai").UIMessageChunk<unknown, import("ai").UIDataTypes>>>;
-    reconnectToStream(_input: Parameters<ChatTransport<UI_MESSAGE>["reconnectToStream"]>[0]): Promise<ReadableStream<import("ai").UIMessageChunk<unknown, import("ai").UIDataTypes>> | null>;
+    /**
+     * Returns null because reconnecting to an existing stream is unsupported.
+     * @param _input - Unused reconnect request.
+     * @returns A promise resolving to null.
+     */
+    reconnectToStream(_input: Parameters<ChatTransport<UI_MESSAGE>["reconnectToStream"]>[0]): Promise<null>;
 }