openbot 0.4.6 → 0.4.7

package/dist/app/cli.js

@@ -16,7 +16,7 @@ function checkNodeVersion() {
     }
 }
 checkNodeVersion();
-program.name('openbot').description('OpenBot CLI').version('0.4.6');
+program.name('openbot').description('OpenBot CLI').version('0.4.7');
 program
     .command('start')
     .description('Start the OpenBot harness')

package/dist/app/responding-agent.js

@@ -2,6 +2,17 @@ import { ORCHESTRATOR_AGENT_ID } from './agent-ids.js';
 import { storageService } from '../plugins/storage/service.js';
 /** Thread `state.json` key for the sticky responding agent id. */
 export const THREAD_RESPONDING_AGENT_ID_KEY = 'respondingAgentId';
+/** Publish events that continue a pending UI interaction rather than a new user turn. */
+export const CONTINUATION_EVENT_TYPES = new Set(['client:ui:widget:response']);
+const readMetaAgentId = (meta) => {
+    if (!meta || typeof meta !== 'object')
+        return undefined;
+    const value = meta.agentId;
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+};
 const readBoundAgentId = (state) => {
     if (!state || typeof state !== 'object')
         return undefined;
@@ -46,3 +57,24 @@ export async function resolveRespondingAgentId(options) {
     });
     return { agentId: fallback, bound: true, overridden: false };
 }
+/**
+ * Resolves the agent that should handle a publish event.
+ * UI continuations route to the widget origin agent; everything else uses sticky thread binding.
+ */
+export async function resolvePublishTargetAgentId(options) {
+    const { eventType, channelId, threadId, requestedAgentId, eventMeta, bindIfUnbound } = options;
+    if (CONTINUATION_EVENT_TYPES.has(eventType)) {
+        const originAgentId = readMetaAgentId(eventMeta) || requestedAgentId?.trim();
+        if (!originAgentId) {
+            return { error: 'agentId_required' };
+        }
+        return { agentId: originAgentId };
+    }
+    const resolved = await resolveRespondingAgentId({
+        channelId,
+        threadId,
+        requestedAgentId,
+        bindIfUnbound,
+    });
+    return { agentId: resolved.agentId };
+}

package/dist/app/server.js

@@ -16,7 +16,7 @@ import { storageService } from '../plugins/storage/service.js';
 import { buildWorkspaceFileUrl, getPublicBaseUrl, openChannelFileStream, } from '../plugins/storage/files.js';
 import { ensureEventId, openBotEventFromQuery } from './utils.js';
 import { abortRegistry, abortKey } from '../services/abort.js';
-import { resolveRespondingAgentId } from './responding-agent.js';
+import { resolvePublishTargetAgentId, resolveRespondingAgentId } from './responding-agent.js';
 import { DEFAULT_UNCATEGORIZED_SPEC, UNCATEGORIZED_CHANNEL_ID, } from './channel-ids.js';
 export async function startServer(options = {}) {
     const publishEventSchema = z
@@ -457,15 +457,21 @@ export async function startServer(options = {}) {
                 });
             }
             const bindIfUnbound = event.type === 'agent:invoke';
