@agent-native/core 0.84.12 → 0.84.14

package/corpus/templates/design/.agents/skills/design-generation/SKILL.md

@@ -119,14 +119,21 @@ Each `content` is a complete, self-contained document (Alpine.js + Tailwind via
 
 Wait for the user's pick before refining. Once they choose, keep the selected
 screen, delete the unchosen variant screens with `delete-file`, and continue
-from the kept screen. If inline chat choice buttons are unavailable in the host,
-ask the user to tell you the preferred screen name. Do not ask them to paste HTML
-or a generated handoff summary; the variants are already real screens on the
-board.
+from the kept screen by calling `get-design-snapshot` with the selected
+screen's `fileId`, then calling `edit-design` on that same `fileId`. Use
+`mode: "replace-file"` when expanding the representative placeholder into the
+full chosen direction. Do not call `generate-design` after a variant pick. If
+inline chat choice buttons are unavailable in the host, ask the user to tell you
+the preferred screen name. Do not ask them to paste HTML or a generated handoff
+summary; the variants are already real screens on the board.
 
 ### Phase 3 — Save with `generate-design` (when not using variants)
 
-Skip variants and call `generate-design` directly for: refinements to an already-picked design, multi-screen additions to an existing design, or one-shot prompts where the direction is unambiguous.
+Skip variants and call `generate-design` directly for: a brand-new first
+renderable file, multi-screen additions to an existing design, or one-shot
+prompts where the direction is unambiguous. For refinements to an already-picked
+design or selected screen, use `get-design-snapshot` followed by `edit-design`
+instead.
 
 ```bash
 pnpm action generate-design \
@@ -476,7 +483,9 @@ regeneration is slow, expensive, and regresses unrelated parts.
    Each `search` must match the file **exactly and uniquely** — include enough
    surrounding context to be unambiguous. Wrapping an element in a new div is
    just a search/replace whose `replace` adds the wrapper around the original.
-3. **Reserve `generate-design` for** net-new files or large structural rewrites.
+3. **Reserve `generate-design` for** net-new files. For large structural
+   rewrites of an existing selected file, call `edit-design` with
+   `mode: "replace-file"` and the exact `fileId` from `get-design-snapshot`.
    Never resend files you aren't changing.
 4. **Treat `:root` as the global spec.** For theme-wide restyles, edit the
    tokens in `:root` rather than touching every element.

package/corpus/templates/design/AGENTS.md

@@ -64,8 +64,9 @@ patterns live in `.agents/skills/`.
   URLs, which would navigate the preview iframe to the app itself.
 - To refine an existing design, make the smallest change: read it with
   `get-design-snapshot`, then use `edit-design` (search/replace). Reserve
-  `generate-design` for new files or large structural rewrites; never resend
-  files you aren't changing.
+  `generate-design` for new files. For broad rewrites of an existing selected
+  file, use `edit-design` with `mode: "replace-file"` and the exact `fileId`;
+  never resend files you aren't changing.
 - When the user asks to add tweak controls, preserve existing useful tweaks,
   add or update the requested `tweaks` definitions, and make sure each control
   is backed by a CSS custom property the rendered file actually uses. If source
@@ -222,8 +223,11 @@ patterns live in `.agents/skills/`.
 - For human-in-the-loop UI exploration, create a design shell, call
   `present-design-variants` with 2-5 concise directions (three by default),
   wait for the user to pick one in chat, delete the other generated variant
-  screens with `delete-file`, then use `get-design-snapshot` and
-  `generate-design` or `edit-design` for follow-up refinements.
+  screens with `delete-file`, call `get-design-snapshot` with the selected
+  screen's `fileId`, then call `edit-design` on that same `fileId` for
+  follow-up refinement. Use `mode: "replace-file"` when expanding the
+  representative placeholder into the full chosen direction. Do not call
+  `generate-design` after a variant pick.
 - If inline chat choice buttons are unavailable, the user can tell you the
   preferred screen name. Do not show a separate variant picker or ask them to
   paste a copyable handoff summary.

package/corpus/templates/design/actions/create-design.ts

@@ -85,6 +85,7 @@ export default defineAction({
       data: "{}",
       ownerEmail,
       orgId,
+      visibility: orgId ? "org" : "private",
       createdAt: now,
       updatedAt: now,
     });

package/corpus/templates/design/actions/duplicate-design.ts

@@ -63,6 +63,7 @@ export default defineAction({
     }
 
     // Copy the design with remapped canvasFrames
+    const orgId = getRequestOrgId() || null;
     await db.insert(schema.designs).values({
       id: newId,
       title: newTitle,
@@ -75,7 +76,8 @@ export default defineAction({
         if (!e) throw new Error("no authenticated user");
         return e;
       })(),
-      orgId: getRequestOrgId() || null,
+      orgId,
+      visibility: orgId ? "org" : "private",
       createdAt: now,
       updatedAt: now,
     });

package/corpus/templates/design/actions/edit-design.ts

@@ -139,20 +139,31 @@ export default defineAction({
     "`replace` adds the wrapper around the original text. For broad copy-only " +
     'changes such as translating all visible text, use `mode: "replace-file"` ' +
     "with `replacementContent`: the complete updated file content copied from " +
-    "the snapshot with only the requested copy changed. Use `generate-design` " +
-    "instead only for brand-new files or large structural rewrites.",
+    "the snapshot with only the requested copy changed. After a variant pick " +
+    "or any other selected-screen follow-up, pass the exact `fileId` from " +
+    '`get-design-snapshot` and use `mode: "replace-file"` when replacing ' +
+    "the representative placeholder with the full chosen direction. Use " +
+    "`generate-design` instead only for brand-new files.",
   schema: z
     .object({
       designId: z.string().describe("Design project ID"),
+      fileId: z
+        .string()
+        .optional()
+        .describe(
+          "Optional exact design file ID to edit. Use this after a variant pick or selected-screen snapshot; when provided, it wins over filename.",
+        ),
       filename: z
         .string()
-        .default("index.html")
-        .describe("File to edit (e.g. 'index.html')"),
+        .optional()
+        .describe(
+          "File to edit (e.g. 'index.html'). Defaults to index.html only when fileId is omitted.",
+        ),
       mode: z
         .enum(["search-replace", "replace-file"])
         .optional()
         .describe(
-          "Defaults to search-replace. Use replace-file for broad copy-only edits like translating the whole page after reading get-design-snapshot.",
+          "Defaults to search-replace. Use replace-file for selected variant expansion or broad copy-only edits after reading get-design-snapshot.",
         ),
       edits: editBlocksSchema
         .optional()
@@ -164,7 +175,7 @@ export default defineAction({
         .min(1)
         .optional()
         .describe(
-          "Complete updated file content. Use only with mode=replace-file for broad copy-only changes; preserve all HTML structure, CSS, scripts, and tweaks from get-design-snapshot.",
+          "Complete updated file content. Use only with mode=replace-file for selected variant expansion or broad copy-only changes; preserve all HTML structure, CSS, scripts, and tweaks from get-design-snapshot.",
         ),
     })
     .superRefine((value, ctx) => {
@@ -201,16 +212,31 @@ export default defineAction({
         });
       }
     }),
-  run: async ({ designId, filename, edits, mode, replacementContent }) => {
+  run: async ({
+    designId,
+    fileId,
+    filename,
+    edits,
+    mode,
+    replacementContent,
+  }) => {
     await assertAccess("design", designId, "editor");
 
     const db = getDb();
     const now = new Date().toISOString();
+    const requestedFileId = fileId?.trim();
+    const targetFilename = requestedFileId
+      ? undefined
+      : filename?.trim() || "index.html";
+    const targetCondition = requestedFileId
+      ? eq(schema.designFiles.id, requestedFileId)
+      : eq(schema.designFiles.filename, targetFilename!);
 
-    // Resolve the target file (access-scoped) by design + filename.
+    // Resolve the target file (access-scoped) by design + fileId or filename.
     const [file] = await db
       .select({
         id: schema.designFiles.id,
+        filename: schema.designFiles.filename,
         content: schema.designFiles.content,
       })
       .from(schema.designFiles)
@@ -221,14 +247,18 @@ export default defineAction({
       .where(
         and(
           eq(schema.designFiles.designId, designId),
-          eq(schema.designFiles.filename, filename),
+          targetCondition,
           accessFilter(schema.designs, schema.designShares),
         ),
       )
       .limit(1);
 
     if (!file) {
-      throw new Error(`File "${filename}" not found in design ${designId}`);
+      throw new Error(
+        requestedFileId
+          ? `File id "${requestedFileId}" not found in design ${designId}`
+          : `File "${targetFilename}" not found in design ${designId}`,
+      );
     }
 
     // Prefer live collab content so we edit in-flight changes, not a stale
@@ -265,13 +295,13 @@ export default defineAction({
           selection: firstSearch
             ? `[data-edit-target="${firstSearch.slice(0, 40)}"]`
             : null,
-          editingFile: filename,
+          editingFile: file.filename,
           designId,
         });
       } else {
         agentUpdateSelection(file.id, {
           selection: null,
-          editingFile: filename,
+          editingFile: file.filename,
           designId,
         });
       }
@@ -301,7 +331,7 @@ export default defineAction({
 
     return {
       designId,
-      filename,
+      filename: file.filename,
       fileId: file.id,
       mode: resolvedMode,
       editsApplied: applied,

package/corpus/templates/design/actions/generate-design.ts

@@ -81,7 +81,8 @@ const generateDesignAgentParameters = {
       type: "string",
       description:
         "JSON array of files to save. Pass one compact, complete, renderable index.html first, e.g. " +
-        '[{"filename":"index.html","fileType":"html","content":"<!doctype html>..."}].',
+        '[{"filename":"index.html","fileType":"html","content":"<!doctype html>..."}]. ' +
+        "Do not use generate-design to replace a selected variant screen after a variant pick; snapshot that fileId and use edit-design instead.",
     },
     designSystemId: {
       type: ["string", "null"],
@@ -117,6 +118,9 @@ const generateDesignAction = defineAction({
     "version then refine individual files with `edit-design` (search/replace) rather " +
     "than resending a big multi-file payload — a single oversized payload can get cut " +
     "off mid-stream and stall the turn. " +
+    "Do not use this action to replace a selected variant screen after a " +
+    "variant pick; call `get-design-snapshot` for the selected `fileId` and " +
+    "`edit-design` that same `fileId` instead. " +
     "Do not report a design as ready until this action succeeds. " +
     "When adding multiple screens or states, pass canvasFrames with filenames " +
     "and x/y/width/height so the new screens appear placed on the overview canvas.",

package/corpus/templates/design/actions/present-design-variants.ts

@@ -41,16 +41,19 @@ const FALLBACK_INSTRUCTIONS =
   "overview board. The chat shows one button per screen. Ask the user to pick " +
   "a screen by name if the inline buttons are not available; after they pick, " +
   "delete the other variant screens, call get-design-snapshot with fileId for " +
-  "the kept screen, and continue from that one file in a bounded pass.";
+  "the kept screen, then call edit-design on that same fileId in a bounded pass. " +
+  'Use mode "replace-file" when expanding the representative placeholder. ' +
+  "Do not call generate-design after a variant pick.";
 
 const VARIANT_PICK_SUBMIT_MESSAGE =
   "Use this design direction. Delete the other variant screens, call " +
   "get-design-snapshot with the selected option's fileId (or filename if " +
-  "needed) for the kept file, then continue from that current HTML in a " +
-  "bounded single-file pass. Prefer edit-design for refinements; if " +
-  "generate-design is needed, update only the kept file compactly. Do not " +
-  "generate a full multi-screen rewrite or resend a huge payload. Stop after " +
-  "the first successful save.";
+  "needed) for the kept file, then call edit-design with that same fileId in " +
+  'a bounded single-file pass. Use mode "replace-file" when replacing the ' +
+  "representative placeholder with the full chosen direction, or search/replace " +
+  "for smaller refinements. Do not call generate-design after a variant pick, " +
+  "do not create index.html, and do not resend a huge payload. Stop after the " +
+  "first successful edit-design save.";
 
 const variantSchema = z.object({
   id: z.string().min(1).describe("Stable variant id, e.g. 'minimal-focus'"),
@@ -421,9 +424,11 @@ export default defineAction({
     "exploration before follow-up refinement. After the user's choice, keep " +
     "the chosen screen, delete the other generated variant screens, and " +
     "call get-design-snapshot with fileId for the kept screen before " +
-    "continuing from that single file in a bounded pass. Prefer edit-design " +
-    "for refinements; if generate-design is needed, update only the kept file " +
-    "compactly and stop after the first successful save. For complex apps, " +
+    "calling edit-design on that same fileId in a bounded pass. Use " +
+    '`mode: "replace-file"` when expanding the representative placeholder ' +
+    "into the full chosen direction. Do not call generate-design after a " +
+    "variant pick. Stop after the first successful edit-design save. For " +
+    "complex apps, " +
     "make each variant a " +
     "compact representative screen; pass concise labels/descriptions/features " +
     "and omit content when full HTML would be too large. Design will render " +
@@ -577,7 +582,7 @@ export default defineAction({
     await writeAppStateForCurrentTab("guided-questions", {
       title: prompt ?? "Pick a direction",
       description:
-        "All options are on the board. Choose one to keep; I will delete the others, read only the kept screen, and continue from that single file in a bounded pass.",
+        "All options are on the board. Choose one to keep; I will delete the others, read only the kept screen, and edit that same file in a bounded pass.",
       submitLabel: "Use selected direction",
       submitMessage: VARIANT_PICK_SUBMIT_MESSAGE,
       skipLabel: "Show another set",
@@ -605,7 +610,7 @@ export default defineAction({
               value:
                 `Keep "${screen.label}" (${screen.filename}, file id ${screen.id}) ` +
                 `from variant set ${variantSetId}. Delete the other variant screens: ${otherScreens}. ` +
-                `Then call get-design-snapshot with designId ${designId} and fileId ${screen.id} (filename ${screen.filename}) and continue from that current HTML in a bounded single-file pass. Prefer edit-design for refinements; if generate-design is needed, update only this kept file compactly. Do not generate a full multi-screen rewrite or resend a huge payload. Stop after the first successful save.`,
+                `Then call get-design-snapshot with designId ${designId} and fileId ${screen.id} (filename ${screen.filename}), then call edit-design with fileId ${screen.id} on that same kept file in a bounded single-file pass. Use mode "replace-file" when replacing the representative placeholder with the full chosen direction, or search/replace for smaller refinements. Do not call generate-design after this variant pick, do not create index.html, and do not resend a huge payload. Stop after the first successful edit-design save.`,
             };
           }),
         },
@@ -623,7 +628,7 @@ export default defineAction({
       embed: true,
       fallbackInstructions: FALLBACK_INSTRUCTIONS,
       nextRequiredAction:
-        "Wait for the user to pick a screen in chat. Then delete the unchosen variant screens with delete-file, call get-design-snapshot with fileId for the chosen screen, and continue from that single file in a bounded pass. Prefer edit-design; if generate-design is needed, update only the kept file compactly and stop after the first successful save.",
+        'Wait for the user to pick a screen in chat. Then delete the unchosen variant screens with delete-file, call get-design-snapshot with fileId for the chosen screen, and call edit-design with that same fileId in a bounded pass. Use mode "replace-file" when expanding the placeholder into the full chosen direction. Do not call generate-design after a variant pick. Stop after the first successful edit-design save.',
     };
   },
   link: ({ result }) => {

package/corpus/templates/design/app/hooks/use-question-flow.ts

@@ -41,7 +41,7 @@ export function useQuestionFlow(
         formattedAnswers,
         "",
         designId
-          ? "Now continue the design. Honor any answer about variations: if the user asked to explore options, call present-design-variants with 2-5 concise directions using label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens - wait for their chat pick, delete the unchosen variant screens, call get-design-snapshot with fileId for the kept screen, then continue from that single file in a bounded pass. Prefer edit-design; if generate-design is needed, update only the kept file compactly and stop after the first successful save. Otherwise call generate-design with one complete, renderable index.html first. Do not ask another question unless a required decision is still genuinely missing."
+          ? 'Now continue the design. Honor any answer about variations: if the user asked to explore options, call present-design-variants with 2-5 concise directions using label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens - wait for their chat pick, delete the unchosen variant screens, call get-design-snapshot with fileId for the kept screen, then call edit-design on that same fileId in a bounded pass. Use mode "replace-file" when expanding the representative placeholder into the full chosen direction. Do not call generate-design after a variant pick. Stop after the first successful edit-design save. Otherwise call generate-design with one complete, renderable index.html first. Do not ask another question unless a required decision is still genuinely missing.'
           : "Now continue the design. Honor any answer about variations: use variants only if requested; otherwise generate one polished direction.",
       ]
         .filter(Boolean)
@@ -79,7 +79,7 @@ export function useQuestionFlow(
         formattedAnswers,
         "",
         designId
-          ? "Now continue the design. Honor any answer about variations: if the user asked to explore options, call present-design-variants with 2-5 concise directions using label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens - wait for their chat pick, delete the unchosen variant screens, call get-design-snapshot with fileId for the kept screen, then continue from that single file in a bounded pass. Prefer edit-design; if generate-design is needed, update only the kept file compactly and stop after the first successful save. Otherwise call generate-design with one complete, renderable index.html first. Do not ask another question unless a required decision is still genuinely missing."
+          ? 'Now continue the design. Honor any answer about variations: if the user asked to explore options, call present-design-variants with 2-5 concise directions using label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens - wait for their chat pick, delete the unchosen variant screens, call get-design-snapshot with fileId for the kept screen, then call edit-design on that same fileId in a bounded pass. Use mode "replace-file" when expanding the representative placeholder into the full chosen direction. Do not call generate-design after a variant pick. Stop after the first successful edit-design save. Otherwise call generate-design with one complete, renderable index.html first. Do not ask another question unless a required decision is still genuinely missing.'
           : "Now continue the design. Honor any answer about variations: use variants only if requested; otherwise generate one polished direction.",
       ]
         .filter(Boolean)

package/corpus/templates/design/app/pages/DesignEditor.tsx

@@ -1445,7 +1445,7 @@ function designVariantGenerationDirectives(
     ...designSystemGenerationDirectives(designSystemId),
     "The user's prompt already asks to explore multiple directions, so DO NOT call `show-design-questions` first and DO NOT call `generate-design` first.",
     "Call `present-design-variants` with 2-5 concise directions (3 when unspecified). Prefer label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens.",
-    "Wait for the user's chat pick, delete the unchosen variant screens, call `get-design-snapshot` with `fileId` for the kept screen, then continue from that single file in a bounded pass. Prefer `edit-design`; if `generate-design` is needed, update only the kept file compactly and stop after the first successful save.",
+    'Wait for the user\'s chat pick, delete the unchosen variant screens, call `get-design-snapshot` with `fileId` for the kept screen, then call `edit-design` on that same `fileId` in a bounded pass. Use `mode: "replace-file"` when expanding the representative placeholder into the full chosen direction. Do not call `generate-design` after a variant pick. Stop after the first successful `edit-design` save.',
   ];
 }
 
@@ -1456,7 +1456,7 @@ function designGenerationDirectives(
   return [
     `Use the \`generate-design --designId="${designId}"\` action with exactly one complete, renderable \`index.html\` file first. The design already exists - DO NOT call create-design.`,
     ...designSystemGenerationDirectives(designSystemId),
-    "If the user asked to explore variations, call `present-design-variants` with 2-5 concise directions. Prefer label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens. Wait for their chat pick, delete the unchosen variant screens, call `get-design-snapshot` with `fileId` for the kept screen, then continue from that single file in a bounded pass. Prefer `edit-design`; if `generate-design` is needed, update only the kept file compactly and stop after the first successful save. Otherwise generate one polished first direction.",
+    'If the user asked to explore variations, call `present-design-variants` with 2-5 concise directions. Prefer label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens. Wait for their chat pick, delete the unchosen variant screens, call `get-design-snapshot` with `fileId` for the kept screen, then call `edit-design` on that same `fileId` in a bounded pass. Use `mode: "replace-file"` when expanding the representative placeholder into the full chosen direction. Do not call `generate-design` after a variant pick. Stop after the first successful `edit-design` save. Otherwise generate one polished first direction.',
     "Keep the first pass bounded enough to finish quickly: one self-contained Alpine.js + Tailwind CDN HTML document, polished but concise. Add 3-6 tweaks only when they naturally fit the design.",
     "After generate-design succeeds, stop and summarize what was created.",
   ];

