openbot 0.5.5 → 0.5.7

package/dist/app/cli.js

@@ -18,7 +18,7 @@ function checkNodeVersion() {
     }
 }
 checkNodeVersion();
-program.name('openbot').description('OpenBot CLI').version('0.5.5');
+program.name('openbot').description('OpenBot CLI').version('0.5.7');
 program
     .command('start')
     .description('Start the OpenBot harness')

package/dist/services/plugins/plugin-cache.js

@@ -2,8 +2,14 @@
 export const resolvedPluginCache = new Map();
 /** Community plugin ids that have already been logged as loaded once. */
 export const loadedCommunityPlugins = new Set();
+/** Bumped on invalidate so dynamic imports use a fresh Node ESM cache key. */
+const pluginImportRevisions = new Map();
+export function getPluginImportRevision(id) {
+    return pluginImportRevisions.get(id) ?? 0;
+}
 /** Drop a single id from the in-memory resolver cache (e.g. after install/uninstall). */
 export function invalidatePlugin(id) {
     resolvedPluginCache.delete(id);
     loadedCommunityPlugins.delete(id);
+    pluginImportRevisions.set(id, (pluginImportRevisions.get(id) ?? 0) + 1);
 }

package/dist/services/plugins/registry.js

@@ -4,7 +4,7 @@ import { pathToFileURL } from 'node:url';
 import { storagePlugin } from '../../plugins/storage/index.js';
 import { pluginManagerPlugin } from '../../plugins/plugin-manager/index.js';
 import { DEFAULT_PLUGINS_DIR, getBaseDir } from '../../app/config.js';
