@agent-native/core 0.168.6 → 0.168.9

package/corpus/templates/factory/server/plugins/factory-migrations.ts

@@ -294,6 +294,86 @@ const migrations = [
       ALTER TABLE factory_config ADD COLUMN builder_slack_user_id TEXT;
     `,
   },
+  {
+    version: 20,
+    name: "factory-runtime-factory-id-columns",
+    sql: `
+      ALTER TABLE factory_config ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_items ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_rules ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_decisions ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_runs ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_feedback ADD COLUMN factory_id TEXT;
+      ALTER TABLE factory_audit_events ADD COLUMN factory_id TEXT;
+    `,
+  },
+  {
+    version: 21,
+    name: "factory-runtime-factory-id-backfill",
+    sql: {},
+    run: async () => {
+      const { getDbExec } = await import("@agent-native/core/db");
+      const exec = getDbExec();
+      const defaultFactoryId = "product-feedback";
+      const tables = [
+        "factory_config",
+        "factory_items",
+        "factory_rules",
+        "factory_decisions",
+        "factory_runs",
+        "factory_feedback",
+        "factory_audit_events",
+      ] as const;
+      for (const table of tables) {
+        await exec.execute({
+          sql: `UPDATE ${table} SET factory_id = ? WHERE factory_id IS NULL OR factory_id = ''`,
+          args: [defaultFactoryId],
+        });
+      }
+      const configRows = await exec.execute({
+        sql: `SELECT id, org_id FROM factory_config WHERE factory_id = ?`,
+        args: [defaultFactoryId],
+      });
+      for (const row of configRows.rows ?? []) {
+        const orgId = String(row.org_id ?? "");
+        const id = String(row.id ?? "");
+        if (!orgId || id.includes(":")) continue;
+        const nextId = `${orgId}:${defaultFactoryId}`;
+        await exec.execute({
+          sql: `UPDATE factory_config SET id = ? WHERE id = ? AND org_id = ?`,
+          args: [nextId, id, orgId],
+        });
+      }
+    },
+  },
+  {
+    version: 22,
+    name: "factory-items-org-factory-dedupe-index",
+    sql: `
+      CREATE UNIQUE INDEX IF NOT EXISTS factory_items_org_factory_dedupe_idx
+        ON factory_items (org_id, factory_id, dedupe_key);
+      CREATE INDEX IF NOT EXISTS factory_items_org_factory_status_idx
+        ON factory_items (org_id, factory_id, status, updated_at);
+      CREATE INDEX IF NOT EXISTS factory_audit_events_org_factory_created_idx
+        ON factory_audit_events (org_id, factory_id, created_at);
+    `,
+  },
+  {
+    version: 23,
+    name: "factory-items-drop-org-dedupe-index",
+    sql: `
+      DROP INDEX IF EXISTS factory_items_org_dedupe_idx;
+    `,
+  },
+  {
+    version: 24,
+    name: "factory-config-org-slack-channel-unique",
+    sql: `
+      CREATE UNIQUE INDEX IF NOT EXISTS factory_config_org_slack_channel_idx
+        ON factory_config (org_id, slack_channel_id)
+        WHERE slack_channel_id IS NOT NULL AND slack_channel_id != '';
+    `,
+  },
 ];
 
 export const runFactoryMigrations = runMigrations(migrations, {

package/corpus/templates/factory/server/plugins/factory-scheduler-job.ts

@@ -3,6 +3,7 @@ import { notify } from "@agent-native/core/notifications";
 import { resolveOrgIdForEmail } from "@agent-native/core/org";
 import {
   organizationResourceOwner,
+  resourceDeleteByPath,
   resourceGetByPath,
   resourcePut,
   resourcePutIfCurrent,
@@ -12,10 +13,21 @@ import {
   defineNitroPlugin,
   runWithRequestContext,
 } from "@agent-native/core/server";
+import { listAutomationDefinitions } from "@agent-native/core/triggers";
 import { and, eq, isNull, lt, ne, or } from "drizzle-orm";
 
 import { getDb } from "../db/index.js";
 import { triageConfig } from "../db/schema.js";
+import { repairFactoryAutomationsFromConfig } from "../lib/factory-automation-repair.js";
+import {
+  DEFAULT_FACTORY_ID,
+  factoryAutomationJobPath,
+  factoryConfigRowId,
+  patchAutomationResource,
+  readAutomationFactoryId,
+  readFactoryIdFromAutomationPath,
+  readTriageConfigRow,
+} from "../lib/factory-scope.js";
 import {
   repairSlackFeedbackPrompt,
   SLACK_HANDOFF_INSTRUCTION,
@@ -57,31 +69,23 @@ async function notifyFactoryAutomationFailure(
   if (
     (event.status !== "error" && event.status !== "interrupted") ||
     !event.orgId ||
-    !event.path.startsWith("jobs/factory-")
+    (!event.path.startsWith("jobs/factory-") &&
+      !event.path.startsWith("jobs/factories/"))
   ) {
     return;
   }
 
   const db = getDb();
-  const config = (
-    await db
-      .select({
-        ownerEmail: triageConfig.ownerEmail,
-        alertsEnabled: triageConfig.automationFailureAlertsEnabled,
-        alertEmail: triageConfig.automationFailureAlertEmail,
-      })
-      .from(triageConfig)
-      .where(
-        and(
-          eq(triageConfig.id, event.orgId),
-          eq(triageConfig.orgId, event.orgId),
-        ),
-      )
-      .limit(1)
-  )[0];
-  if (!config || config.alertsEnabled !== 1) return;
-
-  const recipient = (config.alertEmail || config.ownerEmail || "")
+  const factoryId =
+    readFactoryIdFromAutomationPath(event.path) ?? DEFAULT_FACTORY_ID;
+  const config = await readTriageConfigRow(db, event.orgId, factoryId);
+  if (!config || config.automationFailureAlertsEnabled !== 1) return;
+
+  const recipient = (
+    config.automationFailureAlertEmail ||
+    config.ownerEmail ||
+    ""
+  )
     .trim()
     .toLowerCase();
   if (!recipient) return;
@@ -92,6 +96,7 @@ async function notifyFactoryAutomationFailure(
   const alertKey = `${event.automation}\n${error}`.slice(0, 700);
   const now = new Date();
   const cutoff = new Date(now.getTime() - FAILURE_ALERT_COOLDOWN_MS);
+  const configRowId = factoryConfigRowId(event.orgId, factoryId);
   const claimed = await db
     .update(triageConfig)
     .set({
@@ -100,7 +105,7 @@ async function notifyFactoryAutomationFailure(
     })
     .where(
       and(
-        eq(triageConfig.id, event.orgId),
+        eq(triageConfig.id, configRowId),
         eq(triageConfig.orgId, event.orgId),
         eq(triageConfig.automationFailureAlertsEnabled, 1),
         or(
@@ -116,7 +121,7 @@ async function notifyFactoryAutomationFailure(
 
   const url = factoryPublicUrl();
   const debugTarget = url
-    ? `${url}/factory?tab=automations`
+    ? `${url}/factory?factoryId=${encodeURIComponent(factoryId)}&tab=automations`
     : "Factory > Automations";
   const details = [
     `Automation: ${event.automation}`,
@@ -440,10 +445,31 @@ function frontmatterField(content: string, key: string): string | undefined {
   return value.replace(/^(\"|')|((\"|')$)/g, "");
 }
 
+function automationFactoryScopeInstruction(factoryId: string): string {
+  return `This automation runs for factory \`${factoryId}\`. Pass \`factoryId: "${factoryId}"\` on every Factory triage, poll, and config action in this run.`;
+}
+
+function repairAutomationFactoryScopeInstruction(
+  content: string,
+  factoryId: string,
+): string {
+  if (content.includes(`Pass \`factoryId: "${factoryId}"\``)) {
+    return content;
+  }
+  const end = content.indexOf("\n---", 4);
+  if (end === -1) {
+    return `${automationFactoryScopeInstruction(factoryId)}\n\n${content.trim()}\n`;
+  }
+  const insertAt = end + 4;
+  return `${content.slice(0, insertAt)}\n\n${automationFactoryScopeInstruction(factoryId)}\n${content.slice(insertAt)}`;
+}
+
 function automationContent(
   ownerEmail: string,
   orgId: string,
+  factoryId: string,
   seed: AutomationSeed,
+  enabled = true,
 ): string {
   const body = syncManagedReviewSkillAlignment(
     seed.body.trim(),
@@ -451,17 +477,20 @@ function automationContent(
   );
   return `---
 schedule: "${seed.schedule}"
-${seed.timezone ? `timezone: ${seed.timezone}\n` : ""}enabled: true
+${seed.timezone ? `timezone: ${seed.timezone}\n` : ""}enabled: ${enabled ? "true" : "false"}
 triggerType: schedule
 domain: factory
 appId: factory
 orgId: ${orgId}
+factoryId: ${factoryId}
 createdBy: ${ownerEmail}
 runAs: creator
 model: ${seed.model}
 maxIterations: ${seed.maxIterations}
 maxRunInputTokens: ${seed.maxRunInputTokens}
 ---
+${automationFactoryScopeInstruction(factoryId)}
+
 ${body.trim()}
 `;
 }
@@ -480,20 +509,26 @@ async function disableLegacyObserver(): Promise<void> {
   }
 }
 
