openbot 0.5.6 → 0.5.8

package/dist/app/cli.js

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

package/dist/plugins/storage/service.js

@@ -12,7 +12,7 @@ import { listBuiltInPlugins, parsePluginModule } from '../../services/plugins/re
 import { enrichOpenbotPluginDescriptor, listRegistryModelOptions, } from '../../services/plugins/model-registry.js';
 import { processService } from '../../services/process.js';
 import { memoryService } from '../memory/service.js';
-import { guessMimeType, resolveChannelFile, statChannelFile, } from './files.js';
+import { guessMimeType, resolveChannelFile, statChannelFile } from './files.js';
 const resolveBaseDir = () => getBaseDir();
 const ENTITY_SVG_CANDIDATE_NAMES = ['avatar.svg', 'icon.svg', 'image.svg', 'logo.svg'];
 const toSvgDataUrl = (svg) => `data:image/svg+xml;base64,${Buffer.from(svg, 'utf-8').toString('base64')}`;
@@ -115,10 +115,7 @@ function mergeCloudSystemPluginRefs(defaults, diskRefs) {
     ];
 }
 /** No `openbot` / `bash` — storage-side effects and infra plugins only. */
-const STATE_DEFAULT_PLUGINS = [
-    { id: 'storage' },
-    { id: 'plugin-manager' },
-];
+const STATE_DEFAULT_PLUGINS = [{ id: 'storage' }, { id: 'plugin-manager' }];
 const STATE_AGENT_INSTRUCTIONS = 'Built-in infra agent for deterministic state reads. No conversational model is attached; handle storage, approvals, memory, and plugin marketplace events.';
 function getSystemAgentDetails(overrides) {
     const defaultPlugins = isCloudMode() ? getCloudSystemDefaultPlugins() : SYSTEM_DEFAULT_PLUGINS;
@@ -289,12 +286,37 @@ const toVariablesRecord = (raw) => {
         String(value ?? ''),
     ]));
 };