-import { invalidatePlugin as clearResolvedPluginEntry, loadedCommunityPlugins, resolvedPluginCache, } from './plugin-cache.js';
+import { getPluginImportRevision, invalidatePlugin as clearResolvedPluginEntry, loadedCommunityPlugins, resolvedPluginCache, } from './plugin-cache.js';
 let pluginsDir = null;
 const BUILT_IN = {
     [storagePlugin.id]: storagePlugin,
@@ -59,7 +59,8 @@ export async function resolvePlugin(id) {
     const distPath = path.join(pluginsDir, id, 'dist', 'index.js');
     if (existsSync(distPath)) {
         try {
-            const module = await import(pathToFileURL(distPath).href);
+            const importUrl = `${pathToFileURL(distPath).href}?v=${getPluginImportRevision(id)}`;
+            const module = await import(importUrl);
             const parsed = parsePluginModule(module);
             if (!parsed) {
                 console.warn(`[plugins] Plugin "${id}" at ${distPath} has no recognizable export.`);
@@ -89,6 +90,11 @@ export async function resolvePlugin(id) {
 export function invalidatePlugin(id) {
     clearResolvedPluginEntry(id);
 }
+/** Invalidate and load a community plugin from disk (e.g. after install/upgrade). */
+export async function reloadPlugin(id) {
+    clearResolvedPluginEntry(id);
+    return resolvePlugin(id);
+}
 /** List built-in plugins (for marketplace/registry views). */
 export function listBuiltInPlugins() {
     return Object.values(BUILT_IN);

package/dist/services/plugins/service.js

@@ -4,8 +4,12 @@ import path from 'node:path';
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
 import { DEFAULT_PLUGINS_DIR, DEFAULT_MARKETPLACE_REGISTRY_URL, getBaseDir, loadConfig, } from '../../app/config.js';
+import { reloadPlugin } from './registry.js';
 import { invalidatePlugin } from './plugin-cache.js';
 const execAsync = promisify(exec);
+function isLatestVersionAlias(version) {
+    return version.trim().toLowerCase() === 'latest';
+}
 const DEFAULT_MARKETPLACE_AGENTS = [];
 const DEFAULT_MARKETPLACE_CHANNELS = [];
 function isRecord(value) {
@@ -155,7 +159,8 @@ export const pluginService = {
         if (existsSync(path.join(finalPath, 'package.json'))) {
             try {
                 const pkgJson = JSON.parse(await fs.readFile(path.join(finalPath, 'package.json'), 'utf-8'));
-                if (!version || pkgJson.version === version) {
+                const wantsLatest = version !== undefined && isLatestVersionAlias(version);
+                if (!version || (!wantsLatest && pkgJson.version === version)) {
                     console.log(`[plugins] ${packageName}${version ? `@${version}` : ''} is already installed.`);
                     return { name: pkgJson.name, version: pkgJson.version };
                 }
@@ -186,7 +191,7 @@ export const pluginService = {
                 console.warn(`[plugins] Failed to run npm install in ${finalPath}:`, e);
             }
             const pkgJson = JSON.parse(await fs.readFile(path.join(finalPath, 'package.json'), 'utf-8'));
-            invalidatePlugin(packageName);
+            await reloadPlugin(packageName);
             return { name: pkgJson.name, version: pkgJson.version };
         }
         catch (error) {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbot",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "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.5"
+    "push": "fly deploy --build-only --push --config deploy/fly.toml -a openbot-runtime --image-label v0.5.7"
   },
   "bin": {
     "openbot": "./dist/app/cli.js"

package/src/app/cli.ts

@@ -27,7 +27,7 @@ function checkNodeVersion() {
 
 checkNodeVersion();
 
-program.name('openbot').description('OpenBot CLI').version('0.5.5');
+program.name('openbot').description('OpenBot CLI').version('0.5.7');
 
 program
   .command('start')

package/src/app/types.ts

@@ -875,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/services/plugins/plugin-cache.ts

@@ -6,8 +6,16 @@ export const resolvedPluginCache = new Map<string, Plugin>();
 /** Community plugin ids that have already been logged as loaded once. */
 export const loadedCommunityPlugins = new Set<string>();
 
+/** Bumped on invalidate so dynamic imports use a fresh Node ESM cache key. */
+const pluginImportRevisions = new Map<string, number>();
+
+export function getPluginImportRevision(id: string): number {
+  return pluginImportRevisions.get(id) ?? 0;
+}
+
 /** Drop a single id from the in-memory resolver cache (e.g. after install/uninstall). */
 export function invalidatePlugin(id: string): void {
   resolvedPluginCache.delete(id);
   loadedCommunityPlugins.delete(id);
+  pluginImportRevisions.set(id, (pluginImportRevisions.get(id) ?? 0) + 1);
 }

package/src/services/plugins/registry.ts

@@ -7,6 +7,7 @@ import { storagePlugin } from '../../plugins/storage/index.js';
 import { pluginManagerPlugin } from '../../plugins/plugin-manager/index.js';
 import { DEFAULT_PLUGINS_DIR, getBaseDir } from '../../app/config.js';
 import {
+  getPluginImportRevision,
   invalidatePlugin as clearResolvedPluginEntry,
   loadedCommunityPlugins,
   resolvedPluginCache,
@@ -27,9 +28,7 @@ const BUILT_IN: Record<string, Plugin> = {
 export type ParsedPluginModule = Omit<Plugin, 'id'>;
 
 /** Normalize a dynamically imported plugin module. Supports `plugin`, `default`. */
-export function parsePluginModule(
-  module: Record<string, unknown>,
-): ParsedPluginModule | null {
+export function parsePluginModule(module: Record<string, unknown>): ParsedPluginModule | null {
   const raw =
     (module.plugin as Record<string, unknown> | undefined) ??
     (module.default as Record<string, unknown> | undefined);
@@ -82,7 +81,8 @@ export async function resolvePlugin(id: string): Promise<Plugin | null> {
 
   if (existsSync(distPath)) {
     try {
-      const module = await import(pathToFileURL(distPath).href);
+      const importUrl = `${pathToFileURL(distPath).href}?v=${getPluginImportRevision(id)}`;
+      const module = await import(importUrl);
       const parsed = parsePluginModule(module as Record<string, unknown>);
       if (!parsed) {
         console.warn(`[plugins] Plugin "${id}" at ${distPath} has no recognizable export.`);
@@ -114,6 +114,12 @@ export function invalidatePlugin(id: string): void {
   clearResolvedPluginEntry(id);
 }
 
+/** Invalidate and load a community plugin from disk (e.g. after install/upgrade). */
+export async function reloadPlugin(id: string): Promise<Plugin | null> {
+  clearResolvedPluginEntry(id);
+  return resolvePlugin(id);
+}
+
 /** List built-in plugins (for marketplace/registry views). */
 export function listBuiltInPlugins(): Plugin[] {
   return Object.values(BUILT_IN);

package/src/services/plugins/service.ts

@@ -10,6 +10,7 @@ import {
   loadConfig,
   resolvePath,
 } from '../../app/config.js';
+import { reloadPlugin } from './registry.js';
 import { invalidatePlugin } from './plugin-cache.js';
 import { PluginRef } from './types.js';
 
@@ -17,9 +18,14 @@ const execAsync = promisify(exec);
 
 export interface InstallOptions {
   packageName: string;
+  /** Concrete semver, or `"latest"` to refresh from npm. Omit to ensure present without upgrading. */
   version?: string;
 }
 
+function isLatestVersionAlias(version: string): boolean {
+  return version.trim().toLowerCase() === 'latest';
+}
+
 export interface InstalledPlugin {
   /** npm package name; doubles as the plugin id used everywhere else. */
   name: string;
@@ -229,7 +235,8 @@ export const pluginService = {
         const pkgJson = JSON.parse(
           await fs.readFile(path.join(finalPath, 'package.json'), 'utf-8'),
         );
-        if (!version || pkgJson.version === version) {
+        const wantsLatest = version !== undefined && isLatestVersionAlias(version);
+        if (!version || (!wantsLatest && pkgJson.version === version)) {
           console.log(
             `[plugins] ${packageName}${version ? `@${version}` : ''} is already installed.`,
           );
@@ -267,7 +274,7 @@ export const pluginService = {
 
       const pkgJson = JSON.parse(await fs.readFile(path.join(finalPath, 'package.json'), 'utf-8'));
 
-      invalidatePlugin(packageName);
+      await reloadPlugin(packageName);
       return { name: pkgJson.name, version: pkgJson.version };
     } catch (error) {
       console.error(`[plugins] Failed to install ${packageName}:`, error);