@oh-my-pi/pi-coding-agent 16.2.7 → 16.2.8

package/dist/types/config/settings-schema.d.ts

@@ -4962,6 +4962,62 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "providers.streamFirstEventTimeoutSeconds": {
+        readonly type: "number";
+        readonly default: -1;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Timeouts";
+            readonly label: "Stream First Event Timeout";
+            readonly description: "Seconds to wait for the first model stream event; -1 uses provider/env defaults, 0 disables the watchdog";
+            readonly options: readonly [{
+                readonly value: "-1";
+                readonly label: "Auto";
+                readonly description: "Use provider defaults and PI_* timeout env vars";
+            }, {
+                readonly value: "0";
+                readonly label: "Off";
+                readonly description: "Disable first-event timeout";
+            }, {
+                readonly value: "300";
+                readonly label: "5 minutes";
+            }, {
+                readonly value: "600";
+                readonly label: "10 minutes";
+            }, {
+                readonly value: "1800";
+                readonly label: "30 minutes";
+            }];
+        };
+    };
+    readonly "providers.streamIdleTimeoutSeconds": {
+        readonly type: "number";
+        readonly default: -1;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Timeouts";
+            readonly label: "Stream Idle Timeout";
+            readonly description: "Seconds a model stream may stay silent between events; -1 uses provider/env defaults, 0 disables the watchdog";
+            readonly options: readonly [{
+                readonly value: "-1";
+                readonly label: "Auto";
+                readonly description: "Use provider defaults and PI_* timeout env vars";
+            }, {
+                readonly value: "0";
+                readonly label: "Off";
+                readonly description: "Disable idle timeout";
+            }, {
+                readonly value: "300";
+                readonly label: "5 minutes";
+            }, {
+                readonly value: "600";
+                readonly label: "10 minutes";
+            }, {
+                readonly value: "1800";
+                readonly label: "30 minutes";
+            }];
+        };
+    };
     readonly "providers.openrouterVariant": {
         readonly type: "enum";
         readonly values: readonly ["default", "nitro", "floor", "online", "exacto"];

package/dist/types/edit/hashline/filesystem.d.ts

@@ -34,6 +34,7 @@ export declare class HashlineFilesystem extends Filesystem {
     canonicalPath(relativePath: string): string;
     allowTagPathRecovery(authoredPath: string, resolvedPath: string): boolean;
     readText(relativePath: string): Promise<string>;
+    readBinary(relativePath: string): Promise<Uint8Array | undefined>;
     preflightWrite(relativePath: string, options?: PreflightWriteOptions): Promise<void>;
     delete(relativePath: string): Promise<void>;
     move(fromRelative: string, toRelative: string, content?: string): Promise<void>;

package/dist/types/session/session-context.d.ts

@@ -41,9 +41,4 @@ export interface BuildSessionContextOptions {
     /** In transcript mode, elide entries replaced by the latest compaction. */
     collapseCompactedHistory?: boolean;
 }
-/**
- * Build the session context from entries using tree traversal.
- * If leafId is provided, walks from that entry to root.
- * Handles compaction and branch summaries along the path.
- */
 export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>, options?: BuildSessionContextOptions): SessionContext;

package/dist/types/session/settings-stream-fn.d.ts

@@ -2,8 +2,8 @@
  * Settings-aware stream wrapper shared by the main agent (sdk.ts) and the
  * advisor agent (AgentSession.#buildAdvisorRuntime).
  *
- * Reads OpenRouter / Antigravity routing variants, Responses-family text
- * verbosity, per-provider in-flight caps, and the loop guard out of `Settings`
+ * verbosity, stream watchdog budgets, per-provider in-flight caps, and the loop
+ * guard out of `Settings`
  * per request, layering them onto whatever options the caller passed. Before
  * this helper existed, advisor turns called bare `streamSimple` while the main
  * turn went through an inline closure that read these settings — so an advisor on

package/dist/types/tools/output-schema-validator.d.ts

@@ -14,6 +14,16 @@ export interface OutputValidator {
     validate(value: unknown): JsonSchemaValidationResult;
     /** Top-level required property names. Empty if the schema has no `required` array at root. */
     readonly requiredFields: readonly string[];
+    /**
+     * Per-label validators for incremental yields (`type: ["<label>"]`). Each entry validates the
+     * `data` payload of a single section against the matching top-level property's sub-schema —
+     * array-typed properties (e.g. `findings`) use the items schema since each yield contributes
+     * one element, while scalar properties use the property schema directly. Unknown labels (not
+     * top-level properties) have no entry and skip per-call validation. Lets the yield tool give
+     * the model retry feedback on a section as soon as it arrives, instead of deferring every
+     * mismatch to the parent's post-mortem `schema_violation`.
+     */
+    readonly validateSection: ReadonlyMap<string, (value: unknown) => JsonSchemaValidationResult>;
 }
 export interface BuildOutputValidatorResult {
     /** Present when the schema produced a usable validator (i.e. constraining schemas). Absent for missing/unconstrained schemas. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.2.7",
+	"version": "16.2.8",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -55,17 +55,17 @@
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.2.7",
-		"@oh-my-pi/omp-stats": "16.2.7",
-		"@oh-my-pi/pi-agent-core": "16.2.7",
-		"@oh-my-pi/pi-ai": "16.2.7",
-		"@oh-my-pi/pi-catalog": "16.2.7",
-		"@oh-my-pi/pi-mnemopi": "16.2.7",
-		"@oh-my-pi/pi-natives": "16.2.7",
-		"@oh-my-pi/pi-tui": "16.2.7",
-		"@oh-my-pi/pi-utils": "16.2.7",
-		"@oh-my-pi/pi-wire": "16.2.7",
-		"@oh-my-pi/snapcompact": "16.2.7",
+		"@oh-my-pi/hashline": "16.2.8",
+		"@oh-my-pi/omp-stats": "16.2.8",
+		"@oh-my-pi/pi-agent-core": "16.2.8",
+		"@oh-my-pi/pi-ai": "16.2.8",
+		"@oh-my-pi/pi-catalog": "16.2.8",
+		"@oh-my-pi/pi-mnemopi": "16.2.8",
+		"@oh-my-pi/pi-natives": "16.2.8",
+		"@oh-my-pi/pi-tui": "16.2.8",
+		"@oh-my-pi/pi-utils": "16.2.8",
+		"@oh-my-pi/pi-wire": "16.2.8",
+		"@oh-my-pi/snapcompact": "16.2.8",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/src/config/settings-schema.ts

@@ -144,7 +144,7 @@ export const TAB_GROUPS: Record<SettingTab, readonly string[]> = {
 		"Developer",
 	],
 	tasks: ["Modes", "Subagents", "Isolation", "Commands & Skills"],
-	providers: ["Services", "Fireworks", "Tiny Model", "Protocol", "Privacy"],
+	providers: ["Services", "Fireworks", "Tiny Model", "Protocol", "Timeouts", "Privacy"],
 };
 
 /** Status line segment identifiers */
@@ -4554,6 +4554,44 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	"providers.streamFirstEventTimeoutSeconds": {
+		type: "number",
+		default: -1,
+		ui: {
+			tab: "providers",
+			group: "Timeouts",
+			label: "Stream First Event Timeout",
+			description:
+				"Seconds to wait for the first model stream event; -1 uses provider/env defaults, 0 disables the watchdog",
+			options: [
+				{ value: "-1", label: "Auto", description: "Use provider defaults and PI_* timeout env vars" },
+				{ value: "0", label: "Off", description: "Disable first-event timeout" },
+				{ value: "300", label: "5 minutes" },
+				{ value: "600", label: "10 minutes" },
+				{ value: "1800", label: "30 minutes" },
+			],
+		},
+	},
+
+	"providers.streamIdleTimeoutSeconds": {
+		type: "number",
+		default: -1,
+		ui: {
+			tab: "providers",
+			group: "Timeouts",
+			label: "Stream Idle Timeout",
+			description:
+				"Seconds a model stream may stay silent between events; -1 uses provider/env defaults, 0 disables the watchdog",
+			options: [
+				{ value: "-1", label: "Auto", description: "Use provider defaults and PI_* timeout env vars" },
+				{ value: "0", label: "Off", description: "Disable idle timeout" },
+				{ value: "300", label: "5 minutes" },
+				{ value: "600", label: "10 minutes" },
+				{ value: "1800", label: "30 minutes" },
+			],
+		},
+	},
+
 	"providers.openrouterVariant": {
 		type: "enum",
 		values: ["default", "nitro", "floor", "online", "exacto"] as const,

package/src/discovery/builtin-rules/go-add-cleanup.md

@@ -0,0 +1,32 @@
+---
+description: "Prefer runtime.AddCleanup over runtime.SetFinalizer for new code (Go 1.24)"
+condition: 'runtime\.SetFinalizer'
+scope: "tool:edit(*.go), tool:write(*.go)"
+---
+
+Go 1.24 added `runtime.AddCleanup`, a finalization mechanism that is more flexible and less error-prone than `runtime.SetFinalizer`. The release notes state plainly: **new code should prefer `AddCleanup` over `SetFinalizer`.**
+
+## Why AddCleanup wins
+
+- Multiple cleanups may attach to one object; `SetFinalizer` allows only one.
+- Cleanups may attach to interior pointers.
+- Objects that form a reference cycle still get cleaned up — finalizers leak them.
+- A cleanup does not resurrect its object or delay freeing it (and what it points to) by an extra GC cycle.
+
+## Migration
+
+```go
+// Before
+runtime.SetFinalizer(obj, func(o *T) { o.release() })
+
+// After — the cleanup func receives a value you supply, NOT the object,
+// so it cannot accidentally keep the object alive.
+runtime.AddCleanup(obj, func(h handle) { h.release() }, obj.handle)
+```
+
+The cleanup argument must not reference `obj` itself (that would keep it reachable forever). Capture only the data the cleanup needs — a file descriptor, handle, or pointer that is independent of `obj`.
+
+## Keep SetFinalizer only when
+
+- The module targets a Go release older than 1.24.
+- You depend on finalizer-specific behavior (e.g. object resurrection) that `AddCleanup` deliberately does not provide.

package/src/discovery/builtin-rules/go-bench-loop.md

@@ -0,0 +1,36 @@
+---
+description: "Use for b.Loop() in benchmarks instead of the for i := 0; i < b.N; i++ loop (Go 1.24)"
+interruptMode: never
+scope: "tool:edit(*_test.go), tool:write(*_test.go)"
+astCondition:
+  - "func $F($B *testing.B) { $$$PRE for $I := 0; $I < $B.N; $I++ { $$$BODY } $$$POST }"
+---
+
+Go 1.24 added `testing.B.Loop`. Write `for b.Loop() { ... }` instead of looping over `b.N`.
+
+## Why
+
+- Setup and teardown outside the loop run exactly once per `-count`, not once per `b.N` re-estimation, so expensive fixtures are no longer timed or repeated.
+- The compiler keeps the loop's parameters and results alive, so it can't optimize away the body you are trying to measure — a classic `b.N` benchmarking footgun.
+
+## Avoid
+
+```go
+func BenchmarkEncode(b *testing.B) {
+	for i := 0; i < b.N; i++ {
+		Encode(input)
+	}
+}
+```
+
+## Use
+
+```go
+func BenchmarkEncode(b *testing.B) {
+	for b.Loop() {
+		Encode(input)
+	}
+}
+```
+
+Requires Go 1.24+. If the module targets an older Go, keep the `b.N` loop.

package/src/discovery/builtin-rules/go-exp-promoted.md

@@ -0,0 +1,39 @@
+---
+description: "Use the standard library slices and maps packages instead of golang.org/x/exp/{slices,maps}"
+condition:
+  - '"golang.org/x/exp/slices"'
+  - '"golang.org/x/exp/maps"'
+scope: "tool:edit(*.go), tool:write(*.go)"
+---
+
+`golang.org/x/exp/slices` and `golang.org/x/exp/maps` were promoted into the standard library as `slices` and `maps` in Go 1.21. Import the stdlib packages in new code instead of the experimental ones.
+
+## Migration
+
+```go
+// Before
+import (
+	"golang.org/x/exp/slices"
+	"golang.org/x/exp/maps"
+)
+
+// After
+import (
+	"slices"
+	"maps"
+)
+```
+
+Most call sites are unchanged: `slices.Sort`, `slices.Contains`, `slices.Index`, `slices.Equal`, `maps.Clone`, etc.
+
+## Watch the signature differences
+
+The promoted APIs were tweaked, so a blind path swap can break the build:
+
+- `x/exp/maps.Keys(m)` / `Values(m)` returned a slice; the stdlib `maps.Keys(m)` / `maps.Values(m)` return an **iterator** (`iter.Seq`). Use `slices.Collect(maps.Keys(m))` to recover a slice, or range over the iterator.
+- `slices.SortFunc` takes a comparison returning `int` (cmp-style), matching the stdlib signature.
+
+## Keep x/exp when
+
+- The module's `go` directive is below 1.21 (stdlib `slices`/`maps` don't exist yet).
+- You need an `x/exp` helper that was not promoted (e.g. parts of `x/exp/constraints` still live outside the stdlib).

package/src/discovery/builtin-rules/go-ioutil.md

@@ -0,0 +1,36 @@
+---
+description: "Use io and os instead of the deprecated io/ioutil package"
+condition: '"io/ioutil"'
+scope: "tool:edit(*.go), tool:write(*.go)"
+---
+
+`io/ioutil` has been deprecated since Go 1.16. Every function moved to `io` or `os` with the same behavior. Do not import it in new code.
+
+## Mapping
+
+| io/ioutil | Replacement |
+| --- | --- |
+| `ioutil.ReadAll` | `io.ReadAll` |
+| `ioutil.ReadFile` | `os.ReadFile` |
+| `ioutil.WriteFile` | `os.WriteFile` |
+| `ioutil.ReadDir` | `os.ReadDir` (returns `[]os.DirEntry`, not `[]os.FileInfo`) |
+| `ioutil.TempFile` | `os.CreateTemp` |
+| `ioutil.TempDir` | `os.MkdirTemp` |
+| `ioutil.NopCloser` | `io.NopCloser` |
+| `ioutil.Discard` | `io.Discard` |
+
+## Migration
+
+```go
+// Before
+import "io/ioutil"
+data, err := ioutil.ReadFile(path)
+_ = ioutil.WriteFile(out, data, 0o644)
+
+// After
+import "os"
+data, err := os.ReadFile(path)
+_ = os.WriteFile(out, data, 0o644)
+```
+
+`os.ReadDir` returns `[]os.DirEntry` rather than `[]os.FileInfo` — call `entry.Info()` if you need the old `FileInfo`. Everything else is a drop-in rename.

package/src/discovery/builtin-rules/go-join-hostport.md

@@ -0,0 +1,29 @@
+---
+description: "Build network addresses with net.JoinHostPort, not fmt.Sprintf(\"%s:%d\", host, port) — the Sprintf form breaks on IPv6"
+condition: 'fmt\.Sprintf\("%s:%d"'
+scope: "tool:edit(*.go), tool:write(*.go)"
+---
+
+Use `net.JoinHostPort(host, port)` to assemble a `host:port` address. `fmt.Sprintf("%s:%d", host, port)` produces invalid addresses for IPv6 hosts, which must be bracketed (`[::1]:80`). Go 1.25's `go vet` `hostport` analyzer flags exactly this pattern.
+
+## Why
+
+- An IPv6 literal like `::1` has its own colons, so `fmt.Sprintf("%s:%d", "::1", 80)` yields `::1:80` — unparseable by `net.Dial`.
+- `net.JoinHostPort` adds the brackets when the host contains a colon and leaves IPv4/hostnames untouched.
+
+## Avoid
+
+```go
+addr := fmt.Sprintf("%s:%d", host, port)
+conn, err := net.Dial("tcp", addr)
+```
+
+## Use
+
+```go
+// port is a string here; convert an int with strconv.Itoa.
+addr := net.JoinHostPort(host, strconv.Itoa(port))
+conn, err := net.Dial("tcp", addr)
+```
+
+`net.JoinHostPort` takes the port as a string. For an `int` port, wrap it in `strconv.Itoa`. The function is available in every supported Go version.

package/src/discovery/builtin-rules/go-new-expr.md

@@ -0,0 +1,44 @@
+---
+description: "Use new(expr) for pointer-to-value helpers instead of `func ptr[T any](v T) *T { return &v }` (Go 1.26)"
+interruptMode: never
+scope: "tool:edit(*.go), tool:write(*.go)"
+astCondition:
+  - "func $F($V $T) *$T { return &$V }"
+  - "func $F[$$$TP]($V $T) *$T { return &$V }"
+---
+
+Go 1.26 lets `new` take an expression: `new(expr)` allocates, stores `expr`, and returns its `*T`. That removes the need for hand-written `Ptr`/`boolPtr`/`Int64`-style helpers and the `x := v; p := &x` two-step.
+
+## Why
+
+- One builtin replaces a helper per type (`boolPtr`, `strPtr`, `int64Ptr`, …) and the generic `func Ptr[T any](v T) *T`.
+- No extra function-call frame and no separate heap escape — the value is constructed directly in the allocation.
+- The intent (`new(false)`) reads at the call site instead of hiding behind a helper name.
+
+## Avoid
+
+```go
+// A helper that just takes a value and returns its address.
+func boolPtr(v bool) *bool   { return &v }
+func strPtr(v string) *string { return &v }
+func Ptr[T any](v T) *T       { return &v }
+
+cfg := Config{Enabled: boolPtr(true), Name: strPtr("svc")}
+```
+
+## Use
+
+```go
+cfg := Config{Enabled: new(true), Name: new("svc")}
+
+// Was: x := int64(300); p := &x
+p := new(int64(300))
+```
+
+`new(true)` / `new(false)` give you `*bool`; `new(expr)` works for any expression, including function results (`new(time.Now())`).
+
+## Notes
+
+- Requires Go 1.26+. If the module's `go` directive is older, keep the helper or the temp-variable form until the toolchain is bumped.
+- This is for helpers that *only* take a value and return its address. A function that does real work before taking an address is not in scope.
+- `new(T)` (a bare type) is unchanged and still zero-initializes.

package/src/discovery/builtin-rules/go-rand-v2.md

@@ -0,0 +1,40 @@
+---
+description: Prefer math/rand/v2 over the legacy math/rand package
+condition: '"math/rand"'
+scope: "tool:edit(*.go), tool:write(*.go)"
+---
+
+Use `math/rand/v2` instead of the legacy `math/rand` package (stable since Go 1.22).
+
+## Why
+
+- No global `Seed`: `math/rand`'s top-level functions read a process-global generator (auto-seeded since Go 1.20), so a fixed seed is global mutable state that's easy to misuse; `v2` drops the global `Seed` entirely.
+- Cleaner, better-bounded API: `rand.IntN(n)` / generic `rand.N(n)` replace `rand.Intn(n)`, and `Shuffle`, `Perm`, `Float64` carry over with clearer names.
+- Modern generators: `v2` exposes `PCG` and `ChaCha8` sources instead of the old default LCG.
+
+## Migration
+
+```go
+// Before
+import "math/rand"
+n := rand.Intn(100)
+f := rand.Float64()
+
+// After
+import "math/rand/v2"
+n := rand.IntN(100)
+f := rand.Float64()
+```
+
+| math/rand | math/rand/v2 |
+| --- | --- |
+| `rand.Intn(n)` | `rand.IntN(n)` |
+| `rand.Int63n(n)` | `rand.Int64N(n)` |
+| `rand.Intn`/`Int31n` on a `*Rand` | `(*Rand).IntN` / `Int32N` |
+| `rand.Seed(x)` | drop it — `v2` has no global seed |
+| explicit `rand.New(rand.NewSource(seed))` | `rand.New(rand.NewPCG(s1, s2))` or `rand.NewChaCha8(seed)` |
+
+## Keep math/rand only when
+
+- You need a reproducible stream from a fixed seed via the classic `NewSource`/`Seed` API that a caller already depends on.
+- Reach for `crypto/rand` instead when the values are security-sensitive — neither `math/rand` variant is cryptographically secure.

package/src/discovery/builtin-rules/go-range-int.md

@@ -0,0 +1,45 @@
+---
+description: "Use for i := range n instead of the C-style for i := 0; i < n; i++ loop (Go 1.22)"
+interruptMode: never
+scope: "tool:edit(*.go), tool:write(*.go)"
+astCondition:
+  - "for $I := 0; $I < $N; $I++ { $$$BODY }"
+---
+
+Go 1.22 lets `for` range over an integer. A plain counting loop from `0` to `n` with step `1` reads better as `for i := range n` (or `for range n` when the index is unused).
+
+## Avoid
+
+```go
+for i := 0; i < n; i++ {
+	use(i)
+}
+
+for i := 0; i < len(s); i++ {
+	use(s[i])
+}
+```
+
+## Use
+
+```go
+for i := range n {
+	use(i)
+}
+
+// Ranging the slice directly is usually clearer than indexing.
+for i := range s {
+	use(s[i])
+}
+
+// Index unused → drop it entirely.
+for range n {
+	tick()
+}
+```
+
+## When it does not apply
+
+- Non-zero start, step other than `++`, or a descending loop (`for i := n - 1; i >= 0; i--`) — keep the explicit form.
+- The body reassigns the loop variable or depends on `i` surviving past the loop.
+- Requires Go 1.22+. If the module's `go` directive is older, keep the classic loop.

package/src/discovery/builtin-rules/index.ts

@@ -8,6 +8,14 @@
  * Registered by the lowest-priority `builtin-defaults` rule provider so any
  * user/project/tool rule with the same name overrides the bundled copy.
  */
+import goAddCleanup from "./go-add-cleanup.md" with { type: "text" };
+import goBenchLoop from "./go-bench-loop.md" with { type: "text" };
+import goExpPromoted from "./go-exp-promoted.md" with { type: "text" };
+import goIoutil from "./go-ioutil.md" with { type: "text" };
+import goJoinHostport from "./go-join-hostport.md" with { type: "text" };
+import goNewExpr from "./go-new-expr.md" with { type: "text" };
+import goRandV2 from "./go-rand-v2.md" with { type: "text" };
+import goRangeInt from "./go-range-int.md" with { type: "text" };
 import rsBoxLeak from "./rs-box-leak.md" with { type: "text" };
 import rsFuturePrelude from "./rs-future-prelude.md" with { type: "text" };
 import rsLazylock from "./rs-lazylock.md" with { type: "text" };
@@ -35,6 +43,14 @@ export interface BuiltinRuleSource {
 
 /** All bundled default rules, ordered by name. */
 export const BUILTIN_RULE_SOURCES: readonly BuiltinRuleSource[] = [
+	{ name: "go-add-cleanup", content: goAddCleanup },
+	{ name: "go-bench-loop", content: goBenchLoop },
+	{ name: "go-exp-promoted", content: goExpPromoted },
+	{ name: "go-ioutil", content: goIoutil },
+	{ name: "go-join-hostport", content: goJoinHostport },
+	{ name: "go-new-expr", content: goNewExpr },
+	{ name: "go-rand-v2", content: goRandV2 },
+	{ name: "go-range-int", content: goRangeInt },
 	{ name: "rs-box-leak", content: rsBoxLeak },
 	{ name: "rs-future-prelude", content: rsFuturePrelude },
 	{ name: "rs-lazylock", content: rsLazylock },

package/src/edit/hashline/filesystem.ts

@@ -28,6 +28,7 @@ import { invalidateFsScanAfterWrite } from "../../tools/fs-cache-invalidation";
 import { isInternalUrlPath } from "../../tools/path-utils";
 import { enforcePlanModeWrite, resolvePlanPath, targetsLocalSandbox } from "../../tools/plan-mode-guard";
 import { canonicalSnapshotKey } from "../file-snapshot-store";
+import { isNotebookPath } from "../notebook";
 import { readEditFileText, serializeEditFileText } from "../read-file";
 import type { LspBatchRequest } from "../renderer";
 
@@ -123,6 +124,17 @@ export class HashlineFilesystem extends Filesystem {
 		return content;
 	}
 
+	async readBinary(relativePath: string): Promise<Uint8Array | undefined> {
+		const absolutePath = this.resolveAbsolute(relativePath);
+		if (isNotebookPath(absolutePath)) return undefined;
+		try {
+			return await fs.readFile(absolutePath);
+		} catch (error) {
+			if (isEnoent(error)) throw new NotFoundError(relativePath, error);
+			throw error;
+		}
+	}
+
 	async preflightWrite(relativePath: string, options?: PreflightWriteOptions): Promise<void> {
 		const fileOp = options?.fileOp;
 		if (fileOp?.kind === "rem") {