broods 0.1.1 → 0.2.1

package/dist/index.js

@@ -47,6 +47,8 @@ function isObservabilityClientMessage(v) {
     const backfill = msg["backfill"];
     if (backfill !== undefined && (typeof backfill !== "number" || !Number.isSafeInteger(backfill) || backfill < 0 || backfill > MAX_OBSERVABILITY_BACKFILL))
       return false;
+    if (msg["liveOnly"] !== undefined && typeof msg["liveOnly"] !== "boolean")
+      return false;
     const minLevel = msg["minLevel"];
     if (minLevel !== undefined && minLevel !== "INFO" && minLevel !== "WARN" && minLevel !== "ERROR")
       return false;
@@ -59,7 +61,7 @@ function isObservabilityClientMessage(v) {
   return false;
 }
 // src/runtime-config.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, statSync } from "fs";
 import { join as join2, resolve } from "path";
 
 // src/config.ts
@@ -71,16 +73,19 @@ var GENERATED_DIR = "_generated";
 var USER_CONFIG_PATH = join(homedir(), ".broods", "config.json");
 async function readStoredAuth() {
   const envToken = process.env.BROODS_TOKEN;
-  const envUrl = process.env.BROODS_DASHBOARD_URL;
-  if (envToken && envUrl) {
+  const envConvexUrl = process.env.BROODS_BASE_URL;
+  if (envToken && envConvexUrl) {
     return {
-      dashboardUrl: envUrl,
+      baseUrl: stripTrailingSlash(envConvexUrl),
       token: envToken,
       createdAt: new Date().toISOString()
     };
   }
   try {
-    return JSON.parse(await readFile(USER_CONFIG_PATH, "utf8"));
+    const stored = JSON.parse(await readFile(USER_CONFIG_PATH, "utf8"));
+    if (typeof stored.baseUrl !== "string" || !stored.baseUrl)
+      return null;
+    return stored;
   } catch {
     return null;
   }
@@ -95,12 +100,15 @@ function stripTrailingSlash(value) {
 }
 
 // src/runtime-config.ts
-var loadedEnvForCwd = null;
+var envFileCache = new Map;
+var realEnvSnapshot = new Set(Object.keys(process.env));
+var loadedFromFiles = new Set;
 function loadBroodsRuntimeConfig(cwd = process.cwd()) {
   loadEnvFiles(cwd);
   const stored = readStoredAuthSync();
   return {
     dashboardUrl: process.env.BROODS_DASHBOARD_URL ?? stored?.dashboardUrl,
+    baseUrl: process.env.BROODS_BASE_URL ?? stored?.baseUrl,
     token: process.env.BROODS_TOKEN ?? stored?.token,
     project: process.env.BROODS_PROJECT,
     environment: process.env.BROODS_ENVIRONMENT
@@ -108,17 +116,23 @@ function loadBroodsRuntimeConfig(cwd = process.cwd()) {
 }
 function loadEnvFiles(cwd) {
   const root = resolve(cwd);
-  if (loadedEnvForCwd === root)
-    return;
-  loadedEnvForCwd = root;
-  const originallySet = new Set(Object.keys(process.env));
+  const forceReload = process.env.BROODS_RELOAD_ENV === "1";
   for (const file of [".env", ".env.local"]) {
     const path = join2(root, file);
-    if (!existsSync(path))
+    if (!existsSync(path)) {
+      envFileCache.delete(path);
       continue;
+    }
+    const mtimeMs = statSync(path).mtimeMs;
+    const cached = envFileCache.get(path);
+    if (cached && cached.mtimeMs === mtimeMs)
+      continue;
+    envFileCache.set(path, { mtimeMs });
     for (const [key, value] of Object.entries(parseEnv(readFileSync(path, "utf8")))) {
-      if (!originallySet.has(key))
+      if (forceReload || !realEnvSnapshot.has(key) || loadedFromFiles.has(key)) {
         process.env[key] = value;
+        loadedFromFiles.add(key);
+      }
     }
   }
 }
@@ -153,10 +167,11 @@ function unquoteEnvValue(value) {
 function readStoredAuthSync() {
   try {
     const value = JSON.parse(readFileSync(USER_CONFIG_PATH, "utf8"));
-    if (typeof value.dashboardUrl !== "string" || typeof value.token !== "string")
+    if (typeof value.baseUrl !== "string" || typeof value.token !== "string")
       return null;
     return {
-      dashboardUrl: stripTrailingSlash(value.dashboardUrl),
+      baseUrl: stripTrailingSlash(value.baseUrl),
+      ...typeof value.dashboardUrl === "string" ? { dashboardUrl: stripTrailingSlash(value.dashboardUrl) } : {},
       token: value.token
     };
   } catch {
@@ -185,7 +200,7 @@ class BroodsClient {
       const name = refOrName;
       const id = agentId ?? "";
       if (!id)
-        throw new Error(`Agent ${name} is missing a generated id. Run broods deploy first.`);
+        throw new Error(`Agent ${name} is missing a generated id. Run broods dev --once or broods deploy to sync it first.`);
       return {
         id,
         run: (input) => this.run({ ...input, agentName: name, agentId: id }),
@@ -195,7 +210,7 @@ class BroodsClient {
     }
     const ref = refOrName;
     if (!ref.id)
-      throw new Error(`Agent ${ref.name} is missing a generated id. Run broods deploy first.`);
+      throw new Error(`Agent ${ref.name} is missing a generated id. Run broods dev --once or broods deploy to sync it first.`);
     return {
       id: ref.id,
       run: (input) => this.run(ref, input),
@@ -246,7 +261,8 @@ class BroodsClient {
       agentName: refOrInput.name
     } : refOrInput;
     const body = directRunBody(input, "async");
-    const response = await this.fetchJson(`${this.baseUrl}/async`, {
+    const targetUrl = maybeInput ? this.scopedUrl(refOrInput, "/async") : `${this.baseUrl}/async`;
+    const response = await this.fetchJson(targetUrl, {
       method: "POST",
       headers: this.apiKeyHeaders(),
       body: JSON.stringify(body)
@@ -289,7 +305,7 @@ class BroodsClient {
     throw new Error("Polling timeout");
   }
   async createCron(input) {
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons`, {
       method: "POST",
       headers: this.apiKeyHeaders(),
       body: JSON.stringify(resolveCronInput(input))
@@ -299,7 +315,7 @@ class BroodsClient {
     return await response.json();
   }
   async listCrons() {
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons`, {
       method: "GET",
       headers: this.apiKeyHeaders()
     });
@@ -309,7 +325,7 @@ class BroodsClient {
     return payload.crons;
   }
   async getCron(cronId) {
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons/${encodeURIComponent(cronId)}`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons/${encodeURIComponent(cronId)}`, {
       method: "GET",
       headers: this.apiKeyHeaders()
     });
@@ -324,7 +340,7 @@ class BroodsClient {
     if (options.limit !== undefined)
       params.set("limit", String(options.limit));
     const suffix = params.size > 0 ? `?${params}` : "";
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons/${encodeURIComponent(cronId)}/runs${suffix}`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons/${encodeURIComponent(cronId)}/runs${suffix}`, {
       method: "GET",
       headers: this.apiKeyHeaders()
     });
@@ -334,7 +350,7 @@ class BroodsClient {
     return payload.runs;
   }
   async updateCron(cronId, patch) {
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons/${encodeURIComponent(cronId)}`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons/${encodeURIComponent(cronId)}`, {
       method: "PATCH",
       headers: this.apiKeyHeaders(),
       body: JSON.stringify(patch)
@@ -344,7 +360,7 @@ class BroodsClient {
     return await response.json();
   }
   async deleteCron(cronId) {
-    const response = await this.fetchJson(`${this.baseUrl}/accounts/me/crons/${encodeURIComponent(cronId)}`, {
+    const response = await this.fetchJson(`${this.baseUrl}/v1/crons/${encodeURIComponent(cronId)}`, {
       method: "DELETE",
       headers: this.apiKeyHeaders()
     });
@@ -355,11 +371,11 @@ class BroodsClient {
     const payload = await response.json();
     return payload.deleted;
   }
-  scopedUrl(ref) {
+  scopedUrl(ref, suffix = "") {
     if (ref.projectSlug && ref.environmentSlug && ref.endpointId) {
-      return `${this.baseUrl}/v1/${encodeURIComponent(ref.projectSlug)}` + `/agents/${encodeURIComponent(ref.environmentSlug)}/${encodeURIComponent(ref.endpointId)}`;
+      return `${this.baseUrl}/v1/${encodeURIComponent(ref.projectSlug)}` + `/agents/${encodeURIComponent(ref.environmentSlug)}/${encodeURIComponent(ref.endpointId)}${suffix}`;
     }
-    return this.baseUrl;
+    return `${this.baseUrl}${suffix}`;
   }
   async openStream(body, targetUrl) {
     if (this.apiKey) {
@@ -515,7 +531,6 @@ function formatStreamError(error) {
 var DEFAULT_CONNECT_TIMEOUT_MS = 2000;
 var WS_CONNECTING = 0;
 var WS_OPEN = 1;
-var LAMBDA_FUNCTION_URL_HOST_RE = /\.lambda-url\.[a-z0-9-]+\.on\.aws$/i;
 
 class BroodsWebSocketClient {
   baseUrl;
@@ -524,7 +539,7 @@ class BroodsWebSocketClient {
   connectTimeoutMs;
   constructor(options = {}) {
     loadBroodsRuntimeConfig();
-    this.baseUrl = normalizeWebSocketServiceUrl(options.baseUrl || process.env.BROODS_WEBSOCKET_URL || options.host || process.env.BROODS_BASE_URL || process.env.BROODS_HOST || DEFAULT_CORE_BASE_URL);
+    this.baseUrl = normalizeWebSocketServiceUrl(options.baseUrl || options.host || process.env.BROODS_BASE_URL || process.env.BROODS_HOST || DEFAULT_CORE_BASE_URL);
     this.apiKey = options.apiKey || process.env.BROODS_API_KEY || "";
     if (!this.apiKey)
       throw new Error("BroodsWebSocketClient requires apiKey or BROODS_API_KEY.");
@@ -706,10 +721,6 @@ function normalizeWebSocketServiceUrl(value) {
   return normalizeHttpServiceUrl(trimmed);
 }
 function webSocketAccessError(baseUrl) {
-  const host = new URL(baseUrl).hostname;
-  if (LAMBDA_FUNCTION_URL_HOST_RE.test(host)) {
-    return new Error(`Cannot access the WebSocket service at ${baseUrl}. AWS Lambda Function URLs do not support WebSocket upgrades; ` + "set BROODS_WEBSOCKET_URL or BROODS_HOST to the deployed WebSocket gateway URL instead.");
-  }
   return new Error(`Cannot access the WebSocket service at ${baseUrl}.`);
 }
 function parseServerMessage(data) {
@@ -754,11 +765,16 @@ function defineResource(kind, input) {
   };
 }
 function defineChannel(type, config) {
+  const { workspaceScope, ...channelConfig } = config;
   return {
     [CHANNEL_MARKER]: true,
     kind: "channel",
     type,
-    config
+    ...workspaceScope ? { workspaceScope } : {},
+    config: {
+      ...channelConfig,
+      ...workspaceScope ? { workspaceScope } : {}
+    }
   };
 }
 function defineTelegramChannel(config) {
@@ -774,11 +790,7 @@ function defineDiscordChannel(config) {
   return defineChannel("discord", config);
 }
 function definePancakeChannel(config) {
-  const { ignoreTagIds, ...channelConfig } = config;
-  return defineChannel("pancake", {
-    ...channelConfig,
-    ...ignoreTagIds === undefined ? {} : { options: { ignoreTagIds } }
-  });
+  return defineChannel("pancake", config);
 }
 function defineZaloChannel(config) {
   return defineChannel("zalo", config);
@@ -801,6 +813,9 @@ function defineSkill(input) {
 function defineTool(input) {
   return defineResource("tool", input);
 }
+function definePolicy(input) {
+  return defineResource("policy", input);
+}
 function defineCron(input) {
   return defineResource("cron", input);
 }
@@ -830,6 +845,7 @@ export {
   defineSlackChannel,
   defineSkill,
   defineSandbox,
+  definePolicy,
   definePancakeChannel,
   defineGitHubChannel,
   defineDiscordChannel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "broods",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "CLI + TypeScript SDK for the broods agent platform.",
   "type": "module",
   "license": "MIT",
@@ -42,12 +42,20 @@
     "pack:check": "bun run build && npm pack --dry-run",
     "test": "bun test"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "dependencies": {
-    "ai": "^6.0.195"
+    "@chat-adapter/discord": "^4.31.0",
+    "@chat-adapter/github": "^4.31.0",
+    "@chat-adapter/slack": "^4.31.0",
+    "@chat-adapter/telegram": "^4.31.0",
+    "ai": "^7.0.11"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
     "rollup": "^4.53.3",
+    "typescript": "^6.0.3",
     "rollup-plugin-dts": "^6.3.0"
   }
 }