veryfront 0.1.1101 → 0.1.1103

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1101",
+    "version": "0.1.1103",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/agent/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/agent/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,YAAY,CAAC;AAqFpB,oBAAoB;AACpB,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAwNhD;AAcD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC,GACnD,eAAe,EAAE,CAanB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/agent/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,YAAY,CAAC;AAsFpB,oBAAoB;AACpB,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAyNhD;AAcD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC,GACnD,eAAe,EAAE,CAanB"}

package/esm/src/agent/factory.js

@@ -13,6 +13,7 @@ import { createError, toError } from "../errors/index.js";
 import { COMMON_BLOCKED_PATTERNS, securityMiddleware } from "./middleware/security/validator.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { resolveConfiguredAgentModel } from "./runtime/model-resolution.js";
+import { setEffectiveAgentSystem } from "./runtime/effective-agent-system.js";
 import { defineSchema } from "../schemas/index.js";
 import { getMessageSchema } from "./schemas/agent.schema.js";
 import { isRequestBodyTooLargeError, readBodyWithLimit, } from "../security/input-validation/limits.js";
@@ -204,6 +205,7 @@ export function agent(config) {
             return runtime.clearMemory();
         },
     };
+    setEffectiveAgentSystem(agentInstance, augmentedSystem);
     agentRegistry.register(id, agentInstance);
     return agentInstance;
 }

package/esm/src/agent/hosted/cloud-runtime-system-messages.d.ts

@@ -11,6 +11,11 @@ export type CreateVeryfrontCloudRuntimeSystemMessagesInput = {
     branchId?: string | null;
     environmentContext?: string;
 };
+/** Builds the shared project-context prompt block (project reference + branch). */
+export declare function buildProjectContextPromptBlock(input: {
+    projectId: string;
+    branchId?: string | null;
+}): string;
 /** Create Veryfront Cloud runtime system messages. */
 export declare function createVeryfrontCloudRuntimeSystemMessages(input: CreateVeryfrontCloudRuntimeSystemMessagesInput): ChatSystemMessage[];
 /** Builds Veryfront Cloud runtime instructions. */

package/esm/src/agent/hosted/cloud-runtime-system-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-runtime-system-messages.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/cloud-runtime-system-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,wEAAwE;AACxE,MAAM,MAAM,8CAA8C,GAAG;IAC3D,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAyBF,sDAAsD;AACtD,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,8CAA8C,GACpD,iBAAiB,EAAE,CAsBrB;AAED,mDAAmD;AACnD,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,kCAAkC,CAAC,8BAA8B,CAAC,GACxE,iBAAiB,EAAE,CASrB"}
+{"version":3,"file":"cloud-runtime-system-messages.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/cloud-runtime-system-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,wEAAwE;AACxE,MAAM,MAAM,8CAA8C,GAAG;IAC3D,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AASF,mFAAmF;AACnF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACrD,MAAM,CAcR;AAED,sDAAsD;AACtD,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,8CAA8C,GACpD,iBAAiB,EAAE,CAsBrB;AAED,mDAAmD;AACnD,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,kCAAkC,CAAC,8BAA8B,CAAC,GACxE,iBAAiB,EAAE,CASrB"}

package/esm/src/agent/hosted/cloud-runtime-system-messages.js

@@ -6,7 +6,8 @@ function createProjectInstructionsBlock(instructions) {
         content: `CRITICAL: You MUST follow these project-specific guidelines:\n\n${instructions}`,
     });
 }
