openbot 0.5.4 → 0.5.6

package/docs/plugins.md

@@ -28,7 +28,7 @@ export interface Plugin {
 export interface PluginContext {
   agentId: string;
   agentDetails: AgentDetails;
-  config: Record<string, unknown>;   // from AGENT.md plugins[].config
+  config: Record<string, unknown>; // from AGENT.md plugins[].config
   storage: Storage;
   tools: Record<string, ToolDefinition>; // merged from all tool plugins
 }
@@ -49,16 +49,16 @@ model as the tool result (`history.ts`). Structured fields (e.g. `list`,
 
 ## Built-in plugins
 
-| Id              | Role       | Notes                                                     |
-| --------------- | ---------- | --------------------------------------------------------- |
-| `openbot`       | Runtime    | Standard batteries-included OpenBot agent runtime.        |
-| `claude-code`   | Runtime    | Claude Agent SDK; owns its own tool loop                  |
-| `gemini-cli`    | Runtime    | Google `gemini` CLI in headless mode                      |
-| `bash`          | Tool       | `bash` (inbuilt in `openbot`)                             |
-| `storage`       | Tool       | `create_channel`, `patch_*`, ... (inbuilt in `openbot`)   |
-| `memory`        | Tool       | `remember`, `recall`, `forget` (inbuilt in `openbot`)     |
-| `todo`          | Tool       | `todo_write`, `todo_read` (inbuilt in `openbot`)          |
-| `plugin-manager`| Infra      | Marketplace list, npm plugin install/uninstall, agent install |
+| Id               | Role    | Notes                                                         |
+| ---------------- | ------- | ------------------------------------------------------------- |
+| `openbot`        | Runtime | Standard batteries-included OpenBot agent runtime.            |
+| `claude-code`    | Runtime | Claude Agent SDK; owns its own tool loop                      |
+| `gemini-cli`     | Runtime | Google `gemini` CLI in headless mode                          |
+| `bash`           | Tool    | `bash` (inbuilt in `openbot`)                                 |
+| `storage`        | Tool    | `create_channel`, `patch_*`, ... (inbuilt in `openbot`)       |
+| `memory`         | Tool    | `remember`, `recall`, `forget` (inbuilt in `openbot`)         |
+| `todo`           | Tool    | `todo_write`, `todo_read` (inbuilt in `openbot`)              |
+| `plugin-manager` | Infra   | Marketplace list, npm plugin install/uninstall, agent install |
 
 ## Batteries-included: `openbot` runtime
 
@@ -96,7 +96,9 @@ plugins:
 
 On first use OpenBot installs the package into
 `~/.openbot/plugins/<npm-name>/` (scoped packages live under
-`~/.openbot/plugins/@scope/<name>/`).
+`~/.openbot/plugins/@scope/<name>/`). Publish `action:plugin:install` with no
+`version` to ensure a plugin is present; pass `version: "latest"` to upgrade an
+existing install to npm's latest tag, or a concrete semver to pin.
 
 ## Approval plugin
 

package/docs/templates/AGENT.example.md

@@ -8,27 +8,21 @@ name: Example Agent
 description: One-line description shown in agent pickers and lists.
 
 # Plugins compose the agent. Order matters for tool collisions (first wins).
-# At least one plugin must handle `agent:invoke` (a "runtime" plugin like
-# `openbot`, `claude-code`, or `gemini-cli`). Tool plugins like `bash`,
-# `delegation`, and `storage-tools` contribute tools to whichever runtime
-# plugin can consume them.
+# At least one plugin must handle `agent:invoke`. Use the monolithic runtime:
+# `@meetopenbot/openbot` (batteries-included: shell, memory, todo, storage tools,
+# delegation, approval, preview).
 #
-# Built-in plugin ids: openbot, claude-code, gemini-cli, bash, delegation,
-# storage-tools, approval.
+# Core built-in plugin ids: storage, plugin-manager.
 #
 # Community plugins are referenced by their npm package name (e.g.
-# `openbot-plugin-search` or `@scope/openbot-plugin-foo`) and are auto-installed
+# `openbot-plugin-search` or `@meetopenbot/openbot`) and are auto-installed
 # on first use into ~/.openbot/plugins/<id>/.
 plugins:
-  - id: openbot
+  - id: '@meetopenbot/openbot'
     config:
       model: openai/gpt-4o-mini
-  - id: bash
-  - id: delegation
-  - id: storage
-  - id: approval
-    config:
-      actions: [action:shell_exec]
+      approval:
+        actions: [action:shell_exec]
 ---
 
 <!--

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbot",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "private": false,
   "type": "module",
   "engines": {
@@ -11,7 +11,7 @@
     "build": "tsc && mkdir -p dist/assets && cp src/assets/icon.svg dist/assets/icon.svg",
     "start": "node dist/app/cli.js start",
     "format": "prettier --write .",
-    "push": "fly deploy --build-only --push --config deploy/fly.toml -a openbot-runtime --image-label v0.5.4"
+    "push": "fly deploy --build-only --push --config deploy/fly.toml -a openbot-runtime --image-label v0.5.6"
   },
   "bin": {
     "openbot": "./dist/app/cli.js"

package/src/app/cli.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { bootstrap } from './bootstrap.js';
+import { ensureDefaultStack } from './ensure-default-stack.js';
 import { startServer } from './server.js';
 
 const program = new Command();
@@ -26,7 +27,7 @@ function checkNodeVersion() {
 
 checkNodeVersion();
 
-program.name('openbot').description('OpenBot CLI').version('0.5.4');
+program.name('openbot').description('OpenBot CLI').version('0.5.6');
 
 program
   .command('start')
@@ -34,6 +35,7 @@ program
   .option('-p, --port <number>', 'Port to listen on')
   .action(async (options) => {
     await bootstrap();
+    await ensureDefaultStack();
     await startServer(options);
   });
 

package/src/app/cloud-mode.ts

@@ -1,35 +1,20 @@
 import { ORCHESTRATOR_AGENT_ID } from './agent-ids.js';
 
-/** Platform-managed OpenBot (Fly + integrations proxy). Self-hosted when unset. */
+/** Platform-managed OpenBot (Fly). Self-hosted when unset. */
 export const isCloudMode = (): boolean => process.env.OPENBOT_CLOUD_MODE === '1';
 
-/** Platform-managed coordinator model for cloud workspaces. */
-export const COORDINATOR_MODEL = 'openbot/coordinator-1';
+/** How the cloud system agent authenticates to LLM providers. */
+export type OpenbotAuthMode = 'credits' | 'byok';
 
-/** Default cloud system agent model. */
-export const CLOUD_SYSTEM_MODEL = COORDINATOR_MODEL;
-
-export interface CloudIntegrationsConfig {
-  baseUrl: string;
-  token: string;
-}
-
-export function getCloudIntegrationsConfig(): CloudIntegrationsConfig | null {
-  if (!isCloudMode()) return null;
-
-  const baseUrl = process.env.OPENBOT_INTEGRATIONS_BASE_URL?.trim();
-  const token = process.env.OPENBOT_INTEGRATIONS_TOKEN?.trim();
-  if (!baseUrl || !token) return null;
-
-  return { baseUrl: baseUrl.replace(/\/$/, ''), token };
-}
+/** Default cloud openbot plugin auth mode. */
+export const DEFAULT_CLOUD_OPENBOT_AUTH_MODE: OpenbotAuthMode = 'credits';
 
 export function isCloudSystemAgent(agentId: string): boolean {
   return isCloudMode() && agentId === ORCHESTRATOR_AGENT_ID;
 }
 
-export function resolveCloudSystemModel(configModel: string | undefined): string {
-  return configModel?.trim() || COORDINATOR_MODEL;
+export function parseOpenbotAuthMode(value: unknown): OpenbotAuthMode {
+  return value === 'byok' ? 'byok' : 'credits';
 }
 
 export function assertCloudSystemAgentPluginsMutable(

package/src/app/ensure-default-stack.ts

@@ -0,0 +1,63 @@
+import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import matter from 'gray-matter';
+import { ORCHESTRATOR_AGENT_ID } from './agent-ids.js';
+import { DEFAULT_SYSTEM_AGENT_MODEL, OPENBOT_PLUGIN_ID } from './openbot-plugin.js';
+import { DEFAULT_CLOUD_OPENBOT_AUTH_MODE, isCloudMode } from './cloud-mode.js';
+import { DEFAULT_AGENTS_DIR, getBaseDir } from './config.js';
+import { pluginService } from '../services/plugins/service.js';
+
+function systemAgentMdPath(): string {
+  return path.join(getBaseDir(), DEFAULT_AGENTS_DIR, ORCHESTRATOR_AGENT_ID, 'AGENT.md');
+}
+
+function defaultSystemPluginConfig(): Record<string, unknown> {
+  const config: Record<string, unknown> = {
+    model: DEFAULT_SYSTEM_AGENT_MODEL,
+  };
+  if (isCloudMode()) {
+    config.authMode = DEFAULT_CLOUD_OPENBOT_AUTH_MODE;
+  }
+  return config;
+}
+
+async function ensureOpenbotPluginInstalled(): Promise<void> {
+  if (await pluginService.isInstalled(OPENBOT_PLUGIN_ID)) {
+    return;
+  }
+
+  console.log(`[bootstrap] Installing ${OPENBOT_PLUGIN_ID} from npm`);
+  await pluginService.install({ packageName: OPENBOT_PLUGIN_ID });
+}
+
+async function ensureSystemAgentMaterialized(): Promise<void> {
+  const agentMdPath = systemAgentMdPath();
+  if (existsSync(agentMdPath)) {
+    return;
+  }
+
+  const agentDir = path.dirname(agentMdPath);
+  await fs.mkdir(agentDir, { recursive: true });
+
+  const frontmatter = {
+    name: 'OpenBot',
+    description: 'First-party orchestration agent for OpenBot.',
+    plugins: [
+      {
+        id: OPENBOT_PLUGIN_ID,
+        config: defaultSystemPluginConfig(),
+      },
+    ],
+  };
+
+  const content = matter.stringify('', frontmatter);
+  await fs.writeFile(agentMdPath, content, 'utf-8');
+  console.log(`[bootstrap] Materialized system agent at ${agentMdPath}`);
+}
+
+/** Install the default agent plugin from npm and materialize the system agent on first boot. */
+export async function ensureDefaultStack(): Promise<void> {
+  await ensureOpenbotPluginInstalled();
+  await ensureSystemAgentMaterialized();
+}

package/src/app/openbot-plugin.ts

@@ -0,0 +1,5 @@
+/** npm package id for the monolithic OpenBot agent runtime plugin. */
+export const OPENBOT_PLUGIN_ID = '@meetopenbot/openbot';
+
+/** Default model for the materialized system agent. */
+export const DEFAULT_SYSTEM_AGENT_MODEL = 'openai/gpt-5.4-mini';

package/src/app/server.ts

@@ -9,7 +9,7 @@ const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
 import { generateId } from 'melony';
 import { getBaseDir, loadConfig } from '../app/config.js';
-import { isCloudMode, getCloudIntegrationsConfig } from './cloud-mode.js';
+import { isCloudMode } from './cloud-mode.js';
 import { ActiveRunsSnapshotEvent, OpenBotEvent, OpenBotState } from './types.js';
 import { processService } from '../services/process.js';
 import { runAgent, STATE_AGENT_ID, ORCHESTRATOR_AGENT_ID } from '../harness/index.js';
@@ -48,10 +48,7 @@ export async function startServer(options: ServerOptions = {}) {
   processService.syncWorkspaceVariablesToProcessEnv();
 
   if (isCloudMode()) {
-    const integrations = getCloudIntegrationsConfig();
-    console.log(
-      `[server] Cloud mode enabled${integrations ? '' : ' (integrations proxy env not set)'}`,
-    );
+    console.log('[server] Cloud mode enabled');
   }
 
   const openBotDir = getBaseDir();

package/src/app/types.ts

@@ -9,7 +9,7 @@ import {
 } from '../services/plugins/domain.js';
 import type { PluginRef } from '../services/plugins/types.js';
 import type { MemoryRecord } from '../plugins/memory/service.js';
-import type { TodoList } from '../plugins/todo/service.js';
+import type { TodoList } from '../services/todo/types.js';
 
 export interface OpenBotState {
   agentId: string;
@@ -324,7 +324,7 @@ export type PatchThreadDetailsResultEvent = BaseEvent & {
   type: 'action:patch_thread_details:result';
   data: {
     success: boolean;
-    updatedFields: ('state')[];
+    updatedFields: 'state'[];
   };
 };
 
@@ -658,12 +658,7 @@ export type UIWidgetField = {
   defaultValue?: unknown;
 };
 
-export type UIWidgetListItemStatusVariant =
-  | 'default'
-  | 'success'
-  | 'warning'
-  | 'danger'
-  | 'info';
+export type UIWidgetListItemStatusVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';
 
 export type UIWidgetListItem = {
   id: string;
@@ -880,6 +875,7 @@ export type InstallPluginEvent = BaseEvent & {
   type: 'action:plugin:install';
   data: {
     name: string;
+    /** Concrete semver, or `"latest"` to upgrade an existing install. Omit to ensure present. */
     version?: string;
   };
 };

package/src/harness/index.ts

@@ -8,6 +8,7 @@ import { ToolDefinition } from '../services/plugins/types.js';
 import { abortRegistry, abortKey } from '../services/abort.js';
 import { loadConfig } from '../app/config.js';
 import { getPublicBaseUrl } from '../plugins/storage/files.js';
+import { createPluginHost } from '../services/plugins/host.js';
 
 export { STATE_AGENT_ID, ORCHESTRATOR_AGENT_ID };
 
@@ -119,6 +120,8 @@ export async function runAgent(options: RunAgentOptions): Promise<void> {
 
     const builder = melony<OpenBotState, OpenBotEvent>().initialState(state);
 
+    const pluginHost = createPluginHost(runAgent);
+
     for (const ref of pluginRefs) {
       const plugin = await resolvePlugin(ref.id);
       if (!plugin) continue;
@@ -132,6 +135,7 @@ export async function runAgent(options: RunAgentOptions): Promise<void> {
           tools,
           publicBaseUrl,
           abortSignal,
+          host: pluginHost,
         }),
       );
     }