acryl-cli-linux-x64 0.1.31 → 0.1.35

package/runtime/node_modules/@earendil-works/pi-ai/dist/auth/oauth/oauth-page.js

@@ -1,4 +1,4 @@
-const LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 800" aria-hidden="true"><path fill="#fff" fill-rule="evenodd" d="M165.29 165.29 H517.36 V400 H400 V517.36 H282.65 V634.72 H165.29 Z M282.65 282.65 V400 H400 V282.65 Z"/><path fill="#fff" d="M517.36 400 H634.72 V634.72 H517.36 Z"/></svg>`;
+const LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 800" aria-hidden="true"><g fill="#fff"><rect x="76.0" y="418.0" width="10.5" height="10.5"/><rect x="88.0" y="394.0" width="10.5" height="10.5"/><rect x="88.0" y="406.0" width="10.5" height="10.5"/><rect x="88.0" y="418.0" width="10.5" height="10.5"/><rect x="100.0" y="382.0" width="10.5" height="10.5"/><rect x="100.0" y="394.0" width="10.5" height="10.5"/><rect x="112.0" y="370.0" width="10.5" height="10.5"/><rect x="112.0" y="382.0" width="10.5" height="10.5"/><rect x="124.0" y="358.0" width="10.5" height="10.5"/><rect x="124.0" y="370.0" width="10.5" height="10.5"/><rect x="136.0" y="346.0" width="10.5" height="10.5"/><rect x="136.0" y="358.0" width="10.5" height="10.5"/><rect x="148.0" y="334.0" width="10.5" height="10.5"/><rect x="148.0" y="346.0" width="10.5" height="10.5"/><rect x="160.0" y="334.0" width="10.5" height="10.5"/><rect x="160.0" y="346.0" width="10.5" height="10.5"/><rect x="160.0" y="358.0" width="10.5" height="10.5"/><rect x="172.0" y="358.0" width="10.5" height="10.5"/><rect x="184.0" y="370.0" width="10.5" height="10.5"/><rect x="196.0" y="370.0" width="10.5" height="10.5"/><rect x="196.0" y="382.0" width="10.5" height="10.5"/><rect x="196.0" y="394.0" width="10.5" height="10.5"/><rect x="208.0" y="370.0" width="10.5" height="10.5"/><rect x="208.0" y="406.0" width="10.5" height="10.5"/><rect x="220.0" y="370.0" width="10.5" height="10.5"/><rect x="220.0" y="418.0" width="10.5" height="10.5"/><rect x="232.0" y="370.0" width="10.5" height="10.5"/><rect x="244.0" y="370.0" width="10.5" height="10.5"/><rect x="256.0" y="358.0" width="10.5" height="10.5"/><rect x="256.0" y="370.0" width="10.5" height="10.5"/><rect x="256.0" y="382.0" width="10.5" height="10.5"/><rect x="268.0" y="346.0" width="10.5" height="10.5"/><rect x="268.0" y="382.0" width="10.5" height="10.5"/><rect x="268.0" y="394.0" width="10.5" height="10.5"/><rect x="280.0" y="334.0" width="10.5" height="10.5"/><rect x="280.0" y="394.0" width="10.5" height="10.5"/><rect x="280.0" y="406.0" width="10.5" height="10.5"/><rect x="280.0" y="418.0" width="10.5" height="10.5"/><rect x="292.0" y="310.0" width="10.5" height="10.5"/><rect x="292.0" y="418.0" width="10.5" height="10.5"/><rect x="292.0" y="430.0" width="10.5" height="10.5"/><rect x="304.0" y="298.0" width="10.5" height="10.5"/><rect x="304.0" y="430.0" width="10.5" height="10.5"/><rect x="304.0" y="442.0" width="10.5" height="10.5"/><rect x="316.0" y="286.0" width="10.5" height="10.5"/><rect x="316.0" y="442.0" width="10.5" height="10.5"/><rect x="328.0" y="274.0" width="10.5" height="10.5"/><rect x="328.0" y="442.0" width="10.5" height="10.5"/><rect x="340.0" y="274.0" width="10.5" height="10.5"/><rect x="340.0" y="442.0" width="10.5" height="10.5"/><rect x="352.0" y="274.0" width="10.5" height="10.5"/><rect x="352.0" y="310.0" width="10.5" height="10.5"/><rect x="352.0" y="442.0" width="10.5" height="10.5"/><rect x="364.0" y="274.0" width="10.5" height="10.5"/><rect x="364.0" y="310.0" width="10.5" height="10.5"/><rect x="364.0" y="442.0" width="10.5" height="10.5"/><rect x="376.0" y="274.0" width="10.5" height="10.5"/><rect x="376.0" y="310.0" width="10.5" height="10.5"/><rect x="376.0" y="442.0" width="10.5" height="10.5"/><rect x="388.0" y="274.0" width="10.5" height="10.5"/><rect x="388.0" y="310.0" width="10.5" height="10.5"/><rect x="388.0" y="358.0" width="10.5" height="10.5"/><rect x="388.0" y="442.0" width="10.5" height="10.5"/><rect x="400.0" y="274.0" width="10.5" height="10.5"/><rect x="400.0" y="310.0" width="10.5" height="10.5"/><rect x="400.0" y="358.0" width="10.5" height="10.5"/><rect x="400.0" y="370.0" width="10.5" height="10.5"/><rect x="400.0" y="442.0" width="10.5" height="10.5"/><rect x="412.0" y="274.0" width="10.5" height="10.5"/><rect x="412.0" y="310.0" width="10.5" height="10.5"/><rect x="412.0" y="358.0" width="10.5" height="10.5"/><rect x="412.0" y="382.0" width="10.5" height="10.5"/><rect x="412.0" y="394.0" width="10.5" height="10.5"/><rect x="412.0" y="442.0" width="10.5" height="10.5"/><rect x="424.0" y="310.0" width="10.5" height="10.5"/><rect x="424.0" y="358.0" width="10.5" height="10.5"/><rect x="424.0" y="406.0" width="10.5" height="10.5"/><rect x="424.0" y="442.0" width="10.5" height="10.5"/><rect x="436.0" y="310.0" width="10.5" height="10.5"/><rect x="436.0" y="358.0" width="10.5" height="10.5"/><rect x="436.0" y="406.0" width="10.5" height="10.5"/><rect x="448.0" y="310.0" width="10.5" height="10.5"/><rect x="448.0" y="322.0" width="10.5" height="10.5"/><rect x="448.0" y="346.0" width="10.5" height="10.5"/><rect x="448.0" y="358.0" width="10.5" height="10.5"/><rect x="448.0" y="430.0" width="10.5" height="10.5"/><rect x="460.0" y="334.0" width="10.5" height="10.5"/><rect x="460.0" y="442.0" width="10.5" height="10.5"/><rect x="472.0" y="442.0" width="10.5" height="10.5"/><rect x="484.0" y="454.0" width="10.5" height="10.5"/><rect x="484.0" y="466.0" width="10.5" height="10.5"/><rect x="496.0" y="478.0" width="10.5" height="10.5"/><rect x="508.0" y="478.0" width="10.5" height="10.5"/><rect x="508.0" y="490.0" width="10.5" height="10.5"/><rect x="508.0" y="502.0" width="10.5" height="10.5"/><rect x="508.0" y="514.0" width="10.5" height="10.5"/><rect x="520.0" y="478.0" width="10.5" height="10.5"/><rect x="532.0" y="454.0" width="10.5" height="10.5"/><rect x="532.0" y="466.0" width="10.5" height="10.5"/><rect x="544.0" y="442.0" width="10.5" height="10.5"/><rect x="556.0" y="442.0" width="10.5" height="10.5"/><rect x="568.0" y="430.0" width="10.5" height="10.5"/><rect x="580.0" y="418.0" width="10.5" height="10.5"/><rect x="580.0" y="430.0" width="10.5" height="10.5"/><rect x="592.0" y="406.0" width="10.5" height="10.5"/><rect x="592.0" y="418.0" width="10.5" height="10.5"/><rect x="592.0" y="430.0" width="10.5" height="10.5"/><rect x="604.0" y="394.0" width="10.5" height="10.5"/><rect x="604.0" y="406.0" width="10.5" height="10.5"/><rect x="604.0" y="430.0" width="10.5" height="10.5"/><rect x="616.0" y="382.0" width="10.5" height="10.5"/><rect x="616.0" y="430.0" width="10.5" height="10.5"/><rect x="628.0" y="370.0" width="10.5" height="10.5"/><rect x="628.0" y="430.0" width="10.5" height="10.5"/><rect x="640.0" y="430.0" width="10.5" height="10.5"/><rect x="652.0" y="430.0" width="10.5" height="10.5"/><rect x="664.0" y="430.0" width="10.5" height="10.5"/><rect x="676.0" y="430.0" width="10.5" height="10.5"/><rect x="688.0" y="430.0" width="10.5" height="10.5"/><rect x="700.0" y="430.0" width="10.5" height="10.5"/><rect x="712.0" y="430.0" width="10.5" height="10.5"/></g></svg>`;
 function escapeHtml(value) {
     return value
         .replaceAll("&", "&amp;")

package/runtime/node_modules/acryl-control/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acryl-control",
-  "version": "0.1.31",
+  "version": "0.1.35",
   "private": false,
   "description": "Host-neutral Cordis control plane for ACRYL",
   "license": "MIT",

package/runtime/node_modules/acryl-harness-runtime/lib/index.mjs

@@ -1,9 +1,12 @@
 import { createRequire } from "node:module";
-import { existsSync, writeFileSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { SessionId } from "@deepseek-ai/dsh-session";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
+import { homedir } from "node:os";
 import { provideCmdline } from "@deepseek-ai/dsh-cmdline";
 import { DEFAULT_PROFILE_BUNDLES, boot, composeEntries, healProfilesModuleFallback, initProfile, loadProfile, resolveProfileDir } from "@deepseek-ai/dsh-app-boot";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -114,6 +117,8 @@ function status(agent) {
 */
 function createAcrylSessionBridge(ctx, options) {
 	const handles = /* @__PURE__ */ new Map();
+	const modelSelections = /* @__PURE__ */ new Map();
+	const modelSelectionDisposers = /* @__PURE__ */ new Map();
 	const subscribers = /* @__PURE__ */ new Map();
 	const eventListeners = /* @__PURE__ */ new Map();
 	let disposed = false;
@@ -175,6 +180,12 @@ function createAcrylSessionBridge(ctx, options) {
 				}
 			});
 			handles.set(handle.agent.id, handle);
+			const ref = {
+				current: void 0,
+				assembled: void 0
+			};
+			modelSelectionDisposers.set(handle.agent.id, installModelSelection(handle.agent.ctx, ref));
+			modelSelections.set(handle.agent.id, ref);
 			return handle.agent.id;
 		},
 		snapshot,
@@ -234,6 +245,15 @@ function createAcrylSessionBridge(ctx, options) {
 			}));
 			await accepted;
 		},
