@blazingagents/sdk 0.26.0 → 0.28.0

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-approval.d.ts

@@ -20,6 +20,7 @@ export declare const toolReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         save_memory: "save_memory";
         search_memories: "search_memories";
         update_memory: "update_memory";
+        web_search: "web_search";
         write: "write";
         write_todos: "write_todos";
     }>;
@@ -48,6 +49,7 @@ export declare const toolExecutionReferenceSchema: z.ZodDiscriminatedUnion<[z.Zo
         save_memory: "save_memory";
         search_memories: "search_memories";
         update_memory: "update_memory";
+        web_search: "web_search";
         write: "write";
         write_todos: "write_todos";
     }>;
@@ -82,6 +84,7 @@ export declare const approvalPolicySchema: z.ZodObject<{
                 save_memory: "save_memory";
                 search_memories: "search_memories";
                 update_memory: "update_memory";
+                web_search: "web_search";
                 write: "write";
                 write_todos: "write_todos";
             }>;

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { mcpConnectionIdSchema } from "../ids.js";
-import { AGENT_TOOL_CATALOG, chatFunctionNameSchema } from "./agent-tools.js";
+import { builtinToolNames, chatFunctionNameSchema } from "./agent-tools.js";
 export const approvalDecisionSchema = z.enum([
     "full",
     "deny",
@@ -11,10 +11,7 @@ export const toolReferenceSchema = z.discriminatedUnion("type", [
     z
         .object({
         type: z.literal("builtin"),
-        name: z.enum([
-            ...AGENT_TOOL_CATALOG.flatMap((group) => group.tools),
-            "activate_skill",
-        ]),
+        name: z.enum(builtinToolNames),
     })
         .strict(),
     z

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

@@ -1,29 +1,145 @@
 import { z } from "zod";
-/** Tool groups an Agent can attach. File operations use its Workspace. */
-export declare const agentToolGroupIds: readonly ["workspace", "write_todos", "memory"];
-export type AgentToolGroupId = (typeof agentToolGroupIds)[number];
-export interface AgentToolGroup {
-    description: string;
-    id: AgentToolGroupId;
-    name: string;
-    tools: readonly string[];
-}
-export declare const AGENT_TOOL_CATALOG: readonly [{
-    readonly id: "workspace";
+/**
+ * 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_GROUPS: readonly [{
+    readonly tag: "files";
     readonly name: "File operations";
     readonly description: "Read, write, edit, search, and run shell commands in the attached Workspace.";
-    readonly tools: readonly ["read", "write", "edit", "grep", "glob", "bash", "publish_artifacts"];
 }, {
-    readonly id: "write_todos";
+    readonly tag: "planning";
     readonly name: "Task planning";
     readonly description: "Create and manage a structured todo list to plan and track multi-step work.";
-    readonly tools: readonly ["write_todos"];
 }, {
-    readonly id: "memory";
+    readonly tag: "memory";
     readonly name: "Memory";
     readonly description: "Save, recall, search, update, and delete durable notes owned by this Agent.";
-    readonly tools: readonly ["save_memory", "get_memory", "search_memories", "update_memory", "delete_memory"];
+}, {
+    readonly tag: "web";
+    readonly name: "Web";
+    readonly description: "Search the public web for current information.";
+}];
+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. */
+export type AgentToolTags = readonly ["files"] | readonly ["files", AgentToolFileAccessTag] | readonly [Exclude<AgentToolGroupTag, "files">];
+/** @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 {
+    /** @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 [{
+    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 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"];
 /**
  * A model-facing tool name. Built-in tool names and the `mcp__` prefix used
  * for MCP tools are reserved so a caller function never shadows them.

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

@@ -1,48 +1,152 @@
 import { z } from "zod";
-/** Tool groups an Agent can attach. File operations use its Workspace. */
-export const agentToolGroupIds = [
-    "workspace",
-    "write_todos",
-    "memory",
-];
-export const AGENT_TOOL_CATALOG = [
+/**
+ * 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_GROUPS = [
     {
-        id: "workspace",
+        tag: "files",
         name: "File operations",
         description: "Read, write, edit, search, and run shell commands in the attached Workspace.",
-        tools: [
-            "read",
-            "write",
-            "edit",
-            "grep",
-            "glob",
-            "bash",
-            "publish_artifacts",
-        ],
-    },
-    {
-        id: "write_todos",
+    },
+    {
+        tag: "planning",
         name: "Task planning",
         description: "Create and manage a structured todo list to plan and track multi-step work.",
-        tools: ["write_todos"],
     },
     {
-        id: "memory",
+        tag: "memory",
         name: "Memory",
         description: "Save, recall, search, update, and delete durable notes owned by this Agent.",
-        tools: [
-            "save_memory",
-            "get_memory",
-            "search_memories",
-            "update_memory",
-            "delete_memory",
-        ],
+    },
+    {
+        tag: "web",
+        name: "Web",
+        description: "Search the public web for current information.",
+    },
+];
+/**
+ * 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 }));
+export const AGENT_TOOLS = [
+    {
+        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.",
     },
 ];
-const RESERVED_CHAT_FUNCTION_NAMES = new Set([
-    ...AGENT_TOOL_CATALOG.flatMap((group) => group.tools),
-    "activate_skill",
-]);
+export const agentToolNames = AGENT_TOOLS.map((tool) => tool.name);
+/** Built-in tool names an approval policy can reference. */
+export const builtinToolNames = [...agentToolNames, "activate_skill"];
+const RESERVED_CHAT_FUNCTION_NAMES = new Set(builtinToolNames);
 /**
  * A model-facing tool name. Built-in tool names and the `mcp__` prefix used
  * for MCP tools are reserved so a caller function never shadows them.

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

@@ -3,8 +3,19 @@ export declare const agentInstructionsSchema: z.ZodString;
 /** Provider-native model id, passed through without interpretation. */
 export declare const agentModelIdSchema: z.ZodString;
 export declare const agentToolsSchema: z.ZodArray<z.ZodEnum<{
-    memory: "memory";
-    workspace: "workspace";
+    bash: "bash";
+    delete_memory: "delete_memory";
+    edit: "edit";
+    get_memory: "get_memory";
+    glob: "glob";
+    grep: "grep";
+    publish_artifacts: "publish_artifacts";
+    read: "read";
+    save_memory: "save_memory";
+    search_memories: "search_memories";
+    update_memory: "update_memory";
+    web_search: "web_search";
+    write: "write";
     write_todos: "write_todos";
 }>>;
 export declare const agentMcpConnectionIdsSchema: z.ZodArray<z.ZodString>;
@@ -36,6 +47,7 @@ export declare const agentResponseSchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -75,6 +87,7 @@ export declare const agentResponseSchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -102,8 +115,19 @@ export declare const agentResponseSchema: z.ZodObject<{
     compactionReserveTokens: z.ZodNumber;
     memoryInjectionEnabled: z.ZodBoolean;
     tools: z.ZodArray<z.ZodEnum<{
-        memory: "memory";
-        workspace: "workspace";
+        bash: "bash";
+        delete_memory: "delete_memory";
+        edit: "edit";
+        get_memory: "get_memory";
+        glob: "glob";
+        grep: "grep";
+        publish_artifacts: "publish_artifacts";
+        read: "read";
+        save_memory: "save_memory";
+        search_memories: "search_memories";
+        update_memory: "update_memory";
+        web_search: "web_search";
+        write: "write";
         write_todos: "write_todos";
     }>>;
     instructions: z.ZodString;
@@ -143,6 +167,7 @@ export declare const agentsResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -182,6 +207,7 @@ export declare const agentsResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -209,8 +235,19 @@ export declare const agentsResponseSchema: z.ZodObject<{
         compactionReserveTokens: z.ZodNumber;
         memoryInjectionEnabled: z.ZodBoolean;
         tools: z.ZodArray<z.ZodEnum<{
-            memory: "memory";
-            workspace: "workspace";
+            bash: "bash";
+            delete_memory: "delete_memory";
+            edit: "edit";
+            get_memory: "get_memory";
+            glob: "glob";
+            grep: "grep";
+            publish_artifacts: "publish_artifacts";
+            read: "read";
+            save_memory: "save_memory";
+            search_memories: "search_memories";
+            update_memory: "update_memory";
+            web_search: "web_search";
+            write: "write";
             write_todos: "write_todos";
         }>>;
         instructions: z.ZodString;
@@ -257,6 +294,7 @@ export declare const agentConfigSchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -296,6 +334,7 @@ export declare const agentConfigSchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -320,8 +359,19 @@ export declare const agentConfigSchema: z.ZodObject<{
     compactionReserveTokens: z.ZodNumber;
     memoryInjectionEnabled: z.ZodBoolean;
     tools: z.ZodArray<z.ZodEnum<{
-        memory: "memory";
-        workspace: "workspace";
+        bash: "bash";
+        delete_memory: "delete_memory";
+        edit: "edit";
+        get_memory: "get_memory";
+        glob: "glob";
+        grep: "grep";
+        publish_artifacts: "publish_artifacts";
+        read: "read";
+        save_memory: "save_memory";
+        search_memories: "search_memories";
+        update_memory: "update_memory";
+        web_search: "web_search";
+        write: "write";
         write_todos: "write_todos";
     }>>;
     instructions: z.ZodString;
@@ -352,6 +402,7 @@ export declare const createAgentBodySchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -391,6 +442,7 @@ export declare const createAgentBodySchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -420,8 +472,19 @@ export declare const createAgentBodySchema: z.ZodObject<{
     compactionReserveTokens: z.ZodDefault<z.ZodNumber>;
     memoryInjectionEnabled: z.ZodDefault<z.ZodBoolean>;
     tools: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        memory: "memory";
-        workspace: "workspace";
+        bash: "bash";
+        delete_memory: "delete_memory";
+        edit: "edit";
+        get_memory: "get_memory";
+        glob: "glob";
+        grep: "grep";
+        publish_artifacts: "publish_artifacts";
+        read: "read";
+        save_memory: "save_memory";
+        search_memories: "search_memories";
+        update_memory: "update_memory";
+        web_search: "web_search";
+        write: "write";
         write_todos: "write_todos";
     }>>>;
     instructions: z.ZodDefault<z.ZodString>;
@@ -453,6 +516,7 @@ export declare const updateAgentBodySchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -492,6 +556,7 @@ export declare const updateAgentBodySchema: z.ZodObject<{
                     save_memory: "save_memory";
                     search_memories: "search_memories";
                     update_memory: "update_memory";
+                    web_search: "web_search";
                     write: "write";
                     write_todos: "write_todos";
                 }>;
@@ -517,8 +582,19 @@ export declare const updateAgentBodySchema: z.ZodObject<{
     compactionReserveTokens: z.ZodOptional<z.ZodNumber>;
     memoryInjectionEnabled: z.ZodOptional<z.ZodBoolean>;
     tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        memory: "memory";
-        workspace: "workspace";
+        bash: "bash";
+        delete_memory: "delete_memory";
+        edit: "edit";
+        get_memory: "get_memory";
+        glob: "glob";
+        grep: "grep";
+        publish_artifacts: "publish_artifacts";
+        read: "read";
+        save_memory: "save_memory";
+        search_memories: "search_memories";
+        update_memory: "update_memory";
+        web_search: "web_search";
+        write: "write";
         write_todos: "write_todos";
     }>>>;
     instructions: z.ZodOptional<z.ZodString>;

package/dist/contracts/entities/agents.js

@@ -4,7 +4,7 @@ import { agentIdSchema, mcpConnectionIdSchema, providerIdSchema, tenantIdSchema,
 import { DEFAULT_AGENTS_LIST_LIMIT, MAX_AGENT_INSTRUCTIONS_LENGTH, MAX_AGENT_NAME_LENGTH, MAX_AGENTS_LIST_LIMIT, MAX_MCP_CONNECTIONS_PER_AGENT, } from "../limitations.js";
 import { atLeastOneFieldMessage, hasObjectKeys, hasUniqueValues, } from "../utils.js";
 import { approvalPolicySchema } from "./agent-approval.js";
-import { agentToolGroupIds } from "./agent-tools.js";
+import { agentToolNames } from "./agent-tools.js";
 import { metadataSchema, userIdSchema } from "./attribution.js";
 import { workspaceTierSchema } from "./workspaces.js";
 const approvalFields = {
@@ -24,9 +24,9 @@ export const agentInstructionsSchema = z
 /** Provider-native model id, passed through without interpretation. */
 export const agentModelIdSchema = z.string().trim().min(1);
 export const agentToolsSchema = z
-    .array(z.enum(agentToolGroupIds))
+    .array(z.enum(agentToolNames))
     .refine(hasUniqueValues, {
-    message: "Tool group ids must be unique.",
+    message: "Tool names must be unique.",
 });
 export const agentMcpConnectionIdsSchema = z
     .array(mcpConnectionIdSchema)

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

@@ -60,6 +60,7 @@ export declare const sessionResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -99,6 +100,7 @@ export declare const sessionResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -123,8 +125,19 @@ export declare const sessionResponseSchema: z.ZodObject<{
         compactionReserveTokens: z.ZodNumber;
         memoryInjectionEnabled: z.ZodBoolean;
         tools: z.ZodArray<z.ZodEnum<{
-            memory: "memory";
-            workspace: "workspace";
+            bash: "bash";
+            delete_memory: "delete_memory";
+            edit: "edit";
+            get_memory: "get_memory";
+            glob: "glob";
+            grep: "grep";
+            publish_artifacts: "publish_artifacts";
+            read: "read";
+            save_memory: "save_memory";
+            search_memories: "search_memories";
+            update_memory: "update_memory";
+            web_search: "web_search";
+            write: "write";
             write_todos: "write_todos";
         }>>;
         instructions: z.ZodString;
@@ -249,6 +262,7 @@ export declare const toolApprovalStateSchema: z.ZodObject<{
             save_memory: "save_memory";
             search_memories: "search_memories";
             update_memory: "update_memory";
+            web_search: "web_search";
             write: "write";
             write_todos: "write_todos";
         }>;
@@ -300,6 +314,7 @@ export declare const toolApprovalsResponseSchema: z.ZodObject<{
                 save_memory: "save_memory";
                 search_memories: "search_memories";
                 update_memory: "update_memory";
+                web_search: "web_search";
                 write: "write";
                 write_todos: "write_todos";
             }>;
@@ -346,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/tasks.d.ts

@@ -290,6 +290,7 @@ export declare const taskRunResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -329,6 +330,7 @@ export declare const taskRunResponseSchema: z.ZodObject<{
                         save_memory: "save_memory";
                         search_memories: "search_memories";
                         update_memory: "update_memory";
+                        web_search: "web_search";
                         write: "write";
                         write_todos: "write_todos";
                     }>;
@@ -353,8 +355,19 @@ export declare const taskRunResponseSchema: z.ZodObject<{
         compactionReserveTokens: z.ZodNumber;
         memoryInjectionEnabled: z.ZodBoolean;
         tools: z.ZodArray<z.ZodEnum<{
-            memory: "memory";
-            workspace: "workspace";
+            bash: "bash";
+            delete_memory: "delete_memory";
+            edit: "edit";
+            get_memory: "get_memory";
+            glob: "glob";
+            grep: "grep";
+            publish_artifacts: "publish_artifacts";
+            read: "read";
+            save_memory: "save_memory";
+            search_memories: "search_memories";
+            update_memory: "update_memory";
+            web_search: "web_search";
+            write: "write";
             write_todos: "write_todos";
         }>>;
         instructions: z.ZodString;
@@ -411,6 +424,7 @@ export declare const taskRunsListResponseSchema: z.ZodObject<{
                             save_memory: "save_memory";
                             search_memories: "search_memories";
                             update_memory: "update_memory";
+                            web_search: "web_search";
                             write: "write";
                             write_todos: "write_todos";
                         }>;
@@ -450,6 +464,7 @@ export declare const taskRunsListResponseSchema: z.ZodObject<{
                             save_memory: "save_memory";
                             search_memories: "search_memories";
                             update_memory: "update_memory";
+                            web_search: "web_search";
                             write: "write";
                             write_todos: "write_todos";
                         }>;
@@ -474,8 +489,19 @@ export declare const taskRunsListResponseSchema: z.ZodObject<{
             compactionReserveTokens: z.ZodNumber;
             memoryInjectionEnabled: z.ZodBoolean;
             tools: z.ZodArray<z.ZodEnum<{
-                memory: "memory";
-                workspace: "workspace";
+                bash: "bash";
+                delete_memory: "delete_memory";
+                edit: "edit";
+                get_memory: "get_memory";
+                glob: "glob";
+                grep: "grep";
+                publish_artifacts: "publish_artifacts";
+                read: "read";
+                save_memory: "save_memory";
+                search_memories: "search_memories";
+                update_memory: "update_memory";
+                web_search: "web_search";
+                write: "write";
                 write_todos: "write_todos";
             }>>;
             instructions: z.ZodString;

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,7 +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 { 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";
@@ -16,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 { 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,6 +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_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";
@@ -16,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,6 +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_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.26.0",
+  "version": "0.28.0",
   "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",