Two-phase plan covering ConfigSchema cleanup, env var deduplication,
config-editor migration, PluginFieldRegistry, and legacyConfig removal
from all 6 affected plugins.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Implement Zod schemas for strict input validation on notify, tunnel, and topic routes.
- Block absolute workspace paths in CreateSession to prevent path injection.
- Validate scope strings and enforce limits on token lifetime and command strings.
- Sanitize output in file-viewer template to prevent XSS attacks.
- Adjust CORS settings and apply rate limiting for unauthenticated requests.
- Cap SSE connections and prompt body size to mitigate DoS risks.
- Restrict public health endpoint information to enhance security.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Updated CLI to register `instances` in `noInstanceCommands` map, allowing access without an existing instance root.
- Refactored instance creation to use `generateSlug` instead of `slugify`.
- Added `POST /exchange` route in the API server for exchanging one-time codes for JWTs, ensuring proper authentication bypass handling.
- Improved error handling for port detection in the API server, simplifying retry logic for available ports.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Covers: instances list/create commands, start --json extension,
POST /auth/exchange endpoint, GET /api/v1/workspace route.
TDD with vitest, step-by-step with exact code and commands.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- 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>
- 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>
- 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.
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)
- 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>
9 tasks in 3 phases: fix cleanup() prerequisite, SDK package with
types + testing utilities, scaffold generator, dev mode with hot-reload.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- reply() accepts OutgoingMessage for backward compat
- coreAccess typed as CoreAccess, not unknown
- toCallbackData uses cache for >64 byte payloads
- core.serviceRegistry → core.lifecycleManager.serviceRegistry
- system:commands-ready emission updated in Task 5
- Middleware ordering clarified for Task 6
- Handler types use unknown instead of any
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>