@agent-native/core 0.137.7 → 0.137.8

package/dist/client/use-session.d.ts

@@ -1,8 +1,19 @@
 import type { AuthSession } from "../server/auth.js";
 export type { AuthSession };
+/**
+ * `"unavailable"` is the session endpoint being unreadable — a 5xx, a network
+ * failure, or a timeout. It is NOT the visitor being signed out, and a caller
+ * that collapses the two either strands the user on a spinner forever or
+ * bounces a signed-in user to the sign-in page over a transient blip.
+ */
+export type SessionStatus = "loading" | "authenticated" | "unauthenticated" | "unavailable";
 interface UseSessionResult {
     session: AuthSession | null;
     isLoading: boolean;
+    status: SessionStatus;
+    error: Error | null;
+    /** Restart the resolve loop, e.g. from a "Try again" control. */
+    retry: () => void;
 }
 /**
  * Client-side hook to get the current auth session.

package/dist/client/use-session.js

@@ -1,8 +1,9 @@
-import { useEffect, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { setSentryUser, trackSessionStatus } from "./analytics.js";
 import { fetchAuthSessionStatus } from "./client-status-requests.js";
 const SESSION_CACHE_TTL_MS = 30_000;
 const SESSION_RETRY_DELAY_MS = 1_000;
+const SESSION_MAX_ATTEMPTS = 4;
 let cachedSession;
 let cachedSessionAt = 0;
 let sessionRequest;
@@ -65,22 +66,41 @@ function fetchSharedSession() {
 export function useSession() {
     const cached = hasFreshSessionCache() ? (cachedSession ?? null) : null;
     const [session, setSession] = useState(cached);
-    const [isLoading, setIsLoading] = useState(!hasFreshSessionCache());
+    const [status, setStatus] = useState(() => {
+        if (!hasFreshSessionCache())
+            return "loading";
+        return cached ? "authenticated" : "unauthenticated";
+    });
+    const [error, setError] = useState(null);
+    const [retryToken, setRetryToken] = useState(0);
+    const retry = useCallback(() => {
+        setError(null);
+        setStatus("loading");
+        setRetryToken((token) => token + 1);
+    }, []);
     useEffect(() => {
         let cancelled = false;
         let retryTimer;
+        let attempts = 0;
         const resolveSession = async () => {
             const resolved = await fetchSharedSession();
             if (cancelled)
                 return;
             if (resolved === undefined) {
+                attempts += 1;
+                if (attempts >= SESSION_MAX_ATTEMPTS) {
+                    setError(new Error(`Could not read the session after ${attempts} attempts.`));
+                    setStatus("unavailable");
+                    return;
+                }
                 retryTimer = setTimeout(() => {
                     void resolveSession();
-                }, SESSION_RETRY_DELAY_MS);
+                }, SESSION_RETRY_DELAY_MS * attempts);
                 return;
             }
             setSession(resolved);
-            setIsLoading(false);
+            setError(null);
+            setStatus(resolved ? "authenticated" : "unauthenticated");
         };
         void resolveSession();
         return () => {
@@ -88,7 +108,15 @@ export function useSession() {
             if (retryTimer)
                 clearTimeout(retryTimer);
         };
-    }, []);
-    return { session, isLoading };
+    }, [retryToken]);
+    // Callers that only read `isLoading`/`session` (most of the codebase, not
+    // yet migrated to `status`) must not see "unavailable" as "signed out" —
+    // that bounces an authenticated user through sign-in-only UI over a
+    // transient blip. Keeping `isLoading` true here reproduces this hook's
+    // pre-existing behavior for those callers (an indefinite "still resolving"
+    // instead of a wrong answer); only `status`-aware callers get the distinct
+    // "unavailable" treatment with a retry affordance.
+    const isLoading = status === "loading" || status === "unavailable";
+    return { session, isLoading, status, error, retry };
 }
 //# sourceMappingURL=use-session.js.map

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/notifications/routes.d.ts

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -28,7 +28,7 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.137.7",
+  "version": "0.137.8",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {