@meetopenbot/openbot 1.0.4 → 1.1.1

package/dist/agent-models.js

@@ -0,0 +1,125 @@
+export const MAX_LISTED_MODELS = 8;
+function trimmedString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+function optionFromSchema(value, schema) {
+    const match = schema?.options?.find((option) => option.value === value);
+    return {
+        id: value,
+        label: trimmedString(match?.label),
+        description: trimmedString(match?.description),
+    };
+}
+function schemaModelIds(schema) {
+    const fromOptions = schema?.options
+        ?.map((option) => option.value)
+        .filter((value) => typeof value === "string" && value.length > 0) ?? [];
+    if (fromOptions.length > 0)
+        return unique(fromOptions);
+    const fromEnum = Array.isArray(schema?.enum)
+        ? schema.enum.filter((value) => typeof value === "string" && value.length > 0)
+        : [];
+    return unique(fromEnum);
+}
+export function catalogForAgent(pluginConfig, schema) {
+    const allowedModels = schemaModelIds(schema);
+    const defaultModel = trimmedString(pluginConfig?.model) ?? trimmedString(schema?.default) ?? allowedModels[0];
+    const models = allowedModels.map((id) => optionFromSchema(id, schema));
+    return {
+        defaultModel,
+        allowedModels,
+        models,
+        constrained: allowedModels.length > 0,
+    };
+}
+export function listModelsForPrompt(catalog, limit = MAX_LISTED_MODELS) {
+    const byId = new Map(catalog.models.map((model) => [model.id, model]));
+    const ordered = unique([catalog.defaultModel, ...catalog.allowedModels].filter((value) => Boolean(value)));
+    return ordered.slice(0, limit).map((id) => byId.get(id) ?? { id });
+}
+function formatModelOption(model) {
+    const hint = model.description ?? (model.label && model.label !== model.id ? model.label : undefined);
+    return hint ? `${model.id} — ${hint}` : model.id;
+}
+export function formatInstalledAgentLine(agent, catalog) {
+    let line = `- ${agent.id}: ${agent.name}${agent.description ? ` - ${agent.description}` : ""}`;
+    if (!catalog?.defaultModel && !catalog?.constrained)
+        return line;
+    if (catalog.defaultModel) {
+        line += `\n  default: ${catalog.defaultModel}`;
+    }
+    if (catalog.constrained && catalog.allowedModels.length > 0) {
+        const listed = listModelsForPrompt(catalog);
+        const truncated = catalog.allowedModels.length > listed.length;
+        const rows = listed.map((model) => `    - ${formatModelOption(model)}`);
+        if (truncated)
+            rows.push("    - …");
+        line += `\n  models:\n${rows.join("\n")}`;
+    }
+    return line;
+}
+export function formatInstalledAgentsSection(agents, catalogs) {
+    const formatted = agents
+        .map((agent) => formatInstalledAgentLine(agent, catalogs.get(agent.id)))
+        .join("\n");
+    return `## INSTALLED AGENTS\n${formatted}\n\nWhen you ask_agent, pick \`model\` from that agent's list using the descriptions (cheaper/faster for simple work, stronger for complex coding or reasoning). Omit \`model\` to use their default. Do not reuse another agent's ids.\nAnswer questions about people from this list. Do not create a Space to inspect agents.`;
+}
+export function formatAvailableAgentsSection(agents) {
+    const formatted = agents
+        .map((agent) => `- ${agent.id}: ${agent.name}${agent.description ? ` - ${agent.description}` : ""}`)
+        .join("\n");
+    return `## AVAILABLE AGENTS\n${formatted}\n\nNot installed yet. Use \`install_agent\` with an id from this list when the human needs that person (they must approve). After install, ask them with \`ask_agent\`.`;
+}
+export function availableMarketplaceAgents(installed, marketplace) {
+    const installedIds = new Set(installed.map((agent) => agent.id));
+    return marketplace.filter((agent) => !installedIds.has(agent.id));
+}
+export function validateAskModel(model, catalog) {
+    const requested = trimmedString(model);
+    if (!requested)
+        return { ok: true };
+    if (!catalog?.constrained)
+        return { ok: true, model: requested };
+    if (catalog.allowedModels.includes(requested))
+        return { ok: true, model: requested };
+    const listed = listModelsForPrompt(catalog).map((option) => option.id);
+    const defaultHint = catalog.defaultModel ? ` Omit model to use default (${catalog.defaultModel}).` : "";
+    return {
+        ok: false,
+        error: `model "${requested}" is not in this agent's list. Use one of: ${listed.join(", ")}.${defaultHint}`,
+    };
+}
+function primaryPluginRef(pluginRefs) {
+    return pluginRefs?.find((ref) => typeof ref.id === "string" && ref.id.length > 0);
+}
+export async function loadAgentModelCatalogs(storage, agentIds) {
+    const catalogs = new Map();
+    if (!storage?.getAgentDetails || agentIds.length === 0)
+        return catalogs;
+    const [detailsList, plugins] = await Promise.all([
+        Promise.all(agentIds.map(async (agentId) => {
+            try {
+                const details = await storage.getAgentDetails({ agentId });
+                return { agentId, details };
+            }
+            catch {
+                return { agentId, details: undefined };
+            }
+        })),
+        storage.getPlugins
+            ? storage.getPlugins().catch(() => [])
+            : Promise.resolve([]),
+    ]);
+    const pluginsById = new Map(plugins.map((plugin) => [plugin.id, plugin]));
+    for (const { agentId, details } of detailsList) {
+        const ref = primaryPluginRef(details?.pluginRefs);
+        if (!ref)
+            continue;
+        const schema = pluginsById.get(ref.id)?.configSchema?.properties?.model;
+        catalogs.set(agentId, catalogForAgent(ref.config, schema));
+    }
+    return catalogs;
+}

