zeitlich 0.2.39 → 0.2.41

package/dist/adapters/thread/anthropic/index.d.ts

@@ -2,15 +2,15 @@ import { A as ADAPTER_ID } from '../../../adapter-id-CMwVrVqv.js';
 export { a as AdapterId } from '../../../adapter-id-CMwVrVqv.js';
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-Dt8-HBBT.js';
-import { A as AnthropicContent, a as AnthropicThreadManagerHooks } from '../../../thread-manager-CcRXasqs.js';
-export { b as AnthropicInvocationPayload, c as AnthropicThreadManager, d as AnthropicThreadManagerConfig, S as StoredMessage, e as createAnthropicThreadManager } from '../../../thread-manager-CcRXasqs.js';
-import '@temporalio/common';
+import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-BqTmyH31.js';
+import { A as AnthropicContent, a as AnthropicThreadManagerHooks } from '../../../thread-manager-Dqstsw4i.js';
+export { b as AnthropicInvocationPayload, c as AnthropicThreadManager, d as AnthropicThreadManagerConfig, S as StoredMessage, e as createAnthropicThreadManager } from '../../../thread-manager-Dqstsw4i.js';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
-import '../../../types-DpHTX-iO.js';
+import '@temporalio/common';
+import '../../../types-CjF1_Idx.js';
 
 type AnthropicThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_ID>, AnthropicContent>;
 interface AnthropicAdapterConfig {

package/dist/adapters/thread/anthropic/workflow.d.cts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Bcbiq8iv.cjs';
-import { A as AnthropicContent } from '../../../thread-manager-ClwSaUnj.cjs';
-import { c as createThreadOpsProxy } from '../../../proxy-BAKzNGRq.cjs';
+import { T as ThreadOps } from '../../../types-DjaQKUJx.cjs';
+import { A as AnthropicContent } from '../../../thread-manager-cLhDhRRc.cjs';
+import { c as createThreadOpsProxy } from '../../../proxy-D7mvDEO6.cjs';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-CMwVrVqv.cjs';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.cjs';
+import '@temporalio/common';
 import 'ioredis';
 import '@anthropic-ai/sdk';
-import '../../../types-hFFi-Zd9.cjs';
+import '../../../types-CdvcmXb6.cjs';
 
 /**
  * Workflow-safe proxy for Anthropic thread operations.

package/dist/adapters/thread/anthropic/workflow.d.ts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Dt8-HBBT.js';
-import { A as AnthropicContent } from '../../../thread-manager-CcRXasqs.js';
-import { c as createThreadOpsProxy } from '../../../proxy-DO_MXbY4.js';
+import { T as ThreadOps } from '../../../types-BqTmyH31.js';
+import { A as AnthropicContent } from '../../../thread-manager-Dqstsw4i.js';
+import { c as createThreadOpsProxy } from '../../../proxy-BbcgoXg1.js';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-CMwVrVqv.js';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
+import '@temporalio/common';
 import 'ioredis';
 import '@anthropic-ai/sdk';
-import '../../../types-DpHTX-iO.js';
+import '../../../types-CjF1_Idx.js';
 
 /**
  * Workflow-safe proxy for Anthropic thread operations.

package/dist/adapters/thread/google-genai/index.d.cts

@@ -1,15 +1,15 @@
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-BB-mmrts.cjs';
-import { G as GoogleGenAIThreadManagerHooks } from '../../../activities-ByBFLvm2.cjs';
-export { a as GoogleGenAIAdapter, b as GoogleGenAIAdapterConfig, c as GoogleGenAIContent, d as GoogleGenAIInvocationPayload, e as GoogleGenAIThreadManager, f as GoogleGenAIThreadManagerConfig, g as GoogleGenAIThreadOps, h as GoogleGenAIToolResponse, S as StoredContent, i as createGoogleGenAIAdapter, j as createGoogleGenAIThreadManager } from '../../../activities-ByBFLvm2.cjs';
+import { G as GoogleGenAIThreadManagerHooks } from '../../../activities-qUflxmfS.cjs';
+export { a as GoogleGenAIAdapter, b as GoogleGenAIAdapterConfig, c as GoogleGenAIContent, d as GoogleGenAIInvocationPayload, e as GoogleGenAIThreadManager, f as GoogleGenAIThreadManagerConfig, g as GoogleGenAIThreadOps, h as GoogleGenAIToolResponse, S as StoredContent, i as createGoogleGenAIAdapter, j as createGoogleGenAIThreadManager } from '../../../activities-qUflxmfS.cjs';
 import Redis from 'ioredis';
 import { GoogleGenAI, Content } from '@google/genai';
-import { M as ModelInvokerConfig, A as AgentResponse } from '../../../types-Bcbiq8iv.cjs';
-import '../../../types-hFFi-Zd9.cjs';
-import '@temporalio/common';
+import { M as ModelInvokerConfig, A as AgentResponse } from '../../../types-DjaQKUJx.cjs';
+import '../../../types-CdvcmXb6.cjs';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.cjs';
+import '@temporalio/common';
 
 interface GoogleGenAIModelInvokerConfig {
     redis: Redis;

package/dist/adapters/thread/google-genai/index.d.ts

@@ -1,15 +1,15 @@
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-BB-mmrts.js';
-import { G as GoogleGenAIThreadManagerHooks } from '../../../activities-Bmu7XnaG.js';
-export { a as GoogleGenAIAdapter, b as GoogleGenAIAdapterConfig, c as GoogleGenAIContent, d as GoogleGenAIInvocationPayload, e as GoogleGenAIThreadManager, f as GoogleGenAIThreadManagerConfig, g as GoogleGenAIThreadOps, h as GoogleGenAIToolResponse, S as StoredContent, i as createGoogleGenAIAdapter, j as createGoogleGenAIThreadManager } from '../../../activities-Bmu7XnaG.js';
+import { G as GoogleGenAIThreadManagerHooks } from '../../../activities-D_g13S3y.js';
+export { a as GoogleGenAIAdapter, b as GoogleGenAIAdapterConfig, c as GoogleGenAIContent, d as GoogleGenAIInvocationPayload, e as GoogleGenAIThreadManager, f as GoogleGenAIThreadManagerConfig, g as GoogleGenAIThreadOps, h as GoogleGenAIToolResponse, S as StoredContent, i as createGoogleGenAIAdapter, j as createGoogleGenAIThreadManager } from '../../../activities-D_g13S3y.js';
 import Redis from 'ioredis';
 import { GoogleGenAI, Content } from '@google/genai';
-import { M as ModelInvokerConfig, A as AgentResponse } from '../../../types-Dt8-HBBT.js';
-import '../../../types-DpHTX-iO.js';
-import '@temporalio/common';
+import { M as ModelInvokerConfig, A as AgentResponse } from '../../../types-BqTmyH31.js';
+import '../../../types-CjF1_Idx.js';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
+import '@temporalio/common';
 
 interface GoogleGenAIModelInvokerConfig {
     redis: Redis;

package/dist/adapters/thread/google-genai/workflow.d.cts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Bcbiq8iv.cjs';
-import { c as GoogleGenAIContent } from '../../../activities-ByBFLvm2.cjs';
-import { c as createThreadOpsProxy } from '../../../proxy-BAKzNGRq.cjs';
+import { T as ThreadOps } from '../../../types-DjaQKUJx.cjs';
+import { c as GoogleGenAIContent } from '../../../activities-qUflxmfS.cjs';
+import { c as createThreadOpsProxy } from '../../../proxy-D7mvDEO6.cjs';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-BB-mmrts.cjs';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.cjs';
+import '@temporalio/common';
 import 'ioredis';
 import '@google/genai';
-import '../../../types-hFFi-Zd9.cjs';
+import '../../../types-CdvcmXb6.cjs';
 
 /**
  * Workflow-safe proxy for Google GenAI thread operations.

package/dist/adapters/thread/google-genai/workflow.d.ts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Dt8-HBBT.js';
-import { c as GoogleGenAIContent } from '../../../activities-Bmu7XnaG.js';
-import { c as createThreadOpsProxy } from '../../../proxy-DO_MXbY4.js';
+import { T as ThreadOps } from '../../../types-BqTmyH31.js';
+import { c as GoogleGenAIContent } from '../../../activities-D_g13S3y.js';
+import { c as createThreadOpsProxy } from '../../../proxy-BbcgoXg1.js';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-BB-mmrts.js';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
+import '@temporalio/common';
 import 'ioredis';
 import '@google/genai';
-import '../../../types-DpHTX-iO.js';
+import '../../../types-CjF1_Idx.js';
 
 /**
  * Workflow-safe proxy for Google GenAI thread operations.

package/dist/adapters/thread/langchain/index.d.cts

@@ -2,16 +2,16 @@ import { A as ADAPTER_ID } from '../../../adapter-id-CbY2zeSt.cjs';
 export { a as AdapterId } from '../../../adapter-id-CbY2zeSt.cjs';
 import Redis from 'ioredis';
 import { StoredMessage, MessageContent, BaseMessage } from '@langchain/core/messages';
-import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-Bcbiq8iv.cjs';
+import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-DjaQKUJx.cjs';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-Y8Ucf0Tf.cjs';
-export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-Y8Ucf0Tf.cjs';
-import '@temporalio/common';
+import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-DrWfVjlj.cjs';
+export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-DrWfVjlj.cjs';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.cjs';
-import '../../../types-hFFi-Zd9.cjs';
+import '@temporalio/common';
+import '../../../types-CdvcmXb6.cjs';
 
 type LangChainThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_ID>, LangChainContent>;
 interface LangChainAdapterConfig {

package/dist/adapters/thread/langchain/index.d.ts

@@ -2,16 +2,16 @@ import { A as ADAPTER_ID } from '../../../adapter-id-CbY2zeSt.js';
 export { a as AdapterId } from '../../../adapter-id-CbY2zeSt.js';
 import Redis from 'ioredis';
 import { StoredMessage, MessageContent, BaseMessage } from '@langchain/core/messages';
-import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-Dt8-HBBT.js';
+import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-BqTmyH31.js';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-D-7lp1JK.js';
-export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-D-7lp1JK.js';
-import '@temporalio/common';
+import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-CTXPCu9W.js';
+export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-CTXPCu9W.js';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
-import '../../../types-DpHTX-iO.js';
+import '@temporalio/common';
+import '../../../types-CjF1_Idx.js';
 
 type LangChainThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_ID>, LangChainContent>;
 interface LangChainAdapterConfig {

package/dist/adapters/thread/langchain/workflow.d.cts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Bcbiq8iv.cjs';
-import { L as LangChainContent } from '../../../thread-manager-Y8Ucf0Tf.cjs';
-import { c as createThreadOpsProxy } from '../../../proxy-BAKzNGRq.cjs';
+import { T as ThreadOps } from '../../../types-DjaQKUJx.cjs';
+import { L as LangChainContent } from '../../../thread-manager-DrWfVjlj.cjs';
+import { c as createThreadOpsProxy } from '../../../proxy-D7mvDEO6.cjs';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-CbY2zeSt.cjs';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.cjs';
+import '@temporalio/common';
 import 'ioredis';
 import '@langchain/core/messages';
-import '../../../types-hFFi-Zd9.cjs';
+import '../../../types-CdvcmXb6.cjs';
 
 /**
  * Workflow-safe proxy for LangChain thread operations.

package/dist/adapters/thread/langchain/workflow.d.ts

@@ -1,15 +1,15 @@
 import { ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from '../../../types-Dt8-HBBT.js';
-import { L as LangChainContent } from '../../../thread-manager-D-7lp1JK.js';
-import { c as createThreadOpsProxy } from '../../../proxy-DO_MXbY4.js';
+import { T as ThreadOps } from '../../../types-BqTmyH31.js';
+import { L as LangChainContent } from '../../../thread-manager-CTXPCu9W.js';
+import { c as createThreadOpsProxy } from '../../../proxy-BbcgoXg1.js';
 export { A as ADAPTER_ID, a as AdapterId } from '../../../adapter-id-CbY2zeSt.js';
-import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
 import '../../../types-yx0LzPGn.js';
+import '@temporalio/common';
 import 'ioredis';
 import '@langchain/core/messages';
-import '../../../types-DpHTX-iO.js';
+import '../../../types-CjF1_Idx.js';
 
 /**
  * Workflow-safe proxy for LangChain thread operations.

package/dist/index.cjs

@@ -957,7 +957,6 @@ async function createSession({
   processToolsInParallel = true,
   hooks = {},
   appendSystemPrompt = true,
-  waitForInputTimeout = "48h",
   threadKey,
   sandboxOps,
   thread: threadInit,
@@ -1140,12 +1139,23 @@ async function createSession({
             path,
             size: content.length,
             mtime: (/* @__PURE__ */ new Date()).toISOString(),
