johns-harness 2026.9.18 → 2026.9.19

package/README.md

@@ -62,6 +62,18 @@ The harness ships the current model catalog and the short aliases `opus`, `sonne
 ### Updating from chat
 Send `/update` to install the newest `johns-harness` on the machine the gateway runs on and restart into it; `/update 2026.9.14` pins an exact version. Owner only. The reply names the current and target versions, a second `/update` while one is running is refused, and the first message after the restart confirms the running version. On a writable host the package is reinstalled into the existing global prefix. On an immutable image with a persistent volume (Fly), it is installed into `$JOHNNESS_STATE_DIR/runtime/johnness` and the entrypoint prefers that runtime when it is newer than the image: `exec node "$(node /opt/johnness/lib/node_modules/johns-harness/dist/runtime-path.js)" gateway run`. `JOHNNESS_UPDATE_PREFIX` overrides the target. On failure the reply carries the last lines of npm output and the one command that fixes it.
 
+### Optional local engines
+
+The default install stays lean. Remote embeddings, hosted PDF understanding, chat, channels, tools, memory, and swarms do not need local embedding or PDF engines. Opt in when you use local extraction:
+
+```bash
+npm i -g node-llama-cpp   # local embeddings
+npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1  # local PDF text and images
+npm i -g koffi            # Windows enhanced terminal input only
+```
+
+Use the same npm prefix as `johns-harness` (add the same `--prefix /path` to those commands). Missing local engines return the install command, not a startup failure. `pdf-parse` is pinned to its callable v1 API used by memory uploads. Production dependency source maps are removed after install; set `JOHNNESS_KEEP_SOURCEMAPS=1` during installation to keep dependency maps for debugging. No `--omit=optional` or `--omit=peer` flag is needed for the slim default.
+
 ### From source
 
 ```bash
@@ -73,8 +85,8 @@ node johnness.mjs --help
 ### Verify
 
 ```bash
-npm test                        # 850 tests against the installed dependency tree
-bash scripts/verify-patches.sh  # 417 checks across every patch family
+npm test                        # 873 tests against the installed dependency tree
+bash scripts/verify-patches.sh  # 427 checks across every patch family
 ```
 
 ## Launch a swarm with one command
@@ -120,7 +132,7 @@ Coding agents today run as isolated processes. Two agents on the same repository
 - **Memory built for production.** Tiered recall that traces from consolidated reflections down to the verbatim record, surviving compaction and shared across the swarm. Installed and enabled by default.
 - **Production authority per commit.** Promotion is granted to an exact SHA, never to a branch name, so one worker's authorization never covers another worker's commits.
 - **An append-only action log.** Agents record every consequential action to `ACTION_LOG.md` and read it before acting.
-- **A fixed runtime surface.** The core does not grow on a schedule. New mechanisms enter only to solve a demonstrated production failure, one narrow, tested, reversible patch at a time: 64 patch families, each with a regression test and a rollback path.
+- **A fixed runtime surface.** The core does not grow on a schedule. New mechanisms enter only to solve a demonstrated production failure, one narrow, tested, reversible patch at a time: 66 patch families, each with a regression test and a rollback path.
 - **Reliability with a definition.** Bounded retries, explicit failure states, exact-once continuation, context-pressure recovery, durable delivery, and supervised gateway recovery.
 - **Coding first, phone optional.** Direct the work at a high level from a chat channel while agents plan, implement, test, coordinate, and stage releases unattended.
 - **Local voice.** Optional native Whisper transcription of inbound audio, entirely on your machine. Off by default. [Setup](docs/NATIVE-WHISPER-MUSE.md).
@@ -187,7 +199,7 @@ The log is a [`RULES.md`](RULES.md) workspace convention enforced through the ac
 
 ## Patch families
 
-The runtime carries 65 patch families plus the 65.1 safe-update amendment. Each is a production fix applied at the source with a regression test, a durable patch marker, and a rollback path. A verifier runs 417 checks against the package tree and installed dependencies, and 850 tests run against the installed dependency tree.
+The runtime carries 66 patch families plus the 65.1 safe-update amendment. Each is a production fix applied at the source with a regression test, a durable patch marker, and a rollback path. A verifier runs 427 checks against the package tree and installed dependencies, and 873 tests run against the installed dependency tree.
 
 Every family follows the same six steps: reproduce the failure, trace the exact runtime path, make the smallest source-level change that restores the invariant, add a regression test and a patch marker, run the verifier, and retain rollback artifacts. The full index: [`docs/PATCHES.md`](docs/PATCHES.md).
 
