@blazingagents/sdk 0.1.0

package/dist/resources/memories.js

@@ -0,0 +1,33 @@
+import { memoriesListResponseSchema, memoryResponseSchema, } from "../contracts/entities/memories.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.memories` — CRUD and query over `/v1/agents/:agentId/memories`.
+ * Memories are Agent-nested; `userId` is stamped at creation and immutable,
+ * while list can filter it (including explicit `''`) or full-text search.
+ */
+export function createMemoriesResource(config) {
+    return {
+        async list(agentId, options = {}) {
+            return await requestJson(config, `/v1/agents/${agentId}/memories`, {
+                query: {
+                    ...(options.userId === undefined ? {} : { userId: options.userId }),
+                    search: options.search,
+                    cursor: options.cursor,
+                    limit: options.limit,
+                },
+            }, memoriesListResponseSchema);
+        },
+        async create(agentId, body) {
+            return await requestJson(config, `/v1/agents/${agentId}/memories`, { json: body, method: "POST" }, memoryResponseSchema);
+        },
+        async get(agentId, memoryId) {
+            return await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, {}, memoryResponseSchema);
+        },
+        async update(agentId, memoryId, body) {
+            return await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, { json: body, method: "PATCH" }, memoryResponseSchema);
+        },
+        async delete(agentId, memoryId) {
+            await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, { method: "DELETE" });
+        },
+    };
+}

package/dist/resources/prompts.d.ts

@@ -0,0 +1,6 @@
+import type { HttpConfig, PromptsResource } from "../types.ts";
+/**
+ * `client.prompts` — CRUD over `/v1/prompts`. The list endpoint is
+ * unpaginated (bounded by the 100/tenant cap).
+ */
+export declare function createPromptsResource(config: HttpConfig): PromptsResource;

package/dist/resources/prompts.js

@@ -0,0 +1,36 @@
+import { promptResponseSchema, promptsResponseSchema, } from "../contracts/entities/prompts.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.prompts` — CRUD over `/v1/prompts`. The list endpoint is
+ * unpaginated (bounded by the 100/tenant cap).
+ */
+export function createPromptsResource(config) {
+    return {
+        async create(body) {
+            return await requestJson(config, "/v1/prompts", {
+                json: body,
+                method: "POST",
+            }, promptResponseSchema);
+        },
+        async list(userId) {
+            return await requestJson(config, "/v1/prompts", {
+                // Stryker disable next-line ConditionalExpression: URL serialization omits an undefined query value.
+                ...(userId === undefined ? {} : { query: { userId } }),
+            }, promptsResponseSchema);
+        },
+        async get(promptId) {
+            return await requestJson(config, `/v1/prompts/${promptId}`, {}, promptResponseSchema);
+        },
+        async update(promptId, body) {
+            return await requestJson(config, `/v1/prompts/${promptId}`, {
+                json: body,
+                method: "PATCH",
+            }, promptResponseSchema);
+        },
+        async delete(promptId) {
+            await requestJson(config, `/v1/prompts/${promptId}`, {
+                method: "DELETE",
+            });
+        },
+    };
+}

package/dist/resources/providers.d.ts

@@ -0,0 +1,5 @@
+import type { HttpConfig, ProvidersResource } from "../types.ts";
+/**
+ * `client.providers` — CRUD and cost-free model discovery.
+ */
+export declare function createProvidersResource(config: HttpConfig): ProvidersResource;

package/dist/resources/providers.js

@@ -0,0 +1,38 @@
+import { providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, } from "../contracts/entities/providers.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.providers` — CRUD and cost-free model discovery.
+ */
+export function createProvidersResource(config) {
+    return {
+        async create(body) {
+            return await requestJson(config, "/v1/providers", {
+                json: body,
+                method: "POST",
+            }, providerResponseSchema);
+        },
+        async list() {
+            return await requestJson(config, "/v1/providers", {}, providersResponseSchema);
+        },
+        async get(id) {
+            return await requestJson(config, `/v1/providers/${id}`, {}, providerResponseSchema);
+        },
+        async listModels(id) {
+            return await requestJson(config, `/v1/providers/${id}/models`, {}, providerModelsResponseSchema);
+        },
+        async update(id, body) {
+            return await requestJson(config, `/v1/providers/${id}`, {
+                json: body,
+                method: "PATCH",
+            }, providerResponseSchema);
+        },
+        async delete(id, options = {}) {
+            await requestJson(config, `/v1/providers/${id}`, {
+                method: "DELETE",
+                query: {
+                    confirmVersionInvalidation: options.confirmVersionInvalidation,
+                },
+            });
+        },
+    };
+}

package/dist/resources/sessions.d.ts

@@ -0,0 +1,8 @@
+import type { HttpConfig, SessionsResource } from "../types.ts";
+/**
+ * `client.sessions` — list/get-messages/delete over
+ * `/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.
+ */
+export declare function createSessionsResource(config: HttpConfig): SessionsResource;

