@meetopenbot/openbot 0.1.14 → 0.2.0

package/dist/auto-model.js

@@ -0,0 +1,67 @@
+import { shouldUseCreditsAuth } from './credits-auth.js';
+/** Product alias shown in the picker. Never sent to a provider or the credits proxy. */
+export const AUTO_MODEL_ID = 'openbot/auto';
+export const AUTO_MODEL_OPTION = {
+    value: AUTO_MODEL_ID,
+    label: 'Auto',
+    description: 'Fast and cheap. OpenBot picks the model.',
+};
+/**
+ * Cheap pool for Auto. Order is preference; failover walks this list.
+ * Intent routing can later pick a member without changing the alias.
+ */
+export const AUTO_MODEL_POOL = [
+    'openai/gpt-5.6-luna',
+    'google/gemini-3.5-flash',
+    'openai/gpt-5.4-nano',
+];
+const PROVIDER_BYOK_ENV = {
+    openai: 'OPENAI_API_KEY',
+    anthropic: 'ANTHROPIC_API_KEY',
+    google: 'GOOGLE_GENERATIVE_AI_API_KEY',
+    deepseek: 'DEEPSEEK_API_KEY',
+};
+export function isAutoModel(modelString) {
+    if (!modelString)
+        return true;
+    const trimmed = modelString.trim();
+    return trimmed === '' || trimmed === AUTO_MODEL_ID || trimmed === 'auto';
+}
+function providerOf(modelString) {
+    return modelString.split('/')[0] ?? '';
+}
+function providerHasByokKey(provider, env) {
+    const key = PROVIDER_BYOK_ENV[provider];
+    return Boolean(key && env[key]?.trim());
+}
+/** Concrete models Auto may call, filtered by credits vs BYOK keys. */
+export function listAutoModelCandidates(ctx) {
+    const pool = [...AUTO_MODEL_POOL];
+    if (shouldUseCreditsAuth(ctx))
+        return pool;
+    const env = ctx?.env ?? process.env;
+    const available = pool.filter((id) => providerHasByokKey(providerOf(id), env));
+    return available.length > 0 ? available : [pool[0]];
+}
+/** MVP picker: first available pool member. Later: classify, then pick. */
+export function pickAutoModel(ctx) {
+    return listAutoModelCandidates(ctx)[0] ?? AUTO_MODEL_POOL[0];
+}
+/** Expand Auto to a concrete provider/id. Pass-through for pinned models. */
+export function expandModelString(modelString, ctx) {
+    if (isAutoModel(modelString))
+        return pickAutoModel(ctx);
+    return modelString.trim();
+}
+export function isRetryableModelError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const lower = message.toLowerCase();
+    return (/\b(429|500|502|503|529)\b/.test(message) ||
+        lower.includes('not supported') ||
+        lower.includes('rate limit') ||
+        lower.includes('overloaded') ||
+        lower.includes('temporarily unavailable') ||
+        lower.includes('timeout') ||
+        lower.includes('econnreset') ||
+        lower.includes('fetch failed'));
+}

package/dist/context.js

@@ -1,5 +1,6 @@
-import { OPENBOT_SYSTEM_PROMPT } from './system-prompt.js';
-import { todoService } from './tools/todo-service.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;
 /**
@@ -7,17 +8,17 @@ export const MAX_CONTEXT_FILES = 50;
  */
 export const getContextBudgetForModel = (modelString) => {
     const budgets = {
-        'openai/gpt-4o': 128000,
-        'openai/gpt-4o-mini': 128000,
-        'openai/o1-preview': 128000,
-        'openai/o1-mini': 128000,
-        'anthropic/claude-3-5-sonnet-20240620': 200000,
-        'anthropic/claude-3-5-sonnet-latest': 200000,
-        'anthropic/claude-3-opus-20240229': 200000,
-        'anthropic/claude-3-sonnet-20240229': 200000,
-        'anthropic/claude-3-haiku-20240307': 200000,
-        'deepseek/deepseek-chat': 64000,
-        'deepseek/deepseek-reasoner': 64000,
+        "openai/gpt-4o": 128000,
+        "openai/gpt-4o-mini": 128000,
+        "openai/o1-preview": 128000,
+        "openai/o1-mini": 128000,
+        "anthropic/claude-3-5-sonnet-20240620": 200000,
+        "anthropic/claude-3-5-sonnet-latest": 200000,
+        "anthropic/claude-3-opus-20240229": 200000,
+        "anthropic/claude-3-sonnet-20240229": 200000,
+        "anthropic/claude-3-haiku-20240307": 200000,
+        "deepseek/deepseek-chat": 64000,
+        "deepseek/deepseek-reasoner": 64000,
     };
     return budgets[modelString] || DEFAULT_CONTEXT_BUDGET;
 };
