@blazingagents/sdk 0.34.0 → 0.36.0

package/dist/resources/tasks.js

@@ -9,9 +9,6 @@ import { apiPath, requestJson } from "../http.js";
  */
 export function createTasksResource(config) {
     return {
-        /**
-         * Creates tasks.
-         */
         async create({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/tasks", {
                 json: body,
@@ -19,9 +16,6 @@ export function createTasksResource(config) {
                 method: "POST",
             }, createTaskResponseSchema);
         },
-        /**
-         * Lists one page of tasks.
-         */
         async list(options = {}) {
             return await requestJson(config, "/v1/tasks", {
                 signal: options.abortSignal,
@@ -33,15 +27,9 @@ export function createTasksResource(config) {
                 },
             }, tasksListResponseSchema);
         },
-        /**
-         * Retrieves tasks.
-         */
         async get({ taskId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/tasks/${taskId}`, { signal: abortSignal }, taskResponseSchema);
         },
-        /**
-         * Updates tasks.
-         */
         async update({ taskId, abortSignal, ...body }) {
             return await requestJson(config, apiPath `/v1/tasks/${taskId}`, {
                 json: body,
@@ -49,39 +37,24 @@ export function createTasksResource(config) {
                 method: "PATCH",
             }, taskResponseSchema);
         },
-        /**
-         * Deletes tasks.
-         */
         async delete({ taskId, abortSignal }) {
             await requestJson(config, apiPath `/v1/tasks/${taskId}`, {
                 method: "DELETE",
                 signal: abortSignal,
             });
         },
-        /**
-         * Creates a Task run.
-         */
         async createRun({ taskId, abortSignal, ...body }) {
             return await requestJson(config, apiPath `/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, apiPath `/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, apiPath `/v1/tasks/${taskId}/runs/${runId}`, { signal: abortSignal }, taskRunResponseSchema);
         },
-        /**
-         * Lists one page of Task run messages.
-         */
         async runMessages({ taskId, runId, ...options }) {
             return await requestJson(config, apiPath `/v1/tasks/${taskId}/runs/${runId}/messages`, {
                 signal: options.abortSignal,
@@ -92,9 +65,6 @@ export function createTasksResource(config) {
                 },
             }, taskRunMessagesResponseSchema);
         },
-        /**
-         * Requests cancellation of a Task run.
-         */
         async cancelRun({ taskId, runId, abortSignal }) {
             await requestJson(config, apiPath `/v1/tasks/${taskId}/runs/${runId}/cancel`, { method: "POST", signal: abortSignal });
         },

package/dist/resources/tenant.d.ts

@@ -1,4 +1,26 @@
-import type { HttpConfig, TenantResource } from "../types.ts";
+import { type SpendingLimitResponse, type UpdateSpendingLimitBody } from "../contracts/entities/spending-limits.ts";
+import { type TenantSettingsResponse, type UpdateTenantSettingsBody } from "../contracts/entities/tenants.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+export interface TenantResource {
+    /**
+     * Retrieves Tenant settings.
+     * @param input - optional abortSignal.
+     * @returns The tenant settings response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input?: ResourceRequestOptions): Promise<TenantSettingsResponse>;
+    /** Retrieves the tenant model spending limit. Requires tenant authority. */
+    getSpendingLimit(input?: ResourceRequestOptions): Promise<SpendingLimitResponse>;
+    /**
+     * Updates Tenant settings.
+     * @param input - fields to change; optional abortSignal.
+     * @returns The tenant settings response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    patch(input: UpdateTenantSettingsBody & ResourceRequestOptions): Promise<TenantSettingsResponse>;
+    /** Sets the tenant model spending limit. Pass null to disable it. Requires tenant authority. */
+    updateSpendingLimit(input: UpdateSpendingLimitBody & ResourceRequestOptions): Promise<SpendingLimitResponse>;
+}
 /**
  * `client.tenant` — get/patch over `/v1/tenant` (the tenant's self-set
  * quota row). `quota: null` means unlimited (no row).

package/dist/resources/tenant.js

@@ -1,5 +1,5 @@
-import { spendingLimitResponseSchema } from "../contracts/entities/spending-limits.js";
-import { tenantSettingsResponseSchema } from "../contracts/entities/tenants.js";
+import { spendingLimitResponseSchema, } from "../contracts/entities/spending-limits.js";
+import { tenantSettingsResponseSchema, } from "../contracts/entities/tenants.js";
 import { requestJson } from "../http.js";
 /**
  * `client.tenant` — get/patch over `/v1/tenant` (the tenant's self-set
@@ -9,23 +9,15 @@ import { requestJson } from "../http.js";
  */
 export function createTenantResource(config) {
     return {
-        /** Retrieves the model spending limit using tenant authority. */
         async getSpendingLimit({ abortSignal } = {}) {
             return await requestJson(config, "/v1/tenant/spending-limit", { signal: abortSignal }, spendingLimitResponseSchema);
         },
-        /** Sets the model spending limit. Null disables it. Requires tenant authority. */
         async updateSpendingLimit({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/tenant/spending-limit", { method: "PUT", json: body, signal: abortSignal }, spendingLimitResponseSchema);
         },
-        /**
-         * 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

@@ -1,4 +1,37 @@
-import type { HttpConfig, UsageResource } from "../types.ts";
+import { type SessionUsageQuery, type SessionUsageResponse, type UsageOverviewQuery, type UsageOverviewResponse, type UsageQuery, type UsageResponse } from "../contracts/entities/usage.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+export interface UsageResource {
+    /**
+     * Retrieves usage totals.
+     * @param input - query filters; optional abortSignal.
+     * @returns The usage response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input?: Partial<UsageQuery> & ResourceRequestOptions): Promise<UsageResponse>;
+    /**
+     * Retrieves usage for one Agent.
+     * @param input - `agentId`; query filters; optional abortSignal.
+     * @returns The usage response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    getForAgent(input: Partial<UsageQuery> & {
+        agentId: string;
+    } & ResourceRequestOptions): Promise<UsageResponse>;
+    /**
+     * Returns totals, daily usage, and bounded Agent, user, and model rankings.
+     * @param input - query filters; optional abortSignal.
+     * @returns The usage overview response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    overview(input?: Partial<UsageOverviewQuery> & ResourceRequestOptions): Promise<UsageOverviewResponse>;
+    /**
+     * Retrieves usage grouped by Session.
+     * @param input - query filters; optional abortSignal.
+     * @returns The session usage response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    sessions(input: SessionUsageQuery & ResourceRequestOptions): Promise<SessionUsageResponse>;
+}
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
  * `/v1/agents/:agentId/usage` (per-agent). The query shape is `UsageQuery`;

package/dist/resources/usage.js

@@ -1,4 +1,4 @@
-import { sessionUsageQuerySchema, sessionUsageResponseSchema, usageOverviewResponseSchemaForQuery, usageResponseSchema, } from "../contracts/entities/usage.js";
+import { sessionUsageResponseSchema, usageOverviewResponseSchemaForQuery, usageResponseSchema, } from "../contracts/entities/usage.js";
 import { apiPath, requestJson } from "../http.js";
 /**
  * `client.usage` — get over `/v1/usage` (tenant-wide) and
@@ -9,35 +9,22 @@ import { apiPath, requestJson } from "../http.js";
  */
 export function createUsageResource(config) {
     return {
-        /**
-         * Retrieves usage grouped by Session.
-         */
-        async sessions({ abortSignal, ...input }) {
-            const body = sessionUsageQuerySchema.parse(input);
+        async sessions({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/usage/sessions", {
                 method: "POST",
                 json: body,
                 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, apiPath `/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,4 +1,53 @@
-import type { HttpConfig, WorkspacesResource } from "../types.ts";
+import { type CreateWorkspaceBody, type UpdateWorkspaceBody, type Workspace, type WorkspacesListResponse } from "../contracts/entities/workspaces.ts";
+import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
+export interface WorkspacesResource {
+    /**
+     * Creates the Workspace.
+     * @param input - creation fields; optional abortSignal.
+     * @returns The workspace.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    create(input?: CreateWorkspaceBody & ResourceRequestOptions): Promise<Workspace>;
+    /**
+     * Deletes the Workspace.
+     * @param input - `workspaceId`; optional abortSignal.
+     * @returns "pending" while deletion is underway, otherwise "completed".
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    delete(input: {
+        workspaceId: string;
+    } & ResourceRequestOptions): Promise<"completed" | "pending">;
+    /**
+     * Retrieves the Workspace.
+     * @param input - `workspaceId`; optional abortSignal.
+     * @returns The workspace.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    get(input: {
+        workspaceId: string;
+    } & ResourceRequestOptions): Promise<Workspace>;
+    /**
+     * Lists one page of Workspace records.
+     * @param input - filters and pagination options.
+     * @returns The workspaces list response.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    list(input?: WorkspacesListOptions): Promise<WorkspacesListResponse>;
+    /**
+     * Updates the Workspace.
+     * @param input - `workspaceId`; fields to change; optional abortSignal.
+     * @returns The workspace.
+     * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
+     */
+    update(input: UpdateWorkspaceBody & {
+        workspaceId: string;
+    } & ResourceRequestOptions): Promise<Workspace>;
+}
+export interface WorkspacesListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
+    userId?: string;
+}
 /**
  * Builds the Workspaces operations using the shared HTTP configuration.
  * @param config - Shared authentication and transport configuration.

package/dist/resources/workspaces.js

@@ -7,9 +7,6 @@ import { apiPath, requestJson, requestStream } from "../http.js";
  */
 export function createWorkspacesResource(config) {
     return {
-        /**
-         * Creates workspaces.
-         */
         async create({ abortSignal, ...body } = {}) {
             return await requestJson(config, "/v1/workspaces", {
                 json: body,
@@ -17,22 +14,13 @@ export function createWorkspacesResource(config) {
                 method: "POST",
             }, workspaceSchema);
         },
-        /**
-         * Deletes workspaces.
-         */
         async delete({ workspaceId, abortSignal }) {
             const response = await requestStream(config, apiPath `/v1/workspaces/${workspaceId}`, { method: "DELETE", signal: abortSignal });
             return response.status === 202 ? "pending" : "completed";
         },
-        /**
-         * Retrieves workspaces.
-         */
         async get({ workspaceId, abortSignal }) {
             return await requestJson(config, apiPath `/v1/workspaces/${workspaceId}`, { signal: abortSignal }, workspaceSchema);
         },
-        /**
-         * Lists one page of workspaces.
-         */
         async list({ abortSignal, ...options } = {}) {
             return await requestJson(config, "/v1/workspaces", {
                 signal: abortSignal,
@@ -43,9 +31,6 @@ export function createWorkspacesResource(config) {
                 },
             }, workspacesListResponseSchema);
         },
-        /**
-         * Updates workspaces.
-         */
         async update({ workspaceId, abortSignal, ...body }) {
             return await requestJson(config, apiPath `/v1/workspaces/${workspaceId}`, { json: body, signal: abortSignal, method: "PUT" }, workspaceSchema);
         },