openbot 0.5.7 → 0.5.9

package/CLAUDE.md

@@ -31,7 +31,7 @@ OpenBot is a local-first, event-driven harness for running AI agents, built on t
 
 Core built-ins: `storage` (infra handlers for `/api/state`), `plugin-manager` (marketplace + npm plugin install). The default agent runtime is **`@meetopenbot/openbot`**, a community npm package installed to `~/.openbot/plugins/@meetopenbot/openbot/` on first boot (`ensureDefaultStack`). Disk-installed plugins take precedence over built-ins in `resolvePlugin`.
 
-A `Plugin`'s `factory(context)` returns a `MelonyPlugin`; `PluginContext` carries `agentId`, `agentDetails`, per-agent `config` (from `AGENT.md` frontmatter), the shared `storage` service, the merged `tools` map, `publicBaseUrl`, the run's `abortSignal`, and `host` (platform hooks: `runAgent`, cloud auth, model registry, config).
+A `Plugin`'s `factory(context)` returns a `MelonyPlugin`; `PluginContext` carries `agentId`, `agentDetails`, per-agent `config` (from `AGENT.md` frontmatter), the shared `storage` service, the merged `tools` map, `publicBaseUrl`, the run's `abortSignal`, and `host` (platform hooks: `runAgent`, cloud auth, config).
 
 ### Agents
 

package/dist/app/cli.js

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

package/dist/harness/index.js

