@agent-native/core 0.141.6 → 0.141.7

package/corpus/templates/slides/app/context/DeckContext.tsx

@@ -138,6 +138,25 @@ export interface Deck {
   aspectRatio?: AspectRatio;
 }
 
+export type DeckPersistenceResult =
+  | { persisted: true }
+  | { persisted: false; reason: "request-failed"; error: unknown }
+  | { persisted: false; reason: "not-found" };
+
+export function describeDeckPersistenceFailure(
+  result: DeckPersistenceResult,
+  fallback: string,
+): string {
+  if (result.persisted || result.reason === "not-found") return fallback;
+  if (result.error instanceof Error && result.error.message.trim()) {
+    return result.error.message;
+  }
+  if (typeof result.error === "string" && result.error.trim()) {
+    return result.error;
+  }
+  return fallback;
+}
+
 interface DeckContextType {
   decks: Deck[];
   loading: boolean;
@@ -146,7 +165,7 @@ interface DeckContextType {
     title?: string,
     options?: { noDefaultSlides?: boolean; designSystemId?: string | null },
   ) => Deck;
-  ensureDeckPersisted: (id: string) => Promise<boolean>;
+  ensureDeckPersisted: (id: string) => Promise<DeckPersistenceResult>;
   /**
    * Optimistically duplicate a deck. Inserts a copy into local state with the
    * supplied `newId` immediately so the UI can navigate without awaiting the
@@ -167,6 +186,7 @@ interface DeckContextType {
   ) => void;
   reloadDecks: () => Promise<void>;
   reloadDecksWithStatus: () => Promise<DeckReloadStatus>;
+  refreshOpenDeck: (deckId: string) => Promise<Deck | null>;
   getDeck: (id: string) => Deck | undefined;
   addSlide: (
     deckId: string,
@@ -885,7 +905,22 @@ async function fetchDecksForCurrentRoute(): Promise<Deck[] | null> {
 }
 
 async function deleteDeckFromAPI(id: string): Promise<void> {
-  await callAction("delete-deck", { id }, { method: "DELETE" });
+  try {
+    await callAction("delete-deck", { id }, { method: "DELETE" });
+  } catch (error) {
+    // Deleting an optimistic deck is intentionally idempotent. A create can
+    // fail after the server committed the row, or before it created one.
+    if (
+      !(
+        error &&
+        typeof error === "object" &&
+        "status" in error &&
+        (error as { status?: unknown }).status === 404
+      )
+    ) {
+      throw error;
+    }
+  }
 }
 
 async function createDeckOnAPI(deck: Deck): Promise<void> {
@@ -1081,7 +1116,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
       const deletion = pendingCreate
         ? pendingCreate.then(
             () => deleteDeckFromAPI(deckId),
-            () => undefined,
+            () => deleteDeckFromAPI(deckId),
           )
         : deleteDeckFromAPI(deckId);
       void deletion.catch((err) => {
@@ -1267,11 +1302,11 @@ export function DeckProvider({ children }: { children: ReactNode }) {
   //   - Dirty deck / unsaved local create → additive merge only: surface
   //     agent-added slides without ever overwriting or dropping local slides.
   const refetchOpenDeckIfChanged = useCallback(
-    async (currentOpenId: string) => {
+    async (currentOpenId: string): Promise<Deck | null> => {
       const serverDeck = await fetchDeckFromAPI(currentOpenId);
       // Null means 404 (row not created yet), a transient failure, or a
       // still-pending create — nothing authoritative to reconcile.
-      if (!serverDeck) return;
+      if (!serverDeck) return null;
       const clientDeck = decksRef.current.find((d) => d.id === currentOpenId);
 
       const hasLocalEdits =
@@ -1281,7 +1316,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
       if (hasLocalEdits && clientDeck) {
         // Content-preserving: only ADD server slides missing locally.
         const merged = mergeServerAddedSlides(clientDeck, serverDeck);
-        if (merged === clientDeck) return; // nothing new to surface
+        if (merged === clientDeck) return serverDeck; // nothing new to surface
         lastExternalUpdateRef.current = Date.now();
         setDecks((prev) => {
           const idx = prev.findIndex((d) => d.id === currentOpenId);
@@ -1290,16 +1325,17 @@ export function DeckProvider({ children }: { children: ReactNode }) {
           next[idx] = merged;
           return next;
         });
-        return;
+        return serverDeck;
       }
 
       const changed =
         !clientDeck ||
         clientDeck.updatedAt !== serverDeck.updatedAt ||
-        clientDeck.slides.length !== serverDeck.slides.length;
-      if (!changed) return;
+        deckContentSignature(clientDeck) !== deckContentSignature(serverDeck);
+      if (!changed) return serverDeck;
       lastExternalUpdateRef.current = Date.now();
       applyRemoteDeckUpdate(serverDeck);
+      return serverDeck;
     },
     [applyRemoteDeckUpdate],
   );
@@ -1728,19 +1764,33 @@ export function DeckProvider({ children }: { children: ReactNode }) {
     [noteLocalCreate, setDecksLocal],
   );
 
-  const ensureDeckPersisted = useCallback(async (id: string) => {
-    const pendingCreate = pendingCreatePromisesRef.current.get(id);
-    if (pendingCreate) {
-      try {
-        await pendingCreate;
-        return true;
-      } catch {
-        return false;
+  const ensureDeckPersisted = useCallback(
+    async (id: string): Promise<DeckPersistenceResult> => {
+      const pendingCreate = pendingCreatePromisesRef.current.get(id);
+      if (pendingCreate) {
+        try {
+          await pendingCreate;
+          return { persisted: true };
+        } catch (error) {
+          return { persisted: false, reason: "request-failed", error };
+        }
       }
-    }
 
-    return (await fetchDeckFromAPI(id)) !== null;
-  }, []);
+      try {
+        const result = await callAction<unknown>(
+          "get-deck",
+          { id },
+          { method: "GET" },
+        );
+        return normalizeActionDeck(result)
+          ? { persisted: true }
+          : { persisted: false, reason: "not-found" };
+      } catch (error) {
+        return { persisted: false, reason: "request-failed", error };
+      }
+    },
+    [],
+  );
 
   const duplicateDeck = useCallback(
     (sourceDeckId: string, newId: string, title?: string): Deck | null => {
@@ -2150,6 +2200,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
         updateDeck,
         reloadDecks,
         reloadDecksWithStatus,
+        refreshOpenDeck: refetchOpenDeckIfChanged,
         getDeck,
         addSlide,
         updateSlide,

package/corpus/templates/slides/app/global.css

@@ -14,6 +14,12 @@
 
 @source "./**/*.{ts,tsx}";
 
+/* Keep the editable agent prompt readable even if the generated text utility
+   is missing or loses a cascade tie during the hosted build. */
+.agent-composer-root [data-agent-composer-slot="editor-input"] {
+  color: hsl(var(--foreground));
+}
+
 /* Hide the sidebar's built-in collapsed tab strip — AgentToggleButton in the
    toolbar serves this purpose instead, so we don't want a redundant bar. */
 button[title="Open agent sidebar"] {

package/corpus/templates/slides/app/lib/create-deck-generation.ts

@@ -4,7 +4,7 @@ import { flushSync } from "react-dom";
 
 import type { NewDeckReferenceSelection } from "@/components/editor/NewDeckReferenceStep";
 import type { UploadedFile } from "@/components/editor/PromptDialog";
-import type { Deck } from "@/context/DeckContext";
+import type { Deck, DeckPersistenceResult } from "@/context/DeckContext";
 import { createDeckAgentMessage } from "@/lib/agent-visible-message";
 
 interface DesignSystemGenerationContextResult {
@@ -150,13 +150,17 @@ export interface StartDeckGenerationOptions {
   selectedReferenceDeckId?: string | null;
   designSystems: Array<{ id: string; title: string }>;
   createDeck: CreateDeck;
-  ensureDeckPersisted: (id: string) => Promise<boolean>;
+  ensureDeckPersisted: (id: string) => Promise<DeckPersistenceResult>;
   deleteDeck: (id: string) => void;
   navigate: Navigate;
   agentSubmit: SubmitAgent;
   onPromptClosed: () => void;
   onUnauthenticated: (prompt: string, hadFiles: boolean) => void;
-  onPersistenceFailure: (prompt: string, files: UploadedFile[]) => void;
+  onPersistenceFailure: (
+    prompt: string,
+    files: UploadedFile[],
+    failure: DeckPersistenceResult,
+  ) => void;
 }
 
 /** Create the optimistic deck, hydrate references, and start the agent run. */
@@ -214,8 +218,8 @@ export async function startDeckGeneration({
   onPromptClosed();
 
   const persisted = await ensureDeckPersisted(deck.id);
-  if (!persisted) {
-    onPersistenceFailure(prompt, filesForGeneration);
+  if (!persisted.persisted) {
+    onPersistenceFailure(prompt, filesForGeneration, persisted);
     deleteDeck(deckId);
     return "failed";
   }

package/corpus/templates/slides/app/pages/DeckEditor.tsx

@@ -155,6 +155,7 @@ export default function DeckEditor() {
     getDeck,
     reloadDecks,
     reloadDecksWithStatus,
+    refreshOpenDeck,
     updateDeck,
     updateSlide,
     deleteSlide,
@@ -396,6 +397,22 @@ export default function DeckEditor() {
     }
   }, [refetchOrg, reloadDecks]);
 
+  // The final generation write can race the last sync event. Pull the
+  // authoritative open deck when the run settles so a stale canvas does not
+  // require a browser refresh to reveal completed slides.
+  useEffect(() => {
+    if (
+      !id ||
+      !shouldClearNewDeckGeneratingState({
+        generating,
+        generationStarted: newDeckGenerationStarted.current,
+      })
+    ) {
+      return;
+    }
+    void refreshOpenDeck(id);
+  }, [generating, id, refreshOpenDeck]);
+
   // Clean up the generating URL param/ref when generation completes or when
   // the first slide lands, so partial progress is visible during long decks.
   useEffect(() => {

package/corpus/templates/slides/app/pages/Index.tsx

@@ -40,7 +40,10 @@ import {
 } from "@/components/ui/alert-dialog";
 import { Button } from "@/components/ui/button";
 import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";
-import type { Deck } from "@/context/DeckContext";
+import {
+  describeDeckPersistenceFailure,
+  type Deck,
+} from "@/context/DeckContext";
 import { useDecks } from "@/context/DeckContext";
 import { useAgentGenerating } from "@/hooks/use-agent-generating";
 import { useDesignSystems } from "@/hooks/use-design-systems";
@@ -571,14 +574,17 @@ export default function Index() {
     setNewDeckPromptOpen(false);
 
     const persisted = await ensureDeckPersisted(deck.id);
-    if (!persisted) {
+    if (!persisted.persisted) {
       if (!savePromptForRetry(prompt)) {
         setNewDeckInitialPrompt({ text: prompt, key: Date.now() });
       }
       setNewDeckRetryFiles(filesForGeneration);
       deleteDeck(deckId);
       toast.error(t("home.generationStartFailed"), {
-        description: t("home.generationStartFailedDescription"),
+        description: describeDeckPersistenceFailure(
+          persisted,
+          t("home.generationStartFailedDescription"),
+        ),
       });
       setShowNewDeckPrompt(true);
       return;
@@ -747,9 +753,14 @@ export default function Index() {
             noDefaultSlides: true,
           });
           const persisted = await ensureDeckPersisted(referenceDeck.id);
-          if (!persisted) {
+          if (!persisted.persisted) {
             deleteDeck(referenceDeck.id);
-            throw new Error("The PDF reference deck could not be saved.");
+            throw new Error(
+              describeDeckPersistenceFailure(
+                persisted,
+                "The PDF reference deck could not be saved.",
+              ),
+            );
           }
           try {
             const imported = (await callAction("import-file", {

package/corpus/templates/slides/app/routes/extensions._index.tsx

@@ -1,5 +1,5 @@
 import { Navigate } from "react-router";
 
 export default function ExtensionsRoute() {
-  return <Navigate to="/settings#extensions" replace />;
+  return <Navigate to="/settings/extensions" replace />;
 }

package/corpus/templates/slides/app/routes/settings.$.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./settings.js";

package/corpus/templates/slides/app/routes/team.tsx

@@ -7,5 +7,5 @@ export function meta() {
 }
 
 export default function TeamRoute() {
-  return <Navigate to="/settings#organization" replace />;
+  return <Navigate to="/settings/organization" replace />;
 }

package/corpus/templates/slides/changelog/2026-08-05-failed-deck-creation-and-reference-uploads-now-recover-clean.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-05
+---
+
+Failed deck creation and reference uploads now recover cleanly instead of leaving stuck drafts

package/corpus/templates/slides/changelog/2026-08-05-slides-recover-completed-generation-results-after-a-sync-hic.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-05
+---
+
+Slides recover completed generation results after a sync hiccup, and the agent prompt stays readable.

package/corpus/templates/slides/changelog/2026-08-05-website-url-imports-now-capture-hydrated-browser-computed-st.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+Website URL imports now capture hydrated browser-computed styles for more faithful deck themes.

package/corpus/templates/tasks/app/components/layout/Header.tsx

@@ -11,7 +11,9 @@ type Translate = ReturnType<typeof useT>;
 
 function resolveTitle(t: Translate, pathname: string): string {
   if (pathname === "/tasks") return t("header.pageTasks");
-  if (pathname === "/settings") return t("header.pageSettings");
+  if (pathname === "/settings" || pathname.startsWith("/settings/")) {
+    return t("header.pageSettings");
+  }
   if (pathname === "/team") return t("header.pageTeam");
   if (pathname.startsWith("/extensions")) return t("header.pageExtensions");
   return APP_TITLE;

package/corpus/templates/tasks/app/routes/extensions._index.tsx

@@ -8,5 +8,5 @@ export function meta() {
 }
 
 export default function ExtensionsRoute() {
-  return <Navigate to="/settings#extensions" replace />;
+  return <Navigate to="/settings/extensions" replace />;
 }

package/corpus/templates/tasks/app/routes/settings.$.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./settings.js";

package/dist/agent/engine/ai-sdk-engine.js

@@ -193,9 +193,14 @@ class AISDKEngine {
         // `builder-engine` and `anthropic-engine` already fail closed here; this
         // engine was the only one that did not.
         //
-        // A configured `baseUrl` is exempt: a self-hosted or local gateway may
-        // legitimately accept unauthenticated requests.
-        if (!this.apiKey && !this.baseUrl && this.requiredEnvVars.length > 0) {
+        // A LOCAL `baseUrl` is exempt: a self-hosted gateway on the same machine or
+        // private network may legitimately accept unauthenticated requests. A public
+        // one may not — every hosted provider requires a key, so exempting any
+        // baseUrl at all reopened the same doomed unauthenticated request this
+        // guard exists to stop, just for anyone pointing at a remote gateway.
+        if (!this.apiKey &&
+            !isLocalBaseUrl(this.baseUrl) &&
+            this.requiredEnvVars.length > 0) {
             yield {
                 type: "stop",
                 reason: "error",
@@ -531,6 +536,47 @@ async function importProviderPackage(provider) {
             return import("ai-sdk-ollama");
     }
 }
+/**
+ * True only for a gateway on this machine or a private network — the case the
+ * keyless exemption was written for. Anything routable on the public internet
+ * (openrouter.ai, an api.* host, a cloud proxy) needs credentials, so treating
+ * it as keyless just sends a request that cannot succeed.
+ *
+ * An unparseable value is NOT local: this gates a security-shaped decision, so
+ * the ambiguous case has to take the safe branch and require a key.
+ */
+function isLocalBaseUrl(baseUrl) {
+    if (!baseUrl)
+        return false;
+    let host;
+    try {
+        host = new URL(baseUrl).hostname.toLowerCase();
+    }
+    catch (error) {
+        // An invalid URL is never a local exemption; fail closed.
+        if (error instanceof TypeError)
+            return false;
+        throw error;
+    }
+    if (host === "localhost" || host.endsWith(".localhost"))
+        return true;
+    if (host === "::1" || host === "[::1]")
+        return true;
+    if (host.endsWith(".local") || host.endsWith(".internal"))
+        return true;
+    // IPv4 loopback and the RFC1918 private ranges.
+    const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    if (!v4)
+        return false;
+    const [a, b] = [Number(v4[1]), Number(v4[2])];
+    if (a === 127 || a === 10)
+        return true;
+    if (a === 192 && b === 168)
+        return true;
+    if (a === 172 && b >= 16 && b <= 31)
+        return true;
+    return false;
+}
 function capitalize(s) {
     return s.charAt(0).toUpperCase() + s.slice(1);
 }

package/dist/agent/production-agent.d.ts

@@ -922,6 +922,7 @@ export interface ChainServerDrivenContinuationDeps {
     updateRunStatusIfRunning?: typeof updateRunStatusIfRunning;
     markRunAborted?: typeof markRunAborted;
     setRunTerminalReason?: typeof setRunTerminalReason;
+    setRunError?: typeof setRunError;
     recordRunDiagnostic?: typeof recordRunDiagnostic;
     markBackgroundContinuationChunkTerminal?: typeof markBackgroundContinuationChunkTerminal;
     generateRunId?: typeof generateRunId;

package/dist/agent/production-agent.js

@@ -5271,6 +5271,7 @@ export async function chainServerDrivenContinuation(opts) {
         updateRunStatusIfRunning: opts.deps?.updateRunStatusIfRunning ?? updateRunStatusIfRunning,
         markRunAborted: opts.deps?.markRunAborted ?? markRunAborted,
         setRunTerminalReason: opts.deps?.setRunTerminalReason ?? setRunTerminalReason,
+        setRunError: opts.deps?.setRunError ?? setRunError,
         recordRunDiagnostic: opts.deps?.recordRunDiagnostic ?? recordRunDiagnostic,
         markBackgroundContinuationChunkTerminal: opts.deps?.markBackgroundContinuationChunkTerminal ??
             markBackgroundContinuationChunkTerminal,
@@ -5545,6 +5546,13 @@ export async function chainServerDrivenContinuation(opts) {
             await d
                 .setRunTerminalReason(runId, "background_continuation_dispatch_failed")
                 .catch(() => { });
+            // Record the cause on the row itself, not only inside diag_stage's JSON.
+            // Without this the run goes terminal with error_code and error_detail
+            // both NULL, so every dashboard and query reads it as a failure with no
+            // known cause and the real message is only findable by parsing a blob.
+            await d
+                .setRunError(runId, "background_continuation_dispatch_failed", chainErr instanceof Error ? chainErr.message : String(chainErr))
+                .catch(() => { });
         }
     }
 }

package/dist/agent/types.d.ts

@@ -275,6 +275,13 @@ export type AgentChatEvent = {
     /** Remote task to resume when status is pending/input-required. */
     taskId?: string;
     durationMs?: number;
+    /**
+     * Why the call ended, on a terminal status. Already computed for
+     * telemetry; without it here the persisted event says only that a
+     * cross-app call failed after N ms and never why, so a failed A2A call
+     * cannot be diagnosed from the database without a repro.
+     */
+    terminalCode?: string;
 } | {
     /**
      * Periodic liveness for an in-flight cross-app A2A call. Emitted by the

package/dist/client/agent-chat-adapter.d.ts

@@ -14,7 +14,7 @@ export type AgentChatSurfaceKind =
 /** Chat hosted by Desktop for a local app with explicit code access. */
  | "desktop";
 export declare const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 210000;
-export declare const MAX_FOLLOWED_BACKGROUND_RUNS = 6;
+export declare const MAX_FOLLOWED_BACKGROUND_RUNS = 24;
 export declare const MAX_BACKGROUND_FOLLOW_WALL_TIME_MS: number;
 /**
  * Server truth for "does this run still look alive?", used to keep the client

package/dist/client/agent-chat-adapter.js

@@ -131,8 +131,30 @@ export const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 210_000;
 // every poll tick and the follow loop never exits (prod: 26 chained runs over
 // 22 minutes, all error:stale_run, user watching a spinner). These bound the
 // whole turn instead, and an identical repeated failure counts as no progress.
-export const MAX_FOLLOWED_BACKGROUND_RUNS = 6;
-export const MAX_BACKGROUND_FOLLOW_WALL_TIME_MS = 10 * 60_000;
+//
+// CLIENT-ABOVE-SERVER INVARIANT (asserted in agent-chat-adapter.spec.ts).
+// These are a backstop for a server that has gone silent in a way the idle
+// timeout misses — NOT the primary limit. They must stay ABOVE the server's
+// own ceilings so the server, which can actually tell progress from looping,
+// always terminates a turn first and writes a truthful terminal reason:
+//   BACKGROUND_SOFT_TIMEOUT_CEILING_MS  (13 min, run-manager.ts)  — one chunk
+//   MAX_TURN_WALL_CLOCK_MS              (90 min, production-agent.ts) — one turn
+//   MAX_BACKGROUND_RUN_CONTINUATIONS    (20,     production-agent.ts)
+//
+// They were originally set to 10 min / 6 runs, which put the whole-turn client
+// budget BELOW the 13-minute ceiling of a single legal chunk. Any turn needing
+// a second full-length chunk was killed by the client while the server was
+// healthy and had 80 minutes left — measured in prod as turns dying at 11-25
+// minutes with `last_progress_at` tracking the abort, i.e. still streaming
+// tokens and completing tools when the client gave up. That is the top
+// non-auth cause of "the chat just stopped" reports.
+//
+// Killing a turn that is NOT progressing is already covered twice over, by
+// mechanisms that read progress rather than a clock: the 210s idle timeout
+// above, and MAX_REPEATED_BACKGROUND_TERMINAL_REASONS below. Do not re-tighten
+// these two to catch a stuck turn — fix the progress signal instead.
+export const MAX_FOLLOWED_BACKGROUND_RUNS = 24;
+export const MAX_BACKGROUND_FOLLOW_WALL_TIME_MS = 95 * 60_000;
 const MAX_REPEATED_BACKGROUND_TERMINAL_REASONS = 3;
 // A re-observed terminal run whose outcome would be an ERROR (never a
 // genuine "done" success) gets a short extra grace window before the follow
@@ -2185,7 +2207,12 @@ export function createAgentChatAdapter(options) {
                         if (Date.now() - followStartedAt >=
                             MAX_BACKGROUND_FOLLOW_WALL_TIME_MS) {
                             yield* stopBackgroundTurnBeforeReporting({
-                                message: `The agent kept restarting this step for ${Math.round(MAX_BACKGROUND_FOLLOW_WALL_TIME_MS / 60_000)} minutes without finishing it. It was stopped so you can retry from the preserved chat context — a smaller request usually gets through.`,
+                                // Says only what this backstop actually knows. It fires on a
+                                // clock, so it cannot tell a looping turn from one that was
+                                // still working — the old copy asserted "kept restarting
+                                // without finishing", which prod runs contradicted: they were
+                                // streaming tokens right up to the abort.
+                                message: `This turn ran for ${Math.round(MAX_BACKGROUND_FOLLOW_WALL_TIME_MS / 60_000)} minutes without finishing, so it was stopped. Your chat context is preserved — retrying, or splitting this into smaller requests, usually gets through.`,
                                 errorCode: "background_follow_time_budget_exhausted",
                                 details: `followed_runs: ${followedRunIds.size}`,
                             });

package/dist/client/agent-page/AgentWorkspaceContent.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-export type AgentWorkspaceTab = "overview" | "resources" | "automations" | "agents" | "access";
+export type AgentWorkspaceTab = "overview" | "resources" | "automations" | "agents";
 export declare function AgentWorkspaceContent({ overview, className, activeTab, }: {
     overview: ReactNode;
     activeTab: AgentWorkspaceTab;

package/dist/client/agent-page/AgentWorkspaceContent.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { IconBook2, IconBolt, IconChecklist, IconFolder, IconHierarchy2, IconHistory, IconNotes, IconShieldLock, IconTopologyRing2, } from "@tabler/icons-react";
+import { IconBook2, IconBolt, IconChecklist, IconFolder, IconHierarchy2, IconHistory, IconNotes, IconTopologyRing2, } from "@tabler/icons-react";
 import { lazy, Suspense, useEffect, useState } from "react";
 import { AgentsSection } from "../settings/AgentsSection.js";
 import { cn } from "../utils.js";
@@ -21,7 +21,6 @@ const HUB_TABS = [
     { id: "resources", label: "Resources", icon: IconFolder },
     { id: "automations", label: "Automations", icon: IconBolt },
     { id: "agents", label: "Connected agents", icon: IconTopologyRing2 },
-    { id: "access", label: "Access", icon: IconShieldLock },
 ];
 const RESOURCE_IDS = new Set(RESOURCE_TABS.map((tab) => tab.id));
 function normalizeHash(value) {
@@ -31,9 +30,15 @@ function initialHubState() {
     if (typeof window === "undefined") {
         return { tab: "overview", resource: "files" };
     }
+    const pathParts = window.location.pathname.split("/").filter(Boolean);
+    const settingsIndex = pathParts.indexOf("settings");
+    const settingsPath = settingsIndex === -1 ? [] : pathParts.slice(settingsIndex + 1);
+    const routeParts = settingsPath[0] === "agent" ? settingsPath : ["agent", ...settingsPath];
     const hash = normalizeHash(window.location.hash);
-    const parts = hash.split(":");
-    const scoped = parts[0] === "agent";
+    const hashParts = hash.split(":");
+    const pathScoped = settingsPath[0] === "agent";
+    const scoped = pathScoped || hashParts[0] === "agent";
+    const parts = pathScoped ? routeParts : hashParts;
     const requested = scoped ? parts[1] : hash;
     const resource = scoped && RESOURCE_IDS.has(parts[2])
         ? parts[2]
@@ -54,8 +59,6 @@ function initialHubState() {
         requested === "remote-agents") {
         return { tab: "agents", resource };
     }
-    if (requested === "access")
-        return { tab: "access", resource };
     return { tab: "overview", resource };
 }
 function ResourceContent({ resource }) {
@@ -65,8 +68,8 @@ function ResourceContent({ resource }) {
                     const selected = tab.id === resource;
                     return (_jsxs("button", { type: "button", onClick: () => {
                             if (typeof window !== "undefined") {
-                                window.history.pushState(null, "", `${window.location.pathname}${window.location.search}#agent:resources:${tab.id}`);
-                                window.dispatchEvent(new Event("hashchange"));
+                                window.history.pushState(null, "", `/settings/agent/resources/${tab.id}${window.location.search}`);
+                                window.dispatchEvent(new Event("popstate"));
                             }
                         }, className: cn("inline-flex shrink-0 items-center gap-1.5 rounded-md px-2.5 py-1.5 text-xs font-medium transition-colors", selected
                             ? "bg-accent text-foreground"
@@ -75,9 +78,6 @@ function ResourceContent({ resource }) {
                             ? "Add context the agent can use across conversations."
                             : "Manage the resources that shape how the agent works." })] }), _jsx(Suspense, { fallback: _jsx("div", { className: "h-48 animate-pulse rounded-xl border border-border bg-muted/20" }), children: _jsx(ResourcesPanel, { showMcpServers: false, resourceFilter: resource, resourceTreeVariant: "collection", scope: "personal" }, resource) })] }));
 }
-function AccessContent() {
-    return (_jsx("div", { children: _jsx("div", { className: "rounded-xl border border-border/70 bg-card text-card-foreground", children: _jsx("div", { className: "px-5 py-5 sm:px-6", children: _jsxs("div", { className: "flex items-start gap-3", children: [_jsx("span", { className: "flex size-9 shrink-0 items-center justify-center rounded-lg border border-border bg-background text-muted-foreground", children: _jsx(IconShieldLock, { className: "size-4" }) }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "text-sm font-medium text-foreground", children: "Agent access" }), _jsx("p", { className: "mt-1 text-sm leading-5 text-muted-foreground", children: "Use the agent card and MCP endpoints from connected clients." })] })] }) }) }) }));
-}
 export function AgentWorkspaceContent({ overview, className, activeTab, }) {
     const [{ resource }, setState] = useState(initialHubState);
     useEffect(() => {
@@ -98,8 +98,8 @@ export function AgentWorkspaceContent({ overview, className, activeTab, }) {
                 ? "Schedule and manage agent tasks."
                 : activeTab === "agents"
                     ? "Connect agents to delegate work from chat."
-                    : "Control how other apps and agents access this agent.";
-    return (_jsxs("div", { className: cn("w-full space-y-6", className), children: [_jsxs("header", { className: "space-y-1", children: [_jsx("h1", { className: "text-2xl font-semibold tracking-tight text-foreground", children: activeTab === "overview" ? "Agent" : page?.label }), _jsx("p", { className: "text-sm leading-5 text-muted-foreground", children: pageDescription })] }), activeTab === "overview" && overview, activeTab === "resources" && _jsx(ResourceContent, { resource: resource }), activeTab === "automations" && (_jsx(Suspense, { fallback: _jsx("div", { className: "h-48 animate-pulse rounded-xl border border-border bg-muted/20" }), children: _jsx(AgentJobsTab, { scope: "user", canManageOrg: true, hideHeader: true }) })), activeTab === "agents" && _jsx(AgentsSection, {}), activeTab === "access" && _jsx(AccessContent, {})] }));
+                    : "Configure how your agent works, what it knows, and what it can do.";
+    return (_jsxs("div", { className: cn("w-full space-y-6", className), children: [_jsxs("header", { className: "space-y-1", children: [_jsx("h1", { className: "text-2xl font-semibold tracking-tight text-foreground", children: activeTab === "overview" ? "Agent" : page?.label }), _jsx("p", { className: "text-sm leading-5 text-muted-foreground", children: pageDescription })] }), activeTab === "overview" && overview, activeTab === "resources" && _jsx(ResourceContent, { resource: resource }), activeTab === "automations" && (_jsx(Suspense, { fallback: _jsx("div", { className: "h-48 animate-pulse rounded-xl border border-border bg-muted/20" }), children: _jsx(AgentJobsTab, { scope: "user", canManageOrg: true, hideHeader: true }) })), activeTab === "agents" && _jsx(AgentsSection, {})] }));
 }
 export function agentWorkspaceTabHash(tab) {
     return `agent:${tab}`;

package/dist/client/chat/run-recovery.js

@@ -227,7 +227,11 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
     const canRecover = info.recoverable === true;
     const shouldShowBuilderReconnect = isBuilderReconnectRunError(info);
     const isProviderAuthError = isProviderAuthenticationError([info.message, info.details].filter(Boolean).join("\n"), info.errorCode);
-    const canRetry = canRecover || isProviderAuthError;
+    // Blocked on something the reader goes and fixes elsewhere, then comes back
+    // to. Without a retry the card is a dead end and its own copy ("then retry")
+    // points at a button that isn't there.
+    const isUnblockableExternally = info.errorCode === "email_verification_required";
+    const canRetry = canRecover || isProviderAuthError || isUnblockableExternally;
     const builderReconnectResolved = shouldShowBuilderReconnect &&
         builderReconnect.hasFetchedStatus &&
         builderReconnect.configured;