-            metadata: {}
+            metadata: {},
+            // Carry the content directly on the entry so any handler that
+            // constructs a VirtualFileSystem from `fileTree` can read it
+            // without needing to also wire up `inlineFiles` from state.
+            inlineContent: content
           }))
         ] : result.fileTree;
         stateManager.mergeUpdate({
           fileTree,
           virtualFsCtx: virtualFsConfig.ctx,
+          // `inlineFiles` is still the source of truth at read time:
+          // VirtualFileSystem checks the inlineFiles map first and only
+          // falls through to entry.inlineContent. Embedding the content on
+          // the entry is the migration target so that handlers building a
+          // VirtualFileSystem from `fileTree` alone (without forwarding
+          // `inlineFiles` from state) can read skill resources. Until a
+          // follow-up drops `inlineFiles`, both fields are populated.
           ...skillFiles && { inlineFiles: skillFiles }
         });
       }
@@ -1271,18 +1281,6 @@ async function createSession({
             continue;
           }
           assistantId = void 0;
-          if (stateManager.getStatus() === "WAITING_FOR_INPUT") {
-            const conditionMet = await workflow.condition(
-              () => stateManager.getStatus() === "RUNNING",
-              waitForInputTimeout
-            );
-            if (!conditionMet) {
-              stateManager.cancel();
-              exitReason = "cancelled";
-              await workflow.condition(() => false, "2s");
-              break;
-            }
-          }
         }
         if (stateManager.getTurns() >= maxTurns && stateManager.isRunning()) {
           exitReason = "max_turns";
@@ -1355,7 +1353,9 @@ async function createSession({
       if (onSessionExit) {
         onSessionExit({
           ...sandboxId && { sandboxId },
-          ...exitSnapshot && { snapshot: exitSnapshot }
+          ...exitSnapshot && { snapshot: exitSnapshot },
+          threadId,
+          usage: stateManager.getTotalUsage()
         });
       }
       return {
@@ -1643,9 +1643,24 @@ function withAutoAppend(threadHandler, handler) {
     };
   };
 }
+var SandboxNotSupportedError = class extends common.ApplicationFailure {
+  constructor(operation) {
+    super(
+      `Sandbox does not support: ${operation}`,
+      "SandboxNotSupportedError",
+      true
+    );
+  }
+};
+var SandboxNotFoundError = class extends common.ApplicationFailure {
+  constructor(sandboxId) {
+    super(`Sandbox not found: ${sandboxId}`, "SandboxNotFoundError", true);
+  }
+};
 
 // src/lib/tool-router/with-sandbox.ts
-function withSandbox(manager, handler) {
+function withSandbox(manager, handler, options) {
+  const translateSandboxNotFound = options?.translateSandboxNotFound ?? false;
   return async (args, context) => {
     if (!context.sandboxId) {
       return {
@@ -1653,7 +1668,18 @@ function withSandbox(manager, handler) {
         data: null
       };
     }
-    const sandbox = await manager.getSandbox(context.sandboxId);
+    let sandbox;
+    try {
+      sandbox = await manager.getSandbox(context.sandboxId);
+    } catch (err) {
+      if (translateSandboxNotFound && err instanceof SandboxNotFoundError) {
+        return {
+          toolResponse: options?.sandboxNotFoundToolResponse ?? `Error: the execution environment for the ${context.toolName} tool is no longer available, so this tool call could not be completed.`,
+          data: null
+        };
+      }
+      throw err;
+    }
     return handler(args, { ...context, sandbox, sandboxId: context.sandboxId });
   };
 }
@@ -1685,6 +1711,7 @@ function defineSubagentWorkflow(config, fn) {
     let capturedSnapshot;
     let capturedBaseSnapshot;
     let capturedThreadId;
+    let capturedUsage;
     const sessionInput = {
       agentName: config.name,
       sandboxShutdown: effectiveShutdown,
@@ -1701,10 +1728,17 @@ function defineSubagentWorkflow(config, fn) {
           });
         }
       },
-      onSessionExit: ({ sandboxId, snapshot, threadId }) => {
+      onSessionExit: ({ sandboxId, snapshot, threadId, usage }) => {
         capturedSandboxId = sandboxId;
         capturedSnapshot = snapshot;
         capturedThreadId = threadId;
+        capturedUsage = {
+          inputTokens: usage.totalInputTokens,
+          outputTokens: usage.totalOutputTokens,
+          cachedWriteTokens: usage.totalCachedWriteTokens,
+          cachedReadTokens: usage.totalCachedReadTokens,
+          reasonTokens: usage.totalReasonTokens
+        };
       }
     };
     const result = await fn(prompt, sessionInput, context ?? {});
@@ -1715,7 +1749,8 @@ function defineSubagentWorkflow(config, fn) {
       ...capturedSnapshot !== void 0 && { snapshot: capturedSnapshot },
       ...capturedBaseSnapshot !== void 0 && {
         baseSnapshot: capturedBaseSnapshot
-      }
+      },
+      ...capturedUsage !== void 0 && { usage: capturedUsage }
     };
   };
   Object.defineProperty(workflow$1, "name", { value: config.name });
@@ -1799,20 +1834,6 @@ function proxyRunAgent(scope, options) {
   );
   return acts[name];
 }
