@agent-native/core 0.91.2 → 0.92.1

package/corpus/core/src/client/settings/SettingsSection.tsx

@@ -1,5 +1,36 @@
 import { IconChevronDown, IconCheck } from "@tabler/icons-react";
-import type { ReactNode } from "react";
+import { createContext, useContext, type ReactNode } from "react";
+
+import { cn } from "../utils.js";
+
+/**
+ * Where a settings section is being rendered.
+ *
+ * - `sidebar`: the compact agent sidebar panel (dense, small type).
+ * - `page`: the full-width settings page, styled as a polished card that
+ *   matches the shadcn `Card` surface used by app-owned settings tabs.
+ */
+export type SettingsSurface = "sidebar" | "page";
+
+const SettingsSurfaceContext = createContext<SettingsSurface>("sidebar");
+
+export function SettingsSurfaceProvider({
+  surface,
+  children,
+}: {
+  surface: SettingsSurface;
+  children: ReactNode;
+}) {
+  return (
+    <SettingsSurfaceContext.Provider value={surface}>
+      {children}
+    </SettingsSurfaceContext.Provider>
+  );
+}
+
+export function useSettingsSurface(): SettingsSurface {
+  return useContext(SettingsSurfaceContext);
+}
 
 interface SettingsSectionProps {
   id?: string;
@@ -15,10 +46,133 @@ interface SettingsSectionProps {
 }
 
 /**
- * Collapsible settings section card with icon, title, status dot, and optional badge.
- * Controlled via `open` / `onToggle` for accordion behaviour.
+ * Collapsible settings section. Renders as a compact row in the agent sidebar
+ * and as a polished, shadcn-style card on the full settings page (so the
+ * framework tabs match app-owned General/Team cards). The visual surface is
+ * read from `SettingsSurfaceContext`.
  */
-export function SettingsSection({
+export function SettingsSection(props: SettingsSectionProps) {
+  const surface = useSettingsSurface();
+  return surface === "page" ? (
+    <PageSettingsSection {...props} />
+  ) : (
+    <SidebarSettingsSection {...props} />
+  );
+}
+
+function ConnectedDot({ size }: { size: "sm" | "md" }) {
+  const dim = size === "sm" ? "h-4 w-4" : "h-5 w-5";
+  const stroke = size === "sm" ? 3 : 2.5;
+  const glyph = size === "sm" ? 10 : 12;
+  return (
+    <span
+      className={cn(
+        "flex shrink-0 items-center justify-center rounded-full bg-green-500/15 text-green-500",
+        dim,
+      )}
+    >
+      <IconCheck size={glyph} stroke={stroke} />
+    </span>
+  );
+}
+
+function StatusBadge({
+  label,
+  tone,
+  size,
+}: {
+  label: string;
+  tone: "muted" | "required";
+  size: "sm" | "md";
+}) {
+  return (
+    <span
+      className={cn(
+        "shrink-0 rounded-full font-semibold uppercase tracking-wide",
+        size === "sm" ? "px-1.5 py-0.5 text-[9px]" : "px-2 py-0.5 text-[10px]",
+        tone === "required"
+          ? "bg-amber-500/15 text-amber-600 dark:text-amber-400"
+          : "bg-muted text-muted-foreground",
+      )}
+    >
+      {label}
+    </span>
+  );
+}
+
+function PageSettingsSection({
+  id,
+  icon,
+  title,
+  subtitle,
+  badge,
+  required,
+  connected,
+  open = false,
+  onToggle,
+  children,
+}: SettingsSectionProps) {
+  return (
+    <div
+      id={id}
+      className={cn(
+        "scroll-mt-16 overflow-hidden rounded-lg border bg-card text-card-foreground shadow-sm transition-colors",
+        open ? "border-border" : "border-border/60",
+      )}
+    >
+      <button
+        type="button"
+        onClick={onToggle}
+        aria-expanded={open}
+        className="flex w-full items-start justify-between gap-4 px-5 py-4 text-start transition-colors hover:bg-muted/40 sm:px-6 sm:py-5"
+      >
+        <div className="flex min-w-0 items-start gap-3">
+          <span className="mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&>svg]:size-[18px]">
+            {icon}
+          </span>
+          <span className="flex min-w-0 flex-col gap-1.5">
+            <span className="flex flex-wrap items-center gap-2">
+              <span className="text-base font-semibold leading-none tracking-tight text-foreground">
+                {title}
+              </span>
+              {connected && <ConnectedDot size="md" />}
+              {required && !connected && (
+                <StatusBadge label="Required" tone="required" size="md" />
+              )}
+              {badge && <StatusBadge label={badge} tone="muted" size="md" />}
+            </span>
+            {subtitle && (
+              <span className="text-sm leading-snug text-muted-foreground">
+                {subtitle}
+              </span>
+            )}
+          </span>
+        </div>
+        <IconChevronDown
+          size={18}
+          className={cn(
+            "mt-1 shrink-0 text-muted-foreground transition-transform",
+            open && "rotate-180",
+          )}
+        />
+      </button>
+      {open && (
+        <div
+          // `data-agent-native-settings-page` lets the shared stylesheet nudge
+          // the smallest fixed type (authored dense for the compact sidebar) up
+          // to a comfortable, consistent size on the full settings page so every
+          // framework section body reads like the shadcn cards around it.
+          data-agent-native-settings-page=""
+          className="border-t border-border/60 px-5 pb-5 pt-5 sm:px-6 sm:pb-6"
+        >
+          {children}
+        </div>
+      )}
+    </div>
+  );
+}
+
+function SidebarSettingsSection({
   id,
   icon,
   title,
@@ -42,21 +196,11 @@ export function SettingsSection({
           <span className="text-[12px] font-medium text-foreground truncate">
             {title}
           </span>
-          {connected && (
-            <span className="flex items-center justify-center shrink-0 rounded-full bg-green-500/15 text-green-500 w-4 h-4">
-              <IconCheck size={10} stroke={3} />
-            </span>
-          )}
+          {connected && <ConnectedDot size="sm" />}
           {required && !connected && (
-            <span className="shrink-0 rounded-full bg-accent/60 px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wide text-muted-foreground">
-              Required
-            </span>
-          )}
-          {badge && (
-            <span className="shrink-0 rounded-full bg-accent/60 px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wide text-muted-foreground">
-              {badge}
-            </span>
+            <StatusBadge label="Required" tone="muted" size="sm" />
           )}
+          {badge && <StatusBadge label={badge} tone="muted" size="sm" />}
         </div>
         <IconChevronDown
           size={12}

package/corpus/core/src/client/settings/SettingsTabsPage.tsx

@@ -115,20 +115,33 @@ function normalizeTabId(value?: string | null): string | null {
   if (normalized === "workspace" || normalized === "workspace-settings") {
     return "workspace";
   }
-  if (normalized === "organization" || normalized === "org") {
-    return "team";
-  }
   return normalized;
 }
 
+function resolveTabId(
+  tabs: SettingsTabItem[],
+  value?: string | null,
+): string | null {
+  const normalized = normalizeTabId(value);
+  if (!normalized) return null;
+  if (tabs.some((tab) => tab.id === normalized)) return normalized;
+  if (
+    normalized === "organization" ||
+    normalized === "org" ||
+    normalized === "team"
+  ) {
+    if (tabs.some((tab) => tab.id === "organization")) return "organization";
+    if (tabs.some((tab) => tab.id === "team")) return "team";
+  }
+  return null;
+}
+
 function activeTabFromHash(
   tabs: SettingsTabItem[],
   defaultTab: string,
 ): string {
   if (typeof window === "undefined") return defaultTab;
-  const fromHash = normalizeTabId(window.location.hash);
-  if (fromHash && tabs.some((tab) => tab.id === fromHash)) return fromHash;
-  return defaultTab;
+  return resolveTabId(tabs, window.location.hash) ?? defaultTab;
 }
 
 function updateHashForTab(tabId: string) {
@@ -159,6 +172,9 @@ export function SettingsTabsPage({
   onValueChange,
 }: SettingsTabsPageProps) {
   const tabs = useMemo<SettingsTabItem[]>(() => {
+    const hasOrganizationTab = extraTabs.some(
+      (tab) => tab.id === "organization",
+    );
     const next: SettingsTabItem[] = [
       {
         id: "general",
@@ -169,7 +185,7 @@ export function SettingsTabsPage({
       },
     ];
     next.push(...extraTabs);
-    if (team) {
+    if (team && !hasOrganizationTab) {
       next.push({
         id: "team",
         label: teamLabel,
@@ -229,8 +245,8 @@ export function SettingsTabsPage({
     // the active tab untouched to avoid bouncing back to General.
     if (isControlled) return;
     const handleHashChange = () => {
-      const fromHash = normalizeTabId(window.location.hash);
-      if (fromHash && tabs.some((tab) => tab.id === fromHash)) {
+      const fromHash = resolveTabId(tabs, window.location.hash);
+      if (fromHash) {
         setInternalTab(fromHash);
       }
     };

package/corpus/core/src/client/sse-event-processor.ts

@@ -15,6 +15,16 @@ import {
 
 export type ContentPart =
   | { type: "text"; text: string }
+  | {
+      /**
+       * Model chain-of-thought / extended-thinking prose. Streamed from
+       * server `thinking` SSE events (and code-agent thinking transcript
+       * items). Rendered as a collapsible plain-English cell — not a tool
+       * call.
+       */
+      type: "reasoning";
+      text: string;
+    }
   | {
       type: "tool-call";
       toolCallId: string;
@@ -669,7 +679,7 @@ function pendingToolNames(content: ContentPart[]): {
 
 function contentSnapshot(content: ContentPart[]): ContentPart[] {
   return content.map((part) => {
-    if (part.type === "text") return { ...part };
+    if (part.type === "text" || part.type === "reasoning") return { ...part };
     return {
       ...part,
       args: { ...part.args },
@@ -952,6 +962,23 @@ export function processEvent(
     };
   }
 
+  if (ev.type === "thinking") {
+    // Model chain-of-thought. Coalesce consecutive deltas into one reasoning
+    // part so the UI can render a single collapsible "Thinking" cell.
+    const delta = ev.text ?? "";
+    if (!delta) return { action: "continue" };
+    const lastPart = content[content.length - 1];
+    if (lastPart && lastPart.type === "reasoning") {
+      lastPart.text += delta;
+    } else {
+      content.push({ type: "reasoning", text: delta });
+    }
+    return {
+      action: "yield",
+      result: { content: contentSnapshot(content) } as ChatModelRunResult,
+    };
+  }
+
   if (ev.type === "stream_keepalive") {
     return { action: "continue" };
   }
@@ -1400,7 +1427,7 @@ function clearAssistantDraftContent(content: ContentPart[]): void {
   for (let index = content.length - 1; index >= 0; index--) {
     const part = content[index];
     if (!part) continue;
-    if (part.type === "text") {
+    if (part.type === "text" || part.type === "reasoning") {
       content.splice(index, 1);
       continue;
     }

package/corpus/core/src/db-admin/agent-tools.ts

@@ -65,7 +65,7 @@ export function createDbAdminAgentTools(): Record<string, ActionEntry> {
     "db-admin-rows": {
       tool: {
         description:
-          "DEV ONLY. Read rows from one table (unscoped) with pagination, sorting, and filters. Returns column metadata, the page of rows, and the total count.",
+          'DEV ONLY. Read rows from one table (unscoped) with pagination, sorting, and filters. Large text/JSON cells are previewed by default; pass includeLargeCells: "true" only when you need the full value.',
         parameters: {
           type: "object",
           properties: {
@@ -88,6 +88,11 @@ export function createDbAdminAgentTools(): Record<string, ActionEntry> {
               description:
                 'JSON array of filters, e.g. \'[{"column":"status","op":"eq","value":"draft"}]\'. Ops: eq, neq, lt, lte, gt, gte, like, ilike, in, is_null, not_null.',
             },
+            includeLargeCells: {
+              type: "string",
+              description:
+                'Set to "true" to return full large text/JSON cells instead of previews.',
+            },
           },
           required: ["table"],
         },
@@ -99,6 +104,7 @@ export function createDbAdminAgentTools(): Record<string, ActionEntry> {
           pageSize: Number(args.pageSize) || 50,
           sort: parseJson<DbAdminSort[]>(args.sort, "sort"),
           filters: parseJson<DbAdminFilter[]>(args.filters, "filters"),
+          includeLargeCells: String(args.includeLargeCells) === "true",
         });
         return JSON.stringify(result);
       },
@@ -158,7 +164,7 @@ export function createDbAdminAgentTools(): Record<string, ActionEntry> {
     "db-admin-query": {
       tool: {
         description:
-          'DEV ONLY. Run arbitrary SQL against the full database (unscoped). PREFER THIS over db-query/db-exec for database-admin work and for any table without owner_email/org_id scoping (the scoped tools match 0 rows on those). Bare SELECTs are auto-limited to 100 rows. Destructive statements (DROP / TRUNCATE / unscoped DELETE or UPDATE) require confirmDestructive: "true".',
+          'DEV ONLY. Run arbitrary SQL against the full database (unscoped). PREFER this over db-query/db-exec for database-admin work and for tables without owner_email/org_id scoping. Bare SELECTs are auto-limited to 100 rows, and large string cells are truncated in the tool result. Destructive statements require confirmDestructive: "true".',
         parameters: {
           type: "object",
           properties: {

package/corpus/core/src/db-admin/operations.ts

@@ -40,6 +40,9 @@ import type {
 // ---------------------------------------------------------------------------
 
 const IDENT_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const LARGE_CELL_PREVIEW_CHARS = 16 * 1024;
+const LARGE_CELL_SUFFIX =
+  "\n...[db-admin truncated large cell; request includeLargeCells=true for the full value]";
 
 export interface DbAdminRuntime {
   db?: DbExec;
@@ -72,6 +75,103 @@ function isPostgresRuntime(runtime?: DbAdminRuntime): boolean {
   return dialect(runtime) === "postgres";
 }
 
+function isPreviewableLargeColumn(column: DbAdminColumn): boolean {
+  const type = column.type.toLowerCase();
+  return /\b(text|char|varchar|character|jsonb?|xml|clob)\b/.test(type);
+}
+
+function markLargeValuePreviewColumns(
+  columns: DbAdminColumn[],
+  includeLargeCells: boolean,
+): DbAdminColumn[] {
+  if (includeLargeCells) return columns;
+  return columns.map((column) =>
+    isPreviewableLargeColumn(column)
+      ? { ...column, largeValuePreview: true }
+      : column,
+  );
+}
+
+function buildRowsSelectList(
+  columns: DbAdminColumn[],
+  includeLargeCells: boolean,
+): string {
+  if (includeLargeCells) {
+    return columns.map((column) => quoteIdent(column.name)).join(", ");
+  }
+
+  return columns
+    .map((column) => {
+      const quoted = quoteIdent(column.name);
+      if (!isPreviewableLargeColumn(column)) return quoted;
+      const textValue = `CAST(${quoted} AS TEXT)`;
+      return `CASE WHEN length(${textValue}) > ${LARGE_CELL_PREVIEW_CHARS} THEN substr(${textValue}, 1, ${LARGE_CELL_PREVIEW_CHARS}) || '${LARGE_CELL_SUFFIX.replace(/'/g, "''")}' ELSE ${textValue} END AS ${quoted}`;
+    })
+    .join(", ");
+}
+
+function truncateLargeResultCells(rows: Record<string, unknown>[]): {
+  rows: Record<string, unknown>[];
+  truncatedCells: number;
+} {
+  let truncatedCells = 0;
+  const mapped = rows.map((row) => {
+    let changed = false;
+    const next: Record<string, unknown> = {};
+    for (const [key, value] of Object.entries(row)) {
+      if (
+        typeof value === "string" &&
+        value.length > LARGE_CELL_PREVIEW_CHARS
+      ) {
+        next[key] =
+          `${value.slice(0, LARGE_CELL_PREVIEW_CHARS)}${LARGE_CELL_SUFFIX}`;
+        truncatedCells += 1;
+        changed = true;
+      } else {
+        next[key] = value;
+      }
+    }
+    return changed ? next : row;
+  });
+  return { rows: mapped, truncatedCells };
+}
+
+function countTruncatedResultCells(rows: Record<string, unknown>[]): number {
+  let truncatedCells = 0;
+  for (const row of rows) {
+    for (const value of Object.values(row)) {
+      if (typeof value === "string" && value.endsWith(LARGE_CELL_SUFFIX)) {
+        truncatedCells += 1;
+      }
+    }
+  }
+  return truncatedCells;
+}
+
+function containsLargeCellPreview(value: unknown): boolean {
+  if (typeof value === "string") return value.endsWith(LARGE_CELL_SUFFIX);
+  if (Array.isArray(value)) return value.some(containsLargeCellPreview);
+  if (value && typeof value === "object") {
+    return Object.values(value as Record<string, unknown>).some(
+      containsLargeCellPreview,
+    );
+  }
+  return false;
+}
+
+function assertNoLargeCellPreviewMutation(
+  row: Record<string, unknown>,
+  context: string,
+): void {
+  for (const [column, value] of Object.entries(row)) {
+    if (containsLargeCellPreview(value)) {
+      throw new Error(
+        `Refusing to ${context} with previewed large-cell value in column "${column}". Reload the row with includeLargeCells=true before saving.`,
+      );
+    }
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Notify the UI after a real mutation so polling refetches.
 // ---------------------------------------------------------------------------
@@ -469,6 +569,8 @@ export async function getRows(
   const where = buildWhere(req.filters, runtime);
   const orderBy = buildOrderBy(req.sort);
   const quoted = quoteIdent(table);
+  const includeLargeCells = req.includeLargeCells === true;
+  const selectList = buildRowsSelectList(schema.columns, includeLargeCells);
 
   const countRes = await client.execute({
     sql: `SELECT COUNT(*) AS c FROM ${quoted}${where.clause}`,
@@ -477,16 +579,18 @@ export async function getRows(
   const total = Number((countRes.rows[0] as any)?.c ?? 0) || 0;
 
   const rowsRes = await client.execute({
-    sql: `SELECT * FROM ${quoted}${where.clause}${orderBy} LIMIT ? OFFSET ?`,
+    sql: `SELECT ${selectList} FROM ${quoted}${where.clause}${orderBy} LIMIT ? OFFSET ?`,
     args: [...where.args, pageSize, offset],
   });
+  const rows = rowsRes.rows as Record<string, unknown>[];
 
   return {
-    columns: schema.columns,
-    rows: rowsRes.rows as Record<string, unknown>[],
+    columns: markLargeValuePreviewColumns(schema.columns, includeLargeCells),
+    rows,
     total,
     page,
     pageSize,
+    truncatedCells: includeLargeCells ? 0 : countTruncatedResultCells(rows),
   };
 }
 
@@ -502,6 +606,7 @@ function buildInsert(
   if (cols.length === 0) {
     throw new Error("Cannot insert an empty row");
   }
+  assertNoLargeCellPreviewMutation(row, "insert");
   cols.forEach((c) => assertIdent(c, "column name"));
   const sql = `INSERT INTO ${quoteIdent(table)} (${cols
     .map(quoteIdent)
@@ -520,6 +625,8 @@ function buildUpdate(
   if (whereCols.length === 0) {
     throw new Error("Update requires a non-empty where clause");
   }
+  assertNoLargeCellPreviewMutation(set, "update");
+  assertNoLargeCellPreviewMutation(where, "match rows");
   setCols.forEach((c) => assertIdent(c, "column name"));
   whereCols.forEach((c) => assertIdent(c, "column name"));
   const setSql = setCols.map((c) => `${quoteIdent(c)} = ?`).join(", ");
@@ -539,6 +646,7 @@ function buildDelete(
   if (whereCols.length === 0) {
     throw new Error("Delete requires a non-empty where clause");
   }
+  assertNoLargeCellPreviewMutation(where, "delete");
   whereCols.forEach((c) => assertIdent(c, "column name"));
   const whereSql = whereCols.map((c) => `${quoteIdent(c)} = ?`).join(" AND ");
   const sql = `DELETE FROM ${quoteIdent(table)} WHERE ${whereSql}`;
@@ -674,7 +782,10 @@ export async function runSql(
   );
   const durationMs = Date.now() - started;
 
-  const rows = (res.rows ?? []) as Record<string, unknown>[];
+  const truncation = truncateLargeResultCells(
+    (res.rows ?? []) as Record<string, unknown>[],
+  );
+  const rows = truncation.rows;
   const columns =
     rows.length > 0 && rows[0] && typeof rows[0] === "object"
       ? Object.keys(rows[0])
@@ -687,5 +798,6 @@ export async function runSql(
     rows,
     rowsAffected: res.rowsAffected ?? 0,
     durationMs,
+    truncatedCells: truncation.truncatedCells,
   };
 }

package/corpus/core/src/db-admin/routes.ts

@@ -106,6 +106,7 @@ export function mountDbAdminRoutes(
               pageSize: Number(body.pageSize) || 50,
               sort: body.sort,
               filters: body.filters,
+              includeLargeCells: body.includeLargeCells === true,
             });
             return { ok: true, ...result };
           }

package/corpus/core/src/db-admin/types.ts

@@ -15,6 +15,7 @@ export interface DbAdminColumn {
   pk: boolean;
   defaultValue: string | null;
   autoIncrement?: boolean;
+  largeValuePreview?: boolean;
 }
 
 export interface DbAdminForeignKey {
@@ -74,6 +75,7 @@ export interface DbAdminRowsRequest {
   pageSize: number;
   sort?: DbAdminSort[];
   filters?: DbAdminFilter[];
+  includeLargeCells?: boolean;
 }
 
 export interface DbAdminRowsResult {
@@ -82,6 +84,7 @@ export interface DbAdminRowsResult {
   total: number;
   page: number;
   pageSize: number;
+  truncatedCells?: number;
 }
 
 export interface DbAdminMutation {
@@ -103,4 +106,5 @@ export interface DbAdminQueryResult {
   rows: Record<string, unknown>[];
   rowsAffected: number;
   durationMs: number;
+  truncatedCells?: number;
 }