@agent-native/core 0.87.0 → 0.90.1

package/corpus/templates/brain/app/root.tsx

@@ -25,6 +25,7 @@ import {
 import type { LinksFunction } from "react-router";
 
 import { Layout as AppLayout } from "@/components/layout/Layout";
+import { AppToolkitProvider } from "@/components/ui/toolkit-provider";
 import { useDistillationBridge } from "@/hooks/use-distillation-bridge";
 import { useNavigationState } from "@/hooks/use-navigation-state";
 import { TAB_ID } from "@/lib/tab-id";
@@ -215,14 +216,16 @@ export default function Root() {
   );
 
   return (
-    <AppProviders
-      queryClient={queryClient}
-      tooltipDelayDuration={250}
-      i18n={{ catalog: i18nCatalog }}
-    >
-      <DbSyncSetup />
-      <AppContent />
-    </AppProviders>
+    <AppToolkitProvider>
+      <AppProviders
+        queryClient={queryClient}
+        tooltipDelayDuration={250}
+        i18n={{ catalog: i18nCatalog }}
+      >
+        <DbSyncSetup />
+        <AppContent />
+      </AppProviders>
+    </AppToolkitProvider>
   );
 }
 

package/corpus/templates/brain/app/routes/knowledge.tsx

@@ -3,25 +3,6 @@ import {
   useActionQuery,
   useT,
 } from "@agent-native/core/client";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