@@ -25,18 +26,24 @@ export const getContextBudgetForModel = (modelString) => {
  * Simplified context builder for MVP.
  */
 export async function buildContext(state, storage) {
-    const { channelId, threadId, channelDetails, agentId, threadDetails, agentDetails } = state;
+    const { channelId, threadId, channelDetails, agentId, threadDetails, agentDetails, } = state;
     const sections = [];
     // Fetch agents once if storage is available
-    const allAgents = storage?.getAgents ? await storage.getAgents().catch(() => []) : [];
+    const allAgents = storage?.getAgents
+        ? await storage.getAgents().catch(() => [])
+        : [];
     // 1. User
     if (state.currentUser?.userName) {
         sections.push(`## HUMAN\n- Name: ${state.currentUser.userName}`);
     }
     // 2. Environment
-    let env = '## ENVIRONMENT\n';
-    const channelName = channelDetails?.name || channelId;
-    env += `- Mode: Channel (#${channelName})\n`;
+    let env = "## ENVIRONMENT\n";
+    const spaceName = channelDetails?.name || channelId;
+    const isGeneral = channelId === GENERAL_SPACE_ID;
+    env += `- Space: #${channelId || "unknown"} (${spaceName || channelId})\n`;
+    env += isGeneral
+        ? "- Role: inbox — answer questions, listings, and setup here. start_work only for real project work into an existing Space; propose new Spaces before creating them\n"
+        : "- Role: dedicated Space — do the work here; do not start_work unless the human asks to move\n";
     if (channelDetails?.cwd) {
         env += `- Workspace: ${channelDetails.cwd}\n`;
     }
@@ -44,6 +51,45 @@ export async function buildContext(state, storage) {
         env += `- Thread: ${threadDetails?.name || threadId}\n`;
     }
     sections.push(env);
+    if (threadId) {
+        const threadState = threadDetails?.state && typeof threadDetails.state === "object"
+            ? threadDetails.state
+            : undefined;
+        const threadStatus = typeof threadState?.status === "string" && threadState.status.trim()
+            ? threadState.status.trim()
+            : "completed";
+        const threadStatusReason = typeof threadState?.statusReason === "string" && threadState.statusReason.trim()
+            ? threadState.statusReason.trim()
+            : undefined;
+        let statusSection = `## THREAD STATUS\n- Status: ${threadStatus}`;
+        if (threadStatusReason) {
+            statusSection += `\n- Reason: ${threadStatusReason}`;
+        }
+        statusSection +=
+            "\nUse `set_thread_status` to update this. needs_input when blocked on the human; ready_for_review when you believe the job is done. Never set completed or archived.";
+        sections.push(statusSection);
+    }
+    const invokeData = state.triggerEvent?.type === "agent:invoke"
+        ? state.triggerEvent.data
+        : undefined;
+    const mentionedAgentIds = Array.isArray(invokeData?.mentionedAgentIds)
+        ? invokeData.mentionedAgentIds.filter((id) => typeof id === "string" && id.length > 0)
+        : [];
+    const forwardedFromSpaceId = typeof invokeData?.forwardedFromSpaceId === "string"
+        ? invokeData.forwardedFromSpaceId
+        : undefined;
+    if (mentionedAgentIds.length > 0) {
+        const formatted = mentionedAgentIds
+            .map((id) => {
+            const agent = allAgents.find((a) => a.id === id);
+            return `- ${id}${agent?.name && agent.name !== id ? ` (${agent.name})` : ""} — you MUST ask this agent`;
+        })
+            .join("\n");
+        sections.push(`## MENTIONED AGENTS\n${formatted}`);
+    }
+    if (forwardedFromSpaceId) {
+        sections.push(`## FORWARDED WORK\nThis thread was started from #${forwardedFromSpaceId}. Stay in this Space. Do not call start_work again.`);
+    }
     // 2.5 Thread todos
     if (channelId && threadId) {
         try {
@@ -51,35 +97,72 @@ export async function buildContext(state, storage) {
             if (list.items.length > 0) {
                 const formatted = list.items
                     .map((t) => `- [${t.status}] (${t.id}) ${t.content}`)
-                    .join('\n');
+                    .join("\n");
                 sections.push(`## TODOS\n${formatted}`);
             }
         }
         catch (error) {
-            console.warn('[context] Failed to fetch todos:', error);
+            console.warn("[context] Failed to fetch todos:", error);
         }
     }
     // 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}`);
+            .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.`);
+    }
+    if (storage?.getChannels) {
+        try {
+            const spaces = (await storage.getChannels());
+            if (spaces.length > 0) {
+                const formatted = (await Promise.all(spaces.map(async (space) => {
+                    let specHint = "";
+                    if (storage.getChannelDetails) {
+                        try {
+                            const details = await storage.getChannelDetails({
+                                channelId: space.id,
+                            });
+                            const spec = typeof details?.spec === "string"
+                                ? details.spec.trim()
+                                : "";
+                            const excerpt = spec
+                                .split("\n")
+                                .map((line) => line.trim())
+                                .filter((line) => line && !line.startsWith("#"))
+                                .join(" ")
+                                .slice(0, 140);
+                            if (excerpt)
+                                specHint = ` — ${excerpt}`;
+                        }
+                        catch {
+                            // ignore spec lookup failures
+                        }
+                    }
+                    const inbox = space.id === GENERAL_SPACE_ID ? " [inbox]" : "";
+                    return `- ${space.id}: ${space.name || space.id}${inbox}${specHint}`;
+                }))).join("\n");
+                sections.push(`## SPACES\n${formatted}\n\nAnswer questions about available Spaces from this list. Do not create a Space to look them up.`);
+            }
+        }
+        catch (error) {
+            console.warn("[context] Failed to fetch spaces:", error);
+        }
     }
