veryfront 0.1.644 → 0.1.646

package/esm/src/react/components/chat/chat/utils/message-parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-parts.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/utils/message-parts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAED,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,IAAI,YAAY,GAAG,mBAAmB,CAG5F;AAQD,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,GAAG,OAAO,CAEjF;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,GACpB,IAAI,IAAI;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,CAE3E;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,CAkDvE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAiC1E"}
+{"version":3,"file":"message-parts.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/utils/message-parts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAED,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,IAAI,YAAY,GAAG,mBAAmB,CAG5F;AAQD,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,GAAG,OAAO,CAEjF;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,GACpB,IAAI,IAAI;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,CAE3E;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,CAkDvE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAiC1E"}

package/esm/src/react/components/chat/chat/utils/message-parts.js

@@ -18,11 +18,11 @@ export function isToolPart(part) {
     return part.type.startsWith("tool-") && part.type !== "tool-result";
 }
 const SKILL_TOOL_NAMES = new Set([
-    "load-skill",
-    "load-skill-reference",
-    "execute-skill-script",
+    "load_skill",
+    "load_skill_reference",
+    "execute_skill_script",
 ]);
-/** Check if a tool part is a skill-related tool (load-skill, load-skill-reference, execute-skill-script) */
+/** Check if a tool part is a skill-related tool. */
 export function isSkillToolPart(tool) {
     return SKILL_TOOL_NAMES.has(tool.toolName);
 }

package/esm/src/rendering/orchestrator/module-loader/index.d.ts

@@ -21,6 +21,13 @@ export interface ModuleLoaderConfig {
     /** React version for transforms (from project config) */
     reactVersion?: string;
 }
