Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python

Merge release/v0.0.302.6 into fix/vision-openai-codex-acp-images

Rach Pradhan5a514a5d4206
diff --cc CHANGELOG.md
index b7c12d7a,0b92204a..a175762d
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -22,12 -22,14 +22,20 @@@ current is part of cutting a release
- ACP clients can pass MCP servers in `session/new` and `session/load`, and `GRAFF_NO_PLUGINS` now applies before those servers connect.
- Opted-in ACP clients can preview child-agent activity live, and background workers stream through a Graff extension across turns. Session teardown waits for background agents, and deferred MCP startup joins run under the registry lock.
+ ### Workspaces over ACP
+
+ - ACP sessions now use the folder the client asks for on `session/new` and `session/load`, as the protocol requires, instead of the folder graff was launched in. A relative or missing folder is rejected.
+ - The worktree a session runs in is reported as `_meta["graff/worktree"]` (name, path, branch, base, owning checkout, and whether graff generated it), or `null` in a main checkout. The non-standard top-level `cwd` in the `session/new` reply is gone; the desktop app reads the new field and still accepts older builds.
+ - Reopening a session works from the repository root when the process runs in a `-w` tree, and from a main checkout when the save lives in one of its worktrees. Switching workspace mid-session sends `session_info_update`.
+ - `-w` sessions record their real worktree path. They used `$PWD`, which names the host's own folder when an app launches graff, so their saves pointed at a path that did not exist.
+ - `graff worktree` exits 1 when it refuses or fails and 2 when it does nothing, instead of always 0. Merging a workspace that does not exist now says so.
+
+### Image input
+
+- Every OpenAI `gpt-*` model is treated as image-capable (gpt-oss and gpt-3.5 excepted), and so is every model on the `openai` and `codex` providers, including o-series and `codex-*` ids. New releases no longer ship text-only by omission.
+- ACP clients can send standard `image` prompt blocks, and `promptCapabilities.image` is now advertised. Images join the next model request when the model accepts them and are skipped for text-only models. An image with no caption is sent with a short note, since some providers reject an empty text part.
+- Graff no longer crashes at startup when its presence socket path would exceed the platform limit (a long `$HOME`); that best-effort listener is skipped instead.
+
### Optional formal evidence for local learning
- Bounded lifecycle models cover effort changes, asynchronous tools, permission ownership, and connection leases. Deliberately weakened configurations provide counterexamples for the invariants those models are meant to guard.
diff --cc build.zig
index 7971aa49,02585754..b0235cb2
--- a/build.zig
+++ b/build.zig
@@@ -155,9 -155,9 +155,12 @@@ pub fn build(b: *std.Build) void
const workspace_lifecycle_test = b.addSystemCommand(&.{ "python3", "scripts/test-workspace-lifecycle.py" });
workspace_lifecycle_test.addArtifactArg(exe);
test_step.dependOn(&workspace_lifecycle_test.step);
+ const acp_workspace_test = b.addSystemCommand(&.{ "python3", "scripts/test-acp-workspace.py" });
+ acp_workspace_test.addArtifactArg(exe);
+ test_step.dependOn(&acp_workspace_test.step);
+ const acp_images_test = b.addSystemCommand(&.{ "python3", "scripts/test-acp-images.py" });
+ acp_images_test.addArtifactArg(exe);
+ test_step.dependOn(&acp_images_test.step);
const run_tool_budget_test = b.addSystemCommand(&.{ "python3", "scripts/test-run-tool-budget.py" });
run_tool_budget_test.addArtifactArg(exe);
test_step.dependOn(&run_tool_budget_test.step);
diff --cc scripts/eval-tier1.sh
index 5a614a4a,d2440318..01d629db
--- a/scripts/eval-tier1.sh
+++ b/scripts/eval-tier1.sh
@@@ -189,7 -189,7 +189,8 @@@ if wanted shell; the
python3 scripts/eval/process_guard.py --timeout 90 python3 scripts/test-acp-released-fixes.py zig-out/bin/graff &&
python3 scripts/eval/process_guard.py --timeout 120 python3 scripts/test-acp-permissions.py zig-out/bin/graff &&
python3 scripts/eval/process_guard.py --timeout 90 python3 scripts/test-acp-session-load.py zig-out/bin/graff &&
- python3 scripts/eval/process_guard.py --timeout 120 python3 scripts/test-acp-workspace.py zig-out/bin/graff
++ python3 scripts/eval/process_guard.py --timeout 120 python3 scripts/test-acp-workspace.py zig-out/bin/graff &&
+ python3 scripts/eval/process_guard.py --timeout 90 python3 scripts/test-acp-images.py zig-out/bin/graff
); then :; else
record_fail shell
fi
diff --cc scripts/eval/tier1-manifest.json
index 510a5812,510a5812..26af8314
--- a/scripts/eval/tier1-manifest.json
+++ b/scripts/eval/tier1-manifest.json
@@@ -15,7 -15,7 +15,7 @@@
"src/repl.zig",
"TUI/root.zig"
],
-- "test_count_baseline": 2818,
++ "test_count_baseline": 2823,
"test_count_slack": 25,
"required_invariants": [
{
diff --cc src/test_hooks.zig
index 14871df8,795dfe1a..1c0d598d
--- a/src/test_hooks.zig
+++ b/src/test_hooks.zig
@@@ -350,7 -350,7 +350,8 @@@ test
_ = @import("acp_config.zig");
_ = @import("session_start_plugins_test.zig");
_ = @import("acp_mcp_servers.zig");
+ _ = @import("acp_workspace.zig");
+ _ = @import("acp_images.zig");
_ = @import("libgraff.zig");
_ = @import("tui_peer.zig");
_ = @import("acp_auth.zig");