openbot 0.2.12 → 0.2.14

package/src/app/types.ts

@@ -0,0 +1,476 @@
+import {
+  Agent,
+  AgentDetails,
+  Channel,
+  ChannelDetails,
+  Plugin,
+  Thread,
+  ThreadDetails,
+} from '../plugins/storage.js';
+
+export interface OpenBotState {
+  agentId: string;
+  runId: string;
+  channelId: string;
+  threadId?: string;
+  agentDetails?: AgentDetails;
+  channelDetails?: ChannelDetails;
+  threadDetails?: ThreadDetails;
+  triggerEvent?: OpenBotEvent;
+  shortTermMessages?: ShortTermMessage[];
+}
+
+export type ShortTermMessage = {
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+};
+
+export type BaseEvent = {
+  id?: string;
+  type: string;
+  meta?: any;
+};
+
+export type AgentInvokeEvent = BaseEvent & {
+  type: 'agent:invoke';
+  data: {
+    role?: 'user' | 'assistant' | 'system';
+    content: string;
+    agentId?: string;
+  };
+};
+
+export type GetChannelsEvent = BaseEvent & {
+  type: 'action:storage:get-channels';
+};
+
+export type GetChannelsResultEvent = BaseEvent & {
+  type: 'action:storage:get-channels-result';
+  data: {
+    channels: Channel[];
+  };
+};
+
+export type GetThreadsEvent = BaseEvent & {
+  type: 'action:storage:get-threads';
+  data: {
+    channelId: string;
+  };
+};
+
+export type GetThreadsResultEvent = BaseEvent & {
+  type: 'action:storage:get-threads-result';
+  data: {
+    threads: Thread[];
+  };
+};
+
+export type GetChannelDetailsEvent = BaseEvent & {
+  type: 'action:storage:get-channel-details';
+};
+
+export type GetChannelDetailsResultEvent = BaseEvent & {
+  type: 'action:storage:get-channel-details-result';
+  data: {
+    channelDetails: ChannelDetails;
+  };
+};
+
+export type GetAgentsEvent = BaseEvent & {
+  type: 'action:storage:get-agents';
+};
+
+export type GetAgentsResultEvent = BaseEvent & {
+  type: 'action:storage:get-agents-result';
+  data: {
+    agents: Agent[];
+  };
+};
+
+export type GetPluginsEvent = BaseEvent & {
+  type: 'action:storage:get-plugins';
+};
+
+export type GetPluginsResultEvent = BaseEvent & {
+  type: 'action:storage:get-plugins-result';
+  data: {
+    plugins: Plugin[];
+  };
+};
+
+export type GetEventsEvent = BaseEvent & {
+  type: 'action:storage:get-events';
+};
+
+export type GetEventsResultEvent = BaseEvent & {
+  type: 'action:storage:get-events-result';
+  data: {
+    events: OpenBotEvent[];
+  };
+};
+
+export type GetAgentDetailsEvent = BaseEvent & {
+  type: 'action:storage:get-agent-details';
+  data: {
+    agentId: string;
+  };
+};
+
+export type GetAgentDetailsResultEvent = BaseEvent & {
+  type: 'action:storage:get-agent-details-result';
+  data: {
+    agentDetails: AgentDetails;
+  };
+};
+
+export type StreamThreadEvent = BaseEvent & {
+  type: 'stream:thread';
+  data: {
+    channelId: string;
+    threadId?: string;
+  };
+};
+
+export type GetVariablesEvent = BaseEvent & {
+  type: 'action:storage:get-variables';
+};
+
+export type GetVariablesResultEvent = BaseEvent & {
+  type: 'action:storage:get-variables-result';
+  data: {
+    variables: Record<string, string | { value: string; secret: boolean }>;
+  };
+};
+
+export type PatchChannelStateEvent = BaseEvent & {
+  type: 'action:storage:patch-channel-state';
+  data: {
+    state: unknown;
+  };
+};
+
+export type PatchChannelStateResultEvent = BaseEvent & {
+  type: 'action:storage:patch-channel-state-result';
+  data: {
+    success: boolean;
+  };
+};
+
+export type PatchThreadStateEvent = BaseEvent & {
+  type: 'action:storage:patch-thread-state';
+  data: {
+    state: unknown;
+  };
+};
+
+export type PatchThreadStateResultEvent = BaseEvent & {
+  type: 'action:storage:patch-thread-state-result';
+  data: {
+    success: boolean;
+  };
+};
+
+export type PatchChannelDetailsEvent = BaseEvent & {
+  type: 'action:patch_channel_details';
+  data: {
+    state?: Record<string, unknown>;
+    spec?: string;
+    cwd?: string;
+  };
+};
+
+export type PatchChannelDetailsResultEvent = BaseEvent & {
+  type: 'action:patch_channel_details:result';
+  data: {
+    success: boolean;
+    updatedFields: ('state' | 'spec' | 'cwd')[];
+  };
+};
+
+export type PatchThreadDetailsEvent = BaseEvent & {
+  type: 'action:patch_thread_details';
+  data: {
+    state?: Record<string, unknown>;
+    spec?: string;
+  };
+};
+
+export type PatchThreadDetailsResultEvent = BaseEvent & {
+  type: 'action:patch_thread_details:result';
+  data: {
+    success: boolean;
+    updatedFields: ('state' | 'spec')[];
+  };
+};
+
+export type ListFilesEvent = BaseEvent & {
+  type: 'action:storage:list-files';
+  data: {
+    path?: string;
+  };
+};
+
+export type ListFilesResultEvent = BaseEvent & {
+  type: 'action:storage:list-files:result';
+  data: {
+    success: boolean;
+    files: Array<{ name: string; isDirectory: boolean }>;
+    error?: string;
+  };
+};
+
+export type ReadFileEvent = BaseEvent & {
+  type: 'action:storage:read-file';
+  data: {
+    path: string;
+  };
+};
+
+export type ReadFileResultEvent = BaseEvent & {
+  type: 'action:storage:read-file:result';
+  data: {
+    success: boolean;
+    content?: string;
+    path: string;
+    error?: string;
+  };
+};
+
+export type AgentOutputEvent = BaseEvent & {
+  type: 'agent:output';
+  data: {
+    content: string;
+  };
+  meta: {
+    agentId: string;
+    [key: string]: any;
+  };
+};
+
+export type AgentRunStartEvent = BaseEvent & {
+  type: 'agent:run:start';
+  data: {
+    runId: string;
+    agentId: string;
+    channelId: string;
+    threadId?: string;
+  };
+};
+
+export type AgentRunEndEvent = BaseEvent & {
+  type: 'agent:run:end';
+  data: {
+    runId: string;
+    agentId: string;
+    channelId: string;
+    threadId?: string;
+  };
+};
+
+export type ActiveRunsSnapshotEvent = BaseEvent & {
+  type: 'agent:active-runs:snapshot';
+  data: {
+    channels: Array<{
+      channelId: string;
+      activeCount: number;
+      agentIds: string[];
+    }>;
+  };
+};
+
+export type CreateThreadEvent = BaseEvent & {
+  type: 'action:create_thread';
+  data: {
+    threadTitle: string;
+    spec?: string;
+    initialState?: Record<string, unknown>;
+  };
+  meta: {
+    toolCallId: string;
+    agentId: string;
+    threadId: string;
+  };
+};
+
+export type CreateThreadResultEvent = BaseEvent & {
+  type: 'action:create_thread:result';
+  data: {
+    success: boolean;
+    threadId: string;
+    threadTitle: string;
+  };
+  meta: {
+    threadId: string;
+  };
+};
+
+export type CreateChannelEvent = BaseEvent & {
+  type: 'action:create_channel';
+  data: {
+    channelId: string;
+    spec?: string;
+    initialState?: Record<string, unknown>;
+    cwd?: string;
+  };
+  meta?: {
+    toolCallId?: string;
+    agentId?: string;
+    threadId?: string;
+  };
+};
+
+export type CreateChannelResultEvent = BaseEvent & {
+  type: 'action:create_channel:result';
+  data: {
+    success: boolean;
+    channelId: string;
+    channelUrl: string;
+  };
+};
+
+export type UpdateChannelEvent = BaseEvent & {
+  type: 'action:update_channel';
+  data: {
+    channelId?: string;
+    name?: string;
+    cwd?: string;
+  };
+};
+
+export type UpdateChannelResultEvent = BaseEvent & {
+  type: 'action:update_channel:result';
+  data: {
+    success: boolean;
+    channelId: string;
+    updatedFields: string[];
+  };
+};
+
+export type UIWidgetEvent = BaseEvent & {
+  type: 'client:ui:widget';
+  data: {
+    widgetId: string;
+    kind: 'approval' | 'todo_list' | 'form';
+    title?: string;
+    props: Record<string, unknown>;
+  };
+};
+
+export type RenderUIWidgetEvent = BaseEvent & {
+  type: 'action:render_ui_widget';
+  data: {
+    kind: 'approval' | 'todo_list' | 'form';
+    title?: string;
+    props: Record<string, unknown>;
+  };
+};
+
+export type DelegateEvent = BaseEvent & {
+  type: 'action:delegate';
+  data: {
+    agentId: string;
+    content: string;
+  };
+  meta: {
+    toolCallId: string;
+  };
+};
+
+export type MCPListToolsEvent = BaseEvent & {
+  type: 'action:mcp_list_tools';
+  data: {
+    serverId: string;
+  };
+};
+
+export type MCPListToolsResultEvent = BaseEvent & {
+  type: 'action:mcp_list_tools:result';
+  data: {
+    success: boolean;
+    serverId: string;
+    tools: Array<{ name: string; description?: string; inputSchema?: unknown }>;
+    error?: string;
+  };
+};
+
+export type MCPCallEvent = BaseEvent & {
+  type: 'action:mcp_call';
+  data: {
+    serverId: string;
+    toolName: string;
+    args?: Record<string, unknown>;
+  };
+};
+
+export type MCPCallResultEvent = BaseEvent & {
+  type: 'action:mcp_call:result';
+  data: {
+    success: boolean;
+    serverId: string;
+    toolName: string;
+    result?: unknown;
+    error?: string;
+  };
+};
+
+export type UserInputEvent = BaseEvent & {
+  type: 'user:input';
+  data: {
+    content: string;
+  };
+  meta?: {
+    userId?: string;
+    userName?: string;
+    userAvatarUrl?: string;
+  };
+};
+
+export type OpenBotEvent =
+  | UserInputEvent
+  | AgentInvokeEvent
+  | AgentOutputEvent
+  | AgentRunStartEvent
+  | AgentRunEndEvent
+  | ActiveRunsSnapshotEvent
+  | GetChannelsEvent
+  | GetChannelsResultEvent
+  | GetThreadsEvent
+  | GetThreadsResultEvent
+  | GetChannelDetailsEvent
+  | GetChannelDetailsResultEvent
+  | GetAgentsEvent
+  | GetAgentsResultEvent
+  | GetPluginsEvent
+  | GetPluginsResultEvent
+  | GetAgentDetailsEvent
+  | GetAgentDetailsResultEvent
+  | GetEventsEvent
+  | GetEventsResultEvent
+  | StreamThreadEvent
+  | GetVariablesEvent
+  | GetVariablesResultEvent
+  | PatchChannelStateEvent
+  | PatchChannelStateResultEvent
+  | PatchThreadStateEvent
+  | PatchThreadStateResultEvent
+  | PatchChannelDetailsEvent
+  | PatchChannelDetailsResultEvent
+  | PatchThreadDetailsEvent
+  | PatchThreadDetailsResultEvent
+  | ListFilesEvent
+  | ListFilesResultEvent
+  | ReadFileEvent
+  | ReadFileResultEvent
+  | CreateThreadEvent
+  | CreateThreadResultEvent
+  | CreateChannelEvent
+  | CreateChannelResultEvent
+  | UpdateChannelEvent
+  | UpdateChannelResultEvent
+  | UIWidgetEvent
+  | RenderUIWidgetEvent
+  | DelegateEvent
+  | MCPListToolsEvent
+  | MCPListToolsResultEvent
+  | MCPCallEvent
+  | MCPCallResultEvent;