package/dist/resources/sessions.js

@@ -0,0 +1,49 @@
+import { sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalDecisionResponseSchema, toolApprovalsResponseSchema, } from "../contracts/entities/sessions.js";
+import { buildTerminalStreamResult } from "../generation.js";
+import { requestJson, requestStream } from "../http.js";
+/**
+ * `client.sessions` — list/get-messages/delete over
+ * `/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.
+ */
+export function createSessionsResource(config) {
+    return {
+        async decideToolApproval(agentId, sessionId, approvalId, decision, options = {}) {
+            return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals/${approvalId}`, {
+                json: decision,
+                method: "POST",
+                ...(options.signal ? { signal: options.signal } : {}),
+            }, toolApprovalDecisionResponseSchema);
+        },
+        async list(agentId, options = {}) {
+            return await requestJson(config, `/v1/agents/${agentId}/sessions`, {
+                query: {
+                    cursor: options.cursor,
+                    limit: options.limit,
+                    // Stryker disable next-line ConditionalExpression: URL serialization omits an undefined query value.
+                    ...(options.userId === undefined ? {} : { userId: options.userId }),
+                },
+            }, sessionsListResponseSchema);
+        },
+        async messages(agentId, sessionId, options = {}) {
+            return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/messages`, {
+                query: {
+                    cursor: options.cursor,
+                    after: options.after,
+                    limit: options.limit,
+                },
+            }, sessionMessagesResponseSchema);
+        },
+        async joinToolApprovalContinuation(agentId, sessionId, continuationId, options = {}) {
+            const response = await requestStream(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approval-continuations/${continuationId}`, options.signal ? { signal: options.signal } : {});
+            return buildTerminalStreamResult(response, "continuation");
+        },
+        async toolApprovals(agentId, sessionId) {
+            return await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}/tool-approvals`, {}, toolApprovalsResponseSchema);
+        },
+        async delete(agentId, sessionId, deleteArtifacts) {
+            await requestJson(config, `/v1/agents/${agentId}/sessions/${sessionId}`, { method: "DELETE", query: { deleteArtifacts } });
+        },
+    };
+}

package/dist/resources/skills.d.ts

@@ -0,0 +1,2 @@
+import type { AgentSkillsResource, HttpConfig } from "../types.ts";
+export declare function createAgentSkillsResource(config: HttpConfig, agentId: string): AgentSkillsResource;

package/dist/resources/skills.js