@@ -204,7 +216,7 @@ Every family follows the same six steps: reproduce the failure, trace the exact
 ## Documentation
 
 - [`docs/index.md`](docs/index.md): runtime docs, from gateway and channels to plugins, nodes, and CLI reference.
-- [`docs/PATCHES.md`](docs/PATCHES.md): the 64 patch families, one record each.
+- [`docs/PATCHES.md`](docs/PATCHES.md): the 66 patch families, one record each.
 - [`docs/NATIVE-WHISPER-MUSE.md`](docs/NATIVE-WHISPER-MUSE.md): local Whisper transcription setup.
 - [`RULES.md`](RULES.md): the default operating rules, including Rule Zero on production authorization.
 

package/dist/compact-B247y5Qt.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "./image-generate.js";
 import { handleUpdateCommand } from "./update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -24975,16 +24977,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/manager-4dxT-arP.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { g as resolveStateDir } from "./paths-BJV7vkaX.js";
 import { E as truncateUtf16Safe, a as clampNumber, i as clampInt, y as resolveUserPath } from "./utils-DC4zYvW0.js";
 import { a as resolveAgentDir, i as resolveAgentConfig, u as resolveAgentWorkspaceDir } from "./agent-scope-Cbp0nOOm.js";
@@ -713,7 +715,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -911,7 +913,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/manager-CKjxw95M.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-BXSUl5Nj.js";
 import { c as resolveStateDir } from "./paths-GBpjI3o0.js";
 import { E as truncateUtf16Safe, O as createSubsystemLogger, c as clampNumber, s as clampInt, y as resolveUserPath } from "./logger-Bj0Xl6pn.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/manager-DS9FBMMG.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-Cuc1THN9.js";
 import { c as resolveStateDir } from "./paths-hfkBoC7i.js";
 import { t as createSubsystemLogger } from "./subsystem-C-Cf_MFK.js";
@@ -708,7 +710,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -905,7 +907,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/manager-cNsoeXS5.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { g as resolveStateDir } from "./paths-BfR2LXbA.js";
 import { t as createSubsystemLogger } from "./subsystem-Cf9yS0UI.js";
 import { r as isTruthyEnvValue } from "./entry.js";
@@ -713,7 +715,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -911,7 +913,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/optional-module.js

@@ -0,0 +1,12 @@
+// JOHNNESS_PATCH_SLIM_TREE_66
+export const JOHNNESS_PATCH_SLIM_TREE_66 = true;
+export async function importOptional66(specifier, instruction, load = () => import(specifier)) {
+  try { return await load(); }
+  catch (cause) {
+    // Preserve native/initialization failures. Only a missing module gets setup guidance.
+    if (cause?.code !== 'ERR_MODULE_NOT_FOUND' && cause?.code !== 'MODULE_NOT_FOUND') throw cause;
+    const error = new Error(instruction, { cause });
+    error.code = cause.code;
+    throw error;
+  }
+}