+		async selectModel(input) {
+			agentFor(input.sessionId);
+			const ref = modelSelections.get(input.sessionId);
+			if (ref === void 0) throw new Error(`ACRYL session ${input.sessionId} has no installed model selection`);
+			ref.current = {
+				provider: input.provider,
+				model: input.model
+			};
+		},
 		async cancel(sessionId) {
 			agentFor(sessionId).cancel({ kind: "user" });
 		},
@@ -243,6 +263,9 @@ function createAcrylSessionBridge(ctx, options) {
 			offSessionEvent();
 			subscribers.clear();
 			eventListeners.clear();
+			for (const dispose of modelSelectionDisposers.values()) dispose();
+			modelSelectionDisposers.clear();
+			modelSelections.clear();
 			const activeHandles = [...handles.values()];
 			handles.clear();
 			const sessions = ctx.get("sessions");
@@ -259,6 +282,106 @@ function createAcrylSessionBridge(ctx, options) {
 	});
 }
 //#endregion
+//#region src/session-log-exporter.ts
+/**
+* A durable, cross-surface debug log for ACRYL sessions.
+*
+* Cordis's own `ctx.logger` already carries every structured log record any
+* plugin emits, but nothing in this stack persisted it anywhere — a failure
+* like a vendored provider's OAuth error only ever reached the terminal
+* transcript, gone the moment the pane scrolled or the process exited. This
+* registers one JSONL file exporter on `ctx.logger` per surface (CLI/TUI,
+* web, and — once wired there too — the desktop GUI), so `error`/`warn`
+* records (and everything, when `ACRYL_LOG_LEVEL=debug`) survive the session
+* and can be read back after the fact instead of re-derived from a
+* screenshot.
+*
+* @module acryl-harness-runtime/session-log-exporter
+*/
+const LOGGER_LEVEL_WARN = 2;
+const LOGGER_LEVEL_DEBUG = 3;
+/**
+* Register the file exporter for this process's lifetime. `ctx.logger.exporter()`
+* already ties its own disposal to the fiber that registers it (see
+* `LoggerService.exporter` in `@deepseek-ai/cordis`), so this needs no extra
+* `ctx.effect()` wrapper of its own.
+* @param ctx - the plugin context whose `ctx.logger` gains the exporter.
+* @param options - which surface/home this log file belongs to.
+*/
+function installSessionLogExporter(ctx, options) {
+	const logDir = join(resolveDshHome(options.dshHome), "logs");
+	try {
+		mkdirSync(logDir, {
+			recursive: true,
+			mode: 448
+		});
+	} catch {
+		return;
+	}
+	const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	const logFile = join(logDir, `acryl-${options.surface}-${day}.jsonl`);
+	const threshold = process.env.ACRYL_LOG_LEVEL === "debug" ? LOGGER_LEVEL_DEBUG : LOGGER_LEVEL_WARN;
+	ctx.logger.exporter({ export(message) {
+		if (message.level > threshold) return;
+		try {
+			appendFileSync(logFile, `${JSON.stringify({
+				ts: new Date(message.ts).toISOString(),
+				type: message.type,
+				name: message.name,
+				args: message.args.map((arg) => arg instanceof Error ? {
+					message: arg.message,
+					stack: arg.stack,
+					name: arg.name
+				} : arg)
+			})}\n`, { mode: 384 });
+		} catch {}
+	} });
+}
+//#endregion
+//#region src/acryl-home.ts
+/**
+* ACRYL's own data root, nested one level above the DSH engine home it
+* composes.
+*
+* The stock DSH Desktop app (from dshdesktop.com) uses plain `~/.dsh`, and so
+* did every ACRYL surface until now — sharing that root made the two
+* genuinely different products silently share credentials/settings/sessions,
+* which is both confusing and useless for comparing ACRYL against a stock
+* DSH Desktop install side by side. ACRYL now owns `~/.acryl` and nests each
+* engine's artifacts under it by engine name:
+*
+* ```txt
+* ~/.acryl/            ACRYL's own root — everything not engine-specific
+* ~/.acryl/.dsh/        the DSH engine home (what DSH_HOME resolves to)
+* ~/.acryl/.pi/         reserved for a future pi.dev engine
+* ```
+*
+* `$DSH_HOME`, if a caller has already set it explicitly, still wins — this
+* only changes the *default* the harness's own `resolveDshHome()` falls
+* back to when nothing overrides it.
+*
+* @module acryl-harness-runtime/acryl-home
+*/
+/** ACRYL's own root directory name under the OS home. */
+const ACRYL_HOME_DIR_NAME = ".acryl";
+/** The DSH engine's directory name, nested under ACRYL's root. */
+const ACRYL_DSH_ENGINE_DIR_NAME = ".dsh";
+/** ACRYL's own root — `~/.acryl` unless `$ACRYL_HOME` overrides it. */
+function resolveAcrylHome(env = process.env) {
+	const overridden = env.ACRYL_HOME?.trim();
+	return overridden && overridden !== "" ? overridden : join(homedir(), ACRYL_HOME_DIR_NAME);
+}
+/**
+* The DSH engine home ACRYL boots against: `$DSH_HOME` if a caller already
+* set it (highest precedence, same as `resolveDshHome()` itself), otherwise
+* `<acrylHome>/.dsh` instead of the harness's own bare `~/.dsh` default.
+*/
+function resolveAcrylDshHome(env = process.env) {
+	const overridden = env.DSH_HOME?.trim();
+	if (overridden && overridden !== "") return resolveDshHome(void 0, env);
+	return resolveDshHome(join(resolveAcrylHome(env), ACRYL_DSH_ENGINE_DIR_NAME), env);
+}
+//#endregion
 //#region src/plugin-acryl-workspace-status.ts
 /** Canonical tool name exposed to the model. */
 const TOOL_NAME = "acryl_workspace_status";
