@agent-native/core 0.79.27 → 0.80.1

package/corpus/templates/slides/server/handlers/import-figma-system.ts

@@ -1,4 +1,8 @@
-import { getSession } from "@agent-native/core/server";
+import {
+  FeatureNotConfiguredError,
+  getSession,
+  startBuilderDesignSystemIndex,
+} from "@agent-native/core/server";
 import {
   defineEventHandler,
   getRequestHeader,
@@ -6,11 +10,7 @@ import {
   setResponseStatus,
 } from "h3";
 
-import {
-  MAX_FIG_BYTES,
-  parseSlidesFigDesignSystem,
-} from "../lib/fig-design-system.js";
-
+const MAX_FIG_BYTES = 200 * 1024 * 1024;
 const MULTIPART_OVERHEAD_BYTES = 1024 * 1024;
 
 function requestContentLength(event: Parameters<typeof getRequestHeader>[0]) {
@@ -55,15 +55,47 @@ export const importFigmaSystem = defineEventHandler(async (event) => {
       error: "No .fig file uploaded (expected multipart field 'file').",
     };
   }
+  if (part.data.length > MAX_FIG_BYTES) {
+    setResponseStatus(event, 413);
+    return {
+      error: `File too large (max ${Math.round(MAX_FIG_BYTES / 1024 / 1024)} MB).`,
+    };
+  }
+
+  const suggestedTitle =
+    (part.filename || "Imported brand")
+      .replace(/\.fig$/i, "")
+      .replace(/[-_]+/g, " ")
+      .trim() || "Imported brand";
 
   try {
-    return parseSlidesFigDesignSystem({
-      data: part.data,
-      filename: part.filename,
+    return await startBuilderDesignSystemIndex({
+      projectName: suggestedTitle,
+      files: [
+        {
+          name: part.filename || "brand.fig",
+          data: part.data,
+          mimeType: "application/octet-stream",
+        },
+      ],
     });
   } catch (err) {
-    const message = err instanceof Error ? err.message : "Invalid .fig file";
-    setResponseStatus(event, message.startsWith("File too large") ? 413 : 422);
-    return { error: message };
+    if (err instanceof FeatureNotConfiguredError) {
+      setResponseStatus(event, 412);
+      return {
+        error:
+          err.message ||
+          "Connect Builder.io before indexing a design system from Figma.",
+        builderConnectUrl:
+          err.builderConnectUrl ?? "/_agent-native/builder/connect",
+      };
+    }
+    setResponseStatus(event, 502);
+    return {
+      error:
+        err instanceof Error
+          ? err.message
+          : "Builder design-system indexing failed.",
+    };
   }
 });

package/corpus/templates/slides/server/lib/chat-attachments.ts

@@ -106,7 +106,7 @@ export async function prepareSlidesChatAttachments(args: {
           "- If the request refers to the current or visible deck, call `view-screen` first to confirm the active deckId, then pass that deckId to import or slide-edit actions.",
           '- PPTX files: call `import-pptx --filePath "<path>" --deckId <deckId>` when updating the visible deck, or omit deckId only when the user explicitly wants a new deck.',
           '- PDF and DOCX files: call `import-file --filePath "<path>" --format auto --deckId <deckId>` and use the returned extracted text as source material before creating slides. The returned text is capped for reliability; re-run with maxChars only if more context is needed. If the user wants a direct replacement import, pass `--importIntoDeck true` as well.',
-          '- Figma `.fig` files: call `import-file --filePath "<path>" --format fig`, then call `create-design-system` with the returned `designSystem` data and `customInstructions`.',
+          '- Figma `.fig` files: call `import-file --filePath "<path>" --format fig` to start Builder design-system indexing. Do not create a local design system from raw `.fig` output.',
           "- For deck-generation requests, start mutating promptly: create or update the first slide as soon as source material is extracted, then continue slide-by-slide with add-slide/update-slide.",
           '- Image files with an embeddable URL can be inserted directly into slide HTML as `<img src="...">` or used as visual references.',
           "- Do not say no PDF/PPTX/DOCX/FIG/image was attached when a matching saved path is listed here.",

package/corpus/templates/videos/app/components/NewCompositionPopover.tsx

@@ -40,7 +40,7 @@ export function NewCompositionPopover({
       sessionStorage.removeItem("videos:new-composition-generating");
       window.dispatchEvent(new CustomEvent("videos:new-composition-status"));
       setTimeout(() => {
-        const match = window.location.pathname.match(/\/c\/([^\/]+)/);
+        const match = window.location.pathname.match(/\/c\/([^/]+)/);
         if (match && match[1] !== "new") {
           try {
             window.dispatchEvent(

package/corpus/templates/videos/app/components/Sidebar.tsx

@@ -594,11 +594,11 @@ export function Sidebar({
           </TabsContent>
         </Tabs>
 
-        <div className="border-t border-border px-2 py-1.5 shrink-0">
+        <div className="shrink-0 px-2 py-1.5">
           <ExtensionsSidebarSection />
         </div>
 
-        <div className="border-t border-border px-3 py-1.5 shrink-0 space-y-2">
+        <div className="shrink-0 space-y-2 px-3 py-1.5">
           <DevDatabaseLink />
           <FeedbackButton />
           <OrgSwitcher />

package/corpus/templates/videos/app/components/layout/Layout.tsx

@@ -14,6 +14,17 @@ interface LayoutProps {
   children: React.ReactNode;
 }
 
+const SIDEBAR_COLLAPSE_KEY = "videos.sidebar.collapsed";
+
+function readSidebarCollapsed() {
+  if (typeof window === "undefined") return false;
+  try {
+    return window.localStorage.getItem(SIDEBAR_COLLAPSE_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Routes whose page renders its own h-12 toolbar (with title + AgentToggleButton).
  * Layout still wraps these with the AgentSidebar but skips the global Header
@@ -39,11 +50,24 @@ export function Layout({ children }: LayoutProps) {
   const location = useLocation();
   const t = useT();
   const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
+  const [sidebarCollapsed, setSidebarCollapsed] =
+    useState(readSidebarCollapsed);
 
   useEffect(() => {
     setMobileSidebarOpen(false);
   }, [location.pathname]);
 
+  useEffect(() => {
+    try {
+      window.localStorage.setItem(
+        SIDEBAR_COLLAPSE_KEY,
+        sidebarCollapsed ? "1" : "0",
+      );
+    } catch {
+      // Ignore storage failures; the in-memory preference still works.
+    }
+  }, [sidebarCollapsed]);
+
   const isStudio = studioRoute(location.pathname);
   const ownsToolbar = routeOwnsToolbar(location.pathname);
 
@@ -58,14 +82,17 @@ export function Layout({ children }: LayoutProps) {
     <HeaderActionsProvider>
       <div className="agent-layout-shell flex h-screen w-full overflow-hidden bg-background text-foreground">
         <div className="agent-layout-left-drawer hidden md:block">
-          <NavSidebar />
+          <NavSidebar
+            collapsed={sidebarCollapsed}
+            onCollapsedChange={setSidebarCollapsed}
+          />
         </div>
         <Sheet open={mobileSidebarOpen} onOpenChange={setMobileSidebarOpen}>
           <SheetContent side="left" className="p-0 w-[260px]">
             <SheetTitle className="sr-only">
               {t("sidebar.navigation")}
             </SheetTitle>
-            <NavSidebar />
+            <NavSidebar collapsed={false} collapsible={false} />
           </SheetContent>
         </Sheet>
         <AgentSidebar

package/corpus/templates/videos/app/components/layout/NavSidebar.tsx

@@ -11,9 +11,16 @@ import {
   IconComponents,
   IconPalette,
   IconSettings,
+  IconLayoutSidebarLeftCollapse,
+  IconLayoutSidebarLeftExpand,
 } from "@tabler/icons-react";
 import { Link, useLocation } from "react-router";
 
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
 import { cn } from "@/lib/utils";
 
 const navItems = [
@@ -31,31 +38,90 @@ const navItems = [
   { icon: IconSettings, labelKey: "navigation.settings", href: "/settings" },
 ];
 
-export function NavSidebar() {
+interface NavSidebarProps {
+  collapsed?: boolean;
+  collapsible?: boolean;
+  onCollapsedChange?: (collapsed: boolean) => void;
+}
+
+export function NavSidebar({
+  collapsed = false,
+  collapsible = true,
+  onCollapsedChange,
+}: NavSidebarProps) {
   const location = useLocation();
   const t = useT();
 
   return (
-    <aside className="flex h-full w-56 shrink-0 flex-col border-e border-border bg-sidebar text-sidebar-foreground">
-      <div className="flex h-12 shrink-0 items-center gap-2 px-4 border-b border-border">
-        <img
-          src={appPath("/agent-native-icon-light.svg")}
-          alt=""
-          aria-hidden="true"
-          className="block h-4 w-auto shrink-0 dark:hidden"
-        />
-        <img
-          src={appPath("/agent-native-icon-dark.svg")}
-          alt=""
-          aria-hidden="true"
-          className="hidden h-4 w-auto shrink-0 dark:block"
-        />
-        <span className="text-sm font-semibold tracking-tight">
-          {t("navigation.brand")}
-        </span>
+    <aside
+      data-collapsed={collapsed ? "true" : "false"}
+      className={cn(
+        "flex h-full shrink-0 flex-col overflow-hidden border-e border-border bg-sidebar text-sidebar-foreground transition-[width] duration-200 ease-out",
+        collapsed ? "w-12" : "w-56",
+      )}
+    >
+      <div
+        className={cn(
+          "flex h-12 shrink-0 items-center border-b border-border",
+          collapsed ? "justify-center px-1" : "gap-2 px-4",
+        )}
+      >
+        {!collapsed && (
+          <>
+            <img
+              src={appPath("/agent-native-icon-light.svg")}
+              alt=""
+              aria-hidden="true"
+              className="block h-4 w-auto shrink-0 dark:hidden"
+            />
+            <img
+              src={appPath("/agent-native-icon-dark.svg")}
+              alt=""
+              aria-hidden="true"
+              className="hidden h-4 w-auto shrink-0 dark:block"
+            />
+            <span className="min-w-0 flex-1 truncate text-sm font-semibold tracking-tight">
+              {t("navigation.brand")}
+            </span>
+          </>
+        )}
+        {collapsible && (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <button
+                type="button"
+                onClick={() => onCollapsedChange?.(!collapsed)}
+                aria-label={
+                  collapsed
+                    ? t("sidebar.expandSidebar")
+                    : t("sidebar.collapseSidebar")
+                }
+                className="flex h-8 w-8 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-sidebar-accent/50 hover:text-foreground"
+              >
+                {collapsed ? (
+                  <IconLayoutSidebarLeftExpand className="h-4 w-4 rtl:-scale-x-100" />
+                ) : (
+                  <IconLayoutSidebarLeftCollapse className="h-4 w-4 rtl:-scale-x-100" />
+                )}
+              </button>
+            </TooltipTrigger>
+            <TooltipContent side="right">
+              {collapsed
+                ? t("sidebar.expandSidebar")
+                : t("sidebar.collapseSidebar")}
+            </TooltipContent>
+          </Tooltip>
+        )}
       </div>
 
-      <nav className="flex-1 overflow-y-auto px-2 py-2 space-y-1">
+      <nav
+        className={cn(
+          "flex-1 overflow-y-auto py-2",
+          collapsed
+            ? "flex flex-col items-center gap-1 px-1"
+            : "space-y-1 px-2",
+        )}
+      >
         {navItems.map((item) => {
           const Icon = item.icon;
           const isActive =
@@ -65,33 +131,50 @@ export function NavSidebar() {
                 !location.pathname.startsWith("/settings") &&
                 !location.pathname.startsWith("/extensions")
               : location.pathname.startsWith(item.href);
-          return (
+          const link = (
             <Link
               key={item.href}
               to={item.href}
+              aria-label={collapsed ? t(item.labelKey) : undefined}
               className={cn(
-                "flex items-center gap-3 rounded-lg px-3 py-2 text-sm transition-colors",
+                "flex items-center rounded-lg text-sm transition-colors",
+                collapsed ? "h-10 w-10 justify-center" : "gap-3 px-3 py-2",
                 isActive
                   ? "bg-sidebar-accent text-sidebar-accent-foreground"
                   : "text-muted-foreground hover:bg-sidebar-accent/50 hover:text-foreground",
               )}
             >
               <Icon className="h-4 w-4 shrink-0" />
-              {t(item.labelKey)}
+              {collapsed ? (
+                <span className="sr-only">{t(item.labelKey)}</span>
+              ) : (
+                t(item.labelKey)
+              )}
             </Link>
           );
+          if (!collapsed) return link;
+          return (
+            <Tooltip key={item.href}>
+              <TooltipTrigger asChild>{link}</TooltipTrigger>
+              <TooltipContent side="right">{t(item.labelKey)}</TooltipContent>
+            </Tooltip>
+          );
         })}
       </nav>
 
-      <div className="border-t border-border px-2 py-2">
-        <ExtensionsSidebarSection />
-      </div>
+      {!collapsed && (
+        <div className="px-2 py-2">
+          <ExtensionsSidebarSection />
+        </div>
+      )}
 
-      <div className="border-t border-border px-3 py-2 space-y-2">
-        <DevDatabaseLink />
-        <FeedbackButton />
-        <OrgSwitcher />
-      </div>
+      {!collapsed && (
+        <div className="space-y-2 px-3 py-2">
+          <DevDatabaseLink />
+          <FeedbackButton />
+          <OrgSwitcher />
+        </div>
+      )}
     </aside>
   );
 }

package/corpus/templates/videos/app/i18n/ar-SA.ts

@@ -46,6 +46,8 @@ const messages = {
     suggestionSlow: "أبطئ حركة المقدمة",
   },
   sidebar: {
+    collapseSidebar: "طي الشريط الجانبي",
+    expandSidebar: "توسيع الشريط الجانبي",
     navigation: "التنقل",
     openNavigation: "فتح التنقل",
   },

package/corpus/templates/videos/app/i18n/de-DE.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "Verlangsame die Intro-Animation",
   },
   sidebar: {
+    collapseSidebar: "Seitenleiste einklappen",
+    expandSidebar: "Seitenleiste erweitern",
     navigation: "Navigation",
     openNavigation: "Navigation öffnen",
   },

package/corpus/templates/videos/app/i18n/en-US.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "Slow down the intro animation",
   },
   sidebar: {
+    collapseSidebar: "Collapse sidebar",
+    expandSidebar: "Expand sidebar",
     navigation: "Navigation",
     openNavigation: "Open navigation",
   },

package/corpus/templates/videos/app/i18n/es-ES.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "Ralentiza la animación de introducción",
   },
   sidebar: {
+    collapseSidebar: "Contraer barra lateral",
+    expandSidebar: "Expandir barra lateral",
     navigation: "Navegación",
     openNavigation: "Abrir navegación",
   },

package/corpus/templates/videos/app/i18n/fr-FR.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "Ralentir l’animation d’introduction",
   },
   sidebar: {
+    collapseSidebar: "Réduire la barre latérale",
+    expandSidebar: "Développer la barre latérale",
     navigation: "Navigation",
     openNavigation: "Ouvrir la navigation",
   },

package/corpus/templates/videos/app/i18n/hi-IN.ts

@@ -46,6 +46,8 @@ const messages = {
     suggestionSlow: "इंट्रो एनिमेशन धीमा करें",
   },
   sidebar: {
+    collapseSidebar: "साइडबार समेटें",
+    expandSidebar: "साइडबार फैलाएं",
     navigation: "नेविगेशन",
     openNavigation: "नेविगेशन खोलें",
   },

package/corpus/templates/videos/app/i18n/ja-JP.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "イントロアニメーションを遅くする",
   },
   sidebar: {
+    collapseSidebar: "サイドバーを折りたたむ",
+    expandSidebar: "サイドバーを展開",
     navigation: "ナビゲーション",
     openNavigation: "ナビゲーションを開く",
   },

package/corpus/templates/videos/app/i18n/ko-KR.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "인트로 애니메이션 느리게 하기",
   },
   sidebar: {
+    collapseSidebar: "사이드바 접기",
+    expandSidebar: "사이드바 펼치기",
     navigation: "탐색",
     openNavigation: "탐색 열기",
   },

package/corpus/templates/videos/app/i18n/pt-BR.ts

@@ -47,6 +47,8 @@ const messages = {
     suggestionSlow: "Desacelere a animação de introdução",
   },
   sidebar: {
+    collapseSidebar: "Recolher barra lateral",
+    expandSidebar: "Expandir barra lateral",
     navigation: "Navegação",
     openNavigation: "Abrir navegação",
   },

package/corpus/templates/videos/app/i18n/zh-CN.ts

@@ -45,6 +45,8 @@ const messages = {
     suggestionSlow: "放慢开场动画",
   },
   sidebar: {
+    collapseSidebar: "折叠侧边栏",
+    expandSidebar: "展开侧边栏",
     navigation: "导航",
     openNavigation: "打开导航",
   },

package/corpus/templates/videos/app/i18n/zh-TW.ts

@@ -45,6 +45,8 @@ const messages = {
     suggestionSlow: "放慢開場動畫",
   },
   sidebar: {
+    collapseSidebar: "收合側邊欄",
+    expandSidebar: "展開側邊欄",
     navigation: "導覽",
     openNavigation: "開啟導覽",
   },

package/corpus/templates/videos/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-28
+---
+
+The left sidebar now collapses into an animated icon rail with quieter footer controls.

package/dist/agent/engine/index.d.ts

@@ -2,7 +2,7 @@
  * Public exports for the pluggable agent engine system.
  */
 export type { AgentEngine, EngineCapabilities, EngineTool, EngineMessage, EngineContentPart, EngineTextPart, EngineImagePart, EngineToolCallPart, EngineToolResultPart, EngineThinkingPart, EngineEvent, EngineStreamOptions, } from "./types.js";
-export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, type AgentEngineEntry, type ResolveEngineConfig, } from "./registry.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, type AgentEngineEntry, type ResolveEngineConfig, } from "./registry.js";
 export { createBuilderEngine, BUILDER_DEFAULT_MODEL, BUILDER_SUPPORTED_MODELS, BUILDER_CAPABILITIES, } from "./builder-engine.js";
 export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
 export { createAISDKEngine, type AISDKProvider } from "./ai-sdk-engine.js";

package/dist/agent/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/agent/engine/index.js

@@ -1,7 +1,7 @@
 /**
  * Public exports for the pluggable agent engine system.
  */
-export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, } from "./registry.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, } from "./registry.js";
 export { createBuilderEngine, BUILDER_DEFAULT_MODEL, BUILDER_SUPPORTED_MODELS, BUILDER_CAPABILITIES, } from "./builder-engine.js";
 export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
 export { createAISDKEngine } from "./ai-sdk-engine.js";

package/dist/agent/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Public exports for the pluggable agent engine system.\n */\n\nexport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineTool,\n  EngineMessage,\n  EngineContentPart,\n  EngineTextPart,\n  EngineImagePart,\n  EngineToolCallPart,\n  EngineToolResultPart,\n  EngineThinkingPart,\n  EngineEvent,\n  EngineStreamOptions,\n} from \"./types.js\";\n\nexport {\n  registerAgentEngine,\n  getAgentEngineEntry,\n  listAgentEngines,\n  resolveEngine,\n  getStoredModelForEngine,\n  normalizeModelForEngine,\n  detectEngineFromEnv,\n  detectEngineFromUserSecrets,\n  isAgentEngineSettingConfigured,\n  isAgentEnginePackageInstalled,\n  isStoredEngineUsable,\n  isStoredEngineUsableForRequest,\n  type AgentEngineEntry,\n  type ResolveEngineConfig,\n} from \"./registry.js\";\n\nexport {\n  createBuilderEngine,\n  BUILDER_DEFAULT_MODEL,\n  BUILDER_SUPPORTED_MODELS,\n  BUILDER_CAPABILITIES,\n} from \"./builder-engine.js\";\n\nexport {\n  createAnthropicEngine,\n  ANTHROPIC_DEFAULT_MODEL,\n  ANTHROPIC_SUPPORTED_MODELS,\n  ANTHROPIC_CAPABILITIES,\n} from \"./anthropic-engine.js\";\nexport { createAISDKEngine, type AISDKProvider } from \"./ai-sdk-engine.js\";\nexport { registerBuiltinEngines } from \"./builtin.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,GAGjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Public exports for the pluggable agent engine system.\n */\n\nexport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineTool,\n  EngineMessage,\n  EngineContentPart,\n  EngineTextPart,\n  EngineImagePart,\n  EngineToolCallPart,\n  EngineToolResultPart,\n  EngineThinkingPart,\n  EngineEvent,\n  EngineStreamOptions,\n} from \"./types.js\";\n\nexport {\n  registerAgentEngine,\n  getAgentEngineEntry,\n  listAgentEngines,\n  resolveEngine,\n  getStoredModelForEngine,\n  normalizeModelForEngine,\n  detectEngineFromEnv,\n  detectEngineFromUserSecrets,\n  isAgentEngineSettingConfigured,\n  isAgentEnginePackageInstalled,\n  isStoredEngineUsable,\n  isStoredEngineUsableForRequest,\n  isResolvedEngineUsableForRequest,\n  type AgentEngineEntry,\n  type ResolveEngineConfig,\n} from \"./registry.js\";\n\nexport {\n  createBuilderEngine,\n  BUILDER_DEFAULT_MODEL,\n  BUILDER_SUPPORTED_MODELS,\n  BUILDER_CAPABILITIES,\n} from \"./builder-engine.js\";\n\nexport {\n  createAnthropicEngine,\n  ANTHROPIC_DEFAULT_MODEL,\n  ANTHROPIC_SUPPORTED_MODELS,\n  ANTHROPIC_CAPABILITIES,\n} from \"./anthropic-engine.js\";\nexport { createAISDKEngine, type AISDKProvider } from \"./ai-sdk-engine.js\";\nexport { registerBuiltinEngines } from \"./builtin.js\";\n"]}

package/dist/agent/engine/registry.d.ts

@@ -97,6 +97,15 @@ export declare function isStoredEngineUsable(stored: unknown, entry: AgentEngine
  * when deciding whether a stored engine can actually run for the current user.
  */
 export declare function isStoredEngineUsableForRequest(stored: unknown, entry: AgentEngineEntry): Promise<boolean>;
+/**
+ * Request-aware credential preflight for an already-resolved engine instance.
+ * `resolveEngine()` may still return a default or explicitly requested engine
+ * object before credentials are actually usable; call this before starting a
+ * user-visible run so missing providers fail immediately.
+ */
+export declare function isResolvedEngineUsableForRequest(engine: AgentEngine, options?: {
+    apiKey?: string;
+}): Promise<boolean>;
 export interface ResolveEngineConfig {
     /** Explicit engine name or instance from createAgentChatPlugin options */
     engineOption?: string | AgentEngine | {

package/dist/agent/engine/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,YAAY,EAAE,kBAAkB,CAAC;IACjC,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,6DAA6D;IAC7D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;CACtD;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAajE;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAE9B;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,IAAI,gBAAgB,EAAE,CAErD;AA8BD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAOT;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAAC,EACtE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,CAWR;AAYD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAyB7D;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA8EpF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAOvE;AAsDD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,YAAY,CAAC,EACT,MAAM,GACN,WAAW,GACX;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtD,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,CA+HtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC7B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"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"}

package/dist/agent/engine/registry.js

@@ -332,6 +332,43 @@ export async function isStoredEngineUsableForRequest(stored, entry) {
     }
     return true;
 }
+/**
+ * Request-aware credential preflight for an already-resolved engine instance.
+ * `resolveEngine()` may still return a default or explicitly requested engine
+ * object before credentials are actually usable; call this before starting a
+ * user-visible run so missing providers fail immediately.
+ */
+export async function isResolvedEngineUsableForRequest(engine, options = {}) {
+    const entry = _registry.get(engine.name);
+    // Custom engines may have their own credential contract outside the core
+    // registry metadata, so do not block them speculatively.
+    if (!entry)
+        return true;
+    if (!isAgentEnginePackageInstalled(entry))
+        return false;
+    if (entry.requiredEnvVars.length === 0)
+        return true;
+    if (entry.name === "builder") {
+        const creds = await resolveBuilderCredentials();
+        return Boolean(creds.privateKey && creds.publicKey);
+    }
+    if (options.apiKey?.trim())
+        return true;
+    for (const key of entry.requiredEnvVars) {
+        try {
+            if (await resolveSecret(key))
+                continue;
+        }
+        catch {
+            // Fall through to deployment-level fallback when allowed.
+        }
+        if (!canUseDeployCredentialFallbackForRequest() ||
+            !readDeployCredentialEnv(key)) {
+            return false;
+        }
+    }
+    return true;
+}
 /**
  * Resolve an AgentEngine from options → explicit env → app default →
  * request credentials → settings → env → default.