openbot 0.3.5 → 0.4.0

package/README.md

@@ -18,7 +18,8 @@ OpenBot is a local-first harness for running AI agents. It is built around a sma
 
 - Runs a local agent server.
 - Stores channels, threads, agents, plugins, config, and variables under `~/.openbot`.
-- Ships with a built-in `system` agent named Lolly.
+- Ships with a built-in `system` agent named OpenBot (orchestrator, includes the LLM runtime).
+- Ships with a built-in `state` agent for deterministic, non-LLM handling (e.g. `/api/state` defaults).
 - Loads custom agents from `~/.openbot/agents/<agent-id>/AGENT.md`.
 - Loads shared plugins from `~/.openbot/plugins`.
 - Streams events to clients with Server-Sent Events.
@@ -50,15 +51,17 @@ npm run dev
 OpenBot intentionally keeps the public API small:
 
 - `GET /api/events` opens an SSE stream for a channel or thread.
-- `POST /api/publish` publishes an event into the harness.
-- `GET /api/state` runs an event and returns the resulting events without opening a stream.
+- `POST /api/publish` publishes an event into the harness (defaults to the built-in `system` agent with the OpenBot / LLM runtime).
+- `GET /api/state` runs an event and returns the resulting events without opening a stream (defaults to the built-in `state` agent: storage-oriented plugins, no LLM).
+
+You can override the agent with `agentId` (header, query, or body where applicable).
 
 Example:
 
 ```bash
 curl -X POST http://localhost:4132/api/publish \
   -H "content-type: application/json" \
-  -d '{"type":"user:input","data":{"content":"hello"}}'
+  -d '{"type":"agent:invoke","data":{"role":"user","content":"hello"}}'
 ```
 
 Useful context can be passed as headers, query params, or body fields:
@@ -76,8 +79,7 @@ OpenBot reads config from `~/.openbot/config.json`.
 {
   "port": 4132,
   "baseDir": "~/.openbot",
-  "model": "openai/gpt-4o-mini",
-  "mcpServers": []
+  "model": "openai/gpt-4o-mini"
 }
 ```
 
@@ -91,12 +93,11 @@ The built-in `system` agent is always available. Add a custom agent by creating
 ---
 name: Researcher
 description: Helps collect and summarize information.
-runtime:
-  name: ai-sdk
-  config:
-    model: openai/gpt-4o-mini
 plugins:
-  - name: storage
+  - id: openbot
+    config:
+      model: openai/gpt-4o-mini
+  - id: storage
 ---
 
 You are a careful research assistant.
@@ -109,18 +110,16 @@ Agents are discovered from disk when the server starts.
 
 Built-in plugins include:
 
-- `storage`
+- `storage-tools`
 - `delegation`
-- `mcp`
-- `ui`
-- `ai-sdk`
+- `openbot`
 
 Shared plugins can be placed in `~/.openbot/plugins` and referenced by agents.
 
 ## Project Layout
 
 - `src/app`: CLI, server, event types, and app config.
-- `src/harness`: orchestration, process, and MCP runtime helpers.
+- `src/harness`: orchestration and process helpers.
 - `src/plugins`: built-in plugin implementations.
 - `src/services`: local storage service.
 - `src/registry`: plugin registry.

package/dist/app/agent-ids.js

@@ -0,0 +1,4 @@
+/** Built-in orchestrator agent id. Optional `agents/system/AGENT.md` overrides code defaults. */
+export const ORCHESTRATOR_AGENT_ID = 'system';
+/** Built-in infra agent for deterministic `/api/state` and marketplace/plugin lifecycle; optional AGENT.md overlay. */
+export const STATE_AGENT_ID = 'state';

package/dist/app/cli.js

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

package/dist/app/config.js

@@ -46,22 +46,3 @@ export function loadVariables() {
     }
     return { version: 1, variables: [] };
 }
-export const DEFAULT_AGENT_MD = `---
-description: A specialized AI agent
----
-
-# Agent Profile
-
-You are a specialized AI agent within the OpenBot system.
-Your role is defined by your configuration and the tools you have access to.
-
-## Persona
-- Helpful and precise
-- Focused on my specific domain
-- Professional in all interactions
-`;
-export const DEFAULT_USER_MD = `# About Me
-
-<!-- OpenBot reads this file to understand who you are and how you like to work. -->
-<!-- Edit it here or just chat — agents can update it with the "remember" tool. -->
-`;

package/dist/app/server.js

@@ -9,10 +9,9 @@ const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
 import { generateId } from 'melony';
 import { DEFAULT_BASE_DIR, loadConfig, resolvePath } from '../app/config.js';
-import { processService } from '../harness/process.js';
-import { storageService } from '../services/storage.js';
-import { dispatch } from '../harness/dispatcher.js';
-import { initPlugins } from '../registry/plugins.js';
+import { processService } from '../services/process.js';
+import { runAgent, STATE_AGENT_ID, ORCHESTRATOR_AGENT_ID } from '../harness/index.js';
+import { initPlugins } from '../services/plugins/registry.js';
 import { ensureEventId, openBotEventFromQuery } from './utils.js';
 export async function startServer(options = {}) {
     const publishEventSchema = z
@@ -171,7 +170,6 @@ export async function startServer(options = {}) {
             return;
         }
         const onEvent = async (chunk, state) => {
-            ensureEventId(chunk);
             const targetChannelId = state?.channelId || channelId;
             const targetThreadId = state?.threadId || threadId;
             const targetClientKey = getClientKey(targetChannelId, targetThreadId);
@@ -186,11 +184,6 @@ export async function startServer(options = {}) {
             else if (chunk.type === 'agent:run:end') {
                 activeRuns.delete(getRunKey(chunk.data.runId, chunk.data.agentId, chunk.data.channelId, chunk.data.threadId));
             }
-            await storageService.storeEvent({
-                channelId: targetChannelId,
-                threadId: targetThreadId,
-                event: chunk,
-            });
             sendToClientKey(targetClientKey, chunk);
             if (chunk.type === 'agent:run:start' ||
                 chunk.type === 'agent:run:end' ||
@@ -200,9 +193,9 @@ export async function startServer(options = {}) {
         };
         try {
             ensureEventId(event);
-            await dispatch({
+            await runAgent({
                 runId,
-                agentId: agentId || 'system',
+                agentId: agentId || ORCHESTRATOR_AGENT_ID,
                 event,
                 channelId,
                 threadId,
@@ -238,12 +231,13 @@ export async function startServer(options = {}) {
         };
         try {
             ensureEventId(event);
-            await dispatch({
+            await runAgent({
                 runId,
-                agentId: agentId || 'system',
+                agentId: agentId || STATE_AGENT_ID,
                 event,
                 channelId,
                 threadId,
+                persistEvents: false,
                 onEvent,
             });
             res.json({ events });

package/dist/assets/icon.svg

@@ -1,4 +1,10 @@
-<svg width="60.2" height="58.1" viewBox="262.8 360.5 84.2 82.1" fill="#9333EA" xmlns="http://www.w3.org/2000/svg">
-<path d="M301.841 380.896C302.069 380.893 302.297 380.889 302.531 380.885C304.636 380.853 306.741 380.836 308.845 380.822C310.26 380.813 311.675 380.8 313.09 380.775C314.456 380.752 315.822 380.739 317.189 380.735C317.71 380.731 318.231 380.724 318.752 380.712C322.824 380.626 322.824 380.626 323.909 381.43C324.315 382.025 324.561 382.569 324.8 383.246C324.965 383.518 325.13 383.789 325.301 384.068C325.519 384.445 325.519 384.445 325.741 384.83C325.909 385.118 326.077 385.407 326.249 385.704C326.336 385.854 326.423 386.004 326.513 386.159C328.304 389.25 330.137 392.314 332.004 395.361C332.482 396.144 332.957 396.929 333.431 397.715C333.631 398.035 333.631 398.035 333.835 398.361C334.546 399.544 334.969 400.367 334.7 401.777C334.24 402.838 333.683 403.834 333.113 404.839C332.867 405.285 332.621 405.73 332.375 406.176C332.125 406.626 331.874 407.075 331.622 407.525C330.952 408.724 330.296 409.931 329.639 411.137C329.518 411.359 329.397 411.58 329.272 411.807C328.303 413.581 327.349 415.362 326.398 417.144C324.53 420.642 322.621 424.107 320.611 427.525C320.282 428.088 319.962 428.655 319.644 429.224C319.215 429.954 319.215 429.954 318.708 430.462C317.978 430.557 317.978 430.557 317.185 430.462C316.049 429.578 315.42 428.258 314.71 427.035C313.685 425.291 312.637 423.6 311.454 421.96C311.024 421.203 310.906 420.668 310.838 419.8C311.092 419.081 311.092 419.081 311.491 418.343C311.707 417.937 311.707 417.937 311.927 417.522C312.081 417.242 312.235 416.963 312.393 416.675C312.615 416.26 312.615 416.26 312.841 415.836C314.003 413.671 314.003 413.671 314.549 412.797C315.269 411.676 315.269 411.676 315.308 410.387C314.801 409.466 314.268 408.575 313.694 407.695C313.466 407.335 313.238 406.976 313.011 406.616C312.845 406.353 312.845 406.353 312.676 406.085C312.247 405.402 311.829 404.713 311.425 404.014C311.304 403.806 311.183 403.598 311.058 403.384C310.786 402.65 310.848 402.26 311.092 401.523C311.6 401.015 311.6 401.015 312.57 400.967C312.988 400.97 313.407 400.975 313.826 400.982C314.281 400.981 314.737 400.981 315.192 400.98C315.911 400.98 316.629 400.984 317.348 400.995C318.041 401.005 318.733 401.002 319.427 400.998C319.641 401.004 319.854 401.011 320.075 401.017C320.695 401.007 321.171 400.974 321.754 400.762C322.329 400.154 322.665 399.481 323.023 398.731C323.171 398.49 323.318 398.248 323.47 398C323.899 397.287 324.326 396.573 324.752 395.859C324.904 395.608 325.056 395.357 325.212 395.099C325.355 394.859 325.498 394.618 325.646 394.371C325.841 394.045 325.841 394.045 326.04 393.713C326.38 393.138 326.38 393.138 326.323 392.385C326.167 392.384 326.011 392.383 325.85 392.383C322.054 392.368 318.257 392.349 314.461 392.325C312.625 392.313 310.789 392.303 308.953 392.297C307.352 392.291 305.752 392.282 304.152 392.271C303.305 392.265 302.458 392.26 301.61 392.258C300.664 392.256 299.719 392.249 298.773 392.241C298.351 392.241 298.351 392.241 297.921 392.242C297.663 392.238 297.406 392.235 297.14 392.232C296.916 392.231 296.693 392.23 296.462 392.228C295.73 392.109 295.379 391.879 294.846 391.369C294.591 389.978 295.187 388.999 295.837 387.818C295.938 387.63 296.038 387.441 296.142 387.246C296.464 386.646 296.789 386.049 297.115 385.451C297.333 385.045 297.551 384.638 297.769 384.231C299.545 380.925 299.545 380.925 301.841 380.896Z" fill="#9333EA"/>
-<path d="M291.476 372.547C292.795 373.009 293.243 374.055 293.942 375.218C294.23 375.684 294.519 376.15 294.807 376.615C294.945 376.84 295.082 377.065 295.223 377.297C295.544 377.813 295.875 378.314 296.225 378.811C296.388 379.044 296.551 379.277 296.718 379.518C296.856 379.711 296.994 379.903 297.137 380.102C297.492 380.97 297.407 381.615 297.131 382.485C296.704 383.459 296.209 384.39 295.703 385.325C295.497 385.714 295.497 385.714 295.287 386.111C294.44 387.702 293.559 389.255 292.565 390.759C292.217 391.585 292.351 392.026 292.562 392.892C292.955 393.665 292.955 393.665 293.466 394.431C293.555 394.572 293.644 394.713 293.736 394.858C294.019 395.304 294.305 395.748 294.592 396.192C294.971 396.778 295.346 397.365 295.719 397.953C295.886 398.212 296.053 398.471 296.225 398.738C296.646 399.535 296.848 400.115 296.877 401.015C296.559 401.435 296.559 401.435 296.115 401.777C295.364 401.849 294.663 401.877 293.911 401.871C293.467 401.876 293.023 401.88 292.579 401.885C291.879 401.887 291.18 401.888 290.48 401.888C289.804 401.888 289.129 401.895 288.453 401.903C288.244 401.901 288.036 401.899 287.82 401.897C286.637 401.91 286.637 401.91 285.616 402.466C284.844 403.543 284.229 404.69 283.598 405.854C283.455 406.11 283.312 406.365 283.165 406.628C283.031 406.873 282.897 407.118 282.76 407.371C282.637 407.594 282.515 407.818 282.389 408.048C282.071 408.656 282.071 408.656 282.408 409.392C282.559 409.393 282.71 409.394 282.865 409.395C286.539 409.416 290.213 409.439 293.886 409.465C295.663 409.478 297.439 409.49 299.216 409.499C300.929 409.509 302.642 409.521 304.356 409.534C305.011 409.539 305.665 409.543 306.32 409.546C307.235 409.55 308.15 409.557 309.064 409.565C309.473 409.566 309.473 409.566 309.89 409.567C310.139 409.57 310.388 409.573 310.644 409.576C310.861 409.577 311.077 409.578 311.3 409.58C311.854 409.646 311.854 409.646 312.615 410.154C312.797 411.581 312.41 412.577 311.745 413.808C311.656 413.979 311.567 414.15 311.475 414.326C311.288 414.685 311.099 415.042 310.908 415.399C310.616 415.946 310.329 416.495 310.042 417.045C309.859 417.394 309.676 417.743 309.492 418.092C309.363 418.337 309.363 418.337 309.231 418.588C308.881 419.242 308.574 419.78 308.046 420.308C307.364 420.361 306.707 420.382 306.024 420.382C305.815 420.383 305.606 420.385 305.391 420.387C304.698 420.392 304.005 420.392 303.312 420.393C302.832 420.395 302.351 420.396 301.871 420.398C300.862 420.401 299.854 420.402 298.845 420.402C297.552 420.402 296.259 420.409 294.966 420.417C293.973 420.423 292.98 420.424 291.987 420.424C291.51 420.424 291.034 420.427 290.557 420.431C289.89 420.436 289.224 420.434 288.557 420.431C288.36 420.434 288.163 420.437 287.959 420.44C287.061 420.429 286.569 420.386 285.852 419.824C285.47 419.314 285.137 418.817 284.831 418.259C284.718 418.056 284.605 417.852 284.488 417.643C284.367 417.423 284.246 417.203 284.121 416.976C282.907 414.808 281.638 412.679 280.329 410.566C280.156 410.286 279.982 410.006 279.803 409.717C279.469 409.176 279.134 408.636 278.799 408.096C277.871 406.592 276.959 405.077 276.062 403.554C275.968 403.409 275.874 403.264 275.777 403.114C275.143 402.097 274.834 401.442 275.046 400.254C275.425 399.337 275.889 398.475 276.363 397.604C276.568 397.22 276.568 397.22 276.777 396.828C278.005 394.541 279.284 392.283 280.569 390.029C282.224 387.119 283.868 384.197 285.327 381.184C289.509 372.654 289.509 372.654 291.476 372.547Z" fill="#9333EA"/>
+<svg width="60.2" height="58.1" viewBox="272.584 370.297 64.635 62.51" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .mark { fill: #000000; }
+    @media (prefers-color-scheme: dark) {
+      .mark { fill: #ffffff; }
+    }
+  </style>
+<path class="mark" fill="#000000" d="M301.841 380.896C302.069 380.893 302.297 380.889 302.531 380.885C304.636 380.853 306.741 380.836 308.845 380.822C310.26 380.813 311.675 380.8 313.09 380.775C314.456 380.752 315.822 380.739 317.189 380.735C317.71 380.731 318.231 380.724 318.752 380.712C322.824 380.626 322.824 380.626 323.909 381.43C324.315 382.025 324.561 382.569 324.8 383.246C324.965 383.518 325.13 383.789 325.301 384.068C325.519 384.445 325.519 384.445 325.741 384.83C325.909 385.118 326.077 385.407 326.249 385.704C326.336 385.854 326.423 386.004 326.513 386.159C328.304 389.25 330.137 392.314 332.004 395.361C332.482 396.144 332.957 396.929 333.431 397.715C333.631 398.035 333.631 398.035 333.835 398.361C334.546 399.544 334.969 400.367 334.7 401.777C334.24 402.838 333.683 403.834 333.113 404.839C332.867 405.285 332.621 405.73 332.375 406.176C332.125 406.626 331.874 407.075 331.622 407.525C330.952 408.724 330.296 409.931 329.639 411.137C329.518 411.359 329.397 411.58 329.272 411.807C328.303 413.581 327.349 415.362 326.398 417.144C324.53 420.642 322.621 424.107 320.611 427.525C320.282 428.088 319.962 428.655 319.644 429.224C319.215 429.954 319.215 429.954 318.708 430.462C317.978 430.557 317.978 430.557 317.185 430.462C316.049 429.578 315.42 428.258 314.71 427.035C313.685 425.291 312.637 423.6 311.454 421.96C311.024 421.203 310.906 420.668 310.838 419.8C311.092 419.081 311.092 419.081 311.491 418.343C311.707 417.937 311.707 417.937 311.927 417.522C312.081 417.242 312.235 416.963 312.393 416.675C312.615 416.26 312.615 416.26 312.841 415.836C314.003 413.671 314.003 413.671 314.549 412.797C315.269 411.676 315.269 411.676 315.308 410.387C314.801 409.466 314.268 408.575 313.694 407.695C313.466 407.335 313.238 406.976 313.011 406.616C312.845 406.353 312.845 406.353 312.676 406.085C312.247 405.402 311.829 404.713 311.425 404.014C311.304 403.806 311.183 403.598 311.058 403.384C310.786 402.65 310.848 402.26 311.092 401.523C311.6 401.015 311.6 401.015 312.57 400.967C312.988 400.97 313.407 400.975 313.826 400.982C314.281 400.981 314.737 400.981 315.192 400.98C315.911 400.98 316.629 400.984 317.348 400.995C318.041 401.005 318.733 401.002 319.427 400.998C319.641 401.004 319.854 401.011 320.075 401.017C320.695 401.007 321.171 400.974 321.754 400.762C322.329 400.154 322.665 399.481 323.023 398.731C323.171 398.49 323.318 398.248 323.47 398C323.899 397.287 324.326 396.573 324.752 395.859C324.904 395.608 325.056 395.357 325.212 395.099C325.355 394.859 325.498 394.618 325.646 394.371C325.841 394.045 325.841 394.045 326.04 393.713C326.38 393.138 326.38 393.138 326.323 392.385C326.167 392.384 326.011 392.383 325.85 392.383C322.054 392.368 318.257 392.349 314.461 392.325C312.625 392.313 310.789 392.303 308.953 392.297C307.352 392.291 305.752 392.282 304.152 392.271C303.305 392.265 302.458 392.26 301.61 392.258C300.664 392.256 299.719 392.249 298.773 392.241C298.351 392.241 298.351 392.241 297.921 392.242C297.663 392.238 297.406 392.235 297.14 392.232C296.916 392.231 296.693 392.23 296.462 392.228C295.73 392.109 295.379 391.879 294.846 391.369C294.591 389.978 295.187 388.999 295.837 387.818C295.938 387.63 296.038 387.441 296.142 387.246C296.464 386.646 296.789 386.049 297.115 385.451C297.333 385.045 297.551 384.638 297.769 384.231C299.545 380.925 299.545 380.925 301.841 380.896Z"/>
+<path class="mark" fill="#000000" d="M291.476 372.547C292.795 373.009 293.243 374.055 293.942 375.218C294.23 375.684 294.519 376.15 294.807 376.615C294.945 376.84 295.082 377.065 295.223 377.297C295.544 377.813 295.875 378.314 296.225 378.811C296.388 379.044 296.551 379.277 296.718 379.518C296.856 379.711 296.994 379.903 297.137 380.102C297.492 380.97 297.407 381.615 297.131 382.485C296.704 383.459 296.209 384.39 295.703 385.325C295.497 385.714 295.497 385.714 295.287 386.111C294.44 387.702 293.559 389.255 292.565 390.759C292.217 391.585 292.351 392.026 292.562 392.892C292.955 393.665 292.955 393.665 293.466 394.431C293.555 394.572 293.644 394.713 293.736 394.858C294.019 395.304 294.305 395.748 294.592 396.192C294.971 396.778 295.346 397.365 295.719 397.953C295.886 398.212 296.053 398.471 296.225 398.738C296.646 399.535 296.848 400.115 296.877 401.015C296.559 401.435 296.559 401.435 296.115 401.777C295.364 401.849 294.663 401.877 293.911 401.871C293.467 401.876 293.023 401.88 292.579 401.885C291.879 401.887 291.18 401.888 290.48 401.888C289.804 401.888 289.129 401.895 288.453 401.903C288.244 401.901 288.036 401.899 287.82 401.897C286.637 401.91 286.637 401.91 285.616 402.466C284.844 403.543 284.229 404.69 283.598 405.854C283.455 406.11 283.312 406.365 283.165 406.628C283.031 406.873 282.897 407.118 282.76 407.371C282.637 407.594 282.515 407.818 282.389 408.048C282.071 408.656 282.071 408.656 282.408 409.392C282.559 409.393 282.71 409.394 282.865 409.395C286.539 409.416 290.213 409.439 293.886 409.465C295.663 409.478 297.439 409.49 299.216 409.499C300.929 409.509 302.642 409.521 304.356 409.534C305.011 409.539 305.665 409.543 306.32 409.546C307.235 409.55 308.15 409.557 309.064 409.565C309.473 409.566 309.473 409.566 309.89 409.567C310.139 409.57 310.388 409.573 310.644 409.576C310.861 409.577 311.077 409.578 311.3 409.58C311.854 409.646 311.854 409.646 312.615 410.154C312.797 411.581 312.41 412.577 311.745 413.808C311.656 413.979 311.567 414.15 311.475 414.326C311.288 414.685 311.099 415.042 310.908 415.399C310.616 415.946 310.329 416.495 310.042 417.045C309.859 417.394 309.676 417.743 309.492 418.092C309.363 418.337 309.363 418.337 309.231 418.588C308.881 419.242 308.574 419.78 308.046 420.308C307.364 420.361 306.707 420.382 306.024 420.382C305.815 420.383 305.606 420.385 305.391 420.387C304.698 420.392 304.005 420.392 303.312 420.393C302.832 420.395 302.351 420.396 301.871 420.398C300.862 420.401 299.854 420.402 298.845 420.402C297.552 420.402 296.259 420.409 294.966 420.417C293.973 420.423 292.98 420.424 291.987 420.424C291.51 420.424 291.034 420.427 290.557 420.431C289.89 420.436 289.224 420.434 288.557 420.431C288.36 420.434 288.163 420.437 287.959 420.44C287.061 420.429 286.569 420.386 285.852 419.824C285.47 419.314 285.137 418.817 284.831 418.259C284.718 418.056 284.605 417.852 284.488 417.643C284.367 417.423 284.246 417.203 284.121 416.976C282.907 414.808 281.638 412.679 280.329 410.566C280.156 410.286 279.982 410.006 279.803 409.717C279.469 409.176 279.134 408.636 278.799 408.096C277.871 406.592 276.959 405.077 276.062 403.554C275.968 403.409 275.874 403.264 275.777 403.114C275.143 402.097 274.834 401.442 275.046 400.254C275.425 399.337 275.889 398.475 276.363 397.604C276.568 397.22 276.568 397.22 276.777 396.828C278.005 394.541 279.284 392.283 280.569 390.029C282.224 387.119 283.868 384.197 285.327 381.184C289.509 372.654 289.509 372.654 291.476 372.547Z"/>
 </svg>

package/dist/bus/services.js

@@ -1,25 +1,6 @@
 import { DEFAULT_MARKETPLACE_REGISTRY_URL, loadConfig } from '../app/config.js';
 import { storageService } from '../services/storage.js';
 import { pluginService } from '../services/plugins.js';
-const readTodos = (state) => {
-    const raw = state.threadDetails?.state?.todos;
-    return Array.isArray(raw) ? raw : [];
-};
-let todoCounter = 0;
-const newTodoId = (now, idx) => `todo_${now.toString(36)}_${(todoCounter++).toString(36)}_${idx}`;
-async function persistTodos(storage, state, todos) {
-    if (!state.threadId)
-        throw new Error('No active thread');
-    await storage.patchThreadState({
-        channelId: state.channelId,
-        threadId: state.threadId,
-        state: { todos },
-    });
-    state.threadDetails = await storage.getThreadDetails({
-        channelId: state.channelId,
-        threadId: state.threadId,
-    });
-}
 /**
  * Resolve a scope alias to a concrete scope string. Aliases let tools accept
  * `agent`/`channel`/`global` without knowing the active ids; the bus rewrites
@@ -44,26 +25,7 @@ function resolveMemoryScopeFilter(alias, state) {
     }
     return [resolveMemoryScope(alias, state)];
 }
-const DEFAULT_MARKETPLACE_AGENTS = [
-    {
-        id: 'researcher',
-        name: 'Researcher',
-        description: 'Specialized in web research and information synthesis.',
-        instructions: 'You are a research assistant. Use available tools to find information.',
-        plugins: [
-            { id: 'ai-sdk', config: { model: 'openai/gpt-4o' } },
-            { id: 'mcp' },
-            { id: 'shell' },
-        ],
-    },
-    {
-        id: 'coder',
-        name: 'Coder',
-        description: 'Expert in multiple programming languages and software architecture.',
-        instructions: 'You are an expert software engineer. Help the user with coding tasks.',
-        plugins: [{ id: 'claude-code' }],
-    },
-];
+const DEFAULT_MARKETPLACE_AGENTS = [];
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -163,7 +125,7 @@ export const busServicesPlugin = (options) => (builder) => {
         };
     });
     builder.on('action:create_channel', async function* (event, context) {
-        const { channelId, spec, initialState, cwd } = event.data;
+        const { channelId, spec, initialState, cwd, participants } = event.data;
         const rawChannelId = (channelId || '').trim();
         const channelSpec = typeof spec === 'string' ? spec : '';
         const resultMeta = { ...(event.meta || {}), agentId: context.state.agentId };
@@ -176,11 +138,21 @@ export const busServicesPlugin = (options) => (builder) => {
             return;
         }
         const channelUrl = `/channels/${rawChannelId}`;
+        const mergedInitial = { ...(initialState || {}) };
+        if (participants !== undefined) {
+            const normalized = Array.isArray(participants)
+                ? participants
+                    .filter((x) => typeof x === 'string')
+                    .map((s) => s.trim())
+                    .filter(Boolean)
+                : [];
+            mergedInitial.participants = normalized;
+        }
         try {
             await storage.createChannel({
                 channelId: rawChannelId,
                 spec: channelSpec,
-                initialState: initialState,
+                initialState: mergedInitial,
                 cwd,
             });
             yield {
@@ -224,6 +196,18 @@ export const busServicesPlugin = (options) => (builder) => {
             patch.cwd = data.cwd.trim();
             updatedFields.push('cwd');
         }
+        if (data.participants !== undefined) {
+            if (Array.isArray(data.participants)) {
+                patch.participants = data.participants
+                    .filter((x) => typeof x === 'string')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+            }
+            else {
+                patch.participants = [];
+            }
+            updatedFields.push('participants');
+        }
         try {
             if (updatedFields.length > 0) {
                 await storage.patchChannelState({ channelId: targetChannelId, state: patch });
@@ -250,31 +234,54 @@ export const busServicesPlugin = (options) => (builder) => {
     builder.on('action:patch_channel_details', async function* (event, context) {
         const updatedFields = [];
         const resultMeta = { ...(event.meta || {}), agentId: context.state.agentId };
+        const data = (event.data || {});
         try {
-            if (event.data.state !== undefined) {
+            if (data.state !== undefined) {
                 await storage.patchChannelState({
                     channelId: context.state.channelId,
-                    state: event.data.state,
+                    state: data.state,
                 });
                 updatedFields.push('state');
             }
-            if (typeof event.data.spec === 'string') {
+            if (typeof data.spec === 'string') {
                 await storage.patchChannelSpec({
                     channelId: context.state.channelId,
-                    spec: event.data.spec,
+                    spec: data.spec,
                 });
                 updatedFields.push('spec');
             }
-            if (typeof event.data.cwd === 'string') {
+            if (typeof data.cwd === 'string') {
                 await storage.patchChannelState({
                     channelId: context.state.channelId,
-                    state: { cwd: event.data.cwd },
+                    state: { cwd: data.cwd },
                 });
                 updatedFields.push('cwd');
             }
+            if (data.participants !== undefined) {
+                const normalized = Array.isArray(data.participants)
+                    ? data.participants
+                        .filter((x) => typeof x === 'string')
+                        .map((s) => s.trim())
+                        .filter(Boolean)
+                    : [];
+                await storage.patchChannelState({
+                    channelId: context.state.channelId,
+                    state: { participants: normalized },
+                });
+                updatedFields.push('participants');
+            }
             context.state.channelDetails = await storage.getChannelDetails({
                 channelId: context.state.channelId,
             });
+            yield {
+                type: "client:ui:widget",
+                data: {
+                    kind: "message",
+                    title: "Channel details updated.",
+                    body: "The channel details have been updated.",
+                },
+                meta: resultMeta,
+            };
             yield {
                 type: 'action:patch_channel_details:result',
                 data: { success: true, updatedFields },
@@ -322,91 +329,30 @@ export const busServicesPlugin = (options) => (builder) => {
             };
         }
     });
-    builder.on('action:todo_write', async function* (event, context) {
-        const resultMeta = { ...(event.meta || {}), agentId: context.state.agentId };
-        try {
-            if (!context.state.threadId) {
-                throw new Error('todo_write requires an active thread');
-            }
-            const existing = readTodos(context.state);
-            const byId = new Map(existing.map((t) => [t.id, t]));
-            const now = Date.now();
-            const author = context.state.agentId || 'system';
-            const inputs = event.data.todos || [];
-            const next = inputs.map((raw, idx) => {
-                const prior = raw.id ? byId.get(raw.id) : undefined;
-                return {
-                    id: prior?.id || raw.id || newTodoId(now, idx),
-                    content: raw.content,
-                    status: raw.status || prior?.status || 'pending',
-                    assignee: raw.assignee ?? prior?.assignee,
-                    createdBy: prior?.createdBy || author,
-                    createdAt: prior?.createdAt || now,
-                    updatedAt: now,
-                    ...(prior?.result !== undefined ? { result: prior.result } : {}),
-                };
-            });
-            await persistTodos(storage, context.state, next);
-            yield {
-                type: 'action:todo_write:result',
-                data: { success: true, todos: next },
-                meta: resultMeta,
-            };
-        }
-        catch (error) {
-            yield {
-                type: 'action:todo_write:result',
-                data: {
-                    success: false,
-                    todos: readTodos(context.state),
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                },
-                meta: resultMeta,
-            };
-        }
-    });
-    builder.on('action:todo_update', async function* (event, context) {
-        const resultMeta = { ...(event.meta || {}), agentId: context.state.agentId };
-        const patch = event.data;
-        try {
-            if (!context.state.threadId) {
-                throw new Error('todo_update requires an active thread');
-            }
-            const existing = readTodos(context.state);
-            const idx = existing.findIndex((t) => t.id === patch.id);
-            if (idx === -1) {
-                throw new Error(`Todo "${patch.id}" not found`);
-            }
-            const now = Date.now();
-            const updated = {
-                ...existing[idx],
-                ...(patch.content !== undefined ? { content: patch.content } : {}),
-                ...(patch.status !== undefined ? { status: patch.status } : {}),
-                ...(patch.assignee !== undefined
-                    ? { assignee: patch.assignee === '' ? undefined : patch.assignee }
-                    : {}),
-                updatedAt: now,
-            };
-            const next = [...existing];
-            next[idx] = updated;
-            await persistTodos(storage, context.state, next);
-            yield {
-                type: 'action:todo_update:result',
-                data: { success: true, todo: updated, todos: next },
-                meta: resultMeta,
-            };
-        }
-        catch (error) {
-            yield {
-                type: 'action:todo_update:result',
-                data: {
-                    success: false,
-                    todos: readTodos(context.state),
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                },
-                meta: resultMeta,
-            };
-        }
+    builder.on('agent:usage', async function* (event, context) {
+        const { usage } = event.data;
+        if (!context.state.threadId)
+            return;
+        const currentState = context.state.threadDetails?.state || {};
+        const currentUsage = currentState.usage || {
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+        };
+        const nextUsage = {
+            promptTokens: (currentUsage.promptTokens || 0) + usage.promptTokens,
+            completionTokens: (currentUsage.completionTokens || 0) + usage.completionTokens,
+            totalTokens: (currentUsage.totalTokens || 0) + usage.totalTokens,
+        };
+        await storage.patchThreadState({
+            channelId: context.state.channelId,
+            threadId: context.state.threadId,
+            state: { usage: nextUsage },
+        });
+        context.state.threadDetails = await storage.getThreadDetails({
+            channelId: context.state.channelId,
+            threadId: context.state.threadId,
+        });
     });
     builder.on('action:storage:get-channels', async function* () {
         const channels = await storage.getChannels();

package/dist/harness/agent-invoke-run.js

@@ -0,0 +1,44 @@
+import { createAgentRuntime } from './runtime-factory.js';
+/**
+ * Shared `runtime.run(agent:invoke)` loop: tags chunks with `agentId`, skips echo of the
+ * trigger event, optionally polls for stop, tracks last `agent:output` text.
+ *
+ * Does not emit `agent:run:start` / `agent:run:end` — callers bracket those.
+ */
+export async function* streamTaggedAgentInvokeRuntime(options) {
+    const { target, event, state, pollInterrupt } = options;
+    const { runId, agentId } = target;
+    let lastAgentOutput;
+    const runtime = await createAgentRuntime(state);
+    for await (const chunk of runtime.run(event, { state, runId })) {
+        const interrupt = pollInterrupt?.();
+        if (interrupt) {
+            yield interrupt;
+            break;
+        }
+        if (chunk.id === event.id && chunk.type === event.type)
+            continue;
+        if (chunk.type === 'agent:output' &&
+            chunk.meta?.agentId === agentId) {
+            const content = chunk.data?.content;
+            if (typeof content === 'string' && content.trim()) {
+                lastAgentOutput = content.trim();
+            }
+        }
+        chunk.meta = { ...chunk.meta, agentId };
+        yield chunk;
+    }
+    return { lastAgentOutput };
+}
+/**
+ * Drive {@link streamTaggedAgentInvokeRuntime} with a callback per chunk (dispatcher path).
+ */
+export async function consumeAgentInvokeStream(options, onChunk) {
+    const gen = streamTaggedAgentInvokeRuntime(options);
+    let step = await gen.next();
+    while (!step.done) {
+        await onChunk(step.value);
+        step = await gen.next();
+    }
+    return step.value;
+}

package/dist/harness/agent-turn.js

@@ -0,0 +1,99 @@
+import { ensureEventId } from '../app/utils.js';
+import { storageService } from '../services/storage.js';
+import { createAgentRuntime } from './runtime-factory.js';
+const TODO_RESULT_MAX_CHARS = 12000;
+const readThreadState = (state) => state.threadDetails?.state ?? {};
+const readTodos = (state) => {
+    const raw = readThreadState(state).todos;
+    return Array.isArray(raw) ? raw : [];
+};
+function truncateTodoResult(text, maxChars = TODO_RESULT_MAX_CHARS) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return `${trimmed.slice(0, maxChars)}\n…[truncated]`;
+}
+function resolveTodoIdForWorker(todos, workerId, delegationTodoId) {
+    if (delegationTodoId && todos.some((t) => t.id === delegationTodoId)) {
+        return delegationTodoId;
+    }
+    const inProgress = todos.find((t) => t.status === 'in_progress' && t.assignee === workerId);
+    if (inProgress)
+        return inProgress.id;
+    const assigned = todos.find((t) => (t.status === 'pending' || t.status === 'in_progress') && t.assignee === workerId);
+    return assigned?.id;
+}
+export async function recordWorkerTodoResult(state, workerId, output, delegationTodoId) {
+    if (!state.threadId)
+        return;
+    const result = truncateTodoResult(output ?? '');
+    if (!result)
+        return;
+    const todos = readTodos(state);
+    if (todos.length === 0)
+        return;
+    const todoId = resolveTodoIdForWorker(todos, workerId, delegationTodoId);
+    if (!todoId)
+        return;
+    const prior = todos.find((t) => t.id === todoId);
+    if (prior?.result === result)
+        return;
+    const now = Date.now();
+    const next = todos.map((t) => (t.id === todoId ? { ...t, result, updatedAt: now } : t));
+    await storageService.patchThreadState({
+        channelId: state.channelId,
+        threadId: state.threadId,
+        state: { todos: next },
+    });
+}
+export function makeInternalInvoke(content, threadId) {
+    return ensureEventId({
+        type: 'agent:invoke',
+        data: { role: 'user', content },
+        meta: { threadId, internal: true },
+    });
+}
+/**
+ * Run one agent turn (no dispatcher chaining). Yields all runtime events for
+ * persistence/streaming; returns the last non-empty `agent:output` text.
+ */
+export async function* runAgentTurn(options) {
+    const { runId, channelId, threadId, agentId, event, delegationTodoId } = options;
+    const target = { runId, agentId, channelId, threadId };
+    let state;
+    try {
+        state = await storageService.getOpenBotState({ ...target, event });
+    }
+    catch (error) {
+        if (error.code === 'AGENT_NOT_FOUND') {
+            return undefined;
+        }
+        throw error;
+    }
+    yield { type: 'agent:run:start', data: { ...target } };
+    let lastAgentOutput;
+    try {
+        const runtime = await createAgentRuntime(state);
+        for await (const chunk of runtime.run(event, { state, runId })) {
+            if (chunk.id === event.id && chunk.type === event.type)
+                continue;
+            if (chunk.type === 'agent:output' &&
+                chunk.meta?.agentId === agentId) {
+                const content = chunk.data?.content;
+                if (typeof content === 'string' && content.trim()) {
+                    lastAgentOutput = content.trim();
+                }
+            }
+            chunk.meta = { ...chunk.meta, agentId };
+            yield chunk;
+        }
+    }
+    finally {
+        const stateAfterRun = await storageService.getOpenBotState({ ...target, event });
+        yield { type: 'agent:run:end', data: { ...target } };
+        await recordWorkerTodoResult(stateAfterRun, agentId, lastAgentOutput, delegationTodoId);
+    }
+    return lastAgentOutput;
+}