package/corpus/templates/design/changelog/2026-07-01-org-members-can-see-design-projects-created-in-their-workspace.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-01
+---
+
+Org members can see Design projects created in their workspace.

package/corpus/templates/design/server/plugins/db.ts

@@ -260,6 +260,15 @@ ALTER TABLE motion_timeline ADD COLUMN IF NOT EXISTS org_id TEXT;
 ALTER TABLE motion_timeline ADD COLUMN IF NOT EXISTS visibility TEXT NOT NULL DEFAULT 'private';
 CREATE INDEX IF NOT EXISTS motion_timeline_owner_org_updated_idx ON motion_timeline (owner_email, org_id, updated_at)`,
     },
+    // v18: intentionally no-op. New org-scoped designs now default to
+    // org-visible at creation time, but existing private org rows may have
+    // been intentionally private. There is no durable marker that separates
+    // old default-private rows from explicit private rows, so do not widen
+    // historical access in a migration.
+    {
+      version: 18,
+      sql: {},
+    },
   ],
   { table: "design_migrations" },
 );

package/corpus/templates/plan/app/components/plan/wireframe/html-artboard.css

@@ -405,8 +405,37 @@
   color: var(--wf-ink) !important;
 }
 
-.plan-diagram-frame :is(.diagram-node, .diagram-box, .diagram-card) {
+.plan-diagram-frame
+  :is(
+    .diagram-panel,
+    .diagram-card,
+    .diagram-node,
+    .diagram-box,
+    [class*="card"],
+    [class*="panel"],
+    [class*="box"]
+  ) {
   max-width: 100%;
+  overflow-wrap: anywhere !important;
+  word-break: break-word;
+  white-space: normal !important;
+}
+
+.plan-diagram-frame
+  :is(
+    .diagram-panel,
+    .diagram-card,
+    .diagram-node,
+    .diagram-box,
+    [class*="card"],
+    [class*="panel"],
+    [class*="box"]
+  )
+  :is(h1, h2, h3, p, small, strong, span, li) {
+  max-width: 100%;
+  overflow-wrap: anywhere !important;
+  word-break: break-word;
+  white-space: normal !important;
 }
 
 /* Base padding so primitive text never touches the box edge, even when an author
@@ -472,6 +501,7 @@
   display: inline-flex;
   align-items: center;
   justify-content: center;
+  flex-wrap: wrap;
   /* A pill hugs its label. `fit-content` is a definite cross size, so a flex
    * column with the default `align-items: stretch` no longer blows the pill out
    * to full width (the number chips and short status labels stay pill-shaped).
@@ -484,6 +514,19 @@
   padding: 3px 11px;
   color: var(--wf-ink);
   background: var(--wf-paper);
+  overflow-wrap: anywhere !important;
+  text-align: center;
+  white-space: normal !important;
+  word-break: break-word;
+}
+
+.plan-diagram-frame
+  :is(.diagram-pill, [class*="pill"], [class*="badge"], [class*="chip"])
+  > * {
+  min-width: 0;
+  max-width: 100%;
+  overflow-wrap: anywhere !important;
+  white-space: normal !important;
 }
 
 .plan-diagram-frame :is(.diagram-accent, .diagram-pill.accent) {

package/corpus/templates/plan/changelog/2026-07-01-visual-plan-and-recap-diagram-labels-now-wrap-inside-their-b.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-01
+---
+
+Visual plan and recap diagram labels now wrap inside their boxes instead of spilling outside.

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

@@ -101,6 +101,9 @@ export declare function isHostedRuntimeForDurableBackground(): boolean;
  * additional signals — the latter an operator escape hatch. Off by default.
  */
 export declare function isInBackgroundFunctionRuntime(): boolean;
+export declare function backgroundRunMarkerExpectsBackgroundRuntime(marker: unknown): boolean;
+export declare function shouldUseBackgroundFunctionTimeoutForWorker(marker: unknown): boolean;
+export declare function backgroundRuntimeDiagnosticDetail(marker: unknown): string;
 /**
  * The single gate. True when the env flag is explicitly enabled, or a workspace
  * app opted in and has a per-app background-function target, AND the runtime is

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

@@ -1 +1 @@
-{"version":3,"file":"durable-background.d.ts","sourceRoot":"","sources":["../../src/agent/durable-background.ts"],"names":[],"mappings":"AAgDA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,2CACE,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,gDAA0D,CAAC;AAsB1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sCAAsC,IAAI,MAAM,CAY/D;AAED;;;GAGG;AACH,eAAO,MAAM,iCAAiC,kCACb,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,OAAO,CAsB7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAsBvD;AAwCD;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,CAAC,EAAE;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAWV;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAC7B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAahE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,qBAAqB,CAiDvB"}
+{"version":3,"file":"durable-background.d.ts","sourceRoot":"","sources":["../../src/agent/durable-background.ts"],"names":[],"mappings":"AAgDA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,2CACE,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,gDAA0D,CAAC;AAiC1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sCAAsC,IAAI,MAAM,CAQ/D;AAED;;;GAGG;AACH,eAAO,MAAM,iCAAiC,kCACb,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,OAAO,CAsB7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAsBvD;AAED,wBAAgB,2CAA2C,CACzD,MAAM,EAAE,OAAO,GACd,OAAO,CAOT;AAED,wBAAgB,2CAA2C,CACzD,MAAM,EAAE,OAAO,GACd,OAAO,CAKT;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQzE;AAwCD;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,CAAC,EAAE;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAWV;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAC7B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAahE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,qBAAqB,CAiDvB"}

package/dist/agent/durable-background.js

@@ -87,6 +87,19 @@ function resolveWorkspaceBackgroundFunctionUrlPath() {
         return null;
     return `/.netlify/functions/${candidate}-agent-background`;
 }
+function isNetlifyHostedRuntimeForDispatch() {
+    if (process.env.NETLIFY_LOCAL === "true")
+        return false;
+    if (process.env.NETLIFY === "false")
+        return false;
+    if (process.env.NETLIFY && process.env.NETLIFY !== "false")
+        return true;
+    // Netlify sets AWS Lambda runtime env on deployed Functions, but the build-time
+    // NETLIFY flag is not always present in the runtime isolate. Treat Lambda as
+    // Netlify here unless Netlify was explicitly disabled above; non-Netlify AWS
+    // falls back inline if the /.netlify/functions dispatch fast-fails.
+    return Boolean(process.env.AWS_LAMBDA_FUNCTION_NAME);
+}
 /**
  * Resolve the path the foreground POST should self-dispatch the chat background
  * worker to.
@@ -119,9 +132,7 @@ function resolveWorkspaceBackgroundFunctionUrlPath() {
  * to shadow because `/.netlify/*` is already excluded from the `server` catch-all.
  */
 export function resolveAgentChatProcessRunDispatchPath() {
-    if (process.env.NETLIFY &&
-        process.env.NETLIFY !== "false" &&
-        process.env.NETLIFY_LOCAL !== "true") {
+    if (isNetlifyHostedRuntimeForDispatch()) {
         return (resolveWorkspaceBackgroundFunctionUrlPath() ??
             AGENT_BACKGROUND_FUNCTION_URL_PATH);
     }
@@ -205,6 +216,25 @@ export function isInBackgroundFunctionRuntime() {
     }
     return false;
 }
+export function backgroundRunMarkerExpectsBackgroundRuntime(marker) {
+    return (typeof marker === "object" &&
+        marker !== null &&
+        marker
+            .backgroundFunctionRuntimeExpected === true);
+}
+export function shouldUseBackgroundFunctionTimeoutForWorker(marker) {
+    return (isInBackgroundFunctionRuntime() ||
+        backgroundRunMarkerExpectsBackgroundRuntime(marker));
+}
+export function backgroundRuntimeDiagnosticDetail(marker) {
+    return [
+        `markerExpected=${backgroundRunMarkerExpectsBackgroundRuntime(marker)}`,
+        `runtimeDetected=${isInBackgroundFunctionRuntime()}`,
+        `globalMarker=${globalThis.__AGENT_NATIVE_BACKGROUND_RUNTIME__ === true}`,
+        `lambdaNameEndsBackground=${typeof process.env.AWS_LAMBDA_FUNCTION_NAME === "string" && process.env.AWS_LAMBDA_FUNCTION_NAME.toLowerCase().endsWith("-background")}`,
+        `forceEnv=${typeof process.env.AGENT_CHAT_FORCE_BACKGROUND_RUNTIME === "string" && process.env.AGENT_CHAT_FORCE_BACKGROUND_RUNTIME.trim().length > 0}`,
+    ].join(" ");
+}
 function isFlagEnabled() {
     // Read the literal key (not `process.env[CONST]`) so guard:no-env-credentials
     // can statically verify it against the allowlisted `AGENT_*` prefix. Keep this