@moxt-ai/mobius 0.0.182 → 0.0.184

package/dist/cli.js

@@ -3381,7 +3381,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@moxt-ai/mobius",
-  version: "0.0.182",
+  version: "0.0.184",
   description: "Mobius CLI for pairing and running local AI agent services.",
   type: "module",
   bin: {
@@ -4975,6 +4975,9 @@ function sessionFailureMeta(failure2) {
 // src/acp/codex/app-server-client.ts
 import { spawn as spawn2 } from "node:child_process";
 
+// src/acp/codex/app-server-protocol.ts
+import { isAbsolute as isAbsolute2 } from "node:path";
+
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -24714,6 +24717,7 @@ var imageGenerationItemSchema = external_exports.object({
 });
 var threadItemSchema = external_exports.discriminatedUnion("type", [
   imageGenerationItemSchema,
+  external_exports.object({ type: external_exports.literal("imageView"), id: boundedText(256), path: boundedText(32768).refine(isAbsolute2) }),
   external_exports.object({
     id: boundedText(256),
     text: boundedText(1e6),
@@ -25138,6 +25142,7 @@ var CodexAppServerClient = class {
 };
 
 // src/acp/codex/items.ts
+import { pathToFileURL } from "node:url";
 var TOOL_OUTPUT_CHARACTER_LIMIT = 32768;
 var TITLE_CHARACTER_LIMIT = 500;
 function truncate2(value, limit) {
@@ -25159,6 +25164,14 @@ function textContent(text2) {
   const block = { text: truncate2(text2, TOOL_OUTPUT_CHARACTER_LIMIT), type: "text" };
   return { content: block, type: "content" };
 }
+function structuredToolText(value) {
+  const result = external_exports.object({ content: external_exports.array(external_exports.unknown()) }).safeParse(value);
+  const items = Array.isArray(value) ? value : result.success ? result.data.content : [];
+  return items.flatMap((item) => {
+    const text2 = external_exports.object({ type: external_exports.enum(["text", "inputText"]), text: external_exports.string() }).safeParse(item);
+    return text2.success ? [textContent(text2.data.text)] : [];
+  });
+}
 function firstLine(value) {
   const line = value.split("\n", 1)[0] ?? "";
   return line.trim().length > 0 ? line.trim() : value.trim();
@@ -25179,6 +25192,22 @@ function mcpStatus(status) {
   return status === "inProgress" ? "in_progress" : status === "completed" ? "completed" : "failed";
 }
 function presentToolItem(item) {
+  if (item.type === "imageView") {
+    return {
+      content: [
+        {
+          type: "content",
+          content: { type: "image", data: "", mimeType: "", uri: pathToFileURL(item.path).href }
+        }
+      ],
+      kind: "read",
+      locations: [{ path: item.path }],
+      rawInput: { path: item.path },
+      rawOutput: null,
+      status: "completed",
+      title: "View image"
+    };
+  }
   if (item.type === "imageGeneration") {
     const failed = item.failure != null || item.status === "failed";
     const content = [];
@@ -25243,13 +25272,7 @@ function presentToolItem(item) {
   }
   if (item.type === "mcpToolCall") {
     const label = `${item.server}/${item.tool}`;
-    const content = [];
-    if (item.result != null) {
-      content.push(textContent(JSON.stringify(item.result)));
-    }
-    if (item.error != null) {
-      content.push(textContent(JSON.stringify(item.error)));
-    }
+    const content = structuredToolText(item.error ?? item.result);
     return {
       content,
       kind: "other",
@@ -25262,13 +25285,13 @@ function presentToolItem(item) {
   }
   if (item.type === "dynamicToolCall") {
     const label = item.namespace == null ? item.tool : `${item.namespace}/${item.tool}`;
-    const content = (item.contentItems ?? []).map((entry) => textContent(JSON.stringify(entry)));
+    const content = structuredToolText(item.contentItems);
     return {
       content,
       kind: "other",
       locations: [],
       rawInput: item.arguments ?? null,
-      rawOutput: item.success === true ? null : item.contentItems ?? null,
+      rawOutput: item.contentItems ?? null,
       status: mcpStatus(item.status),
       title: truncate2(label, TITLE_CHARACTER_LIMIT)
     };
@@ -25281,12 +25304,12 @@ function toolCallUpdate(item, lifecycle) {
     return null;
   }
   return {
-    content: [...presentation.content],
+    content: item.type === "imageView" && lifecycle === "started" ? [] : [...presentation.content],
     kind: presentation.kind,
     locations: [...presentation.locations],
     rawInput: presentation.rawInput,
     rawOutput: presentation.rawOutput,
-    status: lifecycle === "completed" && presentation.status === "in_progress" ? "completed" : presentation.status,
+    status: item.type === "imageView" && lifecycle === "started" ? "in_progress" : lifecycle === "completed" && presentation.status === "in_progress" ? "completed" : presentation.status,
     title: presentation.title,
     toolCallId: item.id
   };
@@ -26510,12 +26533,12 @@ var AgentProbeError = class extends Error {
 };
 
 // src/agent-catalog/agents/resolve-user-local-executable.ts
-import { isAbsolute as isAbsolute2, join as join4 } from "node:path";
+import { isAbsolute as isAbsolute3, join as join4 } from "node:path";
 async function resolveUserLocalExecutable(executableName, context) {
   context.signal.throwIfAborted();
   const platform = context.platform ?? process.platform;
   const homeDirectory = context.environment["HOME"];
-  if (platform === "win32" || homeDirectory === void 0 || !isAbsolute2(homeDirectory)) {
+  if (platform === "win32" || homeDirectory === void 0 || !isAbsolute3(homeDirectory)) {
     return [];
   }
   const executable = await resolveExecutablePath(join4(homeDirectory, ".local", "bin", executableName), platform);
@@ -26608,7 +26631,7 @@ var CursorCliAgentSpecification = class extends DirectAcpAgentDefinition {
 
 // src/agent-catalog/agents/deepseek-harness-agent.ts
 import { mkdir as mkdir2, realpath as realpath3, stat as stat3, writeFile } from "node:fs/promises";
-import { isAbsolute as isAbsolute3, join as join6, normalize } from "node:path";
+import { isAbsolute as isAbsolute4, join as join6, normalize } from "node:path";
 
 // src/agent-installation/deepseek-managed-package.ts
 var DeepSeekHarnessManagedPackage = class extends SriManagedNpmPackageDefinition {
@@ -26643,7 +26666,7 @@ var DEEPSEEK_HARNESS_IMAGE_PROMPT_PATCH = `# Managed by Mobius: pin the ACP brid
     model: deepseek-v4-flash-vision-exp
 `;
 async function prepareAgentHome(path3, imagePrompts) {
-  if (!isAbsolute3(path3) || normalize(path3) !== path3) {
+  if (!isAbsolute4(path3) || normalize(path3) !== path3) {
     throw new AgentProbeError("agent_environment_invalid", "The configured Agent home is invalid");
   }
   try {
@@ -26775,7 +26798,7 @@ var GeminiCliAgentSpecification = class extends DirectAcpAgentDefinition {
 
 // src/agent-catalog/agents/grok-build-agent.ts
 import { realpath as realpath4 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join7, relative as relative2, sep as sep2 } from "node:path";
+import { isAbsolute as isAbsolute5, join as join7, relative as relative2, sep as sep2 } from "node:path";
 import {
   RequestError
 } from "@agentclientprotocol/sdk";
@@ -26841,7 +26864,7 @@ function grokBuildManagedPackage(platform, architecture) {
 // src/agent-catalog/agents/grok-build-agent.ts
 function isContainedPath2(root, candidate) {
   const difference = relative2(root, candidate);
-  return difference.length > 0 && difference !== ".." && !difference.startsWith(`..${sep2}`) && !isAbsolute4(difference);
+  return difference.length > 0 && difference !== ".." && !difference.startsWith(`..${sep2}`) && !isAbsolute5(difference);
 }
 var GrokBuildAgentSpecification = class extends DirectAcpAgentDefinition {
   adapterVersion = GROK_BUILD_MANAGED_VERSION;
@@ -26990,7 +27013,7 @@ import { join as join9 } from "node:path";
 import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { chmod, copyFile, mkdir as mkdir3, mkdtemp as mkdtemp2, open as open3, realpath as realpath5, rename as rename2, rm as rm2, stat as stat4, writeFile as writeFile2 } from "node:fs/promises";
-import { delimiter as delimiter2, dirname as dirname2, isAbsolute as isAbsolute5, join as join8, relative as relative3, sep as sep3 } from "node:path";
+import { delimiter as delimiter2, dirname as dirname2, isAbsolute as isAbsolute6, join as join8, relative as relative3, sep as sep3 } from "node:path";
 
 // src/agent-installation/verified-download.ts
 import { fetch } from "undici";
@@ -27096,7 +27119,7 @@ function isRecord4(value) {
 }
 function isContainedPath3(root, candidate) {
   const difference = relative3(root, candidate);
-  return difference.length > 0 && difference !== ".." && !difference.startsWith(`..${sep3}`) && !isAbsolute5(difference);
+  return difference.length > 0 && difference !== ".." && !difference.startsWith(`..${sep3}`) && !isAbsolute6(difference);
 }
 async function hashFile(path3, signal) {
   signal.throwIfAborted();
@@ -27486,7 +27509,7 @@ var PiAgentSpecification = class extends BridgedAcpAgentDefinition {
 };
 
 // src/agent-catalog/agents/workbuddy-agent.ts
-import { isAbsolute as isAbsolute6, join as join11 } from "node:path";
+import { isAbsolute as isAbsolute7, join as join11 } from "node:path";
 
 // src/agent-installation/workbuddy-managed-package.ts
 var WORKBUDDY_MANAGED_VERSION = "2.146.0";
@@ -27554,7 +27577,7 @@ var WorkBuddyAgentSpecification = class extends DirectAcpAgentDefinition {
     }
     const requestedPaths = [join11("/Applications", ...WORKBUDDY_MACOS_EXECUTABLE_PATH)];
     const homeDirectory = context.environment["HOME"];
-    if (homeDirectory !== void 0 && isAbsolute6(homeDirectory)) {
+    if (homeDirectory !== void 0 && isAbsolute7(homeDirectory)) {
       requestedPaths.unshift(join11(homeDirectory, "Applications", ...WORKBUDDY_MACOS_EXECUTABLE_PATH));
     }
     const executables = [];
@@ -27919,7 +27942,7 @@ function isAgentVersionSupported(reportedVersion, minimumSupportedVersion) {
 }
 
 // src/agent-catalog/executable-discovery.ts
-import { isAbsolute as isAbsolute7, join as join13 } from "node:path";
+import { isAbsolute as isAbsolute8, join as join13 } from "node:path";
 
 // src/agent-installation/managed-adapter-installer.ts
 import { join as join12 } from "node:path";
@@ -28024,7 +28047,7 @@ async function resolveManagedAdapterExecutable(specification, context) {
 async function resolveSpecificationExecutables(executableName, overrideVariable, resolveInstalled, resolveManaged, context) {
   const override = context.environment[overrideVariable];
   if (override !== void 0) {
-    if (override.length === 0 || !isAbsolute7(override)) {
+    if (override.length === 0 || !isAbsolute8(override)) {
       return [];
     }
     const executable = await resolveExecutablePath(override, context.platform);
@@ -31314,7 +31337,7 @@ import {
 
 // src/authorization/local-raster.ts
 import { open as open5, readFile as readFile2, realpath as realpath7, stat as stat6 } from "node:fs/promises";
-import { basename as basename2, isAbsolute as isAbsolute8, normalize as normalize2 } from "node:path";
+import { basename as basename2, isAbsolute as isAbsolute9, normalize as normalize2 } from "node:path";
 import { fileURLToPath } from "node:url";
 var MAX_LOCAL_RASTER_BYTES = 128 * 1024 * 1024;
 var MAX_INLINE_RASTER_BYTES = 3e6;
@@ -31380,13 +31403,13 @@ function readInlineRaster(data, name2 = "Image") {
 }
 async function resolveCanonicalPath(requested, signal) {
   signal.throwIfAborted();
-  if (!isAbsolute8(requested) || requested.includes("\0") || normalize2(requested) !== requested) {
+  if (!isAbsolute9(requested) || requested.includes("\0") || normalize2(requested) !== requested) {
     return null;
   }
   try {
     const target = await realpath7(requested);
     signal.throwIfAborted();
-    if (!isAbsolute8(target) || normalize2(target) !== target) {
+    if (!isAbsolute9(target) || normalize2(target) !== target) {
       return null;
     }
     return target;
@@ -31894,6 +31917,18 @@ function isProgressMessage(content) {
 // src/acp/agent-connection.ts
 import { spawn as spawn4 } from "node:child_process";
 import { ndJsonStream as ndJsonStream2, RequestError as RequestError3 } from "@agentclientprotocol/sdk";
+function requestErrorMessage(error62) {
+  const fallback = truncate(error62.message, 500);
+  if (error62.message !== "Internal error" || !isRecord3(error62.data)) {
+    return fallback;
+  }
+  const agentError = error62.data["error"];
+  if (!isRecord3(agentError) || agentError["code"] !== "invalid_prompt") {
+    return fallback;
+  }
+  const message = agentError["message"];
+  return typeof message === "string" && message.length > 0 ? truncate(message, 500) : fallback;
+}
 function readableWebStream(input2) {
   let streamOpen = true;
   return new ReadableStream({
@@ -32065,7 +32100,7 @@ var AgentConnection = class {
           );
         }
         if (error62 instanceof RequestError3) {
-          throw new AcpExecutionError(truncate(error62.message, 500), { cause: error62 }, "acp_agent_error");
+          throw new AcpExecutionError(requestErrorMessage(error62), { cause: error62 }, "acp_agent_error");
         }
         throw error62;
       }
@@ -38873,11 +38908,11 @@ var AgentSession = class _AgentSession {
     }
     throw new AcpExecutionError("ACP agent initialization failed");
   }
-  static start = async (options, getObserver, store, metrics, contentExternalizer) => await _AgentSession.#start(
+  static start = async (options, recovery, getObserver, store, metrics, contentExternalizer) => await _AgentSession.#start(
     options,
     getObserver,
     store,
-    async (runtime) => await runtime.initialize(options.signal, options.origin),
+    async (runtime) => await runtime.initialize(options.signal, recovery, options.origin),
     metrics,
     contentExternalizer
   );
@@ -38915,6 +38950,16 @@ var AgentSession = class _AgentSession {
     const history = await this.#completedHistory(signal, "ACP agent exited while loading history");
     return await embedLocalHistoryImages(await history.snapshot(), signal);
   };
+  ensureHistoryLoaded = async (signal) => {
+    if (!this.#capabilities.loadSession) {
+      throw new AcpExecutionError(
+        "This Agent restores context but does not provide message history.",
+        {},
+        "native_history_unsupported"
+      );
+    }
+    await this.#completedHistory(signal, "ACP agent exited while loading history");
+  };
   loadHistoryEventsV2 = async (eventLimit, cursor, signal) => {
     if (!this.#capabilities.loadSession) {
       throw new AcpExecutionError(
@@ -39087,7 +39132,7 @@ var AgentSession = class _AgentSession {
       128
     );
   }
-  initialize = async (signal, origin) => {
+  initialize = async (signal, recovery, origin) => {
     await this.#initializeAgent(signal);
     let stored = this.#metrics.measureSync(
       "session-state-read",
@@ -39156,7 +39201,19 @@ var AgentSession = class _AgentSession {
       this.#prompted = stored.session.prompted;
       this.#sessionTitle = stored.session.title;
       this.#restored = true;
-      if (this.#capabilities.resumeSession) {
+      if (recovery.kind === "history-required") {
+        if (!this.#capabilities.loadSession) {
+          throw new AcpExecutionError(
+            "This Agent restores context but does not provide message history.",
+            {},
+            "native_history_unsupported"
+          );
+        }
+        lifecycleResponse = await this.#metrics.measure(
+          "session-load",
+          async () => (await this.#loadSession(signal, "ACP agent exited while loading a session")).response
+        );
+      } else if (this.#capabilities.resumeSession) {
         lifecycleResponse = await this.#metrics.measure(
           "session-resume",
           async () => await this.race(
@@ -40114,8 +40171,15 @@ var embeddedImageSchema = external_exports.looseObject({
   data: external_exports.string(),
   mimeType: external_exports.string()
 });
+var inlineImageUrlSchema = external_exports.string().regex(/^data:image\/(?:png|jpeg|gif|webp);base64,/u).transform((url2) => ({
+  type: "image",
+  data: url2.slice(url2.indexOf(",") + 1),
+  mimeType: url2.slice(5, url2.indexOf(";"))
+}));
 var toolImageSchema = external_exports.union([
   embeddedImageSchema,
+  external_exports.object({ type: external_exports.literal("file"), mime: external_exports.string(), url: inlineImageUrlSchema }).refine(({ mime, url: url2 }) => mime === url2.mimeType).transform(({ url: url2 }) => url2),
+  external_exports.object({ type: external_exports.literal("inputImage"), imageUrl: inlineImageUrlSchema }).transform(({ imageUrl }) => imageUrl),
   external_exports.object({
     type: external_exports.literal("image"),
     source: external_exports.object({ type: external_exports.literal("base64"), data: external_exports.string(), media_type: external_exports.string() })
@@ -40767,12 +40831,13 @@ var AgentRuntimeManager = class {
     this.#executionProcesses.retain(options.sessionId, runtime);
     return runtime;
   }
-  async #startPreparation(options, metrics = unmeasuredOperationMetrics) {
+  async #startPreparation(options, recovery, metrics = unmeasuredOperationMetrics) {
     return await this.#executionProcesses.prepare(options.sessionId, async () => {
       return await this.#startRetainedSessionProcess(
         options,
         async () => await AgentSession.start(
           options.origin === void 0 && this.#sessionIdentity === "native" && isNativeChatSessionId(options.agent.id, options.sessionId) && this.#store.read(options.sessionId) instanceof MissingAcpStoredSession ? { ...options, origin: { kind: "import", nativeSessionId: options.sessionId } } : options,
+          recovery,
           () => this.#observer,
           this.#store,
           metrics,
@@ -40781,7 +40846,7 @@ var AgentRuntimeManager = class {
       );
     });
   }
-  async #replacePreparation(existing, options, metrics) {
+  async #replacePreparation(existing, options, recovery, metrics) {
     return await this.#executionProcesses.prepare(options.sessionId, async () => {
       await this.#retireSessionProcess(
         options.sessionId,
@@ -40793,6 +40858,7 @@ var AgentRuntimeManager = class {
         options,
         async () => await AgentSession.start(
           options,
+          recovery,
           () => this.#observer,
           this.#store,
           metrics,
@@ -40809,6 +40875,7 @@ var AgentRuntimeManager = class {
         options,
         async () => await AgentSession.start(
           options,
+          { kind: "interactive-only" },
           () => this.#observer,
           this.#store,
           unmeasuredOperationMetrics,
@@ -40852,42 +40919,58 @@ var AgentRuntimeManager = class {
       return runtime;
     });
   }
-  prepareSession = async (options, metrics = unmeasuredOperationMetrics) => this.#operations.run(options, async (options2) => {
-    const stored = metrics.measureSync("session-state-read", () => this.#store.read(options2.sessionId));
-    if (stored instanceof FoundAcpStoredSession && this.#nativeOperations.has(`${stored.session.agentId}:${stored.session.nativeSessionId}`)) {
-      throw new AcpExecutionError("The native session is being managed", {}, "session_busy");
-    }
-    const pending = this.#executionProcesses.pending(options2.sessionId);
-    if (pending !== void 0) {
-      const runtime2 = await metrics.measure(
-        "session-preparation-wait",
-        async () => await waitForSharedOperation(pending, options2.signal)
-      );
-      if (runtime2.belongsTo(options2.agent.id, options2.cwd, options2.additionalDirectories)) {
-        this.#executionProcesses.touch(options2.sessionId, runtime2);
-        return runtime2.prepared();
-      }
-      return await this.prepareSession(options2, metrics);
-    }
-    const existing = this.#executionProcesses.get(options2.sessionId);
-    if (existing !== void 0) {
-      if (existing.belongsTo(options2.agent.id, options2.cwd, options2.additionalDirectories)) {
-        this.#executionProcesses.touch(options2.sessionId, existing);
-        return existing.prepared();
+  async #prepareSession(options, recovery, metrics = unmeasuredOperationMetrics) {
+    return await this.#operations.run(options, async (options2) => {
+      const stored = metrics.measureSync("session-state-read", () => this.#store.read(options2.sessionId));
+      if (stored instanceof FoundAcpStoredSession && this.#nativeOperations.has(`${stored.session.agentId}:${stored.session.nativeSessionId}`)) {
+        throw new AcpExecutionError("The native session is being managed", {}, "session_busy");
       }
-      if (!existing.canRebind()) {
-        throw new AcpExecutionError(
-          "The agent or workspace cannot change after a conversation has started",
-          {},
-          "session_identity_mismatch"
+      const pending = this.#executionProcesses.pending(options2.sessionId);
+      if (pending !== void 0) {
+        const runtime2 = await metrics.measure(
+          "session-preparation-wait",
+          async () => await waitForSharedOperation(pending, options2.signal)
         );
+        if (runtime2.belongsTo(options2.agent.id, options2.cwd, options2.additionalDirectories)) {
+          this.#executionProcesses.touch(options2.sessionId, runtime2);
+          if (recovery.kind === "history-required") {
+            await metrics.measure(
+              "session-load",
+              async () => await runtime2.ensureHistoryLoaded(options2.signal)
+            );
+          }
+          return runtime2.prepared();
+        }
+        return await this.#prepareSession(options2, recovery, metrics);
+      }
+      const existing = this.#executionProcesses.get(options2.sessionId);
+      if (existing !== void 0) {
+        if (existing.belongsTo(options2.agent.id, options2.cwd, options2.additionalDirectories)) {
+          this.#executionProcesses.touch(options2.sessionId, existing);
+          if (recovery.kind === "history-required") {
+            await metrics.measure(
+              "session-load",
+              async () => await existing.ensureHistoryLoaded(options2.signal)
+            );
+          }
+          return existing.prepared();
+        }
+        if (!existing.canRebind()) {
+          throw new AcpExecutionError(
+            "The agent or workspace cannot change after a conversation has started",
+            {},
+            "session_identity_mismatch"
+          );
+        }
+        const runtime2 = await this.#replacePreparation(existing, options2, recovery, metrics);
+        return runtime2.prepared();
       }
-      const runtime2 = await this.#replacePreparation(existing, options2, metrics);
-      return runtime2.prepared();
-    }
-    const runtime = await this.#startPreparation(options2, metrics);
-    return runtime.prepared();
-  });
+      const runtime = await this.#startPreparation(options2, recovery, metrics);
+      return runtime.prepared();
+    });
+  }
+  prepareSession = async (options, metrics = unmeasuredOperationMetrics) => await this.#prepareSession(options, { kind: "interactive-only" }, metrics);
+  restoreSession = async (options, metrics = unmeasuredOperationMetrics) => await this.#prepareSession(options, { kind: "history-required" }, metrics);
   /**
    * Opens a short-lived native ACP session only to read the local Agent's
    * authoritative settings. Its identity and store are private to this
@@ -40901,6 +40984,7 @@ var AgentRuntimeManager = class {
           ...options2,
           sessionId: `agent-settings-${crypto.randomUUID()}`
         },
+        { kind: "interactive-only" },
         () => this.#agentSettingsObserver,
         new MemoryAcpSessionStore(),
         unmeasuredOperationMetrics,
@@ -40938,7 +41022,7 @@ var AgentRuntimeManager = class {
       );
     }
     return await this.#executionProcesses.use(options2.sessionId, async () => {
-      const runtime = await this.#startPreparation(options2, metrics);
+      const runtime = await this.#startPreparation(options2, { kind: "interactive-only" }, metrics);
       try {
         return runtime.prepared();
       } finally {
@@ -40958,7 +41042,7 @@ var AgentRuntimeManager = class {
     }
     const existing = this.#executionProcesses.get(options2.sessionId);
     if (existing === void 0) {
-      return (await this.#startPreparation(options2)).prepared();
+      return (await this.#startPreparation(options2, { kind: "interactive-only" })).prepared();
     }
     if (!existing.belongsTo(options2.agent.id, options2.cwd, options2.additionalDirectories)) {
       throw new AcpExecutionError(
@@ -41143,7 +41227,7 @@ var AgentRuntimeManager = class {
     const temporaryOptions = { ...options2, sessionId: temporarySessionId };
     return await this.#executionProcesses.use(temporarySessionId, async () => {
       try {
-        const runtime = await this.#startPreparation(temporaryOptions);
+        const runtime = await this.#startPreparation(temporaryOptions, { kind: "interactive-only" });
         let adopted = false;
         try {
           const nativeSessionId = runtime.nativeSessionId();
@@ -41309,7 +41393,7 @@ var AgentRuntimeManager = class {
     return await this.#executionProcesses.use(options2.sessionId, async () => {
       this.#nativeOperations.add(key);
       try {
-        const runtime = await this.#startPreparation({ ...options2, origin });
+        const runtime = await this.#startPreparation({ ...options2, origin }, { kind: "interactive-only" });
         const openedKey = `${options2.agent.id}:${runtime.nativeSessionId()}`;
         this.#nativeOperations.add(openedKey);
         try {
@@ -41922,7 +42006,7 @@ var FixedInstallationExecutor = class {
 // src/authorization/workspace-directory.ts
 import { readdir as readdir4, realpath as realpath9, stat as stat8 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { basename as basename4, dirname as dirname5, isAbsolute as isAbsolute9, join as join17, normalize as normalize3, relative as relative4 } from "node:path";
+import { basename as basename4, dirname as dirname5, isAbsolute as isAbsolute10, join as join17, normalize as normalize3, relative as relative4 } from "node:path";
 
 // src/authorization/local-authorization-error.ts
 var LocalAuthorizationError = class extends Error {
@@ -41989,7 +42073,7 @@ var WorkspaceDirectoryService = class {
     }
     if (id.startsWith("path-")) {
       const path3 = expandCurrentUserHome(decodePath(id, "path-"));
-      if (isAbsolute9(path3)) {
+      if (isAbsolute10(path3)) {
         return path3;
       }
     }
@@ -41997,7 +42081,7 @@ var WorkspaceDirectoryService = class {
   };
   resolvePath = async (requested, signal) => {
     signal.throwIfAborted();
-    if (!isAbsolute9(requested) || requested.includes("\0") || normalize3(requested) !== requested) {
+    if (!isAbsolute10(requested) || requested.includes("\0") || normalize3(requested) !== requested) {
       throw new LocalAuthorizationError("The local directory path is invalid");
     }
     try {
@@ -42005,7 +42089,7 @@ var WorkspaceDirectoryService = class {
       signal.throwIfAborted();
       const metadata = await stat8(target);
       signal.throwIfAborted();
-      if (!isAbsolute9(target) || normalize3(target) !== target || !metadata.isDirectory()) {
+      if (!isAbsolute10(target) || normalize3(target) !== target || !metadata.isDirectory()) {
         throw new LocalAuthorizationError("The selected location is not a directory");
       }
       return target;
@@ -42021,7 +42105,7 @@ var WorkspaceDirectoryService = class {
   };
   label = (path3) => {
     const suffix = relative4(homedir2(), path3);
-    return suffix === "" ? "~" : !isAbsolute9(suffix) && suffix !== ".." && !suffix.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) ? `~/${suffix.replaceAll("\\", "/")}` : path3;
+    return suffix === "" ? "~" : !isAbsolute10(suffix) && suffix !== ".." && !suffix.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) ? `~/${suffix.replaceAll("\\", "/")}` : path3;
   };
   identify = async (bindingId, requestedPath2, signal) => {
     this.authorizeMachine(bindingId);
@@ -45099,7 +45183,7 @@ function createAgentSettingsDiscoveryHandler(dependencies) {
 // src/artifacts/local-file-streamer.ts
 import { createReadStream as createReadStream2 } from "node:fs";
 import { realpath as realpath10, stat as stat9 } from "node:fs/promises";
-import { basename as basename5, isAbsolute as isAbsolute10, normalize as normalize4, resolve as resolve7 } from "node:path";
+import { basename as basename5, isAbsolute as isAbsolute11, normalize as normalize4, resolve as resolve7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var CHUNK_BYTES = 192 * 1024;
 function requestedPath(value) {
@@ -45118,17 +45202,17 @@ function requestedPath(value) {
 }
 async function resolveFile(value, workingDirectory, signal) {
   const path3 = requestedPath(value);
-  if (path3 === null || !isAbsolute10(path3) && workingDirectory === null) {
+  if (path3 === null || !isAbsolute11(path3) && workingDirectory === null) {
     return null;
   }
   const requested = workingDirectory === null ? path3 : resolve7(workingDirectory, path3);
-  if (!isAbsolute10(requested) || isAbsolute10(path3) && normalize4(path3) !== path3) {
+  if (!isAbsolute11(requested) || isAbsolute11(path3) && normalize4(path3) !== path3) {
     return null;
   }
   try {
     const target = await realpath10(requested);
     signal.throwIfAborted();
-    return isAbsolute10(target) && normalize4(target) === target ? target : null;
+    return isAbsolute11(target) && normalize4(target) === target ? target : null;
   } catch {
     signal.throwIfAborted();
     return null;
@@ -45657,7 +45741,7 @@ async function executePrompt({
 }
 
 // src/daemon-session-commands.ts
-async function prepareSession(command, config2, directories, audit, sessions, metrics, signal) {
+async function prepareSession(command, recovery, config2, directories, audit, sessions, metrics, signal) {
   return await metrics.measure("prepare-total", async () => {
     const resolved = await metrics.measure(
       "workspace-resolve",
@@ -45677,7 +45761,7 @@ async function prepareSession(command, config2, directories, audit, sessions, me
       sessionId: command.sessionId,
       signal
     };
-    const prepared = command.transient === true ? await sessions.inspectSession(preparation, metrics) : await sessions.prepareSession(preparation, metrics);
+    const prepared = command.transient === true ? await sessions.inspectSession(preparation, metrics) : recovery.kind === "history-required" ? await sessions.restoreSession(preparation, metrics) : await sessions.prepareSession(preparation, metrics);
     const configuration = command.configuration;
     const configOptions = configuration === void 0 ? prepared.configOptions : await metrics.measure(
       "configuration",
@@ -45747,7 +45831,16 @@ async function executeWorkspaceList(socket, command, directories, audit, signal)
 async function executeSessionPrepare(socket, command, config2, directories, audit, sessions, diagnostics, signal) {
   const metrics = new AccumulatingOperationMetrics();
   try {
-    const readyEvent = await prepareSession(command, config2, directories, audit, sessions, metrics, signal);
+    const readyEvent = await prepareSession(
+      command,
+      { kind: "interactive-only" },
+      config2,
+      directories,
+      audit,
+      sessions,
+      metrics,
+      signal
+    );
     send(socket, {
       ...readyEvent,
       runtimeTimings: metrics.snapshot()
@@ -45796,6 +45889,7 @@ async function executeSessionRestore(socket, command, config2, directories, audi
         sessionId: command.sessionId,
         sessionState: "provisioned"
       },
+      { kind: "history-required" },
       config2,
       directories,
       audit,