@meetopenbot/openbot 1.2.17 → 1.2.19

package/dist/build-tools.js

@@ -6,6 +6,7 @@ import { installAgentTools } from "./tools/install-agent.js";
 import { threadStatusTools } from "./tools/thread-status.js";
 import { threadTitleTools } from "./tools/thread-title.js";
 import { previewTools } from "./tools/preview.js";
+import { suggestSpaceTools } from "./tools/suggest-space.js";
 import { wrapToolsWithApproval } from "./tools/approval.js";
 export const DEFAULT_APPROVAL_ACTIONS = ["update_channel_spec"];
 /**
@@ -22,6 +23,7 @@ export function buildOpenbotTools(args) {
         ...threadStatusTools,
         ...threadTitleTools,
         ...previewTools,
+        ...suggestSpaceTools,
         ...args.context.tools,
     };
     const approvalConfig = args.context.config?.approval;

package/dist/index.js

@@ -11,6 +11,7 @@ import { installAgentTools } from './tools/install-agent.js';
 import { threadStatusTools } from './tools/thread-status.js';
 import { threadTitleTools } from './tools/thread-title.js';
 import { previewTools } from './tools/preview.js';
+import { suggestSpaceTools } from './tools/suggest-space.js';
 import { buildOpenbotTools } from './build-tools.js';
 export const OPENBOT_PLUGIN_ID = '@meetopenbot/openbot';
 const modelField = await modelConfigField({
@@ -51,6 +52,7 @@ export const openbotPlugin = defineOpenbotPlugin({
         ...threadStatusTools,
         ...threadTitleTools,
         ...previewTools,
+        ...suggestSpaceTools,
     },
     async *run(args) {
         const { context } = args;

package/dist/system-prompt.js

@@ -15,7 +15,7 @@ export const OPENBOT_SYSTEM_PROMPT = [
     "# THE AGENT LOOP",
     "You operate in an iterative loop:",
     "1. **Analyze Events**: Understand the human, mentioned people, the current Space, and `## SPACES`.",
-    "2. **Right Space**: Use `## SPACES` to see where work belongs. If the human's intent clearly fits a different existing Space than the one you are in — especially project work posted in `#general` — do not move or copy their message. Reply in plain text: name the Space (e.g. `#checkout`), why it fits, and that they can open that Space and send the same ask there to start a thread. In `#general`, handle questions, listings, setup, and routing only; do not run project execution there. If they are already in the right Space, continue with `ask_agent`. If no Space fits, propose a concrete name and why, then wait for the human to agree before `create_channel` — unless they already named a new Space or explicitly asked you to create it. Never invent placeholder ids (`noop`, `temp`, `misc`, `untitled`).",
+    "2. **Right Space**: Use `## SPACES` to see where work belongs. If the human's intent clearly fits a different existing Space than the one you are in — especially project work posted in `#general` — call `suggest_space` with that Space id, a self-contained version of their ask, and a one-line reason, then stop. Do not also explain it in prose, and do not `ask_agent` in this thread. Do not move or copy their message. In `#general`, handle questions, listings, setup, and routing only; do not run project execution there. If they are already in the right Space, continue with `ask_agent`. If no Space fits, propose a concrete name and why, then wait for the human to agree before `create_channel` — unless they already named a new Space or explicitly asked you to create it. Never invent placeholder ids (`noop`, `temp`, `misc`, `untitled`). Never call `suggest_space` for a Space that is not in `## SPACES`.",
     "3. **Ask people**: Use `ask_agent` to send a message to a specialist. Write it as a request to a colleague, not as a tool invocation.",
     "4. **Wait**: Let the asked agent run in its own harness. Read their reply, then continue or ask someone else.",
     "5. **Close**: The human already saw the specialist speak in this thread. Do not restate, re-bullet, or paraphrase their findings. Name who you asked, then add only what is new — a decision, a conflict, a next step, or a caveat. If nothing is new, close in one or two sentences.",
@@ -42,7 +42,7 @@ export const OPENBOT_SYSTEM_PROMPT = [
     "- The current status is injected each turn as `## THREAD STATUS`.",
     "",
     "# 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. When the human is in the wrong Space, tell them which Space to use and let them post there; never auto-move threads or messages. Create a new Space only when the human asked for one, or they agreed after you suggested it.',
+    '- **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. When the human is in the wrong existing Space, call `suggest_space` and stop so they can edit the Space and the message, then send it as a new thread. Never auto-move threads or messages. 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.",
@@ -61,7 +61,7 @@ export const OPENBOT_SYSTEM_PROMPT = [
     "This runtime is a remote cloud computer. The human is in the browser at openbot.one and cannot open localhost, 127.0.0.1, or any port on this machine.",
     "- Never tell them to visit localhost. They need a public HTTPS URL.",
     "- When you ask a coding agent to run a dev server, preview, or any local process the human should open, tell them to expose it with `cloudflared tunnel --url http://127.0.0.1:<port>` and to add `cloudflared` as a **project devDependency** (not a global install — this image is ephemeral and only workspace files persist).",
-    "- Share the `https://*.trycloudflare.com` URL they print, and call `open_preview` with it so it opens in the space browser. Quick tunnels change on restart — pass the new one through. If they report a localhost URL, ask them to tunnel it.",
+    "- After the specialist finishes, inspect the URL they report, share the `https://*.trycloudflare.com` URL, and call `open_preview` with it so it opens in the space browser. Quick tunnels change on restart — pass the new one through. If they report a localhost URL, ask them to tunnel it.",
     "- For any other public page the human should see, call `open_preview` with that http(s) URL too. Never pass localhost, 127.0.0.1, or a port on this machine.",
     "",
     "# SPACE VARIABLES",

package/dist/tools/ask-agent.js

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { loadAgentModelCatalogs, validateAskModel } from "../agent-models.js";
-import { previewEventsForTunnelUrls } from "./preview.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
@@ -104,8 +103,6 @@ async function runAskedAgent(ctx, args) {
             resolveNext = null;
         }
     });
-    const seenPreviewUrls = new Set();
-    const threadId = ctx.threadId ?? ctx.state.threadId;
     while (!isFinished || eventQueue.length > 0) {
         if (eventQueue.length === 0) {
             await new Promise((r) => {
@@ -115,12 +112,6 @@ async function runAskedAgent(ctx, args) {
         while (eventQueue.length > 0) {
             const nextEvent = eventQueue.shift();
             await ctx.emit(nextEvent);
-            for (const preview of previewEventsForTunnelUrls(nextEvent, seenPreviewUrls, {
-                agentId: ctx.agentId,
-                threadId,
-            })) {
-                await ctx.emit(preview);
-            }
         }
     }
     await runPromise;

package/dist/tools/preview.js

@@ -25,35 +25,6 @@ export function publicPreviewUrl(input) {
         return null;
     return url.href;
 }
-const TUNNEL_URL = /https:\/\/[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*\.trycloudflare\.com(?::\d+)?(?:\/[^\s<>"'`)\\\]]*)?/gi;
-const MAX_SCAN_CHARS = 250000;
-function cleanMatch(raw) {
-    return raw.replace(/[.,;:!?)]+$/g, '');
-}
-/** Public Cloudflare quick-tunnel URLs mentioned in specialist output. */
-export function tunnelPreviewUrls(value) {
-    let text;
-    try {
-        text = typeof value === 'string' ? value : JSON.stringify(value) ?? '';
-    }
-    catch {
-        return [];
-    }
-    if (!text)
-        return [];
-    if (text.length > MAX_SCAN_CHARS)
-        text = text.slice(0, MAX_SCAN_CHARS);
-    const seen = new Set();
-    const urls = [];
-    for (const match of text.matchAll(TUNNEL_URL)) {
-        const url = publicPreviewUrl(cleanMatch(match[0]));
-        if (!url || seen.has(url))
-            continue;
-        seen.add(url);
-        urls.push(url);
-    }
-    return urls;
-}
 export function previewWidgetEvent(args) {
     return {
         type: 'client:ui:widget',
@@ -80,17 +51,6 @@ export function previewWidgetEvent(args) {
         },
     };
 }