-async function ensureOrganizationAutomations(
+export async function ensureFactoryAutomations(
   ownerEmail: string,
   orgId: string,
+  factoryId: string,
+  options?: { enabled?: boolean; enabledNames?: ReadonlySet<string> },
 ): Promise<void> {
   const owner = organizationResourceOwner(orgId);
+  const defaultEnabled = options?.enabled ?? false;
   await Promise.all(
     AUTOMATION_SEEDS.map(async (seed) => {
-      const path = `jobs/${seed.name}.md`;
+      const enabled = options?.enabledNames
+        ? options.enabledNames.has(seed.name)
+        : defaultEnabled;
+      const path = factoryAutomationJobPath(factoryId, seed.name);
       const existing = await resourceGetByPath(owner, path);
       if (!existing) {
         await resourcePut(
           owner,
           path,
-          automationContent(ownerEmail, orgId, seed),
+          automationContent(ownerEmail, orgId, factoryId, seed, enabled),
           "text/markdown",
         );
         return;
@@ -507,6 +542,7 @@ async function ensureOrganizationAutomations(
       repaired = setFrontmatterField(repaired, "domain", "factory");
       repaired = setFrontmatterField(repaired, "appId", "factory");
       repaired = setFrontmatterField(repaired, "orgId", orgId);
+      repaired = setFrontmatterField(repaired, "factoryId", factoryId);
       repaired = setFrontmatterField(repaired, "createdBy", ownerEmail);
       repaired = setFrontmatterField(repaired, "runAs", "creator");
       if (!frontmatterField(repaired, "model")) {
@@ -552,6 +588,7 @@ async function ensureOrganizationAutomations(
       if (seed.name === "factory-slack-feedback") {
         repaired = repairSlackFeedbackPrompt(repaired);
       }
+      repaired = repairAutomationFactoryScopeInstruction(repaired, factoryId);
       if (repaired === existing.content) return;
 
       const updated = await resourcePutIfCurrent({
@@ -572,33 +609,95 @@ async function ensureOrganizationAutomations(
   );
 }
 
+export async function syncFactoryAutomationEnabledStates(
+  ownerEmail: string,
+  orgId: string,
+  factoryId: string,
+  enabledNames: readonly string[],
+): Promise<void> {
+  const enabledSet = new Set(enabledNames);
+  const definitions = await listAutomationDefinitions(
+    { userEmail: ownerEmail, orgId, appId: "factory" },
+    "organization",
+  );
+  await Promise.all(
+    definitions
+      .filter(
+        (definition) =>
+          readAutomationFactoryId(
+            definition.meta,
+            definition.resource.content,
+          ) === factoryId,
+      )
+      .map(async (definition) => {
+        const resource = await resourceGetByPath(
+          definition.resource.owner,
+          definition.resource.path,
+        );
+        if (!resource) return;
+        const leafName =
+          definition.resource.path.match(/([^/]+)\.md$/)?.[1] ??
+          definition.name;
+        const enabled = enabledSet.has(leafName);
+        const content = patchAutomationResource(resource.content, { enabled });
+        if (content === resource.content) return;
+        const updated = await resourcePutIfCurrent({
+          owner: definition.resource.owner,
+          path: definition.resource.path,
+          content,
+          mimeType: "text/markdown",
+          expectedId: resource.id,
+          expectedUpdatedAt: resource.updatedAt,
+          expectedContent: resource.content,
+        });
+        if (!updated) {
+          console.warn(
+            `[factory-scheduler-job] skipped enabled-state sync for ${definition.resource.path}: the resource changed concurrently`,
+          );
+        }
+      }),
+  );
+}
+
+export async function removeFactoryAutomationResources(
+  orgId: string,
+  factoryId: string,
+): Promise<void> {
+  const owner = organizationResourceOwner(orgId);
+  await Promise.all(
+    AUTOMATION_SEEDS.map(async (seed) => {
+      await resourceDeleteByPath(
+        owner,
+        factoryAutomationJobPath(factoryId, seed.name),
+      );
+    }),
+  );
+}
+
 async function ensureDefaultTriageConfig(
   ownerEmail: string,
   orgId: string,
 ): Promise<void> {
   const db = getDb();
-  const existing = (
-    await db
-      .select({
-        id: triageConfig.id,
-      })
-      .from(triageConfig)
-      .where(and(eq(triageConfig.id, orgId), eq(triageConfig.orgId, orgId)))
-      .limit(1)
-  )[0];
-  const repository = defaultRepository();
-  // Existing rows are operator-owned. An empty repository plus disabled
-  // polling can be an intentional choice, so do not infer bootstrap state.
-  if (existing) return;
+  const factoryId = DEFAULT_FACTORY_ID;
+  const existing = await readTriageConfigRow(db, orgId, factoryId);
+  if (existing) {
+    await repairFactoryAutomationsFromConfig(ownerEmail, orgId, factoryId);
+    return;
+  }
   const now = new Date().toISOString();
+  const repository = defaultRepository();
+  const pollingEnabled = 1;
+  const githubPollingEnabled = defaultGithubPollingEnabled() ? 1 : 0;
   await db.insert(triageConfig).values({
-    id: orgId,
+    id: factoryConfigRowId(orgId, factoryId),
+    factoryId,
     slackWorkspace: "primary",
     slackChannelId: DEFAULT_SLACK_CHANNEL_ID,
     slackChannelName: DEFAULT_SLACK_CHANNEL_NAME,
     builderSlackUserId: null,
-    pollingEnabled: 1,
-    githubPollingEnabled: defaultGithubPollingEnabled(),
+    pollingEnabled,
+    githubPollingEnabled,
     sentryPollingEnabled: 0,
     lastSlackTs: null,
     slackHistoryCursor: null,
@@ -612,6 +711,7 @@ async function ensureDefaultTriageConfig(
     ownerEmail,
     orgId,
   });
+  await repairFactoryAutomationsFromConfig(ownerEmail, orgId, factoryId);
 }
 
 async function ensureSchedulerJobs(): Promise<void> {
@@ -636,7 +736,6 @@ async function ensureSchedulerJobs(): Promise<void> {
     orgId = existingConfig.orgId?.trim() || existingConfig.id;
   }
   await ensureDefaultTriageConfig(ownerEmail, orgId);
-  await ensureOrganizationAutomations(ownerEmail, orgId);
   await disableLegacyObserver();
 }
 

package/corpus/templates/factory/server/triage/audit.ts

@@ -21,6 +21,7 @@ export interface FactoryAuditInput {
   action: string;
   kind: FactoryAuditKind;
   status?: FactoryAuditStatus;
+  factoryId?: string | null;
   itemId?: string | null;
   source?: string | null;
   sourceUrl?: string | null;
@@ -55,8 +56,10 @@ export async function recordFactoryAudit(
   context: ActionRunContext | undefined,
   identity: { userEmail: string; orgId: string },
   input: FactoryAuditInput,
+  factoryId?: string | null,
 ): Promise<void> {
   if (context?.caller !== "automation" || !context.runId) return;
+  const resolvedFactoryId = factoryId ?? input.factoryId ?? null;
   await getDb()
     .insert(factoryAuditEvents)
     .values({
@@ -64,6 +67,7 @@ export async function recordFactoryAudit(
       automationRunId: context.runId,
       automationThreadId: context.threadId ?? null,
       automationName: context.automation?.triggerName ?? null,
+      factoryId: resolvedFactoryId,
       itemId: input.itemId ?? null,
       source: input.source ?? null,
       sourceUrl: input.sourceUrl ?? null,

package/corpus/templates/factory/server/triage/ids.ts

@@ -13,9 +13,13 @@ export function itemDedupeKey(
     headSha?: string;
   },
   organizationId = "",
+  factoryId = "",
 ): string {
+  const factorySegment =
+    factoryId && factoryId !== "product-feedback" ? factoryId : "";
   return stableId(
     organizationId,
+    factorySegment,
     input.source,
     input.externalId,
     input.repository ?? "",

package/dist/cli/native-dependencies.js

@@ -58,7 +58,10 @@ function probeBetterSqlite3(packageDir) {
     }
 }
 export function checkNativeDependencies(fromDirectory = corePackageDirectory()) {
-    const packageDir = resolvePackageDirectory(BETTER_SQLITE3, fromDirectory);
+    const packageDir = resolvePackageDirectory(BETTER_SQLITE3, fromDirectory) ??
+        (path.resolve(fromDirectory) === corePackageDirectory()
+            ? null
+            : resolvePackageDirectory(BETTER_SQLITE3, corePackageDirectory()));
     if (!packageDir) {
         return { status: "absent", packageName: BETTER_SQLITE3 };
     }

package/dist/client/AgentPanel.d.ts

@@ -21,6 +21,8 @@
  *   <AgentChatSurface mode="page" className="h-screen" />
  */
 import React from "react";
+/** Start loading the desktop chat surface before a sidebar is opened. */
+export declare function preloadAgentChatSurface(): Promise<void>;
 import type { AgentChatSurfaceKind } from "./agent-chat-adapter.js";
 import type { AssistantChatProps } from "./AssistantChat.js";
 import type { MultiTabAssistantChatHeaderProps, MultiTabAssistantChatProps } from "./MultiTabAssistantChat.js";
@@ -223,6 +225,8 @@ export interface AgentSidebarProps {
     chatViewTransitionHandoff?: boolean;
     /** Namespace for persisted chat state. Use the same key as AgentChatHome. */
     storageKey?: string;
+    /** Restore the previously active chat thread on mount. Default: true. */
+    restoreActiveThread?: boolean;
     /** Namespace for the persisted open/closed preference. Defaults to storageKey. */
     openStorageKey?: string;
     /** API base URL used by the chat surface. */
@@ -262,7 +266,7 @@ export interface AgentSidebarProps {
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export declare function AgentSidebar({ children, enabled, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, scope, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, enabled, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, restoreActiveThread, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, scope, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.

package/dist/client/AgentPanel.js

@@ -36,9 +36,14 @@ import { ShareButton } from "./sharing/ShareButton.js";
 // assistant-ui + zod block schemas) so it is NOT in the static import closure of
 // every page. The header/tab chrome renders immediately; chat streams in once the
 // chunk lands (~650-700 KB gzip saved from the critical path).
-const MultiTabAssistantChatLazy = lazy(() => import("./MultiTabAssistantChat.js").then((m) => ({
+const loadMultiTabAssistantChat = () => import("./MultiTabAssistantChat.js").then((m) => ({
     default: m.MultiTabAssistantChat,
-})));
+}));
+const MultiTabAssistantChatLazy = lazy(loadMultiTabAssistantChat);
+/** Start loading the desktop chat surface before a sidebar is opened. */
+export function preloadAgentChatSurface() {
+    return loadMultiTabAssistantChat().then(() => undefined);
+}
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { Link, useLocation, useNavigate } from "react-router";
 import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
@@ -1418,7 +1423,7 @@ export function AgentChatSurface({ mode = "panel", className, defaultMode = "cha
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export function AgentSidebar({ children, enabled = true, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, scope, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
+export function AgentSidebar({ children, enabled = true, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, restoreActiveThread = true, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, scope, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
     const staticHostedHarnessEnabled = isHostedHarnessConfigured(injectedAgentNativeConfig().harness);
     const hostedHarnessQuery = useActionQuery("get-hosted-harness-config", undefined, { enabled: staticHostedHarnessEnabled });
     const hostedHarnessStatus = hostedHarnessQuery.data;
@@ -2062,7 +2067,7 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
                             ? "desktop"
                             : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": effectivePosition, "data-agent-native-hosted-harness-ui": hostedHarnessUi ? "desktop" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-per-app-chat": isPerAppChatSidebar ? "true" : undefined, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
-                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, availableAgents: effectiveAvailableAgents, availableModels: availableModels, modelListLoading: modelListLoading, selectedAgent: effectiveSelectedAgent, onAgentChange: effectiveOnAgentChange, hostedHarness: hostedHarnessEnabled, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, runtime: runtime, adapterReloadKey: adapterReloadKey, threadFooterSlot: threadFooterSlot, apiUrl: apiUrl, agentChatSurface: agentChatSurface, desktopIdentityUnauthenticated: desktopIdentityUnauthenticated, desktopIdentityAuthenticated: desktopIdentityAuthenticated, showTabBar: effectiveShowTabBar, suppressInlineOpenApp: suppressInlineOpenApp, composerPlaceholder: composerPlaceholder, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, scope: scope, isolateHistoryByScope: isolateHistoryByScope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: effectivePosition, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
+                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, availableAgents: effectiveAvailableAgents, availableModels: availableModels, modelListLoading: modelListLoading, selectedAgent: effectiveSelectedAgent, onAgentChange: effectiveOnAgentChange, hostedHarness: hostedHarnessEnabled, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, runtime: runtime, adapterReloadKey: adapterReloadKey, threadFooterSlot: threadFooterSlot, apiUrl: apiUrl, agentChatSurface: agentChatSurface, desktopIdentityUnauthenticated: desktopIdentityUnauthenticated, desktopIdentityAuthenticated: desktopIdentityAuthenticated, showTabBar: effectiveShowTabBar, suppressInlineOpenApp: suppressInlineOpenApp, composerPlaceholder: composerPlaceholder, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, restoreActiveThread: restoreActiveThread, scope: scope, isolateHistoryByScope: isolateHistoryByScope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: effectivePosition, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
     const drawerPlaceholder = wideDrawerEnabled && !presentationMode && panelOpen ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-drawer-placeholder shrink-0", "data-agent-sidebar-placeholder": "true", style: { width: drawerPlaceholderWidth + 1 } })) : null;
     return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": effectivePosition, "data-agent-native-hosted-harness-ui": hostedHarnessUi ? "desktop" : undefined, "data-agent-native-hosted-chat": isPerAppChatHosted ? "true" : undefined, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [isMobile &&
                             !isPerAppChatHosted &&

package/dist/client/agent-chat/index.d.ts

@@ -32,7 +32,7 @@ export { GuidedQuestionFlow, useGuidedQuestionFlow, askUserQuestion, formatGuide
 export { useChatThreads, type ChatThreadScope, type ChatThreadSnapshot, type ChatThreadSummary, type ChatThreadData, type ChatThreadShareLink, type ChatThreadShareState, type UseChatThreadsOptions, } from "../use-chat-threads.js";
 export { ChatHistoryList, type ChatHistoryItem, type ChatHistorySection, type ChatHistoryListProps, } from "../chat/ChatHistoryList.js";
 export { AgentChatHome, type AgentChatHomeProps } from "../AgentChatHome.js";
-export { AgentChatSurface, AgentPanel, AgentSidebar, AgentToggleButton, focusAgentChat, type AgentChatSurfaceMode, type AgentChatSurfaceProps, type AgentPanelProps, type AgentSidebarProps, } from "../AgentPanel.js";
+export { AgentChatSurface, AgentPanel, AgentSidebar, AgentToggleButton, focusAgentChat, preloadAgentChatSurface, type AgentChatSurfaceMode, type AgentChatSurfaceProps, type AgentPanelProps, type AgentSidebarProps, } from "../AgentPanel.js";
 export { AgentTabsPage, ConnectionsTab, type AgentPageExtraTabContext, type AgentPageExtraTabFactory, type AgentTabsPageProps, } from "../agent-page/AgentTabsPage.js";
 export type { AgentPageScope, AgentPageTabProps } from "../agent-page/types.js";
 export { AGENT_CHAT_HOME_HANDOFF_TTL_MS, AGENT_CHAT_VIEW_TRANSITION_CLASS, AGENT_CHAT_VIEW_TRANSITION_NAME, consumeAgentChatHomeHandoff, getAgentChatViewTransitionStyle, isAgentChatHomeHandoffActive, markAgentChatHomeHandoff, navigateWithAgentChatViewTransition, startAgentChatViewTransition, supportsAgentChatViewTransition, type AgentChatHomeHandoffOptions, type AgentChatViewTransition, type AgentChatViewTransitionOptions, } from "../chat-view-transition.js";

package/dist/client/agent-chat/index.js

@@ -32,7 +32,7 @@ export { GuidedQuestionFlow, useGuidedQuestionFlow, askUserQuestion, formatGuide
 export { useChatThreads, } from "../use-chat-threads.js";
 export { ChatHistoryList, } from "../chat/ChatHistoryList.js";
 export { AgentChatHome } from "../AgentChatHome.js";
-export { AgentChatSurface, AgentPanel, AgentSidebar, AgentToggleButton, focusAgentChat, } from "../AgentPanel.js";
+export { AgentChatSurface, AgentPanel, AgentSidebar, AgentToggleButton, focusAgentChat, preloadAgentChatSurface, } from "../AgentPanel.js";
 export { AgentTabsPage, ConnectionsTab, } from "../agent-page/AgentTabsPage.js";
 export { AGENT_CHAT_HOME_HANDOFF_TTL_MS, AGENT_CHAT_VIEW_TRANSITION_CLASS, AGENT_CHAT_VIEW_TRANSITION_NAME, consumeAgentChatHomeHandoff, getAgentChatViewTransitionStyle, isAgentChatHomeHandoffActive, markAgentChatHomeHandoff, navigateWithAgentChatViewTransition, startAgentChatViewTransition, supportsAgentChatViewTransition, } from "../chat-view-transition.js";
 export { useAgentChatHomeHandoff, useAgentChatHomeHandoffLinks, } from "../use-agent-chat-home-handoff.js";

package/dist/client/chat-first/apps-rail.js

@@ -1,5 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipTrigger, } from "@agent-native/toolkit/ui";
+import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@agent-native/toolkit/ui";
 import { IconApps, IconChevronDown, IconChevronUp, IconPin, IconPlus, IconTrash, } from "@tabler/icons-react";
 import { memo, useEffect, useMemo, useState } from "react";
 import { CHAT_FIRST_DEFAULT_APP_IDS, orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
@@ -133,11 +133,11 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, default
         persistLayout({ ...layout, orderedIds: nextOrder });
     }
     if (collapsed) {
-        return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [loading && apps.length === 0
-                    ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
-                    : visibleApps.map((app) => (_jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
-                            ? "text-sidebar-foreground"
-                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), title: app.name, children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }, app.id))), onOpenAllApps ? (_jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), title: copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }));
+        return (_jsx(TooltipProvider, { children: _jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [loading && apps.length === 0
+                        ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
+                        : visibleApps.map((app) => (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
+                                            ? "text-sidebar-foreground"
+                                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }) }), _jsx(TooltipContent, { side: "right", children: app.name })] }, app.id))), onOpenAllApps ? (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) }) }), _jsx(TooltipContent, { side: "right", children: copy("allApps") })] })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }) }));
     }
     return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, defaultAppIds: defaultAppIds, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
 });

package/dist/client/chat-first/primary-nav.js

@@ -1,4 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@agent-native/toolkit/ui";
 import { IconClock, IconPlus, IconPlugConnected, IconSearch, } from "@tabler/icons-react";
 import { defaultChatFirstCopy } from "./copy.js";
 export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, collapsed = false, stickyNewChat = false, copy = defaultChatFirstCopy, }) {
@@ -10,15 +11,22 @@ export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOp
         : tab === "integrations"
             ? copy("integrations")
             : copy("scheduled");
-    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, "aria-label": collapsed || tab === "new-chat" ? tabLabel(tab) : undefined, title: collapsed ? tabLabel(tab) : undefined, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
+    const renderTab = (tab, content, onSelect, className) => {
+        const label = tabLabel(tab);
+        const control = (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, "aria-label": collapsed || tab === "new-chat" ? label : undefined, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
+        return collapsed ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: control }), _jsx(TooltipContent, { side: "right", children: label })] })) : (control);
+    };
     const newChatTab = onNewChat
         ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("newChat") })] }), onNewChat, "code-agents-primary-new-chat")
         : null;
     const integrationsTab = renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("integrations") })] }), onOpenIntegrations);
     const scheduledTab = renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("scheduled") })] }), onOpenScheduled);
