openbot 0.5.8 → 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.8');
+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,7 +9,7 @@ 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';
@@ -837,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)) {

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.8",
+  "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.8"
+    "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.8');
+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,10 +33,7 @@ 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';
@@ -1056,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)) {

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,
-    },
-  };
-}