@blazingagents/sdk 0.19.0 → 0.21.0

package/dist/resources/sessions.js

@@ -1,43 +1,32 @@
-import { resumeSessionInputsResponseSchema, sessionInputRequestIdSchema, sessionInputResponseSchema, sessionInputsResponseSchema, stopSessionResponseSchema, } from "../contracts/entities/session-inputs.js";
-import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
+import { sessionInputResponseSchema, sessionInputsResponseSchema, stopSessionResponseSchema, } from "../contracts/entities/session-inputs.js";
+import { latestSessionsListResponseSchema, sessionMessagesResponseSchema, sessionResponseSchema, sessionsListResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
 import { agentIdSchema, sessionIdSchema, turnIdSchema, } from "../contracts/ids.js";
-import { dispatchChatFunctions, stripFunctionEvents, toChatFunctionDefinitions, } from "../functions.js";
-import { buildTerminalStreamResult, withFilteredBody } from "../generation.js";
-import { requestJson, requestStream } from "../http.js";
+import { requestJson } from "../http.js";
 /**
  * `client.sessions` reads, paginates, and deletes Sessions under
  * `/v1/agents/:agentId/sessions`. Pagination is manual: the SDK returns
  * the page as-is (`{ data, nextCursor }` verbatim); the caller passes
  * `nextCursor` back as `cursor` on the next call.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export function createSessionsResource(config) {
     return {
-        async runInputs({ agentId, sessionId, functions, abortSignal }) {
-            const response = await requestStream(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/run`, {
-                method: "POST",
-                json: functions === undefined
-                    ? {}
-                    : { functions: toChatFunctionDefinitions(functions) },
-                signal: abortSignal,
-            });
-            return buildTerminalStreamResult(response, "input Turn", (body) => functions
-                ? dispatchChatFunctions(config, { agentId, sessionId, functions, abortSignal }, body)
-                : stripFunctionEvents(body));
-        },
+        /**
+         * Submits a Session input. Reuse the request ID and payload after an uncertain acknowledgement.
+         */
         async submitInput({ agentId, sessionId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs`, { method: "POST", json: body, signal: abortSignal }, sessionInputResponseSchema);
         },
+        /**
+         * Lists input receipts. Poll the first page to observe state changes.
+         */
         async inputs({ agentId, sessionId, abortSignal, ...query }) {
             return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs`, { query, signal: abortSignal }, sessionInputsResponseSchema);
         },
-        async promoteInput({ agentId, sessionId, requestId, abortSignal }) {
-            const inputId = sessionInputRequestIdSchema.parse(requestId);
-            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/${encodeURIComponent(inputId)}/promote`, { method: "POST", signal: abortSignal }, sessionInputResponseSchema);
-        },
-        async deleteInput({ agentId, sessionId, requestId, abortSignal }) {
-            const inputId = sessionInputRequestIdSchema.parse(requestId);
-            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/${encodeURIComponent(inputId)}`, { method: "DELETE", signal: abortSignal }, sessionInputResponseSchema);
-        },
+        /**
+         * Records cancellation for the named Turn without waiting for settlement.
+         */
         async stop({ agentId, sessionId, turnId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/stop`, {
                 method: "POST",
@@ -45,19 +34,26 @@ export function createSessionsResource(config) {
                 signal: abortSignal,
             }, stopSessionResponseSchema);
         },
-        async resumeInputs({ agentId, sessionId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/inputs/resume`, { method: "POST", signal: abortSignal }, resumeSessionInputsResponseSchema);
+        /**
+         * Forks a Session at a message. Reuse the idempotency key after an uncertain acknowledgement.
+         */
+        async fork({ agentId, sessionId, messageId, idempotencyKey, abortSignal }) {
+            return await requestJson(config, `/v1/agents/${agentIdSchema.parse(agentId)}/sessions/${sessionIdSchema.parse(sessionId)}/fork`, {
+                method: "POST",
+                json: { messageId },
+                headers: { "Idempotency-Key": idempotencyKey },
+                signal: abortSignal,
+            }, sessionResponseSchema);
         },
+        /**
+         * Retrieves sessions.
+         */
         async get({ agentId, sessionId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}`, { signal: abortSignal }, sessionResponseSchema);
         },
-        async decideToolApproval({ agentId, sessionId, approvalId, abortSignal, ...decision }) {
-            return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals/${approvalId}`, {
-                json: decision,
-                method: "POST",
-                signal: abortSignal,
-            }, toolApprovalDecisionResponseSchema);
-        },
+        /**
+         * Lists one page of sessions.
+         */
         async list({ agentId, ...options }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions`, {
                 signal: options.abortSignal,
@@ -69,6 +65,9 @@ export function createSessionsResource(config) {
                 },
             }, sessionsListResponseSchema);
         },
+        /**
+         * Lists recently updated Sessions, optionally limited to one per Agent.
+         */
         async listLatest(options = {}) {
             return await requestJson(config, "/v1/sessions/latest", {
                 signal: options.abortSignal,
@@ -83,6 +82,9 @@ export function createSessionsResource(config) {
                 },
             }, latestSessionsListResponseSchema);
         },
+        /**
+         * Lists one page of Session messages.
+         */
         async messages({ agentId, sessionId, ...options }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/messages`, {
                 signal: options.abortSignal,
@@ -93,14 +95,15 @@ export function createSessionsResource(config) {
                 },
             }, sessionMessagesResponseSchema);
         },
