swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authormain <main@swarm.moe>2026-03-24 19:26:58 -0400
committermain <main@swarm.moe>2026-03-24 19:26:58 -0400
commit57db4dc94dbf571ac8a393f61549def5afaa0209 (patch)
treee625a2af169a7397c34339e6150fc7bee1f900a2 /README.md
parent8b090c3d0daf8b336aab9074b0d8aa31a688e232 (diff)
downloadphone_opus-57db4dc94dbf571ac8a393f61549def5afaa0209.zip
Predeclare and stream consult session ids
Diffstat (limited to 'README.md')
-rw-r--r--README.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/README.md b/README.md
index dfaba8c..c2aaefa 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ It exposes one blocking domain tool:
- by default, phone_opus reuses the remembered Claude context for the consulted `cwd`
- pass `fresh_context: true` to opt out and start a fresh Claude context for that `cwd`
- a fixed consult prefix is prepended before the caller-supplied prompt
- - downstream failures still surface any reusable context handle for that `cwd`, so a post-reset retry can stick to the same session
+ - fresh consults predeclare a UUID session id and stream-confirm it eagerly, so downstream failures still surface a reusable context handle for that `cwd`
The server keeps the public MCP session in a durable host, isolates the actual
Claude invocation in a disposable worker, and ships standard health and
@@ -31,6 +31,8 @@ Each `consult` call runs Claude Code with:
- a read-only built-in toolset:
- `Bash,Read,Grep,Glob,LS,WebFetch`
- `--dangerously-skip-permissions`
+- `--session-id <uuid>` on fresh consults, or `--resume <uuid>` when reusing remembered `cwd` context
+- `--output-format stream-json` so phone_opus can capture the init/result session metadata eagerly instead of waiting for the terminal result blob
- an external `systemd-run --user` sandbox instead of Claude's internal permission gate
- the filesystem stays globally read-only under `ProtectSystem=strict`
- `phone_opus` gives Claude a separate persistent home and XDG state under its own state root