@meetopenbot/openbot 1.2.20 → 1.3.0

package/dist/context.js

@@ -2,6 +2,7 @@ import { formatGitIdentity, readGitIdentity, } from "@meetopenbot/plugin-sdk";
 import { formatAvailableAgentsSection, formatInstalledAgentsSection, loadAgentModelCatalogs, availableMarketplaceAgents, } from "./agent-models.js";
 import { GENERAL_SPACE_ID } from "./space-id.js";
 import { todoService } from "./tools/todo-service.js";
+import { readInvokeSurface, surfaceSection } from "./surface.js";
 export const DEFAULT_CONTEXT_BUDGET = 8000;
 export const MAX_CONTEXT_FILES = 50;
 /**
@@ -30,6 +31,8 @@ export const getContextBudgetForModel = (modelString) => {
 export async function buildContext(state, storage, host) {
     const { channelId, threadId, channelDetails, agentId, threadDetails, } = state;
     const sections = [];
+    // Inline asks skip routing context (marketplace, other Spaces): they never move work.
+    const surface = readInvokeSurface(state.triggerEvent);
     // Fetch agents once if storage is available
     const allAgents = storage?.getAgents
         ? await storage.getAgents().catch(() => [])
@@ -118,7 +121,7 @@ export async function buildContext(state, storage, host) {
         sections.push(formatInstalledAgentsSection(otherAgents, catalogs));
     }
     // 2.7 Marketplace agents not yet installed
-    if (host?.listMarketplaceAgents) {
+    if (!surface && host?.listMarketplaceAgents) {
         try {
             const marketplace = await host.listMarketplaceAgents();
             const available = availableMarketplaceAgents(allAgents, marketplace);
@@ -130,7 +133,7 @@ export async function buildContext(state, storage, host) {
             console.warn("[context] Failed to fetch marketplace agents:", error);
         }
     }
-    if (storage?.getChannels) {
+    if (!surface && storage?.getChannels) {
         try {
             const spaces = (await storage.getChannels());
             if (spaces.length > 0) {
@@ -213,5 +216,7 @@ export async function buildContext(state, storage, host) {
             console.warn("[context] Failed to fetch memories:", error);
         }
     }
+    if (surface)
+        sections.push(surfaceSection(surface));
     return sections.join("\n\n");
 }

package/dist/runtime.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { generateText, streamText, stepCountIs } from 'ai';
+import { generateText, hasToolCall, streamText, stepCountIs } from 'ai';
 import { BYOK_ENV_KEYS, isAuthErrorMessage, isCreditsErrorMessage, fetchModelRegistry, getProviderModelOptions, listApiKeyProviders, PROVIDER_API_KEY_LINKS, } from '@meetopenbot/plugin-sdk';
 import { eventsToModelMessages } from './history.js';
 import { addAttachmentParts, chooseTurnCandidates, eventsHaveAttachments, modelSupportsImages, } from './images.js';
@@ -11,6 +11,7 @@ import { reasoningForModel, resolveModel } from './model.js';
 import { errorFromStreamPart } from './stream-error.js';
 import { createAgentOutputBuffer, isOutputBoundaryPart } from './output-buffer.js';
 import { threadNamingHint } from './thread-naming.js';
+import { readInvokeSurface, RESPOND_TOOL, surfaceTools } from './surface.js';
 async function buildSystemPrompt(state, storage, instructions, host) {
     const context = await buildContext(state, storage, host);
     const sections = [
@@ -18,8 +19,10 @@ async function buildSystemPrompt(state, storage, instructions, host) {
         '',
         context,
     ];
-    const threadState = state.threadDetails?.state;
-    sections.push(...threadNamingHint(threadState));
+    if (!readInvokeSurface(state.triggerEvent)) {
+        const threadState = state.threadDetails?.state;
+        sections.push(...threadNamingHint(threadState));
+    }
     return sections.join('\n');
 }
 function toAiTools(tools, args, flushPendingOutput) {
@@ -222,7 +225,11 @@ async function* attemptFastForward(args, options) {
     return true;
 }
 export async function* runOpenbotTurn(args, options) {
-    const { model: modelString = AUTO_MODEL_ID, authMode = 'byok', instructions, storage, toolDefinitions = {}, abortSignal, host, } = options;
+    const { model: modelString = AUTO_MODEL_ID, authMode = 'byok', instructions, storage, toolDefinitions: allToolDefinitions = {}, abortSignal, host, } = options;
+    // Asked inline from a UI surface: no thread history, a narrowed tool set, and
+    // the run ends when OpenBot calls `respond`.
+    const surface = readInvokeSurface(args.event);
+    const toolDefinitions = surface ? surfaceTools(allToolDefinitions) : allToolDefinitions;
     let configuredModelString = modelString;
     const isCreditsCloudAgent = (id) => host.isCloudSystemAgent(id ?? '') && authMode === 'credits';
     if (!storage || abortSignal?.aborted)
@@ -231,10 +238,12 @@ export async function* runOpenbotTurn(args, options) {
     state.model = configuredModelString;
     const threadId = args.threadId || state.threadId;
     let systemPrompt = await buildSystemPrompt(state, storage, instructions, host);
-    let events = await storage.getEvents({
-        channelId: state.channelId ?? '',
-        threadId,
-    });
+    let events = surface
+        ? [args.event]
+        : await storage.getEvents({
+            channelId: state.channelId ?? '',
+            threadId,
+        });
     const hasAttachments = eventsHaveAttachments(events);
     const candidates = chooseTurnCandidates({ model: configuredModelString, events, authMode });
     const readImage = async (name) => {
@@ -271,7 +280,7 @@ export async function* runOpenbotTurn(args, options) {
         const missingKey = missingByokApiKeyMessage(candidates[0], { authMode });
         if (missingKey)
             throw new Error(missingKey);
-        const forwarded = yield* attemptFastForward(args, {
+        const forwarded = !surface && (yield* attemptFastForward(args, {
             model: configuredModelString,
             authMode,
             storage,
@@ -279,7 +288,7 @@ export async function* runOpenbotTurn(args, options) {
             events: events,
             abortSignal,
             host,
-        });
+        }));
         if (abortSignal?.aborted)
             return;
         if (forwarded) {
@@ -318,7 +327,7 @@ export async function* runOpenbotTurn(args, options) {
                     tools,
                     abortSignal,
                     reasoning: reasoningForModel(candidate),
-                    stopWhen: stepCountIs(20),
+                    stopWhen: surface ? [stepCountIs(8), hasToolCall(RESPOND_TOOL)] : stepCountIs(20),
                     allowSystemInMessages: true,
                 });
                 for await (const part of result.fullStream) {

package/dist/surface.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export const RESPOND_TOOL = 'respond';
+/**
+ * Tools OpenBot keeps when asked inline from a UI surface. Anything that writes
+ * to a thread, a Space, or todos stays out: there is no thread, and the human
+ * did not ask for a job.
+ */
+const SURFACE_TOOL_ALLOWLIST = new Set(['ask_agent', 'recall', RESPOND_TOOL]);
+/** The surface an invoke came from, when it did not come from a thread. */
+export function readInvokeSurface(event) {
+    const raw = event?.meta?.surface;
+    if (!raw || typeof raw.id !== 'string' || !raw.id)
+        return undefined;
+    return {
+        id: raw.id,
+        label: typeof raw.label === 'string' && raw.label ? raw.label : raw.id,
+        intent: typeof raw.intent === 'string' ? raw.intent : '',
+    };
+}
+const respondTool = {
+    description: 'Give the surface the value it asked for. Call exactly once, as your final action; the text is shown to the human as-is.',
+    inputSchema: z.object({
+        text: z.string().describe('The value itself, ready to use. No preamble or quotes.'),
+    }),
+    execute: () => 'Delivered.',
+};
+/** Narrows the coordinator's tools to the surface allowlist and adds `respond`. */
+export function surfaceTools(tools) {
+    const out = {};
+    for (const [name, def] of Object.entries(tools)) {
+        if (SURFACE_TOOL_ALLOWLIST.has(name))
+            out[name] = def;
+    }
+    out[RESPOND_TOOL] = respondTool;
+    return out;
+}
+/** System-prompt section that switches OpenBot from thread mode to inline mode. */
+export function surfaceSection(surface) {
+    return [
+        '## SURFACE',
+        `- You were asked inline from ${surface.label}, not in a thread. There is no job, thread status, title, or todo list here.`,
+        `- Task: ${surface.intent}`,
+        '- The context the surface sent is in the human message. Do this yourself — it is a small, direct ask — and use `ask_agent` only when the answer needs something you cannot see.',
+        `- Finish by calling \`${RESPOND_TOOL}\` once with the result. Do not write anything else.`,
+    ].join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetopenbot/openbot",
-  "version": "1.2.20",
+  "version": "1.3.0",
   "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.72",
     "ai": "^7.0.111",
     "zod": "^4.3.5",
-    "@meetopenbot/plugin-sdk": "^1.3.0"
+    "@meetopenbot/plugin-sdk": "^1.4.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.1",