package/dist/build-tools.js

@@ -2,10 +2,13 @@ import { memoryTools } from "./tools/memory.js";
 import { todoTools } from "./tools/todo.js";
 import { storageTools } from "./tools/storage.js";
 import { askAgentTools } from "./tools/ask-agent.js";
+import { installAgentTools } from "./tools/install-agent.js";
 import { startWorkTools } from "./tools/start-work.js";
 import { threadStatusTools } from "./tools/thread-status.js";
 import { threadTitleTools } from "./tools/thread-title.js";
 import { wrapToolsWithApproval } from "./tools/approval.js";
+/** Always gated: installing an agent changes the workspace. */
+const ALWAYS_APPROVE = ["install_agent"];
 /**
  * Merge first-party OpenBot coordinator tools and wrap configured actions
  * with approval.
@@ -16,11 +19,12 @@ export function buildOpenbotTools(args) {
         ...todoTools,
         ...storageTools,
         ...askAgentTools,
+        ...installAgentTools,
         ...startWorkTools,
         ...threadStatusTools,
         ...threadTitleTools,
         ...args.context.tools,
     };
     const approvalConfig = args.context.config?.approval ?? { actions: [] };
-    return wrapToolsWithApproval(tools, approvalConfig.actions ?? [], args.context);
+    return wrapToolsWithApproval(tools, [...new Set([...ALWAYS_APPROVE, ...(approvalConfig.actions ?? [])])], args.context);
 }

package/dist/context.js

@@ -1,5 +1,5 @@
+import { formatAvailableAgentsSection, formatInstalledAgentsSection, loadAgentModelCatalogs, availableMarketplaceAgents, } from "./agent-models.js";
 import { GENERAL_SPACE_ID } from "./space-id.js";
-import { OPENBOT_SYSTEM_PROMPT } from "./system-prompt.js";
 import { todoService } from "./tools/todo-service.js";
 export const DEFAULT_CONTEXT_BUDGET = 8000;
 export const MAX_CONTEXT_FILES = 50;
@@ -26,8 +26,8 @@ export const getContextBudgetForModel = (modelString) => {
 /**
  * Simplified context builder for MVP.
  */