-var SandboxNotSupportedError = class extends common.ApplicationFailure {
-  constructor(operation) {
-    super(
-      `Sandbox does not support: ${operation}`,
-      "SandboxNotSupportedError",
-      true
-    );
-  }
-};
-var SandboxNotFoundError = class extends common.ApplicationFailure {
-  constructor(sandboxId) {
-    super(`Sandbox not found: ${sandboxId}`, "SandboxNotFoundError", true);
-  }
-};
 
 // src/lib/virtual-fs/mutations.ts
 function applyVirtualTreeMutations(stateManager, mutations) {
@@ -2925,7 +2946,7 @@ var VirtualFileSystem = class {
     if (inline !== void 0) return inline;
     const entry = this.entries.get(norm);
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
-    return this.resolver.readFile(entry.id, this.ctx, entry.metadata);
+    return this.readEntryContent(entry);
   }
   async readFileBuffer(path) {
     const norm = normalisePath(path, this.workspaceBase);
@@ -2933,8 +2954,23 @@ var VirtualFileSystem = class {
     if (inline !== void 0) return new TextEncoder().encode(inline);
     const entry = this.entries.get(norm);
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
+    if (entry.inlineContent !== void 0) {
+      return new TextEncoder().encode(entry.inlineContent);
+    }
     return this.resolver.readFileBuffer(entry.id, this.ctx, entry.metadata);
   }
+  /**
+   * Resolve the string content for an entry, preferring inline content
+   * carried on the entry itself before consulting the resolver. Used by
+   * `readFile`, `appendFile`, and `cp` so all read paths agree on the
+   * lookup precedence.
+   */
+  readEntryContent(entry) {
+    if (entry.inlineContent !== void 0) {
+      return Promise.resolve(entry.inlineContent);
+    }
+    return this.resolver.readFile(entry.id, this.ctx, entry.metadata);
+  }
   // --------------------------------------------------------------------------
   // Metadata operations — pure, resolved from the tree
   // --------------------------------------------------------------------------
@@ -3006,6 +3042,11 @@ var VirtualFileSystem = class {
     const norm = normalisePath(path, this.workspaceBase);
     const existing = this.entries.get(norm);
     if (existing) {
+      if (existing.inlineContent !== void 0) {
+        throw new Error(
+          `EROFS: cannot write to inline (read-only) entry: ${path}`
+        );
+      }
       await this.resolver.writeFile(
         existing.id,
         content,
@@ -3034,11 +3075,12 @@ var VirtualFileSystem = class {
     if (!existing) {
       return this.writeFile(path, content);
     }
-    const current = await this.resolver.readFile(
-      existing.id,
-      this.ctx,
-      existing.metadata
-    );
+    if (existing.inlineContent !== void 0) {
+      throw new Error(
+        `EROFS: cannot append to inline (read-only) entry: ${path}`
+      );
+    }
+    const current = await this.readEntryContent(existing);
     const appended = typeof content === "string" ? current + content : current + new TextDecoder().decode(content);
     await this.resolver.writeFile(
       existing.id,
@@ -3073,6 +3115,11 @@ var VirtualFileSystem = class {
     const norm = normalisePath(path, this.workspaceBase);
     const entry = this.entries.get(norm);
     if (entry) {
+      if (entry.inlineContent !== void 0) {
+        throw new Error(
+          `EROFS: cannot remove inline (read-only) entry: ${path}`
+        );
+      }
       await this.resolver.deleteFile(entry.id, this.ctx, entry.metadata);
       this.entries.delete(norm);
       this.mutations.push({ type: "remove", path: norm });
@@ -3085,6 +3132,11 @@ var VirtualFileSystem = class {
       const prefix = norm === "/" ? "/" : norm + "/";
       for (const [p, e] of this.entries) {
         if (p.startsWith(prefix)) {
+          if (e.inlineContent !== void 0) {
+            throw new Error(
+              `EROFS: cannot remove inline (read-only) entry: ${p}`
+            );
+          }
           await this.resolver.deleteFile(e.id, this.ctx, e.metadata);
           this.entries.delete(p);
           this.mutations.push({ type: "remove", path: p });
@@ -3105,11 +3157,7 @@ var VirtualFileSystem = class {
     const normDest = normalisePath(dest, this.workspaceBase);
     const entry = this.entries.get(normSrc);
     if (entry) {
-      const content = await this.resolver.readFile(
-        entry.id,
-        this.ctx,
-        entry.metadata
-      );
+      const content = await this.readEntryContent(entry);
       await this.writeFile(normDest, content);
       return;
     }
@@ -3123,11 +3171,7 @@ var VirtualFileSystem = class {
     for (const [p, e] of this.entries) {
       if (p.startsWith(prefix)) {
         const relative = p.slice(normSrc.length);
-        const content = await this.resolver.readFile(
-          e.id,
-          this.ctx,
-          e.metadata
-        );
+        const content = await this.readEntryContent(e);
         await this.writeFile(normDest + relative, content);
       }
     }