-        async joinToolApprovalContinuation({ agentId, sessionId, continuationId, abortSignal, }) {
-            const response = await requestStream(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approval-continuations/${continuationId}`, { signal: abortSignal });
-            /** Observers never execute calls; private events are removed unclaimed. */
-            return buildTerminalStreamResult(withFilteredBody(response, stripFunctionEvents), "continuation");
-        },
+        /**
+         * Retrieves the pending Tool approval round.
+         */
         async toolApprovals({ agentId, sessionId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals`, { signal: abortSignal }, toolApprovalsResponseSchema);
         },
+        /**
+         * Deletes sessions.
+         */
         async delete({ agentId, sessionId, deleteArtifacts, abortSignal }) {
             await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}`, { method: "DELETE", query: { deleteArtifacts }, signal: abortSignal });
         },

package/dist/resources/skills.d.ts

@@ -1,2 +1,7 @@
 import type { AgentSkillsResource, HttpConfig } from "../types.ts";
+/**
+ * Builds the Agent Skills operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export declare function createAgentSkillsResource(config: HttpConfig, agentId: string): AgentSkillsResource;

package/dist/resources/skills.js

@@ -1,28 +1,54 @@
 import { skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "../contracts/entities/skills.js";
 import { isRequestAborted, requestAbortedError, requestJson, requestStream, } from "../http.js";
+/**
+ * Builds a Skill file URL with encoded Agent, Skill, and file path values.
+ */
 function fileUrl(agentId, input) {
     return `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(input.skillId)}/files?path=${encodeURIComponent(input.path)}`;
 }
+/**
+ * Builds the Agent Skills operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export function createAgentSkillsResource(config, agentId) {
     return {
+        /**
+         * Copies skills.
+         */
         async copy({ skillId, to, abortSignal }) {
             return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}/copies`, { json: to, method: "POST", signal: abortSignal }, skillCopyResultsSchema);
         },
+        /**
+         * Creates skills.
+         */
         async create({ abortSignal, ...body }) {
             return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { json: body, method: "POST", signal: abortSignal }, skillDetailSchema);
         },
+        /**
+         * Deletes skills.
+         */
         async delete({ skillId, abortSignal }) {
             await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, { method: "DELETE", signal: abortSignal });
         },
+        /**
+         * Deletes a Skill file.
+         */
         async deleteFile({ abortSignal, ...input }) {
             return await requestJson(config, fileUrl(agentId, input), {
                 method: "DELETE",
                 signal: abortSignal,
             }, skillDetailSchema);
         },
+        /**
+         * Retrieves skills.
+         */
         async get({ skillId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, { signal: abortSignal }, skillDetailSchema);
         },