package/src/app/utils.ts

@@ -0,0 +1,43 @@
+import express from 'express';
+import crypto from 'node:crypto';
+import { OpenBotEvent } from './types.js';
+
+/** Express query values are always strings; parse JSON `data` for typed events. */
+export function openBotEventFromQuery(query: express.Request['query']): OpenBotEvent {
+  const typeRaw = query.type;
+  const type =
+    typeof typeRaw === 'string'
+      ? typeRaw
+      : Array.isArray(typeRaw) && typeof typeRaw[0] === 'string'
+        ? typeRaw[0]
+        : '';
+
+  const dataRaw = query.data;
+  const dataStr =
+    typeof dataRaw === 'string'
+      ? dataRaw
+      : Array.isArray(dataRaw) && typeof dataRaw[0] === 'string'
+        ? dataRaw[0]
+        : undefined;
+
+  if (dataStr === undefined || dataStr.trim() === '') {
+    return { type } as OpenBotEvent;
+  }
+
+  try {
+    const data = JSON.parse(dataStr) as unknown;
+    return { type, data } as OpenBotEvent;
+  } catch {
+    throw new Error('Query parameter "data" must be valid JSON when provided');
+  }
+}
+
+/**
+ * Ensures the event has a unique ID.
+ */
+export function ensureEventId(event: OpenBotEvent): OpenBotEvent {
+  if (!event.id) {
+    event.id = crypto.randomUUID();
+  }
+  return event;
+}