@@ -7,6 +7,7 @@ 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';
+import { getInvokeConfigOverrides, mergePluginConfig } from './merge-plugin-config.js';
 export { STATE_AGENT_ID, ORCHESTRATOR_AGENT_ID };
 async function emitEvent(chunk, state, { persistEvents, channelId, threadId, onEvent, parentAgentId, parentToolCallId, }) {
     ensureEventId(chunk);
@@ -69,6 +70,11 @@ export async function runAgent(options) {
         }
         const builder = melony().initialState(state);
         const pluginHost = createPluginHost(runAgent);
+        const invokeConfigOverrides = getInvokeConfigOverrides(event);
+        const pluginConfigs = Object.fromEntries(pluginRefs.map((ref) => [
+            ref.id,
+            mergePluginConfig(ref.config, invokeConfigOverrides, ref.id),
+        ]));
         for (const ref of pluginRefs) {
             const plugin = await resolvePlugin(ref.id);
             if (!plugin)
@@ -76,7 +82,7 @@ export async function runAgent(options) {
             builder.use(plugin.factory({
                 agentId,
                 agentDetails,
-                config: ref.config ?? {},
+                config: pluginConfigs[ref.id],
                 storage: storageService,
                 tools,
                 publicBaseUrl,

package/dist/harness/merge-plugin-config.js

@@ -0,0 +1,26 @@
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isPluginKeyedConfig(config) {
+    return Object.values(config).every(isPlainObject);
+}
+export function getInvokeConfigOverrides(event) {
+    if (event.type !== 'agent:invoke')
+        return undefined;
+    const config = event.data?.config;
+    if (!isPlainObject(config) || Object.keys(config).length === 0)
+        return undefined;
+    return config;
+}
+export function mergePluginConfig(base, overrides, pluginId) {
+    const baseConfig = base ?? {};
+    if (!overrides)
+        return baseConfig;
+    if (isPluginKeyedConfig(overrides)) {
+        const pluginOverride = overrides[pluginId];
+        if (!isPlainObject(pluginOverride))
+            return baseConfig;
+        return { ...baseConfig, ...pluginOverride };
+    }
+    return { ...baseConfig, ...overrides };
+}

package/dist/plugins/storage/service.js

@@ -9,10 +9,10 @@ import crypto from 'node:crypto';
 import matter from 'gray-matter';
 import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
 import { listBuiltInPlugins, parsePluginModule } from '../../services/plugins/registry.js';
-import { enrichOpenbotPluginDescriptor, listRegistryModelOptions, } from '../../services/plugins/model-registry.js';
+import { enrichOpenbotPluginDescriptor } from '../../services/plugins/enrich-openbot-plugin.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,
@@ -814,13 +837,12 @@ export const storageService = {
         return Array.from(deduped.values()).filter((agent) => !agent.hidden);
     },
     getPlugins: async () => {
-        const [builtIn, fromDisk, modelOptions] = await Promise.all([
+        const [builtIn, fromDisk] = await Promise.all([
             listBuiltInPluginDescriptors(),
             listPluginsFromDisk(),
-            listRegistryModelOptions(),
         ]);
-        const enrichedBuiltIn = builtIn.map((plugin) => enrichOpenbotPluginDescriptor(plugin, modelOptions));
-        const merged = [...enrichedBuiltIn, ...fromDisk];
+        const enrichPlugin = (plugin) => enrichOpenbotPluginDescriptor(plugin);
+        const merged = [...builtIn.map(enrichPlugin), ...fromDisk.map(enrichPlugin)];
         const deduped = new Map();
         for (const plugin of merged) {
             if (!deduped.has(plugin.id)) {
@@ -840,9 +862,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 +984,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 +1189,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 +1255,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/enrich-openbot-plugin.js

@@ -0,0 +1,38 @@
+import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
+import { DEFAULT_CLOUD_OPENBOT_AUTH_MODE, isCloudMode } from '../../app/cloud-mode.js';
+/** Injects cloud platform fields into the openbot plugin descriptor for settings UI. */
+export function enrichOpenbotPluginDescriptor(descriptor) {
+    if (descriptor.id !== OPENBOT_PLUGIN_ID || !descriptor.configSchema)
+        return descriptor;
+    if (!isCloudMode())
+        return descriptor;
+    const { authMode: _authMode, ...otherProperties } = descriptor.configSchema.properties;
+    const cloudAuthModeProperty = {
+        type: 'string',
+        description: 'Credits uses OpenBot platform billing. BYOK uses your own API keys.',
+        enum: ['credits', 'byok'],
+        default: DEFAULT_CLOUD_OPENBOT_AUTH_MODE,
+        options: [
+            {
+                label: 'Credits',
+                value: 'credits',
+                description: 'Use OpenBot platform credits.',
+            },
+            {
+                label: 'Bring your own key',
+                value: 'byok',
+                description: 'Use your own provider API keys.',
+            },
+        ],
+    };
+    return {
+        ...descriptor,
+        configSchema: {
+            ...descriptor.configSchema,
+            properties: {
+                authMode: cloudAuthModeProperty,
+                ...otherProperties,
+            },
+        },
+    };
+}

package/dist/services/plugins/host.js

@@ -2,15 +2,12 @@ import { DEFAULT_CLOUD_OPENBOT_AUTH_MODE, isCloudMode, isCloudSystemAgent, parse
 import { ORCHESTRATOR_AGENT_ID } from '../../app/agent-ids.js';
 import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
 import { getBaseDir, resolvePath, saveConfig } from '../../app/config.js';
-import { listApiKeyProvidersFromRegistry, resolveModelRegistry, } from './model-registry.js';
 export function createPluginHost(runAgent) {
     return {
         runAgent,
         isCloudSystemAgent,
         isCloudMode,
         parseOpenbotAuthMode,
-        resolveModelRegistry,
-        listApiKeyProvidersFromRegistry,
         saveConfig,
         getBaseDir,
         resolvePath,

package/dist/services/plugins/model-registry.js

@@ -74,7 +74,7 @@ export function enrichOpenbotPluginDescriptor(descriptor, modelOptions) {
         : pickDefaultModelValue(modelOptions) ?? staticDefault;
     const nextModelProperty = {
         ...modelProperty,
-        description: 'Model from the hosted marketplace registry.',
+        description: modelProperty.description ?? 'Model from the hosted marketplace registry.',
     };
     if (values.length > 0) {
         nextModelProperty.enum = values;

package/package.json

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

package/src/app/types.ts

@@ -42,6 +42,8 @@ export type AgentInvokeEvent = BaseEvent & {
     role?: 'user' | 'assistant' | 'system';
     content: string;
     agentId?: string;
+    /** Per-run config overrides: flat fields (e.g. model) or nested by plugin id. */
+    config?: Record<string, unknown>;
   };
 };
 

package/src/harness/index.ts

@@ -9,6 +9,7 @@ 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';
+import { getInvokeConfigOverrides, mergePluginConfig } from './merge-plugin-config.js';
 
 export { STATE_AGENT_ID, ORCHESTRATOR_AGENT_ID };
 
@@ -121,6 +122,13 @@ export async function runAgent(options: RunAgentOptions): Promise<void> {
     const builder = melony<OpenBotState, OpenBotEvent>().initialState(state);
 
     const pluginHost = createPluginHost(runAgent);
+    const invokeConfigOverrides = getInvokeConfigOverrides(event);
+    const pluginConfigs = Object.fromEntries(
+      pluginRefs.map((ref) => [
+        ref.id,
+        mergePluginConfig(ref.config, invokeConfigOverrides, ref.id),
+      ]),
+    );
 
     for (const ref of pluginRefs) {
       const plugin = await resolvePlugin(ref.id);
@@ -130,7 +138,7 @@ export async function runAgent(options: RunAgentOptions): Promise<void> {
         plugin.factory({
           agentId,
           agentDetails,
-          config: ref.config ?? {},
+          config: pluginConfigs[ref.id],
           storage: storageService,
           tools,
           publicBaseUrl,

package/src/harness/merge-plugin-config.ts

@@ -0,0 +1,35 @@
+import { OpenBotEvent } from '../app/types.js';
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function isPluginKeyedConfig(config: Record<string, unknown>): boolean {
+  return Object.values(config).every(isPlainObject);
+}
+
+export function getInvokeConfigOverrides(event: OpenBotEvent): Record<string, unknown> | undefined {
+  if (event.type !== 'agent:invoke') return undefined;
+
+  const config = event.data?.config;
+  if (!isPlainObject(config) || Object.keys(config).length === 0) return undefined;
+
+  return config;
+}
+
+export function mergePluginConfig(
+  base: Record<string, unknown> | undefined,
+  overrides: Record<string, unknown> | undefined,
+  pluginId: string,
+): Record<string, unknown> {
+  const baseConfig = base ?? {};
+  if (!overrides) return baseConfig;
+
+  if (isPluginKeyedConfig(overrides)) {
+    const pluginOverride = overrides[pluginId];
+    if (!isPlainObject(pluginOverride)) return baseConfig;
+    return { ...baseConfig, ...pluginOverride };
+  }
+
+  return { ...baseConfig, ...overrides };
+}

package/src/plugins/storage/service.ts

@@ -33,18 +33,11 @@ import {
 import type { PluginRef } from '../../services/plugins/types.js';
 import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
 import { listBuiltInPlugins, parsePluginModule } from '../../services/plugins/registry.js';
-import {
-  enrichOpenbotPluginDescriptor,
-  listRegistryModelOptions,
-} from '../../services/plugins/model-registry.js';
+import { enrichOpenbotPluginDescriptor } from '../../services/plugins/enrich-openbot-plugin.js';
 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 +135,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 +153,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 +164,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 +197,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 +230,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 +362,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 +461,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 +490,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 +603,7 @@ export const storageService = {
         };
 
         const channelLastRead = lastReadMap[name] || {};
-        
+
         try {
           // Check root unread
           const rootEvents = await storageService.getEvents({ channelId: name });
@@ -595,8 +615,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 +674,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 +724,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 +831,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 +888,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,
@@ -1044,17 +1053,14 @@ export const storageService = {
     return Array.from(deduped.values()).filter((agent) => !agent.hidden);
   },
   getPlugins: async (): Promise<PluginDescriptor[]> => {
-    const [builtIn, fromDisk, modelOptions] = await Promise.all([
+    const [builtIn, fromDisk] = await Promise.all([
       listBuiltInPluginDescriptors(),
       listPluginsFromDisk(),
-      listRegistryModelOptions(),
     ]);
 
-    const enrichedBuiltIn = builtIn.map((plugin) =>
-      enrichOpenbotPluginDescriptor(plugin, modelOptions),
-    );
+    const enrichPlugin = (plugin: PluginDescriptor) => enrichOpenbotPluginDescriptor(plugin);
 
-    const merged = [...enrichedBuiltIn, ...fromDisk];
+    const merged = [...builtIn.map(enrichPlugin), ...fromDisk.map(enrichPlugin)];
     const deduped = new Map<string, PluginDescriptor>();
     for (const plugin of merged) {
       if (!deduped.has(plugin.id)) {
@@ -1078,9 +1084,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 +1241,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 +1475,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 +1577,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 +1624,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/enrich-openbot-plugin.ts

@@ -0,0 +1,41 @@
+import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
+import { DEFAULT_CLOUD_OPENBOT_AUTH_MODE, isCloudMode } from '../../app/cloud-mode.js';
+import type { ConfigSchema, PluginDescriptor } from './domain.js';
+
+/** Injects cloud platform fields into the openbot plugin descriptor for settings UI. */
+export function enrichOpenbotPluginDescriptor(descriptor: PluginDescriptor): PluginDescriptor {
+  if (descriptor.id !== OPENBOT_PLUGIN_ID || !descriptor.configSchema) return descriptor;
+  if (!isCloudMode()) return descriptor;
+
+  const { authMode: _authMode, ...otherProperties } = descriptor.configSchema.properties;
+
+  const cloudAuthModeProperty: ConfigSchema['properties'][string] = {
+    type: 'string',
+    description: 'Credits uses OpenBot platform billing. BYOK uses your own API keys.',
+    enum: ['credits', 'byok'],
+    default: DEFAULT_CLOUD_OPENBOT_AUTH_MODE,
+    options: [
+      {
+        label: 'Credits',
+        value: 'credits',
+        description: 'Use OpenBot platform credits.',
+      },
+      {
+        label: 'Bring your own key',
+        value: 'byok',
+        description: 'Use your own provider API keys.',
+      },
+    ],
+  };
+
+  return {
+    ...descriptor,
+    configSchema: {
+      ...descriptor.configSchema,
+      properties: {
+        authMode: cloudAuthModeProperty,
+        ...otherProperties,
+      },
+    },
+  };
+}

package/src/services/plugins/host.ts

@@ -8,10 +8,6 @@ import {
 import { ORCHESTRATOR_AGENT_ID } from '../../app/agent-ids.js';
 import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
 import { getBaseDir, resolvePath, saveConfig } from '../../app/config.js';
-import {
-  listApiKeyProvidersFromRegistry,
-  resolveModelRegistry,
-} from './model-registry.js';
 import type { PluginHost, RunAgentHostOptions } from './types.js';
 
 export function createPluginHost(
@@ -22,8 +18,6 @@ export function createPluginHost(
     isCloudSystemAgent,
     isCloudMode,
     parseOpenbotAuthMode,
-    resolveModelRegistry,
-    listApiKeyProvidersFromRegistry,
     saveConfig,
     getBaseDir,
     resolvePath,

package/src/services/plugins/types.ts

@@ -38,12 +38,6 @@ export interface PluginHost {
   isCloudSystemAgent: (agentId: string) => boolean;
   isCloudMode: () => boolean;
   parseOpenbotAuthMode: (value: unknown) => 'credits' | 'byok';
-  resolveModelRegistry: () => ReturnType<
-    typeof import('./model-registry.js').resolveModelRegistry
-  >;
-  listApiKeyProvidersFromRegistry: (
-    registry: Awaited<ReturnType<PluginHost['resolveModelRegistry']>>,
-  ) => Array<{ id: string; label: string }>;
   saveConfig: (patch: Record<string, unknown>) => void;
   getBaseDir: () => string;
   resolvePath: (p: string) => string;

package/src/services/plugins/model-registry.ts

@@ -1,178 +0,0 @@
-import {
-  DEFAULT_MARKETPLACE_REGISTRY_URL,
-  loadConfig,
-} from '../../app/config.js';
-import { OPENBOT_PLUGIN_ID } from '../../app/openbot-plugin.js';
-import {
-  DEFAULT_CLOUD_OPENBOT_AUTH_MODE,
-  isCloudMode,
-} from '../../app/cloud-mode.js';
-import type { ConfigSchema, PluginDescriptor } from './domain.js';
-
-export type RegistryProviderCatalog = Record<
-  string,
-  {
-    label: string;
-    models: Array<{ id: string; label: string; description: string }>;
-  }
->;
-
-export type ModelRegistry = {
-  providers?: RegistryProviderCatalog;
-};
-
-export type RegistryModelOption = {
-  value: string;
-  label: string;
-  description?: string;
-  provider: string;
-};
-
-let cachedRegistry: ModelRegistry | null = null;
-let cacheUrl: string | null = null;
-
-function getRegistryUrl(): string {
-  const { marketplaceRegistryUrl } = loadConfig();
-  return marketplaceRegistryUrl?.trim() || DEFAULT_MARKETPLACE_REGISTRY_URL;
-}
-
-export async function resolveModelRegistry(): Promise<ModelRegistry> {
-  const url = getRegistryUrl();
-  if (cachedRegistry && cacheUrl === url) return cachedRegistry;
-
-  try {
-    const res = await fetch(url, {
-      headers: { Accept: 'application/json' },
-      signal: AbortSignal.timeout(15_000),
-    });
-    if (!res.ok) {
-      throw new Error(`Registry HTTP ${res.status} ${res.statusText}`);
-    }
-    cachedRegistry = (await res.json()) as ModelRegistry;
-    cacheUrl = url;
-    return cachedRegistry;
-  } catch (err) {
-    console.warn(
-      '[model-registry] fetch failed:',
-      err instanceof Error ? err.message : err,
-    );
-    return { providers: {} };
-  }
-}
-
-export function listModelOptionsFromRegistry(registry: ModelRegistry): RegistryModelOption[] {
-  const providers = registry.providers ?? {};
-  const out: RegistryModelOption[] = [];
-
-  for (const [providerId, provider] of Object.entries(providers)) {
-    for (const model of provider.models ?? []) {
-      out.push({
-        value: `${providerId}/${model.id}`,
-        label: `${provider.label} — ${model.label}`,
-        description: model.description,
-        provider: providerId,
-      });
-    }
-  }
-
-  return out;
-}
-
-export async function listRegistryModelOptions(): Promise<RegistryModelOption[]> {
-  const registry = await resolveModelRegistry();
-  return listModelOptionsFromRegistry(registry);
-}
-
-export function listApiKeyProvidersFromRegistry(
-  registry: ModelRegistry,
-): Array<{ id: string; label: string }> {
-  const providers = registry.providers ?? {};
-  return Object.entries(providers).map(([id, provider]) => ({
-    id,
-    label: provider.label,
-  }));
-}
-
-function pickDefaultModelValue(options: RegistryModelOption[]): string | undefined {
-  if (options.length === 0) return undefined;
-  const values = options.map((option) => option.value);
-  const preferred = values.find((value) => value.startsWith('openai/'));
-  return preferred ?? values[0];
-}
-
-export function enrichOpenbotPluginDescriptor(
-  descriptor: PluginDescriptor,
-  modelOptions: RegistryModelOption[],
-): PluginDescriptor {
-  if (descriptor.id !== OPENBOT_PLUGIN_ID || !descriptor.configSchema) return descriptor;
-
-  const modelProperty = descriptor.configSchema.properties.model;
-  if (!modelProperty) return descriptor;
-
-  const values = modelOptions.map((option) => option.value);
-  const staticDefault =
-    typeof modelProperty.default === 'string' ? modelProperty.default : undefined;
-  const defaultModel =
-    staticDefault && values.includes(staticDefault)
-      ? staticDefault
-      : pickDefaultModelValue(modelOptions) ?? staticDefault;
-
-  const nextModelProperty: ConfigSchema['properties'][string] = {
-    ...modelProperty,
-    description: 'Model from the hosted marketplace registry.',
-  };
-
-  if (values.length > 0) {
-    nextModelProperty.enum = values;
-    nextModelProperty.options = modelOptions.map((option) => ({
-      label: option.label,
-      value: option.value,
-      description: option.description,
-    }));
-  }
-
-  if (defaultModel) {
-    nextModelProperty.default = defaultModel;
-  }
-
-  const { model: _model, authMode: _authMode, ...otherProperties } =
-    descriptor.configSchema.properties;
-
-  const cloudAuthModeProperty: ConfigSchema['properties'][string] = {
-    type: 'string',
-    description: 'Credits uses OpenBot platform billing. BYOK uses your own API keys.',
-    enum: ['credits', 'byok'],
-    default: DEFAULT_CLOUD_OPENBOT_AUTH_MODE,
-    options: [
-      {
-        label: 'Credits',
-        value: 'credits',
-        description: 'Use OpenBot platform credits.',
-      },
-      {
-        label: 'Bring your own key',
-        value: 'byok',
-        description: 'Use your own provider API keys.',
-      },
-    ],
-  };
-
-  const nextProperties: ConfigSchema['properties'] = isCloudMode()
-    ? {
-        authMode: cloudAuthModeProperty,
-        model: nextModelProperty,
-        ...otherProperties,
-      }
-    : {
-        model: nextModelProperty,
-        ...otherProperties,
-      };
-
-  return {
-    ...descriptor,
-    configSchema: {
-      ...descriptor.configSchema,
-      properties: nextProperties,
-    },
-  };
-}