+/**
+ * Detect a dynamic `import()` failure caused by a module file that is missing on
+ * disk (e.g. a stale/evicted cached page module). Matches Node/Deno's
+ * `ERR_MODULE_NOT_FOUND` as well as the "Cannot find module" / "Module not found"
+ * message variants the runtimes surface for a missing `import()` target.
+ */
+export declare function isMissingModuleError(error: unknown): boolean;
 /**
  * Load a module by path, transforming it and its dependencies.
  *

package/esm/src/rendering/orchestrator/module-loader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA2BzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkJpE,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,UAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CAsSjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqClC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA4BzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkJpE,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,UAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CAsSjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6DlC"}

package/esm/src/rendering/orchestrator/module-loader/index.js

@@ -18,7 +18,7 @@ import { validateCachedBundlesByManifestOrCode } from "../../../transforms/esm/c
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../utils/cache-dir.js";
 import { dirname, join, normalize } from "../../../platform/compat/path/index.js";
 import { hashCodeHex } from "../../../utils/hash-utils.js";
-import { getModulePathCache, lookupMdxEsmCache, saveModulePathCache, } from "../../../transforms/mdx/esm-module-loader/cache/index.js";
+import { getModulePathCache, invalidateMdxEsmModule, lookupMdxEsmCache, saveModulePathCache, } from "../../../transforms/mdx/esm-module-loader/cache/index.js";
 import { buildMdxEsmPathCacheKey } from "../../../transforms/mdx/esm-module-loader/cache-format.js";
 const logger = rendererLogger.component("module-loader");
 // Re-export utilities
@@ -363,6 +363,19 @@ async function getModuleCacheDir(config) {
     }
     return getProjectTmpDir(projectId ?? projectDir);
 }
+/**
+ * Detect a dynamic `import()` failure caused by a module file that is missing on
+ * disk (e.g. a stale/evicted cached page module). Matches Node/Deno's
+ * `ERR_MODULE_NOT_FOUND` as well as the "Cannot find module" / "Module not found"
+ * message variants the runtimes surface for a missing `import()` target.
+ */
+export function isMissingModuleError(error) {
+    if (!(error instanceof Error))
+        return false;
+    if (error.code === "ERR_MODULE_NOT_FOUND")
+        return true;
+    return /cannot find module|module not found/i.test(error.message);
+}
 /**
  * Load a module by path, transforming it and its dependencies.
  *
@@ -395,6 +408,25 @@ export async function loadModule(filePath, config) {
                 return await import(`file://${tempFilePath}?t=${Date.now()}&retry=1`);
             }
         }
+        // Self-heal: the cached module artifact resolved to a path that no longer
+        // exists on disk (evicted, or rebuilt under a different content hash by a
+        // racing write). Rather than hard-failing the whole page render (#2077),
+        // treat it as a cache miss: drop the stale cache pointers so we don't get
+        // handed the same dead path, rebuild the module from source, and retry the
+        // import once. Skip HTTP-bundle misses, which have dedicated recovery above.
+        if (!bundleMatch && isMissingModuleError(error)) {
+            logger.warn("Cached module missing on disk, rebuilding and retrying import", {
+                filePath,
+                tempFilePath,
+            });
+            config.moduleCache.delete(getModuleCacheKey(filePath, config.projectId, config.projectDir, config.contentSourceId));
+            // tmpDir is the exact cache dir this module was registered under, so the
+            // invalidation stays scoped to this tenant (the path-cache key is not
+            // project-scoped — see invalidateMdxEsmModule).
+            invalidateMdxEsmModule(tmpDir, filePath, config.projectDir, config.reactVersion);
+            const rebuiltPath = await transformModuleWithDeps(filePath, tmpDir, localAdapter, config);
+            return await import(`file://${rebuiltPath}?t=${Date.now()}&rebuilt=1`);
+        }
         logger.error("Failed to import module:", {
             filePath,
             tempFilePath,

package/esm/src/server/handlers/dev/framework-candidates.generated.js

@@ -2934,9 +2934,8 @@ export const FRAMEWORK_CANDIDATES = [
     "etc.,",
     "event:",
     "event?.preventDefault()}",
-    "execute-skill-script",
-    "execute-skill-script)",
-    "execute-skill-script).",
+    "execute_skill_script",
+    "execute_skill_script).",
     "exist",
     "expected:",
     "export",
@@ -3607,16 +3606,16 @@ export const FRAMEWORK_CANDIDATES = [
     "listboxId",
     "load():",
     "load();",
-    "load-skill",
-    "load-skill,",
-    "load-skill-reference",
-    "load-skill-reference,",
     "loadIndex(key:",
     "loadIndex(storageKey);",
     "loadMermaid():",
     "loadMermaid();",
     "loadThread(key:",
     "loadThread(storageKey,",
+    "load_skill",
+    "load_skill,",
+    "load_skill_reference",
+    "load_skill_reference,",
     "loaded.length",
     "loaded.push(thread);",
     "loaded.sort((a,",
@@ -5338,6 +5337,7 @@ export const FRAMEWORK_CANDIDATES = [
     "tool-primitives.tsx",
     "tool-result",
     "tool-search",
+    "tool.",
     "tool.error",
     "tool.errorText}",
     "tool.error}",

package/esm/src/server/handlers/request/agent-stream.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-stream.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/agent-stream.handler.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,4BAA4B,EAE7B,MAAM,2CAA2C,CAAC;AAwBnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnG,MAAM,WAAW,sBACf,SAAQ,yBAAyB,EAAE,+BAA+B;IAClE,4BAA4B,CAAC,EAAE,OAAO,4BAA4B,CAAC;CACpE;AAyQD,qBAAa,kBAAmB,SAAQ,WAAW;IASrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,QAAQ,EAAE,eAAe,CAMvB;gBAE2B,IAAI,GAAE,sBAAoC;IAIvE,OAAO,CAAC,sBAAsB;IAwBxB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAiKxE"}
+{"version":3,"file":"agent-stream.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/agent-stream.handler.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,4BAA4B,EAE7B,MAAM,2CAA2C,CAAC;AAwBnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnG,MAAM,WAAW,sBACf,SAAQ,yBAAyB,EAAE,+BAA+B;IAClE,4BAA4B,CAAC,EAAE,OAAO,4BAA4B,CAAC;CACpE;AA2SD,qBAAa,kBAAmB,SAAQ,WAAW;IASrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,QAAQ,EAAE,eAAe,CAMvB;gBAE2B,IAAI,GAAE,sBAAoC;IAIvE,OAAO,CAAC,sBAAsB;IAwBxB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAiKxE"}

package/esm/src/server/handlers/request/agent-stream.handler.js

@@ -73,6 +73,28 @@ function mergeAllowedRemoteTools(current, requestedToolNames) {
     }
     return [...allowed].sort();
 }
+function getVeryfrontApiMcpPolicy(agent) {
+    const requestedToolNames = new Set();
+    const deniedToolNames = new Set();
+    let allowAll = false;
+    for (const server of agent.config.mcpServers ?? []) {
+        if (!("kind" in server) || server.kind !== "veryfront-api") {
+            continue;
+        }
+        for (const toolName of server.toolPolicy?.deny ?? []) {
+            deniedToolNames.add(toolName);
+        }
+        if (server.toolPolicy?.allow) {
+            for (const toolName of server.toolPolicy.allow) {
+                requestedToolNames.add(toolName);
+            }
+        }
+        else {
+            allowAll = true;
+        }
+    }
+    return { allowAll, requestedToolNames: [...requestedToolNames], deniedToolNames };
+}
 function hasVeryfrontPlatformRemoteToolSource(remoteTools) {
     return remoteTools?.some((source) => source.id === VERYFRONT_PLATFORM_REMOTE_TOOL_SOURCE_ID) ??
         false;
@@ -85,11 +107,12 @@ function createStaticRemoteToolSource(source, toolDefinitions) {
     };
 }
 async function withVeryfrontPlatformRemoteTools(input) {
+    const veryfrontApiMcpPolicy = getVeryfrontApiMcpPolicy(input.agent);
     const requestedToolNames = getRequestedUnresolvedBooleanToolNames({
         agent: input.agent,
         availableToolNames: input.availableToolNames,
-    });
-    if (requestedToolNames.length === 0 || !input.token) {
+    }).concat(veryfrontApiMcpPolicy.requestedToolNames);
+    if ((!veryfrontApiMcpPolicy.allowAll && requestedToolNames.length === 0) || !input.token) {
         return input.agent;
     }
     const apiUrl = getHostEnv("VERYFRONT_API_URL") ?? "https://api.veryfront.com";
@@ -114,24 +137,26 @@ async function withVeryfrontPlatformRemoteTools(input) {
         ? new Set(platformToolDefinitions.map((tool) => tool.name))
         : null;
     const requestedPlatformToolNames = platformToolNames
-        ? requestedToolNames.filter((toolName) => platformToolNames.has(toolName))
-        : requestedToolNames;
+        ? (veryfrontApiMcpPolicy.allowAll ? [...platformToolNames] : requestedToolNames).filter((toolName) => platformToolNames.has(toolName) && !veryfrontApiMcpPolicy.deniedToolNames.has(toolName))
+        : requestedToolNames.filter((toolName) => !veryfrontApiMcpPolicy.deniedToolNames.has(toolName));
     if (requestedPlatformToolNames.length === 0) {
         return input.agent;
     }
-    const remoteTools = input.agent.config.remoteTools ?? [];
+    const runtimeRemoteToolConfig = input.agent.config;
+    const remoteTools = runtimeRemoteToolConfig.__vfRemoteToolSources ?? [];
     const platformRemoteToolSources = hasVeryfrontPlatformRemoteToolSource(remoteTools) ? [] : [
         platformToolDefinitions
             ? createStaticRemoteToolSource(platformRemoteToolSource, platformToolDefinitions)
             : platformRemoteToolSource,
     ];
+    const runtimeConfig = {
+        ...input.agent.config,
+        __vfAllowedRemoteTools: mergeAllowedRemoteTools(runtimeRemoteToolConfig.__vfAllowedRemoteTools, requestedPlatformToolNames),
+        __vfRemoteToolSources: [...remoteTools, ...platformRemoteToolSources],
+    };
     return {
         ...input.agent,
-        config: {
-            ...input.agent.config,
-            allowedRemoteTools: mergeAllowedRemoteTools(input.agent.config.allowedRemoteTools, requestedPlatformToolNames),
-            remoteTools: [...remoteTools, ...platformRemoteToolSources],
-        },
+        config: runtimeConfig,
     };
 }
 function buildAgentStreamEnv(input) {

package/esm/src/skill/prompt-augmentation.d.ts

@@ -10,7 +10,7 @@ import type { Skill } from "./types.js";
  * Build the skill manifest prompt section for an agent's system prompt.
  *
  * Lists all available skills with their descriptions and instructions
- * on how to use the skill tools (load-skill, load-skill-reference, execute-skill-script).
+ * on how to use the skill tools (load_skill, load_skill_reference, execute_skill_script).
  *
  * @param skills - Map of resolved skills for the agent
  * @returns Prompt section string, or empty string if no skills

package/esm/src/skill/prompt-augmentation.js

@@ -9,7 +9,7 @@
  * Build the skill manifest prompt section for an agent's system prompt.
  *
  * Lists all available skills with their descriptions and instructions
- * on how to use the skill tools (load-skill, load-skill-reference, execute-skill-script).
+ * on how to use the skill tools (load_skill, load_skill_reference, execute_skill_script).
  *
  * @param skills - Map of resolved skills for the agent
  * @returns Prompt section string, or empty string if no skills
@@ -20,7 +20,7 @@ export function buildSkillManifestPrompt(skills) {
     const lines = [
         "## Available Skills",
         "",
-        "You have access to skills via tool calling. IMPORTANT: You MUST call the load-skill tool (not write it as text) to activate a skill before performing skill-related tasks.",
+        "You have access to skills via tool calling. IMPORTANT: You MUST call the load_skill tool (not write it as text) to activate a skill before performing skill-related tasks.",
         "",
     ];
     for (const [id, skill] of skills) {
@@ -29,8 +29,8 @@ export function buildSkillManifestPrompt(skills) {
     lines.push("");
     lines.push("### Skill Tools (call these as tools, never write them as text)");
     lines.push("");
-    lines.push("- load-skill: Call with { skillId } to load a skill's full instructions and available references/resources/scripts");
-    lines.push("- load-skill-reference: Call with { skillId, reference } to read a file from the skill's references/, resources/, or assets/ directory");
-    lines.push("- execute-skill-script: Call with { skillId, script, args?, env?, timeoutMs? } to execute a script");
+    lines.push("- load_skill: Call with { skillId } to load a skill's full instructions and available references/resources/scripts");
+    lines.push("- load_skill_reference: Call with { skillId, reference } to read a file from the skill's references/, resources/, or assets/ directory");
+    lines.push("- execute_skill_script: Call with { skillId, script, args?, env?, timeoutMs? } to execute a script");
     return lines.join("\n");
 }

package/esm/src/skill/tools.d.ts

@@ -2,25 +2,25 @@
  * Skill Tools
  *
  * Three tools exposed to agents for interacting with skills:
- * - load-skill: Load a skill's full instructions
- * - load-skill-reference: Read a reference file from a skill
- * - execute-skill-script: Execute a script from a skill
+ * - load_skill: Load a skill's full instructions
+ * - load_skill_reference: Read a reference file from a skill
+ * - execute_skill_script: Execute a script from a skill
  *
  * @module
  */
 import type { Tool } from "../tool/index.js";
 /**
- * Create the load-skill tool.
+ * Create the load_skill tool.
  * Loads a skill's full instructions, available references, and scripts.
  */
 export declare function createLoadSkillTool(): Tool;
 /**
- * Create the load-skill-reference tool.
+ * Create the load_skill_reference tool.
  * Reads a reference file from a skill's references/, resources/, or assets/ directory.
  */
 export declare function createLoadSkillReferenceTool(): Tool;
 /**
- * Create the execute-skill-script tool.
+ * Create the execute_skill_script tool.
  * Executes a script from a skill's scripts/ directory.
  */
 export declare function createExecuteSkillScriptTool(): Tool;