-import { Card, CardContent } from "@agent-native/toolkit/ui/card";
-import { Input } from "@agent-native/toolkit/ui/input";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import {
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-} from "@agent-native/toolkit/ui/table";
 import {
   IconBook,
   IconCheck,
@@ -43,6 +24,25 @@ import {
   PageHeader,
   StatusBadge,
 } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
 import {
   type KnowledgeResponse,
   type KnowledgeRow,

package/corpus/templates/brain/app/routes/ops.tsx

@@ -3,24 +3,6 @@ import {
   useActionQuery,
   useT,
 } from "@agent-native/core/client";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
-import { Card } from "@agent-native/toolkit/ui/card";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import {
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-} from "@agent-native/toolkit/ui/table";
 import {
   IconAlertTriangle,
   IconChecks,
@@ -40,6 +22,24 @@ import {
   MetricCard,
   PageHeader,
 } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card } from "@/components/ui/card";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
 import {
   type BrainDistillationQueueStatus,
   type BrainOpsQueueItem,

package/corpus/templates/brain/app/routes/review.tsx

@@ -3,33 +3,6 @@ import {
   useActionQuery,
   useT,
 } from "@agent-native/core/client";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
-import {
-  Card,
-  CardContent,
-  CardHeader,
-  CardTitle,
-} from "@agent-native/toolkit/ui/card";
-import { Input } from "@agent-native/toolkit/ui/input";
-import { Label } from "@agent-native/toolkit/ui/label";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import {
-  Sheet,
-  SheetContent,
-  SheetDescription,
-  SheetHeader,
-  SheetTitle,
-  SheetTrigger,
-} from "@agent-native/toolkit/ui/sheet";
-import { Switch } from "@agent-native/toolkit/ui/switch";
-import { Textarea } from "@agent-native/toolkit/ui/textarea";
 import {
   type Icon,
   IconChartBar,
@@ -58,6 +31,9 @@ import {
   PageHeader,
   StatusBadge,
 } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -65,6 +41,25 @@ import {
   DropdownMenuSeparator,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+  SheetTrigger,
+} from "@/components/ui/sheet";
+import { Switch } from "@/components/ui/switch";
+import { Textarea } from "@/components/ui/textarea";
 import { type ReviewItem, type ReviewQueueResponse } from "@/lib/brain";
 import { cn } from "@/lib/utils";
 

package/corpus/templates/brain/app/routes/search.tsx

@@ -1,24 +1,4 @@
 import { useActionQuery, useT } from "@agent-native/core/client";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
-import { Card, CardContent } from "@agent-native/toolkit/ui/card";
-import { Input } from "@agent-native/toolkit/ui/input";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import { Separator } from "@agent-native/toolkit/ui/separator";
-import {
-  Sheet,
-  SheetContent,
-  SheetDescription,
-  SheetHeader,
-  SheetTitle,
-  SheetTrigger,
-} from "@agent-native/toolkit/ui/sheet";
 import {
   IconBook2,
   IconCircleCheck,
@@ -40,6 +20,26 @@ import {
   PageHeader,
   StatusBadge,
 } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Separator } from "@/components/ui/separator";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+  SheetTrigger,
+} from "@/components/ui/sheet";
 import {
   type KnowledgeRow,
   type SearchEverythingResponse,

package/corpus/templates/brain/app/routes/settings.tsx

@@ -2,24 +2,36 @@ import {
   ChangelogSettingsCard,
   LanguagePicker,
   SettingsTabsPage,
-  openAgentSettings,
+  useAgentSettingsTabs,
   useActionMutation,
   useActionQuery,
   useT,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
+import {
+  IconAdjustments,
+  IconBuilding,
+  IconDeviceFloppy,
+  IconFileText,
+  IconGauge,
+  IconMessageCircle,
+  IconShieldCheck,
+} from "@tabler/icons-react";
+import { useEffect, useMemo, useState } from "react";
+
+import { EmptyActionState, PageHeader } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@agent-native/toolkit/ui/card";
-import { Input } from "@agent-native/toolkit/ui/input";
-import { Label } from "@agent-native/toolkit/ui/label";
-import { Progress } from "@agent-native/toolkit/ui/progress";
+} from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Progress } from "@/components/ui/progress";
 import {
   Select,
   SelectContent,
@@ -27,22 +39,10 @@ import {
   SelectItem,
   SelectTrigger,
   SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import { Separator } from "@agent-native/toolkit/ui/separator";
-import { Switch } from "@agent-native/toolkit/ui/switch";
-import { Textarea } from "@agent-native/toolkit/ui/textarea";
-import {
-  IconAdjustments,
-  IconBuilding,
-  IconDeviceFloppy,
-  IconFileText,
-  IconGauge,
-  IconMessageCircle,
-  IconShieldCheck,
-} from "@tabler/icons-react";
-import { useEffect, useMemo, useState } from "react";
-
-import { EmptyActionState, PageHeader } from "@/components/brain/Surface";
+} from "@/components/ui/select";
+import { Separator } from "@/components/ui/separator";
+import { Switch } from "@/components/ui/switch";
+import { Textarea } from "@/components/ui/textarea";
 import {
   type BrainSettings,
   type SettingsResponse,
@@ -75,6 +75,7 @@ function sourcePolicyOptions(t: ReturnType<typeof useT>) {
 
 export default function SettingsRoute() {
   const t = useT();
+  const agentSettingsTabs = useAgentSettingsTabs();
   const localizedToneOptions = useMemo(() => toneOptions(t), [t]);
   const localizedSourcePolicyOptions = useMemo(
     () => sourcePolicyOptions(t),
@@ -144,6 +145,7 @@ export default function SettingsRoute() {
 
       <SettingsTabsPage
         teamLabel={t("team.title")}
+        extraTabs={agentSettingsTabs}
         general={
           <div className="brain-settings-general-grid grid gap-5">
             <main className="grid gap-5">
@@ -420,23 +422,6 @@ export default function SettingsRoute() {
                 </CardContent>
               </Card>
 
-              <Card>
-                <CardHeader>
-                  <CardTitle className="flex items-center gap-2 text-base">
-                    <IconAdjustments className="size-4 text-primary" />
-                    {t("settings.agentTitle")}
-                  </CardTitle>
-                  <CardDescription>
-                    {t("settings.agentDescription")}
-                  </CardDescription>
-                </CardHeader>
-                <CardContent>
-                  <Button variant="outline" onClick={() => openAgentSettings()}>
-                    {t("settings.openAgentSettings")}
-                  </Button>
-                </CardContent>
-              </Card>
-
               <Card>
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">

package/corpus/templates/brain/app/routes/sources.tsx

@@ -3,29 +3,6 @@ import {
   useActionQuery,
   useT,
 } from "@agent-native/core/client";
-import { Badge } from "@agent-native/toolkit/ui/badge";
-import { Button } from "@agent-native/toolkit/ui/button";
-import { Card, CardContent } from "@agent-native/toolkit/ui/card";
-import { Input } from "@agent-native/toolkit/ui/input";
-import { Label } from "@agent-native/toolkit/ui/label";
-import { Progress } from "@agent-native/toolkit/ui/progress";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@agent-native/toolkit/ui/select";
-import {
-  Sheet,
-  SheetContent,
-  SheetDescription,
-  SheetFooter,
-  SheetHeader,
-  SheetTitle,
-} from "@agent-native/toolkit/ui/sheet";
-import { Switch } from "@agent-native/toolkit/ui/switch";
-import { Textarea } from "@agent-native/toolkit/ui/textarea";
 import {
   IconAlertTriangle,
   IconArchive,
@@ -60,12 +37,35 @@ import {
   PageHeader,
   StatusBadge,
 } from "@/components/brain/Surface";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
 import {
   DropdownMenu,
   DropdownMenuContent,
   DropdownMenuItem,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Progress } from "@/components/ui/progress";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetFooter,
+  SheetHeader,
+  SheetTitle,
+} from "@/components/ui/sheet";
+import { Switch } from "@/components/ui/switch";
+import { Textarea } from "@/components/ui/textarea";
 import {
   type BrainConnectionProvider,
   type BrainHealthResponse,

package/corpus/templates/calendar/.agents/skills/actions/SKILL.md

@@ -161,6 +161,18 @@ to find likely URLs, `web-request` or `provider-api-docs` with clean
 `webFetch()` when you need to grep, aggregate, or compare many pages before
 returning a small result.
 
+For LONG compute, `run-code` supports durable background executions: pass
+`background: true` and the code is enqueued to a `sandbox_executions` row and
+executed out-of-band with a generous budget (default 10 min), surviving the
+hosted agent run's ~40s soft timeout. The call returns
+`{ executionId, status: "queued" }` immediately with polling guidance; check
+progress with `run-code` `{ executionId }` (or the `get-code-execution` tool
+where registered) — results persist after completion. Use background for big
+cross-source joins, multi-page provider sweeps, and heavy analysis scripts;
+keep quick scripts in the default foreground mode. Agents should continue
+other work between polls, and on `failed`/`timed_out` split the computation or
+persist intermediate progress with `workspaceWrite` and re-run.
+
 ### The `http` Option
 
 Controls how the action is exposed as an HTTP endpoint:
@@ -205,6 +217,49 @@ run: async (args) => {
 }
 ```
 
+### Returning Images the Agent Can See (`_agentImages`)
+
+An action's return object may include the well-known optional field
+`_agentImages` to attach vision images (screenshots, chart previews, rendered
+designs) to the tool result. The agent literally sees them — enabling visual
+self-review loops — while the field itself is stripped from the JSON text the
+model reads.
+
+```ts
+run: async ({ dashboardId }) => {
+  const shot = await renderDashboardPng(dashboardId); // Buffer
+  return {
+    dashboardId,
+    panelCount: 6,
+    _agentImages: [
+      // Either a public https URL (preferred — the provider fetches it)…
+      { url: "https://cdn.example.com/previews/dash-1.png", label: "overview" },
+      // …or base64 without a data: prefix (mediaType required; a full
+      // data:image/png;base64,… URL in `data` is also accepted and parsed).
+      { data: shot.toString("base64"), mediaType: "image/png" },
+    ],
+  };
+},
+```
+
+Rules and limits:
+
+- Shape: `Array<{ url?: string; data?: string; mediaType?: string; label?: string }>`.
+  Each entry needs `url` (https only) **or** `data`. Supported media types:
+  `image/jpeg`, `image/png`, `image/gif`, `image/webp`.
+- Caps: max **4 images** per result; max **~2MB of base64** per image.
+  Over-cap or invalid entries never fail the call — they become text notes in
+  the result telling the model what was dropped and why.
+- Persistence: the run ledger stores only the string result plus compact
+  `[image: …]` notes (URLs verbatim; base64 as a byte-count placeholder) —
+  never the payload. Images are re-attached only for the live turn; replayed
+  history is text-only, so prefer stable `url` images the model can re-request.
+- Engine support: native Anthropic and vision-capable AI-SDK providers
+  (anthropic, openai, google, openrouter) receive real image blocks; other
+  paths (Builder gateway, non-vision providers) degrade to the text notes.
+- External MCP tools need no changes — standard MCP `image` content parts are
+  converted automatically under the same caps.
+
 ### Validating Return Values (`outputSchema`)
 
 `schema` validates inputs; `outputSchema` validates what the action **returns**. Pass any Standard Schema-compatible schema (Zod, Valibot, ArkType) and the framework validates the result _after_ `run()` resolves — input validated before `run`, output after.

package/corpus/templates/calendar/actions/find-a-time.ts

@@ -251,15 +251,22 @@ export default defineAction({
     const busyByKey = new Map<string, FindTimeBusyBlock>();
     const errors: Array<{ email: string; error: string }> = [];
 
-    if (googleConnected) {
-      const freeBusy = await googleCalendar.getFreeBusy(
-        range.from,
-        range.to,
-        participantEmails,
-        ownerEmail,
-        timezone,
-        organizerEmail,
-      );
+    const [freeBusyOutcome, eventsOutcome] = await Promise.allSettled([
+      googleConnected
+        ? googleCalendar.getFreeBusy(
+            range.from,
+            range.to,
+            participantEmails,
+            ownerEmail,
+            timezone,
+            organizerEmail,
+          )
+        : Promise.resolve(null),
+      listCalendarEvents({ from: range.from, to: range.to }),
+    ]);
+
+    if (freeBusyOutcome.status === "fulfilled" && freeBusyOutcome.value) {
+      const freeBusy = freeBusyOutcome.value;
       errors.push(...freeBusy.errors);
       for (const [email, calendar] of Object.entries(freeBusy.calendars)) {
         for (const busy of calendar.busy) {
@@ -276,13 +283,17 @@ export default defineAction({
           );
         }
       }
+    } else if (freeBusyOutcome.status === "rejected") {
+      errors.push({
+        email: organizerEmail,
+        error:
+          freeBusyOutcome.reason?.message ||
+          "Unable to load free/busy availability",
+      });
     }
 
-    try {
-      const eventResult = await listCalendarEvents({
-        from: range.from,
-        to: range.to,
-      });
+    if (eventsOutcome.status === "fulfilled") {
+      const eventResult = eventsOutcome.value;
       errors.push(...eventResult.errors);
       addCalendarEventBusyBlocks(
         busyByKey,
@@ -292,10 +303,12 @@ export default defineAction({
         args.ignoreStart,
         args.ignoreEnd,
       );
-    } catch (error: any) {
+    } else {
       errors.push({
         email: organizerEmail,
-        error: error?.message || "Unable to load local calendar conflicts",
+        error:
+          eventsOutcome.reason?.message ||
+          "Unable to load local calendar conflicts",
       });
     }
 

package/corpus/templates/calendar/actions/list-bookings.ts

@@ -6,7 +6,24 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import type { Booking } from "../shared/api.js";
 
-function rowToBooking(row: typeof schema.bookings.$inferSelect): Booking {
+function rowToBooking(
+  row: Pick<
+    typeof schema.bookings.$inferSelect,
+    | "id"
+    | "name"
+    | "email"
+    | "start"
+    | "end"
+    | "slug"
+    | "eventTitle"
+    | "notes"
+    | "fieldResponses"
+    | "meetingLink"
+    | "googleEventId"
+    | "status"
+    | "createdAt"
+  >,
+): Booking {
   let fieldResponses: Record<string, string | boolean> | undefined;
   if (row.fieldResponses) {
     try {
@@ -43,7 +60,21 @@ export default defineAction({
     if (slugs.length === 0) return [];
 
     const rows = await getDb()
-      .select()
+      .select({
+        id: schema.bookings.id,
+        name: schema.bookings.name,
+        email: schema.bookings.email,
+        start: schema.bookings.start,
+        end: schema.bookings.end,
+        slug: schema.bookings.slug,
+        eventTitle: schema.bookings.eventTitle,
+        notes: schema.bookings.notes,
+        fieldResponses: schema.bookings.fieldResponses,
+        meetingLink: schema.bookings.meetingLink,
+        googleEventId: schema.bookings.googleEventId,
+        status: schema.bookings.status,
+        createdAt: schema.bookings.createdAt,
+      })
       .from(schema.bookings)
       .where(inArray(schema.bookings.slug, slugs))
       .orderBy(schema.bookings.start);

package/corpus/templates/calendar/actions/list-events.ts

@@ -16,6 +16,39 @@ import { calendarEventMatchesQuery } from "./event-search.js";
 
 const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
 
+// External ICS feeds are third-party HTTP fetches re-parsed on every
+// list-events call; a short TTL avoids re-fetching/re-parsing the same feed
+// + range on every poll while a calendar tab stays open. Per-process only —
+// a serverless cold start just resets it, which is fine since the feed is
+// re-fetched on the next call.
+const ICAL_CACHE_TTL_MS = 5 * 60_000;
+const icalCache = new Map<
+  string,
+  { events: CalendarEvent[]; fetchedAt: number }
+>();
+
+async function fetchICalEventsCached(
+  cal: ExternalCalendar,
+  from: string,
+  to: string,
+): Promise<CalendarEvent[]> {
+  const cacheKey = `${cal.url}|${from}|${to}`;
+  const cached = icalCache.get(cacheKey);
+  if (cached && Date.now() - cached.fetchedAt < ICAL_CACHE_TTL_MS) {
+    return cached.events;
+  }
+  const events = await fetchICalEvents(
+    cal.id,
+    cal.name,
+    cal.url,
+    cal.color,
+    from,
+    to,
+  );
+  icalCache.set(cacheKey, { events, fetchedAt: Date.now() });
+  return events;
+}
+
 interface CalendarEventRange {
   from: string;
   to: string;
@@ -308,14 +341,7 @@ export async function listCalendarEvents(
 
   const icalResults = await Promise.allSettled(
     externalCalendars.map((cal) =>
-      fetchICalEvents(
-        cal.id,
-        cal.name,
-        cal.url,
-        cal.color,
-        range.from,
-        range.to,
-      ),
+      fetchICalEventsCached(cal, range.from, range.to),
     ),
   );