-    // 3. Channel Spec
+    // 3. Space spec
     const spec = channelDetails?.spec?.trim();
     if (spec) {
-        sections.push(`## CHANNEL SPECIFICATION\n${spec}`);
+        sections.push(`## SPACE SPEC\n${spec}`);
     }
-    // 4. Files
-    if (storage?.listFiles && channelId && channelDetails?.cwd) {
+    // 4. Files (dedicated Spaces only — general is an inbox)
+    if (!isGeneral && storage?.listFiles && channelId && channelDetails?.cwd) {
         try {
             const files = await storage.listFiles({ channelId });
             if (files.length > 0) {
                 const limited = files.slice(0, MAX_CONTEXT_FILES);
                 const formatted = limited
-                    .map((f) => `- ${f.name}${f.isDirectory ? '/' : ''}`)
-                    .join('\n');
+                    .map((f) => `- ${f.name}${f.isDirectory ? "/" : ""}`)
+                    .join("\n");
                 let fileSection = `## FILES\n${formatted}`;
                 if (files.length > MAX_CONTEXT_FILES) {
                     fileSection += `\n- ... and ${files.length - MAX_CONTEXT_FILES} more files`;
@@ -87,36 +170,35 @@ export async function buildContext(state, storage) {
                 sections.push(fileSection);
             }
             else {
-                sections.push('## FILES\n- (No files in workspace)');
+                sections.push("## FILES\n- (No files in workspace)");
             }
         }
         catch (error) {
-            console.warn('[context] Failed to fetch files:', error);
+            console.warn("[context] Failed to fetch files:", error);
         }
     }
     // 5. Agent Instructions
     const rawInstructions = agentDetails?.instructions?.trim();
-    if (rawInstructions &&
-        rawInstructions !== OPENBOT_SYSTEM_PROMPT.trim()) {
+    if (rawInstructions && rawInstructions !== OPENBOT_SYSTEM_PROMPT.trim()) {
         sections.push(`## Instructions\n${rawInstructions}`);
     }
     // 6. Memories
     if (storage?.listMemories) {
         try {
-            const scopes = ['global', `agent:${agentId}`];
+            const scopes = ["global", `agent:${agentId}`];
             if (channelId)
                 scopes.push(`channel:${channelId}`);
             const records = await storage.listMemories({ scopes, limit: 20 });
             if (records.length > 0) {
                 const formatted = records
                     .map((r) => `- (${r.scope}) ${r.content}`)
-                    .join('\n');
+                    .join("\n");
                 sections.push(`## MEMORIES\n${formatted}`);
             }
         }
         catch (error) {
-            console.warn('[context] Failed to fetch memories:', error);
+            console.warn("[context] Failed to fetch memories:", error);
         }
     }
-    return sections.join('\n\n');
+    return sections.join("\n\n");
 }

package/dist/history.js

@@ -89,8 +89,9 @@ export function eventsToModelMessages(events) {
             case 'agent:invoke': {
                 const invokeEvent = event;
                 if (invokeEvent.data?.content && invokeEvent.data?.role) {
+                    const role = invokeEvent.data.role === 'agent' ? 'user' : invokeEvent.data.role;
                     messages.push({
-                        role: invokeEvent.data.role,
+                        role,
                         content: invokeEvent.data.content,
                     });
                 }

package/dist/index.js

@@ -1,37 +1,45 @@
-import { defineOpenbotPlugin } from './types.js';
-import { isCloudMode } from './cloud-mode.js';
-import { resolveModelConfigField } from './model-registry.js';
-import { openbotRuntime } from './runtime.js';
-import { bashPlugin } from './tools/bash.js';
-import { memoryPlugin } from './tools/memory.js';
-import { todoPlugin } from './tools/todo.js';
-import { approvalPlugin } from './tools/approval.js';
-import { delegationPlugin } from './tools/delegation.js';
-import { uiPlugin } from './tools/ui.js';
-import { previewPlugin } from './tools/preview.js';
-import { storageToolPlugin } from './tools/storage.js';
-export const OPENBOT_PLUGIN_ID = '@meetopenbot/openbot';
+import { defineOpenbotPlugin } from "./types.js";
+import { isCloudMode } from "./cloud-mode.js";
+import { AUTO_MODEL_ID } from "./auto-model.js";
+import { resolveModelConfigField } from "./model-registry.js";
+import { openbotRuntime } from "./runtime.js";
+import { bashPlugin } from "./tools/bash.js";
+import { memoryPlugin } from "./tools/memory.js";
+import { todoPlugin } from "./tools/todo.js";
+import { approvalPlugin } from "./tools/approval.js";
+import { askAgentPlugin } from "./tools/ask-agent.js";
+import { startWorkPlugin } from "./tools/start-work.js";
+import { threadStatusPlugin } from "./tools/thread-status.js";
+import { uiPlugin } from "./tools/ui.js";
+import { previewPlugin } from "./tools/preview.js";
+import { storageToolPlugin } from "./tools/storage.js";
+export const OPENBOT_PLUGIN_ID = "@meetopenbot/openbot";
 const modelField = await resolveModelConfigField();
+const SPECIALIST_TOOL_NAMES = new Set([
+    ...Object.keys(bashPlugin.toolDefinitions ?? {}),
+    ...Object.keys(previewPlugin.toolDefinitions ?? {}),
+]);
 /**
  * `@meetopenbot/openbot` — the standard, opinionated OpenBot agent runtime.
  *
- * Batteries-included: shell, memory, todo, storage tools, delegation, approval,
- * preview, and the LLM loop.
+ * The orchestrator (`system`) is a coordinator: ask agents, start work in
+ * Spaces, memory, todos, storage. Specialist tools (shell, preview) stay on
+ * non-orchestrator agents that opt into this runtime.
  */
 export const openbotPlugin = defineOpenbotPlugin({
     id: OPENBOT_PLUGIN_ID,
-    name: 'OpenBot Agent',
-    description: 'The standard OpenBot agent runtime with inbuilt tools (shell, memory, todo, storage, delegation, and approval).',
+    name: "OpenBot Agent",
+    description: "OpenBot coordinator runtime: ask specialists, route work into Spaces, and track todos.",
     configSchema: {
-        type: 'object',
+        type: "object",
         properties: {
             ...(isCloudMode()
                 ? {
                     authMode: {
-                        type: 'string',
-                        description: 'Credits — use your workspace credit balance via OpenBot. BYOK — bring your own API key.',
-                        enum: ['credits', 'byok'],
-                        default: 'credits',
+                        type: "string",
+                        description: "Credits — use your workspace credit balance via OpenBot. BYOK — bring your own API key.",
+                        enum: ["credits", "byok"],
+                        default: "credits",
                     },
                 }
                 : {}),
@@ -43,31 +51,41 @@ export const openbotPlugin = defineOpenbotPlugin({
         ...memoryPlugin.toolDefinitions,
         ...todoPlugin.toolDefinitions,
         ...storageToolPlugin.toolDefinitions,
-        ...delegationPlugin.toolDefinitions,
+        ...askAgentPlugin.toolDefinitions,
+        ...startWorkPlugin.toolDefinitions,
+        ...threadStatusPlugin.toolDefinitions,
         ...previewPlugin.toolDefinitions,
     },
     factory: (context) => (builder) => {
         const { agentId, config, storage, tools, abortSignal, host } = context;
-        bashPlugin.factory(context)(builder);
+        const isOrchestrator = agentId === host.orchestratorAgentId;
         memoryPlugin.factory(context)(builder);
         todoPlugin.factory(context)(builder);
         storageToolPlugin.register(context)(builder);
-        delegationPlugin.factory(context)(builder);
+        askAgentPlugin.factory(context)(builder);
+        startWorkPlugin.factory(context)(builder);
+        threadStatusPlugin.factory(context)(builder);
         uiPlugin.factory(context)(builder);
-        previewPlugin.factory(context)(builder);
+        if (!isOrchestrator) {
+            bashPlugin.factory(context)(builder);
+            previewPlugin.factory(context)(builder);
+        }
         const approvalConfig = config?.approval ?? {
             actions: [],
         };
         approvalPlugin.factory({ ...context, config: approvalConfig })(builder);
         const authMode = host.isCloudSystemAgent(agentId)
             ? host.parseOpenbotAuthMode(config?.authMode)
-            : 'byok';
+            : "byok";
+        const toolDefinitions = isOrchestrator
+            ? Object.fromEntries(Object.entries(tools).filter(([name]) => !SPECIALIST_TOOL_NAMES.has(name)))
+            : tools;
         return openbotRuntime({
-            model: config?.model,
+            model: config?.model || AUTO_MODEL_ID,
             authMode,
             agentId,
             storage,
-            toolDefinitions: tools,
+            toolDefinitions,
             abortSignal,
             host,
         })(builder);

package/dist/model-registry.js

@@ -1,3 +1,4 @@
+import { AUTO_MODEL_ID, AUTO_MODEL_OPTION } from './auto-model.js';
 const DEFAULT_REGISTRY_URL = 'https://raw.githubusercontent.com/meetopenbot/openbot-registry/main/registry.json';
 const API_KEY_PROVIDER_IDS = ['openai', 'anthropic', 'google', 'deepseek'];
 export const PROVIDER_API_KEY_LINKS = {
@@ -67,26 +68,26 @@ function listAllModelOptions(registry) {
     }
     return options;
 }
+function withAutoOption(options) {
+    if (options.some((option) => option.value === AUTO_MODEL_ID))
+        return options;
+    return [AUTO_MODEL_OPTION, ...options];
+}
 const freeInputModelField = () => ({
     type: 'string',
-    override: true,
-    description: 'Provider model in provider/model-id format (e.g. openai/gpt-4o-mini).',
-    default: 'openai/gpt-4o-mini',
+    description: 'Auto, or a provider model in provider/model-id format (e.g. openai/gpt-4o-mini).',
+    default: AUTO_MODEL_ID,
 });
 /** Registry-backed model field for plugin configSchema (`enum` + labeled `options`). */
 export async function resolveModelConfigField() {
     const registry = await fetchModelRegistry();
-    const options = listAllModelOptions(registry);
-    if (options.length === 0)
+    const options = withAutoOption(listAllModelOptions(registry));
+    if (options.length === 1)
         return freeInputModelField();
-    const defaultModel = options.find((option) => option.value === 'openai/gpt-4o-mini')?.value ??
-        options.find((option) => option.value.startsWith('openai/'))?.value ??
-        options[0].value;
     return {
         type: 'string',
-        override: true,
-        description: 'Model from the OpenBot registry.',
-        default: defaultModel,
+        description: 'Auto, or a model from the OpenBot registry.',
+        default: AUTO_MODEL_ID,
         enum: options.map((option) => option.value),
         options,
     };

package/dist/model.js

@@ -1,5 +1,6 @@
 import { createOpenAI, openai as defaultOpenai } from '@ai-sdk/openai';
 import { createAnthropic, anthropic } from '@ai-sdk/anthropic';
+import { expandModelString } from './auto-model.js';
 import { CREDITS_API_KEY_PLACEHOLDER, INTEGRATIONS_TOKEN_HEADER, creditsProviderBaseUrl, resolveCreditsAuthConfig, shouldUseCreditsAuth, } from './credits-auth.js';
 const defaultDeepseek = createOpenAI({
     baseURL: 'https://api.deepseek.com',
@@ -9,10 +10,18 @@ const defaultGoogle = createOpenAI({
     baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai',
     apiKey: process.env.GOOGLE_GENERATIVE_AI_API_KEY,
 });
-/** AI SDK 5+ defaults `openai(modelId)` to the Responses API; Gemini compat needs chat. */
+/**
+ * OpenAI-compatible Chat Completions. Gemini/DeepSeek gateways only speak this.
+ * Do not use for OpenAI itself — gpt-5.6-luna rejects function tools on
+ * `/v1/chat/completions` unless `reasoning_effort` is `none`.
+ */
 function openAiChatModel(options, modelId) {
     return createOpenAI(options).chat(modelId);
 }
+/** AI SDK 5+ default: OpenAI Responses API (`/v1/responses`), required for tools on Luna. */
+function openAiResponsesModel(options, modelId) {
+    return createOpenAI(options)(modelId);
+}
 function resolveCreditsProvider(provider, modelId) {
     const config = resolveCreditsAuthConfig();
     if (!config) {
@@ -24,7 +33,7 @@ function resolveCreditsProvider(provider, modelId) {
     const apiKey = config.token || CREDITS_API_KEY_PLACEHOLDER;
     switch (provider) {
         case 'openai':
-            return openAiChatModel({ baseURL, apiKey, headers }, modelId);
+            return openAiResponsesModel({ baseURL, apiKey, headers }, modelId);
         case 'anthropic':
             return createAnthropic({ baseURL, apiKey, headers })(modelId);
         case 'google':
@@ -34,7 +43,8 @@ function resolveCreditsProvider(provider, modelId) {
     }
 }
 export function resolveModel(modelString, options) {
-    const [provider, ...rest] = modelString.split('/');
+    const concrete = expandModelString(modelString, options);
+    const [provider, ...rest] = concrete.split('/');
     const modelId = rest.join('/');
     if (!modelId) {
         throw new Error(`Invalid model string: "${modelString}". Expected "provider/model-id".`);
@@ -42,7 +52,7 @@ export function resolveModel(modelString, options) {
     const useCredits = shouldUseCreditsAuth(options);
     switch (provider) {
         case 'openai':
-            return useCredits ? resolveCreditsProvider('openai', modelId) : defaultOpenai.chat(modelId);
+            return useCredits ? resolveCreditsProvider('openai', modelId) : defaultOpenai(modelId);
         case 'anthropic':
             return useCredits ? resolveCreditsProvider('anthropic', modelId) : anthropic(modelId);
         case 'google':