@sayknow-cli/coding-agent 0.5.6 → 0.5.9

package/CHANGELOG.md

@@ -2,7 +2,22 @@
 
 ## [Unreleased]
 
-## [0.5.6] - 2026-08-28
+## [0.5.9] - 2026-09-10
+
+### Fixed
+
+- Fixed published-install startup crash from the 0.5.8 PDF wasm embed. The asset was imported from `../../../../node_modules/mupdf/dist/mupdf-wasm.wasm`, which only exists in the monorepo checkout — after `bun install -g` / `skc update` the same relative path resolved outside the package and aborted before the TUI opened. The wasm is now vendored under `packages/coding-agent/vendor/mupdf/` and imported package-locally so source installs and compiled binaries both resolve it.
+
+## [0.5.7] - 2026-09-10
+
+### Added
+
+- Added opt-in `reasoningLanguage: english`. Model reasoning quality on technical work is generally better in English, but that previously meant answering in English too. With the setting on, the system prompt gains a `<reasoning-language>` block asking the agent to reason in English while keeping user-facing answers in the language the user used; correctness, safety, and communication requirements are explicitly unchanged. The default `off` adds nothing to the prompt.
+- Added opt-in `compaction.adaptive.*` settings — `enabled`, `baseThresholdPercent`, `aggression`, `turnWindow`, and `minThresholdPercent` — and wired a per-session call-rate tracker into the auto-compaction threshold decision. Adaptive mode is disabled by default and the existing fixed `compaction.thresholdTokens` / `compaction.thresholdPercent` precedence is preserved. `getGroup("compaction")` flattens dotted keys, so the nested options object is assembled explicitly at the decision site rather than inferred, and a completed compaction resets the tracker in exactly one place.
+
+### Fixed
+
+- Restored PDF conversion in standalone binaries (ported from upstream #5433). Compiled releases kept mupdf `--external`, but compiled-Bun module resolution cannot satisfy markit's bare `import("mupdf")`, and mupdf's Emscripten loader cannot find `mupdf-wasm.wasm` inside the bunfs — so every standalone PDF read fell back to raw bytes behind a generic "PDF support requires 'mupdf'" note while the real cause was discarded. mupdf is now bundled: the wasm is embedded via `with { type: "file" }` and routed to the loader through a `locateFile` hook seeded before the first mupdf import, markit-ai's bundler-hostile `require("mupdf")` image-render call is patched to a dynamic import (`patches/markit-ai@0.5.3.patch`), and conversion failures re-run the import so diagnostics carry the actual error. The fetch tool also accepts any non-empty markit conversion instead of discarding short documents (e.g. the 14-character W3C dummy.pdf) into a raw-bytes fallback.
 
 ## [0.5.4] - 2026-08-28
 

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

@@ -523,6 +523,25 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly reasoningLanguage: {
+        readonly type: "enum";
+        readonly values: readonly ["off", "english"];
+        readonly default: "off";
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly label: "Reasoning Language";
+            readonly description: "Reason through technical work in English while answering in your own language";
+            readonly options: readonly [{
+                readonly value: "off";
+                readonly label: "Off";
+                readonly description: "Do not add reasoning-language guidance";
+            }, {
+                readonly value: "english";
+                readonly label: "English";
+                readonly description: "Reason in English and answer in the language you used";
+            }];
+        };
+    };
     readonly colorBlindMode: {
         readonly type: "boolean";
         readonly default: false;
@@ -1958,6 +1977,51 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "compaction.adaptive.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Adaptive Compaction";
+            readonly description: "Adjust compaction frequency by context size and call rate";
+        };
+    };
+    readonly "compaction.adaptive.baseThresholdPercent": {
+        readonly type: "number";
+        readonly default: 85;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Adaptive Base Threshold %";
+            readonly description: "Base context percentage used when adaptive compaction is enabled";
+        };
+    };
+    readonly "compaction.adaptive.aggression": {
+        readonly type: "number";
+        readonly default: 0.15;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Adaptive Aggression";
+            readonly description: "How strongly call rate lowers the compaction threshold; use 0 to 1";
+        };
+    };
+    readonly "compaction.adaptive.turnWindow": {
+        readonly type: "number";
+        readonly default: 15;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Call-Rate Window";
+            readonly description: "Minutes of recent calls considered by adaptive compaction";
+        };
+    };
+    readonly "compaction.adaptive.minThresholdPercent": {
+        readonly type: "number";
+        readonly default: 50;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Adaptive Floor %";
+            readonly description: "Lowest context percentage adaptive compaction may lower the threshold to";
+        };
+    };
     readonly "compaction.handoffSaveToDisk": {
         readonly type: "boolean";
         readonly default: false;

package/dist/types/system-prompt.d.ts

@@ -83,6 +83,11 @@ export interface BuildSystemPromptOptions {
     alwaysApplyRules?: AlwaysApplyRule[];
     /** Whether secret obfuscation is active. When true, explains the redaction format in the prompt. */
     secretsEnabled?: boolean;
+    /**
+     * Reason through technical work in English while answering in the language the
+     * user used. Affects prompt guidance only. Default: "off".
+     */
+    reasoningLanguage?: "off" | "english";
     /** Pre-loaded workspace tree (skips discovery if provided). May be a Promise to allow early kick-off. */
     workspaceTree?: WorkspaceTree | Promise<WorkspaceTree>;
     /**

package/dist/types/utils/mupdf-wasm.d.ts

@@ -0,0 +1 @@
+export declare function ensureMupdfWasmResolution(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/coding-agent",
-	"version": "0.5.6",
+	"version": "0.5.9",
 	"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -54,12 +54,12 @@
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@sayknow-cli/stats": "0.5.6",
-		"@sayknow-cli/agent-core": "0.5.6",
-		"@sayknow-cli/ai": "0.5.6",
-		"@sayknow-cli/natives": "0.5.6",
-		"@sayknow-cli/tui": "0.5.6",
-		"@sayknow-cli/utils": "0.5.6",
+		"@sayknow-cli/stats": "0.5.9",
+		"@sayknow-cli/agent-core": "0.5.9",
+		"@sayknow-cli/ai": "0.5.9",
+		"@sayknow-cli/natives": "0.5.9",
+		"@sayknow-cli/tui": "0.5.9",
+		"@sayknow-cli/utils": "0.5.9",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/compile-args.ts

@@ -18,7 +18,14 @@ const compiledDefineFlags = ['process.env.PI_COMPILED="true"'];
 const releaseDefineFlags = [...compiledDefineFlags, 'process.env.SKC_BUILD_CHANNEL="release"'];
 const devDefineFlags = [...compiledDefineFlags, 'process.env.SKC_BUILD_CHANNEL="dev"'];
 
-export const compiledExternalPackages = ["mupdf"];
+// NOTE: mupdf must NOT be marked --external here. Compiled binaries cannot
+// resolve bare "mupdf" imports (and its Emscripten loader cannot find the
+// wasm asset inside the bunfs), which broke markit PDF conversion in every
+// standalone release (upstream #5433). mupdf is bundled instead: its wasm is
+// embedded via `with { type: "file" }` and routed to the loader through the
+// hook in packages/coding-agent/src/utils/mupdf-wasm.ts, and the bundled
+// `require("mupdf")` inside markit-ai is replaced by the patch in
+// patches/markit-ai@0.5.3.patch.
 
 export const releaseEntrypoints = [
 	"./packages/coding-agent/src/cli.ts",
@@ -57,8 +64,6 @@ export function buildReleaseCompileArgs(target: string, outfile: string): string
 		outfile,
 		target,
 		defines: releaseDefineFlags,
-
-		externals: compiledExternalPackages,
 	});
 }
 
@@ -68,7 +73,6 @@ export function buildDevCompileArgs(outfile = "dist/skc"): string[] {
 		entrypoints: devEntrypoints,
 		outfile,
 		defines: devDefineFlags,
-		externals: compiledExternalPackages,
 	});
 }
 

package/src/config/model-profiles.ts

@@ -149,25 +149,25 @@ export const BUILTIN_MODEL_PROFILES: readonly ModelProfileDefinition[] = [
 		architect: "anthropic/claude-fable-5:xhigh",
 	}),
 	profile("glm-eco", ["zai"], {
-		default: "zai/glm-5.2:low",
-		executor: "zai/glm-5.2:minimal",
-		planner: "zai/glm-5.2:low",
-		critic: "zai/glm-5.2:medium",
-		architect: "zai/glm-5.2:high",
+		default: "zai/glm-5.3:low",
+		executor: "zai/glm-5.3:minimal",
+		planner: "zai/glm-5.3:low",
+		critic: "zai/glm-5.3:medium",
+		architect: "zai/glm-5.3:high",
 	}),
 	profile("glm-medium", ["zai"], {
-		default: "zai/glm-5.2:medium",
-		executor: "zai/glm-5.2:low",
-		planner: "zai/glm-5.2:medium",
-		critic: "zai/glm-5.2:high",
-		architect: "zai/glm-5.2:xhigh",
+		default: "zai/glm-5.3:medium",
+		executor: "zai/glm-5.3:low",
+		planner: "zai/glm-5.3:medium",
+		critic: "zai/glm-5.3:high",
+		architect: "zai/glm-5.3:xhigh",
 	}),
 	profile("glm-pro", ["zai"], {
-		default: "zai/glm-5.2:xhigh",
-		executor: "zai/glm-5.2:medium",
-		planner: "zai/glm-5.2:high",
-		critic: "zai/glm-5.2:xhigh",
-		architect: "zai/glm-5.2:xhigh",
+		default: "zai/glm-5.3:xhigh",
+		executor: "zai/glm-5.3:medium",
+		planner: "zai/glm-5.3:high",
+		critic: "zai/glm-5.3:xhigh",
+		architect: "zai/glm-5.3:xhigh",
 	}),
 	profile("kimi-coding-plan-eco", ["kimi-code"], {
 		default: "kimi-code/k3:low",

package/src/config/settings-schema.ts

@@ -581,6 +581,25 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	reasoningLanguage: {
+		type: "enum",
+		values: ["off", "english"] as const,
+		default: "off",
+		ui: {
+			tab: "appearance",
+			label: "Reasoning Language",
+			description: "Reason through technical work in English while answering in your own language",
+			options: [
+				{ value: "off", label: "Off", description: "Do not add reasoning-language guidance" },
+				{
+					value: "english",
+					label: "English",
+					description: "Reason in English and answer in the language you used",
+				},
+			],
+		},
+	},
+
 	colorBlindMode: {
 		type: "boolean",
 		default: false,
@@ -1625,6 +1644,57 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	// Adaptive compaction. Opt-in; the fixed thresholds above keep precedence.
+	"compaction.adaptive.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "context",
+			label: "Adaptive Compaction",
+			description: "Adjust compaction frequency by context size and call rate",
+		},
+	},
+
+	"compaction.adaptive.baseThresholdPercent": {
+		type: "number",
+		default: 85,
+		ui: {
+			tab: "context",
+			label: "Adaptive Base Threshold %",
+			description: "Base context percentage used when adaptive compaction is enabled",
+		},
+	},
+
+	"compaction.adaptive.aggression": {
+		type: "number",
+		default: 0.15,
+		ui: {
+			tab: "context",
+			label: "Adaptive Aggression",
+			description: "How strongly call rate lowers the compaction threshold; use 0 to 1",
+		},
+	},
+
+	"compaction.adaptive.turnWindow": {
+		type: "number",
+		default: 15,
+		ui: {
+			tab: "context",
+			label: "Call-Rate Window",
+			description: "Minutes of recent calls considered by adaptive compaction",
+		},
+	},
+
+	"compaction.adaptive.minThresholdPercent": {
+		type: "number",
+		default: 50,
+		ui: {
+			tab: "context",
+			label: "Adaptive Floor %",
+			description: "Lowest context percentage adaptive compaction may lower the threshold to",
+		},
+	},
+
 	"compaction.handoffSaveToDisk": {
 		type: "boolean",
 		default: false,

package/src/prompts/system/system-prompt.md

@@ -42,6 +42,14 @@ Optimize for correctness first, maintainability second, and brevity third. Prefe
 - Do not defer actionable work. Underpromise and overdeliver: report only what is done or in progress, never announce remaining work instead of doing it.
 </communication>
 
+{{#if reasoningLanguageEnglish}}
+<reasoning-language>
+- Reason through development and technical problem-solving in English.
+- Keep user-facing answers in the language the user requested or used.
+- This changes reasoning language only; it does not relax correctness, safety, or communication requirements.
+</reasoning-language>
+{{/if}}
+
 <completion-contract>
 - Never present partial work as complete.
 - Never suppress tests or warnings to make code pass.

package/src/sdk/session.ts

@@ -2197,6 +2197,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 
 		const repeatToolDescriptions = settings.get("repeatToolDescriptions");
 		const eagerTasks = settings.get("task.eager");
+		const reasoningLanguage = settings.get("reasoningLanguage");
 		const intentTracingEnabled = resolveIntentTracingEnabled(
 			settings.get("tools.intentTracing"),
 			options.hasUI ?? false,
@@ -2257,6 +2258,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 				toolDiscoveryActive: effectiveDiscoveryMode === "all" || mcpDiscoveryEnabled,
 				eagerTasks,
 				secretsEnabled,
+				reasoningLanguage,
 				workspaceTree: workspaceTreePromise,
 				subagent: options.parentTaskPrefix !== undefined,
 			});

package/src/session/agent-session.ts

@@ -42,10 +42,13 @@ import {
 } from "@sayknow-cli/agent-core";
 import { normalizeMessagesForProvider } from "@sayknow-cli/agent-core/agent-loop";
 import {
+	type AdaptiveCompactionOptions,
+	AdaptiveCompactionTracker,
 	AUTO_HANDOFF_THRESHOLD_FOCUS,
 	CompactionCancelledError,
 	type CompactionPreparation,
 	type CompactionResult,
+	type CompactionSettings as CoreCompactionSettings,
 	calculateContextTokens,
 	calculatePromptTokens,
 	collectEntriesForBranchSummary,
@@ -10770,6 +10773,43 @@ export class AgentSession {
 		return 0;
 	}
 
+	/**
+	 * Call-rate tracker backing opt-in adaptive compaction. Always maintained so
+	 * enabling the setting mid-session has immediate, honest state; the recorded
+	 * rate only reaches a threshold decision while `compaction.adaptive.enabled`
+	 * is true.
+	 */
+	#adaptiveCompaction = new AdaptiveCompactionTracker();
+
+	#adaptiveCompactionOptions(): AdaptiveCompactionOptions {
+		return {
+			enabled: this.settings.get("compaction.adaptive.enabled"),
+			baseThresholdPercent: this.settings.get("compaction.adaptive.baseThresholdPercent"),
+			aggression: this.settings.get("compaction.adaptive.aggression"),
+			turnWindow: this.settings.get("compaction.adaptive.turnWindow"),
+			minThresholdPercent: this.settings.get("compaction.adaptive.minThresholdPercent"),
+		};
+	}
+
+	/**
+	 * Compaction settings for a threshold decision.
+	 *
+	 * `getGroup("compaction")` flattens `compaction.adaptive.*` into dotted keys,
+	 * so the nested options object is assembled explicitly here. The tracker
+	 * window follows the configured minutes so a settings change takes effect
+	 * without restarting the session.
+	 */
+	#compactionSettingsWithAdaptive(): CoreCompactionSettings {
+		const adaptive = this.#adaptiveCompactionOptions();
+		const windowMinutes = Number.isFinite(adaptive.turnWindow) ? Math.max(1, adaptive.turnWindow) : 15;
+		this.#adaptiveCompaction.setWindowMs(windowMinutes * 60_000);
+		return {
+			...this.settings.getGroup("compaction"),
+			adaptive,
+			adaptiveState: this.#adaptiveCompaction.decisionState(),
+		};
+	}
+
 	/**
 	 * Evidence-gated below-threshold maintenance pruning (Finding 13). Runs
 	 * #pruneToolOutputs ONCE, below the compaction threshold, only when it is
@@ -11436,13 +11476,15 @@ export class AgentSession {
 			}
 			return this.#scheduleOverflowRetryContinuation(generation);
 		}
-		const compactionSettings = this.settings.getGroup("compaction");
+		const compactionSettings = this.#compactionSettingsWithAdaptive();
 		if (!compactionSettings.enabled || compactionSettings.strategy === "off") return false;
 
 		// Case 2: Threshold - turn succeeded but context is getting large
 		// Skip if this was an error (non-overflow errors don't have usage data)
 		if (assistantMessage.stopReason === "error") return false;
 		let contextTokens = calculateContextTokens(assistantMessage.usage);
+		this.#adaptiveCompaction.recordCall(contextTokens);
+		compactionSettings.adaptiveState = this.#adaptiveCompaction.decisionState();
 		// Model maxTokens is a capability ceiling, not a per-turn reservation.
 		// Auto maintenance should track actual context fullness.
 		const autoCompactionOutputReserveTokens = 0;
@@ -12747,6 +12789,11 @@ export class AgentSession {
 
 	/**
 	 * Internal: Run auto-compaction with events.
+	 *
+	 * Wraps the run so a completed compaction resets the adaptive call-rate
+	 * tracker in exactly one place. The post-compaction context size is reported
+	 * as 0 because the next recorded call carries the real provider number; the
+	 * tracker only uses this value as a fallback for callers that pass none.
 	 */
 	async #runAutoCompaction(
 		reason: "overflow" | "threshold" | "idle",
