@owloops/browserbird 1.2.10 → 1.3.0

package/README.md

@@ -4,7 +4,7 @@
 
 # BrowserBird
 
-Self-hosted AI agent for Slack with a real browser, a scheduler, and a web dashboard.
+Self-hosted AI agent orchestrator with a real browser, a cron scheduler, and a web dashboard.
 
 [![License: FSL-1.1-MIT](https://img.shields.io/badge/license-FSL--1.1--MIT-blue?style=flat-square)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/@owloops/browserbird?style=flat-square)](https://www.npmjs.com/package/@owloops/browserbird)
@@ -25,7 +25,7 @@ Self-hosted AI agent for Slack with a real browser, a scheduler, and a web dashb
    </tr>
 </table>
 
-Talk to an AI agent in Slack threads. It can browse the web with a real Chromium browser you can watch live through VNC, run scheduled tasks on a cron, and keep persistent sessions across conversations. BrowserBird is the orchestration layer; the agent CLI ([claude](https://docs.anthropic.com/en/docs/claude-code/overview), [opencode](https://github.com/anomalyco/opencode)) handles reasoning, memory, tools, and sub-agents.
+Schedule AI agents to run on a cron, browse the web with a real Chromium browser you can watch live through VNC, and manage everything from a web dashboard or the CLI. Optionally connect Slack for conversational threads and slash commands. BrowserBird is the orchestration layer; the agent CLI ([claude](https://docs.anthropic.com/en/docs/claude-code/overview), [opencode](https://github.com/anomalyco/opencode)) handles reasoning, memory, tools, and sub-agents.
 
 Built by [Owloops](https://github.com/Owloops), building browser automation tools since 2020.
 
@@ -46,7 +46,7 @@ These are starting points. Every bird has a full AI agent (Claude Code or openco
 
 ## Installation
 
-On first run, open the web UI and complete the onboarding wizard. It walks through Slack tokens, agent config, and API keys.
+On first run, open the web UI and complete the onboarding wizard. It walks through agent config, API keys, and optional integrations (Slack, browser).
 
 ### Docker (recommended)
 
@@ -63,7 +63,7 @@ The browser runs in **persistent** mode by default: logins and cookies are saved
 
 [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/browserbird-1)
 
-## Slack
+## Slack (Optional)
 
 [![Create Slack App](https://img.shields.io/badge/Slack-Create_App-4A154B?style=for-the-badge&logo=slack&logoColor=white)](https://api.slack.com/apps?new_app=1&manifest_json=%7B%22display_information%22%3A%7B%22name%22%3A%22BrowserBird%22%2C%22description%22%3A%22A%20self-hosted%20AI%20assistant%20in%20Slack%2C%20with%20a%20real%20browser%20and%20a%20scheduler.%22%2C%22background_color%22%3A%22%231a1a2e%22%7D%2C%22features%22%3A%7B%22assistant_view%22%3A%7B%22assistant_description%22%3A%22A%20self-hosted%20AI%20assistant%20in%20Slack%2C%20with%20a%20real%20browser%20and%20a%20scheduler.%22%7D%2C%22app_home%22%3A%7B%22home_tab_enabled%22%3Atrue%2C%22messages_tab_enabled%22%3Atrue%2C%22messages_tab_read_only_enabled%22%3Afalse%7D%2C%22bot_user%22%3A%7B%22display_name%22%3A%22BrowserBird%22%2C%22always_online%22%3Atrue%7D%2C%22slash_commands%22%3A%5B%7B%22command%22%3A%22%2Fbird%22%2C%22description%22%3A%22Manage%20BrowserBird%20birds%22%2C%22usage_hint%22%3A%22list%20%7C%20fly%20%7C%20logs%20%7C%20enable%20%7C%20disable%20%7C%20create%20%7C%20status%22%2C%22should_escape%22%3Afalse%7D%5D%7D%2C%22oauth_config%22%3A%7B%22scopes%22%3A%7B%22bot%22%3A%5B%22app_mentions%3Aread%22%2C%22assistant%3Awrite%22%2C%22channels%3Ahistory%22%2C%22channels%3Aread%22%2C%22chat%3Awrite%22%2C%22files%3Aread%22%2C%22files%3Awrite%22%2C%22groups%3Ahistory%22%2C%22groups%3Aread%22%2C%22im%3Ahistory%22%2C%22im%3Aread%22%2C%22im%3Awrite%22%2C%22mpim%3Ahistory%22%2C%22mpim%3Aread%22%2C%22reactions%3Aread%22%2C%22reactions%3Awrite%22%2C%22users%3Aread%22%2C%22commands%22%5D%7D%7D%2C%22settings%22%3A%7B%22event_subscriptions%22%3A%7B%22bot_events%22%3A%5B%22app_mention%22%2C%22assistant_thread_context_changed%22%2C%22assistant_thread_started%22%2C%22message.channels%22%2C%22message.groups%22%2C%22message.im%22%2C%22message.mpim%22%5D%7D%2C%22interactivity%22%3A%7B%22is_enabled%22%3Atrue%7D%2C%22org_deploy_enabled%22%3Afalse%2C%22socket_mode_enabled%22%3Atrue%2C%22token_rotation_enabled%22%3Afalse%7D%7D)
 
@@ -114,7 +114,7 @@ The top-level `timezone` field (IANA format, default `"UTC"`) is used for cron s
 }
 ```
 
-- `botToken`, `appToken`: Required. Bot user OAuth token and app-level token for Socket Mode
+- `botToken`, `appToken`: Optional. Bot user OAuth token and app-level token for Socket Mode. Required only for Slack integration
 - `requireMention`: Only respond in channels when `@mentioned`; DMs always respond
 - `coalesce.debounceMs`: Wait N ms after last message before dispatching (groups rapid messages)
 - `coalesce.bypassDms`: Skip debouncing for DMs
@@ -247,8 +247,8 @@ Authentication is handled via the web UI. On first visit, you create an account.
 
 | Variable                  | Description                                                                                      |
 | ------------------------- | ------------------------------------------------------------------------------------------------ |
-| `SLACK_BOT_TOKEN`         | Bot user OAuth token                                                                             |
-| `SLACK_APP_TOKEN`         | App-level token for Socket Mode                                                                  |
+| `SLACK_BOT_TOKEN`         | Bot user OAuth token (optional, for Slack integration)                                           |
+| `SLACK_APP_TOKEN`         | App-level token for Socket Mode (optional, for Slack integration)                                |
 | `ANTHROPIC_API_KEY`       | Anthropic API key (pay-per-token). Used by both claude and opencode providers                    |
 | `CLAUDE_CODE_OAUTH_TOKEN` | OAuth token for claude provider only (uses your Claude Pro/Max subscription)                     |
 | `BROWSER_MODE`            | `persistent` (default) or `isolated`. Requires container restart                                 |
@@ -295,6 +295,16 @@ options:
 run 'browserbird <command> --help' for command-specific options.
 ```
 
+### Standalone CLI Workflow
+
+BrowserBird works without Slack. Create a bird, trigger it, and check results from the terminal:
+
+```bash
+browserbird birds add --schedule "0 9 * * *" --prompt "Check Hacker News for AI news and summarize"
+browserbird birds fly <name>
+browserbird birds flights <name>
+```
+
 ## Web UI
 
 Runs at `http://localhost:18800` by default.

package/dist/index.mjs

@@ -122,8 +122,8 @@ function unknownSubcommand(subcommand, command, validCommands) {
 /** @fileoverview ASCII banner displayed on daemon startup and in help text. */
 const pkg = createRequire(import.meta.url)("../package.json");
 const buildInfo = [];
-buildInfo.push(`commit: ${"bddda226a98294fa5e272a0f50b3e8f52dab935f".substring(0, 7)}`);
-buildInfo.push(`built: 2026-03-09T14:46:24+04:00`);
+buildInfo.push(`commit: ${"b06564aa22755ababe5972e05230d453baa632e9".substring(0, 7)}`);
+buildInfo.push(`built: 2026-03-09T18:52:55+04:00`);
 const buildString = buildInfo.length > 0 ? ` (${buildInfo.join(", ")})` : "";
 const VERSION = `browserbird ${pkg.version}${buildString}`;
 const BIRD = [
@@ -267,31 +267,6 @@ function loadRawConfig(configPath) {
 	return deepMerge(DEFAULTS, parsed);
 }
 /**
-* Checks whether both Slack tokens are present and resolvable.
-* Literal strings must be non-empty; `"env:VAR"` references must point to a set env var.
-*/
-function hasSlackTokens(configPath) {
-	const filePath = configPath ?? resolve("browserbird.json");
-	if (!existsSync(filePath)) return false;
-	let parsed;
-	try {
-		parsed = JSON.parse(readFileSync(filePath, "utf-8"));
-	} catch {
-		return false;
-	}
-	const slack = parsed["slack"];
-	if (!slack) return false;
-	return isTokenResolvable(slack["botToken"]) && isTokenResolvable(slack["appToken"]);
-}
-function isTokenResolvable(value) {
-	if (typeof value !== "string" || !value) return false;
-	if (value.startsWith("env:")) {
-		const envKey = value.slice(4);
-		return !!process.env[envKey];
-	}
-	return true;
-}
-/**
 * When the browser is enabled but no explicit mcpConfigPath is set, generates
 * a Playwright MCP config file using novncHost as the SSE server hostname.
 * Writes to `<configDir>/mcp.json` and mutates `config.browser.mcpConfigPath`.
@@ -925,6 +900,7 @@ function sanitizeConfig(config) {
 			model: a.model,
 			fallbackModel: a.fallbackModel ?? null,
 			maxTurns: a.maxTurns,
+			processTimeoutMs: a.processTimeoutMs ?? null,
 			systemPrompt: a.systemPrompt,
 			channels: a.channels
 		})),
@@ -1231,7 +1207,7 @@ function buildRoutes(getConfig, startedAt, getDeps, options) {
 					broadcastSSE("invalidate", { resource: "secrets" });
 					json(res, {
 						success: true,
-						requiresRestart: true
+						requiresRestart: false
 					});
 				} catch (err) {
 					jsonError(res, `Failed to save Slack tokens: ${err instanceof Error ? err.message : String(err)}`, 500);
@@ -2534,7 +2510,7 @@ function cleanEnv() {
 function spawnProvider(provider, options, signal) {
 	const mod = PROVIDERS[provider];
 	const cmd = mod.buildCommand(options);
-	const timeoutMs = options.agent.processTimeoutMs ?? 3e5;
+	const timeoutMs = options.agent.processTimeoutMs ?? options.globalTimeoutMs ?? 3e5;
 	logger.debug(`spawning: ${cmd.binary} ${cmd.args.join(" ")} (timeout: ${timeoutMs}ms)`);
 	const baseEnv = cleanEnv();
 	if (cmd.env) for (const [k, v] of Object.entries(cmd.env)) if (v === "") delete baseEnv[k];
@@ -2982,7 +2958,8 @@ function startScheduler(config, signal, deps) {
 				message: payload.prompt,
 				agent,
 				mcpConfigPath: config.browser.mcpConfigPath,
-				timezone: config.timezone
+				timezone: config.timezone,
+				globalTimeoutMs: config.sessions.processTimeoutMs
 			}, signal);
 			if (payload.channelId) logMessage(payload.channelId, null, agent.id, "in", payload.prompt);
 			let result = "";
@@ -3298,7 +3275,8 @@ function createHandler(client, config, signal, getTeamId) {
 				sessionId: existingSessionId,
 				agent,
 				mcpConfigPath: config.browser.mcpConfigPath,
-				timezone: config.timezone
+				timezone: config.timezone,
+				globalTimeoutMs: config.sessions.processTimeoutMs
 			}, signal);
 			lock.killCurrent = kill;
 			client.setStatus?.(channelId, threadTs, "is thinking...").catch(() => {});
@@ -3942,14 +3920,6 @@ function setupShutdown() {
 	process.on("SIGINT", () => shutdown("SIGINT"));
 	process.on("SIGTERM", () => shutdown("SIGTERM"));
 }
-const stubDeps = {
-	slackConnected: () => false,
-	activeProcessCount: () => 0,
-	serviceHealth: () => ({
-		agent: { available: false },
-		browser: { connected: false }
-	})
-};
 async function startDaemon(options) {
 	setupShutdown();
 	logger.setMode("daemon");
@@ -3962,56 +3932,68 @@ async function startDaemon(options) {
 	clearBrowserLock();
 	startWorker(controller.signal);
 	loadDotEnv(envPath);
-	let currentConfig = loadRawConfig(configPath);
+	let currentConfig;
 	let slackHandle = null;
-	let setupMode = true;
+	let schedulerStarted = false;
+	let slackStarted = false;
+	let healthStarted = false;
+	try {
+		currentConfig = loadConfig(configPath);
+		ensureMcpConfig(currentConfig, configDir);
+	} catch (err) {
+		logger.warn(`config validation failed: ${err instanceof Error ? err.message : String(err)}`);
+		currentConfig = loadRawConfig(configPath);
+	}
 	const getConfig = () => currentConfig;
-	const getDeps = () => {
-		if (setupMode) return stubDeps;
-		return {
-			slackConnected: () => slackHandle?.isConnected() ?? false,
-			activeProcessCount: () => slackHandle?.activeCount() ?? 0,
-			serviceHealth: () => getServiceHealth(currentConfig)
-		};
-	};
-	const startFull = (config) => {
+	const getDeps = () => ({
+		slackConnected: () => slackHandle?.isConnected() ?? false,
+		activeProcessCount: () => slackHandle?.activeCount() ?? 0,
+		serviceHealth: () => getServiceHealth(currentConfig)
+	});
+	let activated = false;
+	const activateLayers = (config) => {
 		currentConfig = config;
-		setupMode = false;
-		logger.info("connecting to slack...");
-		slackHandle = createSlackChannel(config, controller.signal);
-		logger.info("starting scheduler...");
-		startScheduler(config, controller.signal, { postToSlack: (channel, text, opts) => slackHandle.postMessage(channel, text, opts) });
-		slackHandle.start().catch((err) => {
-			logger.error(`slack failed to start: ${err instanceof Error ? err.message : String(err)}`);
-		});
-		startHealthChecks(getConfig, controller.signal);
-		logger.success("browserbird orchestrator started");
-		logger.info(`agents: ${config.agents.map((a) => a.id).join(", ")}`);
-		logger.info(`max concurrent sessions: ${config.sessions.maxConcurrent}`);
-		if (config.browser.enabled) logger.info(`browser mode: ${getBrowserMode()}`);
+		if (!schedulerStarted && config.agents.length > 0) {
+			logger.info("starting scheduler...");
+			startScheduler(config, controller.signal, { postToSlack: (channel, text, opts) => slackHandle ? slackHandle.postMessage(channel, text, opts) : Promise.resolve() });
+			schedulerStarted = true;
+		}
+		if (!healthStarted) {
+			startHealthChecks(getConfig, controller.signal);
+			healthStarted = true;
+		}
+		if (!slackStarted && config.slack.botToken && config.slack.appToken) {
+			logger.info("connecting to slack...");
+			slackHandle = createSlackChannel(config, controller.signal);
+			slackHandle.start().catch((err) => {
+				logger.error(`slack failed to start: ${err instanceof Error ? err.message : String(err)}`);
+			});
+			slackStarted = true;
+		}
+		if (!activated) {
+			logger.success("browserbird orchestrator started");
+			logger.info(`agents: ${config.agents.map((a) => a.id).join(", ") || "none"}`);
+			if (!slackStarted) logger.info("slack: not configured");
+			logger.info(`max concurrent sessions: ${config.sessions.maxConcurrent}`);
+			if (config.browser.enabled) logger.info(`browser mode: ${getBrowserMode()}`);
+			activated = true;
+		}
 	};
 	const onLaunch = async () => {
 		loadDotEnv(envPath);
 		const config = loadConfig(configPath);
 		ensureMcpConfig(config, configDir);
-		if (!config.slack.botToken || !config.slack.appToken) throw new Error("Slack tokens are required to launch");
-		startFull(config);
+		activateLayers(config);
 	};
 	const reloadConfig = () => {
 		loadDotEnv(envPath);
-		currentConfig = loadConfig(configPath);
-		ensureMcpConfig(currentConfig, configDir);
+		const config = loadConfig(configPath);
+		ensureMcpConfig(config, configDir);
+		activateLayers(config);
 		logger.info("config reloaded");
 	};
-	if (hasSlackTokens(configPath)) {
-		currentConfig = loadConfig(configPath);
-		ensureMcpConfig(currentConfig, configDir);
-		setSetting("onboarding_completed", "true");
-		startFull(currentConfig);
-	} else {
-		setSetting("onboarding_completed", "");
-		logger.info("starting in setup mode (onboarding not completed)");
-	}
+	if (currentConfig.agents.length > 0) activateLayers(currentConfig);
+	else logger.info("no agents configured");
 	let webServer = null;
 	const webConfig = getConfig();
 	if (webConfig.web.enabled) {
@@ -4024,7 +4006,6 @@ async function startDaemon(options) {
 		});
 		await webServer.start();
 	}
-	if (setupMode) logger.info("waiting for onboarding to complete via web UI");
 	await new Promise((resolvePromise) => {
 		controller.signal.addEventListener("abort", () => {
 			resolvePromise();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@owloops/browserbird",
-  "version": "1.2.10",
-  "description": "Self-hosted AI agent for Slack with a real browser, a scheduler, and a web dashboard",
+  "version": "1.3.0",
+  "description": "AI agent orchestrator with a real browser, a cron scheduler, and a web dashboard",
   "type": "module",
   "bin": {
     "browserbird": "./bin/browserbird"
@@ -28,12 +28,14 @@
     "prepublishOnly": "npm run lint && npm run format:check && npm run typecheck && npm run build && cd web && npm ci && npm run build"
   },
   "keywords": [
-    "slack",
-    "claude",
-    "claude-code",
-    "orchestrator",
     "cli",
-    "bot"
+    "ai-agent",
+    "orchestrator",
+    "browser-automation",
+    "scheduler",
+    "cron",
+    "claude",
+    "playwright"
   ],
   "author": "Owloops",
   "license": "FSL-1.1-MIT",