@meetopenbot/openbot 0.2.7 → 1.0.0

package/dist/tools/start-work.js

@@ -1,7 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { GENERAL_SPACE_ID, isPlaceholderSpaceId, placeholderSpaceError, } from "../space-id.js";
-import { asActionBuilder, } from "../types.js";
 function normalizeSpaceId(raw) {
     return raw
         .trim()
@@ -24,7 +23,14 @@ function startWorkWidget(args) {
         meta: args.meta,
     };
 }
-const startWorkToolDefinitions = {
+function resultMeta(ctx) {
+    return {
+        agentId: ctx.agentId,
+        threadId: ctx.threadId ?? ctx.state.threadId,
+        toolCallId: ctx.toolCallId,
+    };
+}
+export const toolDefinitions = {
     start_work: {
         description: "Start the human's ask in an existing Space. Use from #general for real project work only — not questions, listings, or setup. If the Space does not exist, do not invent one: propose it to the human, then create_channel after they agree. Do not call this on work that was already forwarded.",
         inputSchema: z.object({
@@ -45,149 +51,71 @@ const startWorkToolDefinitions = {
         }),
     },
 };
-export const startWorkPlugin = {
-    id: "start-work",
-    name: "Start work",
-    description: "Forwards an ask into the right Space and starts OpenBot there.",
-    toolDefinitions: startWorkToolDefinitions,
-    factory: (pluginContext) => (builder) => {
-        const actions = asActionBuilder(builder);
-        actions.on("start_work", async function* (event, context) {
-            const data = event.data;
-            const toolCallId = event.meta?.toolCallId;
-            const resultMeta = {
-                ...(event.meta || {}),
-                agentId: context.state.agentId,
-                threadId: event.meta?.threadId || context.state.threadId,
-            };
-            const widgetId = typeof toolCallId === "string"
-                ? toolCallId
+export const tools = {
+    start_work: {
+        ...toolDefinitions.start_work,
+        execute: async (rawArgs, ctx) => {
+            const data = (rawArgs ?? {});
+            const meta = resultMeta(ctx);
+            const widgetId = typeof ctx.toolCallId === "string"
+                ? ctx.toolCallId
                 : `start_work:${Date.now()}`;
-            if (context.state.agentId !== pluginContext.host.orchestratorAgentId) {
-                const error = "Only OpenBot can start work in another Space.";
-                yield startWorkWidget({
+            const fail = async (error, spaceId = "") => {
+                await ctx.emit(startWorkWidget({
                     widgetId,
-                    spaceId: "",
+                    spaceId,
                     body: error,
                     state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+                    meta,
+                }));
+                return { success: false, spaceId, error, output: error };
+            };
+            if (ctx.agentId !== ctx.host.orchestratorAgentId) {
+                return fail("Only OpenBot can start work in another Space.");
             }
-            const invokeData = context.state.triggerEvent?.type === "agent:invoke"
-                ? context.state.triggerEvent.data
+            const invokeData = ctx.state.triggerEvent?.type === "agent:invoke"
+                ? ctx.state.triggerEvent.data
                 : undefined;
             if (typeof invokeData?.forwardedFromSpaceId === "string") {
-                const error = "This thread was already forwarded. Stay here and ask agents; do not start_work again.";
-                yield startWorkWidget({
-                    widgetId,
-                    spaceId: "",
-                    body: error,
-                    state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+                return fail("This thread was already forwarded. Stay here and ask agents; do not start_work again.");
             }
             const spaceId = normalizeSpaceId(data.spaceId || "");
             const prompt = typeof data.prompt === "string" ? data.prompt.trim() : "";
             if (spaceId && isPlaceholderSpaceId(spaceId)) {
-                const error = placeholderSpaceError(spaceId);
-                yield startWorkWidget({
-                    widgetId,
-                    spaceId,
-                    body: error,
-                    state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, spaceId, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+                return fail(placeholderSpaceError(spaceId), spaceId);
             }
             if (!spaceId || !prompt) {
-                const error = "spaceId and prompt are required";
-                yield startWorkWidget({
-                    widgetId,
-                    spaceId,
-                    body: error,
-                    state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, spaceId, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+                return fail("spaceId and prompt are required", spaceId);
             }
-            if (spaceId === context.state.channelId) {
-                const error = `Already in #${spaceId}. Ask an agent here instead of start_work.`;
-                yield startWorkWidget({
-                    widgetId,
-                    spaceId,
-                    body: error,
-                    state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, spaceId, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+            if (spaceId === (ctx.channelId ?? ctx.state.channelId)) {
+                return fail(`Already in #${spaceId}. Ask an agent here instead of start_work.`, spaceId);
             }
-            const storage = pluginContext.storage;
-            const existing = (await storage.getChannels?.().catch(() => []));
+            const existing = (await ctx.storage.getChannels?.().catch(() => []));
             const exists = Array.isArray(existing) &&
                 existing.some((space) => space.id === spaceId);
             if (!exists) {
-                const error = `Space #${spaceId} does not exist. Propose it to the human (name + why). After they agree, use create_channel, then start_work. Do not invent a placeholder Space.`;
-                yield startWorkWidget({
-                    widgetId,
-                    spaceId,
-                    body: error,
-                    state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, spaceId, error, output: error },
-                    meta: resultMeta,
-                };
-                return;
+                return fail(`Space #${spaceId} does not exist. Propose it to the human (name + why). After they agree, use create_channel, then start_work. Do not invent a placeholder Space.`, spaceId);
             }
             const threadId = randomUUID();
             const threadTitle = typeof data.title === "string" && data.title.trim()
                 ? data.title.trim()
                 : undefined;
             const threadUrl = `/channels/${encodeURIComponent(spaceId)}/threads/${encodeURIComponent(threadId)}`;
-            const fromSpace = context.state.channelId || GENERAL_SPACE_ID;
-            yield startWorkWidget({
+            const fromSpace = ctx.channelId ?? ctx.state.channelId ?? GENERAL_SPACE_ID;
+            await ctx.emit(startWorkWidget({
                 widgetId,
                 spaceId,
                 body: `Starting in #${spaceId}…`,
                 state: "open",
-                meta: resultMeta,
-            });
+                meta,
+            }));
             try {
-                await storage.createThread({
+                await ctx.storage.createThread({
                     channelId: spaceId,
                     threadId,
                     threadTitle,
                     initialState: {
-                        respondingAgentId: pluginContext.host.orchestratorAgentId,
+                        respondingAgentId: ctx.host.orchestratorAgentId,
                         ...(threadTitle ? { name: threadTitle } : {}),
                     },
                 });
@@ -205,58 +133,50 @@ export const startWorkPlugin = {
                     meta: {
                         channelId: spaceId,
                         threadId,
-                        userId: context.state.triggerEvent?.meta?.userId,
-                        userName: context.state.triggerEvent?.meta?.userName,
-                        userAvatarUrl: context.state.triggerEvent?.meta?.userAvatarUrl,
+                        userId: ctx.state.triggerEvent?.meta?.userId,
+                        userName: ctx.state.triggerEvent?.meta?.userName,
+                        userAvatarUrl: ctx.state.triggerEvent?.meta?.userAvatarUrl,
                     },
                 };
-                await pluginContext.host.runAgent({
+                await ctx.host.runAgent({
                     runId: `sw_${randomUUID()}`,
-                    agentId: pluginContext.host.orchestratorAgentId,
+                    agentId: ctx.host.orchestratorAgentId,
                     event: invokeEvent,
-                    publicBaseUrl: pluginContext.publicBaseUrl,
+                    publicBaseUrl: ctx.publicBaseUrl,
                     persistEvents: true,
                     onEvent: async () => {
                         // Persist in the target Space via the inner harness. Do not echo into this thread.
                     },
                 });
                 const output = `Started work in #${spaceId}. Open ${threadUrl}`;
-                yield startWorkWidget({
+                await ctx.emit(startWorkWidget({
                     widgetId,
                     spaceId,
                     body: output,
                     state: "submitted",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: {
-                        success: true,
-                        spaceId,
-                        threadId,
-                        threadUrl,
-                        output,
-                    },
-                    meta: resultMeta,
+                    meta,
+                }));
+                return {
+                    success: true,
+                    spaceId,
+                    threadId,
+                    threadUrl,
+                    output,
                 };
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : "Unknown error";
                 const output = `Failed to start work in #${spaceId}: ${message}`;
-                yield startWorkWidget({
+                await ctx.emit(startWorkWidget({
                     widgetId,
                     spaceId,
                     body: output,
                     state: "error",
-                    meta: resultMeta,
-                });
-                yield {
-                    type: "action:start_work:result",
-                    data: { success: false, spaceId, threadId, error: message, output },
-                    meta: resultMeta,
-                };
+                    meta,
+                }));
+                return { success: false, spaceId, threadId, error: message, output };
             }
-        });
+        },
     },
 };
-export default startWorkPlugin;
+export const startWorkTools = tools;