@blazingagents/sdk 0.27.0 → 0.28.1

package/dist/contracts/api.d.ts

@@ -65,6 +65,7 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
     session_busy: "session_busy";
     session_fork_deleted: "session_fork_deleted";
     session_fork_unavailable: "session_fork_unavailable";
+    session_turn_unresponsive: "session_turn_unresponsive";
     session_version_mismatch: "session_version_mismatch";
     skill_invalid_archive: "skill_invalid_archive";
     skill_invalid_markdown: "skill_invalid_markdown";

package/dist/contracts/api.js

@@ -57,6 +57,7 @@ export const apiErrorCodeSchema = z.enum([
     "workspace_in_use",
     "workspace_busy",
     "session_busy",
+    "session_turn_unresponsive",
     "session_version_mismatch",
     "tool_approval_continuation_settled",
     "tool_approval_decision_conflict",

package/dist/contracts/entities/agent-tools.d.ts

@@ -1,105 +1,149 @@
 import { z } from "zod";
 /**
- * Agent tools are toggled one by one. A category only groups tools for
- * display; it never enables anything on its own.
+ * Agent tools are toggled one by one. A tag describes a tool; it never enables
+ * anything on its own.
+ *
+ * Every tool has exactly one group tag, which display code groups tools by.
  */
-export declare const AGENT_TOOL_CATEGORIES: readonly [{
-    readonly id: "files";
+export declare const AGENT_TOOL_GROUPS: readonly [{
+    readonly tag: "files";
     readonly name: "File operations";
     readonly description: "Read, write, edit, search, and run shell commands in the attached Workspace.";
 }, {
-    readonly id: "planning";
+    readonly tag: "planning";
     readonly name: "Task planning";
     readonly description: "Create and manage a structured todo list to plan and track multi-step work.";
 }, {
-    readonly id: "memory";
+    readonly tag: "memory";
     readonly name: "Memory";
     readonly description: "Save, recall, search, update, and delete durable notes owned by this Agent.";
 }, {
-    readonly id: "web";
+    readonly tag: "web";
     readonly name: "Web";
     readonly description: "Search the public web for current information.";
 }];
-export type AgentToolCategoryId = (typeof AGENT_TOOL_CATEGORIES)[number]["id"];
+export type AgentToolGroupTag = (typeof AGENT_TOOL_GROUPS)[number]["tag"];
+/**
+ * What a file operation tool may do to the Workspace. `file_read` tools never
+ * change Workspace files, so an Agent limited to them is read-only.
+ * `execute` runs arbitrary commands, which can change files and more.
+ */
+export declare const AGENT_TOOL_FILE_ACCESS_TAGS: readonly ["file_read", "file_write", "execute"];
+export type AgentToolFileAccessTag = (typeof AGENT_TOOL_FILE_ACCESS_TAGS)[number];
+export declare const AGENT_TOOL_TAGS: readonly [...("files" | "memory" | "planning" | "web")[], "file_read", "file_write", "execute"];
+export type AgentToolTag = AgentToolGroupTag | AgentToolFileAccessTag;
+/** The group tag comes first. Only a file operation tool adds a file access tag, and at most one. */
+export type AgentToolTags = readonly [
+    AgentToolGroupTag,
+    ...AgentToolFileAccessTag[]
+];
+/** @deprecated Use `AgentToolGroupTag`. */
+export type AgentToolCategoryId = AgentToolGroupTag;
+/** @deprecated Use `AGENT_TOOL_GROUPS`, keyed by `tag`. */
+export declare const AGENT_TOOL_CATEGORIES: readonly {
+    description: string;
+    id: AgentToolGroupTag;
+    name: string;
+}[];
 export interface AgentToolDefinition {
-    category: AgentToolCategoryId;
+    /** @deprecated Use the group tag in `tags`. */
+    category: AgentToolGroupTag;
     description: string;
     name: string;
     /** The tool runs in the Agent's attached Workspace. */
     requiresWorkspace: boolean;
+    tags: AgentToolTags;
 }
-export declare const AGENT_TOOLS: readonly [{
+declare const CATALOG: readonly [{
     readonly name: "read";
+    readonly tags: readonly ["files", "file_read"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Read a file from the Workspace.";
 }, {
     readonly name: "write";
+    readonly tags: readonly ["files", "file_write"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Create or overwrite a file in the Workspace.";
 }, {
     readonly name: "edit";
+    readonly tags: readonly ["files", "file_write"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Replace exact text in a Workspace file.";
 }, {
     readonly name: "grep";
+    readonly tags: readonly ["files", "file_read"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Search Workspace file contents with a regular expression.";
 }, {
     readonly name: "glob";
+    readonly tags: readonly ["files", "file_read"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Find Workspace files by path pattern.";
 }, {
     readonly name: "bash";
+    readonly tags: readonly ["files", "execute"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Run shell commands in the Workspace.";
 }, {
     readonly name: "publish_artifacts";
+    readonly tags: readonly ["files"];
     readonly category: "files";
     readonly requiresWorkspace: true;
     readonly description: "Publish Workspace files as downloadable Artifacts.";
 }, {
     readonly name: "write_todos";
+    readonly tags: readonly ["planning"];
     readonly category: "planning";
     readonly requiresWorkspace: false;
     readonly description: "Plan and track multi-step work with a todo list.";
 }, {
     readonly name: "save_memory";
+    readonly tags: readonly ["memory"];
     readonly category: "memory";
     readonly requiresWorkspace: false;
     readonly description: "Save a durable note.";
 }, {
     readonly name: "get_memory";
+    readonly tags: readonly ["memory"];
     readonly category: "memory";
     readonly requiresWorkspace: false;
     readonly description: "Read one saved note.";
 }, {
     readonly name: "search_memories";
+    readonly tags: readonly ["memory"];
     readonly category: "memory";
     readonly requiresWorkspace: false;
     readonly description: "Search saved notes.";
 }, {
     readonly name: "update_memory";
+    readonly tags: readonly ["memory"];
     readonly category: "memory";
     readonly requiresWorkspace: false;
     readonly description: "Update a saved note.";
 }, {
     readonly name: "delete_memory";
+    readonly tags: readonly ["memory"];
     readonly category: "memory";
     readonly requiresWorkspace: false;
     readonly description: "Delete a saved note.";
 }, {
     readonly name: "web_search";
+    readonly tags: readonly ["web"];
     readonly category: "web";
     readonly requiresWorkspace: false;
     readonly description: "Search the public web for current results. Each search consumes Usage credit.";
 }];
-export type AgentToolName = (typeof AGENT_TOOLS)[number]["name"];
+export type AgentToolName = (typeof CATALOG)[number]["name"];
+/** Declared rather than inferred, so `tool.tags.includes(tag)` accepts any tag. */
+export declare const AGENT_TOOLS: readonly (AgentToolDefinition & {
+    name: AgentToolName;
+})[];
 export declare const agentToolNames: readonly AgentToolName[];
 /** Built-in tool names an approval policy can reference. */
 export declare const builtinToolNames: readonly [...("bash" | "delete_memory" | "edit" | "get_memory" | "glob" | "grep" | "publish_artifacts" | "read" | "save_memory" | "search_memories" | "update_memory" | "web_search" | "write" | "write_todos")[], "activate_skill"];
@@ -108,3 +152,4 @@ export declare const builtinToolNames: readonly [...("bash" | "delete_memory" |
  * for MCP tools are reserved so a caller function never shadows them.
  */
 export declare const chatFunctionNameSchema: z.ZodString;
+export {};

package/dist/contracts/entities/agent-tools.js

@@ -1,116 +1,150 @@
 import { z } from "zod";
 /**
- * Agent tools are toggled one by one. A category only groups tools for
- * display; it never enables anything on its own.
+ * Agent tools are toggled one by one. A tag describes a tool; it never enables
+ * anything on its own.
+ *
+ * Every tool has exactly one group tag, which display code groups tools by.
  */
-export const AGENT_TOOL_CATEGORIES = [
+export const AGENT_TOOL_GROUPS = [
     {
-        id: "files",
+        tag: "files",
         name: "File operations",
         description: "Read, write, edit, search, and run shell commands in the attached Workspace.",
     },
     {
-        id: "planning",
+        tag: "planning",
         name: "Task planning",
         description: "Create and manage a structured todo list to plan and track multi-step work.",
     },
     {
-        id: "memory",
+        tag: "memory",
         name: "Memory",
         description: "Save, recall, search, update, and delete durable notes owned by this Agent.",
     },
     {
-        id: "web",
+        tag: "web",
         name: "Web",
         description: "Search the public web for current information.",
     },
 ];
-export const AGENT_TOOLS = [
+/**
+ * What a file operation tool may do to the Workspace. `file_read` tools never
+ * change Workspace files, so an Agent limited to them is read-only.
+ * `execute` runs arbitrary commands, which can change files and more.
+ */
+export const AGENT_TOOL_FILE_ACCESS_TAGS = [
+    "file_read",
+    "file_write",
+    "execute",
+];
+export const AGENT_TOOL_TAGS = [
+    ...AGENT_TOOL_GROUPS.map((group) => group.tag),
+    ...AGENT_TOOL_FILE_ACCESS_TAGS,
+];
+/** @deprecated Use `AGENT_TOOL_GROUPS`, keyed by `tag`. */
+export const AGENT_TOOL_CATEGORIES = AGENT_TOOL_GROUPS.map(({ tag, ...group }) => ({ id: tag, ...group }));
+const CATALOG = [
     {
         name: "read",
+        tags: ["files", "file_read"],
         category: "files",
         requiresWorkspace: true,
         description: "Read a file from the Workspace.",
     },
     {
         name: "write",
+        tags: ["files", "file_write"],
         category: "files",
         requiresWorkspace: true,
         description: "Create or overwrite a file in the Workspace.",
     },
     {
         name: "edit",
+        tags: ["files", "file_write"],
         category: "files",
         requiresWorkspace: true,
         description: "Replace exact text in a Workspace file.",
     },
     {
         name: "grep",
+        tags: ["files", "file_read"],
         category: "files",
         requiresWorkspace: true,
         description: "Search Workspace file contents with a regular expression.",
     },
     {
         name: "glob",
+        tags: ["files", "file_read"],
         category: "files",
         requiresWorkspace: true,
         description: "Find Workspace files by path pattern.",
     },
     {
         name: "bash",
+        tags: ["files", "execute"],
         category: "files",
         requiresWorkspace: true,
         description: "Run shell commands in the Workspace.",
     },
     {
         name: "publish_artifacts",
+        tags: ["files"],
         category: "files",
         requiresWorkspace: true,
         description: "Publish Workspace files as downloadable Artifacts.",
     },
     {
         name: "write_todos",
+        tags: ["planning"],
         category: "planning",
         requiresWorkspace: false,
         description: "Plan and track multi-step work with a todo list.",
     },
     {
         name: "save_memory",
+        tags: ["memory"],
         category: "memory",
         requiresWorkspace: false,
         description: "Save a durable note.",
     },
     {
         name: "get_memory",
+        tags: ["memory"],
         category: "memory",
         requiresWorkspace: false,
         description: "Read one saved note.",
     },
     {
         name: "search_memories",
+        tags: ["memory"],
         category: "memory",
         requiresWorkspace: false,
         description: "Search saved notes.",
     },
     {
         name: "update_memory",
+        tags: ["memory"],
         category: "memory",
         requiresWorkspace: false,
         description: "Update a saved note.",
     },
     {
         name: "delete_memory",
+        tags: ["memory"],
         category: "memory",
         requiresWorkspace: false,
         description: "Delete a saved note.",
     },
     {
         name: "web_search",
+        tags: ["web"],
         category: "web",
         requiresWorkspace: false,
         description: "Search the public web for current results. Each search consumes Usage credit.",
     },
 ];
+/** Declared rather than inferred, so `tool.tags.includes(tag)` accepts any tag. */
+export const AGENT_TOOLS = CATALOG;
 export const agentToolNames = AGENT_TOOLS.map((tool) => tool.name);
 /** Built-in tool names an approval policy can reference. */
 export const builtinToolNames = [...agentToolNames, "activate_skill"];

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

@@ -361,6 +361,20 @@ export declare const continueToolApprovalsBodySchema: z.ZodObject<{
         inputSchema: z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
+/**
+ * Transient event that precedes the `error` chunk when a Turn stream is cut
+ * after it started. The `error` chunk has no field for a code, so the code
+ * rides here. `turn_interrupted` is never an HTTP error code. The Turn may
+ * have saved its work before the cut, so read the Session's messages.
+ */
+export declare const turnInterruptedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-turn-interrupted">;
+    data: z.ZodObject<{
+        code: z.ZodLiteral<"turn_interrupted">;
+    }, z.core.$strict>;
+    transient: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type TurnInterruptedEvent = z.infer<typeof turnInterruptedEventSchema>;
 export type SessionForkedFrom = z.infer<typeof sessionForkedFromSchema>;
 export type SessionResponse = z.infer<typeof sessionResponseSchema>;
 export type SessionsListResponse = z.infer<typeof sessionsListResponseSchema>;

package/dist/contracts/entities/sessions.js

@@ -134,3 +134,16 @@ export const continueToolApprovalsBodySchema = z
     functions: chatFunctionDefinitionsSchema.optional(),
 })
     .strict();
+/**
+ * Transient event that precedes the `error` chunk when a Turn stream is cut
+ * after it started. The `error` chunk has no field for a code, so the code
+ * rides here. `turn_interrupted` is never an HTTP error code. The Turn may
+ * have saved its work before the cut, so read the Session's messages.
+ */
+export const turnInterruptedEventSchema = z
+    .object({
+    type: z.literal("data-turn-interrupted"),
+    data: z.object({ code: z.literal("turn_interrupted") }).strict(),
+    transient: z.literal(true),
+})
+    .strict();

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

@@ -1,50 +1,7 @@
 import { z } from "zod";
-/**
- * `GET /v1/usage` groupBy — `day|agent|model|session|user`. `session` is
- * top-N by tokens; the others are exhaustive and bounded. `user` is the
- * end-user attribution dimension (ADR-0001) — one bucket per `userId`, with
- * `''` emitted verbatim as the tenant-level bucket.
- */
-export declare const usageGroupBySchema: z.ZodDefault<z.ZodEnum<{
-    agent: "agent";
-    day: "day";
-    model: "model";
-    session: "session";
-    user: "user";
-}>>;
-/**
- * A `sessionId` filter value — either a real platform session id (`ss_…`)
- * or the `''` sentinel for stateless `completion`/`object` turns. The daily
- * table stores `''` for stateless turns; the bucket wire shape maps `''`
- * back to `null` on read (see `usageBucketSchema.sessionId`).
- */
-export declare const usageSessionFilterSchema: z.ZodString;
-/**
- * `?from=&to=&agentId=&sessionId=&userId=&groupBy=&limit=` — `from`/`to` are
- * date strings (`YYYY-MM-DD`) since the daily table is keyed by `day date`.
- * Range capped at 31 days; default is the last 30 days ending today (UTC).
- * The `sessionId` filter accepts `''` to drill into stateless turns only.
- * The `userId` filter accepts any opaque string (including `''` for
- * tenant-level usage only) — see ADR-0001 for the three filter modes.
- */
-export declare const usageQuerySchema: z.ZodObject<{
-    from: z.ZodOptional<z.ZodISODate>;
-    to: z.ZodOptional<z.ZodISODate>;
-    agentId: z.ZodOptional<z.ZodString>;
-    sessionId: z.ZodOptional<z.ZodString>;
-    userId: z.ZodOptional<z.ZodString>;
-    groupBy: z.ZodDefault<z.ZodEnum<{
-        agent: "agent";
-        day: "day";
-        model: "model";
-        session: "session";
-        user: "user";
-    }>>;
-    limit: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
 /**
  * Query for the bounded dashboard-oriented usage overview. The date range has
- * the same semantics as `usageQuerySchema`; `limit` bounds each ranking.
+ * the same semantics as `UsageQuery`; `limit` bounds each ranking.
  */
 export declare const usageOverviewQuerySchema: z.ZodObject<{
     from: z.ZodOptional<z.ZodISODate>;
@@ -236,7 +193,26 @@ export declare function usageOverviewResponseSchemaForQuery(query?: Partial<Usag
     }, z.core.$strip>>;
     activeAgentCount: z.ZodNumber;
 }, z.core.$strip>;
-export type UsageQuery = z.infer<typeof usageQuerySchema>;
+/**
+ * `?from=&to=&agentId=&sessionId=&userId=&groupBy=&limit=` for `GET /v1/usage`.
+ * `from`/`to` are `YYYY-MM-DD` dates, both present or both absent and at most
+ * 31 days apart; the default is the last 30 days ending today (UTC). `groupBy`
+ * defaults to `day`; `session` is top-N by tokens, bounded by `limit` (default
+ * 50, at most 200), and `user` is the end-user attribution dimension
+ * (ADR-0001) with `''` emitted verbatim as the tenant-level bucket. The
+ * `sessionId` filter accepts `''` to drill into stateless `completion`/`object`
+ * turns; `userId` accepts any opaque string, including `''` for tenant-level
+ * usage only. The server enforces these rules; the SDK passes the query through.
+ */
+export interface UsageQuery {
+    agentId?: string;
+    from?: string;
+    groupBy?: "day" | "agent" | "model" | "session" | "user";
+    limit?: number;
+    sessionId?: string;
+    to?: string;
+    userId?: string;
+}
 export type UsageBucket = z.infer<typeof usageBucketSchema>;
 export type UsageTotals = z.infer<typeof usageTotalsSchema>;
 export type UsageResponse = z.infer<typeof usageResponseSchema>;

package/dist/contracts/entities/usage.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 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 { DEFAULT_USAGE_OVERVIEW_TOP_N, DEFAULT_USAGE_RANGE_DAYS, MAX_USAGE_OVERVIEW_TOP_N, MAX_USAGE_RANGE_DAYS, } from "../limitations.js";
 import { hasUniqueValues } from "../utils.js";
 import { userIdSchema } from "./attribution.js";
 /**
@@ -34,54 +34,9 @@ function validateUsageRange(value, ctx) {
         }
     }
 }
-/**
- * `GET /v1/usage` groupBy — `day|agent|model|session|user`. `session` is
- * top-N by tokens; the others are exhaustive and bounded. `user` is the
- * end-user attribution dimension (ADR-0001) — one bucket per `userId`, with
- * `''` emitted verbatim as the tenant-level bucket.
- */
-export const usageGroupBySchema = z
-    .enum(["day", "agent", "model", "session", "user"])
-    .default("day");
-/**
- * A `sessionId` filter value — either a real platform session id (`ss_…`)
- * or the `''` sentinel for stateless `completion`/`object` turns. The daily
- * table stores `''` for stateless turns; the bucket wire shape maps `''`
- * back to `null` on read (see `usageBucketSchema.sessionId`).
- */
-export const usageSessionFilterSchema = z
-    .string()
-    .refine((v) => v === "" || z.validate(sessionIdSchema, v), {
-    message: "Must be a session id or '' for stateless turns.",
-});
-/**
- * `?from=&to=&agentId=&sessionId=&userId=&groupBy=&limit=` — `from`/`to` are
- * date strings (`YYYY-MM-DD`) since the daily table is keyed by `day date`.
- * Range capped at 31 days; default is the last 30 days ending today (UTC).
- * The `sessionId` filter accepts `''` to drill into stateless turns only.
- * The `userId` filter accepts any opaque string (including `''` for
- * tenant-level usage only) — see ADR-0001 for the three filter modes.
- */
-export const usageQuerySchema = z
-    .object({
-    from: z.iso.date().optional(),
-    to: z.iso.date().optional(),
-    agentId: agentIdSchema.optional(),
-    sessionId: usageSessionFilterSchema.optional(),
-    userId: userIdSchema.optional(),
-    groupBy: usageGroupBySchema,
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(MAX_USAGE_SESSION_TOP_N)
-        .default(DEFAULT_USAGE_SESSION_TOP_N),
-})
-    .strict()
-    .superRefine(validateUsageRange);
 /**
  * Query for the bounded dashboard-oriented usage overview. The date range has
- * the same semantics as `usageQuerySchema`; `limit` bounds each ranking.
+ * the same semantics as `UsageQuery`; `limit` bounds each ranking.
  */
 export const usageOverviewQuerySchema = z
     .object({

package/dist/contracts/index.d.ts

@@ -2,8 +2,8 @@
 export { receivedApiErrorResponseSchema } from "./api.ts";
 export type { ApprovalDecision, ApprovalPolicy, ToolExecutionReference, ToolReference, } from "./entities/agent-approval.ts";
 export { approvalDecisionSchema, approvalPolicySchema, toolExecutionReferenceSchema, toolReferenceSchema, } from "./entities/agent-approval.ts";
-export type { AgentToolCategoryId, AgentToolDefinition, AgentToolName, } from "./entities/agent-tools.ts";
-export { AGENT_TOOL_CATEGORIES, AGENT_TOOLS, agentToolNames, chatFunctionNameSchema, } from "./entities/agent-tools.ts";
+export type { AgentToolCategoryId, AgentToolDefinition, AgentToolFileAccessTag, AgentToolGroupTag, AgentToolName, AgentToolTag, AgentToolTags, } from "./entities/agent-tools.ts";
+export { AGENT_TOOL_CATEGORIES, AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, agentToolNames, chatFunctionNameSchema, } from "./entities/agent-tools.ts";
 export { agentConfigSchema, agentResponseSchema, agentStatusSchema, agentsListQuerySchema, agentsResponseSchema, createAgentBodySchema, updateAgentBodySchema, } from "./entities/agents.ts";
 export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "./entities/artifacts.ts";
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.ts";
@@ -17,8 +17,8 @@ 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, 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 type { ContinueToolApprovalsBody, SessionForkedFrom, ToolApprovalContinuationState, ToolApprovalDecision, ToolApprovalsResponse, TurnInterruptedEvent, } from "./entities/sessions.ts";
+export { continueToolApprovalsBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionForkedFromSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, turnInterruptedEventSchema, } from "./entities/sessions.ts";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.ts";
 export type { SpendingLimit, SpendingLimitResponse, SpendingLimitStopDetails, SpendingLimitStopEvent, UpdateSpendingLimitBody, } from "./entities/spending-limits.ts";
 export { nextSpendingLimitReset, spendingLimitPeriodSchema, spendingLimitResetIntervalSchema, spendingLimitResponseSchema, spendingLimitSchema, spendingLimitStopDetailsSchema, spendingLimitStopEventSchema, updateSpendingLimitBodySchema, } from "./entities/spending-limits.ts";

package/dist/contracts/index.js

@@ -2,7 +2,7 @@
 // biome-ignore lint/performance/noBarrelFile: public contract entry point
 export { receivedApiErrorResponseSchema } from "./api.js";
 export { approvalDecisionSchema, approvalPolicySchema, toolExecutionReferenceSchema, toolReferenceSchema, } from "./entities/agent-approval.js";
-export { AGENT_TOOL_CATEGORIES, AGENT_TOOLS, agentToolNames, chatFunctionNameSchema, } from "./entities/agent-tools.js";
+export { AGENT_TOOL_CATEGORIES, AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, agentToolNames, chatFunctionNameSchema, } from "./entities/agent-tools.js";
 export { agentConfigSchema, agentResponseSchema, agentStatusSchema, agentsListQuerySchema, agentsResponseSchema, createAgentBodySchema, updateAgentBodySchema, } from "./entities/agents.js";
 export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "./entities/artifacts.js";
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.js";
@@ -14,7 +14,7 @@ export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merc
 export { createPromptBodySchema, parsePromptVariables, promptResponseSchema, 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, sessionForkedFromSchema, 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, turnInterruptedEventSchema, } from "./entities/sessions.js";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.js";
 export { nextSpendingLimitReset, spendingLimitPeriodSchema, spendingLimitResetIntervalSchema, spendingLimitResponseSchema, spendingLimitSchema, spendingLimitStopDetailsSchema, spendingLimitStopEventSchema, updateSpendingLimitBodySchema, } from "./entities/spending-limits.js";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskCronConfigSchema, taskIntervalConfigSchema, taskListItemSchema, taskOnceConfigSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleInputSchema, taskScheduleKindSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.js";

package/dist/contracts/limitations.d.ts

@@ -45,13 +45,8 @@ export declare const MAX_AGENT_INSTRUCTIONS_LENGTH = 3000;
 export declare const MAX_ARTIFACT_BYTES: number;
 /** Memories — 10 KiB of text per memory. */
 export declare const MAX_MEMORY_TEXT_BYTES: number;
-/**
- * Usage — range cap 31 days, default 30 days; top-N sessions default 50, max 200.
- */
 export declare const MAX_USAGE_RANGE_DAYS = 31;
 export declare const DEFAULT_USAGE_RANGE_DAYS = 30;
-export declare const DEFAULT_USAGE_SESSION_TOP_N = 50;
-export declare const MAX_USAGE_SESSION_TOP_N = 200;
 export declare const DEFAULT_USAGE_OVERVIEW_TOP_N = 5;
 export declare const MAX_USAGE_OVERVIEW_TOP_N = 20;
 export declare const MIN_QUOTA_RESET_DAY = 1;

package/dist/contracts/limitations.js

@@ -45,13 +45,9 @@ export const MAX_AGENT_INSTRUCTIONS_LENGTH = 3000;
 export const MAX_ARTIFACT_BYTES = 10 * 1024 * 1024;
 /** Memories — 10 KiB of text per memory. */
 export const MAX_MEMORY_TEXT_BYTES = 10 * 1024;
-/**
- * Usage — range cap 31 days, default 30 days; top-N sessions default 50, max 200.
- */
+// Usage — range cap 31 days, default 30 days; overview rankings default 5, max 20.
 export const MAX_USAGE_RANGE_DAYS = 31;
 export const DEFAULT_USAGE_RANGE_DAYS = 30;
-export const DEFAULT_USAGE_SESSION_TOP_N = 50;
-export const MAX_USAGE_SESSION_TOP_N = 200;
 export const DEFAULT_USAGE_OVERVIEW_TOP_N = 5;
 export const MAX_USAGE_OVERVIEW_TOP_N = 20;
 // Quota — reset day between 1 and 28.

package/dist/http.d.ts

@@ -46,4 +46,4 @@ export declare function requestAbortedError(cause: unknown): BlazingAgentsError;
  * @param headers - Response headers to preserve or inspect.
  * @returns The server error, or invalid_response when the envelope is malformed.
  */
-export declare function parseErrorEnvelope(bodyText: string, status: number, headers?: Headers): BlazingAgentsError;
+export declare function parseErrorEnvelope(bodyText: string, status: number, headers: Headers): BlazingAgentsError;

package/dist/http.js

@@ -305,7 +305,7 @@ function decodeChunks(chunks, byteLength, truncated) {
  * @param headers - Response headers to preserve or inspect.
  * @returns The server error, or invalid_response when the envelope is malformed.
  */
-export function parseErrorEnvelope(bodyText, status, headers = new Headers()) {
+export function parseErrorEnvelope(bodyText, status, headers) {
     let parsed;
     if (bodyText.length === 0) {
         parsed = null;

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export type { UIMessage } from "ai";
 export { BlazingAgentsChatTransport, type BlazingAgentsChatTransportOptions, } from "./chat-transport.ts";
 export { BlazingAgents } from "./client.ts";
 export type { ApprovalDecision, ApprovalPolicy, ToolExecutionReference, ToolReference, } from "./contracts/entities/agent-approval.ts";
-export { AGENT_TOOL_CATEGORIES, AGENT_TOOLS, type AgentToolCategoryId, type AgentToolDefinition, type AgentToolName, } from "./contracts/entities/agent-tools.ts";
+export { AGENT_TOOL_CATEGORIES, AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, type AgentToolCategoryId, type AgentToolDefinition, type AgentToolFileAccessTag, type AgentToolGroupTag, type AgentToolName, type AgentToolTag, type AgentToolTags, } from "./contracts/entities/agent-tools.ts";
 export type { Agent, AgentConfig, AgentResponse, AgentsListQuery, AgentsResponse, CreateAgentBody, UpdateAgentBody, } from "./contracts/entities/agents.ts";
 export { agentConfigSchema } from "./contracts/entities/agents.ts";
 export type { ArtifactDownloadUrlResponse, ArtifactListItem, ArtifactsListResponse, } from "./contracts/entities/artifacts.ts";
@@ -17,7 +17,7 @@ export type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBin
 export type { CreatePromptBody, PromptResponse, PromptsListQuery, PromptsResponse, UpdatePromptBody, } from "./contracts/entities/prompts.ts";
 export type { CreateProviderBody, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ProviderType, ThinkingLevelsResponse, UpdateProviderBody, } from "./contracts/entities/providers.ts";
 export type { ChatSteerConsumedEvent, SessionActivity, SessionInput, SessionInputResponse, SessionInputState, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody, } from "./contracts/entities/session-inputs.ts";
-export type { ContinueToolApprovalsBody, SessionForkedFrom, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, } from "./contracts/entities/sessions.ts";
+export type { ContinueToolApprovalsBody, SessionForkedFrom, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, TurnInterruptedEvent, } from "./contracts/entities/sessions.ts";
 export { sessionResponseSchema } from "./contracts/entities/sessions.ts";
 export type { CreateSkillBody, Skill, SkillArchiveType, SkillCopyResult, SkillCopyResults, SkillDetail, SkillFile, SkillsListResponse, } from "./contracts/entities/skills.ts";
 export type { SpendingLimit, SpendingLimitResponse, SpendingLimitStopDetails, SpendingLimitStopEvent, UpdateSpendingLimitBody, } from "./contracts/entities/spending-limits.ts";

package/dist/index.js

@@ -6,7 +6,7 @@
 // biome-ignore lint/performance/noBarrelFile: package entry point
 export { BlazingAgentsChatTransport, } from "./chat-transport.js";
 export { BlazingAgents } from "./client.js";
-export { AGENT_TOOL_CATEGORIES, AGENT_TOOLS, } from "./contracts/entities/agent-tools.js";
+export { AGENT_TOOL_CATEGORIES, AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, } from "./contracts/entities/agent-tools.js";
 export { agentConfigSchema } from "./contracts/entities/agents.js";
 export { sessionResponseSchema } from "./contracts/entities/sessions.js";
 export { nextSpendingLimitReset } from "./contracts/entities/spending-limits.js";

package/dist/resources/usage.d.ts

@@ -1,8 +1,8 @@
 import type { HttpConfig, UsageResource } from "../types.ts";
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
- * `/v1/agents/:agentId/usage` (per-agent). The query shape is the core
- * `usageQuerySchema`; the SDK passes it through as query params.
+ * `/v1/agents/:agentId/usage` (per-agent). The query shape is `UsageQuery`;
+ * the SDK passes it through as query params.
  * @param config - Shared authentication and transport configuration.
  * @returns The configured resource client.
  */

package/dist/resources/usage.js

@@ -2,8 +2,8 @@ import { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewRespo
 import { requestJson } from "../http.js";
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
- * `/v1/agents/:agentId/usage` (per-agent). The query shape is the core
- * `usageQuerySchema`; the SDK passes it through as query params.
+ * `/v1/agents/:agentId/usage` (per-agent). The query shape is `UsageQuery`;
+ * the SDK passes it through as query params.
  * @param config - Shared authentication and transport configuration.
  * @returns The configured resource client.
  */

package/dist/types.d.ts

@@ -10,7 +10,7 @@ import type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBin
 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 { ChatSteerConsumedEvent, SessionInputResponse, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody } from "./contracts/entities/session-inputs.ts";
-import type { LatestSessionsListResponse, SessionMessagesResponse, SessionResponse, SessionsListResponse, ToolApprovalDecision, ToolApprovalsResponse } from "./contracts/entities/sessions.ts";
+import type { LatestSessionsListResponse, SessionMessagesResponse, SessionResponse, SessionsListResponse, ToolApprovalDecision, ToolApprovalsResponse, TurnInterruptedEvent } from "./contracts/entities/sessions.ts";
 import type { CreateSkillBody, SkillArchiveType, SkillCopyResults, SkillDetail, SkillsListResponse } from "./contracts/entities/skills.ts";
 import type { SpendingLimitResponse, SpendingLimitStopEvent, UpdateSpendingLimitBody } from "./contracts/entities/spending-limits.ts";
 import type { CreateTaskBody, CreateTaskResponse, CreateTaskRunBody, CreateTaskRunResponse, TaskResponse, TaskRunMessagesResponse, TaskRunResponse, TaskRunsListResponse, TasksListResponse, UpdateTaskBody } from "./contracts/entities/tasks.ts";
@@ -118,7 +118,7 @@ export interface ResponseObservation {
     status: number;
 }
 export type ChatTrigger = "submit-message" | "regenerate-message";
-export type BlazingAgentsUIMessageData = Record<"ba-steer-consumed", ChatSteerConsumedEvent["data"]> & Record<"model-spending-limit", SpendingLimitStopEvent["data"]>;
+export type BlazingAgentsUIMessageData = Record<"ba-steer-consumed", ChatSteerConsumedEvent["data"]> & Record<"model-spending-limit", SpendingLimitStopEvent["data"]> & Record<"turn-interrupted", TurnInterruptedEvent["data"]>;
 export type BlazingAgentsUIMessage = UIMessage<BlazingAgentsChatMessageMetadata, BlazingAgentsUIMessageData>;
 export type BlazingAgentsUIMessageChunk = UIMessageChunk<BlazingAgentsChatMessageMetadata, BlazingAgentsUIMessageData>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazingagents/sdk",
-  "version": "0.27.0",
+  "version": "0.28.1",
   "description": "TypeScript SDK for the Blazing Agents API",
   "homepage": "https://docs.blazingagents.com",
   "bugs": {
@@ -29,6 +29,7 @@
     "README.md"
   ],
   "scripts": {
+    "agent-tools:json": "node scripts/write-agent-tools-json.ts",
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "check": "npm run typecheck && npm run test && npm run lint && npm run unused",
     "fix": "ultracite fix",