28 Commits

Author SHA1 Message Date
sen 4feb29121c chore: migrate actionbook.dev to actionbook.app (#614)
* [packages/actionbook-extension]fix: point Cloud Mode OAuth and edge WebSocket at actionbook.app

clerk.actionbook.dev is now only a 307 redirect shim to clerk.actionbook.app
and its JWKS endpoint no longer responds, so hardcoding it left the extension
depending on a half-decommissioned host. Both edge hosts already advertise
clerk.actionbook.app as their OAuth authorization server, so switching is a
no-op for existing sessions.

- CLERK_AUTHORIZE_URL / CLERK_TOKEN_URL -> clerk.actionbook.app
- DEFAULT_CLOUD_ENDPOINT -> wss://edge.actionbook.app/extension/ws
- popup / callback "Learn more" links -> actionbook.app/docs
- PRIVACY.md + README.md updated to match the new hosts

manifest.json uses host_permissions ["<all_urls>"], so no permission change
is required.

* [root]docs: migrate actionbook.dev links to actionbook.app

Domain migration for everything that resolves on the new domain, verified
live before the swap: actionbook.app (+ /docs, /discord, /request-website),
edge.actionbook.app/mcp (401 + self-consistent OAuth metadata) and
accounts.actionbook.app/waitlist.

Deliberately left on actionbook.dev:
- api.actionbook.dev (57 refs) - api.actionbook.app has no DNS record yet,
  and it is still the default in mcp/js-sdk/dify-plugin/openclaw-plugin.
- @actionbook.dev addresses - actionbook.app has no MX records.
- .docs/ reports and the extension CHANGELOG - historical records.
- dify-plugin search_actions.py SSRF hints - they refer to the API host.

Also repoints dify-plugin's Documentation URL from docs.actionbook.dev
(no DNS, dead link) to actionbook.app/docs.

* [packages/actionbook-extension]fix: bump to 0.5.1 so the endpoint migration ships

The extension is distributed through the Chrome Web Store, which refuses an
update that does not increase manifest.json's version. Leaving it at 0.5.0
meant installed Cloud Mode users would keep pointing at the degraded
clerk.actionbook.dev host despite the source change.

@actionbookdev/extension is in .changeset/config.json's ignore list, so
`changeset version` never bumps it — the bump has to be manual here.
package.json and manifest.json are set to the same value, so
scripts/sync-versions.js stays a no-op.
2026-07-31 14:15:51 +08:00
asensagent c112388c7a docs(start): document --set-session-id get-or-create and SESSION_PROFILE_MISMATCH (#588)
Sync session reuse semantics (ACT-987, PR #587) across all four doc
surfaces. --set-session-id is now get-or-create (same as --session).
Documents new SESSION_PROFILE_MISMATCH error code when reusing a
session with a mismatched --profile flag.
2026-04-22 14:46:54 +08:00
asensagent e10cab4490 docs(har): document HAR truncation signal and default bump (#584)
Sync HAR truncation envelope behavior (ACT-970, PR #583) across all
four doc surfaces: command-reference.md, cli.mdx, browser.mdx, SKILL.md.
Documents --max-entries default bump (10000), meta.truncated,
meta.warnings HAR_TRUNCATED message, and data.max_entries field.
2026-04-22 14:23:19 +08:00
asensagent 49e59c2246 docs(cdp): document CDP_* structured error taxonomy (#581)
Sync CDP error code taxonomy (ACT-972, PR #580) across all four doc
surfaces: command-reference.md, cli.mdx, browser.mdx, SKILL.md.
Documents 6 CDP_* codes, retryable behavior, error.details schema,
hints, and legacy CDP_ERROR migration note (ACT-999).
2026-04-22 09:44:18 +08:00
asensagent a26474f551 docs(close): document browser close idempotent semantics (#579)
Sync browser close idempotent behavior (ACT-969, PR #577) across all
four doc surfaces: command-reference.md, cli.mdx, browser.mdx, SKILL.md.
Documents envelope shape, warning text, and SESSION_CLOSING edge case.
2026-04-22 08:13:36 +08:00
asensagent a1e68b9106 docs(eval): document --file/stdin input sources and CLI-layer error codes (#578)
* docs(eval): document --file/stdin input sources and 4 CLI-layer error codes (#576)

Sync doc surfaces with browser eval --file/stdin support and 4 new
client-only error codes (EVAL_ARGS_CONFLICT, EVAL_FILE_NOT_FOUND,
EVAL_STDIN_TTY, EVAL_STDIN_EMPTY) merged in #576 (ACT-975).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(eval): align EVAL_FILE_NOT_FOUND sub-cases in cli.mdx

Add "invalid data" to match command-reference.md and io_kind_to_reason()
bounded vocab.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-22 01:24:18 +08:00
Asen's Agent 338de7c9a0 docs(eval): document structured EvalErrorCode error envelope (#573)
Sync doc surfaces with the structured browser eval error contract
merged in #573 (ACT-967/ACT-973). Covers all five error codes,
error.details fields, and body_head inspection guidance.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-21 19:52:35 +08:00
asensagent f8287d1255 docs(wait network-idle): update to edge-triggered semantics (#574)
Replace relaxed/strict mode descriptions with edge-triggered framing
across cli.mdx, browser.mdx, and command-reference.md to match the
implementation merged in #558.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-21 19:27:50 +08:00
Codex efc35f7e2d [packages/cli]revert: remove --auto-connect (rollback of #545)
The --auto-connect feature's probing logic targets Chrome's legacy
/json/version endpoint. Chrome's new native "Allow remote debugging"
toggle (chrome://inspect) uses a different protocol, so --auto-connect
cannot attach to a user's daily Chrome profile — the only way to make
it work is to launch a dedicated Chrome with --remote-debugging-port
and an isolated user-data-dir, which is equivalent to `browser start`.

Rolling back so 1.5.0 ships without a misleading feature. Will revisit
once the native-toggle protocol is supported.

- Revert source changes from 9401bbee (feat: browser start --auto-connect)
- Remove --auto-connect from CLI help text (main.rs)
- Remove --auto-connect from 1.5.0 CHANGELOG entry
- Remove --auto-connect docs: docs/guides/browser.mdx, docs/api-reference/cli.mdx
- Remove --auto-connect examples from skills SKILL.md + command-reference.md

Also incorporates earlier CHANGELOG cleanups:
- Drop "ACT-" JIRA prefixes from release notes
- Drop mention of "browser send removed" (was never in a released version)
2026-04-18 00:30:25 +08:00
Asen's Agent 309828efb9 docs: change search/manual examples to use youtube
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-17 23:19:15 +08:00
Asen's Agent b5498fbd0e docs: update documentation for 1.5.0 release
- Add manual command (alias: man) to cli.mdx, command-reference, SKILL.md
- Add search/manual to SKILL.md command categories table
- Document relaxed-idle fallback mode for wait network-idle
- Bump extension version references from 0.3.0 to 0.4.0
- Document extension 0.4.0 changes: tab grouping, listTabs scoping
- Add session ID underscore support note
- Bump SKILL.md version from 1.4.3 to 1.5.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-17 21:31:45 +08:00
Asen's Agent d65cf0fb19 docs: add --auto-connect flag to browser start documentation
Document the new browser start --auto-connect flag (PR #545) across
CLI help, command reference, docs site, and SKILL.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-17 17:16:18 +08:00
Asen's Agent a455303ed1 docs: add HAR details — error codes, redirect behavior, limitations
Add state machine errors (HAR_ALREADY_RECORDING, HAR_NOT_RECORDING),
redirect chain behavior, no-body note, and iframe limitation to
command-reference and CLI reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-16 12:25:24 +08:00
Asen's Agent 9b9cd63884 docs: add network HAR recording commands to help, skills, and docs
Add `network har start` and `network har stop` to CLI help text,
SKILL.md command table, command-reference, CLI reference, and browser
guide. HAR records per-tab in HAR 1.2 format with optional --out path.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-16 12:24:15 +08:00
Asen's Agent a710f81ee1 docs: fix install path to ~/Actionbook/extension/, add Chrome Web Store recommendation, update READMEs
- Fix extension install path from ~/.actionbook/extension/ to ~/Actionbook/extension/
- Add Chrome Web Store (v0.3.0) as recommended install, mark CLI install as fallback
- Clarify fallback install requires manual Chrome load
- Add Extension & Daemon section to main README
- Update extension README: --session/--tab flags, bridge=daemon note

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-15 12:17:21 +08:00
Asen's Agent 345e043403 docs: add extension commands, daemon restart, and version bump for 1.4.3
Add documentation for the 5 extension subcommands (status, ping, install,
uninstall, path) and daemon restart across help text, SKILL.md, command
reference, CLI reference, and browser guide. Bump SKILL.md version to
1.4.3. Clarify that the extension bridge runs inside the actionbook daemon.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-15 11:55:24 +08:00
Asen's Agent 7321116e56 docs: add Network Phase A flags to docs and command-reference
Document new features from PR #524:
- `browser start --max-tracked-requests N` (default 500, range 1-100000)
- `browser list-sessions` now includes max_tracked_requests field
- `browser network requests --dump --out <dir>` exports to requests.json
- `browser restart` preserves max_tracked_requests

Updated: command-reference.md, api-reference/cli.mdx, guides/browser.mdx

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-14 17:00:54 +08:00
asensagent a42d58d92b docs: comprehensive audit fix for CLI 1.0.0–1.4.2 (#520)
* docs: comprehensive audit fix for CLI 1.0.0–1.4.2

Align docs/ and skills/ with CLI actual state after 1.0.0→1.4.2 changes.

P0 — broken examples fixed:
- quickstart.mdx: add --session/--tab, use start+goto instead of open
- index.mdx: replace search→get→operate flow with start→snapshot→automate
- api-reference/cli.mdx: remove search/get sections, add full browser
  command reference with --session/--tab on all commands
- guides/browser.mdx: add --session/--tab to Local Mode examples,
  replace search→get recommended workflow with snapshot-based workflow
- guides/cli-and-skills.mdx: add --session/--tab, update skill workflow
  from search→get→operate to start→snapshot→automate

P1 — missing flags and commands:
- command-reference.md: add --provider/-p, --stealth/--no-stealth,
  --header, --session to start; add --wait-until to goto; add --by-ref
  to select; add --no-isolate, pre-context fields, structured error
  details to eval; add --screenshot-format, --selector to screenshot;
  add hermes target and --browser to setup; remove --executable-path
- SKILL.md: add missing commands to Observation row (viewport, attr,
  attrs, box, styles, describe, state, inspect-point, pdf) and
  Interaction row (focus, drag, upload, eval, mouse-move,
  cursor-position); add cloud provider workflow section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: restore search/get references per review feedback

Keep actionbook search and actionbook get sections in docs — they will
be adjusted later. Restores search/get to api-reference/cli.mdx,
index.mdx, browser.mdx recommended workflow, and cli-and-skills.mdx
core commands and skill workflow. The --session/--tab fixes on browser
commands remain.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add select diagnostic output to command-reference

Document that `browser select` now returns structured diagnostics
(available values, visible texts, match mode, total count) when an
option is not found (PR #521).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-14 15:18:28 +08:00
sen df22a1ec40 docs: remove deprecated actionbook app documentation (#515)
[docs]chore: remove deprecated actionbook app documentation

The `actionbook app` (Electron desktop automation) feature was removed
during the CLI rewrite from TypeScript to Rust (v1.0.0+). The MDX
documentation was never cleaned up, causing users to encounter
"unknown command" errors when following the docs.

Removed:
- docs/guides/app-use.mdx (entire file)
- actionbook app section from docs/api-reference/cli.mdx
- Navigation entry from docs/docs.json
2026-04-13 20:39:56 +08:00
sen 94c7e2bea7 docs: update browser automation guide with cloud providers and CLI alignment (#514)
* [docs]docs: add cloud provider documentation for browser automation

- Add Cloud mode to Modes table and new Cloud Providers section in browser.mdx
- Add browser start/restart commands and expanded global flags in cli.mdx
- Add cloud provider tip in installation.mdx

* [docs]fix: align browser.mdx commands with actual CLI implementation

- Rename mode: Isolated → Local (matches Mode::Local enum)
- Fix command names: tab list → list-tabs, session list → list-sessions,
  wait-nav → wait navigation, wait-idle → wait network-idle,
  wait-fn → wait condition, hotkey → press, console → logs console,
  inspect → inspect-point, storage → local-storage/session-storage
- Remove 7 non-existent commands: fetch, batch, switch-frame, emulate,
  fingerprint, connect, info
- Fix argument order: fill/type use [selector] value (selector first)
- Fix coordinate format: mouse-move/inspect-point use comma x,y
- Fix flag: --full-page → --full for screenshot
- Fix cookies: session-level only (no --tab flag)
- Remove non-existent --ref and --human flags
- Remove non-existent -S short flag (use --session)
- Add --session/--tab to all per-tab command examples
- Restructure: add Session Lifecycle and Wait Conditions sections

All 47 documented commands verified against actionbook v1.4.1.

* [docs]refactor: reorder sections, remove stale content, polish wording

- Reorder: Local Mode → Cloud Providers → Extension Mode (by stability)
- Add "under active development" note on Extension mode
- Remove deprecated upgrade tip (v0.2.0 migration)
- Remove extension serve/stop mention
- Remove Risk Levels section (internal implementation detail)
- Simplify Extension Security to single paragraph
- Replace all em dashes with natural punctuation
- Simplify Session Lifecycle examples

* [docs]fix: remove unsupported -S shorthand from cli.mdx global flags

Address PR review comment: CLI only supports --session (long form),
no -S short alias exists.
2026-04-13 20:12:01 +08:00
mcfn.feng bd8c9767e7 [root]docs: restore deleted evaluate-api.mdx
Restores docs/api-reference/evaluate-api.mdx that was accidentally
removed in revert commit 72aac42.
2026-04-03 08:35:02 +08:00
AlexZ a35ba49827 [docs]fix: address PR #199 Codex review — correct CLI flags and arguments
- P2-1: `app attach [port]` → `app attach <target>` (required argument)
- P2-2: `--port` → `--cdp` (correct global flag for CDP port)
- P2-3: Remove invalid custom-path launch fallback; show manual
  start + attach workflow instead

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 18:35:51 +08:00
AlexZ 3299a0c5db [docs]feat: add actionbook app command documentation
- Add CLI reference for `actionbook app` commands (launch, attach, list, etc.)
- Add app automation guide with Electron use cases
- Update docs.json navigation structure
- Add agent prompt files to .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 14:35:42 +08:00
sen c70683da86 [docs]docs: simplify browser workflow and make setup-first quickstart (#147) 2026-02-19 00:50:14 +08:00
Adcent 1aaa6548e8 docs: make website CLI-first and demote MCP/SDK paths (#119) 2026-02-12 10:43:34 +08:00
sen 2e47ee6dab Add browser extension and CLI reference documentation (#95)
* [docs]feat: add browser extension documentation for PR #89

Add comprehensive documentation for the Chrome Extension Bridge feature:
- New guides/browser-extension.mdx with setup, usage, security, and
  troubleshooting sections
- docs.json navigation updated with new page entry
- index.mdx gains Integration Options card section (CLI/Extension/MCP)
- installation.mdx table and links include extension method
- cli-and-skills.mdx adds extension mode tip after browser examples
- api-reference/cli.mdx adds extension subcommands and --extension
  global flag documentation

* [docs]fix: update extension docs to reflect GitHub Release install flow

Sync documentation with PR #93 changes: extension is now downloaded
from GitHub Releases instead of extracted from embedded CLI binary.
2026-02-09 18:42:47 +08:00
Adcent 9c5db26e1a docs: restructure documentation for CLI-first approach 2026-02-05 17:01:11 +08:00
Adcent e29ee02281 [docs]feat: add Mintlify documentation site
- Add introduction page with demo video, Why Actionbook section, and How It Works steps
- Configure Mintlify theme with black/white color scheme
- Add Actionbook logo (light/dark variants)
- Set up navigation structure with Documentation and API Reference tabs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 21:23:06 +08:00