@blazingagents/sdk 0.7.0 → 0.9.0

package/README.md

@@ -16,7 +16,7 @@ requires Node.js 24 or newer.
 ## Features
 
 - Typed clients for Agents, Workspaces, Skills, Providers, Prompts, Tasks,
-  Sessions, Artifacts, usage, and Tenant settings.
+  Sessions, Artifacts, Slack and Telegram Chat Connections, usage, and Tenant settings.
 - Stateful chat and stateless text or structured-object generation.
 - Public Zod contracts for validating API requests and responses.
 - Cursor pagination and binary transfers.
@@ -184,3 +184,57 @@ await client.agents.update({
   compactionReserveTokens: 32768,
 });
 ```
+
+### Tool approval policies (0.8.0)
+
+Agents and immutable Agent Versions expose separate `approvalInChat` and
+`approvalInTasks` policies. Create and update them through the ordinary Agent API:
+
+```ts
+await client.agents.update({
+  agentId,
+  approvalInChat: {
+    default: "full",
+    overrides: [
+      { tool: { type: "builtin", name: "bash" }, decision: "manual" },
+      {
+        tool: { type: "mcp", connectionId: "mcp_0123456789abcdef", name: "send_mail" },
+        decision: "auto",
+      },
+    ],
+  },
+  approvalInTasks: { default: "deny", overrides: [] },
+});
+```
+
+An exact tool override wins over the default. Both policies default to `full`
+with no overrides. `full` allows available tools, `deny` blocks execution,
+`manual` requires human review, and `auto` uses backend LLM review. Review errors
+block execution; escalation without an available human also blocks execution.
+Policies do not grant tool access. MCP references use the original remote tool
+name and connection ID; the backend validates attachment and discovery.
+
+Omitting a policy from an update preserves it. Supplying one replaces that whole
+policy; omitted or empty `overrides` clears its overrides. `restoreVersion`
+restores both policies alongside the other versioned fields.
+
+Interactive Sessions reuse `client.sessions.toolApprovals`,
+`client.sessions.decideToolApproval`, and
+`client.sessions.joinToolApprovalContinuation`. A configured backend human
+reviewer path is required. Tasks and stateless generations have no human
+continuation path and block manual or escalated calls; stateless generation uses
+`approvalInChat`. The SDK does not run an approval reviewer.
+
+Approval rows retain optional `tool`, `assistantMessageId`, `createdAt`, and
+`decidedAt` metadata. `tool` and `decidedAt` may be null (admin tools have no
+ordinary-policy reference). Persisted approval decisions remain
+`pending | approved | denied`; policy modes are `full | deny | manual | auto`.
+The root package exports `ApprovalDecision`, `ApprovalPolicy`, `ToolReference`,
+and `ToolApprovalState`; runtime policy schemas are exported from
+`@blazingagents/sdk/contracts`.
+
+## Slack and Telegram
+
+Use the [connection example](https://github.com/blazingagents/typescript-sdk/blob/main/examples/chat-integrations.md) to connect an existing
+Agent through REST. BA hosts the Chat SDK runtime, conversation history, and
+approval cards; no additional SDK resource is required.

package/dist/client.d.ts

@@ -1,6 +1,7 @@
-import type { AgentClient, AgentsResource, ArtifactsResource, BlazingAgentsOptions, BlazingAgentsRequestOptions, ChatInput, ChatResult, CompletionInput, CompletionResult, McpConnectionsResource, MemoriesResource, ObjectInput, ObjectResult, PromptsResource, ProvidersResource, SessionsResource, TasksResource, TenantResource, UsageResource, WorkspacesResource } from "./types.ts";
+import type { AgentClient, AgentsResource, ArtifactsResource, BlazingAgentsOptions, BlazingAgentsRequestOptions, ChatConnectionsResource, ChatInput, ChatResult, CompletionInput, CompletionResult, McpConnectionsResource, MemoriesResource, ObjectInput, ObjectResult, PromptsResource, ProvidersResource, SessionsResource, TasksResource, TenantResource, UsageResource, WorkspacesResource } from "./types.ts";
 export declare class BlazingAgents {
     private readonly config;
+    readonly chatConnections: ChatConnectionsResource;
     readonly agents: AgentsResource;
     readonly sessions: SessionsResource;
     readonly providers: ProvidersResource;

package/dist/client.js

@@ -1,6 +1,7 @@
 import { chat, completion, objectGeneration } from "./generation.js";
 import { createAgentsResource } from "./resources/agents.js";
 import { createArtifactsResource } from "./resources/artifacts.js";
+import { createChatConnectionsResource } from "./resources/chat-connections.js";
 import { createMcpConnectionsResource } from "./resources/mcp-connections.js";
 import { createMemoriesResource } from "./resources/memories.js";
 import { createPromptsResource } from "./resources/prompts.js";
@@ -15,6 +16,7 @@ const DEFAULT_BASE_URL = "https://api.blazingagents.com";
 const TRAILING_SLASH_RE = /\/+$/;
 export class BlazingAgents {
     config;
+    chatConnections;
     agents;
     sessions;
     providers;
@@ -36,6 +38,7 @@ export class BlazingAgents {
                 : { clientRequestId: options.clientRequestId }),
             onResponse: options.onResponse,
         };
+        this.chatConnections = createChatConnectionsResource(this.config);
         this.agents = createAgentsResource(this.config);
         this.sessions = createSessionsResource(this.config);
         this.providers = createProvidersResource(this.config);

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

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export declare const approvalDecisionSchema: z.ZodEnum<{
+    auto: "auto";
+    deny: "deny";
+    full: "full";
+    manual: "manual";
+}>;
+export declare const toolReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"builtin">;
+    name: z.ZodEnum<{
+        activate_skill: "activate_skill";
+        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";
+        write: "write";
+        write_todos: "write_todos";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"mcp">;
+    connectionId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>], "type">;
+export declare const approvalPolicySchema: z.ZodObject<{
+    default: z.ZodEnum<{
+        auto: "auto";
+        deny: "deny";
+        full: "full";
+        manual: "manual";
+    }>;
+    overrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"builtin">;
+            name: z.ZodEnum<{
+                activate_skill: "activate_skill";
+                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";
+                write: "write";
+                write_todos: "write_todos";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"mcp">;
+            connectionId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>], "type">;
+        decision: z.ZodEnum<{
+            auto: "auto";
+            deny: "deny";
+            full: "full";
+            manual: "manual";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ApprovalPolicy = z.infer<typeof approvalPolicySchema>;
+export type ToolReference = z.infer<typeof toolReferenceSchema>;
+export type ApprovalDecision = z.infer<typeof approvalDecisionSchema>;

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

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { mcpConnectionIdSchema } from "../ids.js";
+import { AGENT_TOOL_CATALOG } from "./agent-tools.js";
+export const approvalDecisionSchema = z.enum([
+    "full",
+    "deny",
+    "manual",
+    "auto",
+]);
+export const toolReferenceSchema = z.discriminatedUnion("type", [
+    z
+        .object({
+        type: z.literal("builtin"),
+        name: z.enum([
+            ...AGENT_TOOL_CATALOG.flatMap((group) => group.tools),
+            "activate_skill",
+        ]),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("mcp"),
+        connectionId: mcpConnectionIdSchema,
+        name: z.string().min(1),
+    })
+        .strict(),
+]);
+export const approvalPolicySchema = z
+    .object({
+    default: approvalDecisionSchema,
+    overrides: z
+        .array(z
+        .object({
+        tool: toolReferenceSchema,
+        decision: approvalDecisionSchema,
+    })
+        .strict())
+        .default([]),
+})
+    .strict()
+    .superRefine((policy, ctx) => {
+    const seen = new Set();
+    for (const [index, rule] of policy.overrides.entries()) {
+        const key = JSON.stringify(rule.tool);
+        if (seen.has(key)) {
+            ctx.addIssue({
+                code: "custom",
+                message: "Tool overrides must be unique within each policy.",
+                path: ["overrides", index, "tool"],
+            });
+        }
+        seen.add(key);
+    }
+});