From e908db637b827a9a5b88453a6d67b3c684af545f Mon Sep 17 00:00:00 2001 From: Bohdan Triapitsyn Date: Fri, 24 Jul 2026 21:54:28 +0300 Subject: [PATCH] feat: agent and CLI control plane for sessions, worktrees, and scheduled tasks (#2408) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a shared OpenChamber control service with two thin adapters — a native `openchamber` tool injected into managed OpenCode, and new CLI commands — so users can manage parallel sessions, worktrees, and scheduled tasks conversationally through agents or from the terminal. Control plane: - New openchamber-control service owning a fixed action contract: projects.list, models.list, session list/create/send/fork/status/messages, and schedule list/create/run/delete/toggle. Session and worktree deletion and project registration are deliberately not exposed. - New openchamber-sessions module owning create/worktree/prompt orchestration, Goal Mode dispatch, wait semantics (initial idle never counts as completion; timeout and cancellation are failures), and explicit partial-failure results. - Scheduled-task logic extracted into a service shared by routes, CLI, and the agent tool. Agent tool: - Managed OpenCode gets a materialized plugin registering one typed tool with a loopback-only callback, per-child ephemeral bearer (timing-safe, never persisted or logged), and abort propagation into the service. - The ~1.5k-token schema applies progressive disclosure: short descriptions, server-side validation returning actionable usage errors, and intent guardrails — created sessions/tasks are user-facing work (not age self-delegation); worktree/goal/agent/variant/wait are omit-by-default; dispatches produce no completion notification, and later result r to session.messages, which now returns the authoritative sessionStatus. - session.create without a user-named model picks from favorites/re send/fork omit the selection and the service reuses the target session's last user-message model, agent, and variant before falling back t - An "Agent control tool" setting (default on, Save + Reload to apply) disables plugin injection entirely. CLI: - New `openchamber session`, `schedule`, `projects`, and `models` commands with automatic instance targeting, --wait/--timeout/--last-assist worktree flags, and Goal Mode, preserving interactive, non-TTY, --quiet, and --json contracts. The control HTTP timeout derives from the w instead of the 4-second default. UI: - New built-in "Schedule a Task" starter (/schedule-task) running a dialogue that defines a task and offers to create it via the tool after explicit confirmation; Craft a Goal and Feature Planning gain the handoff offer, and guided starters reserve the question tool for concrete option choices. Localized in all 10 locales, migrated into custom starter lists, hidden on VS Code. - Sidebar shows CLI/agent-created sessions live via the control eve - openchamber tool calls render with per-action titles and metadata. --- packages/ui/src/components/chat/ChatInput.tsx | 28 +- .../components/chat/CommandAutocomplete.tsx | 8 + .../chat/message/parts/DOCUMENTATION.md | 1 + .../chat/message/parts/ToolPart.test.ts | 13 + .../chat/message/parts/ToolPart.tsx | 5 +- .../chat/message/parts/toolPresentation.tsx | 3 + .../src/components/chat/useDraftStarters.ts | 4 +- packages/ui/src/components/icon/README.md | 4 +- packages/ui/src/components/icon/sprite.ts | 79 +- .../openchamber/OpenCodeCliSettings.tsx | 16 + .../src/components/session/SessionSidebar.tsx | 25 +- .../session/sidebar/DOCUMENTATION.md | 1 + packages/ui/src/lib/desktop.ts | 2 + packages/ui/src/lib/draftStarters.ts | 1 + .../ui/src/lib/i18n/messages/en.settings.ts | 3 + packages/ui/src/lib/i18n/messages/en.ts | 3 + .../ui/src/lib/i18n/messages/es.settings.ts | 3 + packages/ui/src/lib/i18n/messages/es.ts | 3 + .../ui/src/lib/i18n/messages/fr.settings.ts | 3 + packages/ui/src/lib/i18n/messages/fr.ts | 3 + .../ui/src/lib/i18n/messages/ja.settings.ts | 3 + packages/ui/src/lib/i18n/messages/ja.ts | 3 + .../ui/src/lib/i18n/messages/ko.settings.ts | 3 + packages/ui/src/lib/i18n/messages/ko.ts | 3 + .../ui/src/lib/i18n/messages/pl.settings.ts | 3 + packages/ui/src/lib/i18n/messages/pl.ts | 3 + .../src/lib/i18n/messages/pt-BR.settings.ts | 3 + packages/ui/src/lib/i18n/messages/pt-BR.ts | 3 + .../ui/src/lib/i18n/messages/uk.settings.ts | 3 + packages/ui/src/lib/i18n/messages/uk.ts | 3 + .../src/lib/i18n/messages/zh-CN.settings.ts | 3 + packages/ui/src/lib/i18n/messages/zh-CN.ts | 3 + .../src/lib/i18n/messages/zh-TW.settings.ts | 3 + packages/ui/src/lib/i18n/messages/zh-TW.ts | 3 + packages/ui/src/lib/magicPrompts.ts | 55 +- packages/ui/src/lib/openchamberEvents.test.ts | 75 ++ packages/ui/src/lib/openchamberEvents.ts | 60 +- packages/ui/src/lib/persistence.test.ts | 18 +- packages/ui/src/lib/persistence.ts | 43 +- packages/ui/src/lib/settings/search.ts | 8 + packages/ui/src/lib/toolHelpers.ts | 9 +- packages/ui/src/stores/useUIStore.ts | 7 + packages/web/README.md | 4 + packages/web/bin/cli.js | 55 +- packages/web/bin/cli.test.js | 492 +++++++++++- packages/web/bin/lib/DOCUMENTATION.md | 27 + packages/web/bin/lib/cli-api-target.js | 74 ++ packages/web/bin/lib/cli-args.js | 252 ++++++- packages/web/bin/lib/cli-control.js | 42 ++ packages/web/bin/lib/cli-control.test.js | 22 + packages/web/bin/lib/cli-goal.js | 17 + packages/web/bin/lib/cli-http.js | 52 +- packages/web/bin/lib/cli-paths.js | 12 + packages/web/bin/lib/commands-models.js | 63 ++ packages/web/bin/lib/commands-projects.js | 28 + packages/web/bin/lib/commands-schedule.js | 195 +++++ packages/web/bin/lib/commands-session.js | 340 +++++++++ packages/web/server/index.js | 73 ++ .../server/lib/agent-tool/DOCUMENTATION.md | 90 +++ packages/web/server/lib/agent-tool/runtime.js | 256 +++++++ .../web/server/lib/agent-tool/runtime.test.js | 236 ++++++ .../lib/openchamber-control/DOCUMENTATION.md | 47 ++ .../server/lib/openchamber-control/actions.js | 28 + .../server/lib/openchamber-control/error.js | 16 + .../server/lib/openchamber-control/routes.js | 36 + .../lib/openchamber-control/routes.test.js | 46 ++ .../server/lib/openchamber-control/service.js | 398 ++++++++++ .../lib/openchamber-control/service.test.js | 226 ++++++ .../server/lib/openchamber-sessions/routes.js | 714 ++++++++++++++++++ .../lib/openchamber-sessions/routes.test.js | 574 ++++++++++++++ .../web/server/lib/opencode/DOCUMENTATION.md | 10 + .../server/lib/opencode/bootstrap-runtime.js | 4 + .../lib/opencode/feature-routes-runtime.js | 21 + packages/web/server/lib/opencode/lifecycle.js | 14 +- .../web/server/lib/opencode/lifecycle.test.js | 28 + .../server/lib/opencode/settings-helpers.js | 9 + .../lib/opencode/startup-pipeline-runtime.js | 4 +- .../opencode/startup-pipeline-runtime.test.js | 40 + .../web/server/lib/scheduled-tasks/routes.js | 105 +-- .../web/server/lib/scheduled-tasks/runtime.js | 110 +-- .../web/server/lib/scheduled-tasks/service.js | 145 ++++ .../server/lib/session-goal/DOCUMENTATION.md | 23 +- .../web/server/lib/session-goal/create.js | 112 +++ .../server/lib/session-goal/create.test.js | 80 ++ scripts/generate-icon-sprite.mjs | 28 +- 85 files changed, 5375 insertions(+), 298 deletions(-) create mode 100644 packages/ui/src/lib/openchamberEvents.test.ts create mode 100644 packages/web/bin/lib/cli-api-target.js create mode 100644 packages/web/bin/lib/cli-control.js create mode 100644 packages/web/bin/lib/cli-control.test.js create mode 100644 packages/web/bin/lib/cli-goal.js create mode 100644 packages/web/bin/lib/commands-models.js create mode 100644 packages/web/bin/lib/commands-projects.js create mode 100644 packages/web/bin/lib/commands-schedule.js create mode 100644 packages/web/bin/lib/commands-session.js create mode 100644 packages/web/server/lib/agent-tool/DOCUMENTATION.md create mode 100644 packages/web/server/lib/agent-tool/runtime.js create mode 100644 packages/web/server/lib/agent-tool/runtime.test.js create mode 100644 packages/web/server/lib/openchamber-control/DOCUMENTATION.md create mode 100644 packages/web/server/lib/openchamber-control/actions.js create mode 100644 packages/web/server/lib/openchamber-control/error.js create mode 100644 packages/web/server/lib/openchamber-control/routes.js create mode 100644 packages/web/server/lib/openchamber-control/routes.test.js create mode 100644 packages/web/server/lib/openchamber-control/service.js create mode 100644 packages/web/server/lib/openchamber-control/service.test.js create mode 100644 packages/web/server/lib/openchamber-sessions/routes.js create mode 100644 packages/web/server/lib/openchamber-sessions/routes.test.js create mode 100644 packages/web/server/lib/opencode/startup-pipeline-runtime.test.js create mode 100644 packages/web/server/lib/scheduled-tasks/service.js create mode 100644 packages/web/server/lib/session-goal/create.js create mode 100644 packages/web/server/lib/session-goal/create.test.js diff --git a/packages/ui/src/components/chat/ChatInput.tsx b/packages/ui/src/components/chat/ChatInput.tsx index 46f7e428..df3aa230 100644 --- a/packages/ui/src/components/chat/ChatInput.tsx +++ b/packages/ui/src/components/chat/ChatInput.tsx @@ -1288,7 +1288,7 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo const availableSkills = useSkillsStore((s) => s.skills); const knownSlashNames = React.useMemo(() => { const names = new Set([ - 'init', 'review', 'undo', 'redo', 'timeline', 'compact', 'summary', 'workspace-review', 'plan-feature', 'craft-goal', 'catch-up', 'debug', 'weigh', 'explore', + 'init', 'review', 'undo', 'redo', 'timeline', 'compact', 'summary', 'workspace-review', 'plan-feature', 'craft-goal', 'schedule-task', 'catch-up', 'debug', 'weigh', 'explore', ]); if (!isMobile && !isVSCodeRuntime()) names.add('handoff-review'); for (const command of availableCommands) names.add(command.name.toLowerCase()); @@ -2257,6 +2257,32 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo } return; } + else if (commandName === 'schedule-task' && (currentSessionId || newSessionDraftOpen)) { + try { + await sessionActions.waitForConnectionOrThrow(); + const idea = normalizedCommand.replace(/^\/schedule-task\b/i, '').trim(); + const visibleText = await renderMagicPrompt('session.scheduleTask.visible', { + idea_block: idea ? `\n\nHere is my initial idea:\n${idea}` : '', + }); + const instructionsText = await renderMagicPrompt('session.scheduleTask.instructions'); + await sendMessage( + visibleText, + providerIdToSend, + modelIdToSend, + agentNameToSend, + [], + agentMentionName, + [{ text: instructionsText, synthetic: true }], + variantToSend, + inputMode, + sendMessageOptions, + ); + scrollToBottom?.(); + } catch (error) { + toast.error(error instanceof Error ? error.message : t('chat.chatInput.toast.scheduleTaskFailed')); + } + return; + } else if (commandName === 'catch-up' && (currentSessionId || newSessionDraftOpen)) { try { await sessionActions.waitForConnectionOrThrow(); diff --git a/packages/ui/src/components/chat/CommandAutocomplete.tsx b/packages/ui/src/components/chat/CommandAutocomplete.tsx index 6b950364..c4fe39bc 100644 --- a/packages/ui/src/components/chat/CommandAutocomplete.tsx +++ b/packages/ui/src/components/chat/CommandAutocomplete.tsx @@ -170,6 +170,10 @@ export const CommandAutocomplete = React.forwardRef