You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 77db267
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: AGENTS.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -254,6 +254,8 @@ crewcoder/
254
254
255
255
## Current hard-won notes
256
256
257
+
- Tool mode defaults to `crewcoder` for new sessions; `native` uses Codex CLI or Claude SDK tools without CrewCoder built-in/extension tools. Preserve saved mode on resume and host custody precedence. Host-supplied tools, virtual filesystems and specialized agent modes force CrewCoder tools. Never apply the standalone preference around host approvals. See `crewcoder-agent/docs/TOOL_MODE.md`.
258
+
257
259
- ACP hosts advertise `_meta["crewcoder/questions"].version: 1` to receive `_crewcoder/request_question` with original option values, free-text/Other, secret flags, and exact provider permission details. Questions must never become automatic permission approvals. Cancel pending cards on session/provider cancellation. Explicit Never remains non-interactive; use Review when escalation should ask. See `crewcoder-agent/docs/ACP_ADAPTER.md`.
258
260
259
261
- Reuse provider-specific computer-use integrations where available; the universal computer-use layer is deferred. Claude's built-in CLI computer use is documented as macOS-only and interactive-only, so CrewCoder's non-interactive Agent SDK transport cannot currently reuse it. Claude Desktop Windows support does not establish SDK support; never relax strict MCP isolation as a workaround. See `crewcoder-agent/docs/CODEX_CLI_PROVIDER.md`.
Copy file name to clipboardExpand all lines: crewcoder-agent/AGENTS.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -276,7 +276,7 @@ Codex / OpenAI Responses:
276
276
Claude Agent SDK:
277
277
- `claude` is the local-login Agent SDK provider; `anthropic` remains the direct API-key Messages provider.
278
278
- Keep `settingSources: ["project"]`, `skills: []`, and `strictMcpConfig: true`: preserve project CLAUDE.md guidance without auto-injecting global skill catalogs or undeclared MCP servers. On-demand skill files under `~/.agents/skills` and the other user catalogs remain readable; do not force Skill-tool activation.
279
-
- Tool ownership is hybrid. Native Claude is limited to Read/Grep/Glob/AskUserQuestion; Bash, mutations, and specialized tools must route through the in-process CrewCoder MCP server and existing executor.
279
+
- New sessions use explicit Tool mode: `crewcoder` disables native Claude coding tools and uses the CrewCoder MCP executor; `native` uses the SDK tool preset and provider permission routing. Pre-setting sessions retain the original hybrid Read/Grep/Glob/AskUserQuestion behavior. Host custody always overrides the preference. See `docs/TOOL_MODE.md`.
280
280
- Disable native Read/Grep/Glob whenever a virtual `TextFileHost` is active (especially ACP SSH/SFTP); route those operations through CrewCoder MCP so the local Claude process cannot cross host boundaries.
281
281
- Persist returned SDK session ids in `providerSessionIds.claude`; never substitute the CrewCoder session id or send Claude ids to another provider.
Copy file name to clipboardExpand all lines: crewcoder-agent/docs/CODEX_CLI_PROVIDER.md
+27-2Lines changed: 27 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,6 +60,31 @@ See [Claude Code computer use](https://code.claude.com/docs/en/computer-use).
60
60
Connecting an external automation service would be separate work; do not
61
61
disable strict MCP isolation as a workaround.
62
62
63
+
## Image results from hosted tools
64
+
65
+
CrewCoder's guest/local read tool declares images on the tool result's image metadata.
66
+
The Codex app-server adapter now reads those authorized local files and sends their
67
+
pixels as dynamic-tool inputImage content items alongside the text description.
68
+
Native view_image remains disabled in hosted-tools-only sessions. ACP client text
69
+
I/O and hosted-text-only tools do not gain a binary filesystem fallback.
70
+
71
+
The adapter rechecks workspace and session external-directory scope, sniffs PNG,
72
+
JPEG, GIF or WebP bytes, and limits a response to four images, 8 MiB per image and
73
+
16 MiB total. Missing, changed, unsupported or oversized images produce a failed
74
+
tool response with a readable delivery error, without partial image content.
75
+
Image bytes are encoded only on the app-server wire; durable tool records retain
76
+
paths and metadata.
77
+
78
+
Regression command from the repository root:
79
+
80
+
```sh
81
+
node node_modules/vitest/vitest.mjs run --config test/codex-tool-images.config.ts
82
+
```
83
+
84
+
A guest with an older CrewCoder bundle still returns only the binary description.
85
+
Build and install the updated bundle in that guest before repeating VM GUI acceptance;
86
+
restarting the desktop application alone does not update an existing guest disk.
87
+
63
88
## No fallback
64
89
65
90
If the app-server cannot start, the turn fails with the cause. It never falls back to the direct Responses transport, because that would need CrewCoder-owned credentials.
@@ -69,7 +94,7 @@ If the app-server cannot start, the turn fails with the cause. It never falls ba
69
94
70
95
## Hosted-tools-only lockdown
71
96
72
-
When CrewCoder routes the filesystem itself (`useProviderNativeFileTools: false`, which ACP virtual-filesystem sessions and Supervisor hosted sessions set), only CrewCoder's dynamic tools may act. The launch adds:
97
+
When `toolMode: crewcoder` is selected, or `useProviderNativeFileTools: false` enforces ACP virtual-filesystem or Supervisor custody, only CrewCoder's dynamic tools may act. The launch adds:
73
98
74
99
| Control | Why |
75
100
| --- | --- |
@@ -97,4 +122,4 @@ Fail-closed rules:
97
122
## Limits
98
123
99
124
- Feature names are tied to the Codex versions above. A Codex update that adds a new native tool under a new feature name is not removed until it is added here. The read-only sandbox still blocks native writes and command execution.
100
-
-Without lockdown (plain CrewCoder use), Codex keeps its native tools and the user's full Codex config, as when running `codex` directly.
125
+
-With native Tool mode, Codex keeps its native tools and the user's full Codex config, as when running `codex` directly. New standalone sessions default to CrewCoder tools. See [Tool mode](TOOL_MODE.md).
if(options.hostedToolsOnly&&(!options.tools||!options.textFiles?.readTextFile||!options.textFiles.writeTextFile))thrownewError("Hosted tool policy requires supplied tools and both host text methods");
...(toolMode ? [`Tool mode: ${toolMode}. ${toolMode==="native" ? "Use the provider's native tools. CrewCoder built-in and extension tools are unavailable." : "Use the tools supplied by CrewCoder for actions."}`] : []),
351
356
options.hostedToolsOnly ? "You operate through host-authorized virtual text records only. Delegate execution through the host management bridge. Local project files, shell commands, native provider tools, and extension execution are unavailable." : buildSystemPrompt({ mode, skills, docs,identityPrompt: workerIdentityEnabled&&activeWorker ? buildIdentityPrompt(activeWorker) : null, crewTasksPrompt, extensionContext }),
0 commit comments