+let cachedRuntimeVersion;
+const getRuntimeVersion = () => {
+    if (cachedRuntimeVersion !== undefined)
+        return cachedRuntimeVersion || undefined;
+    try {
+        const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '../../../package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        cachedRuntimeVersion = typeof pkg.version === 'string' ? pkg.version : '';
+    }
+    catch {
+        cachedRuntimeVersion = '';
+    }
+    return cachedRuntimeVersion || undefined;
+};
+const readPluginPackageVersion = async (pluginDir) => {
+    try {
+        const pkg = JSON.parse(await fs.readFile(path.join(pluginDir, 'package.json'), 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
 const listBuiltInPluginDescriptors = async () => {
+    const version = getRuntimeVersion();
     return listBuiltInPlugins().map((plugin) => ({
         id: plugin.id,
         name: plugin.name,
         description: plugin.description,
         builtIn: true,
+        version,
         image: plugin.image,
         configSchema: plugin.configSchema,
         createdAt: new Date(),
@@ -356,12 +378,16 @@ const listPluginsFromDisk = async () => {
             const parsed = parsePluginModule(module);
             if (!parsed)
                 return null;
-            const image = await resolveEntityImageDataUrl(pluginDir);
+            const [image, version] = await Promise.all([
+                resolveEntityImageDataUrl(pluginDir),
+                readPluginPackageVersion(pluginDir),
+            ]);
             return {
                 id,
                 name: parsed.name || id,
                 description: parsed.description || '',
                 builtIn: false,
+                version,
                 image: parsed.image || image,
                 configSchema: parsed.configSchema,
                 createdAt: new Date(),
@@ -480,7 +506,7 @@ export const storageService = {
                 channel.recentThreads = allThreads
                     .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())
                     .slice(0, 5);
-                const threadsUnseen = allThreads.some(t => t.hasUnseenMessages);
+                const threadsUnseen = allThreads.some((t) => t.hasUnseenMessages);
                 channel.hasUnseenMessages = rootUnseen || threadsUnseen;
             }
             catch {
@@ -521,8 +547,7 @@ export const storageService = {
         finalState.cwd = resolvedCwd;
         await fs.mkdir(resolvedCwd, { recursive: true });
         await fs.mkdir(channelDir, { recursive: true });
-        await fs.writeFile(specPath, spec?.trim() ||
-            `# ${normalizedChannelId}\n\n`);
+        await fs.writeFile(specPath, spec?.trim() || `# ${normalizedChannelId}\n\n`);
         await writeJsonFileAtomically(statePath, finalState);
     },
     ensureChannel: async ({ channelId, spec, initialState, cwd, }) => {
@@ -684,9 +709,7 @@ export const storageService = {
                 console.error(`Failed to read thread state for channel ${channelId} thread ${threadId}`, error);
             }
         }
-        const threadName = isRecord(state) && typeof state.name === 'string'
-            ? state.name.trim()
-            : '';
+        const threadName = isRecord(state) && typeof state.name === 'string' ? state.name.trim() : '';
         return {
             id: threadId,
             name: threadName || threadId,
@@ -840,9 +863,7 @@ export const storageService = {
             const discoveredImage = await resolveEntityImageDataUrl(agentDir);
             const stats = await fs.stat(agentMdPath);
             const pluginRefs = parsePluginRefs(data.plugins);
-            const frontmatterImage = typeof data.image === 'string' && data.image.trim() !== ''
-                ? data.image.trim()
-                : undefined;
+            const frontmatterImage = typeof data.image === 'string' && data.image.trim() !== '' ? data.image.trim() : undefined;
             diskDetails = {
                 id: agentId,
                 name: typeof data.name === 'string' ? data.name : agentId,
@@ -964,8 +985,7 @@ export const storageService = {
         // Built-in agents merge disk overlays with code defaults on read; on write, partial
         // updates (e.g. plugins-only) must still persist a complete AGENT.md.
         if (isBuiltinOverlayAgentId(agentId)) {
-            const pluginRefs = plugins ??
-                (nextData.plugins !== undefined ? parsePluginRefs(nextData.plugins) : undefined);
+            const pluginRefs = plugins ?? (nextData.plugins !== undefined ? parsePluginRefs(nextData.plugins) : undefined);
             const diskOverrides = {};
             if (typeof nextData.name === 'string' && nextData.name.trim() !== '') {
                 diskOverrides.name = nextData.name;
@@ -1170,7 +1190,7 @@ export const storageService = {
             typeof raw === 'object' &&
             'variables' in raw &&
             Array.isArray(raw.variables)) {
-            const entries = (raw.variables)
+            const entries = raw.variables
                 .filter((v) => typeof v?.key === 'string')
                 .map((v) => [v.key, { value: String(v.value ?? ''), secret: !!v.secret }]);
             return Object.fromEntries(entries);
@@ -1236,9 +1256,7 @@ export const storageService = {
         if (!baseCwd) {
             throw new Error('Channel has no CWD configured');
         }
-        const targetDir = subPath
-            ? resolveChannelFile(baseCwd, subPath)
-            : resolvePath(baseCwd);
+        const targetDir = subPath ? resolveChannelFile(baseCwd, subPath) : resolvePath(baseCwd);
         const entries = await fs.readdir(targetDir, { withFileTypes: true });
         return entries
             .filter((e) => !e.name.startsWith('.'))

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,6 +4,7 @@ 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) {
@@ -190,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbot",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "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.6"
+    "push": "fly deploy --build-only --push --config deploy/fly.toml -a openbot-runtime --image-label v0.5.8"
   },
   "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.6');
+program.name('openbot').description('OpenBot CLI').version('0.5.8');
 
 program
   .command('start')

package/src/plugins/storage/service.ts

@@ -40,11 +40,7 @@ import {
 import { OpenBotEvent, OpenBotState } from '../../app/types.js';
 import { processService } from '../../services/process.js';
 import { memoryService } from '../memory/service.js';
-import {
-  guessMimeType,
-  resolveChannelFile,
-  statChannelFile,
-} from './files.js';
+import { guessMimeType, resolveChannelFile, statChannelFile } from './files.js';
 
 const resolveBaseDir = () => getBaseDir();
 
@@ -142,10 +138,7 @@ function getCloudSystemDefaultPlugins(): PluginRef[] {
   });
 }
 
-function mergeCloudSystemPluginRefs(
-  defaults: PluginRef[],
-  diskRefs: PluginRef[],
-): PluginRef[] {
+function mergeCloudSystemPluginRefs(defaults: PluginRef[], diskRefs: PluginRef[]): PluginRef[] {
   const defaultOpenbot = defaults.find((ref) => ref.id === OPENBOT_PLUGIN_ID);
   const diskOpenbot = diskRefs.find((ref) => ref.id === OPENBOT_PLUGIN_ID);
 
@@ -163,10 +156,7 @@ function mergeCloudSystemPluginRefs(
 }
 
 /** No `openbot` / `bash` — storage-side effects and infra plugins only. */
-const STATE_DEFAULT_PLUGINS: PluginRef[] = [
-  { id: 'storage' },
-  { id: 'plugin-manager' },
-];
+const STATE_DEFAULT_PLUGINS: PluginRef[] = [{ id: 'storage' }, { id: 'plugin-manager' }];
 
 const STATE_AGENT_INSTRUCTIONS =
   'Built-in infra agent for deterministic state reads. No conversational model is attached; handle storage, approvals, memory, and plugin marketplace events.';
@@ -177,8 +167,7 @@ function getSystemAgentDetails(overrides?: Partial<AgentDetails>): AgentDetails
     id: SYSTEM_AGENT_ID,
     name: 'OpenBot',
     image: getBundledSystemAgentImage(),
-    description:
-      'First-party orchestration agent for OpenBot.',
+    description: 'First-party orchestration agent for OpenBot.',
     instructions: '',
     plugins: defaultPlugins.map((ref) => ref.id),
     pluginRefs: defaultPlugins,
@@ -211,9 +200,10 @@ function getSystemAgentDetails(overrides?: Partial<AgentDetails>): AgentDetails
     };
   }
 
-  const refs = overrides.pluginRefs && overrides.pluginRefs.length > 0
-    ? overrides.pluginRefs
-    : defaults.pluginRefs;
+  const refs =
+    overrides.pluginRefs && overrides.pluginRefs.length > 0
+      ? overrides.pluginRefs
+      : defaults.pluginRefs;
 
   return {
     ...defaults,
@@ -243,9 +233,10 @@ function getStateAgentDetails(overrides?: Partial<AgentDetails>): AgentDetails {
 
   if (!overrides) return defaults;
 
-  const refs = overrides.pluginRefs && overrides.pluginRefs.length > 0
-    ? overrides.pluginRefs
-    : defaults.pluginRefs;
+  const refs =
+    overrides.pluginRefs && overrides.pluginRefs.length > 0
+      ? overrides.pluginRefs
+      : defaults.pluginRefs;
 
   const diskInstructions = overrides.instructions?.trim();
   const instructions =
@@ -374,12 +365,42 @@ const toVariablesRecord = (raw: unknown): Record<string, string> => {
   );
 };
 
+let cachedRuntimeVersion: string | undefined;
+
+const getRuntimeVersion = (): string | undefined => {
+  if (cachedRuntimeVersion !== undefined) return cachedRuntimeVersion || undefined;
+  try {
+    const pkgPath = path.join(
+      path.dirname(fileURLToPath(import.meta.url)),
+      '../../../package.json',
+    );
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as { version?: unknown };
+    cachedRuntimeVersion = typeof pkg.version === 'string' ? pkg.version : '';
+  } catch {
+    cachedRuntimeVersion = '';
+  }
+  return cachedRuntimeVersion || undefined;
+};
+
+const readPluginPackageVersion = async (pluginDir: string): Promise<string | undefined> => {
+  try {
+    const pkg = JSON.parse(await fs.readFile(path.join(pluginDir, 'package.json'), 'utf-8')) as {
+      version?: unknown;
+    };
+    return typeof pkg.version === 'string' ? pkg.version : undefined;
+  } catch {
+    return undefined;
+  }
+};
+
 const listBuiltInPluginDescriptors = async (): Promise<PluginDescriptor[]> => {
+  const version = getRuntimeVersion();
   return listBuiltInPlugins().map((plugin) => ({
     id: plugin.id,
     name: plugin.name,
     description: plugin.description,
     builtIn: true,
+    version,
     image: plugin.image,
     configSchema: plugin.configSchema,
     createdAt: new Date(),
@@ -443,12 +464,16 @@ const listPluginsFromDisk = async (): Promise<PluginDescriptor[]> => {
         const module = await import(pathToFileURL(distPath).href);
         const parsed = parsePluginModule(module as Record<string, unknown>);
         if (!parsed) return null;
-        const image = await resolveEntityImageDataUrl(pluginDir);
+        const [image, version] = await Promise.all([
+          resolveEntityImageDataUrl(pluginDir),
+          readPluginPackageVersion(pluginDir),
+        ]);
         return {
           id,
           name: parsed.name || id,
           description: parsed.description || '',
           builtIn: false,
+          version,
           image: parsed.image || image,
           configSchema: parsed.configSchema,
           createdAt: new Date(),
@@ -468,9 +493,7 @@ const isRecord = (value: unknown): value is Record<string, unknown> =>
   !!value && typeof value === 'object' && !Array.isArray(value);
 
 /** Display-oriented fields persisted in a channel's `state.json`. */
-const readChannelStateFileFields = (
-  parsed: unknown,
-): { name?: string; cwd?: string } => {
+const readChannelStateFileFields = (parsed: unknown): { name?: string; cwd?: string } => {
   if (!isRecord(parsed)) {
     return {};
   }
@@ -583,7 +606,7 @@ export const storageService = {
         };
 
         const channelLastRead = lastReadMap[name] || {};
-        
+
         try {
           // Check root unread
           const rootEvents = await storageService.getEvents({ channelId: name });
@@ -595,8 +618,8 @@ export const storageService = {
           channel.recentThreads = allThreads
             .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())
             .slice(0, 5);
-          
-          const threadsUnseen = allThreads.some(t => t.hasUnseenMessages);
+
+          const threadsUnseen = allThreads.some((t) => t.hasUnseenMessages);
           channel.hasUnseenMessages = rootUnseen || threadsUnseen;
         } catch {
           channel.hasUnseenMessages = false;
@@ -654,11 +677,7 @@ export const storageService = {
     finalState.cwd = resolvedCwd;
     await fs.mkdir(resolvedCwd, { recursive: true });
     await fs.mkdir(channelDir, { recursive: true });
-    await fs.writeFile(
-      specPath,
-      spec?.trim() ||
-      `# ${normalizedChannelId}\n\n`,
-    );
+    await fs.writeFile(specPath, spec?.trim() || `# ${normalizedChannelId}\n\n`);
     await writeJsonFileAtomically(statePath, finalState);
   },
   ensureChannel: async ({
@@ -708,10 +727,7 @@ export const storageService = {
       await fs.access(specPath);
     } catch (error: unknown) {
       if ((error as NodeJS.ErrnoException)?.code === 'ENOENT') {
-        await fs.writeFile(
-          specPath,
-          spec?.trim() || `# ${normalizedChannelId}\n\n`,
-        );
+        await fs.writeFile(specPath, spec?.trim() || `# ${normalizedChannelId}\n\n`);
       } else {
         throw error;
       }
@@ -818,8 +834,7 @@ export const storageService = {
 
         try {
           const threadState = await readJsonFile<Record<string, unknown>>(threadStatePath, {});
-          const threadName =
-            typeof threadState.name === 'string' ? threadState.name.trim() : '';
+          const threadName = typeof threadState.name === 'string' ? threadState.name.trim() : '';
           if (threadName) {
             threadDisplayName = threadName;
           }
@@ -876,10 +891,7 @@ export const storageService = {
       }
     }
 
-    const threadName =
-      isRecord(state) && typeof state.name === 'string'
-        ? state.name.trim()
-        : '';
+    const threadName = isRecord(state) && typeof state.name === 'string' ? state.name.trim() : '';
 
     return {
       id: threadId,
@@ -1078,9 +1090,7 @@ export const storageService = {
 
       const pluginRefs = parsePluginRefs(data.plugins);
       const frontmatterImage =
-        typeof data.image === 'string' && data.image.trim() !== ''
-          ? data.image.trim()
-          : undefined;
+        typeof data.image === 'string' && data.image.trim() !== '' ? data.image.trim() : undefined;
 
       diskDetails = {
         id: agentId,
@@ -1237,8 +1247,7 @@ export const storageService = {
     // updates (e.g. plugins-only) must still persist a complete AGENT.md.
     if (isBuiltinOverlayAgentId(agentId)) {
       const pluginRefs =
-        plugins ??
-        (nextData.plugins !== undefined ? parsePluginRefs(nextData.plugins) : undefined);
+        plugins ?? (nextData.plugins !== undefined ? parsePluginRefs(nextData.plugins) : undefined);
       const diskOverrides: Partial<AgentDetails> = {};
       if (typeof nextData.name === 'string' && nextData.name.trim() !== '') {
         diskOverrides.name = nextData.name;
@@ -1472,7 +1481,7 @@ export const storageService = {
       'variables' in raw &&
       Array.isArray((raw as { variables: unknown }).variables)
     ) {
-      const entries = ((raw as { variables: StoredVariable[] }).variables)
+      const entries = (raw as { variables: StoredVariable[] }).variables
         .filter((v) => typeof v?.key === 'string')
         .map((v) => [v.key, { value: String(v.value ?? ''), secret: !!v.secret }] as const);
       return Object.fromEntries(entries);
@@ -1574,9 +1583,7 @@ export const storageService = {
       throw new Error('Channel has no CWD configured');
     }
 
-    const targetDir = subPath
-      ? resolveChannelFile(baseCwd, subPath)
-      : resolvePath(baseCwd);
+    const targetDir = subPath ? resolveChannelFile(baseCwd, subPath) : resolvePath(baseCwd);
 
     const entries = await fs.readdir(targetDir, { withFileTypes: true });
     return entries
@@ -1623,8 +1630,7 @@ export const storageService = {
 
     const targetFile = resolveChannelFile(baseCwd, filePath);
     const buf = await fs.readFile(targetFile);
-    const content =
-      encoding === 'base64' ? buf.toString('base64') : buf.toString('utf-8');
+    const content = encoding === 'base64' ? buf.toString('base64') : buf.toString('utf-8');
 
     return {
       content,

package/src/services/plugins/domain.ts

@@ -35,6 +35,8 @@ export type PluginDescriptor = {
   description: string;
   /** True when bundled with the core server (`src/registry/plugins`); false for ~/.openbot/plugins installs. */
   builtIn: boolean;
+  /** Installed npm semver for disk plugins; runtime package version for built-ins. */
+  version?: string;
   image?: string;
   configSchema?: ConfigSchema;
   createdAt: Date;
@@ -136,7 +138,11 @@ export interface Storage {
   }) => Promise<void>;
   getThreads: (args: { channelId: string }) => Promise<Thread[]>;
   getThreadDetails: (args: { channelId: string; threadId: string }) => Promise<ThreadDetails>;
-  setLastRead: (args: { channelId: string; threadId?: string; lastReadEventId: string }) => Promise<void>;
+  setLastRead: (args: {
+    channelId: string;
+    threadId?: string;
+    lastReadEventId: string;
+  }) => Promise<void>;
   /** User-facing agent list; excludes agents with `hidden: true` (e.g. built-in `state`). */
   getAgents: () => Promise<Agent[]>;
   getPlugins: () => Promise<PluginDescriptor[]>;

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';
 
@@ -273,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);