@meetopenbot/openbot 1.2.18 → 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.",

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.18",
+  "version": "1.2.19",
   "description": "OpenBot coordinator runtime: ask specialists, route work into Spaces, and track todos.",
   "type": "module",
   "main": "./dist/index.js",