@agent-native/core 0.92.0 → 0.92.1

package/corpus/README.md

@@ -28,4 +28,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 ## Generated Counts
 
 - core files: 2153
-- template files: 5000
+- template files: 5035

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @agent-native/core
 
+## 0.92.1
+
+### Patch Changes
+
+- 1d13434: Allow extension iframes to trigger user-initiated downloads and add CSV export to standard data table widgets.
+- 1d13434: Remove the GitHub icon from the free and open source badge on public booking pages.
+- 1d13434: Make framework polling cheaper with durable sync events, remove Dispatch's short app-list polling intervals, preview large DB admin cells by default to avoid accidental blob transfers, and require configured file storage for binary resource uploads instead of storing base64 blobs in SQL.
+- 1d13434: Stage database-admin table selections as agent chat context chips and selected-object application state so users can ask the agent about the active table.
+- 1d13434: Show a clear unavailable state for shared extension links that the viewer cannot access, instead of leaving the standalone extension page looking blank.
+- 1d13434: Filter known browser and extension noise from first-party error auto-capture while preserving real app fetch failures.
+- 1d13434: Recover stale background chat runs instead of surfacing them as terminal failures, and keep chat handoffs from restoring stale server snapshots over fresher completed replies.
+- 1d13434: Fix durable polling cursors, DB admin large-cell safeguards, extension unavailable states, and stale chat snapshot handling.
+- 1d13434: Show organization access controls alongside long team member lists when the Team settings surface has enough width.
+
 ## 0.92.0
 
 ### Minor Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.92.0",
+  "version": "0.92.1",
   "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": {

package/corpus/core/src/application-state/store.ts

@@ -1,5 +1,6 @@
 import {
   getDbExec,
+  isLocalDatabase,
   isConnectionError,
   isPostgres,
   intType,
@@ -10,6 +11,7 @@ import type { StoreWriteOptions } from "../settings/store.js";
 import { emitAppStateChange, emitAppStateDelete } from "./emitter.js";
 
 let _initPromise: Promise<void> | undefined;
+const MAX_HOSTED_APP_STATE_VALUE_BYTES = 1024 * 1024;
 
 // Escapes LIKE wildcards (`%`, `_`) and the escape char itself so a caller's
 // literal prefix is matched verbatim. Used with `ESCAPE '!'` in prefix queries
@@ -123,11 +125,20 @@ export async function appStatePut(
 ): Promise<void> {
   await ensureTable();
   const client = getDbExec();
+  const serialized = JSON.stringify(value);
+  if (
+    !isLocalDatabase() &&
+    Buffer.byteLength(serialized, "utf8") > MAX_HOSTED_APP_STATE_VALUE_BYTES
+  ) {
+    throw new Error(
+      `application_state value "${key}" is too large for hosted SQL storage. Store large files, base64, or blobs in file storage and write only a URL or handle.`,
+    );
+  }
   await client.execute({
     sql: isPostgres()
       ? `INSERT INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?) ON CONFLICT (session_id, key) DO UPDATE SET value=EXCLUDED.value, updated_at=EXCLUDED.updated_at`
       : `INSERT OR REPLACE INTO application_state (session_id, key, value, updated_at) VALUES (?, ?, ?, ?)`,
-    args: [sessionId, key, JSON.stringify(value), Date.now()],
+    args: [sessionId, key, serialized, Date.now()],
   });
   emitAppStateChange(key, options?.requestSource, sessionId);
 }

package/corpus/core/src/client/AssistantChat.tsx

@@ -1894,7 +1894,9 @@ const AssistantChatInner = forwardRef<
             repo,
           );
         } catch {
-          shouldImport = true;
+          // If the runtime/export comparison itself fails, do not fail open by
+          // importing a server snapshot that may be stale relative to local UI.
+          shouldImport = false;
         }
         if (shouldImport) {
           if (options?.markTitleGenerated) {
@@ -1907,7 +1909,7 @@ const AssistantChatInner = forwardRef<
           settled = false;
         }
       }
