broods 0.2.0 → 0.3.0

package/dist/account.js

@@ -0,0 +1,271 @@
+// @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();
+  }
+}
+export {
+  BroodsAccountClient,
+  BroodsAccountApiError
+};

package/dist/cli/index.js

@@ -686,8 +686,56 @@ async function normalizeConfig(resource, projectRoot) {
   }
   return rewriteValues(resource.config);
 }
+var KNOWN_PROVIDER_NAMES = ["google", "openai", "anthropic", "bedrock", "gateway", "minimax", "custom"];
+var KNOWN_PROVIDER_SETTING_KEYS = new Set([
+  "apiKey",
+  "base_url",
+  "baseURL",
+  "headers",
+  "organization",
+  "project",
+  "name",
+  "region",
+  "accessKeyId",
+  "secretAccessKey",
+  "sessionToken"
+]);
+function suggestProviderKey(key) {
+  const canonical = key.replace(/[^a-z0-9]/gi, "").toLowerCase();
+  if (canonical === "baseurl")
+    return `"base_url" or "baseURL"`;
+  if (canonical === "apikey")
+    return `"apiKey"`;
+  return "";
+}
+function validateProviderConfig(agentName, provider) {
+  if (provider === undefined || provider === null)
+    return;
+  if (typeof provider !== "object" || Array.isArray(provider)) {
+    throw new Error(`Agent "${agentName}" config.provider must be an object`);
+  }
+  for (const [providerName, settings] of Object.entries(provider)) {
+    if (!KNOWN_PROVIDER_NAMES.includes(providerName)) {
+      throw new Error(`Agent "${agentName}" config.provider.${providerName} is not a supported provider (expected one of: ${KNOWN_PROVIDER_NAMES.join(", ")})`);
+    }
+    if (typeof settings !== "object" || settings === null || Array.isArray(settings)) {
+      throw new Error(`Agent "${agentName}" config.provider.${providerName} must be an object`);
+    }
+    const record = settings;
+    for (const key of Object.keys(record)) {
+      if (KNOWN_PROVIDER_SETTING_KEYS.has(key))
+        continue;
+      const suggestion = suggestProviderKey(key);
+      throw new Error(`Agent "${agentName}" config.provider.${providerName} has unknown option "${key}"${suggestion ? ` \u2014 did you mean ${suggestion}?` : ""}`);
+    }
+    if (providerName === "custom" && record.base_url === undefined && record.baseURL === undefined) {
+      throw new Error(`Agent "${agentName}" config.provider.custom.base_url is required (use "base_url" or "baseURL")`);
+    }
+  }
+}
 function normalizeAgentConfig(resource, _projectRoot) {
   const config = { ...resource.config };
+  validateProviderConfig(resource.name, config.provider);
   const inlineHooks = normalizeInlineAgentHooks(resource.name, config.hooks);
   if (inlineHooks) {
     config.hooks = inlineHooks.agentHooksConfig;
@@ -2547,7 +2595,7 @@ function renderStreamPart(part, state) {
 // package.json
 var package_default = {
   name: "broods",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "CLI + TypeScript SDK for the broods agent platform.",
   type: "module",
   license: "MIT",
@@ -2574,6 +2622,10 @@ var package_default = {
     ".": {
       types: "./dist/index.d.ts",
       import: "./dist/index.js"
+    },
+    "./account": {
+      types: "./dist/account.d.ts",
+      import: "./dist/account.js"
     }
   },
   main: "./dist/index.js",
@@ -2602,6 +2654,7 @@ var package_default = {
   devDependencies: {
     "@types/bun": "^1.3.14",
     rollup: "^4.53.3",
+    typescript: "^6.0.3",
     "rollup-plugin-dts": "^6.3.0"
   }
 };