+        /**
+         * Reads Skill file bytes.
+         */
         async getFile({ abortSignal, ...input }) {
             const response = await requestStream(config, fileUrl(agentId, input), {
                 signal: abortSignal,
@@ -37,9 +63,15 @@ export function createAgentSkillsResource(config, agentId) {
                 throw cause;
             }
         },
+        /**
+         * Lists one page of skills.
+         */
         async list({ cursor, limit, abortSignal } = {}) {
             return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { signal: abortSignal, query: { cursor, limit } }, skillsListResponseSchema);
         },
+        /**
+         * Replaces a Skill file with the supplied content.
+         */
         async putFile({ content, abortSignal, ...input }) {
             return await requestJson(config, fileUrl(agentId, input), {
                 body: content,
@@ -47,6 +79,9 @@ export function createAgentSkillsResource(config, agentId) {
                 signal: abortSignal,
             }, skillDetailSchema);
         },
+        /**
+         * Uploads a Skill archive as multipart form data.
+         */
         async upload({ source, abortSignal }) {
             const form = new FormData();
             form.set("type", source.type);

package/dist/resources/tasks.d.ts

@@ -3,5 +3,7 @@ import type { HttpConfig, TasksResource } from "../types.ts";
  * `client.tasks` — CRUD + runs over `/v1/tasks`. Runs are listed/get/
  * canceled/transcripted via `/v1/tasks/:taskId/runs/...`. All lists are
  * keyset-cursored.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export declare function createTasksResource(config: HttpConfig): TasksResource;

package/dist/resources/tasks.js

@@ -4,9 +4,14 @@ import { requestJson } from "../http.js";
  * `client.tasks` — CRUD + runs over `/v1/tasks`. Runs are listed/get/
  * canceled/transcripted via `/v1/tasks/:taskId/runs/...`. All lists are
  * keyset-cursored.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export function createTasksResource(config) {
     return {
+        /**
+         * Creates tasks.
+         */
         async create({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/tasks", {
                 json: body,
@@ -14,6 +19,9 @@ export function createTasksResource(config) {
                 method: "POST",
             }, createTaskResponseSchema);
         },
+        /**
+         * Lists one page of tasks.
+         */
         async list(options = {}) {
             return await requestJson(config, "/v1/tasks", {
                 signal: options.abortSignal,
@@ -26,9 +34,15 @@ export function createTasksResource(config) {
                 },
             }, tasksListResponseSchema);
         },
+        /**
+         * Retrieves tasks.
+         */
         async get({ taskId, abortSignal }) {
             return await requestJson(config, `/v1/tasks/${taskId}`, { signal: abortSignal }, taskResponseSchema);
         },
+        /**
+         * Updates tasks.
+         */
         async update({ taskId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/tasks/${taskId}`, {
                 json: body,
@@ -36,24 +50,39 @@ export function createTasksResource(config) {
                 method: "PATCH",
             }, taskResponseSchema);
         },
+        /**
+         * Deletes tasks.
+         */
         async delete({ taskId, abortSignal }) {
             await requestJson(config, `/v1/tasks/${taskId}`, {
                 method: "DELETE",
                 signal: abortSignal,
             });
         },
+        /**
+         * Creates a Task run.
+         */
         async createRun({ taskId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/tasks/${taskId}/runs`, { json: body, method: "POST", signal: abortSignal }, createTaskRunResponseSchema);
         },
+        /**
+         * Lists one page of Task runs.
+         */
         async listRuns({ taskId, ...options }) {
             return await requestJson(config, `/v1/tasks/${taskId}/runs`, {
                 signal: options.abortSignal,
                 query: { cursor: options.cursor, limit: options.limit },
             }, taskRunsListResponseSchema);
         },
+        /**
+         * Retrieves a Task run.
+         */
         async getRun({ taskId, runId, abortSignal }) {
             return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}`, { signal: abortSignal }, taskRunResponseSchema);
         },
+        /**
+         * Lists one page of Task run messages.
+         */
         async runMessages({ taskId, runId, ...options }) {
             return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/messages`, {
                 signal: options.abortSignal,
@@ -64,6 +93,9 @@ export function createTasksResource(config) {
                 },
             }, taskRunMessagesResponseSchema);
         },
+        /**
+         * Requests cancellation of a Task run.
+         */
         async cancelRun({ taskId, runId, abortSignal }) {
             await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/cancel`, { method: "POST", signal: abortSignal });
         },

package/dist/resources/tenant.d.ts

@@ -2,5 +2,7 @@ import type { HttpConfig, TenantResource } from "../types.ts";
 /**
  * `client.tenant` — get/patch over `/v1/tenant` (the tenant's self-set
  * quota row). `quota: null` means unlimited (no row).
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export declare function createTenantResource(config: HttpConfig): TenantResource;

package/dist/resources/tenant.js

@@ -3,12 +3,20 @@ import { requestJson } from "../http.js";
 /**
  * `client.tenant` — get/patch over `/v1/tenant` (the tenant's self-set
  * quota row). `quota: null` means unlimited (no row).
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export function createTenantResource(config) {
     return {
+        /**
+         * Retrieves tenant.
+         */
         async get({ abortSignal } = {}) {
             return await requestJson(config, "/v1/tenant", { signal: abortSignal }, tenantSettingsResponseSchema);
         },
+        /**
+         * Updates tenant.
+         */
         async patch({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/tenant", {
                 json: body,

package/dist/resources/usage.d.ts

@@ -3,5 +3,7 @@ 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.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export declare function createUsageResource(config: HttpConfig): UsageResource;

package/dist/resources/usage.js

@@ -4,9 +4,14 @@ 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.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export function createUsageResource(config) {
     return {
+        /**
+         * Retrieves usage grouped by Session.
+         */
         async sessions({ abortSignal, ...input }) {
             const body = sessionUsageQuerySchema.parse(input);
             return await requestJson(config, "/v1/usage/sessions", {
@@ -15,15 +20,24 @@ export function createUsageResource(config) {
                 signal: abortSignal,
             }, sessionUsageResponseSchema);
         },
+        /**
+         * Retrieves usage.
+         */
         async get({ abortSignal, ...query } = {}) {
             return await requestJson(config, "/v1/usage", {
                 query,
                 signal: abortSignal,
             }, usageResponseSchema);
         },
+        /**
+         * Retrieves usage for one Agent.
+         */
         async getForAgent({ agentId, abortSignal, ...query }) {
             return await requestJson(config, `/v1/agents/${agentId}/usage`, { query, signal: abortSignal }, usageResponseSchema);
         },
+        /**
+         * Retrieves usage totals, daily usage, and bounded rankings.
+         */
         async overview({ abortSignal, ...query } = {}) {
             return await requestJson(config, "/v1/usage/overview", { query, signal: abortSignal }, usageOverviewResponseSchemaForQuery(query));
         },

package/dist/resources/workspaces.d.ts

@@ -1,2 +1,7 @@
 import type { HttpConfig, WorkspacesResource } from "../types.ts";
+/**
+ * Builds the Workspaces operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export declare function createWorkspacesResource(config: HttpConfig): WorkspacesResource;

package/dist/resources/workspaces.js

@@ -1,7 +1,15 @@
 import { workspaceSchema, workspacesListResponseSchema, } from "../contracts/entities/workspaces.js";
 import { requestJson, requestStream } from "../http.js";
+/**
+ * Builds the Workspaces operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export function createWorkspacesResource(config) {
     return {
+        /**
+         * Creates workspaces.
+         */
         async create({ abortSignal, ...body } = {}) {
             return await requestJson(config, "/v1/workspaces", {
                 json: body,
@@ -9,13 +17,22 @@ export function createWorkspacesResource(config) {
                 method: "POST",
             }, workspaceSchema);
         },
+        /**
+         * Deletes workspaces.
+         */
         async delete({ workspaceId, abortSignal }) {
             const response = await requestStream(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { method: "DELETE", signal: abortSignal });
             return response.status === 202 ? "pending" : "completed";
         },
+        /**
+         * Retrieves workspaces.
+         */
         async get({ workspaceId, abortSignal }) {
             return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { signal: abortSignal }, workspaceSchema);
         },
+        /**
+         * Lists one page of workspaces.
+         */
         async list({ abortSignal, ...options } = {}) {
             return await requestJson(config, "/v1/workspaces", {
                 signal: abortSignal,
@@ -26,6 +43,9 @@ export function createWorkspacesResource(config) {
                 },
             }, workspacesListResponseSchema);
         },
+        /**
+         * Updates workspaces.
+         */
         async update({ workspaceId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { json: body, signal: abortSignal, method: "PUT" }, workspaceSchema);
         },