package/src/assets/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 762 762" fill="none" shape-rendering="auto"><metadata xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/"><rdf:RDF><rdf:Description><dc:title>Adventurer</dc:title><dc:creator>Lisa Wischofsky</dc:creator><dc:source xsi:type="dcterms:URI">https://www.figma.com/community/file/1184595184137881796</dc:source><dcterms:license xsi:type="dcterms:URI">https://creativecommons.org/licenses/by/4.0/</dcterms:license><dc:rights>Remix of „Adventurer” (https://www.figma.com/community/file/1184595184137881796) by „Lisa Wischofsky”, licensed under „CC BY 4.0” (https://creativecommons.org/licenses/by/4.0/)</dc:rights></rdf:Description></rdf:RDF></metadata><mask id="viewboxMask"><rect width="762" height="762" rx="0" ry="0" x="0" y="0" fill="#fff" /></mask><g mask="url(#viewboxMask)"><path d="M396 164.8a224.8 224.8 0 0 1 104.8 42.4c6.2 4.9 12.5 9.4 18 15a225.4 225.4 0 0 1 71.8 149 58.5 58.5 0 0 1 50.9 42.2 71 71 0 0 1-27.6 76.5c-11 7.7-24.5 12-38 11.7-5 0-10-1.6-15-1.8-1.9 2.2-3.3 4.9-4.8 7.3A223.3 223.3 0 0 1 389 609.8c-11 .7-21.9 2-33 .7a223.7 223.7 0 0 1-178.8-342.3A223.4 223.4 0 0 1 352 163.5c14.6-1.4 29.4-.3 44 1.3Z" fill="#000"/><path fill-rule="evenodd" clip-rule="evenodd" d="M498.8 213.2A216 216 0 0 0 363 169c-13-.2-26.2 1.6-39 4a218 218 0 0 0-113.6 365.5 218.5 218.5 0 0 0 260.4 40.2c35-18.8 64.2-47.3 84.4-81.5l-3-1.6c-2.8-1.4-5.7-3-8-5-2.2-2-.3-5.8 2.7-4.7 1.5.7 3 1.6 4.4 2.4a55 55 0 0 0 59.6-3.6 64.5 64.5 0 0 0 25-69.8 53.1 53.1 0 0 0-24-31 52.6 52.6 0 0 0-47-2.8c-1.6.8-3.4 1.5-5 1.3-2.5-.2-2.8-4.2-.6-5.2 8-4 16.5-5.6 25.4-6.4a217 217 0 0 0-72-146.4c-4.4-4-8.7-8.1-13.9-11.3Zm107.6 196.2c2-1.2 1.3-5.1-1.4-5-2 0-4.2.8-6.2 1.6l-1.4.4a95.1 95.1 0 0 0-25.5 12.4c-2.2 2-2.2 4.4.1 6.2a92 92 0 0 0 5.2 2.8 36 36 0 0 1 13 9.2c-.2 1.9-2 3.4-3.4 4.5l-.2.2c-3.9 3-8.8 5-13.6 7-2.5 1-4.9 2-7.1 3.1-1.7.8-2.6 2.2-1.6 3.9 1 2 3.2 1.1 5 .5l.6-.2 5.4-2.3c5.4-2.3 11-4.5 15.4-8 2.7-2.1 5.1-5.1 5.4-8.7-.5-3.4-2.7-5.7-5.3-7.8a83 83 0 0 0-11.6-7.2l-1.1-.6c5.4-3 10.8-5.6 16.6-7.7l5-1.7a52 52 0 0 0 6.7-2.6Z" fill="#763900"/><g transform="translate(-161 -83)"><path d="M589.3 432.7a64.4 64.4 0 0 1 28.5 33.5 64.3 64.3 0 0 1 .5 45.1c-1 2.9-2.9 5.2-6.3 4.8-15-.8-30 .1-45 .5-10 1.1-20 2.2-30 3.8-10.5 1.8-20.6 4.1-31 6.1-4.3-.1-5.3-4.2-7.2-7.3A65.5 65.5 0 0 1 546 425c14.8-2.6 30.5.2 43.4 7.7Z" fill="#000"/><path d="M558 429.9a59.1 59.1 0 0 1 54.4 80.6l-3.2-.3a27 27 0 0 0 1.3-15.4 26.6 26.6 0 1 0-50 16.9 287 287 0 0 0-34 5.2c-6.7 1.2-13.4 3.2-20.1 4A59.8 59.8 0 0 1 517 445a59 59 0 0 1 41-15.1Z" fill="#fff"/><path d="M392 447a54.8 54.8 0 0 1 42.8 81.9c-1.1 1.9-2.9 4-5 4.7-3 .8-6.6-.2-9.6-.9-8.7-2-17.4-3.8-26.3-5.1-12.9-.9-26-1-39 0-4.7.4-9.7 1.4-14.5 1-2.3-1-3.7-4.2-4.6-6.4a54.9 54.9 0 0 1 56.2-75Z" fill="#000"/><path d="M401.5 454.7a49.3 49.3 0 0 1 26.7 74l-4.1-.7c4.1-4.4 7-9.8 6.8-16a22.6 22.6 0 0 0-43.7-8.8c-2.5 5.9-1.9 12 .4 18-7.6.2-15-.4-22.6.3-7.3.7-14.7 1.2-22 1.8l-1.9-3.4a49.2 49.2 0 0 1 60.4-65.2Z" fill="#fff"/></g><g transform="translate(-161 -83)"><path d="M531 352.3a85.8 85.8 0 0 1 60.6 15.1 82.9 82.9 0 0 1 29 33c1 3-.4 3.8-2.6 5.3-4-2.2-6.9-5.6-10.5-8.3-13-9.7-28-16.3-43.7-20.2-15-3.5-30.6-5-45.8-2.8-4.8.4-9.3 2-14 2.7-2.4.2-5.1-1.2-4.2-4 1.9-4.2 4.2-8.6 7.6-11.7a45 45 0 0 1 23.6-9ZM383 428.8c13.4-.8 26.3-.6 39 4.3 5.9 2.3 11.6 5.9 14 12a14 14 0 0 1-1.8 12.6c-4.9-.7-9.4-2.6-14.1-3.8a203 203 0 0 0-71-6c-5 .4-10 2-14.8 1.8-1.8-.5-1.2-2.2-1-3.5.9-2.5 3.6-3.9 5.8-5.1a119.2 119.2 0 0 1 43.9-12.3Z" fill="#000"/></g><g transform="translate(-161 -83)"><path d="m525 563.7 1.2 2.3c.4 2.7-2 3.4-3.8 4.4a184 184 0 0 1-85.8 17c-5-.6-10.2-.7-15-2-2.3-1-2.6-4-.3-5.2 2.7 0 5.5.9 8.2 1 7.2 1 14.3.7 21.5.7 22.5-.8 45-6.8 65.7-15.5 2.8-1.2 5.2-2.6 8.3-2.7Z" fill="#000"/></g><g transform="translate(-161 -83)"></g><g transform="translate(-161 -83)"></g><g transform="translate(-161 -83)"><path d="M754.9 186.1a94.7 94.7 0 0 1 29 52c5.3 43 5.3 86 11.8 128.9 4.5 31.8 10.7 66.1 25.5 94.9 10.3 20.5 21.8 40.5 31.8 61.1 8.6 17.7 14 37.3 14.8 57 .9 11.5.4 23.5-.6 34.9-2.2 18-7.9 36.3-17.5 51.8-7.5 12.2-19 21.4-30.6 29.5-1.3.8-2.5 2.8-4.1 2.6-2 0-3-2-2.5-3.8a95 95 0 0 0 6.5-69.1c-.3-1-.4-2.1-1.4-2.7-4.6 25.3-15 49.9-31.4 69.9-13.2 16-30 28.9-50.2 34.6a73.7 73.7 0 0 1-47-1.7c-1.6-1.7-4.5-3.3-3.3-6a68.1 68.1 0 0 0 16.8-32c-1.8.6-3.3 1.7-5 2.4a67.7 67.7 0 0 1-29.5 5.9c-9 0-19.3-2-26.3-8-1.8-1.6-4-3.2-3.3-5.9a69 69 0 0 0 12.8-32.3c.7-.9 1.9-1.4 2.8-2.1 26-18.2 47.3-42.2 63.5-69.5 1-2.3 3.4-2.8 5.6-2a55.2 55.2 0 0 0 41.4-4 64.8 64.8 0 0 0 34.3-65.5 55 55 0 0 0-19.8-36 50.2 50.2 0 0 0-55-6 123 123 0 0 1-4.6 32.1 123.4 123.4 0 0 1-35 58.3c-1.3 1-2.7 2.6-4.4 3.1-1.3.1-3.5-.9-3.5-2.5-.3-1.9 1.7-3.3 2.7-4.8a76.6 76.6 0 0 0 10-21.2c4.3-14 6-29.3 6.1-44-.3-26-5-52.4-16-76.1-.6-1.8-1.8-3.8-1-5.8 2-5 3-10.3 3.2-15.7-4.3 2.8-9 5.2-13.4 7.7-2.2 1.2-5.4 2.1-7.3 0-1.1-3.4-1-7.5-.7-11 .3-6.2.5-12.1 0-18.2-6.9 3.7-13.3 7.5-20.6 10.4-2.5 1-5.3 0-7.7-.9a83.6 83.6 0 0 1-29.2-23c-4.7-5.3-9-10.6-11.8-17.3-2.6-6-3.6-12.1-3.7-18.6-13.7 7.3-31 6.1-46.1 6.2-16 .3-32.2-.8-48 1.1-1.8.2-4.8-.8-4.9-2.9-.5-2.8 1.8-4.6 3.5-6.5-13.2 3.6-26.2 8.7-39 13-3.6.9-7 2.6-10.4.4-3.5-2.5-2.6-6.2-2.3-10-3 0-6 1.4-8.8 2.3a721.5 721.5 0 0 1-41 14.3c-9.5 2.9-19 5-29.1 4.8-4.8-.2-9.6.9-14 3a62.4 62.4 0 0 1-44.1-15 40.6 40.6 0 0 1-13-24.2 46 46 0 0 1 2-20 69.7 69.7 0 0 1 34.4-37.7c1.6-.8 3.9-2.4 5.7-1.4 1.7 1 2 3.4 1 5a49.6 49.6 0 0 0-5.8 57.9c4.4 7.3 10.9 14.2 19.5 16 2.6-15 10.8-29 20.5-40.6a205.6 205.6 0 0 1 49.4-41.6 297.1 297.1 0 0 1 114.9-41.3 176 176 0 0 1 66.5 2.6c17-22 42.5-37.2 70-41.6 30.7-5.4 63.9 3.6 86.9 24.8Z" fill="#000"/><g fill="#3eac2c"><path d="M681 165.9c28-1.7 56.2 9.2 75.2 29.9a88.5 88.5 0 0 1 21.6 42.3c.6 7 2 13.8 2.2 20.8 1.3 9.7 1.5 19.4 2.5 29.1 1.2 22.6 3.1 45.5 5.7 68 4 29 8 57.1 17.6 85 5.8 16.7 14.1 31.4 22.3 46.9 7.8 14.9 16.1 29.7 22.9 45.1 11.9 27.4 13.5 58.6 9.4 87.9a112.7 112.7 0 0 1-22.5 52c-4.5 5-9.7 9.9-15.2 13.7 4.3-12.3 6.3-25.6 5.7-38.6-.3-12.7-3.2-26-9.2-37.2-1.2-2.3-5.1-2-5.7.7-3.7 30-15.6 60.3-36.2 82.8a90 90 0 0 1-52.4 29.8 66.1 66.1 0 0 1-32.2-3c8.3-10.9 15.8-25.2 15.7-39.1.2-2.8-3.4-3.3-5.1-1.8a53.9 53.9 0 0 1-19.3 8.6 52.6 52.6 0 0 1-34.5-2.3c-1.2-.8-3.7-1.9-4.2-3.2a84.7 84.7 0 0 0 11.5-29.8c1.5-2 4.1-3 6-4.7a226.1 226.1 0 0 0 59-66.2c4.7.4 9.3 1.8 14.2 1.9a66 66 0 0 0 55-27.5 72.5 72.5 0 0 0 14.1-39 62.6 62.6 0 0 0-20.9-50 55 55 0 0 0 6.6-19c3.1-19.7.1-40.7-4.4-60a214.8 214.8 0 0 0-21-53.1c-3.6-15.1-8.4-29.8-15.8-43.5a138 138 0 0 0-55.4-56.6c-1.2-.7-2.5-.9-3.9-1.1a58.9 58.9 0 0 0-44.3-24.4c-5-.8-9.9 0-14.9 0-3.3-2.4-7-3.2-11-3.4-6.1-.5-11 1.8-16.6-1.5A104.6 104.6 0 0 1 681 166Z"/><path d="M594 208c1 .4 2.3.3 2.9 1.4-2.4.6-4.8 1.4-7 2.3a320.2 320.2 0 0 0-75.1 33.9c-8.2 5-16.1 10.6-23.5 16.7-1.5 1.3-1.6 3.3-.5 5 1.5.8 2.8.8 4.1-.4a254.2 254.2 0 0 1 46.6-29.4 268.6 268.6 0 0 1 61.6-23c6.4-1 13.5-2.5 20-1.3 2.2.4 4.2 1.7 6.4 2.4 3 1.2 6.2.2 9.5.2 4.3.1 8.8.3 13 1.2 12.5 2.2 24 9 32 19a91.5 91.5 0 0 1 17.3 44.1c1 7.6 1.8 15.2 1.6 22.9 0 2.2 0 5.7 3 5.5 2.2 0 3-1.6 3-3.5 0-21.1-3-41.8-12.4-61a127.4 127.4 0 0 1 36.4 33 156 156 0 0 1 27.8 66c4.7 25.5 4.3 52.4 1 78-.5 3.3-1.3 6.8-1.1 10.1 1.3 3 5.2 2.2 5.5-1 1.7-8.8 2.7-18 3.2-27.1 1.6-16.3.9-32.1-.8-48.3.3 2 1.4 3.6 2.2 5.4A202.3 202.3 0 0 1 786 428c.3 11.7-.6 25.3-6.3 35.8a57 57 0 0 0-56-5.3c-.6-1.6-.5-4.2-2.8-4.4-1.7-.3-3.4 1-3.3 2.9.3 6.6.5 13.4-.2 20a130.9 130.9 0 0 1-22.6 58l-1 .5c.2-2 .8-3.7 1.4-5.5 5-16.8 6.3-34.2 5.8-51.6-1.2-24.9-6.5-50.5-17.4-73.1 2.4-6 3-12 3.8-18.3.1-2 .5-4.1 0-6.1-1.2-2.4-4.1-1.8-5.7-.1-3.2 3-7 5.1-10.9 7-1.6.8-3.2 2.2-5 2.2 0-3.6.4-7.3.2-11 0-5.9.5-12.4-1-18-2.5-2.2-5-1-7.2.9-6.2 3.5-12.5 6.8-19 9.6-1.8.8-3.4.2-5-.4a78.2 78.2 0 0 1-24.8-19.2 64.7 64.7 0 0 1-13.4-19.4 39.7 39.7 0 0 1 2-33c1-1.6.5-4.1-1.7-4.4-2.7-.6-4 3-5 4.9-2 4.5-4 10.9-8.4 13.6-9.6 4-19.4 4.3-29.6 4.2h-48c-2.6.1-5.1.6-7.8.8 2-3 5.3-5 3.1-8.9-3.2-2-6.4-.7-9.8-.1-13.2 3.5-26 8.6-39 13-2 .6-4 1.4-6 1 .1-2.8 1.4-6.8-1-9-2-2.3-4.8-2-7.5-1.5-7 1.8-13.2 4.6-20 7-12.9 4.5-25.9 9.3-39.2 12.5-7.5 1.7-15.1 1.9-22.8 2-3.7 0-6.3 2.6-10 2.3a54 54 0 0 1-26-5c-9.7-4.3-17.9-11.9-21.6-22a37 37 0 0 1 1.2-27 62.3 62.3 0 0 1 22-26.4c-1.6 4-3.3 7.8-4.3 12-4.5 19 .4 40.8 15.1 54.1 5.2 3.6 10 7 16.6 7.1 2.3 0 3.8-1.3 4.2-3.5 3.4-20.6 18-39.2 32.8-53.2 26.2-24.4 59.4-42.1 93-53.9 13.1-4.4 26.4-8 40-10.7 24.7-4.5 51.4-6.2 76-.4Z"/></g></g><g transform="translate(-161 -83)"></g></g></svg>

