@blazingagents/sdk 0.28.1 → 0.30.0

package/dist/client.js

@@ -36,7 +36,11 @@ function createUserClient(config) {
         artifacts: createArtifactsResource(config),
         workspaces: createWorkspacesResource(config),
         memories: createMemoriesResource(config),
-        usage: { get: usage.get, sessions: usage.sessions },
+        usage: {
+            get: usage.get,
+            getForAgent: usage.getForAgent,
+            sessions: usage.sessions,
+        },
         /** Returns Skill operations for the selected Agent. */
         agent: ({ agentId }) => ({
             skills: createAgentSkillsResource(config, agentId),

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

@@ -37,17 +37,7 @@ 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 {
-    /** @deprecated Use the group tag in `tags`. */
-    category: AgentToolGroupTag;
     description: string;
     name: string;
     /** The tool runs in the Agent's attached Workspace. */
@@ -57,85 +47,71 @@ export interface AgentToolDefinition {
 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.";
 }];

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

@@ -41,104 +41,88 @@ 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.",
     },

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, 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 type { AgentToolDefinition, AgentToolFileAccessTag, AgentToolGroupTag, AgentToolName, AgentToolTag, AgentToolTags, } from "./entities/agent-tools.ts";
+export { 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";

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_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, agentToolNames, chatFunctionNameSchema, } from "./entities/agent-tools.js";
+export { 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";

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_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 { AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, 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";
@@ -28,4 +28,4 @@ export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransport
 export { BlazingAgentsError } from "./errors.ts";
 export { type ChatFunction, type ChatFunctionContext, type ChatFunctions, defineFunction, } from "./functions.ts";
 export { createChatRelay, createCompletionRelay, type RelayContext, type SessionOwnershipStore, } from "./relay.ts";
-export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, BlazingAgentsUIMessageData, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";
+export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, BlazingAgentsUIMessageData, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserAgentsResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.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_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_TOOLS, } from "./contracts/entities/agent-tools.js";
+export { 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/types.d.ts

@@ -61,6 +61,24 @@ export interface BlazingAgentsOptions {
 export interface BlazingAgentsRequestOptions {
     clientRequestId: string;
 }
+/**
+ * Agent operations on a user-scoped client. The API refuses the spending limit
+ * methods for user-scoped callers.
+ */
+export interface UserAgentsResource extends Omit<AgentsResource, "getSpendingLimit" | "updateSpendingLimit"> {
+    /**
+     * @deprecated The API always refuses this for user-scoped callers with
+     * `forbidden` (403). Call it on the tenant client instead. It is removed
+     * from user-scoped clients in a later release.
+     */
+    getSpendingLimit: AgentsResource["getSpendingLimit"];
+    /**
+     * @deprecated The API always refuses this for user-scoped callers with
+     * `forbidden` (403). Call it on the tenant client instead. It is removed
+     * from user-scoped clients in a later release.
+     */
+    updateSpendingLimit: AgentsResource["updateSpendingLimit"];
+}
 export interface UserClient {
     /**
      * Returns the Skill operations for the selected Agent.
@@ -70,7 +88,7 @@ export interface UserClient {
     agent(input: {
         agentId: string;
     }): AgentClient;
-    readonly agents: AgentsResource;
+    readonly agents: UserAgentsResource;
     readonly artifacts: ArtifactsResource;
     /**
      * Creates or resumes a Session and returns its SSE stream and Session ID.
@@ -100,7 +118,7 @@ export interface UserClient {
     readonly prompts: PromptsResource;
     readonly sessions: SessionsResource;
     readonly tasks: TasksResource;
-    readonly usage: Pick<UsageResource, "get" | "sessions">;
+    readonly usage: Pick<UsageResource, "get" | "getForAgent" | "sessions">;
     /**
      * Creates a client view with the supplied request correlation ID.
      * @param options - Caller-owned request correlation ID for subsequent calls.

package/package.json

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