-      if (Array.isArray(repo?.queuedMessages)) {
+      if (settled && Array.isArray(repo?.queuedMessages)) {
         const incomingQueue = repo.queuedMessages as QueuedMessage[];
         const incomingSerialized = JSON.stringify(incomingQueue);
         const currentSerialized = JSON.stringify(queuedMessagesRef.current);
@@ -2521,18 +2523,29 @@ const AssistantChatInner = forwardRef<
                 markTitleGenerated: true,
               });
               if (repo) {
-                const { title, preview } = extractThreadMeta(repo);
-                writeCachedThreadSnapshot(apiUrl, threadId, {
-                  threadData:
-                    typeof data.threadData === "string"
-                      ? data.threadData
-                      : JSON.stringify(data.threadData),
-                  title: data.title || title,
-                  preview,
-                  messageCount: Array.isArray(repo.messages)
-                    ? repo.messages.length
-                    : 0,
-                });
+                let shouldCacheServerSnapshot = true;
+                try {
+                  shouldCacheServerSnapshot = shouldImportServerThreadData(
+                    normalizeThreadRepository(threadRuntime.export()),
+                    repo,
+                  );
+                } catch {
+                  shouldCacheServerSnapshot = false;
+                }
+                if (shouldCacheServerSnapshot) {
+                  const { title, preview } = extractThreadMeta(repo);
+                  writeCachedThreadSnapshot(apiUrl, threadId, {
+                    threadData:
+                      typeof data.threadData === "string"
+                        ? data.threadData
+                        : JSON.stringify(data.threadData),
+                    title: data.title || title,
+                    preview,
+                    messageCount: Array.isArray(repo.messages)
+                      ? repo.messages.length
+                      : 0,
+                  });
+                }
               }
             }
             // Also skip title generation if thread already has a title

package/corpus/core/src/client/PoweredByBadge.tsx

@@ -1,4 +1,3 @@
-import { IconBrandGithub } from "@tabler/icons-react";
 import type { CSSProperties } from "react";
 
 import { appPath } from "./api-path.js";