package/src/harness/agent-harness.ts

@@ -0,0 +1,58 @@
+import { Runtime } from 'melony';
+import { OpenBotEvent, OpenBotState } from '../app/types.js';
+import { Harness, HarnessOptions } from './types.js';
+import { orchestratorService } from './orchestrator.js';
+import { ensureEventId } from '../app/utils.js';
+
+/**
+ * Standard implementation of the Agent Harness.
+ * It wraps the orchestrator logic into a clean, stateful container.
+ */
+export class AgentHarness implements Harness {
+  public readonly runId: string;
+  public readonly agentId: string;
+  public readonly channelId: string;
+  public threadId?: string;
+  private eventCallbacks: ((event: OpenBotEvent, state: OpenBotState) => Promise<void>)[] = [];
+
+  constructor(options: HarnessOptions) {
+    this.runId = options.runId;
+    this.agentId = options.agentId;
+    this.channelId = options.channelId;
+    this.threadId = options.threadId;
+    if (options.onEvent) {
+      this.eventCallbacks.push(options.onEvent);
+    }
+  }
+
+  /**
+   * Dispatches an event to the agent within this harness.
+   */
+  async dispatch(event: OpenBotEvent): Promise<void> {
+    ensureEventId(event);
+
+    await orchestratorService.dispatch({
+      runId: this.runId,
+      agentId: this.agentId,
+      event,
+      channelId: this.channelId,
+      threadId: this.threadId,
+      onEvent: async (chunk, state) => {
+        // Update internal thread state if it changes (e.g. thread creation)
+        if (chunk.type === 'action:create_thread:result' && chunk.data.success) {
+          this.threadId = chunk.data.threadId || this.threadId;
+        }
+
+        // Notify all observers
+        await Promise.all(this.eventCallbacks.map(cb => cb(chunk, state)));
+      }
+    });
+  }
+
+  /**
+   * Adds an event listener to the harness.
+   */
+  onEvent(callback: (event: OpenBotEvent, state: OpenBotState) => Promise<void>): void {
+    this.eventCallbacks.push(callback);
+  }
+}