-export async function buildContext(state, storage) {
-    const { channelId, threadId, channelDetails, agentId, threadDetails, agentDetails, } = state;
+export async function buildContext(state, storage, host) {
+    const { channelId, threadId, channelDetails, agentId, threadDetails, } = state;
     const sections = [];
     // Fetch agents once if storage is available
     const allAgents = storage?.getAgents
@@ -108,10 +108,21 @@ export async function buildContext(state, storage) {
     }
     // 2.6 Installed Agents
     if (allAgents.length > 0) {
-        const formatted = allAgents
-            .map((a) => `- ${a.id}: ${a.name}${a.description ? ` - ${a.description}` : ""}`)
-            .join("\n");
-        sections.push(`## INSTALLED AGENTS\n${formatted}\n\nAnswer questions about people from this list. Do not create a Space to inspect agents.`);
+        const catalogs = await loadAgentModelCatalogs(storage, allAgents.map((agent) => agent.id));
+        sections.push(formatInstalledAgentsSection(allAgents, catalogs));
+    }
+    // 2.7 Marketplace agents not yet installed
+    if (host?.listMarketplaceAgents) {
+        try {
+            const marketplace = await host.listMarketplaceAgents();
+            const available = availableMarketplaceAgents(allAgents, marketplace);
+            if (available.length > 0) {
+                sections.push(formatAvailableAgentsSection(available));
+            }
+        }
+        catch (error) {
+            console.warn("[context] Failed to fetch marketplace agents:", error);
+        }
     }
     if (storage?.getChannels) {
         try {
@@ -178,12 +189,7 @@ export async function buildContext(state, storage) {
             console.warn("[context] Failed to fetch files:", error);
         }
     }
-    // 5. Agent Instructions
-    const rawInstructions = agentDetails?.instructions?.trim();
-    if (rawInstructions && rawInstructions !== OPENBOT_SYSTEM_PROMPT.trim()) {
-        sections.push(`## Instructions\n${rawInstructions}`);
-    }
-    // 6. Memories
+    // 5. Memories
     if (storage?.listMemories) {
         try {
             const scopes = ["global", `agent:${agentId}`];

package/dist/index.js

@@ -1,11 +1,13 @@
 import { defineOpenbotPlugin } from './types.js';
-import { cloudAuthModeProperties, modelConfigField, } from '@meetopenbot/plugin-sdk';
+import { modelConfigField, } from '@meetopenbot/plugin-sdk';
 import { AUTO_MODEL_ID, AUTO_MODEL_OPTION } from './auto-model.js';
 import { handleOpenbotWidgetResponse, runOpenbotTurn } from './runtime.js';
+import { MAX_USER_INSTRUCTIONS_LENGTH } from './system-prompt.js';
 import { memoryTools } from './tools/memory.js';
 import { todoTools } from './tools/todo.js';
 import { storageTools } from './tools/storage.js';
 import { askAgentTools } from './tools/ask-agent.js';
+import { installAgentTools } from './tools/install-agent.js';
 import { startWorkTools } from './tools/start-work.js';
 import { threadStatusTools } from './tools/thread-status.js';
 import { threadTitleTools } from './tools/thread-title.js';
@@ -31,8 +33,13 @@ export const openbotPlugin = defineOpenbotPlugin({
     configSchema: {
         type: 'object',
         properties: {
-            ...cloudAuthModeProperties(),
             model: modelField,
+            instructions: {
+                type: 'string',
+                format: 'textarea',
+                description: 'Optional extra instructions injected into the coordinator system prompt.',
+                maxLength: MAX_USER_INSTRUCTIONS_LENGTH,
+            },
         },
     },
     tools: {
@@ -40,6 +47,7 @@ export const openbotPlugin = defineOpenbotPlugin({
         ...todoTools,
         ...storageTools,
         ...askAgentTools,
+        ...installAgentTools,
         ...startWorkTools,
         ...threadStatusTools,
         ...threadTitleTools,
@@ -53,6 +61,7 @@ export const openbotPlugin = defineOpenbotPlugin({
         yield* runOpenbotTurn(args, {
             model: context.config?.model || AUTO_MODEL_ID,
             authMode,
+            instructions: context.config?.instructions,
             agentId: context.agentId,
             storage: context.storage,
             toolDefinitions,
@@ -78,6 +87,7 @@ export const openbotPlugin = defineOpenbotPlugin({
         yield* handleOpenbotWidgetResponse(turnArgs, {
             model: context.config?.model || AUTO_MODEL_ID,
             authMode,
+            instructions: context.config?.instructions,
             agentId: context.agentId,
             storage: context.storage,
             toolDefinitions,

package/dist/runtime.js

@@ -3,14 +3,14 @@ import { BYOK_ENV_KEYS, isAuthErrorMessage, isCreditsErrorMessage, fetchModelReg
 import { eventsToModelMessages } from './history.js';
 import { addImageParts, eventsHaveImages, pickVisionModel } from './images.js';
 import { buildContext } from './context.js';
-import { OPENBOT_SYSTEM_PROMPT } from './system-prompt.js';
+import { OPENBOT_SYSTEM_PROMPT, withUserInstructions } from './system-prompt.js';
 import { AUTO_MODEL_ID, isAutoModel, isRetryableModelError, listAutoModelCandidates, missingByokApiKeyMessage, } from './auto-model.js';
 import { reasoningForModel, resolveModel } from './model.js';
 import { errorFromStreamPart } from './stream-error.js';
 import { createAgentOutputBuffer, isOutputBoundaryPart } from './output-buffer.js';
-async function buildSystemPrompt(state, storage) {
-    const context = await buildContext(state, storage);
-    const sections = [OPENBOT_SYSTEM_PROMPT, '', context];
+async function buildSystemPrompt(state, storage, instructions, host) {
+    const context = await buildContext(state, storage, host);
+    const sections = [withUserInstructions(OPENBOT_SYSTEM_PROMPT, instructions), '', context];
     const threadState = state.threadDetails?.state;
     if (!threadState?.isSmartNamed) {
         sections.push('', '## SYSTEM HINT', 'This thread is unnamed. Please use the `set_thread_title` tool to set a concise, descriptive title (e.g., "Project Brainstorming" instead of "project-brainstorm"). Only do this once.');
@@ -84,7 +84,7 @@ function toAiTools(tools, args, flushPendingOutput) {
     return mapped;
 }
 export async function* runOpenbotTurn(args, options) {
-    const { model: modelString = AUTO_MODEL_ID, authMode = 'byok', storage, toolDefinitions = {}, abortSignal, host, } = options;
+    const { model: modelString = AUTO_MODEL_ID, authMode = 'byok', instructions, storage, toolDefinitions = {}, abortSignal, host, } = options;
     let configuredModelString = modelString;
     const isCreditsCloudAgent = (id) => host.isCloudSystemAgent(id ?? '') && authMode === 'credits';
     if (!storage || abortSignal?.aborted)
@@ -92,7 +92,7 @@ export async function* runOpenbotTurn(args, options) {
     const state = args.state;
     state.model = configuredModelString;
     const threadId = args.threadId || state.threadId;
-    const systemPrompt = await buildSystemPrompt(state, storage);
+    const systemPrompt = await buildSystemPrompt(state, storage, instructions, host);
     const events = await storage.getEvents({
         channelId: state.channelId ?? '',
         threadId,

package/dist/system-prompt.js

@@ -1,14 +1,15 @@
+import { settingsVariablesMarkdown, SETTINGS_VARIABLES_MARKDOWN } from '@meetopenbot/plugin-sdk';
 export const OPENBOT_SYSTEM_PROMPT = [
     "# ROLE",
     "You are OpenBot, the coordinator. Humans talk only to you. Specialized agents have their own harnesses; you ask them to do work. You do not impersonate them, and you do not do their jobs yourself.",
     "",
     "# SECURITY POLICY",
     "- **CRITICAL**: Never request API keys, passwords, or sensitive credentials via text or UI widgets; these are managed deterministically via secure forms and must never enter your context.",
-    '- **Credential Guidance**: If an agent or tool requires credentials, inform the user they can be managed under "Settings > Variables".',
+    `- **Credential Guidance**: If an agent or tool requires credentials, tell the user to add them under ${SETTINGS_VARIABLES_MARKDOWN}. When you know the variable name, link to that page with \`?new=ENV_VAR_NAME\` so the client opens Add Variable with the name filled in. Example: ${settingsVariablesMarkdown('LINEAR_API_KEY')}.`,
     "",
     "# CORE MISSION",
     "You are a high-level manager. Not every message is project work.",
-    "- Questions, listings, setup, routing, and status stay in `#general`. Answer them from `## SPACES` and `## INSTALLED AGENTS`. Do not create a Space to look anything up.",
+    "- Questions, listings, setup, routing, and status stay in `#general`. Answer them from `## SPACES`, `## INSTALLED AGENTS`, and `## AVAILABLE AGENTS`. Do not create a Space to look anything up.",
     "- For real project work (build, code, design, ops) you decide **where** (which Space) and **who** (which installed agent), then ask that agent, close without restating their work, and keep todos current.",
     "",
     "# THE AGENT LOOP",
@@ -42,8 +43,9 @@ export const OPENBOT_SYSTEM_PROMPT = [
     "# OPERATIONAL GUIDELINES",
     '- **Spaces**: Work lives in Spaces (product name for channels). `#general` is dispatch — setup, questions, listings, routing, and "what should we do next." Project, coding, design, and ops work belongs in a dedicated Space. Prefer existing Spaces. Create a new Space only when the human asked for one, or they agreed after you suggested it.',
     "- **Asking**: You ask specialists with `ask_agent`. If `## MENTIONED AGENTS` is present, you MUST ask those people. You may also ask others if needed. If nobody is mentioned, pick the best match from `## INSTALLED AGENTS` and tell the human who you asked.",
+    "- **Models**: When you `ask_agent`, pick `model` from that agent's list in `## INSTALLED AGENTS` using the descriptions — cheaper/faster for simple work, stronger for complex coding or reasoning. Omit `model` to use their default. Do not reuse another agent's ids.",
     "- **Closer**: After `ask_agent`, you are the closer, not a second author of their work. Don't repeat. Add or close. When several people replied, write only the synthesis or decision — not a recap of each.",
-    "- **Missing people**: If no installed agent can do the job, tell the human who to install. Do not attempt the specialist work yourself.",
+    "- **Missing people**: If no installed agent can do the job, pick a match from `## AVAILABLE AGENTS` and call `install_agent` (human must approve) — only when they asked for that capability or agreed. One agent per call. Then `ask_agent`. If nobody is listed, tell the human who to install from Settings. Do not attempt the specialist work yourself.",
     "- **Hub-and-spoke**: Specialists cannot talk to each other. You pass context from one to the next.",
     "- **Durable Memory**: Use the `remember` tool to store important facts, preferences, or project details that should persist across sessions.",
     "",
@@ -59,3 +61,29 @@ export const OPENBOT_SYSTEM_PROMPT = [
     "- If an asked agent fails, try a different agent or tell the human what blocked them.",
     "- Only ask the human for help after you cannot route or ask anyone who can do the work.",
 ].join("\n");
+/** Max characters accepted from the OpenBot plugin `instructions` config field. */
+export const MAX_USER_INSTRUCTIONS_LENGTH = 4000;
+/** Trim and cap user-provided coordinator instructions. */
+export function normalizeUserInstructions(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.length > MAX_USER_INSTRUCTIONS_LENGTH
+        ? trimmed.slice(0, MAX_USER_INSTRUCTIONS_LENGTH)
+        : trimmed;
+}
+/** Append capped user instructions to the static system prompt. */
+export function withUserInstructions(basePrompt, value) {
+    const instructions = normalizeUserInstructions(value);
+    if (!instructions)
+        return basePrompt;
+    return [
+        basePrompt,
+        "",
+        "# USER INSTRUCTIONS",
+        "The following are additional instructions from the user. Follow them when they do not conflict with the security policy or core mission above.",
+        instructions,
+    ].join("\n");
+}

package/dist/tools/ask-agent.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
+import { loadAgentModelCatalogs, validateAskModel } from "../agent-models.js";
 /**
  * `ask_agent` — OpenBot sends a message to another agent in its own harness.
  * Only the orchestrator may ask. Child events stream into this thread so the
@@ -13,6 +14,10 @@ export const toolDefinitions = {
                 .string()
                 .describe("The ID of the agent to ask (from INSTALLED AGENTS)."),
             prompt: z.string().describe("The message or question for that agent."),
+            model: z
+                .string()
+                .optional()
+                .describe("Optional model id from that agent's list in INSTALLED AGENTS. Omit to use their default."),
         }),
     },
 };
@@ -34,6 +39,15 @@ async function runAskedAgent(ctx, args) {
             output: "agentId, prompt, and toolCallId are required",
         };
     }
+    const catalogs = await loadAgentModelCatalogs(ctx.storage, [agentId]);
+    const modelCheck = validateAskModel(args.model, catalogs.get(agentId));
+    if (!modelCheck.ok) {
+        return {
+            success: false,
+            error: modelCheck.error,
+            output: modelCheck.error,
+        };
+    }
     const runId = `ask_${randomUUID()}`;
     let lastAgentOutput = "";
     const eventQueue = [];
@@ -49,9 +63,10 @@ async function runAskedAgent(ctx, args) {
                 role: "agent",
                 content: prompt,
                 agentId,
+                ...(modelCheck.model ? { config: { model: modelCheck.model } } : {}),
             },
             meta: {
-                channelId: ctx.channelId ?? ctx.state.channelId ?? '',
+                channelId: ctx.channelId ?? ctx.state.channelId ?? "",
                 threadId: ctx.threadId ?? ctx.state.threadId,
                 parentAgentId: ctx.agentId,
                 parentToolCallId: toolCallId,

package/dist/tools/install-agent.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/**
+ * `install_agent` — OpenBot installs a marketplace specialist so it can ask them.
+ * The host looks up the listing, installs plugins, and materializes AGENT.md.
+ * Approval wrapping happens in `buildOpenbotTools`.
+ */
+export const toolDefinitions = {
+    install_agent: {
+        description: "Install a marketplace agent so you can ask them. Use an id from AVAILABLE AGENTS. The human must approve. After install, ask them with ask_agent.",
+        inputSchema: z.object({
+            agentId: z
+                .string()
+                .describe("The marketplace agent id to install (from AVAILABLE AGENTS)."),
+        }),
+    },
+};
+async function installMarketplaceAgent(ctx, args) {
+    if (ctx.agentId !== ctx.host.orchestratorAgentId) {
+        const message = "Only OpenBot can install agents.";
+        return { success: false, error: message, output: message };
+    }
+    const agentId = typeof args.agentId === "string" ? args.agentId.trim() : "";
+    if (!agentId) {
+        const message = "agentId is required";
+        return { success: false, error: message, output: message };
+    }
+    try {
+        const installed = await ctx.host.installMarketplaceAgent(agentId);
+        const output = `Installed ${installed.name} (${installed.agentId}). You can ask them with ask_agent.`;
+        return {
+            success: true,
+            agentId: installed.agentId,
+            name: installed.name,
+            output,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to install agent";
+        return { success: false, error: message, output: message };
+    }
+}
+export const tools = {
+    install_agent: {
+        ...toolDefinitions.install_agent,
+        execute: async (rawArgs, ctx) => {
+            return installMarketplaceAgent(ctx, (rawArgs ?? {}));
+        },
+    },
+};
+export const installAgentTools = tools;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetopenbot/openbot",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "description": "OpenBot coordinator runtime: ask specialists, route work into Spaces, and track todos.",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
     "@ai-sdk/openai": "^4.0.46",
     "ai": "^7.0.77",
     "zod": "^4.3.5",
-    "@meetopenbot/plugin-sdk": "^1.0.3"
+    "@meetopenbot/plugin-sdk": "^1.0.5"
   },
   "devDependencies": {
     "@types/node": "^20.10.1",