@blazingagents/sdk 0.20.0 → 0.21.0

package/dist/contracts/entities/session-inputs.js

@@ -19,7 +19,9 @@ export const sessionInputSchema = z
     .object({
     requestId: sessionInputRequestIdSchema,
     sequence: z.number().int().positive(),
-    message: sessionMessageSchema.extend({ role: z.literal("user") }),
+    message: sessionMessageSchema
+        .omit({ branchable: true })
+        .extend({ role: z.literal("user") }),
     state: sessionInputStateSchema,
     turnId: turnIdSchema,
     createdAt: z.iso.datetime({ offset: true }),

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>>;
@@ -342,6 +352,7 @@ export declare const continueToolApprovalsBodySchema: z.ZodObject<{
     }, 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>;

package/dist/contracts/entities/sessions.js

@@ -22,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
@@ -49,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({

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

@@ -16,12 +16,13 @@ export { createPromptBodySchema, parsePromptVariables, promptResponseSchema, pro
 export { createProviderBodySchema, providerListItemSchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.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, ToolApprovalContinuationState, ToolApprovalDecision, ToolApprovalsResponse, } from "./entities/sessions.ts";
-export { continueToolApprovalsBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.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

@@ -14,10 +14,10 @@ export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merc
 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 { chatSteerConsumedEventSchema, sessionActivitySchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputSchema, sessionInputStateSchema, sessionInputsQuerySchema, sessionInputsResponseSchema, stopSessionBodySchema, stopSessionResponseSchema, submitSessionInputBodySchema, } from "./entities/session-inputs.js";
-export { continueToolApprovalsBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.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,11 +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);
+    /**
+     * 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>>>;
+    /**
+     * 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>;
 }

package/dist/direct-chat-transport.js

@@ -5,6 +5,10 @@ import { sessionIdSchema } from "./contracts/ids.js";
 export class BlazingAgentsDirectChatTransport extends DefaultChatTransport {
     #options;
     #sessionId;
+    /**
+     * Creates a chat transport and validates any supplied Session ID.
+     * @param options - Configuration for this operation.
+     */
     constructor(options) {
         super();
         this.#options = options;
@@ -13,6 +17,11 @@ export class BlazingAgentsDirectChatTransport extends DefaultChatTransport {
                 ? undefined
                 : sessionIdSchema.parse(options.sessionId);
     }
+    /**
+     * 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.
+     */
     async sendUserMessages(input) {
         const client = await this.#options.getClient();
         const result = await client.chat({
@@ -25,6 +34,11 @@ export class BlazingAgentsDirectChatTransport extends DefaultChatTransport {
         });
         return this.#processChatResult(result);
     }
+    /**
+     * 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.
+     */
     async sendMessages(input) {
         if (input.trigger === "regenerate-message" && !this.#sessionId) {
             throw new Error("Regeneration requires an existing Session.");
@@ -80,6 +94,9 @@ export class BlazingAgentsDirectChatTransport extends DefaultChatTransport {
         }
         return this.#processChatResult(result);
     }
+    /**
+     * Claims the chat stream and records the first Session ID before decoding chunks.
+     */
     async #processChatResult(result) {
         const stream = result.toStream();
         try {
@@ -95,9 +112,18 @@ export class BlazingAgentsDirectChatTransport extends DefaultChatTransport {
         }
         return this.processResponseStream(stream);
     }
+    /**
+     * Returns null because reconnecting to an existing stream is unsupported.
+     * @param _input - Unused reconnect request.
+     * @returns A promise resolving to null.
+     */
     reconnectToStream(_input) {
         return Promise.resolve(null);
     }
+    /**
+     * Submits the last assistant approval round for the existing Session.
+     * @param input - Operation input and optional cancellation signal.
+     */
     async #sendApprovalContinuation(input, last) {
         if (this.#sessionId === undefined) {
             throw new Error("Tool approval requires an existing Session.");

package/dist/errors.d.ts

@@ -17,6 +17,10 @@ export declare class BlazingAgentsError extends Error {
      * biome-ignore lint/correctness/noUnusedPrivateClassMembers: marker pattern
      */
     private readonly [BLAZING_AGENTS_ERROR_SYMBOL];
+    /**
+     * Creates an SDK error with its code, diagnostics, and optional cause.
+     * @param options - Configuration for this operation.
+     */
     constructor({ code, details, headers, message, param, requestId, responseBody, responseBodyTruncated, status, }: {
         code: BlazingAgentsErrorCode;
         details?: Record<string, unknown>;
@@ -28,6 +32,11 @@ export declare class BlazingAgentsError extends Error {
         responseBodyTruncated?: boolean;
         status?: number;
     }, options?: ErrorOptions);
+    /**
+     * Checks the shared symbol marker, including errors from duplicated SDK packages.
+     * @param error - Value to inspect or handle.
+     * @returns Whether the value carries the SDK error marker.
+     */
     static isInstance(error: unknown): error is BlazingAgentsError;
 }
 export {};

package/dist/errors.js

@@ -27,6 +27,10 @@ export class BlazingAgentsError extends Error {
      */
     [BLAZING_AGENTS_ERROR_SYMBOL] = true;
     // Stryker restore BooleanLiteral
+    /**
+     * Creates an SDK error with its code, diagnostics, and optional cause.
+     * @param options - Configuration for this operation.
+     */
     constructor({ code, details, headers, message, param, requestId, responseBody, responseBodyTruncated, status, }, options) {
         super(`[${code}] ${message}`, options);
         this.name = BLAZING_AGENTS_ERROR_NAME;
@@ -39,6 +43,11 @@ export class BlazingAgentsError extends Error {
         this.responseBodyTruncated = responseBodyTruncated;
         this.status = status;
     }
+    /**
+     * Checks the shared symbol marker, including errors from duplicated SDK packages.
+     * @param error - Value to inspect or handle.
+     * @returns Whether the value carries the SDK error marker.
+     */
     static isInstance(error) {
         if (error === null || typeof error !== "object") {
             return false;