package/src/harness/mcp.ts

@@ -0,0 +1,78 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { loadConfig, type MCPServerConfig } from '../app/config.js';
+
+type MCPToolSummary = {
+  name: string;
+  description?: string;
+  inputSchema?: unknown;
+};
+
+class MCPService {
+  private clients = new Map<string, Client>();
+
+  private transports = new Map<string, StdioClientTransport>();
+
+  private getServerConfig(serverId: string): MCPServerConfig {
+    const config = loadConfig();
+    const server = (config.mcpServers || []).find((s) => s.id === serverId);
+    if (!server) {
+      throw new Error(`MCP server "${serverId}" is not configured`);
+    }
+    return server;
+  }
+
+  private async getClient(serverId: string): Promise<Client> {
+    const existing = this.clients.get(serverId);
+    if (existing) {
+      return existing;
+    }
+
+    const server = this.getServerConfig(serverId);
+    const client = new Client(
+      {
+        name: 'openbot-v2',
+        version: '0.1.0',
+      },
+      {
+        capabilities: {},
+      },
+    );
+    const transport = new StdioClientTransport({
+      command: server.command,
+      args: server.args || [],
+      env: server.env,
+      cwd: server.cwd,
+    });
+
+    await client.connect(transport);
+    this.clients.set(serverId, client);
+    this.transports.set(serverId, transport);
+    return client;
+  }
+
+  async listServers(): Promise<string[]> {
+    const config = loadConfig();
+    return (config.mcpServers || []).map((server) => server.id);
+  }
+
+  async listTools(serverId: string): Promise<MCPToolSummary[]> {
+    const client = await this.getClient(serverId);
+    const result = await client.listTools();
+    return (result.tools || []).map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      inputSchema: tool.inputSchema,
+    }));
+  }
+
+  async callTool(serverId: string, toolName: string, args: Record<string, unknown>) {
+    const client = await this.getClient(serverId);
+    return client.callTool({
+      name: toolName,
+      arguments: args,
+    });
+  }
+}
+
+export const mcpService = new MCPService();