openbot 0.3.1 → 0.3.2

package/src/plugins/delegation/index.ts

@@ -3,26 +3,18 @@ import z from 'zod';
 import type { Plugin } from '../../bus/plugin.js';
 import { OpenBotEvent, OpenBotState } from '../../app/types.js';
 
-const delegationToolDefinitions = {
+const handoffToolDefinitions = {
   handoff: {
     description:
-      'Transfer control to another agent. The target agent continues the task and you do not wait for a tool result.',
+      'Transfer control to another agent. The target agent continues the task in this thread.',
     inputSchema: z.object({
       agentId: z.string().describe('The ID of the target agent.'),
       content: z.string().describe('The message or task to hand off.'),
     }),
   },
-  delegate: {
-    description:
-      'Delegate a subtask to another agent and wait for its result so you can continue.',
-    inputSchema: z.object({
-      agentId: z.string().describe('The ID of the target agent.'),
-      content: z.string().describe('The subtask you want the target agent to execute.'),
-    }),
-  },
 };
 
-const delegationPluginRuntime = (): MelonyPlugin<OpenBotState, OpenBotEvent> => (builder) => {
+const handoffPluginRuntime = (): MelonyPlugin<OpenBotState, OpenBotEvent> => (builder) => {
   builder.on('action:handoff', async function* (event, context) {
     const { agentId, content } = event.data;
 
@@ -46,49 +38,14 @@ const delegationPluginRuntime = (): MelonyPlugin<OpenBotState, OpenBotEvent> =>
       };
     }
   });
-
-  builder.on('action:delegate', async function* (event, context) {
-    const { agentId, content } = event.data;
-    const widgetId = event.meta?.toolCallId
-      ? `delegate_${event.meta.toolCallId}`
-      : `delegate_${Date.now()}`;
-
-    yield {
-      type: 'client:ui:widget',
-      data: {
-        kind: 'message',
-        widgetId,
-        title: `Delegation started: ${agentId}`,
-        body: `Running delegated task in background.\n\n${content}`,
-        state: 'open',
-        metadata: {
-          type: 'delegation:status',
-          phase: 'started',
-          delegatedAgentId: agentId,
-        },
-      },
-      meta: { ...(event.meta || {}), agentId: context.state.agentId },
-    };
-
-    yield {
-      type: 'delegation:request',
-      data: { agentId, content },
-      meta: {
-        ...(event.meta || {}),
-        parentAgentId: context.state.agentId,
-        delegationWidgetId: widgetId,
-        agentId: context.state.agentId,
-      },
-    };
-  });
 };
 
 export const delegationPlugin: Plugin = {
   id: 'delegation',
-  name: 'Delegation',
-  description: 'Hand off or delegate sub-tasks to other agents on the bus.',
-  toolDefinitions: delegationToolDefinitions,
-  factory: () => delegationPluginRuntime(),
+  name: 'Handoff',
+  description: 'Hand off tasks to other agents on the bus.',
+  toolDefinitions: handoffToolDefinitions,
+  factory: () => handoffPluginRuntime(),
 };
 
 export default delegationPlugin;

package/src/plugins/storage-tools/index.ts