package/dist/pi-embedded-C6ITuRXf.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "./image-generate.js";
 import { handleUpdateCommand } from "./update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -15260,16 +15262,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/pi-embedded-DoQsYfIY.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "./image-generate.js";
 import { handleUpdateCommand } from "./update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -15256,16 +15258,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/dispatch-BP0viZiL.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -3826,16 +3828,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/dispatch-CQsjmw7g.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -4068,16 +4070,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/dispatch-Cerq29sy.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -6150,16 +6152,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/dispatch-Cndjtt0g.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -4517,16 +4519,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/dispatch-UogiJYul.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -4132,16 +4134,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/plugin-sdk/manager--Ispw7m5.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-D4zr_gVN.js";
 import { Wr as isTruthyEnvValue, a as resolveEnvApiKey, br as retryAsync, i as resolveApiKeyForProvider, jr as normalizeResolvedSecretInputString, r as requireApiKey, zr as normalizeOptionalSecretInput } from "./model-auth-DVyo6JSX.js";
 import { E as truncateUtf16Safe, O as createSubsystemLogger, c as clampNumber, s as clampInt, y as resolveUserPath } from "./logger-By5InJr-.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/manager-BX2Te_uw.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { O as createSubsystemLogger, S as truncateUtf16Safe, h as resolveUserPath, i as clampNumber, r as clampInt } from "./utils-B0IyLNx9.js";
 import { c as resolveStateDir } from "./paths-Dmn791zP.js";
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-DskKz1MS.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/manager-BtQX5d7S.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-BMh-rgTO.js";
 import { c as resolveStateDir } from "./paths-eFexkPEh.js";
 import { Gr as normalizeOptionalSecretInput, Qr as normalizeResolvedSecretInputString, Xn as retryAsync, ar as resolveApiKeyForProvider, ir as requireApiKey, li as isTruthyEnvValue, or as resolveEnvApiKey } from "./config-4Fgm-yEH.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/manager-CIqGMwbi.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-XmKq-xNS.js";
 import { Ir as normalizeOptionalSecretInput, Or as normalizeResolvedSecretInputString, Vr as isTruthyEnvValue, a as resolveEnvApiKey, i as resolveApiKeyForProvider, r as requireApiKey, vr as retryAsync } from "./model-auth-Ciehz0x5.js";
 import { E as truncateUtf16Safe, O as createSubsystemLogger, c as clampNumber, s as clampInt, y as resolveUserPath } from "./logger-Cxu-Klb_.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/manager-DwQO_07E.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-DCb27DCP.js";
 import { c as resolveStateDir } from "./paths-B9fwHuf0.js";
 import { E as truncateUtf16Safe, O as createSubsystemLogger, c as clampNumber, s as clampInt, y as resolveUserPath } from "./logger-3VRkTvTU.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/manager-qIXfu7MM.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { a as resolveAgentDir, c as resolveAgentWorkspaceDir, i as resolveAgentConfig } from "./run-with-concurrency-8rEOAFIb.js";
 import { Kn as normalizeOptionalSecretInput, fn as requireApiKey, in as retryAsync, lr as normalizeResolvedSecretInputString, mn as resolveEnvApiKey, pn as resolveApiKeyForProvider, rr as isTruthyEnvValue } from "./config-Di-lyCdh.js";
 import { E as truncateUtf16Safe, O as createSubsystemLogger, c as clampNumber, s as clampInt, y as resolveUserPath } from "./logger-Blr-bUxJ.js";
@@ -707,7 +709,7 @@ async function resolveVoyageEmbeddingClient(options) {
 //#endregion
 //#region src/memory/node-llama.ts
 async function importNodeLlamaCpp() {
-	return import("node-llama-cpp");
+	return importOptional66("node-llama-cpp", "local embeddings require: npm i -g node-llama-cpp");
 }
 //#endregion
 //#region src/memory/embeddings.ts
@@ -904,7 +906,7 @@ function formatLocalSetupError(err) {
 		missing && detail ? `Detail: ${detail}` : null,
 		"To enable local embeddings:",
 		"1) Use Node 22 LTS (recommended for installs/updates)",
-		missing ? "2) Reinstall Johnness (this should install node-llama-cpp): npm i -g johns-harness@latest" : null,
+		missing ? "2) local embeddings require: npm i -g node-llama-cpp" : null,
 		"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",
 		...REMOTE_EMBEDDING_PROVIDER_IDS.map((provider) => `Or set agents.defaults.memorySearch.provider = "${provider}" (remote).`)
 	].filter(Boolean).join("\n");

package/dist/plugin-sdk/reply-DbZnH8-h.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "../optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "../image-generate.js";
 import { handleUpdateCommand } from "../update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -959,16 +961,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }

package/dist/reply-C5LKjXcC.js

@@ -1,3 +1,5 @@
+import { importOptional66 } from "./optional-module.js";
+const JOHNNESS_PATCH_SLIM_TREE_66 = true;
 import { createImageGenerateTool } from "./image-generate.js";
 import { handleUpdateCommand } from "./update-command.js";
 // JOHNNESS_PATCH_DEVICE_LOGIN_60
@@ -787,16 +789,16 @@ async function applyLinkUnderstanding(params) {
 let canvasModulePromise = null;
 let pdfJsModulePromise = null;
 async function loadCanvasModule() {
-	if (!canvasModulePromise) canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+	if (!canvasModulePromise) canvasModulePromise = importOptional66("@napi-rs/canvas", "PDF image extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		canvasModulePromise = null;
-		throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+		throw err;
 	});
 	return canvasModulePromise;
 }
 async function loadPdfJsModule() {
-	if (!pdfJsModulePromise) pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+	if (!pdfJsModulePromise) pdfJsModulePromise = importOptional66("pdfjs-dist/legacy/build/pdf.mjs", "PDF extraction requires: npm i -g pdfjs-dist@5.5.207 @napi-rs/canvas@0.1.89 pdf-parse@1.1.1").catch((err) => {
 		pdfJsModulePromise = null;
-		throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+		throw err;
 	});
 	return pdfJsModulePromise;
 }