openbot 0.5.5 → 0.5.6

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.6');
 program
     .command('start')
     .description('Start the OpenBot harness')

package/dist/services/plugins/service.js

@@ -6,6 +6,9 @@ import { promisify } from 'node:util';
 import { DEFAULT_PLUGINS_DIR, DEFAULT_MARKETPLACE_REGISTRY_URL, getBaseDir, loadConfig, } from '../../app/config.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 +158,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 };
                 }

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.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.5"
+    "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

@@ -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.6');
 
 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/service.ts

@@ -17,9 +17,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 +234,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.`,
           );