@@ -12760,6 +12807,24 @@ export class AgentSession {
 			beforeTerminalOverflowNoop?: () => void;
 			suppressNextPostTurnMaintenanceAfterHandoff?: boolean;
 		},
+	): Promise<AutoCompactionTerminalStatus> {
+		const status = await this.#runAutoCompactionInner(reason, willRetry, deferred, options);
+		if (status.kind === "compacted") this.#adaptiveCompaction.recordCompact(0);
+		return status;
+	}
+
+	async #runAutoCompactionInner(
+		reason: "overflow" | "threshold" | "idle",
+		willRetry: boolean,
+		deferred = false,
+		options?: {
+			continueAfterMaintenance?: boolean;
+			deferHandoffMaintenance?: boolean;
+			force?: boolean;
+			signal?: AbortSignal;
+			beforeTerminalOverflowNoop?: () => void;
+			suppressNextPostTurnMaintenanceAfterHandoff?: boolean;
+		},
 	): Promise<AutoCompactionTerminalStatus> {
 		const compactionSettings = this.settings.getGroup("compaction");
 		// `force` is the non-disableable emergency floor (F6): it bypasses the user's

package/src/system-prompt.ts

@@ -375,6 +375,11 @@ export interface BuildSystemPromptOptions {
 	alwaysApplyRules?: AlwaysApplyRule[];
 	/** Whether secret obfuscation is active. When true, explains the redaction format in the prompt. */
 	secretsEnabled?: boolean;
+	/**
+	 * Reason through technical work in English while answering in the language the
+	 * user used. Affects prompt guidance only. Default: "off".
+	 */
+	reasoningLanguage?: "off" | "english";
 	/** Pre-loaded workspace tree (skips discovery if provided). May be a Promise to allow early kick-off. */
 	workspaceTree?: WorkspaceTree | Promise<WorkspaceTree>;
 	/**
@@ -439,6 +444,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 		toolDiscoveryActive = false,
 		eagerTasks = false,
 		secretsEnabled = false,
+		reasoningLanguage = "off",
 		workspaceTree: providedWorkspaceTree,
 		subagent = false,
 	} = options;
@@ -613,6 +619,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 		toolDiscoveryActive: toolDiscoveryActive && hasHiddenToolDiscoveryTool,
 		eagerTasks,
 		secretsEnabled,
+		reasoningLanguageEnglish: reasoningLanguage === "english",
 		subagent,
 	};
 	const rendered = prompt.render(resolvedCustomPrompt ? customSystemPromptTemplate : systemPromptTemplate, data);

package/src/tools/fetch.ts

@@ -751,7 +751,9 @@ async function renderUrl(
 				let convertedText: string | null = null;
 				const converted = await convertWithMarkit(binary.buffer, conversionExtension, timeout, signal);
 				if (converted.ok) {
-					if (converted.content.trim().length > 50) {
+					// See the non-empty conversion note near the document path
+					// below (upstream #5433): short conversions still beat raw fallback.
+					if (converted.content.trim().length > 0) {
 						notes.push("Converted with markit");
 						convertedText = converted.content;
 					} else {
@@ -859,7 +861,10 @@ async function renderUrl(
 			const ext = getExtensionHint(finalUrl, binary.contentDisposition) || extHint;
 			const converted = await convertWithMarkit(binary.buffer, ext, timeout, signal);
 			if (converted.ok) {
-				if (converted.content.trim().length > 50) {
+				// Any non-empty markit conversion is preferable to a raw-bytes
+				// fallback (upstream #5433): short documents like the W3C dummy.pdf
+				// ("Dummy PDF file", 14 chars) are legitimately converted text.
+				if (converted.content.trim().length > 0) {
 					notes.push("Converted with markit");
 					const output = finalizeOutput(converted.content);
 					return {

package/src/utils/markit.ts

@@ -1,6 +1,7 @@
 import { untilAborted } from "@sayknow-cli/utils";
 import type { Markit, StreamInfo } from "markit-ai";
 import { ToolAbortError } from "../tools/tool-errors";
+import { ensureMupdfWasmResolution } from "./mupdf-wasm";
 
 export interface MarkitConversionResult {
 	content: string;
@@ -18,6 +19,11 @@ let markit: () => Markit | Promise<Markit> = async () => {
 	return promise;
 };
 
+// Upstream #5433: mupdf's wasm asset is not reachable at the Emscripten
+// loader's default bunfs path in compiled binaries. Seed the embedded-asset
+// hook before any markit conversion (and therefore before any mupdf import).
+ensureMupdfWasmResolution();
+
 function normalizeExtension(extension: string): string {
 	const trimmed = extension.trim().toLowerCase();
 	if (!trimmed) return ".bin";
@@ -31,6 +37,22 @@ function normalizeError(error: unknown): string {
 	return "Conversion failed";
 }
 
+/**
+ * markit-ai's PDF converter swallows the real mupdf import failure behind a
+ * generic "Install it" message (upstream #5433). Re-run the import here so
+ * release diagnostics carry the actual module/asset/initialization error.
+ */
+async function describeConversionError(error: unknown): Promise<string> {
+	const base = normalizeError(error);
+	if (!base.includes("PDF support requires 'mupdf'")) return base;
+	try {
+		await import("mupdf");
+	} catch (cause) {
+		return `${base} (mupdf import failed: ${normalizeError(cause)})`;
+	}
+	return base;
+}
+
 async function runMarkitConversion<T>(task: (markit: Markit) => Promise<T>, signal?: AbortSignal): Promise<T> {
 	try {
 		const instance = await markit();
@@ -62,7 +84,7 @@ export async function convertFileWithMarkit(filePath: string, signal?: AbortSign
 		if (error instanceof ToolAbortError) {
 			throw error;
 		}
-		return { content: "", ok: false, error: normalizeError(error) };
+		return { content: "", ok: false, error: await describeConversionError(error) };
 	}
 }
 
@@ -84,6 +106,6 @@ export async function convertBufferWithMarkit(
 		if (error instanceof ToolAbortError) {
 			throw error;
 		}
-		return { content: "", ok: false, error: normalizeError(error) };
+		return { content: "", ok: false, error: await describeConversionError(error) };
 	}
 }

package/src/utils/mupdf-wasm.ts

@@ -0,0 +1,35 @@
+/**
+ * MuPDF wasm asset resolution inside compiled binaries (upstream #5433).
+ *
+ * `mupdf`'s Emscripten loader resolves `mupdf-wasm.wasm` relative to
+ * `import.meta.url` (or `scriptDirectory`). Inside a `bun build --compile`
+ * bunfs that path points at the bunfs root where the asset does not exist,
+ * so every mupdf import aborted with
+ * `ENOENT: ... /$bunfs/root/mupdf-wasm.wasm`.
+ *
+ * The wasm is embedded via `with { type: "file" }`, which lands it at a
+ * hashed bunfs path. MuPDF's top-level factory call reads
+ * `globalThis["$libmupdf_wasm_Module"]`, so seeding that config with a
+ * `locateFile` hook that returns the embedded asset path makes the loader
+ * read the wasm from the bunfs directly — no disk sidecar needed.
+ *
+ * The asset MUST live under this package (`vendor/mupdf/…`), not under the
+ * monorepo `node_modules/` tree. A `../../../../node_modules/mupdf/…` import
+ * resolves in a workspace checkout but breaks every published install
+ * (`bun install -g` / npm) where `@sayknow-cli/coding-agent` sits several
+ * directories deeper and mupdf is hoisted elsewhere — that was the 0.5.8
+ * startup crash. Refresh the vendored bytes from
+ * `node_modules/mupdf/dist/mupdf-wasm.wasm` whenever markit-ai's mupdf
+ * dependency moves.
+ *
+ * This must run before the first `import("mupdf")` anywhere in the process.
+ */
+import mupdfWasmPath from "../../vendor/mupdf/mupdf-wasm.wasm" with { type: "file" };
+
+const MODULE_CONFIG_KEY = "$libmupdf_wasm_Module";
+
+export function ensureMupdfWasmResolution(): void {
+	const globalScope = globalThis as typeof globalThis & Record<string, unknown>;
+	if (globalScope[MODULE_CONFIG_KEY] !== undefined) return;
+	globalScope[MODULE_CONFIG_KEY] = { locateFile: () => String(mupdfWasmPath) };
+}