@agent-native/core 0.90.3 → 0.90.5

package/corpus/templates/design/app/components/design/bridge/editor-chrome.bridge.ts

@@ -604,6 +604,32 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
     return styles;
   }
 
+  var liveVisualEditOriginalInlineStyles =
+    typeof WeakMap !== "undefined"
+      ? new WeakMap<Element, Record<string, string>>()
+      : null;
+
+  function rememberLiveVisualEditOriginalStyles(el: Element | null): void {
+    if (!el || !liveVisualEditOriginalInlineStyles) return;
+    if (liveVisualEditOriginalInlineStyles.has(el)) return;
+    liveVisualEditOriginalInlineStyles.set(el, collectInlineStyles(el));
+  }
+
+  function originalInlineStylesForPatch(
+    el: Element | null,
+    styles: Record<string, string>,
+  ): Record<string, string> {
+    if (!el || !liveVisualEditOriginalInlineStyles) return {};
+    rememberLiveVisualEditOriginalStyles(el);
+    var original = liveVisualEditOriginalInlineStyles.get(el) || {};
+    var patch: Record<string, string> = {};
+    Object.keys(styles).forEach(function (property) {
+      patch[property] =
+        typeof original[property] === "string" ? original[property] : "";
+    });
+    return patch;
+  }
+
   function chromeColorForElement(el: Element | null): string {
     return elementLooksLikeComponent(el)
       ? "var(--design-editor-component-color)"
@@ -946,6 +972,7 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
   }
 
   function postElementSelect(el: Element, e?: MouseEvent): void {
+    rememberLiveVisualEditOriginalStyles(el);
     var message: {
       type: string;
       payload: unknown;
@@ -4455,6 +4482,7 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
         type: "visual-style-change",
         selector: getSelector(selectedEl),
         styles: styles,
+        originalStyles: originalInlineStylesForPatch(selectedEl, styles),
         payload: getElementInfo(selectedEl),
       },
       "*",
@@ -4647,13 +4675,17 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
     setActiveDragCancel(cancelSpacingDrag);
   }
 