@@ -192,7 +191,7 @@ export function PoweredByBadge({
 }
 
 /**
- * Small GitHub badge: "Free and open source"
+ * Small badge: "Free and open source"
  *
  * Intended to pair with PoweredByBadge on public pages.
  */
@@ -209,11 +208,6 @@ export function OpenSourceBadge({
   return (
     <>
       <style>{`
-        .an-open-source-badge svg {
-          width: 15px;
-          height: 15px;
-          flex: none;
-        }
         .an-open-source-badge {
           background: transparent !important;
           border-color: transparent !important;
@@ -283,7 +277,6 @@ export function OpenSourceBadge({
             : containerStyle(position)
         }
       >
-        <IconBrandGithub aria-hidden="true" stroke={1.8} />
         <span>Free and open source</span>
       </a>
     </>

package/corpus/core/src/client/agent-chat-adapter.ts

@@ -2276,7 +2276,11 @@ export function createAgentChatAdapter(
         // ends the turn from the client side.
         const followBackgroundTurn = async function* (
           initialSignal: AgentAutoContinueSignal,
-        ): AsyncGenerator<ChatModelRunResult, void, unknown> {
+        ): AsyncGenerator<
+          ChatModelRunResult,
+          "completed" | "client_continue",
+          unknown
+        > {
           lastAutoContinueReason = initialSignal.reason;
           if (initialSignal.activityTrail.length > 0) {
             lastActivityTrail = [...initialSignal.activityTrail];
@@ -2310,7 +2314,7 @@ export function createAgentChatAdapter(
           while (true) {
             if (abortSignal.aborted) {
               clearActiveRun();
-              return;
+              return "completed";
             }
             let active: Record<string, unknown> | null = null;
             try {
@@ -2324,7 +2328,7 @@ export function createAgentChatAdapter(
             } catch (pollErr: unknown) {
               if (pollErr instanceof Error && pollErr.name === "AbortError") {
                 clearActiveRun();
-                return;
+                return "completed";
               }
               // Transient poll failure — counts as "no active run" this tick.
             }
@@ -2351,8 +2355,25 @@ export function createAgentChatAdapter(
               const isTerminal =
                 activeStatus === "completed" || activeStatus === "errored";
               if (isTerminal && replayedTerminalRunIds.has(activeRunId)) {
+                if (
+                  lastAutoContinueReason === "stale_run" &&
+                  lastRecoverableRunError?.errorCode === "stale_run"
+                ) {
+                  const continuation = prepareAutoContinuation(
+                    new AgentAutoContinueSignal({
+                      reason: "stale_run",
+                      errorInfo: lastRecoverableRunError,
+                      activityTrail: lastActivityTrail,
+                    }),
+                  );
+                  if (continuation.ok) {
+                    dispatchResumingUiEvent();
+                    await delay(250, abortSignal);
+                    return "client_continue";
+                  }
+                }
                 yield* emitBackgroundTerminalOutcome(active);
-                return;
+                return "completed";
               }
               const previousRunId = runId;
               runId = activeRunId;
@@ -2365,7 +2386,7 @@ export function createAgentChatAdapter(
               }
               const attach = yield* followAttachOnce();
               if (attach === "completed" || attach === "aborted") {
-                return;
+                return "completed";
               }
               if (isTerminal) {
                 replayedTerminalRunIds.add(activeRunId);
@@ -2387,7 +2408,7 @@ export function createAgentChatAdapter(
                   BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS
                 ) {
                   yield* emitBackgroundTerminalOutcome(lastSeenActive);
-                  return;
+                  return "completed";
                 }
               }
               dispatchResumingUiEvent();
@@ -2407,13 +2428,13 @@ export function createAgentChatAdapter(
                   },
                 );
                 yield* emitBackgroundTerminalOutcome(lastSeenActive);
-                return;
+                return "completed";
               }
             }
             await delay(BACKGROUND_FOLLOW_POLL_INTERVAL_MS, abortSignal);
             if (abortSignal.aborted) {
               clearActiveRun();
-              return;
+              return "completed";
             }
           }
         };
@@ -3003,7 +3024,10 @@ export function createAgentChatAdapter(
               // client/server recovery race: client watchdog signals here are
               // just "reattach", not "recover".
               if (shouldFollowServerContinuation(err) && threadId) {
-                yield* followBackgroundTurn(err);
+                const followOutcome = yield* followBackgroundTurn(err);
+                if (followOutcome === "client_continue") {
+                  continue;
+                }
                 return;
               }
               if (err.reason === "no_progress") {
@@ -3182,9 +3206,12 @@ export function createAgentChatAdapter(
             // before any response headers arrived has no dispatch mode yet
             // and keeps the foreground startup-retry path.)
             if (shouldFollowServerContinuation() && threadId) {
-              yield* followBackgroundTurn(
+              const followOutcome = yield* followBackgroundTurn(
                 new AgentAutoContinueSignal({ reason: "stream_ended" }),
               );
+              if (followOutcome === "client_continue") {
+                continue;
+              }
               return;
             }
 

package/corpus/core/src/client/chat/widgets/DataTableWidget.tsx

@@ -1,8 +1,20 @@
-import { IconExternalLink, IconTable } from "@tabler/icons-react";
+import {
+  IconDots,
+  IconDownload,
+  IconExternalLink,
+  IconTable,
+} from "@tabler/icons-react";
 
 import { requestAgentSidebarOpen } from "../../agent-sidebar-state.js";
 import { appPath } from "../../api-path.js";
 import { startAgentChatViewTransition } from "../../chat-view-transition.js";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "../../components/ui/dropdown-menu.js";
+import { downloadFile, toCSVTable } from "../../db-admin/export-utils.js";
 import { cn } from "../../utils.js";
 import type { DataTableWidget as DataTableWidgetData } from "./data-widget-types.js";
 
@@ -82,6 +94,15 @@ function navigateSameAppHref(href: string): void {
   });
 }
 
+function slugifyFilenamePart(value: string | undefined): string {
+  const slug = (value ?? "data-table")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  return slug || "data-table";
+}
+
 export function DataTableWidget({
   table,
   action,
@@ -91,6 +112,19 @@ export function DataTableWidget({
 }) {
   const rows = table.rows ?? [];
   const actionHref = action ? normalizeActionHref(action.href) : null;
+  const canExportCsv = table.columns.length > 0;
+  const exportCsv = () => {
+    if (!canExportCsv) return;
+    const stamp = new Date().toISOString().slice(0, 10);
+    downloadFile(
+      `${slugifyFilenamePart(table.title)}-${stamp}.csv`,
+      "text/csv;charset=utf-8",
+      toCSVTable(
+        table.columns.map((column) => column.label),
+        rows.map((row) => table.columns.map((column) => row[column.key])),
+      ),
+    );
+  };
 
   return (
     <div className="my-1.5 overflow-hidden rounded-lg border border-border bg-background text-foreground shadow-sm">
@@ -131,6 +165,23 @@ export function DataTableWidget({
             <IconExternalLink className="h-3 w-3" />
           </a>
         ) : null}
+        <DropdownMenu>
+          <DropdownMenuTrigger asChild>
+            <button
+              type="button"
+              aria-label="Data table options"
+              className="inline-flex size-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
+            >
+              <IconDots className="h-3.5 w-3.5" />
+            </button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end" className="w-44">
+            <DropdownMenuItem onSelect={exportCsv} disabled={!canExportCsv}>
+              <IconDownload className="mr-2 h-3.5 w-3.5" />
+              Download CSV
+            </DropdownMenuItem>
+          </DropdownMenuContent>
+        </DropdownMenu>
       </div>
       <div className="max-h-[360px] overflow-auto">
         <table className="w-full min-w-[420px] border-collapse text-xs">

package/corpus/core/src/client/db-admin/TableEditor.tsx

@@ -7,6 +7,8 @@ import {
   IconCode,
   IconArrowBackUp,
   IconDeviceFloppy,
+  IconDots,
+  IconDownload,
   IconChevronLeft,
   IconChevronRight,
   IconChevronsLeft,
@@ -25,6 +27,12 @@ import type {
   DbAdminSort,
   DbAdminMutationResult,
 } from "../../db-admin/types.js";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "../components/ui/dropdown-menu.js";
 import {
   Popover,
   PopoverContent,
@@ -33,6 +41,7 @@ import {
 import { cn } from "../utils.js";
 import { useChangeset, pkStringFor } from "./changeset.js";
 import { DataGrid, type GridRow, type ActiveCell } from "./DataGrid.js";
+import { downloadFile, toCSVTable } from "./export-utils.js";
 import { FilterBar } from "./FilterBar.js";
 import { RowSidePanel, type RowSidePanelMode } from "./RowSidePanel.js";
 import { loadGridState, saveGridState } from "./storage.js";
@@ -54,6 +63,15 @@ export interface TableEditorProps {
 const DEFAULT_PAGE_SIZE = 100;
 const PAGE_SIZES = [25, 50, 100, 250, 500];
 
+function slugifyFilenamePart(value: string): string {
+  const slug = value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  return slug || "table";
+}
+
 export function TableEditor({
   table,
   dialect: _dialect,
@@ -300,6 +318,20 @@ export function TableEditor({
   }
 
   const noPk = schema.primaryKey.length === 0;
+  const exportCurrentPageCsv = () => {
+    const columns = schema.columns.map((column) => column.name);
+    const stamp = new Date().toISOString().slice(0, 10);
+    downloadFile(
+      `${slugifyFilenamePart(table)}-${stamp}.csv`,
+      "text/csv;charset=utf-8",
+      toCSVTable(
+        columns,
+        gridRows
+          .filter((row) => !row.isDeleted)
+          .map((row) => columns.map((column) => row.values[column])),
+      ),
+    );
+  };
 
   return (
     <div className="flex h-full min-h-0 flex-col">
@@ -337,6 +369,23 @@ export function TableEditor({
                 primary
               />
             )}
+            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
+                <button
+                  type="button"
+                  aria-label="Table options"
+                  className="inline-flex h-7 w-7 cursor-pointer items-center justify-center rounded-md border border-border text-muted-foreground hover:bg-muted hover:text-foreground"
+                >
+                  <IconDots className="h-3.5 w-3.5" />
+                </button>
+              </DropdownMenuTrigger>
+              <DropdownMenuContent align="end" className="w-44">
+                <DropdownMenuItem onSelect={exportCurrentPageCsv}>
+                  <IconDownload className="mr-2 h-3.5 w-3.5" />
+                  Download CSV
+                </DropdownMenuItem>
+              </DropdownMenuContent>
+            </DropdownMenu>
           </div>
         </div>
 

package/corpus/core/src/client/db-admin/export-utils.ts

@@ -16,6 +16,9 @@ function cellToCSV(value: unknown): string {
   } else {
     str = String(value);
   }
+  // Spreadsheet apps treat leading =, +, -, and @ as formulas. Prefix with an
+  // apostrophe so exported CSV opens as literal text instead of executing.
+  if (/^[=+\-@]/.test(str)) str = `'${str}`;
   // Quote when the value contains a comma, quote, CR, or LF. Escape embedded
   // double-quotes by doubling them (RFC 4180).
   if (/[",\r\n]/.test(str)) {
@@ -24,16 +27,22 @@ function cellToCSV(value: unknown): string {
   return str;
 }
 
+/** Render a matrix as RFC-4180-style CSV with a header row. */
+export function toCSVTable(headers: string[], rows: unknown[][]): string {
+  const header = headers.map(cellToCSV).join(",");
+  const body = rows.map((row) => row.map(cellToCSV).join(","));
+  return [header, ...body].join("\r\n");
+}
+
 /** Render rows as RFC-4180-style CSV with a header row of the given columns. */
 export function toCSV(
   columns: string[],
   rows: Record<string, unknown>[],
 ): string {
-  const header = columns.map(cellToCSV).join(",");
-  const body = rows.map((row) =>
-    columns.map((col) => cellToCSV(row[col])).join(","),
+  return toCSVTable(
+    columns,
+    rows.map((row) => columns.map((col) => row[col])),
   );
-  return [header, ...body].join("\r\n");
 }
 
 /** Render rows as a pretty-printed JSON array. */

package/corpus/core/src/client/db-admin/useAgentSync.ts

@@ -14,7 +14,16 @@
  */
 import { useEffect, useRef } from "react";
 
+import {
+  removeAgentChatContextItem,
+  setAgentChatContextItem,
+} from "../agent-chat.js";
 import { agentNativePath } from "../api-path.js";
+import {
+  deleteClientAppState,
+  readClientAppState,
+  setClientAppState,
+} from "../application-state.js";
 
 const NAVIGATION_PATH = agentNativePath(
   "/_agent-native/application-state/navigation",
@@ -24,6 +33,9 @@ const NAVIGATE_PATH = agentNativePath(
 );
 
 const POLL_INTERVAL_MS = 1500;
+const TABLE_CONTEXT_KEY = "database-selected-table";
+const SELECTED_OBJECT_STATE_KEY = "selected-object";
+const SELECTED_OBJECT_SOURCE_FIELD = "__agentNativeSelectedObjectSource";
 
 let cachedSource: string | null = null;
 
@@ -55,6 +67,23 @@ function headers(extra?: Record<string, string>): Record<string, string> {
   return h;
 }
 
+async function deleteSelectedObjectIfOwned(source: string | undefined) {
+  if (!source) return;
+  try {
+    const current = await readClientAppState<Record<string, unknown>>(
+      SELECTED_OBJECT_STATE_KEY,
+    );
+    if (current?.[SELECTED_OBJECT_SOURCE_FIELD] !== source) return;
+    await deleteClientAppState(SELECTED_OBJECT_STATE_KEY, {
+      keepalive: true,
+      requestSource: source,
+    });
+  } catch {
+    // Best effort only; stale selected-object context is less harmful than
+    // clearing a selection owned by another tab.
+  }
+}
+
 export interface DbAdminNavigationState {
   view: "database";
   table: string | null;
@@ -88,6 +117,49 @@ export function useDbAdminAgentSync({
       body: JSON.stringify(state),
     }).catch(() => {});
   }, [enabled, table, mode]);
+
+  useEffect(() => {
+    if (!enabled) return;
+    const source = requestSource();
+    if (!table) {
+      removeAgentChatContextItem({
+        key: TABLE_CONTEXT_KEY,
+        openSidebar: false,
+      });
+      deleteSelectedObjectIfOwned(source);
+      return;
+    }
+
+    const selection = {
+      type: "database-table",
+      table,
+      mode,
+      [SELECTED_OBJECT_SOURCE_FIELD]: source,
+    };
+    setAgentChatContextItem({
+      key: TABLE_CONTEXT_KEY,
+      title: `Table: ${table}`,
+      context: [
+        `The user currently has this database table selected: ${table}.`,
+        `Database admin mode: ${mode}`,
+        "Use the database admin actions and current-screen context to inspect rows, schema, or run SQL against this table.",
+      ].join("\n"),
+      openSidebar: false,
+      focus: false,
+    });
+    setClientAppState(SELECTED_OBJECT_STATE_KEY, selection, {
+      keepalive: true,
+      requestSource: source,
+    }).catch(() => {});
+
+    return () => {
+      removeAgentChatContextItem({
+        key: TABLE_CONTEXT_KEY,
+        openSidebar: false,
+      });
+      deleteSelectedObjectIfOwned(source);
+    };
+  }, [enabled, table, mode]);
 }
 
 interface NavigateCommand {