package/esm/src/skill/tools.js

@@ -2,9 +2,9 @@
  * Skill Tools
  *
  * Three tools exposed to agents for interacting with skills:
- * - load-skill: Load a skill's full instructions
- * - load-skill-reference: Read a reference file from a skill
- * - execute-skill-script: Execute a script from a skill
+ * - load_skill: Load a skill's full instructions
+ * - load_skill_reference: Read a reference file from a skill
+ * - execute_skill_script: Execute a script from a skill
  *
  * @module
  */
@@ -52,23 +52,23 @@ async function readSkillFile(skill, path) {
 }
 function buildSkillAvailabilityNote(references, scripts) {
     if (scripts.length === 0 && references.length === 0) {
-        return "This skill has no scripts or reference files. Do NOT call execute-skill-script or load-skill-reference.";
+        return "This skill has no scripts or reference files. Do NOT call execute_skill_script or load_skill_reference.";
     }
     if (scripts.length === 0) {
-        return "This skill has no scripts. Do NOT call execute-skill-script.";
+        return "This skill has no scripts. Do NOT call execute_skill_script.";
     }
     if (references.length === 0) {
-        return "This skill has no reference files. Do NOT call load-skill-reference.";
+        return "This skill has no reference files. Do NOT call load_skill_reference.";
     }
     return undefined;
 }
 /**
- * Create the load-skill tool.
+ * Create the load_skill tool.
  * Loads a skill's full instructions, available references, and scripts.
  */
 export function createLoadSkillTool() {
     return tool({
-        id: "load-skill",
+        id: "load_skill",
         description: "Load a skill's full instructions. Returns the skill's markdown instructions, " +
             "allowed tools policy, and lists of available reference files and scripts.",
         inputSchema: getLoadSkillInputSchema(),
@@ -86,7 +86,7 @@ export function createLoadSkillTool() {
             const content = await readSkillFile(skill, skillMdPath);
             // Parse frontmatter to get instructions
             const parsed = await parseSkillFrontmatter(content);
-            // List available files the agent can load through load-skill-reference.
+            // List available files the agent can load through load_skill_reference.
             const [references, resources, scripts] = await Promise.all([
                 listSkillSubdir(skill.rootPath, SKILL_REFERENCES_DIR, skill.fsAdapter),
                 listSkillSubdir(skill.rootPath, SKILL_RESOURCES_DIR, skill.fsAdapter),
@@ -105,12 +105,12 @@ export function createLoadSkillTool() {
     });
 }
 /**
- * Create the load-skill-reference tool.
+ * Create the load_skill_reference tool.
  * Reads a reference file from a skill's references/, resources/, or assets/ directory.
  */
 export function createLoadSkillReferenceTool() {
     return tool({
-        id: "load-skill-reference",
+        id: "load_skill_reference",
         description: "Read a reference file from a skill. Only files in the skill's " +
             "references/, resources/, and assets/ directories are accessible.",
         inputSchema: getLoadSkillReferenceInputSchema(),
@@ -130,12 +130,12 @@ export function createLoadSkillReferenceTool() {
     });
 }
 /**
- * Create the execute-skill-script tool.
+ * Create the execute_skill_script tool.
  * Executes a script from a skill's scripts/ directory.
  */
 export function createExecuteSkillScriptTool() {
     return tool({
-        id: "execute-skill-script",
+        id: "execute_skill_script",
         description: "Execute a script from a skill's scripts/ directory. Returns stdout, stderr, and exit code.",
         inputSchema: getExecuteSkillScriptInputSchema(),
         execute: async (input) => {

package/esm/src/skill/types.d.ts

@@ -37,7 +37,7 @@ export interface SkillMetadata {
     /** Arbitrary key-value metadata */
     metadata?: Record<string, string>;
 }
-/** Full skill content returned by load-skill tool */
+/** Full skill content returned by load_skill tool */
 export interface SkillContent {
     /** Markdown instructions (body after frontmatter) */
     instructions: string;

package/esm/src/skill/types.js

@@ -17,9 +17,9 @@ export const SKILL_DESCRIPTION_MAX_LENGTH = 1024;
 export const SKILL_MD_FILENAME = "SKILL.md";
 /** Tool IDs that belong to the skill system (single source of truth) */
 export const SKILL_TOOL_IDS = new Set([
-    "load-skill",
-    "load-skill-reference",
-    "execute-skill-script",
+    "load_skill",
+    "load_skill_reference",
+    "execute_skill_script",
 ]);
 /** Conventional subdirectory names */
 export const SKILL_SCRIPTS_DIR = "scripts";

package/esm/src/transforms/mdx/esm-module-loader/cache/index.d.ts

@@ -24,6 +24,29 @@ export declare function clearModulePathCache(): void;
 /** Await any in-flight disk cleanup (for testing only). */
 export declare function waitForDiskCleanup(): Promise<void>;
 export declare function invalidateModulePaths(changedPaths: string[]): void;
+/**
+ * Invalidate the cached module path for a single source file in a single cache dir.
+ *
+ * Unlike {@link invalidateModulePaths} (driven by the file watcher on source
+ * edits, which also deletes the stale `.mjs` from disk), this is a targeted,
+ * synchronous self-heal for the case where a cached module artifact has already
+ * gone missing on disk — evicted, or rebuilt under a different content hash by a
+ * racing write — while the in-memory path cache and its verified-deps fast-path
+ * still point at the stale path. Clearing both forces the next
+ * {@link lookupMdxEsmCache} to report a miss so the module is rebuilt instead of
+ * handing back a path whose `import()` fails with ERR_MODULE_NOT_FOUND (#2077).
+ *
+ * `cacheDir` MUST be the dir that produced the missing path. The path-cache key
+ * is scoped only by React version + relative module path (not project/source),
+ * so two tenants that both have e.g. `app/page.tsx` share the same key in their
+ * separate cache dirs — scanning every dir would evict another tenant's valid
+ * entry, so the invalidation is confined to the failing dir.
+ *
+ * The deletion is also persisted to `_index.json` (fire-and-forget, chained onto
+ * the shared disk-cleanup queue like {@link invalidateModulePaths}) so the stale
+ * pointer does not resurrect from disk on the next process start.
+ */
+export declare function invalidateMdxEsmModule(cacheDir: string, filePath: string, projectDir?: string, reactVersion?: string): void;
 export declare function clearESMDiskCache(): Promise<void>;
 export declare function clearHttpBundleCache(): Promise<void>;
 /**

package/esm/src/transforms/mdx/esm-module-loader/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAI5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AA2HH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAmBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,oDAAoD;AAC3E,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAwH5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAI5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AA2HH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAuBD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,GACnC,IAAI,CAgBN;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAmBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,oDAAoD;AAC3E,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAmJ5B"}

package/esm/src/transforms/mdx/esm-module-loader/cache/index.js

@@ -184,6 +184,27 @@ let _pendingDiskCleanup = Promise.resolve();
 export function waitForDiskCleanup() {
     return _pendingDiskCleanup;
 }
+/**
+ * Persist the given cache dirs' `_index.json` fire-and-forget, chained onto the
+ * shared disk-cleanup queue so concurrent invalidations don't clobber each
+ * other. Used after an in-memory eviction so the stale pointer does not
+ * resurrect from disk on the next process start — callers that drop an entry
+ * (e.g. an SSR-only path) may never re-register and re-save it themselves.
+ */
+function queueIndexPersist(cacheDirs) {
+    if (cacheDirs.length === 0)
+        return;
+    const cleanup = async () => {
+        for (const cacheDir of cacheDirs) {
+            await saveModulePathCache(cacheDir);
+        }
+    };
+    _pendingDiskCleanup = _pendingDiskCleanup.then(cleanup, cleanup).catch((error) => {
+        logger.warn(`${LOG_PREFIX_MDX_LOADER} Failed to persist _index.json`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    });
+}
 export function invalidateModulePaths(changedPaths) {
     if (modulePathCaches.size === 0)
         return;
@@ -250,6 +271,44 @@ export function invalidateModulePaths(changedPaths) {
         });
     });
 }
+/**
+ * Invalidate the cached module path for a single source file in a single cache dir.
+ *
+ * Unlike {@link invalidateModulePaths} (driven by the file watcher on source
+ * edits, which also deletes the stale `.mjs` from disk), this is a targeted,
+ * synchronous self-heal for the case where a cached module artifact has already
+ * gone missing on disk — evicted, or rebuilt under a different content hash by a
+ * racing write — while the in-memory path cache and its verified-deps fast-path
+ * still point at the stale path. Clearing both forces the next
+ * {@link lookupMdxEsmCache} to report a miss so the module is rebuilt instead of
+ * handing back a path whose `import()` fails with ERR_MODULE_NOT_FOUND (#2077).
+ *
+ * `cacheDir` MUST be the dir that produced the missing path. The path-cache key
+ * is scoped only by React version + relative module path (not project/source),
+ * so two tenants that both have e.g. `app/page.tsx` share the same key in their
+ * separate cache dirs — scanning every dir would evict another tenant's valid
+ * entry, so the invalidation is confined to the failing dir.
+ *
+ * The deletion is also persisted to `_index.json` (fire-and-forget, chained onto
+ * the shared disk-cleanup queue like {@link invalidateModulePaths}) so the stale
+ * pointer does not resurrect from disk on the next process start.
+ */
+export function invalidateMdxEsmModule(cacheDir, filePath, projectDir, reactVersion = REACT_DEFAULT_VERSION) {
+    const cache = modulePathCaches.get(cacheDir);
+    if (!cache)
+        return;
+    const cacheKey = toMdxEsmCacheKey(filePath, projectDir, reactVersion);
+    const cachedPath = cache.get(cacheKey);
+    if (cachedPath === undefined)
+        return;
+    cache.delete(cacheKey);
+    verifiedModuleDeps.delete(`${cachedPath}:${cacheKey}`);
+    logger.debug(`${LOG_PREFIX_MDX_LOADER} Self-heal invalidated missing module`, {
+        filePath,
+        cachedPath,
+    });
+    queueIndexPersist([cacheDir]);
+}
 function extractNormalizedCachedModulePath(cachedKey) {
     const normalizedPath = cachedKey.match(/(?:^|:)(_vf_modules\/[^:]+)$/)?.[1] ?? cachedKey;
     return normalizedPath.replace(/^_vf_modules\//, "").replace(/\.js$/, "");
@@ -312,8 +371,32 @@ recoveryOptions, reactVersion = REACT_DEFAULT_VERSION) {
         return { status: "miss" };
     const verifyKey = `${cachedPath}:${cacheKey}`;
     if (verifiedModuleDeps.get(verifyKey)) {
-        logger.debug(`${LOG_PREFIX_MDX_LOADER} SSR reusing MDX-ESM cache (verified): ${filePath} -> ${cachedPath}`);
-        return { status: "hit", path: cachedPath };
+        // Fast-path: skip the expensive read + content scans for already-verified
+        // modules, but still confirm the artifact is present on disk. A cached module
+        // can be evicted or rebuilt under a different content hash out from under us
+        // (disk-cache eviction, or a racing rebuild) without going through
+        // invalidateModulePaths — which is the only thing that clears this marker.
+        // Returning the stale path here makes the SSR loader import() a file that no
+        // longer exists and hard-fail the whole page render (#2077), so a single stat
+        // (far cheaper than the read + regex scans below) guards correctness.
+        try {
+            const stat = await getLocalFs().stat(cachedPath);
+            if (stat?.isFile) {
+                logger.debug(`${LOG_PREFIX_MDX_LOADER} SSR reusing MDX-ESM cache (verified): ${filePath} -> ${cachedPath}`);
+                return { status: "hit", path: cachedPath };
+            }
+        }
+        catch (_) {
+            /* expected: verified artifact was evicted/rebuilt; fall through to invalidate */
+        }
+        // Artifact is gone — drop the stale markers so the caller rebuilds it, and
+        // persist the deletion so it can't resurrect from _index.json on restart
+        // (an SSR-only caller may never re-register and re-save this entry itself).
+        logger.debug(`${LOG_PREFIX_MDX_LOADER} Verified MDX-ESM artifact missing on disk, invalidating`, { filePath, cachedPath });
+        verifiedModuleDeps.delete(verifyKey);
+        cache.delete(cacheKey);
+        queueIndexPersist([cacheDir]);
+        return { status: "miss" };
     }
     try {
         const stat = await getLocalFs().stat(cachedPath);

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.644";
+export declare const VERSION = "0.1.646";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.644";
+export const VERSION = "0.1.646";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.644",
+  "version": "0.1.646",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",