@warlock.js/ai-workspace 5.39.2 → 5.40.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@warlock.js/ai-workspace` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.40.0 - 2026-10-29
+
+### Added
+
+- `apply_patch` tool and `ws.applyPatch({ patch, dryRun? })`: apply a unified diff (plain or `git diff` style) that modifies, creates, deletes and renames several files in one call. The patch is atomic: every hunk is checked first and the files are written only if all apply, with a rollback if a write fails. Paths go through the workspace jail (`..`, absolute paths and symlinks out are refused), hunks are matched by context so small line drift is fine, CRLF and LF files keep their line endings, and binary patches or binary target files are refused with a clear error. `apply_patch` is part of `tools.all()` and is left out of `readonly()`.
+- `WorkspaceEditError.type` gains `"patch-invalid"`, `"hunk-failed"` (with `hunkIndex`), `"binary-file"`, `"file-exists"` and `"file-missing"`.
+- `parsePatch()` and `applyHunks()` are exported for applying a unified diff to a string without a workspace.
+- `applyPatch` is optional on a custom `WorkspaceOps`: an implementation without it still gets `apply_patch` and `ws.applyPatch()`, built on its `exists`, `readFile`, `writeFile` and `remove` with the same all-or-nothing behaviour (also exported as `applyPatchWithOps`).
+- `ApplyPatchInput`, `ApplyPatchResult` and `ApplyPatchFileResult` types; `"applyPatch"` joins `WorkspaceToolName`.
+
+### Changed
+
+- The package skill description now names the read, write and test tools (`makeReadFileTool`, `makeWriteFileTool`, `makeRunTestsTool`) and the "apply a patch" phrasing, so agents find them from the skill listing alone.
+
 ## 5.34.3 - 2026-10-20
 
 ### Changed

package/README.md

@@ -129,11 +129,11 @@ for (const file of await ws.glob("src/models/**/*.ts")) {
   and redirections kept inside the jail.
 - **Backends** — `local` (default; `@warlock.js/fs` + `node:child_process`) and
   `mock` (in-memory, for hermetic disk-free tests).
-- **Tools** under `ws.tools.*` — `read_file`, `edit_file`, `multi_edit`, `write_file`,
+- **Tools** under `ws.tools.*` — `read_file`, `edit_file`, `multi_edit`, `apply_patch`, `write_file`,
   `list_dir`, `run_shell` (optionally in the background), `shell_output`,
   `shell_kill`, `run_tests`, `grep`, `glob`, `todo_write`, `todo_read` — each a
   `ToolContract` (with a JSON Schema of its input) ready for `ai.agent({ tools })`.
-- **Direct methods** — `readFile` / `writeFile` / `editFile` / `multiEdit` /
+- **Direct methods** — `readFile` / `writeFile` / `editFile` / `multiEdit` / `applyPatch` /
   `listDir` / `exec` / `startShell` / `shellOutput` / `shellKill` / `listShells` /
   `grep` / `glob` / `exists` / `mkdir` / `remove` / `readTodos` / `writeTodos`,
   sharing the exact same policy seam, and `dispose()`.