-            const resolved = await resolveRespondingAgentId({
+            const target = await resolvePublishTargetAgentId({
+                eventType: event.type,
                 channelId,
                 threadId,
                 requestedAgentId: agentId,
+                eventMeta: event.meta,
                 bindIfUnbound,
             });
+            if ('error' in target) {
+                res.status(400).json({ error: 'agentId is required for widget response' });
+                return;
+            }
             await runAgent({
                 runId,
-                agentId: resolved.agentId,
+                agentId: target.agentId,
                 event,
                 channelId,
                 threadId,

package/dist/plugins/openbot/index.js

@@ -45,7 +45,8 @@ export const openbotPlugin = {
         ...memoryPlugin.toolDefinitions,
         ...storagePlugin.toolDefinitions,
         ...delegationPlugin.toolDefinitions,
-        ...uiPlugin.toolDefinitions,
+        // this is the capability to render UI widgets to the user. We dont need it for now.
+        // ...uiPlugin.toolDefinitions,
     },
     factory: (context) => (builder) => {
         const { config, storage, tools, abortSignal } = context;

package/dist/plugins/openbot/system-prompt.js

@@ -15,7 +15,7 @@ export const OPENBOT_SYSTEM_PROMPT = [
     '- **Bash Tool Usage**: You should use the `bash` tool very rarely. Only use it when the user explicitly requests a command to be run or when it is absolutely necessary for a task that no other agent can handle.',
     '- **Context Awareness**: Use the provided ENVIRONMENT, CHANNEL SPECIFICATION, and MEMORIES to maintain continuity. Do not ask for information already present in these sections.',
     '- **Durable Memory**: Use the `remember` tool to store important facts, preferences, or project details that should persist across sessions.',
-    '- **Structured Interaction**: Use the `render_widget` tool to collect information via forms, offer choices, or display lists. This is preferred over asking multiple separate questions in plain text.',
+    '- **Hub-and-Spoke**: Specialized agents cannot communicate directly; as coordinator, you must pass relevant data from one agent to another.',
     '',
     '# COMMUNICATION STYLE',
     '- Be always concise, professional, and proactive.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbot",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "private": false,
   "type": "module",
   "engines": {

package/src/app/cli.ts

@@ -25,7 +25,7 @@ function checkNodeVersion() {
 
 checkNodeVersion();
 
-program.name('openbot').description('OpenBot CLI').version('0.4.6');
+program.name('openbot').description('OpenBot CLI').version('0.4.7');
 
 program
   .command('start')

package/src/app/responding-agent.ts

@@ -4,6 +4,9 @@ import { storageService } from '../plugins/storage/service.js';
 /** Thread `state.json` key for the sticky responding agent id. */
 export const THREAD_RESPONDING_AGENT_ID_KEY = 'respondingAgentId';
 
+/** Publish events that continue a pending UI interaction rather than a new user turn. */
+export const CONTINUATION_EVENT_TYPES = new Set(['client:ui:widget:response']);
+
 export type ResolveRespondingAgentOptions = {
   channelId: string;
   threadId?: string;
@@ -20,6 +23,14 @@ export type ResolveRespondingAgentResult = {
   overridden: boolean;
 };
 
+const readMetaAgentId = (meta: unknown): string | undefined => {
+  if (!meta || typeof meta !== 'object') return undefined;
+  const value = (meta as Record<string, unknown>).agentId;
+  if (typeof value !== 'string') return undefined;
+  const trimmed = value.trim();
+  return trimmed || undefined;
+};
+
 const readBoundAgentId = (state: unknown): string | undefined => {
   if (!state || typeof state !== 'object') return undefined;
   const value = (state as Record<string, unknown>)[THREAD_RESPONDING_AGENT_ID_KEY];
@@ -72,3 +83,38 @@ export async function resolveRespondingAgentId(
 
   return { agentId: fallback, bound: true, overridden: false };
 }
+
+export type ResolvePublishTargetAgentOptions = {
+  eventType: string;
+  channelId: string;
+  threadId?: string;
+  requestedAgentId?: string;
+  eventMeta?: unknown;
+  bindIfUnbound?: boolean;
+};
+
+/**
+ * Resolves the agent that should handle a publish event.
+ * UI continuations route to the widget origin agent; everything else uses sticky thread binding.
+ */
+export async function resolvePublishTargetAgentId(
+  options: ResolvePublishTargetAgentOptions,
+): Promise<{ agentId: string } | { error: 'agentId_required' }> {
+  const { eventType, channelId, threadId, requestedAgentId, eventMeta, bindIfUnbound } = options;
+
+  if (CONTINUATION_EVENT_TYPES.has(eventType)) {
+    const originAgentId = readMetaAgentId(eventMeta) || requestedAgentId?.trim();
+    if (!originAgentId) {
+      return { error: 'agentId_required' };
+    }
+    return { agentId: originAgentId };
+  }
+
+  const resolved = await resolveRespondingAgentId({
+    channelId,
+    threadId,
+    requestedAgentId,
+    bindIfUnbound,
+  });
+  return { agentId: resolved.agentId };
+}

package/src/app/server.ts

@@ -21,7 +21,7 @@ import {
 } from '../plugins/storage/files.js';
 import { ensureEventId, openBotEventFromQuery } from './utils.js';
 import { abortRegistry, abortKey } from '../services/abort.js';
-import { resolveRespondingAgentId } from './responding-agent.js';
+import { resolvePublishTargetAgentId, resolveRespondingAgentId } from './responding-agent.js';
 import {
   DEFAULT_UNCATEGORIZED_SPEC,
   UNCATEGORIZED_CHANNEL_ID,
@@ -561,16 +561,23 @@ export async function startServer(options: ServerOptions = {}) {
       }
 
       const bindIfUnbound = event.type === 'agent:invoke';
-      const resolved = await resolveRespondingAgentId({
+      const target = await resolvePublishTargetAgentId({
+        eventType: event.type,
         channelId,
         threadId,
         requestedAgentId: agentId,
+        eventMeta: event.meta,
         bindIfUnbound,
       });
 
+      if ('error' in target) {
+        res.status(400).json({ error: 'agentId is required for widget response' });
+        return;
+      }
+
       await runAgent({
         runId,
-        agentId: resolved.agentId,
+        agentId: target.agentId,
         event,
         channelId,
         threadId,

package/src/app/types.ts

@@ -730,6 +730,11 @@ export type UIWidgetResponseEvent = BaseEvent & {
     values?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
   };
+  meta?: {
+    agentId?: string;
+    threadId?: string;
+    [key: string]: unknown;
+  };
 };
 
 export type BashEvent = BaseEvent & {

package/src/plugins/openbot/index.ts

@@ -49,7 +49,8 @@ export const openbotPlugin: Plugin = {
     ...memoryPlugin.toolDefinitions,
     ...storagePlugin.toolDefinitions,
     ...delegationPlugin.toolDefinitions,
-    ...uiPlugin.toolDefinitions,
+    // this is the capability to render UI widgets to the user. We dont need it for now.
+    // ...uiPlugin.toolDefinitions,
   },
   factory: (context) => (builder) => {
     const { config, storage, tools, abortSignal } = context;

package/src/plugins/openbot/system-prompt.ts

@@ -15,7 +15,7 @@ export const OPENBOT_SYSTEM_PROMPT = [
   '- **Bash Tool Usage**: You should use the `bash` tool very rarely. Only use it when the user explicitly requests a command to be run or when it is absolutely necessary for a task that no other agent can handle.',
   '- **Context Awareness**: Use the provided ENVIRONMENT, CHANNEL SPECIFICATION, and MEMORIES to maintain continuity. Do not ask for information already present in these sections.',
   '- **Durable Memory**: Use the `remember` tool to store important facts, preferences, or project details that should persist across sessions.',
-  '- **Structured Interaction**: Use the `render_widget` tool to collect information via forms, offer choices, or display lists. This is preferred over asking multiple separate questions in plain text.',
+  '- **Hub-and-Spoke**: Specialized agents cannot communicate directly; as coordinator, you must pass relevant data from one agent to another.',
   '',
   '# COMMUNICATION STYLE',
   '- Be always concise, professional, and proactive.',