docs(smith): update tool inventory, approval modes, and provider configuration by edwin-zvs · Pull Request #1323 · construct-worlds/construct · GitHub
Skip to content

docs(smith): update tool inventory, approval modes, and provider configuration - #1323

Open
edwin-zvs wants to merge 1 commit into
mainfrom
docs-smith-tools-approval-modes
Open

docs(smith): update tool inventory, approval modes, and provider configuration#1323
edwin-zvs wants to merge 1 commit into
mainfrom
docs-smith-tools-approval-modes

Conversation

@edwin-zvs

Copy link
Copy Markdown
Contributor

Summary

Updates docs/smith.md to match the current Smith implementation, tool inventory, three approval modes, context management, and provider configuration.

  • Tool inventory: Replaces obsolete file read/write/list/find tool descriptions with the current Codex-style minimal local coding tools (shell, write_stdin, edit_file supporting multi-hunk / multi-file batch edits and file creation), Chrome DevTools browser tools (browser_open, browser_inspect, browser_screenshot, browser_eval), and daemon/fleet control tools including recurring loops (agentd_loop_*), playbook operations (agentd_playbook_get, agentd_playbook_edit), and Smith-owned subagents (agentd_subagent_*).
  • Three approval modes & transitions: Replaces obsolete boolean automode with the three explicit approval modes (manual, auto_review, always-approve / unsafe_auto on the wire). Details Safe vs Risky classifications, dynamic Safe downgrades (shell with read_only: true, edit_file within auto-approved paths), inline approval prompt keys (y/n/a/f), mode cycling (C-x A / A / modeline badge click), and initial override via CONSTRUCT_SMITH_AUTOMODE=1.
  • Context management & compaction: Documents tool output truncation (8 KiB budget), automatic context compaction before pruning (AUTO_COMPACT_RATIO = 0.65, [Compacted earlier context], DEFAULT_KEEP_PAIRS = 4), manual /compact [N], and rolling prune at 70% utilization.
  • Provider & config drift: Adds OpenRouter (openrouter:, OPENROUTER_API_KEY, profile support, and fallback ladder position); documents CODEX_HOME and CONSTRUCT_CLAUDE_OAUTH_CREDENTIALS; clarifies that CONSTRUCT_CLAUDE_BIN / CONSTRUCT_CLAUDE_CMD configure the standalone claude CLI adapter harness rather than Smith's claude-oauth:; and documents CONSTRUCT_SMITH_FLEET_TOOLS=off and CONSTRUCT_SMITH_AUTO_COMPACT=off.

Verification

  • cargo test -p construct-adapter-smith (229 tests passed)
  • cargo build completed cleanly across workspace
  • Verified internal links and diff

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant