- Task 9: add full code for each command handler (/new, /cancel, /status, etc.)
- Task 10: fix broken build — remove adapter imports of deleted functions before committing
- Task 7: add connectSessionBridge() method to OpenACPCore
- Task 11: fix placeholder for assistantTopicId in menu callback handler
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
13-task plan covering MenuRegistry, AssistantRegistry, AssistantManager,
SessionBridge simplification, command handler migration, and Telegram
adapter cleanup. TDD approach with tests before implementation.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Design doc for refactoring the three intertwined systems (command dispatch,
assistant session management, bot/chat flows) into clean, separated concerns
with plugin extensibility for assistant context and menu items.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Updated all references from 'dangerous mode' to 'bypass permissions' in CLI commands, API documentation, and internal logic.
- Adjusted command usage and descriptions to reflect the new terminology for clarity and consistency.
- Removed warmup functionality from session management as part of the refactor.
Changes include:
- Updated `.gitignore` to include `.openacp` for local workspace secrets.
- Refactored CLI commands to replace "instance" with "workspace" for consistency.
- Enhanced workspace setup and registration logic, including deduplication of entries.
- Improved user prompts and error messages related to workspaces.
- Added functionality to protect local workspace secrets from being tracked by git.
This commit aims to clarify the distinction between workspaces and instances, enhancing user experience and code maintainability.
Added Section 6 covering Telegram/Discord/Slack button rendering,
command response format, and agent-initiated notification handling.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- B4: Remove createThread:false override from createFullSession callback
- B5: Add createThread to createFullSession type signature
- B6: Fix createSessionWithContext to pick fields, not spread params
- B2: Use optional chaining for middleware, preserve original semantics
- I2: Note handleNewChat as dead code
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Phase 1d: Move 4 loose instance-* files into core/instance/ directory.
All belong to multi-instance management domain.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Added system messages and structured events for agent switching, including "starting", "succeeded", and "failed" statuses.
- Updated the event bus to handle new `session:agentSwitch` events, allowing UIs to display loading and error states during agent transitions.
- Enhanced error handling during agent startup to provide users with clear guidance on resolving issues.
This change improves user experience by providing real-time feedback during agent switches.
- Changed the behavior of the `/archive` command to stop the agent session and permanently delete the Telegram topic without recreating it.
- Updated related tests to reflect the new confirmation messages and ensure accurate descriptions of the archiving process.
- Adjusted the interface and implementation of the `archiveSessionTopic` method to return void instead of a new thread ID, aligning with the new functionality.
This change clarifies the archiving process and ensures that users are aware that the deletion is permanent and cannot be undone.
- Add restart CLI command (stop + start in one step)
- Disable tsup code splitting to prevent ERR_MODULE_NOT_FOUND when
daemon is running during a global npm upgrade (hash-named chunks
get replaced, breaking dynamic imports in the old process)
- Update help, docs, and README
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Changed 'plugins' to 'plugin' in installation, configuration, enabling, and disabling commands for uniformity.
- Updated Node.js version requirements in install script to reflect the minimum supported version.
Registry only stores id + root path. All details (name, ports,
channels, mode, PID) are read from each instance's own config and
state files. This avoids stale data and keeps the registry simple.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Status table Directory column shows parent path without .openacp suffix
- API and Tunnel port columns clearly labeled with actual port numbers
- Mode column shows daemon/fg/— for clarity
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add instance id (slug) and name to InstanceContext and Registry
- Paths in flags use parent dir, system appends .openacp internally
- Copy from any existing setup, not just global
- Show step-by-step progress with spinner during copy
- Status table includes id, name, mode, channels columns
- Add --name flag, status --id subcommand
- Clearer user-facing language throughout
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Clone now includes plugins/node_modules, agents/, bin/ directories
- Clone source can be any existing instance, not just global
- Add --from <path> CLI flag to specify clone source
- All prompts show full paths for clarity
- Show equivalent CLI command as tip after interactive selection
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Defines architecture for running multiple OpenACP instances on the same
machine with independent config, sessions, ports, and lifecycle.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Mark Discord and Slack as "coming soon" in agent-switch docs and chat-commands table since those adapter integrations were reverted. In the rollback path of switchSessionAgent(), attempt agentManager.resume() with the saved fromAgentSessionId before falling back to a fresh spawn, preserving conversation history on rollback when possible.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents the /switch command, mid-conversation agent switching behavior,
history label injection, session resume logic, and the agentSwitch.labelHistory
config option. Adds a dedicated feature page and updates chat-commands,
agents, configuration-schema, README, and SUMMARY.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Introduced a new function `computeLineDiff` to accurately calculate line-level diffs by stripping common prefixes and suffixes, improving diff accuracy.
- Updated `MessageTransformer` to utilize the new diff computation for better metadata extraction.
- Enhanced `DisplaySpecBuilder` to include `inputContent` in the display specifications, allowing for inline display of raw input in high verbosity mode.
- Refined title generation logic to improve clarity and consistency in displayed titles across different contexts.
- Adjusted formatting functions to ensure proper display of input content and viewer links in tool cards.
- Refined logging in agent-instance to reduce verbosity by removing debug logs for raw input/output.
- Enhanced activity tracker logging to include viewer links for improved traceability.
- Updated .gitignore to exclude .log files from version control.
- Added .log to .gitignore to exclude log files from version control.
- Removed debug logging for raw input/output in agent-instance to reduce verbosity.
- Enhanced logging in activity tracker to include viewer links for better traceability.
Session state machine:
- Guard processPrompt for finished state (prevents double-throw crash)
- Add cancelled to valid transitions from error state
- Wrap abortPrompt in try-catch in cancelSession (agent may be dead)
- Set session.threadId before createSession in lazy resume
- Skip cancelled sessions in lazy resume (spawn fresh instead)
- Backup corrupt sessions.json as .bak before starting empty
Error handling & stability:
- Validate config before writing to disk (prevents bricking on restart)
- Close session logger file descriptors on destroy
- Clean up spinner/logger on plugin boot failure
- Catch sendMessage middleware errors (prevent unhandled rejections)
- Unref permission gate timeout timer (unblock graceful shutdown)
Adapter primitives:
- Remove thinking indicator on maxThinkingDuration exceeded
- Remove draft from map after finalize in shared DraftManager
- ToolCardState appendUsage uses scheduleFlush instead of immediate flush
- Node stream adapters: add close/cancel/abort handlers
CLI/API field fixes:
- Fix CLI api session field access (.session wrapper + correct field names)
- Fix CLI api health field access (uptime in ms, memory.rss, tunnel object)
- Use AgentCatalog.resolve() in API sessions route instead of config.agents
TTS:
- Move voiceMode "next" reset after successful prompt (preserve on error)
- Updated `unregister` method to simplify command removal logic.
- Enhanced error handling in `AgentInstance` for event processing and subprocess termination.
- Added sorting of middleware handlers upon registration in `MiddlewareChain`.
- Improved `PermissionGate` to reject previous pending requests when a new one is set.
- Enhanced `NotificationManager` to handle notification failures gracefully without crashing the caller.
- Removed the Edge TTS provider implementation and its associated tests.
- Updated the SpeechService to support dynamic registration and unregistration of TTS providers.
- Enhanced the speech plugin to install the Edge TTS plugin dynamically if not already available.
- Adjusted configuration to exclude specific test directories and removed unnecessary dependencies from package.json.
* fix(formatting): wire rawInput + display* fields through both adapters
- Add rawInput, displaySummary, displayTitle, displayKind to Discord
adapter tool call/update meta construction (were missing after reset)
- Add displaySummary, displayTitle, displayKind to Telegram adapter
(rawInput was already present)
- Update existing tests to pass "high" for full-detail assertions
(default changed to "medium" which returns compact output)
Entire-Checkpoint: e0737b6c7432
* fix(formatting): preserve display* on tool edit, cleanup duplication
- Store displaySummary/displayTitle/displayKind in ToolCallState
so they survive from tool_call to tool_call_update edit
- Merge with ?? fallback: update fields take precedence over stored
- Telegram formatToolUpdate delegates to formatToolCall (like Discord)
- Remove unused STATUS_ICONS/KIND_ICONS imports from platform formatters
Entire-Checkpoint: 5afc4b23e3ed
* fix(formatting): always show plan regardless of verbosity level
Plan messages were hidden when displayVerbosity was set to "low".
Removed "plan" from HIDDEN_ON_LOW set and added low verbosity
handling in Discord/Telegram formatPlan to show summary count.
Entire-Checkpoint: 25f61b05a8f3
* fix(telegram): handle low verbosity in PlanCard formatPlanCard
PlanCard uses its own formatPlanCard() instead of the shared
formatPlan() from formatting.ts. The low verbosity case was
missing, causing it to fall through to high detail mode.
Entire-Checkpoint: ad8701fddbdc
* fix(formatting): plan always shows full entries regardless of verbosity
Remove verbosity branching from formatPlan — plan always renders
the full entry list with status icons. Previously low/medium showed
only a summary count. Also fix Telegram PlanCard formatPlanCard
which had the same issue.
Entire-Checkpoint: ec946aa88fa1
* docs: add consolidated tool card design spec
Entire-Checkpoint: 41ede6b49d70
* docs: update tool card spec with review decisions (v2)
Entire-Checkpoint: c49386e3cfc2
* docs: update tool card verbosity tiers — full list on all levels (v3)
Entire-Checkpoint: 075290d470e5
* docs: viewer links shown on all verbosity levels (v4)
Entire-Checkpoint: cbc26f5db2c4
* docs: add grep to noise filter rules
Entire-Checkpoint: 2b8dbb47e518
* docs: add consolidated tool card implementation plan
Entire-Checkpoint: 2baf2ed990bc
* feat(formatting): add grep to noise filter, change glob to hide
Entire-Checkpoint: 5d880ff51b85
* feat: add ToolCardState for consolidated tool card
Entire-Checkpoint: 31469436e6e5
* feat(discord): add renderToolCard formatter
Entire-Checkpoint: 1c21fec9dc31
* feat(telegram): add renderToolCard formatter
Add renderToolCard() to Telegram formatting that renders tool card snapshots
as HTML (bold headers, escaped labels, anchor viewer links, plan section,
usage footer). Add corresponding tests covering all output behaviors.
Entire-Checkpoint: 643c26444277
* feat(discord): wire ToolCard into ActivityTracker
Entire-Checkpoint: 018413b14f8d
* feat(telegram): wire ToolCard into ActivityTracker
Entire-Checkpoint: 22d59ca7c6f5
* refactor: delete deprecated platform ToolCallTrackers
Entire-Checkpoint: c5c4b3ac6239
* docs: update message format reference for consolidated tool card
Entire-Checkpoint: f211f739e728
* fix(tool-card): guard empty render, fix falsy usage check, make destroy terminal
- Skip send/edit when renderToolCard returns empty string (prevents API
errors for sessions that end with no tool calls)
- Fix tokensUsed check from falsy to != null in both Discord and Telegram
renderToolCard so tokensUsed=0 is not silently hidden
- Set finalized=true in ToolCardState.destroy() to make it terminal and
prevent post-destroy mutations
Entire-Checkpoint: de056e6643c9
* fix(tool-card): put viewer links on new line for better readability
Entire-Checkpoint: 4ce2b139ecbd
* fix(tool-card): always show usage stats, use formatUsage with verbosity
- sendUsage() no longer skips when no tool content — standalone usage
message is sent for text-only responses
- renderToolCard uses formatUsage() so progress bar and cost appear
according to verbosity (high verbosity shows progress bar + %)
- Separator line only rendered when there are tool entries above it
- Update test to assert standalone usage message behavior
Entire-Checkpoint: b55f5bc768c0
* fix(telegram): edit thinking message instead of sending new ones
Entire-Checkpoint: 4f47ffddcdb4
* fix(formatting): recognize Terminal tool name, show command in summary
Entire-Checkpoint: 1c66813043ae
* fix(formatting): show play icon for Terminal tool with no command
Entire-Checkpoint: 46c93d01eee8
---------
Co-authored-by: Leo Agent <bigbearman078@mgail.com>
* fix(api): respect channel param in POST /api/sessions (#76)
Session creation always used the first registered adapter. Add optional
`channel` field so callers can target a specific platform (e.g. discord).
Falls back to first-adapter behavior when omitted for backward compat.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(api): wire --channel flag in CLI and assistant prompts (#76)
The API endpoint accepted `channel` but the CLI `openacp api new` didn't
pass it through. Add --channel flag to CLI and update Discord/Telegram
assistant prompts to include --channel so sessions are created on the
correct platform.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 27c1f141d0c1
* docs: add session cleanup feature design spec
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 8de760ac911e
* docs: address spec review feedback for session cleanup
- Reference existing TopicManager and archiveSession() instead of reimplementing
- Add parseDuration utility for --older-than flag
- Fix API route collision (/api/cleanup/ instead of /api/sessions/cleanable)
- Add CleanupFlowState for Telegram selection state with TTL
- Clarify default filter excludes active/initializing
- Add archiving flag edge case to test plan
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 98610f1a27c8
* docs: add design spec for extracting Discord plugin to standalone package
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 10f437186acf
* docs: address spec review feedback for Discord plugin extraction
- Fix npm scope to @openacp (not @open-acp) for consistency
- Fix peerDependency version to match date-based versioning
- Move misclassified exports to "Need to add" section
- Add ConfigManager, AgentCatalog, requestRestart to SDK exports list
- Add essential: false, pluginDependencies notes
- Add tsconfig.json template
- Add exports field and .npmignore to package.json
- Add runAdapterConformanceTests to SDK testing exports
- Add legacy migration map update for backward compat
- Add boot order note for pluginDependencies
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: c5db89eae6aa
* docs: add implementation plan for extracting Discord plugin
9 tasks: extend CLI exports, extend SDK, migration map, scaffold
project, copy+refactor source, verify build, remove from OpenACP,
update README, push repos.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: a54a5510736a
* feat(core): export format-utils, message-formatter, CommandRegistry, Doctor, PRODUCT_GUIDE for plugin SDK
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 27b04551e9a7
* feat(plugin-sdk): export all symbols needed by adapter plugins
Entire-Checkpoint: a1ed33612eb6
* fix(plugin): add @openacp/plugin-discord migration alias for backward compat
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: a9db7beb2975
* fix(sdk): add missing adapter-primitive exports and testing entry point
- Add MessagingAdapterConfig, IRenderer, RenderedMessage type exports to src/core/index.ts
- Add DisplayVerbosity, ToolCallMeta, ToolUpdateMeta, ViewerLinks type exports
- Add STATUS_ICONS, KIND_ICONS, progressBar, formatTokens, truncateContent, stripCodeFences, splitMessage exports
- Add extractContentText, formatToolSummary, formatToolTitle, resolveToolIcon exports
- Create src/testing.ts as a separate entry point exporting runAdapterConformanceTests
- Add ./testing export map to @openacp/cli package.json
- Fix @openacp/plugin-sdk/testing.ts to import from @openacp/cli/testing
- Fix version strings to use valid semver (2026.326.4 not 2026.0326.4)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: restore original version format YYYY.MMDD.patch
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: remove built-in Discord plugin (now available as @openacp/plugin-discord)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(plugin): resolve 3 bugs preventing dev plugins from loading
- lifecycle-manager: include already-loaded plugins in dependency resolution
so late-booted dev plugins aren't cascade-skipped
- dev-loader: use URL query string for ESM cache busting instead of copying
to temp dir, which broke relative imports (e.g., './adapter.js')
- adapter-primitives: remove runAdapterConformanceTests from main barrel
to prevent vitest from leaking into runtime bundle
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 64f604573bb7
* fix(review): address PR #80 code review feedback
- Remove core→plugin-discord import in config-editor (architecture violation):
inline Discord token validation using REST API /users/@me instead of
importing from @openacp/plugin-discord/validators
- Mark legacyMap in lifecycle-manager as @deprecated with migration notes
- Remove 98 planning artifacts from docs/superpowers/ (72k+ lines)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: cdeeaa98a4f1
* Revert "fix(plugin): resolve 3 bugs preventing dev plugins from loading"
This reverts commit 031464640560628dd8c093a4d8d30895c775ef98.
Entire-Checkpoint: 6ed1a02a0cb5
* Reapply "fix(plugin): resolve 3 bugs preventing dev plugins from loading"
This reverts commit 5707bf1c240f52baab277d21333cd7d92c191fac.
Entire-Checkpoint: bfaaa263a765
* revert: restore docs/superpowers/ plans and specs
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 9195220e9172
* fix(review): revert unrelated changes and organize SDK sub-paths
- Revert --channel flag, assistant prompt changes, and session route
changes that don't belong in Discord extraction PR (#82)
- Add SDK sub-path exports: @openacp/plugin-sdk/formatting,
@openacp/plugin-sdk/config (alongside existing /testing) (#83)
- Mark SDK exports as @stable vs @experimental
- Fix plugin count test (10 → 9 after Discord removal)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 9bd5c44d98c4
* fix(review): address round 2 feedback on PR #80
- Rename @openacp/plugin-discord → @openacp/adapter-discord in all refs
(setup-channels, wizard, lifecycle-manager, docs)
- Keep @openacp/plugin-discord as legacy alias in lifecycle-manager
- Remove unrelated session-cleanup-design.md spec from PR
- SDK: deduplicate main barrel by re-exporting from sub-path modules
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 4454289e400f
* fix(review): remove remaining Discord references from core
- Remove Discord doctor check from core (plugin registers its own)
- Dynamic adapter discovery via ServiceRegistry instead of hardcoded list
- Remove @openacp/discord from auto-register built-in plugins list
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: c15c5fbf08c8
* fix(config): auto-install Discord plugin when enabling via config editor
When user enables or configures Discord through `openacp config` (not
onboarding), check if @openacp/adapter-discord is installed. If not,
prompt to install it automatically via npm.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: dd218c585ae3
* fix(review): round 3 cleanup — extensible ChannelId, update CLAUDE.md
- Change ChannelId from fixed union to string for extensibility
- Remove discord/ from CLAUDE.md project layout (now external plugin)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 66d8d185cda7
* fix(review): resolve all remaining Discord coupling in core
- Remove DiscordPlatformData from core types (plugin defines its own)
- Remove DiscordPlatformData from SDK re-exports
- Config editor: delegate Discord config to plugin configure() instead
of 100+ lines of inline Discord logic
- Update integrate.ts help text to be adapter-agnostic
- Clean absolute local paths from planning docs
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 094cc484aaae
* fix: replace execSync npm install with async utility
Extract installNpmPlugin() into a shared utility that uses async exec
instead of execSync, preventing event loop blocking. Used by both
config-editor.ts and wizard.ts instead of inline execSync calls.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: 0xmrpeter <0xmrpeter@gmail.com>