29 Commits

Author SHA1 Message Date
0xmrpeter
abe0d8ed29 docs: update CLAUDE.md to reflect the addition of a new middleware hook
- Updated the documentation to indicate the total number of middleware hooks has increased from 18 to 19.
- Adjusted references in the getting-started-plugin guide to ensure consistency with the updated middleware hook count.
- Corrected the middleware hooks section in the plugin template to reflect the accurate total.
2026-04-06 15:50:16 +07:00
0xmrpeter
2075fc4819 docs(telegram): update terminology and document new prerequisite behavior
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-05 22:28:14 +07:00
hightman
6f77aed353
feat(integrate): add OpenCode session handoff integration (#205)
* feat(integrate): add opencode handoff plugin strategy

Add a plugin-based integration path so OpenCode can hand off sessions bidirectionally while preserving the existing hooks flow for other agents. This enables /openacp:handoff in OpenCode and avoids jq requirements for that integration.

Co-authored-by: Codex <noreply@openai.com>

* fix(integrate): address PR review for opencode strategy

Make integration strategy discriminated and exhaustive, harden OpenCode injected text part shape, and improve plugin install/uninstall idempotency and messaging. Add regression tests for reinstall and empty uninstall paths.
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: 0xmrpeter <0xmrpeter@gmail.com>

---------

Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: 0xmrpeter <0xmrpeter@gmail.com>
2026-04-05 10:07:19 +07:00
0xmrpeter
0c302331cc docs(cli): enhance help documentation with --json flag support
- Added `--json` flag descriptions to various CLI commands in the help text.
- Updated command usage examples to include `--json` for machine-readable output.
- Clarified that commands supporting `--json` will output results in a consistent JSON format.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 16:24:54 +07:00
0xmrpeter
add905a40c docs: clean up and simplify gitbook documentation
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 22:28:37 +07:00
0xmrpeter
e8af143c87 docs: update gitbook for recent specs (03-29 to 04-01)
Add new pages: output modes, workspaces (multi-instance), app connectivity.
Update 16 existing pages to reflect: tunnel auto-start/keepalive, JWT auth
system, SSE streaming, session config options, one-liner install, startup UX,
lazy session resume, new CLI commands (attach, remote), and new chat commands
(/mode, /model, /thought, /dangerous).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 21:24:26 +07:00
0xmrpeter
914fc013d6 refactor: rename 'dangerous mode' to 'bypass permissions' across documentation and code
- 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.
2026-04-01 13:28:08 +07:00
0xmrpeter
abd2cc098a feat: implement agent switch lifecycle events for UI feedback
- 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.
2026-03-31 17:32:27 +07:00
0xmrpeter
0ff03d1459 fix: update archive session behavior and documentation
- 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.
2026-03-31 16:56:31 +07:00
0xmrpeter
8c2da0af50 feat: add openacp restart command, fix bundle chunk crash on upgrade
- 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>
2026-03-31 15:52:48 +07:00
0xmrpeter
3380faa4df docs: update plugin commands for consistency and clarity
- 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.
2026-03-31 15:40:09 +07:00
0xmrpeter
40f364717f docs: update Discord docs for output mode parity
- discord.md: add missing slash commands to table (outputmode, verbosity,
  dangerous, tts, settings, doctor, etc.); document tool card embeds
  and action row buttons in "How Sessions Work"
- chat-commands.md: fix /outputmode description — correct low mode label
  ("icons only"), add adapter-level reset, document 3-level cascade,
  add note about Discord action row buttons
- configuration-schema.md: expand discord outputMode description to
  mention per-session override cascade and displayVerbosity auto-migration

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 15:03:23 +07:00
0xmrpeter
25475fb74a docs(slack): add output mode section, /outputmode setup step, fix /openacp-new typo
- slack.md: add Step 6 sub-section for registering /outputmode slash command
- slack.md: add outputMode field to config table
- slack.md: add Output Mode section (Low/Medium/High, thread rendering, /outputmode usage)
- slack.md: add /outputmode to commands table and examples
- slack-issues.md: fix incorrect /openacp-new command (should be /new)
- slack-issues.md: update outputMode reference, remove deprecated displayVerbosity mention
- slack-issues.md: add /outputmode troubleshooting entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 15:03:02 +07:00
0xmrpeter
aa36315a42 fix(agent-switch): update docs for Discord/Slack, improve rollback with resume
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>
2026-03-30 20:38:58 +07:00
0xmrpeter
efb7f552a9 docs: add agent switch feature documentation
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>
2026-03-30 18:43:24 +07:00
0xmrpeter
16e0884354 fix(output-mode): wire outputViewerLink, fix verbosity callback key, update docs
- DisplaySpecBuilder: add TunnelServiceInterface constructor injection, implement
  outputViewerLink/outputFallbackContent for long output (>15 lines or >800 chars)
- DisplaySpecBuilder: fix buildThoughtSpec indicator to "Thinking..."
- ActivityTracker: store and pass tunnelService to DisplaySpecBuilder, pass sessionContext
  to all buildToolSpec calls
- setupVerbosityCallbacks: write outputMode instead of deprecated displayVerbosity key
- /verbosity static command description updated to note deprecation
- Docs: update displayVerbosity → outputMode across configuration, chat-commands,
  troubleshooting, and architecture docs; add /outputmode command reference
2026-03-30 01:52:51 +07:00
0xmrpeter
428e343ea8 Merge branch 'develop' 2026-03-28 07:44:40 +07:00
0xmrpeter
340b7bdc34 feat(scaffold): add CLAUDE.md and PLUGIN_GUIDE.md to plugin template
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 10:41:56 +07:00
0xmrpeter
e7f925b055 feat(cli): support community npm install, @version syntax, and compatibility check
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 10:37:29 +07:00
0xmrpeter
0898fe6e37 docs: add plugin registry submission guide to GitBook
- contributing.md: full step-by-step guide for publishing to registry
- getting-started-plugin.md: brief mention with link after npm publish step

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 10:03:27 +07:00
0xmrpeter
63bee61daa fix: update outdated docs + add system command tests
- Fix adapter-reference.md and building-adapters.md (AdapterFactory → plugin pattern)
- Fix contributing.md (src/adapters/ → src/plugins/)
- Fix for-contributors.md (plugin-manager → PluginRegistry)
- Update configuration.md for per-plugin settings
- Update environment-variables.md for plugin-level env vars
- Add system command handler tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 22:14:52 +07:00
0xmrpeter
4121840b84 docs: add plugin dev tooling guides (getting started, SDK reference, dev mode)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 21:07:56 +07:00
0xmrpeter
301d1c0b3c docs: add architecture documentation for microkernel plugin system
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 19:52:41 +07:00
0xmrpeter
0b193428b7 docs: update links in README and documentation for consistency
- Updated various links in README.md and documentation files to point to the new GitBook URLs for better accessibility.
- Ensured all references to the Agent Client Protocol (ACP) guide are now linked correctly.
2026-03-26 10:03:37 +07:00
0xmrpeter
861d99f6cc docs: update getting-started overview links to quick-start
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 23:59:13 +07:00
0xmrpeter
004a8ff1b1 docs: merge for-users and for-developers into single quick-start guide
OpenACP is self-hosted so the user and developer are the same person.
Consolidated into one unified quickstart page with a natural flow:
Install → Setup wizard → Start → Chat.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 23:54:05 +07:00
0xmrpeter
362459aa74 docs(gitbook): add cross-references and internal links across all pages
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 18:03:42 +07:00
0xmrpeter
7007ed3cec docs(gitbook): write all 8 content sections — complete documentation
Sections written:
- Getting Started (what-is-openacp, for-users, for-developers, for-contributors)
- Platform Setup (Telegram, Discord, Slack)
- Using OpenACP (commands, sessions, agents, permissions, voice, files)
- Self-Hosting (installation, configuration, daemon, security, logging, updating)
- Features (tunnel, context-resume, usage, persistence, handoff, doctor, assistant)
- Extending (plugin-system, building-adapters, adapter-reference, contributing)
- API Reference (CLI commands, REST API, config schema, env vars)
- Troubleshooting (Telegram, Discord, Slack, agent issues, FAQ)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 18:00:11 +07:00
0xmrpeter
b834749a5e docs(gitbook): scaffold directory structure, SUMMARY.md, and landing page
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 17:53:29 +07:00