-  function postTextContentChange(el, value, html) {
+  function postTextContentChange(el, value, html, originalValue, originalHtml) {
     (window.parent as Window).postMessage(
       {
         type: "text-content-change",
         selector: getSelector(el),
         value: value,
         html: html,
+        originalValue:
+          typeof originalValue === "string" ? originalValue : undefined,
+        originalHtml:
+          typeof originalHtml === "string" ? originalHtml : undefined,
         payload: getElementInfo(el),
       },
       "*",
@@ -5126,15 +5158,17 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
     el.style.display = "flex";
     el.style.flexDirection = inferred.direction;
     el.style.gap = inferred.gap + "px";
+    var styles = {
+      display: "flex",
+      "flex-direction": inferred.direction,
+      gap: inferred.gap + "px",
+    };
     (window.parent as Window).postMessage(
       {
         type: "visual-style-change",
         selector: getSelector(container),
-        styles: {
-          display: "flex",
-          "flex-direction": inferred.direction,
-          gap: inferred.gap + "px",
-        },
+        styles: styles,
+        originalStyles: originalInlineStylesForPatch(container, styles),
         payload: getElementInfo(container),
       },
       "*",
@@ -5223,11 +5257,13 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
       if (!containerBackgroundIsLight(container)) return;
     }
     el.style.color = "inherit";
+    var styles = { color: "inherit" };
     (window.parent as Window).postMessage(
       {
         type: "visual-style-change",
         selector: getSelector(member),
-        styles: { color: "inherit" },
+        styles: styles,
+        originalStyles: originalInlineStylesForPatch(member, styles),
         payload: getElementInfo(member),
       },
       "*",
@@ -6590,15 +6626,17 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
         // order — the host composes them against its synchronous same-tick
         // content refs exactly like multi-property style commits.
         memberStates.forEach(function (state) {
+          var styles = {
+            position: state.el.style.position,
+            left: state.el.style.left,
+            top: state.el.style.top,
+          };
           (window.parent as Window).postMessage(
             {
               type: "visual-style-change",
               selector: getSelector(state.el),
-              styles: {
-                position: state.el.style.position,
-                left: state.el.style.left,
-                top: state.el.style.top,
-              },
+              styles: styles,
+              originalStyles: originalInlineStylesForPatch(state.el, styles),
               payload: getElementInfo(state.el),
             },
             "*",
@@ -6832,6 +6870,7 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
           type: "visual-style-change",
           selector: getSelector(resizeEl),
           styles: styles,
+          originalStyles: originalInlineStylesForPatch(resizeEl, styles),
           payload: getElementInfo(resizeEl),
         },
         "*",
@@ -6902,11 +6941,13 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
       cleanupRotateDrag();
       hideTransformBadge();
       if (!rotateEl) return;
+      var styles = { transform: rotateEl.style.transform };
       (window.parent as Window).postMessage(
         {
           type: "visual-style-change",
           selector: getSelector(rotateEl),
-          styles: { transform: rotateEl.style.transform },
+          styles: styles,
+          originalStyles: originalInlineStylesForPatch(rotateEl, styles),
           payload: getElementInfo(rotateEl),
         },
         "*",
@@ -7461,7 +7502,13 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
       var nextHtml = target.innerHTML || "";
       refreshOverlays();
       if (next !== originalText || nextHtml !== originalHtml) {
-        postTextContentChange(target, next, nextHtml);
+        postTextContentChange(
+          target,
+          next,
+          nextHtml,
+          originalText,
+          originalHtml,
+        );
       }
       // T13: replay the latest runtime-content update that arrived (and was
       // buffered) while this edit session was active, so the canvas isn't
@@ -7905,6 +7952,15 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
       cancelActiveBridgeDrag();
       return;
     }
+    if (e.data.type === "agent-native:reset-live-visual-edit-baselines") {
+      if (liveVisualEditOriginalInlineStyles) {
+        liveVisualEditOriginalInlineStyles = new WeakMap<
+          Element,
+          Record<string, string>
+        >();
+      }
+      return;
+    }
     if (e.data.type === "clear-selection") {
       // During marquee drag, empty hit sets are replayed back from the host as a
       // clear-selection state. Keep the drag-owned rectangle alive until pointer-up.
@@ -8168,6 +8224,23 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
       removeRuntimeTarget(e.data.selector, e.data.selectorCandidates);
       return;
     }
+    if (e.data.type === "set-text-content") {
+      var textTarget = findRuntimeTarget(
+        String(e.data.selector || ""),
+        Array.isArray(e.data.selectorCandidates)
+          ? e.data.selectorCandidates
+          : [],
+      ) as HTMLElement | null;
+      if (!textTarget) return;
+      if (typeof e.data.html === "string") {
+        textTarget.innerHTML = e.data.html;
+      } else {
+        textTarget.textContent =
+          typeof e.data.value === "string" ? e.data.value : "";
+      }
+      refreshOverlays();
+      return;
+    }
     if (e.data.type !== "style-change") return;
     var sel = e.data.selector;
     var prop = e.data.property;
@@ -8211,6 +8284,8 @@ declare var __DESIGN_CANVAS_BOARD_SURFACE__: boolean;
         activeTextEditEl,
         activeTextEditEl!.textContent || "",
         activeTextEditEl!.innerHTML || "",
+        undefined,
+        undefined,
       );
       refreshOverlays();
       return;

package/corpus/templates/design/app/components/design/bridge-security.ts

@@ -3,12 +3,18 @@ export function isTrustedCanvasBridgeMessage({
   origin,
   iframeWindow,
   parentOrigin,
+  allowedOrigins = [],
 }: {
   source: MessageEventSource | null;
   origin: string;
   iframeWindow: Window | null | undefined;
   parentOrigin: string;
+  allowedOrigins?: string[];
 }): boolean {
   if (!iframeWindow || source !== iframeWindow) return false;
-  return origin === parentOrigin || origin === "null";
+  return (
+    origin === parentOrigin ||
+    origin === "null" ||
+    allowedOrigins.includes(origin)
+  );
 }

package/corpus/templates/design/app/components/design/multi-screen/types.ts

@@ -334,7 +334,7 @@ export interface MultiScreenCanvasProps {
       sourceRect?: { x: number; y: number; width: number; height: number };
       anchorRect?: { x: number; y: number; width: number; height: number };
     },
-  ) => boolean | void;
+  ) => boolean | "pending" | void;
   /**
    * Called when a style property changes on a board element.
    * Target file is boardFileId.

package/corpus/templates/design/app/i18n/zh-TW.ts

@@ -600,9 +600,12 @@ const messages = {
       previewLabel: "待處理的視覺預覽",
       applyWithAgent: "用 Design 代理套用",
       copyPrompt: "將提示複製給您的代理",
+      abortPreview: "放棄預覽並進入互動",
       agentMessage: "將待處理的視覺樣式編輯套用到來源。",
       sentToast: "樣式編輯已傳送給 Design 代理",
       copiedToast: "樣式提示已複製",
+      abortedToast: "已捨棄待處理的預覽",
+      interactBlocked: "切換到互動前，請先套用或放棄待處理的即時編輯。",
       leaveTitle: "離開前要套用樣式嗎？",
       leaveDescriptionOne:
         "即時預覽中有 {{count}} 個待處理的視覺樣式編輯。現在離開會捨棄該未套用的樣式變更。",

package/corpus/templates/design/app/i18n-data.ts

@@ -618,9 +618,13 @@ const enUS = {
       previewLabel: "Pending visual preview",
       applyWithAgent: "Apply with Design agent",
       copyPrompt: "Copy prompt to your agent",
+      abortPreview: "Abort preview and interact",
       agentMessage: "Apply the pending visual style edits to the source.",
       sentToast: "Style edits sent to the Design agent",
       copiedToast: "Style prompt copied",
+      abortedToast: "Pending preview discarded",
+      interactBlocked:
+        "Apply or abort pending live edits before switching to Interact.",
       leaveTitle: "Apply styles before leaving?",
       leaveDescriptionOne:
         "You have {{count}} pending visual style edit in the live preview. Leaving now will discard that unapplied style change.",
@@ -9786,9 +9790,12 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "待處理的視覺預覽",
         applyWithAgent: "用 Design 代理套用",
         copyPrompt: "將提示複製給您的代理",
+        abortPreview: "中止預覽並互動",
         agentMessage: "將待處理的視覺樣式編輯套用到來源。",
         sentToast: "樣式編輯已傳送給 Design 代理",
         copiedToast: "樣式提示已複製",
+        abortedToast: "待處理的預覽已捨棄",
+        interactBlocked: "請先套用或中止待處理的即時編輯，再切換到互動模式。",
         leaveTitle: "離開前要套用樣式嗎？",
         leaveDescriptionOne:
           "即時預覽中有 {{count}} 個待處理的視覺樣式編輯。現在離開會捨棄該未套用的樣式變更。",
@@ -9807,9 +9814,12 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "待处理的视觉预览",
         applyWithAgent: "用 Design 代理应用",
         copyPrompt: "将提示复制给你的代理",
+        abortPreview: "中止预览并互动",
         agentMessage: "将待处理的视觉样式编辑应用到源文件。",
         sentToast: "样式编辑已发送给 Design 代理",
         copiedToast: "样式提示已复制",
+        abortedToast: "待处理的预览已丢弃",
+        interactBlocked: "请先应用或中止待处理的实时编辑，再切换到互动模式。",
         leaveTitle: "离开前应用样式？",
         leaveDescriptionOne:
           "实时预览中有 {{count}} 个待处理的视觉样式编辑。现在离开会丢弃这个未应用的样式更改。",
@@ -9828,10 +9838,14 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "Vista previa visual pendiente",
         applyWithAgent: "Aplicar con el agente de Design",
         copyPrompt: "Copiar prompt a tu agente",
+        abortPreview: "Cancelar vista previa e interactuar",
         agentMessage:
           "Aplica las ediciones visuales de estilo pendientes al código fuente.",
         sentToast: "Ediciones de estilo enviadas al agente de Design",
         copiedToast: "Prompt de estilo copiado",
+        abortedToast: "Vista previa pendiente descartada",
+        interactBlocked:
+          "Aplica o cancela las ediciones en vivo pendientes antes de cambiar a Interactuar.",
         leaveTitle: "¿Aplicar estilos antes de salir?",
         leaveDescriptionOne:
           "Tienes {{count}} edición visual de estilo pendiente en la vista previa en vivo. Si sales ahora, se descartará ese cambio de estilo sin aplicar.",
@@ -9850,10 +9864,14 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "Aperçu visuel en attente",
         applyWithAgent: "Appliquer avec l’agent Design",
         copyPrompt: "Copier le prompt vers votre agent",
+        abortPreview: "Annuler l’aperçu et interagir",
         agentMessage:
           "Appliquez les modifications visuelles de style en attente à la source.",
         sentToast: "Modifications de style envoyées à l’agent Design",
         copiedToast: "Prompt de style copié",
+        abortedToast: "Aperçu en attente supprimé",
+        interactBlocked:
+          "Appliquez ou annulez les modifications en direct en attente avant de passer à Interagir.",
         leaveTitle: "Appliquer les styles avant de quitter ?",
         leaveDescriptionOne:
           "Vous avez {{count}} modification visuelle de style en attente dans l’aperçu en direct. Quitter maintenant supprimera cette modification non appliquée.",
@@ -9872,10 +9890,14 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "Ausstehende visuelle Vorschau",
         applyWithAgent: "Mit Design-Agent anwenden",
         copyPrompt: "Prompt an deinen Agent kopieren",
+        abortPreview: "Vorschau abbrechen und interagieren",
         agentMessage:
           "Wende die ausstehenden visuellen Stiländerungen auf die Quelle an.",
         sentToast: "Stiländerungen an den Design-Agent gesendet",
         copiedToast: "Stil-Prompt kopiert",
+        abortedToast: "Ausstehende Vorschau verworfen",
+        interactBlocked:
+          "Wende ausstehende Live-Änderungen an oder brich sie ab, bevor du zu Interagieren wechselst.",
         leaveTitle: "Stile vor dem Verlassen anwenden?",
         leaveDescriptionOne:
           "In der Live-Vorschau gibt es {{count}} ausstehende visuelle Stiländerung. Wenn du jetzt gehst, wird diese nicht angewendete Stiländerung verworfen.",
@@ -9894,10 +9916,14 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "保留中のビジュアルプレビュー",
         applyWithAgent: "Design エージェントで適用",
         copyPrompt: "エージェントにプロンプトをコピー",
+        abortPreview: "プレビューを中止して操作",
         agentMessage:
           "保留中のビジュアルスタイル編集をソースに適用してください。",
         sentToast: "スタイル編集を Design エージェントに送信しました",
         copiedToast: "スタイルプロンプトをコピーしました",
+        abortedToast: "保留中のプレビューを破棄しました",
+        interactBlocked:
+          "操作モードに切り替える前に、保留中のライブ編集を適用するか中止してください。",
         leaveTitle: "離れる前にスタイルを適用しますか？",
         leaveDescriptionOne:
           "ライブプレビューに {{count}} 件の保留中のビジュアルスタイル編集があります。今離れると、未適用のスタイル変更は破棄されます。",
@@ -9916,9 +9942,13 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "보류 중인 시각 미리보기",
         applyWithAgent: "Design 에이전트로 적용",
         copyPrompt: "에이전트에 프롬프트 복사",
+        abortPreview: "미리보기를 중단하고 상호작용",
         agentMessage: "보류 중인 시각 스타일 편집을 소스에 적용하세요.",
         sentToast: "스타일 편집을 Design 에이전트로 보냈습니다",
         copiedToast: "스타일 프롬프트가 복사되었습니다",
+        abortedToast: "보류 중인 미리보기를 버렸습니다",
+        interactBlocked:
+          "상호작용 모드로 전환하기 전에 보류 중인 라이브 편집을 적용하거나 중단하세요.",
         leaveTitle: "나가기 전에 스타일을 적용할까요?",
         leaveDescriptionOne:
           "라이브 미리보기에 보류 중인 시각 스타일 편집이 {{count}}개 있습니다. 지금 나가면 적용되지 않은 스타일 변경이 삭제됩니다.",
@@ -9937,10 +9967,14 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "Prévia visual pendente",
         applyWithAgent: "Aplicar com o agente Design",
         copyPrompt: "Copiar prompt para seu agente",
+        abortPreview: "Cancelar prévia e interagir",
         agentMessage:
           "Aplique as edições visuais de estilo pendentes à origem.",
         sentToast: "Edições de estilo enviadas ao agente Design",
         copiedToast: "Prompt de estilo copiado",
+        abortedToast: "Prévia pendente descartada",
+        interactBlocked:
+          "Aplique ou cancele as edições ao vivo pendentes antes de mudar para Interagir.",
         leaveTitle: "Aplicar estilos antes de sair?",
         leaveDescriptionOne:
           "Você tem {{count}} edição visual de estilo pendente na prévia ao vivo. Sair agora descartará essa alteração de estilo não aplicada.",
@@ -9959,9 +9993,12 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "लंबित visual preview",
         applyWithAgent: "Design agent से लागू करें",
         copyPrompt: "Prompt अपने agent को कॉपी करें",
+        abortPreview: "Preview रोकें और interact करें",
         agentMessage: "लंबित visual style edits को source पर लागू करें।",
         sentToast: "Style edits Design agent को भेजे गए",
         copiedToast: "Style prompt कॉपी हुआ",
+        abortedToast: "लंबित preview हटा दिया गया",
+        interactBlocked: "Interact पर जाने से पहले लंबित live edits लागू करें या रोकें।",
         leaveTitle: "छोड़ने से पहले styles लागू करें?",
         leaveDescriptionOne:
           "Live preview में {{count}} लंबित visual style edit है। अभी छोड़ने पर वह unapplied style change हट जाएगा।",
@@ -9980,9 +10017,13 @@ const designPendingVisualStyleOverrides = {
         previewLabel: "معاينة مرئية معلقة",
         applyWithAgent: "تطبيق عبر وكيل Design",
         copyPrompt: "نسخ الموجه إلى وكيلك",
+        abortPreview: "إلغاء المعاينة والتفاعل",
         agentMessage: "طبّق تعديلات النمط المرئية المعلقة على المصدر.",
         sentToast: "تم إرسال تعديلات النمط إلى وكيل Design",
         copiedToast: "تم نسخ موجه النمط",
+        abortedToast: "تم تجاهل المعاينة المعلقة",
+        interactBlocked:
+          "طبّق التعديلات المباشرة المعلقة أو ألغها قبل الانتقال إلى التفاعل.",
         leaveTitle: "تطبيق الأنماط قبل المغادرة؟",
         leaveDescriptionOne:
           "لديك {{count}} تعديل نمط مرئي معلق في المعاينة المباشرة. ستؤدي المغادرة الآن إلى تجاهل تغيير النمط غير المطبق.",

package/corpus/templates/design/changelog/2026-07-07-local-visual-edit-keeps-bridge-access-when-opening-previousl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Local visual edit keeps bridge access when opening previously connected localhost apps

package/corpus/templates/design/changelog/2026-07-07-local-visual-edit-now-keeps-the-live-app-connection-authenti.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Local visual edit now keeps the live app connection authenticated when applying or discarding style previews.

package/corpus/templates/design/changelog/2026-07-07-local-visual-edit-uses-live-app-iframes-for-click-to-edit-pr.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-07
+---
+
+Local visual edit uses live app iframes for click-to-edit previews before applying changes.

package/dist/agent/durable-background.d.ts

@@ -117,27 +117,27 @@ export declare function isAgentChatDurableBackgroundEnabled(options?: {
     appOptIn?: boolean;
 }): boolean;
 /**
- * Env flag for the FOREGROUND server-driven self-chain. DEFAULT-OFF (opt-in):
- * unset means disabled; an app opts IN with an explicit truthy value
- * (`true`/`1`/`yes`/`on`) — same parsing convention as
- * `AGENT_CHAT_DURABLE_BACKGROUND`, deliberately kept as a separate flag so
- * this narrower capability can be enabled/disabled independently of the full
- * durable-background worker path.
+ * Env flag for the FOREGROUND server-driven self-chain. DEFAULT-ON for hosted
+ * deployments with `A2A_SECRET`: unset/empty/unknown means enabled, and an app
+ * opts OUT with an explicit falsy value (`false`/`0`/`no`/`off`). Deliberately
+ * kept separate from `AGENT_CHAT_DURABLE_BACKGROUND` so this narrower
+ * capability can be disabled independently of the full durable-background
+ * worker path.
  */
 export declare const AGENT_CHAT_FOREGROUND_SELF_CHAIN_ENV = "AGENT_CHAT_FOREGROUND_SELF_CHAIN";
 /**
- * Gate for the OPT-IN foreground self-chain: a normal (non-durable-background)
+ * Gate for the foreground self-chain: a normal (non-durable-background)
  * agent-chat turn that hits its soft-timeout chunk boundary continues via a
  * server-side self-dispatch on the REGULAR function (not a Netlify
  * `-background` function) instead of depending on the client to re-POST
  * `auto_continue`. Composes exactly like `isAgentChatDurableBackgroundEnabled`:
- * true only when the env flag is explicitly truthy AND the runtime is hosted
- * AND `A2A_SECRET` is configured (the HMAC handoff authenticates the
- * self-dispatch). False otherwise — and false means the existing
- * client-driven `auto_continue` re-POST path is used unchanged, byte-for-byte.
+ * true when the runtime is hosted AND `A2A_SECRET` is configured (the HMAC
+ * handoff authenticates the self-dispatch), unless the env flag is explicitly
+ * falsy. False otherwise — and false means the existing client-driven
+ * `auto_continue` re-POST path is used unchanged, byte-for-byte.
  *
  * Deliberately independent of `isAgentChatDurableBackgroundEnabled`: an app can
- * enable this narrower capability without opting into the full 15-min
+ * use this narrower capability without opting into the full 15-min
  * background-function worker path, and the two gates never need to agree.
  * When BOTH would be true for a given run, the durable-background dispatch
  * decision in `production-agent.ts` is evaluated first and takes precedence —

package/dist/agent/durable-background.js

@@ -290,15 +290,15 @@ export function isAgentChatDurableBackgroundEnabled(options) {
         hasConfiguredA2ASecret());
 }
 /**
- * Env flag for the FOREGROUND server-driven self-chain. DEFAULT-OFF (opt-in):
- * unset means disabled; an app opts IN with an explicit truthy value
- * (`true`/`1`/`yes`/`on`) — same parsing convention as
- * `AGENT_CHAT_DURABLE_BACKGROUND`, deliberately kept as a separate flag so
- * this narrower capability can be enabled/disabled independently of the full
- * durable-background worker path.
+ * Env flag for the FOREGROUND server-driven self-chain. DEFAULT-ON for hosted
+ * deployments with `A2A_SECRET`: unset/empty/unknown means enabled, and an app
+ * opts OUT with an explicit falsy value (`false`/`0`/`no`/`off`). Deliberately
+ * kept separate from `AGENT_CHAT_DURABLE_BACKGROUND` so this narrower
+ * capability can be disabled independently of the full durable-background
+ * worker path.
  */
 export const AGENT_CHAT_FOREGROUND_SELF_CHAIN_ENV = "AGENT_CHAT_FOREGROUND_SELF_CHAIN";
-function isForegroundSelfChainFlagEnabled() {
+function isForegroundSelfChainExplicitlyDisabled() {
     // Read the literal key (not `process.env[CONST]`) so guard:no-env-credentials
     // can statically verify it against the allowlisted `AGENT_*` prefix. Keep this
     // in sync with AGENT_CHAT_FOREGROUND_SELF_CHAIN_ENV.
@@ -306,24 +306,24 @@ function isForegroundSelfChainFlagEnabled() {
     if (raw == null)
         return false;
     const normalized = raw.trim().toLowerCase();
-    return (normalized === "1" ||
-        normalized === "true" ||
-        normalized === "yes" ||
-        normalized === "on");
+    return (normalized === "0" ||
+        normalized === "false" ||
+        normalized === "no" ||
+        normalized === "off");
 }
 /**
- * Gate for the OPT-IN foreground self-chain: a normal (non-durable-background)
+ * Gate for the foreground self-chain: a normal (non-durable-background)
  * agent-chat turn that hits its soft-timeout chunk boundary continues via a
  * server-side self-dispatch on the REGULAR function (not a Netlify
  * `-background` function) instead of depending on the client to re-POST
  * `auto_continue`. Composes exactly like `isAgentChatDurableBackgroundEnabled`:
- * true only when the env flag is explicitly truthy AND the runtime is hosted
- * AND `A2A_SECRET` is configured (the HMAC handoff authenticates the
- * self-dispatch). False otherwise — and false means the existing
- * client-driven `auto_continue` re-POST path is used unchanged, byte-for-byte.
+ * true when the runtime is hosted AND `A2A_SECRET` is configured (the HMAC
+ * handoff authenticates the self-dispatch), unless the env flag is explicitly
+ * falsy. False otherwise — and false means the existing client-driven
+ * `auto_continue` re-POST path is used unchanged, byte-for-byte.
  *
  * Deliberately independent of `isAgentChatDurableBackgroundEnabled`: an app can
- * enable this narrower capability without opting into the full 15-min
+ * use this narrower capability without opting into the full 15-min
  * background-function worker path, and the two gates never need to agree.
  * When BOTH would be true for a given run, the durable-background dispatch
  * decision in `production-agent.ts` is evaluated first and takes precedence —
@@ -331,7 +331,7 @@ function isForegroundSelfChainFlagEnabled() {
  * existing `isBackgroundWorker` path, not this one.
  */
 export function isAgentChatForegroundSelfChainEnabled() {
-    return (isForegroundSelfChainFlagEnabled() &&
+    return (!isForegroundSelfChainExplicitlyDisabled() &&
         isHostedRuntimeForDurableBackground() &&
         hasConfiguredA2ASecret());
 }