@@ -330,6 +453,7 @@ const profileRoot = "[]\n";
 /** Boot one normal pinned-Harness ACRYL profile in a single Cordis root. */
 async function bootAcrylHarnessProfile(options) {
 	if (options.profile.trim() === "") throw new Error("ACRYL Harness profile must not be empty");
+	process.env.DSH_HOME = resolveAcrylDshHome();
 	initProfile(resolveProfileDir(options.profile), DEFAULT_PROFILE_BUNDLES);
 	healProfilesModuleFallback(dshInstallAnchor);
 	const profile = loadProfile("acryl", options.profile, dshInstallAnchor);
@@ -343,6 +467,7 @@ async function bootAcrylHarnessProfile(options) {
 	if (composeEntries([patches]).find((entry) => entry.id === "hmr")?.disabled !== true && !process.execArgv.includes("--expose-internals")) throw new Error("ACRYL profile enables Cordis HMR and must be launched with Node --expose-internals");
 	const ctx = await boot("acryl", rootConfig, patches, options.prepare);
 	if (ctx.tools) installAcrylWorkspaceStatusTool(ctx);
+	installSessionLogExporter(ctx, { surface: "tui" });
 	let disposed = false;
 	return Object.freeze({
 		ctx,
@@ -363,6 +488,7 @@ async function bootAcrylHarnessProfile(options) {
 */
 async function bootAcrylWebProfile(options = {}) {
 	const profileName = "web";
+	process.env.DSH_HOME = resolveAcrylDshHome();
 	initProfile(resolveProfileDir(profileName), DEFAULT_PROFILE_BUNDLES);
 	healProfilesModuleFallback(dshInstallAnchor);
 	const profile = loadProfile("web", profileName, dshInstallAnchor);
@@ -384,6 +510,7 @@ async function bootAcrylWebProfile(options = {}) {
 		return options.prepare?.(hostCtx);
 	});
 	if (ctx.tools) installAcrylWorkspaceStatusTool(ctx);
+	installSessionLogExporter(ctx, { surface: "web" });
 	const startup = ctx.get("webStartup");
 	const url = `http://${startup?.host ?? "127.0.0.1"}:${startup?.port ?? 3080}`;
 	let disposed = false;
@@ -399,6 +526,6 @@ async function bootAcrylWebProfile(options = {}) {
 	});
 }
 //#endregion
-export { ACRYL_CODING_CAPABILITIES, bootAcrylHarnessProfile, bootAcrylWebProfile, createAcrylCodingCapabilityPatches, createAcrylSessionBridge };
+export { ACRYL_CODING_CAPABILITIES, ACRYL_DSH_ENGINE_DIR_NAME, ACRYL_HOME_DIR_NAME, bootAcrylHarnessProfile, bootAcrylWebProfile, createAcrylCodingCapabilityPatches, createAcrylSessionBridge, installSessionLogExporter, resolveAcrylDshHome, resolveAcrylHome };
 
 //# sourceMappingURL=index.mjs.map

package/runtime/node_modules/acryl-harness-runtime/lib/types/acryl-home.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ACRYL's own data root, nested one level above the DSH engine home it
+ * composes.
+ *
+ * The stock DSH Desktop app (from dshdesktop.com) uses plain `~/.dsh`, and so
+ * did every ACRYL surface until now — sharing that root made the two
+ * genuinely different products silently share credentials/settings/sessions,
+ * which is both confusing and useless for comparing ACRYL against a stock
+ * DSH Desktop install side by side. ACRYL now owns `~/.acryl` and nests each
+ * engine's artifacts under it by engine name:
+ *
+ * ```txt
+ * ~/.acryl/            ACRYL's own root — everything not engine-specific
+ * ~/.acryl/.dsh/        the DSH engine home (what DSH_HOME resolves to)
+ * ~/.acryl/.pi/         reserved for a future pi.dev engine
+ * ```
+ *
+ * `$DSH_HOME`, if a caller has already set it explicitly, still wins — this
+ * only changes the *default* the harness's own `resolveDshHome()` falls
+ * back to when nothing overrides it.
+ *
+ * @module acryl-harness-runtime/acryl-home
+ */
+/** ACRYL's own root directory name under the OS home. */
+export declare const ACRYL_HOME_DIR_NAME = ".acryl";
+/** The DSH engine's directory name, nested under ACRYL's root. */
+export declare const ACRYL_DSH_ENGINE_DIR_NAME = ".dsh";
+/** ACRYL's own root — `~/.acryl` unless `$ACRYL_HOME` overrides it. */
+export declare function resolveAcrylHome(env?: Record<string, string | undefined>): string;
+/**
+ * The DSH engine home ACRYL boots against: `$DSH_HOME` if a caller already
+ * set it (highest precedence, same as `resolveDshHome()` itself), otherwise
+ * `<acrylHome>/.dsh` instead of the harness's own bare `~/.dsh` default.
+ */
+export declare function resolveAcrylDshHome(env?: Record<string, string | undefined>): string;

package/runtime/node_modules/acryl-harness-runtime/lib/types/index.d.ts

@@ -1,6 +1,8 @@
 export { ACRYL_CODING_CAPABILITIES, createAcrylCodingCapabilityPatches, type AcrylCodingCapability, type AcrylSurface, } from './coding-capabilities.ts';
 export type { DurableSessionMessage, DurableSessionMessagePort, DurableSessionMessageReceipt, } from './durable-message.ts';
 export { createAcrylSessionBridge, type AcrylSessionBridge, type AcrylSessionBridgeOptions, } from './session-bridge.ts';
+export { installSessionLogExporter, type InstallSessionLogExporterOptions, } from './session-log-exporter.ts';
+export { ACRYL_DSH_ENGINE_DIR_NAME, ACRYL_HOME_DIR_NAME, resolveAcrylDshHome, resolveAcrylHome, } from './acryl-home.ts';
 import type { Context } from '@deepseek-ai/cordis';
 export interface BootAcrylHarnessProfileOptions {
     readonly profile: string;

package/runtime/node_modules/acryl-harness-runtime/lib/types/session-bridge.d.ts

@@ -22,6 +22,19 @@ export interface AcrylSessionBridge {
         readonly sessionId: string;
         readonly text: string;
     }): Promise<void>;
+    /**
+     * Switch an already-open session's live model. `agentOptions.provider`/`model`
+     * are a one-time construction input to `ctx.agents.create` — not a live
+     * setting — so this is the only thing that changes what a running session
+     * sends its next request to (`ModelSelectionRef` installed on the agent's
+     * own scoped context via `installModelSelection`, per-step prompt assembly
+     * reads it fresh).
+     */
+    selectModel(input: {
+        readonly sessionId: string;
+        readonly provider: string;
+        readonly model: string;
+    }): Promise<void>;
     cancel(sessionId: string): Promise<void>;
     dispose(): Promise<void>;
 }

package/runtime/node_modules/acryl-harness-runtime/lib/types/session-log-exporter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A durable, cross-surface debug log for ACRYL sessions.
+ *
+ * Cordis's own `ctx.logger` already carries every structured log record any
+ * plugin emits, but nothing in this stack persisted it anywhere — a failure
+ * like a vendored provider's OAuth error only ever reached the terminal
+ * transcript, gone the moment the pane scrolled or the process exited. This
+ * registers one JSONL file exporter on `ctx.logger` per surface (CLI/TUI,
+ * web, and — once wired there too — the desktop GUI), so `error`/`warn`
+ * records (and everything, when `ACRYL_LOG_LEVEL=debug`) survive the session
+ * and can be read back after the fact instead of re-derived from a
+ * screenshot.
+ *
+ * @module acryl-harness-runtime/session-log-exporter
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export interface InstallSessionLogExporterOptions {
+    /** Which ACRYL surface this process is (`tui`, `web`, `desktop`) — becomes part of the log filename. */
+    readonly surface: string;
+    /** Harness home override; defaults to `$DSH_HOME`/`~/.dsh` exactly like credentials/settings resolve it. */
+    readonly dshHome?: string;
+}
+/**
+ * Register the file exporter for this process's lifetime. `ctx.logger.exporter()`
+ * already ties its own disposal to the fiber that registers it (see
+ * `LoggerService.exporter` in `@deepseek-ai/cordis`), so this needs no extra
+ * `ctx.effect()` wrapper of its own.
+ * @param ctx - the plugin context whose `ctx.logger` gains the exporter.
+ * @param options - which surface/home this log file belongs to.
+ */
+export declare function installSessionLogExporter(ctx: Context, options: InstallSessionLogExporterOptions): void;

package/runtime/node_modules/acryl-harness-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acryl-harness-runtime",
-  "version": "0.1.31",
+  "version": "0.1.35",
   "private": false,
   "license": "MIT",
   "type": "module",

package/runtime/node_modules/acryl-harness-runtime/src/acryl-home.ts

@@ -0,0 +1,50 @@
+/**
+ * ACRYL's own data root, nested one level above the DSH engine home it
+ * composes.
+ *
+ * The stock DSH Desktop app (from dshdesktop.com) uses plain `~/.dsh`, and so
+ * did every ACRYL surface until now — sharing that root made the two
+ * genuinely different products silently share credentials/settings/sessions,
+ * which is both confusing and useless for comparing ACRYL against a stock
+ * DSH Desktop install side by side. ACRYL now owns `~/.acryl` and nests each
+ * engine's artifacts under it by engine name:
+ *
+ * ```txt
+ * ~/.acryl/            ACRYL's own root — everything not engine-specific
+ * ~/.acryl/.dsh/        the DSH engine home (what DSH_HOME resolves to)
+ * ~/.acryl/.pi/         reserved for a future pi.dev engine
+ * ```
+ *
+ * `$DSH_HOME`, if a caller has already set it explicitly, still wins — this
+ * only changes the *default* the harness's own `resolveDshHome()` falls
+ * back to when nothing overrides it.
+ *
+ * @module acryl-harness-runtime/acryl-home
+ */
+
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
+
+/** ACRYL's own root directory name under the OS home. */
+export const ACRYL_HOME_DIR_NAME = '.acryl'
+
+/** The DSH engine's directory name, nested under ACRYL's root. */
+export const ACRYL_DSH_ENGINE_DIR_NAME = '.dsh'
+
+/** ACRYL's own root — `~/.acryl` unless `$ACRYL_HOME` overrides it. */
+export function resolveAcrylHome(env: Record<string, string | undefined> = process.env): string {
+  const overridden = env.ACRYL_HOME?.trim()
+  return overridden && overridden !== '' ? overridden : join(homedir(), ACRYL_HOME_DIR_NAME)
+}
+
+/**
+ * The DSH engine home ACRYL boots against: `$DSH_HOME` if a caller already
+ * set it (highest precedence, same as `resolveDshHome()` itself), otherwise
+ * `<acrylHome>/.dsh` instead of the harness's own bare `~/.dsh` default.
+ */
+export function resolveAcrylDshHome(env: Record<string, string | undefined> = process.env): string {
+  const overridden = env.DSH_HOME?.trim()
+  if (overridden && overridden !== '') return resolveDshHome(undefined, env)
+  return resolveDshHome(join(resolveAcrylHome(env), ACRYL_DSH_ENGINE_DIR_NAME), env)
+}

package/runtime/node_modules/acryl-harness-runtime/src/index.ts

@@ -14,6 +14,16 @@ export {
   type AcrylSessionBridge,
   type AcrylSessionBridgeOptions,
 } from './session-bridge.ts'
+export {
+  installSessionLogExporter,
+  type InstallSessionLogExporterOptions,
+} from './session-log-exporter.ts'
+export {
+  ACRYL_DSH_ENGINE_DIR_NAME,
+  ACRYL_HOME_DIR_NAME,
+  resolveAcrylDshHome,
+  resolveAcrylHome,
+} from './acryl-home.ts'
 
 import { writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
@@ -30,8 +40,10 @@ import {
   resolveProfileDir,
 } from '@deepseek-ai/dsh-app-boot'
 
+import { resolveAcrylDshHome } from './acryl-home.ts'
 import { createAcrylCodingCapabilityPatches } from './coding-capabilities.ts'
 import { installAcrylWorkspaceStatusTool } from './plugin-acryl-workspace-status.ts'
+import { installSessionLogExporter } from './session-log-exporter.ts'
 
 const require = createRequire(import.meta.url)
 const dshInstallAnchor = require.resolve('@deepseek-ai/dsh/package.json')
@@ -53,6 +65,7 @@ export async function bootAcrylHarnessProfile(
   options: BootAcrylHarnessProfileOptions,
 ): Promise<AcrylHarnessRuntime> {
   if (options.profile.trim() === '') throw new Error('ACRYL Harness profile must not be empty')
+  process.env.DSH_HOME = resolveAcrylDshHome()
   const profileDirectory = resolveProfileDir(options.profile)
   initProfile(profileDirectory, DEFAULT_PROFILE_BUNDLES)
   healProfilesModuleFallback(dshInstallAnchor)
@@ -72,6 +85,7 @@ export async function bootAcrylHarnessProfile(
   }
   const ctx = await boot('acryl', rootConfig, patches, options.prepare)
   if ((ctx as { tools?: unknown }).tools) installAcrylWorkspaceStatusTool(ctx)
+  installSessionLogExporter(ctx, { surface: 'tui' })
   let disposed = false
   return Object.freeze({
     ctx,
@@ -110,6 +124,7 @@ export async function bootAcrylWebProfile(
   options: BootAcrylWebProfileOptions = {},
 ): Promise<AcrylWebRuntime> {
   const profileName = 'web'
+  process.env.DSH_HOME = resolveAcrylDshHome()
   const profileDirectory = resolveProfileDir(profileName)
   initProfile(profileDirectory, DEFAULT_PROFILE_BUNDLES)
   healProfilesModuleFallback(dshInstallAnchor)
@@ -127,6 +142,7 @@ export async function bootAcrylWebProfile(
     return options.prepare?.(hostCtx)
   })
   if ((ctx as { tools?: unknown }).tools) installAcrylWorkspaceStatusTool(ctx)
+  installSessionLogExporter(ctx, { surface: 'web' })
   const startup = ctx.get('webStartup') as { host?: string; port?: number } | undefined
   const host = startup?.host ?? '127.0.0.1'
   const port = startup?.port ?? 3080

package/runtime/node_modules/acryl-harness-runtime/src/session-bridge.ts

@@ -1,5 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis'
-import type { Agent, AgentHandle } from '@deepseek-ai/dsh-agent'
+import { installModelSelection, type Agent, type AgentHandle, type ModelSelectionRef } from '@deepseek-ai/dsh-agent'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
 import { SessionId, type SessionEvent } from '@deepseek-ai/dsh-session'
 import type {} from '@deepseek-ai/dsh-agent-default-model'
@@ -39,6 +39,15 @@ export interface AcrylSessionBridge {
     listener: (event: SessionEvent) => void,
   ): Promise<AcrylSessionEventSubscription>
   submitPrompt(input: { readonly sessionId: string; readonly text: string }): Promise<void>
+  /**
+   * Switch an already-open session's live model. `agentOptions.provider`/`model`
+   * are a one-time construction input to `ctx.agents.create` — not a live
+   * setting — so this is the only thing that changes what a running session
+   * sends its next request to (`ModelSelectionRef` installed on the agent's
+   * own scoped context via `installModelSelection`, per-step prompt assembly
+   * reads it fresh).
+   */
+  selectModel(input: { readonly sessionId: string; readonly provider: string; readonly model: string }): Promise<void>
   cancel(sessionId: string): Promise<void>
   dispose(): Promise<void>
 }
@@ -101,6 +110,8 @@ export function createAcrylSessionBridge(
   options: AcrylSessionBridgeOptions,
 ): AcrylSessionBridge {
   const handles = new Map<string, AgentHandle>()
+  const modelSelections = new Map<string, ModelSelectionRef>()
+  const modelSelectionDisposers = new Map<string, () => void>()
   const subscribers = new Map<string, Set<(snapshot: AcrylSessionSnapshot) => void>>()
   const eventListeners = new Map<string, Set<(event: SessionEvent) => void>>()
   let disposed = false
@@ -170,6 +181,9 @@ export function createAcrylSessionBridge(
             agentOptions: { provider: selection.provider, model: selection.model },
           })
       handles.set(handle.agent.id, handle)
+      const ref: ModelSelectionRef = { current: undefined, assembled: undefined }
+      modelSelectionDisposers.set(handle.agent.id, installModelSelection(handle.agent.ctx, ref))
+      modelSelections.set(handle.agent.id, ref)
       return handle.agent.id
     },
     snapshot,
@@ -235,6 +249,12 @@ export function createAcrylSessionBridge(
       }))
       await accepted
     },
+    async selectModel(input: { readonly sessionId: string; readonly provider: string; readonly model: string }): Promise<void> {
+      agentFor(input.sessionId)
+      const ref = modelSelections.get(input.sessionId)
+      if (ref === undefined) throw new Error(`ACRYL session ${input.sessionId} has no installed model selection`)
+      ref.current = { provider: input.provider, model: input.model }
+    },
     async cancel(sessionId: string): Promise<void> {
       agentFor(sessionId).cancel({ kind: 'user' })
     },
@@ -244,6 +264,9 @@ export function createAcrylSessionBridge(
       offSessionEvent()
       subscribers.clear()
       eventListeners.clear()
+      for (const dispose of modelSelectionDisposers.values()) dispose()
+      modelSelectionDisposers.clear()
+      modelSelections.clear()
       // Durable continuity: idle the turn, checkpoint the session log, then
       // release the native handle. Mirror of Tomo's shutdown sequence, owned
       // here so every surface gets the same durability guarantee.

package/runtime/node_modules/acryl-harness-runtime/src/session-log-exporter.ts

@@ -0,0 +1,69 @@
+/**
+ * A durable, cross-surface debug log for ACRYL sessions.
+ *
+ * Cordis's own `ctx.logger` already carries every structured log record any
+ * plugin emits, but nothing in this stack persisted it anywhere — a failure
+ * like a vendored provider's OAuth error only ever reached the terminal
+ * transcript, gone the moment the pane scrolled or the process exited. This
+ * registers one JSONL file exporter on `ctx.logger` per surface (CLI/TUI,
+ * web, and — once wired there too — the desktop GUI), so `error`/`warn`
+ * records (and everything, when `ACRYL_LOG_LEVEL=debug`) survive the session
+ * and can be read back after the fact instead of re-derived from a
+ * screenshot.
+ *
+ * @module acryl-harness-runtime/session-log-exporter
+ */
+
+import { appendFileSync, mkdirSync } from 'node:fs'
+import { join } from 'node:path'
+import type { Context } from '@deepseek-ai/cordis'
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
+
+export interface InstallSessionLogExporterOptions {
+  /** Which ACRYL surface this process is (`tui`, `web`, `desktop`) — becomes part of the log filename. */
+  readonly surface: string
+  /** Harness home override; defaults to `$DSH_HOME`/`~/.dsh` exactly like credentials/settings resolve it. */
+  readonly dshHome?: string
+}
+
+const LOGGER_LEVEL_WARN = 2
+const LOGGER_LEVEL_DEBUG = 3
+
+/**
+ * Register the file exporter for this process's lifetime. `ctx.logger.exporter()`
+ * already ties its own disposal to the fiber that registers it (see
+ * `LoggerService.exporter` in `@deepseek-ai/cordis`), so this needs no extra
+ * `ctx.effect()` wrapper of its own.
+ * @param ctx - the plugin context whose `ctx.logger` gains the exporter.
+ * @param options - which surface/home this log file belongs to.
+ */
+export function installSessionLogExporter(ctx: Context, options: InstallSessionLogExporterOptions): void {
+  const dshHome = resolveDshHome(options.dshHome)
+  const logDir = join(dshHome, 'logs')
+  try {
+    mkdirSync(logDir, { recursive: true, mode: 0o700 })
+  } catch {
+    return // best-effort diagnostics only; a session must never fail to start over this
+  }
+  const day = new Date().toISOString().slice(0, 10)
+  const logFile = join(logDir, `acryl-${options.surface}-${day}.jsonl`)
+  const threshold = process.env.ACRYL_LOG_LEVEL === 'debug' ? LOGGER_LEVEL_DEBUG : LOGGER_LEVEL_WARN
+
+  ctx.logger.exporter({
+    export(message) {
+      if (message.level > threshold) return
+      try {
+        appendFileSync(logFile, `${JSON.stringify({
+          ts: new Date(message.ts).toISOString(),
+          type: message.type,
+          name: message.name,
+          args: message.args.map(arg => (arg instanceof Error
+            ? { message: arg.message, stack: arg.stack, name: arg.name }
+            : arg)),
+        })}\n`, { mode: 0o600 })
+      } catch {
+        // best-effort: a write failure here must never take a session down
+      }
+    },
+  })
+}

package/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acryl-tui",
-  "version": "0.1.31",
+  "version": "0.1.35",
   "private": true,
   "description": "Canonical ACRYL pi-tui coding-agent terminal client",
   "license": "MIT",
@@ -25,7 +25,9 @@
     "node": ">=22"
   },
   "scripts": {
+    "prebuild": "node scripts/generate-build-info.mjs",
     "build": "tsdown && tsc -p tsconfig.json --emitDeclarationOnly",
+    "pretypecheck": "node scripts/generate-build-info.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit",
     "test": "vitest run",
     "tui": "node lib/bin.js tui",

package/runtime/receipt.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "surface": "cli",
   "target": "linux-x64",
-  "version": "0.1.31",
+  "version": "0.1.35",
   "packageName": "acryl-cli-linux-x64",
-  "payloadSha256": "28662eabe7bc951c7b2dcc1f038eaffedaa340ee1a8ff8ad721fea5f95d501c9"
+  "payloadSha256": "0e4da558f00aca2aa26c52a10677258683194e04e009d906f8d1d534ca688d53"
 }