-function createProjectContextBlock(input) {
+/** Builds the shared project-context prompt block (project reference + branch). */
+export function buildProjectContextPromptBlock(input) {
     const branchLine = input.branchId
         ? `branch_id: "${input.branchId}"`
         : "branch_id: main (no branch_id needed for file operations)";
@@ -27,7 +28,7 @@ export function createVeryfrontCloudRuntimeSystemMessages(input) {
         runtimeBlocks.push(createProjectInstructionsBlock(input.instructions));
     }
     if (input.projectId) {
-        runtimeBlocks.push(createProjectContextBlock({
+        runtimeBlocks.push(buildProjectContextPromptBlock({
             projectId: input.projectId,
             branchId: input.branchId,
         }));

package/esm/src/agent/runtime/agent-invocation-contract.d.ts

@@ -397,6 +397,7 @@ export type RuntimeAgentControlPlaneStreamRequest = {
     messages: RuntimeAgentRunInvocation["messages"];
     tools: RuntimeAgentRunInvocation["tools"];
     context: RuntimeAgentRunInvocation["context"];
+    runtimeTargetBranchId?: RuntimeAgentProjectContext["runtimeTargetBranchId"];
     credentials?: RuntimeAgentRunInvocation["credentials"];
     agentSource: RuntimeAgentRunInvocation["agentSource"];
     agentConfig?: RuntimeAgentRunInvocation["agentConfig"];

package/esm/src/agent/runtime/agent-invocation-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-invocation-contract.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-invocation-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-invocation-contract.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-invocation-contract.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/runtime/agent-invocation-contract.js

@@ -246,6 +246,7 @@ export function buildRuntimeAgentControlPlaneStreamRequestFromInvocation(input)
         messages: input.messages,
         tools: input.tools,
         context: input.context,
+        runtimeTargetBranchId: input.run.project.runtimeTargetBranchId ?? null,
         ...(input.credentials ? { credentials: input.credentials } : {}),
         agentSource: input.agentSource,
         ...(input.agentConfig ? { agentConfig: input.agentConfig } : {}),

package/esm/src/agent/runtime/effective-agent-system.d.ts

@@ -0,0 +1,8 @@
+import type { Agent } from "../types.js";
+type AgentSystem = Agent["config"]["system"];
+/** Records the system resolver used by an agent's private runtime. */
+export declare function setEffectiveAgentSystem(agent: Agent, system: AgentSystem): void;
+/** Returns the effective runtime system resolver, including through config-preserving wrappers. */
+export declare function getEffectiveAgentSystem(agent: Agent): AgentSystem;
+export {};
+//# sourceMappingURL=effective-agent-system.d.ts.map

package/esm/src/agent/runtime/effective-agent-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-agent-system.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/effective-agent-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,KAAK,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;AAU7C,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAE/E;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAEjE"}

package/esm/src/agent/runtime/effective-agent-system.js

@@ -0,0 +1,9 @@
+const EFFECTIVE_AGENT_SYSTEM = Symbol("veryfront.effectiveAgentSystem");
+/** Records the system resolver used by an agent's private runtime. */
+export function setEffectiveAgentSystem(agent, system) {
+    agent.config[EFFECTIVE_AGENT_SYSTEM] = system;
+}
+/** Returns the effective runtime system resolver, including through config-preserving wrappers. */
+export function getEffectiveAgentSystem(agent) {
+    return agent.config[EFFECTIVE_AGENT_SYSTEM] ?? agent.config.system;
+}

package/esm/src/data/helpers.d.ts

@@ -1,7 +1,18 @@
 import type { DataResult } from "./types.js";
-/** Return a redirect result from a data loader. */
+/**
+ * Redirect the request from a data loader.
+ *
+ * Return it or throw it. `throw redirect("/login")` behaves exactly like
+ * `return redirect("/login")`.
+ */
 export declare function redirect(destination: string, permanent?: boolean): DataResult;
-/** Return a 404 result from a data loader. */
+/**
+ * Render the 404 page from a data loader.
+ *
+ * Return it or throw it. `throw notFound()` behaves exactly like
+ * `return notFound()`, which is useful deep inside a helper that has no clean
+ * way to return to the loader.
+ */
 export declare function notFound(): DataResult;
 /**
  * True when `value` is a control-flow result produced by {@link notFound} or
@@ -11,8 +22,14 @@ export declare function notFound(): DataResult;
  * naturally and is what people coming from other frameworks reach for. Thrown,
  * the plain object is not an `Error`, so the SSR error handler stringified it
  * to `[object Object]` and returned a 500 instead of the intended 404 or
- * redirect. Recognising the shape lets a thrown result behave like a returned
+ * redirect. Recognising the brand lets a thrown result behave like a returned
  * one.
+ *
+ * The check is on the brand, never on the shape. A loader that does
+ * `throw await response.json()` against an upstream answering
+ * `{ notFound: true, message: "record locked" }` is reporting a failure, and
+ * reading that as a 404 would render the wrong page, log nothing, and cache a
+ * 404 the site never asked for.
  */
 export declare function isDataControlResult(value: unknown): value is DataResult;
 /**

package/esm/src/data/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/src/data/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,UAAU,CAE3E;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,IAAI,UAAU,CAErC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAUvE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAGlE"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/src/data/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2B7C;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,UAAU,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,UAAU,CAErC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIvE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAGlE"}

package/esm/src/data/helpers.js

@@ -1,10 +1,44 @@
-/** Return a redirect result from a data loader. */
+/**
+ * Brand marking an object as produced by {@link notFound} or {@link redirect}.
+ *
+ * A registered symbol, so a result built by one copy of this module is
+ * recognised by another. Project code and the framework do not always share a
+ * module instance, and isolated data fetching crosses a realm boundary.
+ *
+ * Symbols are dropped by `structuredClone`, so the brand does not survive
+ * `postMessage`. Worker-side code normalises a thrown control result before it
+ * is posted back, while the object is still in-realm.
+ */
+const DATA_CONTROL_RESULT = Symbol.for("veryfront.dataControlResult");
+/**
+ * Mark a result as framework-produced control flow.
+ *
+ * The brand is non-enumerable, so it stays out of `Object.keys`,
+ * `JSON.stringify`, and the `DataResult` schema. A returned control result
+ * behaves exactly as it did before the brand existed.
+ */
+function brandDataControlResult(result) {
+    Object.defineProperty(result, DATA_CONTROL_RESULT, { value: true });
+    return result;
+}
+/**
+ * Redirect the request from a data loader.
+ *
+ * Return it or throw it. `throw redirect("/login")` behaves exactly like
+ * `return redirect("/login")`.
+ */
 export function redirect(destination, permanent = false) {
-    return { redirect: { destination, permanent } };
+    return brandDataControlResult({ redirect: { destination, permanent } });
 }
-/** Return a 404 result from a data loader. */
+/**
+ * Render the 404 page from a data loader.
+ *
+ * Return it or throw it. `throw notFound()` behaves exactly like
+ * `return notFound()`, which is useful deep inside a helper that has no clean
+ * way to return to the loader.
+ */
 export function notFound() {
-    return { notFound: true };
+    return brandDataControlResult({ notFound: true });
 }
 /**
  * True when `value` is a control-flow result produced by {@link notFound} or
@@ -14,19 +48,19 @@ export function notFound() {
  * naturally and is what people coming from other frameworks reach for. Thrown,
  * the plain object is not an `Error`, so the SSR error handler stringified it
  * to `[object Object]` and returned a 500 instead of the intended 404 or
- * redirect. Recognising the shape lets a thrown result behave like a returned
+ * redirect. Recognising the brand lets a thrown result behave like a returned
  * one.
+ *
+ * The check is on the brand, never on the shape. A loader that does
+ * `throw await response.json()` against an upstream answering
+ * `{ notFound: true, message: "record locked" }` is reporting a failure, and
+ * reading that as a 404 would render the wrong page, log nothing, and cache a
+ * 404 the site never asked for.
  */
 export function isDataControlResult(value) {
     if (value === null || typeof value !== "object")
         return false;
-    if (value instanceof Error)
-        return false;
-    const candidate = value;
-    if (candidate.notFound === true)
-        return true;
-    const destination = candidate.redirect?.destination;
-    return typeof destination === "string";
+    return value[DATA_CONTROL_RESULT] === true;
 }
 /**
  * Reduce a thrown control result to the shape a returned one produces.

package/esm/src/data/static-data-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-data-fetcher.d.ts","sourceRoot":"","sources":["../../../src/src/data/static-data-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2DxE,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,YAAY;IAFhC,OAAO,CAAC,oBAAoB,CAAoC;gBAE5C,YAAY,EAAE,YAAY;IAExC,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA4ChF,OAAO,CAAC,uBAAuB;YAMjB,iBAAiB;IAuB/B,OAAO,CAAC,eAAe;YAQT,iBAAiB;YA+BjB,UAAU;YAqEV,sBAAsB;IAoEpC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAIjB"}
+{"version":3,"file":"static-data-fetcher.d.ts","sourceRoot":"","sources":["../../../src/src/data/static-data-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2DxE,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,YAAY;IAFhC,OAAO,CAAC,oBAAoB,CAAoC;gBAE5C,YAAY,EAAE,YAAY;IAExC,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA4ChF,OAAO,CAAC,uBAAuB;YAMjB,iBAAiB;IAuB/B,OAAO,CAAC,eAAe;YAQT,iBAAiB;YA+BjB,UAAU;YAqEV,sBAAsB;IAuFpC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAIjB"}

package/esm/src/data/static-data-fetcher.js

@@ -188,6 +188,21 @@ export class StaticDataFetcher {
                 const start = performance.now();
                 try {
                     const result = await this.executeStaticData(getStaticData, context, REVALIDATION_TIMEOUT_MS, `getStaticData revalidation for ${pathname}`);
+                    // A background revalidation refreshes a page that is already being
+                    // served. A notFound or redirect is not a refreshed page, so keep
+                    // the entry that is live and let the next revalidation try again.
+                    // Storing it would serve a 404 for the previously healthy page, and
+                    // a control result carries no revalidate interval, so the entry
+                    // would never revalidate again either.
+                    if (result.notFound || result.redirect) {
+                        serverLogger.warn("DATA_REVALIDATION_CONTROL_RESULT background revalidation returned a control result, keeping the cached entry", {
+                            pathname,
+                            durationMs: Math.round(performance.now() - start),
+                            cacheKey,
+                            control: result.notFound ? "notFound" : "redirect",
+                        });
+                        return;
+                    }
                     this.storeCacheEntry(cacheKey, result);
                 }
                 catch (error) {

package/esm/src/html/hydration-script-builder/templates/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../src/src/html/hydration-script-builder/templates/renderer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,cA4R7B,CAAC"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../src/src/html/hydration-script-builder/templates/renderer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,cAoT7B,CAAC"}

package/esm/src/html/hydration-script-builder/templates/renderer.js

@@ -3,17 +3,59 @@ export const getRendererScript = () => `
 
     // True when a dynamic import failed because the module could not be
     // fetched (404 / network), as opposed to being fetched and then failing to
-    // link or evaluate. Browsers report the former as a TypeError with a
-    // "dynamically imported module" message; link failures are SyntaxErrors and
-    // evaluation failures are whatever the module threw.
+    // link or evaluate. Browsers word this as a TypeError naming the dynamic
+    // import itself; link failures are SyntaxErrors and evaluation failures are
+    // whatever the module threw. The wording is matched against the dynamic
+    // import phrases only, so app code throwing "Failed to load user profile"
+    // at module scope is not mistaken for a missing module.
     function isModuleNotFoundError(error) {
       if (!error) return false;
       if (error instanceof SyntaxError) return false;
       const message = String((error && error.message) || error);
-      return /(?:Failed to fetch|error loading|Importing a module script failed|Failed to load)/i
+      return /(?:dynamically imported module|Importing a module script failed|Failed to load module script)/i
         .test(message);
     }
 
+    // Picks the error that describes the failure best. An error that proves a
+    // module was reached (link or evaluation) always beats one that only proves
+    // a URL could not be fetched, because a 404 on a path that was never
+    // expected to exist explains nothing. Otherwise the earlier error wins: it
+    // names the module the router actually intended to load.
+    function preferReachedModuleError(earlier, later) {
+      if (!earlier) return later;
+      if (!later) return earlier;
+      if (isModuleNotFoundError(earlier) && !isModuleNotFoundError(later)) return later;
+      return earlier;
+    }
+
+    // Loads a Pages Router page, retrying at <route>/index.js because both
+    // pages/about.tsx and pages/about/index.tsx are valid sources for the same
+    // route. The retry is unconditional: gating it on the wording of the
+    // first rejection turned any unrecognized wording into a blank page. Error
+    // selection, not the retry, is what must stay precise.
+    async function loadPageModuleWithIndexFallback(
+      basePath,
+      pageSlug,
+      pageModuleError,
+      importModule,
+    ) {
+      try {
+        return await importModule(basePath + '.js');
+      } catch (error) {
+        const routeError = preferReachedModuleError(pageModuleError, error);
+
+        // An index slug already resolves to <route>/index.js, so the retry
+        // would ask for <route>/index/index.js.
+        if (pageSlug === 'index' || pageSlug.endsWith('/index')) throw routeError;
+
+        try {
+          return await importModule(basePath + '/index.js');
+        } catch (indexError) {
+          throw preferReachedModuleError(routeError, indexError);
+        }
+      }
+    }
+
     async function renderPage(pathname) {
       const resolvedPathname = (() => {
         const input = typeof pathname === 'string' ? pathname : window.location.pathname;
@@ -128,30 +170,12 @@ export const getRendererScript = () => `
           const prefix = pageSlug.startsWith('@/') ? '' : '/pages';
           const basePath = MODULE_SERVER_URL + prefix + '/' + pageSlug;
 
-          try {
-            pageModule = await import(basePath + '.js');
-          } catch (error) {
-            pageModuleError = pageModuleError || error;
-
-            // Only retry at <route>/index.js when the module genuinely could not
-            // be found. If it was found but failed to link or evaluate, retrying
-            // a path that does not exist replaces a precise error ("does not
-            // provide an export named 'createHash'") with a misleading 404.
-            const canRetryAsIndex = isModuleNotFoundError(error) &&
-              pageSlug !== 'index' && !pageSlug.endsWith('/index');
-
-            if (!canRetryAsIndex) throw pageModuleError;
-
-            try {
-              pageModule = await import(basePath + '/index.js');
-            } catch (indexError) {
-              // For a real <route>/index.tsx page, the first 404 was expected
-              // and this retry is the path that matters: if it reached a module
-              // and failed to link or evaluate, its error is the real one. Only
-              // when the retry 404s as well does the original describe more.
-              throw isModuleNotFoundError(indexError) ? pageModuleError : indexError;
-            }
-          }
+          pageModule = await loadPageModuleWithIndexFallback(
+            basePath,
+            pageSlug,
+            pageModuleError,
+            (moduleUrl) => import(moduleUrl),
+          );
         }
 
         if (!pageModule) {

package/esm/src/internal-agents/run-stream.d.ts

@@ -9,6 +9,7 @@ export interface RuntimeAgentStreamExecutionDeps {
     projectAgentSandbox?: {
         apiUrl?: string;
         authToken?: string;
+        branchId?: string | null;
         projectId?: string | null;
         sandboxEndpoint?: string;
     };

package/esm/src/internal-agents/run-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,IAAI,OAAO,EAC5B,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAY3B,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAGL,KAAK,IAAI,EAGV,MAAM,kBAAkB,CAAC;AAe1B,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAsCxD,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;IAC5C,mBAAmB,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,cAAc,CAAC,EAAE,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;IACnE,8BAA8B,CAAC,EAAE,CAC/B,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAClC;QACH,MAAM,EAAE,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;SAC9C,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,WAAW,KACtB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH;AAoCD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,sBAAsB,EACtC,2BAA2B,CAAC,EAAE,MAAM,EAAE,EACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;;cAsFrD;AA6VD,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,QAAQ,CAAC,CA2anB"}
+{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,IAAI,OAAO,EAC5B,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAc3B,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAGL,KAAK,IAAI,EAGV,MAAM,kBAAkB,CAAC;AAe1B,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAsCxD,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;IAC5C,mBAAmB,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,cAAc,CAAC,EAAE,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;IACnE,8BAA8B,CAAC,EAAE,CAC/B,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAClC;QACH,MAAM,EAAE,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;SAC9C,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,WAAW,KACtB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH;AAoCD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,sBAAsB,EACtC,2BAA2B,CAAC,EAAE,MAAM,EAAE,EACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;;cAsFrD;AAoXD,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,QAAQ,CAAC,CAqdnB"}

package/esm/src/internal-agents/run-stream.js

@@ -3,6 +3,8 @@ import { normalizeAgUiRuntimeMessages } from "../agent/ag-ui/runtime-support.js"
 import { compactForStep, estimateOverhead } from "../chat/message-prep.js";
 import { getRuntimeRemoteToolSources, } from "../agent/runtime/mcp-server-tool-sources.js";
 import { buildRuntimeUsageTraceAttributes } from "../agent/runtime/trace-usage.js";
+import { getProviderNativeToolNames } from "../agent/runtime/provider-native-tool-inventory.js";
+import { selectProviderCompatibleToolNames } from "../agent/runtime/provider-tool-compat.js";
 import { convertAgentRuntimeMessagesToProviderMessages, convertProviderMessagesToAgentRuntimeMessages, } from "../agent/runtime/message-adapter.js";
 import { createAgentServiceSandboxTools } from "../sandbox/index.js";
 import { tryResolve } from "../extensions/contracts.js";
@@ -15,6 +17,7 @@ import { addSpanEvent, setSpanAttributes, withSpan, } from "../observability/tra
 import { defineSchema, lazySchema } from "../schemas/index.js";
 import { createStreamTransformState, finalizeRunEvents, formatAgUiEvent, mapRuntimeEventToAgUi, parseSseJsonEvents, } from "./ag-ui-sse.js";
 import { AgentRunCancelledError } from "./session-manager.js";
+import { createInternalAgentRunSystemPromptResolver } from "./run-system-prompt.js";
 import { serverLogger } from "../utils/index.js";
 const getAnyObjectSchema = defineSchema((v) => v.record(v.string(), v.unknown()));
 const anyObjectSchema = lazySchema(getAnyObjectSchema);
@@ -303,6 +306,23 @@ function applyRuntimeToolAllowlist(mergedTools, toolAllowlist, agent) {
     }
     return Object.fromEntries(Object.entries(mergedTools).filter(([toolName]) => allowedToolNames.has(toolName)));
 }
+function getRequiredLocalToolNames(input) {
+    if (!input.mergedTools || input.mergedTools === true) {
+        return [];
+    }
+    return Object.entries(input.mergedTools)
+        .filter(([toolName, entry]) => {
+        if (entry && typeof entry === "object") {
+            return true;
+        }
+        if (Object.hasOwn(input.availableLocalTools, toolName)) {
+            return true;
+        }
+        const registryTool = toolRegistry.get(toolName);
+        return Boolean(registryTool && isToolVisibleTo(registryTool, { agentId: input.agent.id }));
+    })
+        .map(([toolName]) => toolName);
+}
 function getServerResolvedProjectToolNames(forwardedProps) {
     const runtimeOverrides = isRecord(forwardedProps?.runtimeOverrides)
         ? forwardedProps.runtimeOverrides
@@ -430,10 +450,43 @@ export async function createRuntimeAgentStreamResponse(input, agent, deps) {
     const cappedProviderTools = runtimeToolAllowlist !== null && Array.isArray(agent.config.providerTools)
         ? agent.config.providerTools.filter((toolName) => typeof toolName === "string" && runtimeToolAllowlist.has(toolName))
         : undefined;
+    const effectiveProviderToolNames = cappedProviderTools ??
+        (Array.isArray(agent.config.providerTools)
+            ? agent.config.providerTools.filter((toolName) => typeof toolName === "string")
+            : []);
+    const modelSupportedProviderToolNames = new Set(getProviderNativeToolNames({ model: agent.config.model }));
+    const providerToolNames = effectiveProviderToolNames.filter((toolName) => modelSupportedProviderToolNames.has(toolName));
+    const mergedToolNames = mergedTools && mergedTools !== true ? Object.keys(mergedTools) : [];
+    const allowedRemoteToolNameSet = new Set(allowedRemoteToolNames ?? []);
+    const forwardedToolNames = (forwardedIntegrationToolDefs?.map((def) => def.name) ?? [])
+        .filter((toolName) => allowedRemoteToolNameSet.has(toolName));
+    const localToolNames = getRequiredLocalToolNames({
+        mergedTools,
+        availableLocalTools,
+        agent,
+    });
+    const runtimeToolNames = selectProviderCompatibleToolNames([
+        ...new Set([
+            ...mergedToolNames,
+            ...providerToolNames,
+            ...(allowedRemoteToolNames ?? []),
+            ...forwardedToolNames,
+        ]),
+    ].sort(), {
+        model: agent.config.model,
+        requiredToolNames: localToolNames,
+    });
     const runtimeAgent = {
         ...agent,
         config: {
             ...agent.config,
+            system: createInternalAgentRunSystemPromptResolver({
+                agent,
+                runInput: input,
+                projectId: deps.projectAgentSandbox?.projectId ?? null,
+                branchId: deps.projectAgentSandbox?.branchId,
+                toolNames: runtimeToolNames,
+            }),
             tools: mergedTools,
             ...(cappedProviderTools !== undefined ? { providerTools: cappedProviderTools } : {}),
             ...(allowedRemoteToolNames !== undefined

package/esm/src/internal-agents/run-system-prompt.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Internal Agent Run System Prompt
+ *
+ * Composes the system prompt for project-runtime agent runs, mirroring the
+ * hosted chat runtime's instruction assembly. Before this, internal runs used
+ * the agent's authored instructions verbatim, so request-scoped agents (e.g.
+ * Studio-created project agents) never learned the project reference, branch,
+ * Studio environment context, or effective tool surface of the run they were
+ * executing in and asked users for values the harness already knew.
+ *
+ * The composed prompt extends the agent's resolved base instructions (which
+ * already include the factory's skill manifest for skill-enabled agents) with:
+ * - the shared project-context block (project reference + branch)
+ * - the requested model
+ * - the caller-supplied environment context (`studio_context` context item)
+ * - the effective run tool inventory
+ *
+ * @module
+ */
+import type { Agent } from "../agent/index.js";
+import type { RuntimeRunAgentInput } from "./schema.js";
+/** Caller-supplied run context extracted from the `studio_context` item. */
+export type InternalAgentStudioRunContext = {
+    environmentContext?: string;
+    projectId?: string;
+    branchId?: string | null;
+};
+/** Extracts the Studio-supplied run context from run context items. */
+export declare function getInternalAgentStudioRunContext(context: RuntimeRunAgentInput["context"]): InternalAgentStudioRunContext;
+/** Input payload for compose internal agent run system prompt. */
+export type ComposeInternalAgentRunSystemPromptInput = {
+    agent: Agent;
+    runInput: RuntimeRunAgentInput;
+    projectId?: string | null;
+    branchId?: string | null;
+    toolNames: readonly string[];
+};
+/** Composes the internal agent run system prompt. */
+export declare function composeInternalAgentRunSystemPrompt(input: ComposeInternalAgentRunSystemPromptInput): Promise<string>;
+/** Creates a lazy system prompt resolver for an internal agent run. */
+export declare function createInternalAgentRunSystemPromptResolver(input: ComposeInternalAgentRunSystemPromptInput): () => Promise<string>;
+//# sourceMappingURL=run-system-prompt.d.ts.map

package/esm/src/internal-agents/run-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-system-prompt.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/run-system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAU/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAKxD,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAqBF,uEAAuE;AACvE,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACvC,6BAA6B,CAmB/B;AAYD,kEAAkE;AAClE,MAAM,MAAM,wCAAwC,GAAG;IACrD,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,qDAAqD;AACrD,wBAAsB,mCAAmC,CACvD,KAAK,EAAE,wCAAwC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED,uEAAuE;AACvE,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,wCAAwC,GAC9C,MAAM,OAAO,CAAC,MAAM,CAAC,CAEvB"}