@@ -0,0 +1,49 @@
+import { skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "../contracts/entities/skills.js";
+import { requestJson, requestStream } from "../http.js";
+function fileUrl(agentId, input) {
+    const path = input.path.split("/").map(encodeURIComponent).join("/");
+    return `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(input.skillId)}/files/${path}`;
+}
+export function createAgentSkillsResource(config, agentId) {
+    return {
+        async copy({ skillId, to }) {
+            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}/copies`, { json: to, method: "POST" }, skillCopyResultsSchema);
+        },
+        async create(body) {
+            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { json: body, method: "POST" }, skillDetailSchema);
+        },
+        async delete({ skillId }) {
+            await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, { method: "DELETE" });
+        },
+        async deleteFile(input) {
+            return await requestJson(config, fileUrl(agentId, input), {
+                method: "DELETE",
+            }, skillDetailSchema);
+        },
+        async get({ skillId }) {
+            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`, {}, skillDetailSchema);
+        },
+        async getFile(input) {
+            const response = await requestStream(config, fileUrl(agentId, input));
+            return new Uint8Array(await response.arrayBuffer());
+        },
+        async list({ cursor, limit } = {}) {
+            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills`, { query: { cursor, limit } }, skillsListResponseSchema);
+        },
+        async putFile({ content, ...input }) {
+            return await requestJson(config, fileUrl(agentId, input), {
+                body: content,
+                method: "PUT",
+            }, skillDetailSchema);
+        },
+        async upload({ source }) {
+            const form = new FormData();
+            form.set("type", source.type);
+            const file = source.file instanceof Blob
+                ? source.file
+                : new Blob([source.file]);
+            form.set("file", file, `skill.${source.type}`);
+            return await requestJson(config, `/v1/agents/${encodeURIComponent(agentId)}/skills/upload`, { body: form, method: "POST" }, skillDetailSchema);
+        },
+    };
+}

package/dist/resources/tasks.d.ts

@@ -0,0 +1,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.
+ */
+export declare function createTasksResource(config: HttpConfig): TasksResource;

package/dist/resources/tasks.js

@@ -0,0 +1,63 @@
+import { createTaskResponseSchema, createTaskRunResponseSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunsListResponseSchema, tasksListResponseSchema, } from "../contracts/entities/tasks.js";
+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.
+ */
+export function createTasksResource(config) {
+    return {
+        async create(body) {
+            return await requestJson(config, "/v1/tasks", {
+                json: body,
+                method: "POST",
+            }, createTaskResponseSchema);
+        },
+        async list(options = {}) {
+            return await requestJson(config, "/v1/tasks", {
+                query: {
+                    agentId: options.agentId,
+                    cursor: options.cursor,
+                    limit: options.limit,
+                    // Stryker disable next-line ConditionalExpression: URL serialization omits an undefined query value.
+                    ...(options.userId === undefined ? {} : { userId: options.userId }),
+                },
+            }, tasksListResponseSchema);
+        },
+        async get(taskId) {
+            return await requestJson(config, `/v1/tasks/${taskId}`, {}, taskResponseSchema);
+        },
+        async update(taskId, body) {
+            return await requestJson(config, `/v1/tasks/${taskId}`, {
+                json: body,
+                method: "PATCH",
+            }, taskResponseSchema);
+        },
+        async delete(taskId) {
+            await requestJson(config, `/v1/tasks/${taskId}`, {
+                method: "DELETE",
+            });
+        },
+        async createRun(taskId, body = {}) {
+            return await requestJson(config, `/v1/tasks/${taskId}/runs`, { json: body, method: "POST" }, createTaskRunResponseSchema);
+        },
+        async listRuns(taskId, options = {}) {
+            return await requestJson(config, `/v1/tasks/${taskId}/runs`, { query: { cursor: options.cursor, limit: options.limit } }, taskRunsListResponseSchema);
+        },
+        async getRun(taskId, runId) {
+            return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}`, {}, taskRunResponseSchema);
+        },
+        async runMessages(taskId, runId, options = {}) {
+            return await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/messages`, {
+                query: {
+                    cursor: options.cursor,
+                    after: options.after,
+                    limit: options.limit,
+                },
+            }, taskRunMessagesResponseSchema);
+        },
+        async cancelRun(taskId, runId) {
+            await requestJson(config, `/v1/tasks/${taskId}/runs/${runId}/cancel`, { method: "POST" });
+        },
+    };
+}

package/dist/resources/tenant.d.ts

@@ -0,0 +1,6 @@
+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).
+ */
+export declare function createTenantResource(config: HttpConfig): TenantResource;

package/dist/resources/tenant.js

@@ -0,0 +1,19 @@
+import { tenantSettingsResponseSchema } from "../contracts/entities/tenants.js";
+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).
+ */
+export function createTenantResource(config) {
+    return {
+        async get() {
+            return await requestJson(config, "/v1/tenant", {}, tenantSettingsResponseSchema);
+        },
+        async patch(body) {
+            return await requestJson(config, "/v1/tenant", {
+                json: body,
+                method: "PATCH",
+            }, tenantSettingsResponseSchema);
+        },
+    };
+}

package/dist/resources/usage.d.ts

@@ -0,0 +1,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.
+ */
+export declare function createUsageResource(config: HttpConfig): UsageResource;

package/dist/resources/usage.js

@@ -0,0 +1,19 @@
+import { usageResponseSchema } from "../contracts/entities/usage.js";
+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.
+ */
+export function createUsageResource(config) {
+    return {
+        async get(query = {}) {
+            return await requestJson(config, "/v1/usage", {
+                query,
+            }, usageResponseSchema);
+        },
+        async getForAgent(agentId, query = {}) {
+            return await requestJson(config, `/v1/agents/${agentId}/usage`, { query }, usageResponseSchema);
+        },
+    };
+}

package/dist/resources/workspaces.d.ts

@@ -0,0 +1,2 @@
+import type { HttpConfig, WorkspacesResource } from "../types.ts";
+export declare function createWorkspacesResource(config: HttpConfig): WorkspacesResource;

package/dist/resources/workspaces.js

@@ -0,0 +1,31 @@
+import { workspaceSchema, workspacesListResponseSchema, } from "../contracts/entities/workspaces.js";
+import { requestJson, requestStream } from "../http.js";
+export function createWorkspacesResource(config) {
+    return {
+        async create(body = {}) {
+            return await requestJson(config, "/v1/workspaces", {
+                json: body,
+                method: "POST",
+            }, workspaceSchema);
+        },
+        async delete({ workspaceId }) {
+            const response = await requestStream(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { method: "DELETE" });
+            return response.status === 202 ? "pending" : "completed";
+        },
+        async get({ workspaceId }) {
+            return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, {}, workspaceSchema);
+        },
+        async list(options = {}) {
+            return await requestJson(config, "/v1/workspaces", {
+                query: {
+                    cursor: options.cursor,
+                    limit: options.limit,
+                    userId: options.userId,
+                },
+            }, workspacesListResponseSchema);
+        },
+        async update({ workspaceId, ...body }) {
+            return await requestJson(config, `/v1/workspaces/${encodeURIComponent(workspaceId)}`, { json: body, method: "PUT" }, workspaceSchema);
+        },
+    };
+}