sandbox-agent/docs
Nathan Flurry c91791f88d
feat: add configuration for model, mode, and thought level (#205)
* feat: add configuration for model, mode, and thought level

* docs: document Claude effort-level filesystem config

* fix: prevent panic on empty modes/thoughtLevels in parse_agent_config

Use `.first()` with safe fallback instead of direct `[0]` index access,
which would panic if the Vec is empty and no default is set.

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

* fix: harden session lifecycle and align cli.mdx example with claude.json

- destroySession: wrap session/cancel RPC in try/catch so local cleanup
  always succeeds even when the agent is unreachable
- createSession/resumeOrCreateSession: clean up the remote session if
  post-creation config calls (setMode/setModel/setThoughtLevel) fail,
  preventing leaked orphan sessions
- cli.mdx: fix example output to match current claude.json (model name,
  model order, and populated modes)

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

* fix: harden session lifecycle and align config persistence logic

- resumeOrCreateSession: Remove destroy-on-error for the resume path. Config
  errors now propagate without destroying a pre-existing session. The destroy
  pattern remains in createSession (where the session is newly created and has
  no prior state to preserve).

- setSessionMode fallback: When session/set_mode returns -32601 and the
  fallback uses session/set_config_option, now keep modes.currentModeId
  in sync with the updated currentValue. Prevents stale cached state in
  getModes() when the fallback path is used.

- persistSessionStateFromMethod: Re-read the record from persistence instead
  of using a stale pre-await snapshot. Prevents race conditions where
  concurrent session/update events (processed by persistSessionStateFromEvent)
  are silently overwritten by optimistic updates.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* fix: correct doc examples with valid Codex modes and update stable API list

- Replace invalid Codex mode values ("plan", "build") with valid ones
  ("auto", "full-access") in agent-sessions.mdx and sdk-overview.mdx
- Update CLAUDE.md stable method enumerations to include new session
  config methods (setSessionMode, setSessionModel, etc.)

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

* fix: add OpenAPI annotations for process endpoints and fix config persistence race

Add summary/description to all process management endpoint specs and the
not_found error type. Fix hydrateSessionConfigOptions to re-read from
persistence after the network call, and sync mode-category configOptions
on session/update current_mode_update events.

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

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 00:24:32 -08:00
..
ai fix host for docs 2026-02-13 04:53:53 +05:00
deploy Add SDK health wait gate (#206) 2026-03-06 00:05:06 -08:00
images feat(inspector): improve contrast and add collapsible debug panel (#182) 2026-02-13 07:15:40 +00:00
logo chore(site): links and image updates 2026-01-28 02:16:37 -08:00
agent-capabilities.mdx feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
agent-sessions.mdx feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
architecture.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
attachments.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
building-chat-ui.mdx chore: commit remaining workspace updates 2026-02-08 11:51:47 -08:00
cli.mdx feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
cors.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
credentials.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
custom-tools.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
daemon.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
docs.json feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
favicon.svg chore(site): diagram mobile and favicon 2026-01-31 22:49:01 -08:00
file-system.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
gigacode.mdx chore: update readme (#98) 2026-02-06 03:03:24 -08:00
inspector.mdx chore: fix bad merge 2026-02-11 07:33:19 -08:00
manage-sessions.mdx acp spec (#155) 2026-02-11 14:47:41 +00:00
mcp-config.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
multiplayer.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
observability.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
openapi.json feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
opencode-compatibility.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
pi-support-plan.md wip: pi working 2026-02-06 16:54:53 -05:00
quickstart.mdx docs: fix bun trust command 2026-02-11 18:52:32 -08:00
sdk-overview.mdx feat: add configuration for model, mode, and thought level (#205) 2026-03-06 00:24:32 -08:00
security.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
session-persistence.mdx docs: fix bun trust command 2026-02-11 18:52:32 -08:00
session-restoration.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
session-transcript-schema.mdx Merge branch 'main' into feat/support-pi 2026-02-10 22:27:03 -08:00
skills-config.mdx chore: fix bad merge 2026-02-11 07:57:02 -08:00
telemetry.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
theme.css docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
troubleshooting.mdx fix: detect musl/glibc at runtime for correct Claude binary download 2026-01-28 04:19:35 -08:00