broods 0.2.1 → 0.3.0

package/dist/index.js

@@ -1,4 +1,270 @@
 // @bun
+// src/account.ts
+var DEFAULT_ACCOUNT_BASE_URL = "https://gateway.broods.app";
+
+class BroodsAccountApiError extends Error {
+  status;
+  body;
+  constructor(method, path, status, body) {
+    super(`${method} ${path} failed with ${status}: ${body}`);
+    this.name = "BroodsAccountApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+function envVar(name) {
+  return typeof process !== "undefined" ? process?.env?.[name] : undefined;
+}
+
+class BroodsAccountClient {
+  baseUrl;
+  accountSecret;
+  fetchImpl;
+  constructor(options = {}) {
+    const baseUrl = options.baseUrl ?? envVar("BROODS_BASE_URL") ?? DEFAULT_ACCOUNT_BASE_URL;
+    const accountSecret = options.accountSecret ?? envVar("BROODS_ACCOUNT_SECRET");
+    if (!accountSecret)
+      throw new Error("BroodsAccountClient requires an accountSecret (or BROODS_ACCOUNT_SECRET).");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.accountSecret = accountSecret;
+    this.fetchImpl = options.fetch ?? fetch;
+  }
+  async getAccount() {
+    const result = await this.request("GET", "/v1/account");
+    if (!result)
+      throw new BroodsAccountApiError("GET", "/v1/account", 404, "Account not found");
+    return result.account;
+  }
+  async updateAccount(patch) {
+    const result = await this.request("PATCH", "/v1/account", patch);
+    return result?.account ?? null;
+  }
+  async rotateSecret() {
+    const result = await this.request("POST", "/v1/account/rotate-secret");
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/account/rotate-secret", 404, "Account not found");
+    return result;
+  }
+  async deleteAccount() {
+    const result = await this.request("DELETE", "/v1/account");
+    return result ?? { deleted: false };
+  }
+  webhookUrl(accountId, agentId, channelType) {
+    const segments = [accountId, agentId, channelType].map(encodeURIComponent);
+    return `${this.baseUrl}/webhooks/${segments.join("/")}`;
+  }
+  async listAgents() {
+    const result = await this.request("GET", "/v1/agents");
+    return result?.agents ?? [];
+  }
+  async createAgent(input) {
+    const result = await this.request("POST", "/v1/agents", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/agents", 404, "Not found");
+    return result;
+  }
+  async getAgent(agentId) {
+    return await this.request("GET", `/v1/agents/${encodeURIComponent(agentId)}`);
+  }
+  async updateAgent(agentId, patch) {
+    return await this.request("PATCH", `/v1/agents/${encodeURIComponent(agentId)}`, patch);
+  }
+  async deleteAgent(agentId) {
+    const result = await this.request("DELETE", `/v1/agents/${encodeURIComponent(agentId)}`);
+    return result?.deleted ?? false;
+  }
+  async listCrons() {
+    const result = await this.request("GET", "/v1/crons");
+    return result?.crons ?? [];
+  }
+  async createCron(input) {
+    const result = await this.request("POST", "/v1/crons", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/crons", 404, "Not found");
+    return result;
+  }
+  async getCron(cronId) {
+    return await this.request("GET", `/v1/crons/${encodeURIComponent(cronId)}`);
+  }
+  async updateCron(cronId, patch) {
+    return await this.request("PATCH", `/v1/crons/${encodeURIComponent(cronId)}`, patch);
+  }
+  async deleteCron(cronId) {
+    const result = await this.request("DELETE", `/v1/crons/${encodeURIComponent(cronId)}`);
+    return result?.deleted ?? false;
+  }
+  async listCronRuns(cronId, options = {}) {
+    const query = options.limit !== undefined ? `?limit=${options.limit}` : "";
+    const result = await this.request("GET", `/v1/crons/${encodeURIComponent(cronId)}/runs${query}`);
+    return result?.runs ?? [];
+  }
+  async listWorkspaces() {
+    const result = await this.request("GET", "/v1/workspaces");
+    return result?.workspaces ?? [];
+  }
+  async createWorkspace(input) {
+    const result = await this.request("POST", "/v1/workspaces", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/workspaces", 404, "Not found");
+    return result;
+  }
+  async getWorkspace(workspaceId) {
+    return await this.request("GET", `/v1/workspaces/${encodeURIComponent(workspaceId)}`);
+  }
+  async updateWorkspace(workspaceId, patch) {
+    return await this.request("PATCH", `/v1/workspaces/${encodeURIComponent(workspaceId)}`, patch);
+  }
+  async deleteWorkspace(workspaceId) {
+    const result = await this.request("DELETE", `/v1/workspaces/${encodeURIComponent(workspaceId)}`);
+    return result?.deleted ?? false;
+  }
+  async listWorkspaceFiles(workspaceId) {
+    const result = await this.request("GET", `/v1/workspaces/${encodeURIComponent(workspaceId)}/files`);
+    return result?.files ?? [];
+  }
+  async getWorkspaceFileUrl(workspaceId, path) {
+    const query = `?path=${encodeURIComponent(path)}`;
+    const result = await this.request("GET", `/v1/workspaces/${encodeURIComponent(workspaceId)}/files${query}`);
+    return result?.url ?? null;
+  }
+  async uploadWorkspaceFile(workspaceId, input) {
+    const path = `/v1/workspaces/${encodeURIComponent(workspaceId)}/files`;
+    const result = await this.request("POST", path, input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", path, 404, "Workspace not found");
+    return result.file;
+  }
+  async renameWorkspaceFile(workspaceId, path, newPath) {
+    const result = await this.request("PATCH", `/v1/workspaces/${encodeURIComponent(workspaceId)}/files`, { path, newPath });
+    return result?.renamed ?? false;
+  }
+  async deleteWorkspaceFile(workspaceId, path) {
+    const result = await this.request("DELETE", `/v1/workspaces/${encodeURIComponent(workspaceId)}/files`, { path });
+    return result?.deleted ?? false;
+  }
+  async listSandboxes() {
+    const result = await this.request("GET", "/v1/sandboxes");
+    return result?.sandboxes ?? [];
+  }
+  async createSandbox(input) {
+    const result = await this.request("POST", "/v1/sandboxes", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/sandboxes", 404, "Not found");
+    return result;
+  }
+  async getSandbox(sandboxId) {
+    return await this.request("GET", `/v1/sandboxes/${encodeURIComponent(sandboxId)}`);
+  }
+  async updateSandbox(sandboxId, patch) {
+    return await this.request("PATCH", `/v1/sandboxes/${encodeURIComponent(sandboxId)}`, patch);
+  }
+  async deleteSandbox(sandboxId) {
+    const result = await this.request("DELETE", `/v1/sandboxes/${encodeURIComponent(sandboxId)}`);
+    return result?.deleted ?? false;
+  }
+  async suspendSandbox(sandboxId, reservationKey) {
+    return await this.sandboxAction(sandboxId, "suspend", { reservationKey });
+  }
+  async resumeSandbox(sandboxId, reservationKey) {
+    return await this.sandboxAction(sandboxId, "resume", { reservationKey });
+  }
+  async terminateSandbox(sandboxId, reservationKey) {
+    return await this.sandboxAction(sandboxId, "terminate", { reservationKey });
+  }
+  async snapshotSandbox(sandboxId, reservationKey, name) {
+    return await this.sandboxAction(sandboxId, "snapshot", { reservationKey, name });
+  }
+  async openSandboxTerminal(sandboxId, reservationKey) {
+    return await this.sandboxAction(sandboxId, "terminal", { reservationKey });
+  }
+  async listTools() {
+    const result = await this.request("GET", "/v1/tools");
+    return result?.tools ?? [];
+  }
+  async createTool(input) {
+    const result = await this.request("POST", "/v1/tools", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/tools", 404, "Not found");
+    return result;
+  }
+  async getTool(toolId) {
+    return await this.request("GET", `/v1/tools/${encodeURIComponent(toolId)}`);
+  }
+  async updateTool(toolId, patch) {
+    return await this.request("PATCH", `/v1/tools/${encodeURIComponent(toolId)}`, patch);
+  }
+  async deleteTool(toolId) {
+    const result = await this.request("DELETE", `/v1/tools/${encodeURIComponent(toolId)}`);
+    return result?.deleted ?? false;
+  }
+  async listPolicies() {
+    const result = await this.request("GET", "/v1/policies");
+    return result?.policies ?? [];
+  }
+  async createPolicy(input) {
+    const result = await this.request("POST", "/v1/policies", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/policies", 404, "Not found");
+    return result;
+  }
+  async getPolicy(policyId) {
+    return await this.request("GET", `/v1/policies/${encodeURIComponent(policyId)}`);
+  }
+  async updatePolicy(policyId, patch) {
+    return await this.request("PATCH", `/v1/policies/${encodeURIComponent(policyId)}`, patch);
+  }
+  async deletePolicy(policyId) {
+    const result = await this.request("DELETE", `/v1/policies/${encodeURIComponent(policyId)}`);
+    return result?.deleted ?? false;
+  }
+  async listSkills() {
+    const result = await this.request("GET", "/v1/skills");
+    return result?.skills ?? [];
+  }
+  async createSkill(input) {
+    const result = await this.request("POST", "/v1/skills", input);
+    if (!result)
+      throw new BroodsAccountApiError("POST", "/v1/skills", 404, "Not found");
+    return result;
+  }
+  async getSkill(skillName) {
+    return await this.request("GET", `/v1/skills/${encodeURIComponent(skillName)}`);
+  }
+  async uploadSkill(skillName, input) {
+    const path = `/v1/skills/${encodeURIComponent(skillName)}`;
+    const result = await this.request("PUT", path, input);
+    if (!result)
+      throw new BroodsAccountApiError("PUT", path, 404, "Skill not found");
+    return result;
+  }
+  async deleteSkill(skillName) {
+    const result = await this.request("DELETE", `/v1/skills/${encodeURIComponent(skillName)}`);
+    return result?.deleted ?? false;
+  }
+  async sandboxAction(sandboxId, action, body) {
+    const path = `/v1/sandboxes/${encodeURIComponent(sandboxId)}/${action}`;
+    const result = await this.request("POST", path, body);
+    if (!result)
+      throw new BroodsAccountApiError("POST", path, 404, "Sandbox not found");
+    return result;
+  }
+  async request(method, path, body) {
+    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.accountSecret}`,
+        ...body !== undefined ? { "Content-Type": "application/json" } : {}
+      },
+      ...body !== undefined ? { body: JSON.stringify(body) } : {}
+    });
+    if (response.status === 404)
+      return null;
+    if (!response.ok) {
+      throw new BroodsAccountApiError(method, path, response.status, await response.text());
+    }
+    return await response.json();
+  }
+}
 // src/run-input.ts
 function resolveRunEvents(input) {
   if (input.events && input.input !== undefined) {
@@ -857,5 +1123,7 @@ export {
   MAX_OBSERVABILITY_BACKFILL,
   DEFAULT_CORE_BASE_URL,
   BroodsWebSocketClient,
-  BroodsClient
+  BroodsClient,
+  BroodsAccountClient,
+  BroodsAccountApiError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "broods",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI + TypeScript SDK for the broods agent platform.",
   "type": "module",
   "license": "MIT",
@@ -27,6 +27,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./account": {
+      "types": "./dist/account.d.ts",
+      "import": "./dist/account.js"
     }
   },
   "main": "./dist/index.js",