-    const searchAction = onSearch ? (_jsxs("button", { type: "button", "aria-label": collapsed ? copy("search") : undefined, title: collapsed ? copy("search") : undefined, className: `mt-px flex h-8 w-full items-center gap-2 rounded-md text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${collapsed ? "justify-center px-0" : "px-2"}`, onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("search") })] })) : null;
-    if (stickyNewChat) {
-        return (_jsxs(_Fragment, { children: [newChatTab ? (_jsx("div", { className: "code-agents-primary-new-chat-shell", children: newChatTab })) : null, _jsxs("div", { className: "code-agents-nav-list", "aria-label": "Agent navigation", children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [integrationsTab, scheduledTab] }), searchAction] })] }));
-    }
-    return (_jsxs("div", { children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [newChatTab, integrationsTab, scheduledTab] }), searchAction] }));
+    const searchAction = onSearch
+        ? (() => {
+            const label = copy("search");
+            const control = (_jsxs("button", { type: "button", "aria-label": collapsed ? label : undefined, className: `mt-px flex h-8 w-full items-center gap-2 rounded-md text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${collapsed ? "justify-center px-0" : "px-2"}`, onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: label })] }));
+            return collapsed ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: control }), _jsx(TooltipContent, { side: "right", children: label })] })) : (control);
+        })()
+        : null;
+    return (_jsx(TooltipProvider, { delayDuration: 0, children: stickyNewChat ? (_jsxs(_Fragment, { children: [newChatTab ? (_jsx("div", { className: "code-agents-primary-new-chat-shell", children: newChatTab })) : null, _jsxs("div", { className: "code-agents-nav-list", "aria-label": "Agent navigation", children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [integrationsTab, scheduledTab] }), searchAction] })] })) : (_jsxs("div", { children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [newChatTab, integrationsTab, scheduledTab] }), searchAction] })) }));
 }