@@ -52,25 +52,14 @@ const storageToolDefinitions = {
       ),
   },
   patch_thread_details: {
-    description: 'Patch current thread details (state and/or spec).',
-    inputSchema: z
-      .object({
-        state: z
-          .record(z.string(), z.unknown())
-          .optional()
-          .describe(
-            'JSON state object for the thread. Use for structured data like `todos` or progress.',
-          ),
-        spec: z
-          .string()
-          .optional()
-          .describe(
-            'Markdown content for the thread specification (SPEC.md). Use for plans and goals.',
-          ),
-      })
-      .refine((value) => value.state !== undefined || value.spec !== undefined, {
-        message: 'Provide at least one of state or spec.',
-      }),
+    description: 'Patch current thread details (state).',
+    inputSchema: z.object({
+      state: z
+        .record(z.string(), z.unknown())
+        .describe(
+          'JSON state object for the thread. Use for structured data like `todos` or progress.',
+        ),
+    }),
   },
   create_variable: {
     description: 'Create or update a variable in the workspace storage.',

package/src/plugins/todo/index.ts

@@ -0,0 +1,64 @@
+import z from 'zod';
+import type { Plugin } from '../../bus/plugin.js';
+
+/**
+ * `todo` — shared, per-thread task list for autonomous multi-agent flows.
+ *
+ * Todos live in `threadDetails.state.todos` and are owned by the system
+ * (handlers in `bus/services.ts`). Any agent in the thread can read the
+ * list via context, and propose mutations through these tools. Each item
+ * may carry an `assignee` agent id; combine with `handoff` to drive an
+ * autonomous, multi-step plan across agents.
+ *
+ * Keep the surface minimal: two tools (replace-all, patch-one) cover plan
+ * authoring, status transitions, and reassignment.
+ */
+const todoStatus = z.enum(['pending', 'in_progress', 'done', 'cancelled']);
+
+const todoToolDefinitions = {
+  todo_write: {
+    description:
+      'Author or rewrite the shared todo plan for the current thread. Pass the full ordered list — missing items are removed. Use at the start of multi-step work, or whenever the plan changes shape. For status flips, prefer `todo_update`.',
+    inputSchema: z.object({
+      todos: z
+        .array(
+          z.object({
+            id: z
+              .string()
+              .optional()
+              .describe('Stable id. Reuse existing ids to preserve history; omit to create.'),
+            content: z.string().min(1).describe('What needs to be done. One concrete step.'),
+            status: todoStatus.optional().describe('Defaults to `pending`.'),
+            assignee: z
+              .string()
+              .optional()
+              .describe('Agent id responsible for this step. Pair with `handoff` to delegate.'),
+          }),
+        )
+        .describe('The complete, ordered plan.'),
+    }),
+  },
+  todo_update: {
+    description:
+      'Patch a single todo by id. Use to mark progress (`in_progress`, `done`, `cancelled`), rephrase, or reassign without rewriting the whole list.',
+    inputSchema: z.object({
+      id: z.string().describe('Todo id from `todo_write` or the rendered list.'),
+      status: todoStatus.optional(),
+      content: z.string().min(1).optional(),
+      assignee: z.string().optional().describe('Use empty string to clear.'),
+    }),
+  },
+};
+
+export const todoPlugin: Plugin = {
+  id: 'todo',
+  name: 'Todo',
+  description:
+    'Shared per-thread task list for coordinating multi-step, multi-agent work.',
+  toolDefinitions: todoToolDefinitions,
+  factory: () => () => {
+    // Handlers live in bus/services.ts; this plugin only contributes tool definitions.
+  },
+};
+
+export default todoPlugin;

package/src/registry/plugins.ts

@@ -10,6 +10,7 @@ import { storageToolsPlugin } from '../plugins/storage-tools/index.js';
 import { uiPlugin } from '../plugins/ui/index.js';
 import { approvalPlugin } from '../plugins/approval/index.js';
 import { memoryPlugin } from '../plugins/memory/index.js';
+import { todoPlugin } from '../plugins/todo/index.js';
 import { DEFAULT_PLUGINS_DIR, DEFAULT_BASE_DIR, loadConfig, resolvePath } from '../app/config.js';
 
 let pluginsDir: string | null = null;
@@ -25,6 +26,7 @@ const BUILT_IN: Record<string, Plugin> = {
   [uiPlugin.id]: uiPlugin,
   [approvalPlugin.id]: approvalPlugin,
   [memoryPlugin.id]: memoryPlugin,
+  [todoPlugin.id]: todoPlugin,
 };
 
 /**
@@ -50,8 +52,6 @@ export function parsePluginModule(
   const name = typeof raw.name === 'string' ? raw.name : '';
   const description = typeof raw.description === 'string' ? raw.description : '';
   const image = typeof raw.image === 'string' ? raw.image : undefined;
-  const defaultInstructions =
-    typeof raw.defaultInstructions === 'string' ? raw.defaultInstructions : undefined;
   const configSchema = raw.configSchema as Plugin['configSchema'];
   const toolDefinitions = raw.toolDefinitions as Plugin['toolDefinitions'];
 
@@ -59,7 +59,6 @@ export function parsePluginModule(
     name,
     description,
     image,
-    defaultInstructions,
     configSchema,
     toolDefinitions,
     factory: factory as Plugin['factory'],

package/src/services/storage.ts

@@ -91,7 +91,7 @@ const SYSTEM_DEFAULT_PLUGINS: PluginRef[] = [
   { id: 'storage-tools' },
   // { id: 'mcp' },
   { id: 'shell' },
-  { id: 'delegation' },
+  { id: 'todo' },
   // { id: 'ui' },
   { id: 'approval' },
   { id: 'memory' },
@@ -103,7 +103,7 @@ function getSystemAgentDetails(overrides?: Partial<AgentDetails>): AgentDetails
     name: 'OpenBot',
     image: undefined,
     description:
-      'First-party orchestration agent for OpenBot. Coordinates other agents via handoff and delegation.',
+      'First-party orchestration agent for OpenBot. Coordinates other agents via handoff.',
     instructions: AI_SDK_SYSTEM_PROMPT,
     plugins: SYSTEM_DEFAULT_PLUGINS.map((ref) => ref.id),
     pluginRefs: SYSTEM_DEFAULT_PLUGINS,
@@ -211,7 +211,6 @@ const listBuiltInPluginDescriptors = async (): Promise<PluginDescriptor[]> => {
     description: plugin.description,
     builtIn: true,
     image: plugin.image,
-    defaultInstructions: plugin.defaultInstructions,
     configSchema: plugin.configSchema,
     createdAt: new Date(),
     updatedAt: new Date(),
@@ -281,7 +280,6 @@ const listPluginsFromDisk = async (): Promise<PluginDescriptor[]> => {
           description: parsed.description || '',
           builtIn: false,
           image: parsed.image || image,
-          defaultInstructions: parsed.defaultInstructions,
           configSchema: parsed.configSchema,
           createdAt: new Date(),
           updatedAt: new Date(),
@@ -450,13 +448,11 @@ export const storageService = {
     channelId,
     threadId,
     threadTitle,
-    spec,
     initialState,
   }: {
     channelId: string;
     threadId: string;
     threadTitle?: string;
-    spec?: string;
     initialState?: Record<string, unknown>;
   }): Promise<void> => {
     const normalizedChannelId = channelId.trim();
@@ -466,7 +462,6 @@ export const storageService = {
     if (!normalizedThreadId) throw new Error('threadId is required');
 
     const threadDir = getConversationDir(normalizedChannelId, normalizedThreadId);
-    const specPath = `${threadDir}/SPEC.md`;
     const statePath = `${threadDir}/state.json`;
 
     try {
@@ -487,11 +482,6 @@ export const storageService = {
     }
 
     await fs.mkdir(threadDir, { recursive: true });
-    await fs.writeFile(
-      specPath,
-      spec?.trim() ||
-        `# ${normalizedThreadId}\n\nDefine the goals and plan for this thread here.\n`,
-    );
     await fs.writeFile(statePath, JSON.stringify(baseState, null, 2));
   },
   getThreads: async ({ channelId }: { channelId: string }): Promise<Thread[]> => {
@@ -550,21 +540,8 @@ export const storageService = {
     threadId: string;
   }): Promise<ThreadDetails> => {
     const threadDir = getConversationDir(channelId, threadId);
-    const specPath = `${threadDir}/SPEC.md`;
     const statePath = `${threadDir}/state.json`;
 
-    let spec = '';
-    try {
-      spec = await fs.readFile(specPath, 'utf-8');
-    } catch (error: unknown) {
-      if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') {
-        console.error(
-          `Failed to read thread spec for channel ${channelId} thread ${threadId}`,
-          error,
-        );
-      }
-    }
-
     let state: unknown = {};
     try {
       const stateContent = await fs.readFile(statePath, 'utf-8');
@@ -587,7 +564,6 @@ export const storageService = {
       id: threadId,
       name: generatedName || threadId,
       channelId,
-      spec,
       state,
     };
   },
@@ -704,29 +680,6 @@ export const storageService = {
       throw error;
     }
   },
-  patchThreadSpec: async ({
-    channelId,
-    threadId,
-    spec,
-  }: {
-    channelId: string;
-    threadId: string;
-    spec: string;
-  }): Promise<void> => {
-    const threadDir = getConversationDir(channelId, threadId);
-    const specPath = `${threadDir}/SPEC.md`;
-
-    try {
-      await fs.mkdir(threadDir, { recursive: true });
-      await fs.writeFile(specPath, spec);
-    } catch (error) {
-      console.error(
-        `Failed to patch thread spec for channel ${channelId} thread ${threadId}`,
-        error,
-      );
-      throw error;
-    }
-  },
   getAgents: async (): Promise<Agent[]> => {
     const agentsDir = resolvePath(resolveBaseDir() + '/' + DEFAULT_AGENTS_DIR);
     try {