-/** Preview widgets for tunnel URLs in `value` that `seen` has not emitted yet. */
-export function previewEventsForTunnelUrls(value, seen, meta) {
-    const events = [];
-    for (const url of tunnelPreviewUrls(value)) {
-        if (seen.has(url))
-            continue;
-        seen.add(url);
-        events.push(previewWidgetEvent({ url, ...meta }));
-    }
-    return events;
-}
 async function openPreview(rawArgs, ctx) {
     const channelId = ctx.channelId ?? ctx.state.channelId ?? '';
     const threadId = ctx.threadId ?? ctx.state.threadId;

package/dist/tools/suggest-space.js

@@ -0,0 +1,115 @@
+import z from 'zod';
+import { isPlaceholderSpaceId } from '../space-id.js';
+/** Widget metadata the client uses to render a Space handoff card. */
+export const SPACE_HANDOFF_TYPE = 'space_handoff';
+const MAX_MESSAGE_LENGTH = 8000;
+const MAX_REASON_LENGTH = 240;
+function normalizeChannelId(raw) {
+    return raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '');
+}
+function spaceOptionLabel(space) {
+    const name = space.name?.trim();
+    if (!name || name.toLowerCase() === space.id)
+        return `#${space.id}`;
+    return `#${space.id} · ${name}`;
+}
+function failure(channelId, error) {
+    return { success: false, channelId, error, output: error };
+}
+async function suggestSpace(rawArgs, ctx) {
+    const data = (rawArgs ?? {});
+    const channelId = normalizeChannelId(typeof data.channelId === 'string' ? data.channelId : '');
+    const message = typeof data.message === 'string' ? data.message.trim() : '';
+    const reason = typeof data.reason === 'string' ? data.reason.trim().slice(0, MAX_REASON_LENGTH) : '';
+    const currentId = normalizeChannelId(ctx.channelId ?? ctx.state.channelId ?? '');
+    if (!channelId)
+        return failure('', 'channelId is required');
+    if (isPlaceholderSpaceId(channelId)) {
+        return failure(channelId, `Refused to suggest #${channelId}: that looks like a placeholder, not a real Space.`);
+    }
+    if (!message)
+        return failure(channelId, 'message is required');
+    if (message.length > MAX_MESSAGE_LENGTH) {
+        return failure(channelId, `message must be ${MAX_MESSAGE_LENGTH} characters or fewer.`);
+    }
+    if (currentId && channelId === currentId) {
+        return failure(channelId, `Already in #${channelId}. Continue here with ask_agent.`);
+    }
+    const channels = (await ctx.storage.getChannels());
+    const target = channels.find((space) => normalizeChannelId(space.id) === channelId);
+    if (!target) {
+        return failure(channelId, `Space #${channelId} does not exist. Suggest a name and wait before create_channel.`);
+    }
+    const targetId = target.id;
+    const options = channels
+        .filter((space) => normalizeChannelId(space.id) !== currentId)
+        .map((space) => ({ label: spaceOptionLabel(space), value: space.id }));
+    const threadId = ctx.threadId ?? ctx.state.threadId;
+    const description = reason || `This belongs in #${targetId}.`;
+    await ctx.emit({
+        type: 'client:ui:widget',
+        data: {
+            widgetId: ctx.toolCallId ?? `suggest_space:${targetId}`,
+            kind: 'form',
+            title: `Run this in #${targetId}`,
+            description,
+            fields: [
+                {
+                    id: 'channelId',
+                    label: 'Space',
+                    type: 'select',
+                    required: true,
+                    defaultValue: targetId,
+                    options,
+                },
+                {
+                    id: 'message',
+                    label: 'Message',
+                    type: 'textarea',
+                    required: true,
+                    defaultValue: message,
+                    placeholder: 'What should OpenBot do there?',
+                },
+            ],
+            actions: [
+                {
+                    id: 'start_in_space',
+                    label: 'Send',
+                    variant: 'primary',
+                    value: { channelId: targetId },
+                },
+            ],
+            display: 'expanded',
+            state: 'open',
+            metadata: { type: SPACE_HANDOFF_TYPE, channelId: targetId },
+        },
+        meta: {
+            agentId: ctx.agentId,
+            ...(threadId ? { threadId } : {}),
+        },
+    });
+    const output = `Showed a handoff to #${targetId}. Stop. Do not ask_agent in this thread and do not explain the handoff in prose. The human sends the message there if they confirm.`;
+    return { success: true, channelId: targetId, output };
+}
+export const suggestSpaceTools = {
+    suggest_space: {
+        description: 'When the human is in the wrong existing Space, show a card with that Space and a self-contained version of their ask. They can edit both, then send it as a new thread there. Call this and stop. Do not ask_agent in this thread. Only use a Space id from ## SPACES, never the current Space, and never a Space you have not created yet.',
+        inputSchema: z.object({
+            channelId: z
+                .string()
+                .describe('Existing Space id from ## SPACES. Not the Space you are in.'),
+            message: z
+                .string()
+                .describe("The human's ask, rewritten so it stands alone in that Space. They can edit it before sending."),
+            reason: z
+                .string()
+                .optional()
+                .describe('One line on why this Space fits. Shown on the card.'),
+        }),
+        execute: suggestSpace,
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetopenbot/openbot",
-  "version": "1.2.17",
+  "version": "1.2.19",
   "description": "OpenBot coordinator runtime: ask specialists, route work into Spaces, and track todos.",
   "type": "module",
   "main": "./dist/index.js",