@truefoundry/trueforge-ui 0.3.0-rc.2 → 0.3.0-rc.4

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import * as react from 'react';
-import react__default, { CSSProperties, ReactNode, FC, SVGProps, ComponentType, ComponentPropsWithRef, ComponentProps, HTMLAttributes, ComponentPropsWithoutRef, PropsWithChildren } from 'react';
+import react__default, { CSSProperties, ReactNode, FC, SVGProps, ComponentType, ComponentPropsWithRef, ComponentProps, HTMLAttributes, ReactElement, MouseEventHandler, ComponentPropsWithoutRef, PropsWithChildren } from 'react';
 import { LucideIcon } from 'lucide-react';
-import { SessionEventItem, AgentDetail, AgentMetricMeter, AgentMetricChartDefinition, AgentMetricGraph, CodeSnippet, AgentLibraryEntry, AgentSpec, ModelSelection, ConnectorState, AgentSkill, McpToolSelection, AgentRuntimeConfig, Schedule, ScheduleRun, ScheduleStatus, CatalogServer, AgentUIServer, AgentMetricsServer, AgentSessionsServer, ScheduleServer, AgentBuilderCapabilitiesResponse } from '@truefoundry/assistant-ui-runtime/server';
-export { AgentBuilderCapabilitiesResponse, AgentBuilderServer, AgentChatServer, AgentDetail, AgentLibraryEntry, AgentMetricChartData, AgentMetricChartDataRequest, AgentMetricChartDefinition, AgentMetricChartType, AgentMetricGraph, AgentMetricGraphLine, AgentMetricMeter, AgentMetricPoint, AgentMetricRangeRequest, AgentMetricsServer, AgentSessionsServer, AgentSkill, AgentSpec, AgentUIServer, ApprovalDecision, AuthenticateConnectorRequest, CatalogServer, CodeSnippet, CodeSnippetSampleCode, ConnectorAuth, ConnectorAuthApiKey, ConnectorAuthNone, ConnectorAuthOAuth, ConnectorAuthPublic, ConnectorAuthPublicApiKey, ConnectorAuthPublicNone, ConnectorAuthPublicOAuth, ConnectorAuthType, ConnectorAuthenticationResult, ConnectorBase, ConnectorCatalogEntry, ConnectorCatalogServer, ConnectorConfigBase, ConnectorState, CreateConnectorRequest, CreateModelProviderRequest, CreateSandboxProviderRequest, CreateSessionRequest, CreateSkillRequest, CreateSkillRequestBase, DefinedSkill, GithubSkill, ImportGithubSkillRequest, ListResult, ListSessionEventsParams, ListSessionsOrder, ListSessionsParams, McpServerMount, Model, ModelCatalogServer, ModelEntry, ModelParams, ModelProperties, ModelProviderBase, ModelProviderCatalogEntry, ModelProviderConfigBase, ModelSelection, ModelSelectorEntry, PageParams, PreviousTurnIdInput, ProviderEntry, ProviderType, RegistrySkill, SandboxCatalogServer, SandboxProviderBase, SandboxProviderCatalogEntry, SandboxProviderConfig, SandboxProviderListEntry, SandboxSnapshotSyncStatus, SaveAgentRequest, SaveAgentResult, SearchAgentsParams, SelectRegistrySkillRequest, Session, SessionEventItem, SessionListEntry, SessionListMetrics, SkillBase, SkillCatalogEntry, SkillCatalogServer, SkillConfigBase, SkillMount, ToolBase, Turn, TurnDoneMetrics, TurnInputItem, TurnState, TurnStreamData, TurnStreamingEvent, UpdateConnectorRequest, UpdateModelProviderRequest, UpdateSandboxProviderRequest, UpdateSessionRequest, UserMessage, UserMessageContent, UserToolApprovalEvent, UserToolResponseEvent } from '@truefoundry/assistant-ui-runtime/server';
+import { SessionEventItem, AgentDetail, AgentMetricMeter, AgentMetricChartDefinition, AgentMetricGraph, CodeSnippet, AgentLibraryEntry, AgentSpec, ModelSelection, ConnectorState, AgentSkill, McpToolSelection, AgentRuntimeConfig, Schedule, ScheduleRun, ScheduleStatus, CatalogServer, PermissionsServer, AgentUIServer, PermissionResourceType, ResourcePermission, AgentMetricsServer, AgentSessionsServer, ScheduleServer, AgentBuilderCapabilitiesResponse } from '@truefoundry/assistant-ui-runtime/server';
+export { AgentBuilderCapabilitiesResponse, AgentBuilderServer, AgentChatServer, AgentDetail, AgentLibraryEntry, AgentMetricChartData, AgentMetricChartDataRequest, AgentMetricChartDefinition, AgentMetricChartType, AgentMetricGraph, AgentMetricGraphLine, AgentMetricMeter, AgentMetricPoint, AgentMetricRangeRequest, AgentMetricsServer, AgentSessionsServer, AgentSkill, AgentSpec, AgentUIServer, ApprovalDecision, AuthenticateConnectorRequest, CatalogServer, CodeSnippet, CodeSnippetSampleCode, ConnectorAuth, ConnectorAuthApiKey, ConnectorAuthNone, ConnectorAuthOAuth, ConnectorAuthPublic, ConnectorAuthPublicApiKey, ConnectorAuthPublicNone, ConnectorAuthPublicOAuth, ConnectorAuthType, ConnectorAuthenticationResult, ConnectorBase, ConnectorCatalogEntry, ConnectorCatalogServer, ConnectorConfigBase, ConnectorState, CreateConnectorRequest, CreateModelProviderRequest, CreateSandboxProviderRequest, CreateSessionRequest, CreateSkillRequest, CreateSkillRequestBase, CreatedBySubject, DefinedSkill, GithubSkill, ImportGithubSkillRequest, ListPermissionsRequest, ListPermissionsResponse, ListResult, ListSessionEventsParams, ListSessionsOrder, ListSessionsParams, McpServerMount, Model, ModelCatalogServer, ModelEntry, ModelParams, ModelProperties, ModelProviderBase, ModelProviderCatalogEntry, ModelProviderConfigBase, ModelSelection, ModelSelectorEntry, PageParams, PermissionResourceType, PermissionsServer, PreviousTurnIdInput, ProviderEntry, ProviderType, RegistrySkill, ResourcePermission, SandboxCatalogServer, SandboxProviderBase, SandboxProviderCatalogEntry, SandboxProviderConfig, SandboxProviderListEntry, SandboxSnapshotSyncStatus, SaveAgentRequest, SaveAgentResult, SearchAgentsParams, SelectRegistrySkillRequest, Session, SessionEventItem, SessionListEntry, SessionListMetrics, SkillBase, SkillCatalogEntry, SkillCatalogServer, SkillConfigBase, SkillMount, ToolBase, Turn, TurnDoneMetrics, TurnInputItem, TurnState, TurnStreamData, TurnStreamingEvent, UpdateConnectorRequest, UpdateModelProviderRequest, UpdateSandboxProviderRequest, UpdateSessionRequest, UserMessage, UserMessageContent, UserToolApprovalEvent, UserToolResponseEvent } from '@truefoundry/assistant-ui-runtime/server';
 import { TrueForgeApi } from '@truefoundry/trueforge-sdk';
 import { MessagePrimitive, ToolCallMessagePartComponent } from '@assistant-ui/react';
 export { AssistantState, useAui, useAuiState } from '@assistant-ui/react';
 import { UseTrueFoundryAgentRuntimeOptions, TrueFoundryAgentConfig } from '@truefoundry/assistant-ui-runtime';
-export { DraftAgentConfig, NamedAgentConfig, TrueFoundryAgentConfig, UseTrueFoundryAgentRuntimeOptions, mergeAgentSpec, trueFoundryAttachmentAdapter, useTrueFoundryAgentRuntime, useTrueFoundryAgentSpec, useTrueFoundryCancel, useTrueFoundryDownloadSandboxFile, useTrueFoundryHistoryPagination, useTrueFoundryMcpAuth, useTrueFoundryRespondToToolApproval, useTrueFoundryToolResponses, useTrueFoundryTurnId, useTrueFoundryUpdateAgentSpec } from '@truefoundry/assistant-ui-runtime';
-export { C as CreateTrueFoundryServerOptions, T as TrueFoundryServer, c as createTrueFoundryServer } from './createTrueFoundryServer-CmZnBh_l.js';
+export { DraftAgentConfig, NamedAgentConfig, TrueFoundryAgentConfig, UseTrueFoundryAgentRuntimeOptions, mergeAgentSpec, trueFoundryAttachmentAdapter, useTrueFoundryAgentRuntime, useTrueFoundryAgentSpec, useTrueFoundryApprovals, useTrueFoundryCancel, useTrueFoundryDownloadSandboxFile, useTrueFoundryHistoryPagination, useTrueFoundryMcpAuth, useTrueFoundryRespondToToolApproval, useTrueFoundryToolResponses, useTrueFoundryTurnId, useTrueFoundryUpdateAgentSpec } from '@truefoundry/assistant-ui-runtime';
+export { C as CreateTrueFoundryServerOptions, T as TrueFoundryServer, c as createTrueFoundryServer } from './createTrueFoundryServer-B_FYhSdn.js';
 import { PartState } from '@assistant-ui/core/react';
 
 type ThemeMode = 'light' | 'dark' | 'system';
@@ -460,7 +460,7 @@ type SessionMetrics = {
     toolCallFrequency: SessionMetricBarDatum[];
 };
 
-type LibraryAgentTab = 'overview' | 'sessions' | 'code' | 'metrics';
+type LibraryAgentTab = 'overview' | 'sessions' | 'schedules' | 'code' | 'metrics';
 type SessionTimeRange = {
     startTs: number;
     endTs: number;
@@ -478,6 +478,7 @@ type AgentSessionsProps = {
 type AgentSessionListRowProps = {
     title: string;
     agentName?: string;
+    sourceType?: 'schedule';
     lastActivityAt: string;
     metrics: {
         totalTurns: number;
@@ -503,6 +504,8 @@ type AgentSessionDetailHeaderProps = {
     onResume?: () => void;
     /** Label for the resume action. */
     resumeLabel?: string;
+    /** Whether the current user may resume this session. */
+    canResume?: boolean;
 };
 type AgentSessionTurnHeaderProps = {
     turnNumber: number;
@@ -540,6 +543,7 @@ type AgentDetailsTabsProps = {
     activeTab: AgentDetailsTab;
     onTabChange: (tab: AgentDetailsTab) => void;
     showMetrics?: boolean;
+    showSchedules?: boolean;
 };
 type AgentMetricsProps = {
     agentId: string;
@@ -558,6 +562,9 @@ type AgentMetricsViewProps = {
     timeRange: SessionTimeRange;
     onTimeRangeChange: (range: SessionTimeRange) => void;
 };
+type AgentMetricStatisticsProps = {
+    meters: AgentMetricMeter[];
+};
 type AgentMetricsTimeRangeFilterProps = {
     timeRange: SessionTimeRange;
     onTimeRangeChange: (range: SessionTimeRange) => void;
@@ -569,6 +576,7 @@ type AgentMetricChartProps = {
     graph?: AgentMetricGraph;
     definition: AgentMetricChartDefinition;
     error?: string;
+    colorIndex?: number;
 };
 type AgentOverviewProps = {
     detail: AgentDetail;
@@ -612,7 +620,7 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
-declare function AgentDetailsTabs({ activeTab, onTabChange, showMetrics }: AgentDetailsTabsProps): react.JSX.Element;
+declare function AgentDetailsTabs({ activeTab, onTabChange, showMetrics, showSchedules, }: AgentDetailsTabsProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentDetailsTabs: typeof AgentDetailsTabs;
@@ -640,9 +648,11 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
+declare function AgentMetricStatistics({ meters }: AgentMetricStatisticsProps): react.JSX.Element;
 declare function AgentMetricsView({ meters, meterError, charts, chartsLoading, chartsError, timeRange, onTimeRangeChange, }: AgentMetricsViewProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
+        AgentMetricStatistics: ComponentType<AgentMetricStatisticsProps>;
         AgentMetricsView: ComponentType<AgentMetricsViewProps>;
     }
 }
@@ -654,14 +664,14 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
-declare function AgentSessionDetailHeader({ title, sessionId, agentId, createdAt, view, onClose, resumeHref, onResume, resumeLabel, }: AgentSessionDetailHeaderProps): react.JSX.Element;
+declare function AgentSessionDetailHeader({ title, sessionId, agentId, createdAt, view, onClose, resumeHref, onResume, resumeLabel, canResume, }: AgentSessionDetailHeaderProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentSessionDetailHeader: typeof AgentSessionDetailHeader;
     }
 }
 
-declare function AgentSessionListRow({ title, agentName, lastActivityAt, metrics, active, onSelect, }: AgentSessionListRowProps): react.JSX.Element;
+declare function AgentSessionListRow({ title, agentName, sourceType, lastActivityAt, metrics, active, onSelect, }: AgentSessionListRowProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentSessionListRow: typeof AgentSessionListRow;
@@ -709,12 +719,18 @@ type AgentsLibraryProps = {
 };
 type AgentScheduleSummary = {
     count: number;
-    hasPaused: boolean;
+    pausedCount: number;
+    activeNames: string[];
+    pausedNames: string[];
 };
 type AgentLibraryRowProps = {
     agent: AgentLibraryEntry;
     canMutate: boolean;
+    canUseAgent?: boolean;
+    canManageAgent?: boolean;
+    canDeleteAgent?: boolean;
     canManageSchedules: boolean;
+    showCreatedBy?: boolean;
     scheduleSummary?: AgentScheduleSummary | null;
     onOpenSchedules?: () => void;
     onCreateSchedule?: () => void;
@@ -723,7 +739,7 @@ type AgentLibraryRowProps = {
     onEdit: () => void;
     onManageSchedules?: () => void;
 };
-declare function AgentLibraryRow({ agent, canMutate, canManageSchedules, scheduleSummary, onOpenSchedules, onCreateSchedule, onOpen, onTry, onEdit, onManageSchedules, }: AgentLibraryRowProps): react.JSX.Element;
+declare function AgentLibraryRow({ agent, canMutate, canUseAgent, canManageAgent, canDeleteAgent, canManageSchedules, showCreatedBy, scheduleSummary, onOpenSchedules, onCreateSchedule, onOpen, onTry, onEdit, onManageSchedules, }: AgentLibraryRowProps): react.JSX.Element;
 declare function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps): react.JSX.Element | null;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
@@ -743,6 +759,25 @@ declare module '../theme/SlotsProvider.js' {
     }
 }
 
+type ApprovalNavBannerProps = {
+    total: number;
+    /** 1-based index for display, e.g. 1 in "(1/4)". */
+    current: number;
+    canPrev: boolean;
+    canNext: boolean;
+    onPrev: () => void;
+    onNext: () => void;
+    /** Scroll the thread to the currently selected approval. */
+    onFocusCurrent: () => void;
+    className?: string;
+};
+declare function ApprovalNavBanner({ total, current, canPrev, canNext, onPrev, onNext, onFocusCurrent, className, }: ApprovalNavBannerProps): react.JSX.Element;
+declare module '../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        ApprovalNavBanner: typeof ApprovalNavBanner;
+    }
+}
+
 type AssistantMessageBubbleProps = {
     children: ReactNode;
     error?: ReactNode;
@@ -946,12 +981,13 @@ type AgentConfigEditorsProps = {
     sandboxAvailable?: boolean;
     instructions?: string;
     onInstructionsSave?: (draft: AgentInstructionsDraft) => void;
+    loadMcpConnector?: (connectorId: string) => Promise<ConnectorState | undefined>;
     loadMcpTools?: (connectorId: string) => Promise<McpToolSelection[]>;
     onRefreshConnectors?: () => Promise<void>;
     onChange: (spec: AgentSpec) => void;
     onClose: () => void;
 };
-declare function AgentConfigEditors({ editor, spec, models, connectors, skills, loading, error, skillsDisabled, sandboxAvailable, instructions, onInstructionsSave, loadMcpTools, onRefreshConnectors, onChange, onClose, }: AgentConfigEditorsProps): react.JSX.Element;
+declare function AgentConfigEditors({ editor, spec, models, connectors, skills, loading, error, skillsDisabled, sandboxAvailable, instructions, onInstructionsSave, loadMcpConnector, loadMcpTools, onRefreshConnectors, onChange, onClose, }: AgentConfigEditorsProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentConfigEditors: typeof AgentConfigEditors;
@@ -961,11 +997,16 @@ declare module '../../theme/SlotsProvider.js' {
 type AgentConfigPanelProps = {
     spec: AgentSpec;
     model?: ModelSelection;
+    models: ModelSelection[];
+    modelsLoading: boolean;
+    modelsError: string | null;
+    skills?: AgentSkill[];
     skillsAvailable: boolean;
     instructions: string;
     onOpenEditor: (editor: AgentConfigEditor) => void;
     onChange?: (spec: AgentSpec) => void;
     onClose?: () => void;
+    disabled?: boolean;
 };
 declare function AgentConfigSection({ title, description, icon, actionIcon, actionLabel, onEdit, children, }: {
     title?: string;
@@ -976,7 +1017,7 @@ declare function AgentConfigSection({ title, description, icon, actionIcon, acti
     onEdit?: () => void;
     children?: ReactNode;
 }): react.JSX.Element;
-declare function AgentConfigPanel({ spec, model, skillsAvailable, instructions, onOpenEditor, onChange, onClose, }: AgentConfigPanelProps): react.JSX.Element;
+declare function AgentConfigPanel({ spec, model, models, modelsLoading, modelsError, skills: catalogSkills, skillsAvailable, instructions, onOpenEditor, onChange, onClose, disabled, }: AgentConfigPanelProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentConfigPanel: typeof AgentConfigPanel;
@@ -984,21 +1025,35 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
+type AgentCustomParametersEditorProps = {
+    value: Record<string, unknown>;
+    reservedKeys: ReadonlySet<string>;
+    onChange: (value: Record<string, unknown>) => void;
+};
+declare function AgentCustomParametersEditor({ value, reservedKeys, onChange }: AgentCustomParametersEditorProps): react.JSX.Element;
+declare module '../../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        AgentCustomParametersEditor: typeof AgentCustomParametersEditor;
+    }
+}
+
 type AgentMcpEditorContentProps = {
     spec: AgentSpec;
     connectors: ConnectorState[];
     query: string;
     activeConnectorId: string | null;
     tools: McpToolSelection[];
+    connectorLoading: boolean;
+    connectorError: string | null;
     toolsLoading: boolean;
     toolsError: string | null;
     onQueryChange: (query: string) => void;
     onSelectConnector: (connectorId: string) => void;
     onRetryTools: () => void;
-    onRefreshConnectors?: () => Promise<void>;
+    onRefreshConnector?: () => void;
     onChange: (spec: AgentSpec) => void;
 };
-declare function AgentMcpEditorContent({ spec, connectors, query, activeConnectorId, tools, toolsLoading, toolsError, onQueryChange, onSelectConnector, onRetryTools, onRefreshConnectors, onChange, }: AgentMcpEditorContentProps): react.JSX.Element;
+declare function AgentMcpEditorContent({ spec, connectors, query, activeConnectorId, tools, connectorLoading, connectorError, toolsLoading, toolsError, onQueryChange, onSelectConnector, onRetryTools, onRefreshConnector, onChange, }: AgentMcpEditorContentProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentMcpEditorContent: typeof AgentMcpEditorContent;
@@ -1024,7 +1079,6 @@ declare module '../../theme/SlotsProvider.js' {
 }
 
 type AgentModelEditorContentProps = {
-    editor: 'model' | 'model-settings';
     spec: AgentSpec;
     models: ModelSelection[];
     loading: boolean;
@@ -1033,7 +1087,7 @@ type AgentModelEditorContentProps = {
     onQueryChange: (query: string) => void;
     onChange: (spec: AgentSpec) => void;
 };
-declare function AgentModelEditorContent({ editor, spec, models, loading, error, query, onQueryChange, onChange, }: AgentModelEditorContentProps): react.JSX.Element;
+declare function AgentModelEditorContent({ spec, models, loading, error, query, onQueryChange, onChange, }: AgentModelEditorContentProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentModelEditorContent: typeof AgentModelEditorContent;
@@ -1061,12 +1115,14 @@ type AgentResourceConfigModalProps = {
     query: string;
     activeConnectorId: string | null;
     tools: McpToolSelection[];
+    connectorLoading: boolean;
+    connectorError: string | null;
     toolsLoading: boolean;
     toolsError: string | null;
     onQueryChange: (query: string) => void;
     onSelectConnector: (connectorId: string) => void;
     onRetryTools: () => void;
-    onRefreshConnectors?: () => Promise<void>;
+    onRefreshConnector?: () => void;
     onChange: (spec: AgentSpec) => void;
     onClose: () => void;
 };
@@ -1086,12 +1142,14 @@ type AgentResourceEditorContentProps = {
     query: string;
     activeConnectorId: string | null;
     tools: McpToolSelection[];
+    connectorLoading: boolean;
+    connectorError: string | null;
     toolsLoading: boolean;
     toolsError: string | null;
     onQueryChange: (query: string) => void;
     onSelectConnector: (connectorId: string) => void;
     onRetryTools: () => void;
-    onRefreshConnectors?: () => Promise<void>;
+    onRefreshConnector?: () => void;
     onChange: (spec: AgentSpec) => void;
 };
 declare function AgentResourceEditorContent(props: AgentResourceEditorContentProps): react.JSX.Element;
@@ -1101,6 +1159,20 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
+type AgentRuntimeConfigDrawerProps = {
+    open: boolean;
+    spec: AgentSpec;
+    sandboxAvailable: boolean;
+    onChange: (spec: AgentSpec) => void;
+    onClose: () => void;
+};
+declare function AgentRuntimeConfigDrawer({ open, spec, sandboxAvailable, onChange, onClose, }: AgentRuntimeConfigDrawerProps): react.JSX.Element;
+declare module '../../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        AgentRuntimeConfigDrawer: typeof AgentRuntimeConfigDrawer;
+    }
+}
+
 type AgentRuntimeConfigFieldsProps = {
     value: AgentRuntimeConfig;
     sandboxAvailable: boolean;
@@ -1117,20 +1189,6 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
-type AgentRuntimeConfigModalProps = {
-    open: boolean;
-    spec: AgentSpec;
-    sandboxAvailable: boolean;
-    onChange: (spec: AgentSpec) => void;
-    onClose: () => void;
-};
-declare function AgentRuntimeConfigModal({ open, spec, sandboxAvailable, onChange, onClose, }: AgentRuntimeConfigModalProps): react.JSX.Element;
-declare module '../../theme/SlotsProvider.js' {
-    interface AtomSlots {
-        AgentRuntimeConfigModal: typeof AgentRuntimeConfigModal;
-    }
-}
-
 type AgentRuntimeEditorContentProps = {
     spec: AgentSpec;
     sandboxAvailable: boolean;
@@ -1188,6 +1246,23 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
+type DraftComposerAction = {
+    id: string;
+    label: string;
+    icon: string;
+    onSelect: () => void;
+};
+type DraftComposerActionsMenuProps = {
+    actions: DraftComposerAction[];
+    disabled?: boolean;
+};
+declare function DraftComposerActionsMenu({ actions, disabled }: DraftComposerActionsMenuProps): react.JSX.Element | null;
+declare module '../../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        DraftComposerActionsMenu: typeof DraftComposerActionsMenu;
+    }
+}
+
 declare function DraftComposerLeftSection({ disabled, isRunning, onAttach }: ComposerLeftSectionProps): react.JSX.Element;
 declare function DraftComposerRightSection({ disabled, isRunning }: ComposerRightSectionProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
@@ -1197,9 +1272,10 @@ declare module '../../theme/SlotsProvider.js' {
     }
 }
 
-declare function CatalogRow({ title, description, logo, fallbackIcon, checked, disabled, onToggle, onActivate, action, }: {
+declare function CatalogRow({ title, description, badge, logo, fallbackIcon, checked, disabled, onToggle, onActivate, action, }: {
     title: string;
     description?: string;
+    badge?: ReactNode;
     /** Catalog logo URL; when absent, `fallbackIcon` (or the title initial) is shown. */
     logo?: string | undefined;
     fallbackIcon?: string;
@@ -1315,6 +1391,20 @@ declare module '../theme/SlotsProvider.js' {
     }
 }
 
+type PermissionGuardProps = {
+    allowed: boolean;
+    children: ReactElement<{
+        disabled?: boolean;
+    }>;
+    deniedMessage?: string;
+};
+declare function PermissionGuard({ allowed, children, deniedMessage, }: PermissionGuardProps): react.JSX.Element;
+declare module '../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        PermissionGuard: typeof PermissionGuard;
+    }
+}
+
 type SandboxArtifactDownloadProps = {
     code: string;
     fileDownloadBaseUrl?: string;
@@ -1344,6 +1434,8 @@ type ToolCallCardProps = {
     showResponseLine?: boolean;
     responseIcon?: ReactNode;
     approvalSlot?: ReactNode;
+    /** When set, this card is the scroll/flash target for approval banner navigation. */
+    approvalId?: string;
     requestSlot?: ReactNode;
     responseSlot?: ReactNode;
     highlightCard?: boolean;
@@ -1351,7 +1443,7 @@ type ToolCallCardProps = {
     mcpServerName?: string;
     dataTestPrefix?: string;
 };
-declare function ToolCallCard({ icon, iconClassName, iconVariant, toolName, expanded, onToggle, awaiting, awaitingText, status: explicitStatus, exitCode, showExpandChevron, showResponseLine, approvalSlot, requestSlot, responseSlot, highlightCard, className, mcpServerName: _mcpServerName, dataTestPrefix, }: ToolCallCardProps): react.JSX.Element;
+declare function ToolCallCard({ icon, iconClassName, iconVariant, toolName, expanded, onToggle, awaiting, awaitingText, status: explicitStatus, exitCode, showExpandChevron, showResponseLine, approvalSlot, approvalId, requestSlot, responseSlot, highlightCard, className, mcpServerName: _mcpServerName, dataTestPrefix, }: ToolCallCardProps): react.JSX.Element;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
         ToolCallCard: typeof ToolCallCard;
@@ -1373,10 +1465,13 @@ type SandboxToolCallCardProps = {
     hasContent?: boolean;
     onViewModeChange?: (viewMode: 'terminal' | 'code') => void;
     durationText?: string;
+    approvalSlot?: ReactNode;
+    /** When set, this card is the scroll/flash target for approval banner navigation. */
+    approvalId?: string;
     dataTestPrefix?: string;
     className?: string;
 };
-declare function SandboxToolCallCard({ name, intent, status, expanded, onToggle, command, exitCode, argsJson, resultText, resultJson, viewMode, hasContent, onViewModeChange, durationText, dataTestPrefix, className, }: SandboxToolCallCardProps): react.JSX.Element;
+declare function SandboxToolCallCard({ name, intent, status, expanded, onToggle, command, exitCode, argsJson, resultText, resultJson, viewMode, hasContent, onViewModeChange, durationText, approvalSlot, approvalId, dataTestPrefix, className, }: SandboxToolCallCardProps): react.JSX.Element;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
         SandboxToolCallCard: typeof SandboxToolCallCard;
@@ -1397,50 +1492,32 @@ declare module '../theme/SlotsProvider.js' {
     }
 }
 
-type EditableMount = {
-    id: string;
-    name: string;
-    value: object;
-};
-
 type SaveAgentFormProps = {
     intent: 'create' | 'update';
     name: string;
     spec: AgentSpec;
-    modelEntry?: ModelSelection;
-    mcpMounts: EditableMount[];
-    skillMounts: EditableMount[];
     saving: boolean;
     error: string | null;
     onNameChange: (name: string) => void;
     onChange: (spec: AgentSpec) => void;
-    onEdit: (editor: AgentConfigEditor) => void;
-    onToggleMcpPreload: (id: string) => void;
-    onRemoveMcp?: (id: string) => void;
     onCancel: () => void;
     onSave: () => void;
 };
-declare function SaveAgentForm({ intent, name, spec, modelEntry, mcpMounts, skillMounts, saving, error, onNameChange, onChange, onEdit, onToggleMcpPreload, onRemoveMcp, onCancel, onSave, }: SaveAgentFormProps): react.JSX.Element;
+declare function SaveAgentForm({ intent, name, spec, saving, error, onNameChange, onCancel, onSave, }: SaveAgentFormProps): react.JSX.Element;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
         SaveAgentForm: typeof SaveAgentForm;
     }
 }
 
-type SaveAgentFormFieldsProps = {
-    spec: AgentSpec;
-    modelEntry?: ModelSelection;
-    mcpMounts: EditableMount[];
-    skillMounts: EditableMount[];
-    disabled: boolean;
-    onEdit: (editor: AgentConfigEditor) => void;
-    onToggleMcpPreload: (id: string) => void;
-    onRemoveMcp?: (id: string) => void;
+type SchedulesPageProps = {
+    /** Lock the page to one agent when embedded in Agent Details. */
+    agentId?: string;
 };
-declare function SaveAgentFormFields({ spec, modelEntry, mcpMounts, skillMounts, disabled, onEdit, onToggleMcpPreload, onRemoveMcp, }: SaveAgentFormFieldsProps): react.JSX.Element;
-declare module '../theme/SlotsProvider.js' {
+declare function SchedulesPage({ agentId }: SchedulesPageProps): react.JSX.Element;
+declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
-        SaveAgentFormFields: typeof SaveAgentFormFields;
+        SchedulesPage: ComponentType<SchedulesPageProps>;
     }
 }
 
@@ -1529,7 +1606,7 @@ type ThreadListEmptyStateProps = {
 };
 declare function ThreadListEmptyState({ message, className }: ThreadListEmptyStateProps): react.JSX.Element;
 type ThreadListShellProps = {
-    header: ReactNode;
+    header?: ReactNode;
     children: ReactNode;
     className?: string;
 };
@@ -1660,16 +1737,28 @@ declare module '../theme/SlotsProvider.js' {
     }
 }
 
+type UserAvatarProps = {
+    labeled?: boolean;
+    className?: string;
+};
+declare function UserAvatar({ labeled, className }: UserAvatarProps): react.JSX.Element | null;
+declare module '../theme/SlotsProvider.js' {
+    interface AtomSlots {
+        UserAvatar: typeof UserAvatar;
+    }
+}
+
 type UserMessageActionBarProps = {
     isCopied: boolean;
     editDisabled?: boolean;
+    retryDisabled?: boolean;
     createdAt?: Date | string;
     onCopy: () => void;
     onEdit: () => void;
     onRetry: () => void;
     className?: string;
 };
-declare function UserMessageActionBar({ isCopied, editDisabled, createdAt, onCopy, onEdit, onRetry, className, }: UserMessageActionBarProps): react.JSX.Element;
+declare function UserMessageActionBar({ isCopied, editDisabled, retryDisabled, createdAt, onCopy, onEdit, onRetry, className, }: UserMessageActionBarProps): react.JSX.Element;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
         UserMessageActionBar: typeof UserMessageActionBar;
@@ -1734,10 +1823,13 @@ declare const defaultSlots: {
     ComposerLeftSection: typeof ComposerLeftSection;
     ComposerRightSection: typeof ComposerRightSection;
     ComposerSendButton: typeof ComposerSendButton;
+    PermissionGuard: typeof PermissionGuard;
     DraftComposerLeftSection: typeof DraftComposerLeftSection;
     DraftComposerRightSection: typeof DraftComposerRightSection;
     DraftAgentConfigTrigger: typeof DraftAgentConfigTrigger;
     DraftCapabilitiesPanel: typeof DraftCapabilitiesPanel;
+    DraftComposerActionsMenu: typeof DraftComposerActionsMenu;
+    AgentCustomParametersEditor: typeof AgentCustomParametersEditor;
     AgentConfigEditors: typeof AgentConfigEditors;
     AgentInstructionsDrawer: typeof AgentInstructionsDrawer;
     AgentModelEditorContent: typeof AgentModelEditorContent;
@@ -1750,7 +1842,7 @@ declare const defaultSlots: {
     AgentConfigPanel: typeof AgentConfigPanel;
     AgentConfigSection: typeof AgentConfigSection;
     AgentRuntimeConfigFields: typeof AgentRuntimeConfigFields;
-    AgentRuntimeConfigModal: typeof AgentRuntimeConfigModal;
+    AgentRuntimeConfigDrawer: typeof AgentRuntimeConfigDrawer;
     AgentRuntimeEditorContent: typeof AgentRuntimeEditorContent;
     DraftCompositeSelector: typeof DraftCompositeSelector;
     CatalogRow: typeof CatalogRow;
@@ -1792,6 +1884,7 @@ declare const defaultSlots: {
     AgentsLibrary: typeof AgentsLibrary;
     AgentLibraryRow: typeof AgentLibraryRow;
     AgentsLibraryButton: typeof AgentsLibraryButton;
+    ApprovalNavBanner: typeof ApprovalNavBanner;
     SessionsBrowserButton: typeof SessionsBrowserButton;
     AgentDetailsPage: typeof AgentDetailsPage;
     AgentDetailsHeader: typeof AgentDetailsHeader;
@@ -1803,6 +1896,7 @@ declare const defaultSlots: {
     AgentMetricsView: typeof AgentMetricsView;
     AgentMetricsTimeRangeFilter: typeof AgentMetricsTimeRangeFilter;
     AgentMetricCard: typeof AgentMetricCard;
+    AgentMetricStatistics: typeof AgentMetricStatistics;
     AgentMetricChart: react.FunctionComponent<AgentMetricChartProps>;
     AgentSessionDetailHeader: typeof AgentSessionDetailHeader;
     AgentSessionsFilters: typeof AgentSessionsFilters;
@@ -1816,10 +1910,10 @@ declare const defaultSlots: {
     AgentSessions: react.FunctionComponent<AgentSessionsProps>;
     AgentCodeSnippets: react.FunctionComponent<AgentCodeSnippetsProps>;
     AgentCodeBlock: typeof AgentCodeBlock;
+    SchedulesPage: react.FunctionComponent<SchedulesPageProps>;
     SchedulesButton: typeof SchedulesButton;
     SaveAgentButton: typeof SaveAgentButton;
     SaveAgentForm: typeof SaveAgentForm;
-    SaveAgentFormFields: typeof SaveAgentFormFields;
     SelectAgentEmptyState: typeof SelectAgentEmptyState;
     ClearChatButton: typeof ClearChatButton;
     ThreadListRowSkeleton: typeof ThreadListRowSkeleton;
@@ -1834,6 +1928,7 @@ declare const defaultSlots: {
     Toast: typeof Toast;
     ToastStack: typeof ToastStack;
     ShellActionsActionSlot: typeof ShellActionsActionSlot;
+    UserAvatar: typeof UserAvatar;
 };
 
 type PresetTokens = {
@@ -1950,10 +2045,13 @@ type CommonPopoverSelectProps<T extends string> = {
     placeholder?: string;
     disabled?: boolean;
     className?: string;
+    menuClassName?: string;
     /** Which edge of the trigger the menu opens toward. Default `bottom`. */
     menuPlacement?: 'top' | 'bottom';
     /** When set, renders a labeled chip trigger (label | value chip + chevron). */
     prefix?: string;
+    emptyContent?: ReactNode;
+    footer?: ReactNode;
     'aria-label': string;
 };
 type PopoverSelectProps<T extends string> = CommonPopoverSelectProps<T> & ({
@@ -1967,6 +2065,37 @@ type PopoverSelectProps<T extends string> = CommonPopoverSelectProps<T> & ({
 });
 declare function PopoverSelect<T extends string>(props: PopoverSelectProps<T>): react.JSX.Element;
 
+type DropdownMenuProps = {
+    trigger: react__default.ReactNode;
+    children: react__default.ReactNode;
+    align?: 'start' | 'end';
+    side?: 'top' | 'bottom';
+    className?: string;
+    containerClassName?: string;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    closeOnClick?: boolean;
+};
+
+type ResponsiveDropdownTriggerProps = {
+    'aria-controls'?: string;
+    'aria-expanded'?: boolean;
+    'aria-haspopup'?: 'dialog' | 'menu';
+    onClick?: MouseEventHandler<HTMLElement>;
+};
+type ResponsiveDropdownMenuProps = Omit<DropdownMenuProps, 'children' | 'open' | 'onOpenChange' | 'trigger'> & {
+    trigger: ReactElement<ResponsiveDropdownTriggerProps>;
+    children: ReactNode;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    sheetLabel: string;
+    sheetClassName?: string;
+};
+/**
+ * Uses dropdown chrome normally and a container-bound bottom sheet in compact layouts.
+ */
+declare function ResponsiveDropdownMenu({ trigger, children, open: controlledOpen, onOpenChange, sheetLabel, sheetClassName, containerClassName, closeOnClick, ...dropdownProps }: ResponsiveDropdownMenuProps): react.JSX.Element;
+
 type SideDrawerAnchor = 'left' | 'right';
 type SideDrawerSize = 'sm' | 'md' | 'lg' | 'xl';
 type SideDrawerProps = {
@@ -2071,9 +2200,11 @@ type ScheduleFormFieldsProps = {
         agentId: string;
         name: string;
     }>;
+    agentOptionsLoaded?: boolean;
     agentPickerDisabled?: boolean;
+    onBuildAgent?: () => void;
 };
-declare function ScheduleFormFields({ values, onChange, agentId, onAgentIdChange, agentOptions, agentPickerDisabled, }: ScheduleFormFieldsProps): react.JSX.Element;
+declare function ScheduleFormFields({ values, onChange, agentId, onAgentIdChange, agentOptions, agentOptionsLoaded, agentPickerDisabled, onBuildAgent, }: ScheduleFormFieldsProps): react.JSX.Element;
 
 declare function ScheduleLastRunsCell({ runs }: {
     runs: readonly ScheduleRun[];
@@ -2083,8 +2214,6 @@ declare function ScheduleRunChip({ run }: {
     run: ScheduleRun;
 }): react.JSX.Element;
 
-declare function SchedulesPage(): react.JSX.Element;
-
 declare function ScheduleStatusBadge({ status }: {
     status: ScheduleStatus;
 }): react.JSX.Element;
@@ -2125,7 +2254,12 @@ interface AgentStepsContainerProps {
  */
 declare function AgentStepsContainer({ children, toolCount, thinkingCount, hasFinal, }: PropsWithChildren<AgentStepsContainerProps>): react.JSX.Element;
 
-declare function AskUserContainer(): react.JSX.Element | null;
+/** Composer banner that navigates pending tool approvals. */
+declare function ApprovalNavContainer(): react.JSX.Element | null;
+
+declare function AskUserContainer({ disabled }: {
+    disabled?: boolean;
+}): react.JSX.Element | null;
 
 declare function AssistantMessageContainer(): react.JSX.Element;
 
@@ -2141,7 +2275,9 @@ type ComposerContainerProps = {
 declare function ComposerContainer({ placeholder, }: ComposerContainerProps): react.JSX.Element;
 
 /** Host custom-action UI for a pending client-side tool response. */
-declare function CustomActionContainer(): react.JSX.Element | null;
+declare function CustomActionContainer({ disabled }: {
+    disabled?: boolean;
+}): react.JSX.Element | null;
 
 /**
  * Renders `HistoryLoader` at the top of the message list and fetches
@@ -2153,7 +2289,9 @@ declare function CustomActionContainer(): react.JSX.Element | null;
  */
 declare function HistoryLoaderContainer(): react.JSX.Element | null;
 
-declare function McpAuthContainer(): react.JSX.Element | null;
+declare function McpAuthContainer({ disabled }: {
+    disabled?: boolean;
+}): react.JSX.Element | null;
 
 declare const PostMcpOauthScreen: () => react.JSX.Element;
 
@@ -2187,8 +2325,10 @@ declare function ThreadContainer({ composer }: ThreadContainerProps): react.JSX.
 type ThreadListContainerProps = {
     /** Called after New chat or selecting a row — used by stack/drawer chrome. */
     onThreadOpen?: () => void;
+    /** `recent-history` hides navigation and lists only persisted sessions. */
+    variant?: 'default' | 'recent-history';
 };
-declare function ThreadListContainer({ onThreadOpen }?: ThreadListContainerProps): react.JSX.Element;
+declare function ThreadListContainer({ onThreadOpen, variant }?: ThreadListContainerProps): react.JSX.Element;
 
 type ToastContent = {
     title: string;
@@ -2227,6 +2367,13 @@ declare const ToolCallContainer: ToolCallMessagePartComponent;
 
 declare function ToolCallContentBlockContainer(props: ToolCallContentBlockProps): react.JSX.Element;
 
+type CurrentUser = {
+    displayName: string;
+};
+declare function useOptionalCurrentUser(): CurrentUser | undefined;
+
+type HistoryAgentIntent = 'try-agent' | 'history';
+
 type DraftPreferenceKind = 'chat' | 'agent';
 
 /** Host-facing shell configuration for agent / library / composer chrome. */
@@ -2277,6 +2424,11 @@ type SelectLibraryAgentRequest = {
     agentSpec?: AgentSpec;
 };
 type SettingsSection = 'models' | 'connectors' | 'skills' | 'sandbox';
+type HistoryAgentFilter = {
+    agentId?: string;
+    agentName: string;
+    intent: HistoryAgentIntent;
+};
 type ShellModeContextValue = {
     mode: ShellMode;
     /** Host agentConfig mode (capabilities source). */
@@ -2327,11 +2479,8 @@ type ShellModeContextValue = {
     /** Remember plain-draft composer choices as the seed for future New Chat / New Agent. */
     rememberDraftSpec: (agentSpec: AgentSpec, kind?: DraftPreferenceKind) => void;
     /**
-     * Open a history session, remounting when mutability/identity changes.
-     * Prefer explicit `isMutable` from the session row; when omitted, agentName
-     * present → immutable and agentName absent → mutable. Immutable rows may omit
-     * `agentName` when the registry agent was deleted.
-     * `isCreateAgent` is only applied when mutable (default false when omitted).
+     * Open a history session without remounting the runtime.
+     * Prefer explicit `isMutable`; otherwise agentName means immutable.
      */
     openHistorySession: (req: {
         sessionId: string;
@@ -2343,18 +2492,20 @@ type ShellModeContextValue = {
     clearChat: () => void;
     /** Return library-only mode to its idle landing; no-op in other modes. */
     openLibraryHome: () => void;
-    /** Remount key for the chat runtime when binding changes. */
+    /** Changes only when the chat runtime must reset. */
     runtimeKey: string;
     /**
      * History list filter forwarded as `listSessions({ agentId })`.
      * `null` = All chats. Only meaningful when `isLibraryEnabled`.
      */
-    historyAgentFilter: string | null;
-    setHistoryAgentFilter: (agentId: string | null) => void;
+    historyAgentFilter: HistoryAgentFilter | null;
+    setHistoryAgentFilter: (filter: HistoryAgentFilter | null) => void;
     /** Effective `listSessionsAgentId` for the runtime (SingleAgent locks to name). */
     listSessionsAgentId: string | undefined;
-    /** Session to open after a binding remount (history click across mutability). */
+    /** Session selected from history. */
     pendingSessionId: string | undefined;
+    /** Distinguishes repeated selections of the same session. */
+    pendingSessionEpoch: number;
     /**
      * Bumped when the Agents catalog may have changed (e.g. after saveAgent).
      * Library chrome should re-fetch when this changes.
@@ -2399,6 +2550,8 @@ type RoutePlace = {
     type: 'sessionsBrowser';
 } | {
     type: 'schedules';
+} | {
+    type: 'buildAgent';
 };
 /**
  * Host-facing route path customization. Only honored when `withRouter`.
@@ -2419,6 +2572,8 @@ type RoutesConfig = {
         libraryAgent?: string | false;
         /** Schedules page. `false` keeps schedules overlay-only (no URL). Default `'/schedules'`. */
         schedules?: string | false;
+        /** Agent builder. `false` disables its dedicated URL. Default `'/build-agent'`. */
+        buildAgent?: string | false;
         /** Immutable "Try" agent. `false` disables. Default `'/agents/:agentName'`. */
         agent?: string | false;
         /** Session deep link. `false` disables. Default `'/sessions/:sessionId'`. */
@@ -2446,7 +2601,7 @@ declare function useOptionalCustomActionRenderers(): CustomActionRenderers | und
 
 /**
  * Built-in backends init inside `<TrueForgeUI />`.
- * Optional `catalog` is attached onto the resolved `AgentUIServer`.
+ * Optional host ports are attached onto the resolved `AgentUIServer`.
  */
 type TrueForgeBuiltInServerConfig = {
     type: 'truefoundry';
@@ -2454,6 +2609,7 @@ type TrueForgeBuiltInServerConfig = {
     controlPlaneURL: string;
     gatewayPlaneURL?: string;
     catalog?: CatalogServer;
+    permissions?: PermissionsServer;
 } | {
     type: 'trueforge';
     /** Harness API root. Defaults to `'/'` (same-origin / proxied). */
@@ -2463,6 +2619,7 @@ type TrueForgeBuiltInServerConfig = {
     /** Custom fetch (cookie sessions, auth interceptors). */
     fetch?: typeof fetch;
     catalog?: CatalogServer;
+    permissions?: PermissionsServer;
 };
 /**
  * `server` prop for `<TrueForgeUI />`: a built-in config, or a ready
@@ -2502,6 +2659,8 @@ type TrueForgeUIProps = {
     withRouter?: boolean;
     /** URL path customization; only honored when `withRouter`. */
     routes?: RoutesConfig;
+    /** Optional identity rendered by the default `UserAvatar` slot. */
+    currentUser?: CurrentUser;
 };
 
 /**
@@ -2534,6 +2693,24 @@ declare function UserEditComposerContainer(): react.JSX.Element;
 
 declare function UserMessageContainer(): react.JSX.Element;
 
+type ApprovalNavState = {
+    count: number;
+    /** 0-based index into pending approvals. */
+    index: number;
+    canPrev: boolean;
+    canNext: boolean;
+    goPrev: () => void;
+    goNext: () => void;
+    /** Scroll to the currently selected approval (e.g. after the user scrolled away). */
+    focusCurrent: () => void;
+};
+/**
+ * Tracks the focused pending tool approval for the composer banner.
+ * Auto-focuses #1 when approvals appear; after allow/deny, stays on the same
+ * index so the next pending item fills the slot; chevrons do not wrap.
+ */
+declare function useApprovalNav(): ApprovalNavState;
+
 type ComposerBusyState = {
     /** True while submitting or while the turn stream is active. */
     isBusy: boolean;
@@ -2577,6 +2754,8 @@ type ComposerPauseView = {
     toolName: string;
 } | {
     kind: 'ask-user';
+} | {
+    kind: 'approval';
 } | {
     kind: 'compose';
 };
@@ -2597,6 +2776,17 @@ declare const useMCPAuth: ({ callbackPath }?: UseMCPAuthOptions) => {
     isOAuthLoading: boolean;
 };
 
+type UseResourcePermissionsOptions = {
+    resourceType: PermissionResourceType;
+    resourceIds: readonly string[];
+};
+type UseResourcePermissionsResult = {
+    loading: boolean;
+    error: unknown | null;
+    allows: (resourceId: string | null | undefined, permission: ResourcePermission) => boolean;
+};
+declare function useResourcePermissions({ resourceType, resourceIds, }: UseResourcePermissionsOptions): UseResourcePermissionsResult;
+
 /** Session metadata key for New Chat vs New Agent builder intent (wire/jsonb snake_case). */
 declare const IS_CREATE_AGENT_METADATA_KEY = "is_create_agent";
 /** Wire metadata values are strings (`SessionMetadataSchema`). */
@@ -2624,8 +2814,9 @@ declare function useAgentMetricsServer(): AgentMetricsServer;
 declare function useOptionalAgentMetricsServer(): AgentMetricsServer | null;
 declare function useScheduleServer(): ScheduleServer;
 declare function useOptionalScheduleServer(): ScheduleServer | null;
+declare function useOptionalPermissionsServer(): PermissionsServer | null;
 
-declare function AgentMetricChart({ graph, definition, error }: AgentMetricChartProps): react.JSX.Element;
+declare function AgentMetricChart({ graph, definition, error, colorIndex }: AgentMetricChartProps): react.JSX.Element;
 declare module '../../theme/SlotsProvider.js' {
     interface AtomSlots {
         AgentMetricChart: ComponentType<AgentMetricChartProps>;
@@ -2644,6 +2835,31 @@ interface AgentStepsSplitResult {
 }
 declare function computeAgentStepsSplit(parts: readonly AgentStepPart[], isRunning: boolean): AgentStepsSplitResult;
 
+type ApprovalRef = {
+    id?: string;
+    approved?: boolean;
+    resolution?: string;
+};
+type ToolCallPart = {
+    type: string;
+    toolCallId?: string;
+    toolName?: string;
+    approval?: ApprovalRef;
+    messages?: readonly {
+        role: string;
+        content: readonly ToolCallPart[];
+    }[];
+};
+type ThreadMessageLike = {
+    role: string;
+    content: readonly ToolCallPart[];
+};
+/**
+ * Returns `create_sub_agent` toolCallIds that must be expanded for `approvalId`
+ * to mount in the DOM. Empty when the approval is on the root thread.
+ */
+declare function findSubAgentAncestorsForApproval(messages: readonly ThreadMessageLike[], approvalId: string): string[];
+
 /**
  * User-facing error text. Prefers HTTP body `{ error: { message } }` when
  * present (e.g. TrueForgeError), then `error.message` / `error.error.message`,
@@ -2660,9 +2876,6 @@ type DraftCatalogValue = {
     connectors: ConnectorState[];
     /** Connector logo URL keyed by connector name, sourced from the discovery catalog. */
     connectorLogos: Record<string, string>;
-    connectorsHasMore: boolean;
-    connectorsLoadMoreFailed: boolean;
-    connectorsLoadingMore: boolean;
     loaded: boolean;
     loading: boolean;
     error: string | null;
@@ -2672,12 +2885,10 @@ type DraftCatalogValue = {
     refresh: () => void;
     /** Refresh connector auth state without reloading unrelated catalogs. */
     refreshConnectors: () => Promise<void>;
-    /** Append the next MCP page when `connectorsHasMore`. */
-    loadMoreConnectors: () => void;
 };
 declare function DraftCatalogProvider({ children }: {
     children: ReactNode;
 }): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null | undefined;
 declare function useDraftCatalog(): DraftCatalogValue;
 
-export { AgentCodeBlock, type AgentCodeBlockProps, type AgentCodeSnippetsProps, type AgentConfig, type AgentConfigEditor, AgentConfigEditors, type AgentConfigEditorsProps, AgentConfigPanel, type AgentConfigPanelProps, AgentConfigSection, AgentDetailsHeader, type AgentDetailsHeaderProps, AgentDetailsPage, type AgentDetailsPageProps, type AgentDetailsTab, AgentDetailsTabs, type AgentDetailsTabsProps, AgentDetailsUnavailable, type AgentDetailsUnavailableProps, AgentInstructionsDrawer, type AgentInstructionsDrawerProps, AgentMcpEditorContent, type AgentMcpEditorContentProps, AgentMetricCard, type AgentMetricCardProps, AgentMetricChart, type AgentMetricChartProps, type AgentMetricChartResult, AgentMetricsContainer, type AgentMetricsProps, AgentMetricsTimeRangeFilter, type AgentMetricsTimeRangeFilterProps, AgentMetricsView, type AgentMetricsViewProps, AgentModelConfigModal, type AgentModelConfigModalProps, AgentModelEditorContent, type AgentModelEditorContentProps, AgentModelSettingsContent, type AgentModelSettingsContentProps, AgentOverviewCard, type AgentOverviewCardProps, type AgentOverviewProps, AgentResourceConfigModal, type AgentResourceConfigModalProps, AgentResourceEditorContent, type AgentResourceEditorContentProps, AgentRuntimeConfigFields, type AgentRuntimeConfigFieldsProps, AgentRuntimeConfigModal, type AgentRuntimeConfigModalProps, AgentRuntimeEditorContent, type AgentRuntimeEditorContentProps, type AgentSessionDetailHeaderProps, type AgentSessionEventTimelineChartProps, type AgentSessionEventTimelineProps, type AgentSessionListRowProps, type AgentSessionMetricsStripProps, type AgentSessionTurnHeaderProps, AgentSessionsFilters, type AgentSessionsFiltersProps, type AgentSessionsProps, AgentSkillsEditorContent, type AgentSkillsEditorContentProps, type AgentStepPart, AgentStepsCard, type AgentStepsCardProps, AgentStepsContainer, type AgentStepsContainerProps, type AgentStepsSplitResult, AgentsLibrary, AgentsLibraryButton, type AgentsLibraryButtonProps, type AgentsLibraryProps, type AskUserAnswerDraft, type AnsweredQuestion as AskUserAnsweredQuestion, AskUserContainer, type AskUserPromptProps, type Question as AskUserQuestion, type AskUserPromptProps as AskUserQuestionCardProps, AssistantMessageBubble, type AssistantMessageBubbleProps, AssistantMessageContainer, AssistantTextContainer, type PublicAtomSlots as AtomSlots, AttachmentCard, type AttachmentCardProps, type AttachmentCardSize, AttachmentPickerButton, type AttachmentPickerButtonProps, AttachmentPreviewDialog, type AttachmentPreviewDialogProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, BottomSheet, type BottomSheetProps, type BrandChrome, type BrandConfig, type BrandImage, BrandLogo, type BrandLogoConfig, type BrandMode, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CenteredModal, type CenteredModalProps, ChatFileDownload, type ChatFileDownloadFile, type ChatFileDownloadProps, type ChatLayout, ClearChatButton, CodeEditor, type CodeEditorProps, ComposerAttachmentPickerContainer, ComposerAttachmentsContainer, ComposerBusyProvider, type ComposerBusyState, ComposerContainer, type ComposerContainerProps, ComposerLeftSection, type ComposerLeftSectionProps, type ComposerPauseView, ComposerRightSection, type ComposerRightSectionProps, ComposerSendButton, type ComposerSendButtonProps, ComposerShell, type ComposerShellProps, type ContentClassNames, CustomActionContainer, type CustomActionRendererProps, type CustomActionRenderers, CustomActionRenderersProvider, DEFAULT_AGENT_CONFIG, DEFAULT_TABLE_PAGE_SIZE, DraftAgentConfigTrigger, type DraftAgentConfigTriggerProps, DraftCapabilitiesPanel, DraftCatalogProvider, DraftComposerLeftSection, DraftComposerRightSection, DraftCompositeSelector, type DraftCompositeSelectorProps, DraftModelSelector, type DraftModelSelectorProps, type FixedVariantButtonProps, HistoryLoader, HistoryLoaderContainer, type HistoryLoaderProps, IS_CREATE_AGENT_METADATA_KEY, Icon, type IconButtonProps, type IconMap, type IconProps, type LayoutProp, MCP_AUTH_POPUP_CHANNEL, Markdown, type MarkdownProps, type McpAuthCallback, type McpAuthPromptProps as McpAuthCardProps, McpAuthContainer, type McpAuthPopupMessage, type McpAuthPromptProps, type McpServer as McpAuthServer, MessageActionBar, type MessageActionBarProps, MessageAttachmentsContainer, MessageErrorBanner, type MessageErrorBannerProps, MessageGroup, type MessageGroupProps, MessageIndicator, type MessageIndicatorProps, MessageListSkeleton, type MessageListSkeletonProps, MessageTimestamp, type MessageTimestampProps, MonacoEditorCore, type MonacoEditorCoreProps, OpenUiFenceBlock, type OpenUiFenceBlockProps, PRESETS, PopoverSelect, type PopoverSelectOption, type PopoverSelectProps, PostMcpOauthScreen, type ReasoningCardProps, ReasoningContainer, ResumeUnavailable, ResumeUnavailableContainer, type ResumeUnavailableProps, type RoutePlace, type RoutesConfig, SandboxArtifactDownload, type SandboxArtifactDownloadProps, SandboxToolCallCard, type SandboxToolCallCardProps, SaveAgentButton, type SaveAgentButtonProps, SaveAgentForm, SaveAgentFormFields, type SaveAgentFormFieldsProps, type SaveAgentFormProps, ScheduleFormDrawer, type ScheduleFormDrawerProps, ScheduleFormFields, type ScheduleFormFieldsProps, ScheduleLastRunsCell, type ScheduleMcpMount, ScheduleRunChip, ScheduleStatusBadge, SchedulesButton, type SchedulesButtonProps, SchedulesPage, ScrollToBottomButton, type ScrollToBottomButtonProps, SelectAgentEmptyState, type SelectLibraryAgentRequest, type SemanticTokens, ServerProvider, type SessionEventTimelineSegment, type SessionEventType, type SessionTurnView, SessionsBrowserButton, type SessionsBrowserButtonProps, SessionsPage, ShellActionsActionSlot, type ShellMode, ShellModeProvider, SideDrawer, type SideDrawerAnchor, type SideDrawerProps, type SideDrawerSize, type SlotOverrides, SlotsProvider, SubAgentCard, type SubAgentCardProps, Switch, type SwitchProps, type SwitchSize, SyntaxHighlighter, type SyntaxHighlighterProps, TABLE_PAGE_SIZE_OPTIONS, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, TableTokenPagination, type TableTokenPaginationProps, TestScheduleScreen, type TestScheduleScreenProps, type ThemeConfig, type IconProps$1 as ThemeIconProps, type ThemeMode, type ThemePreset, ThemeProvider, Thread, ThreadComposerAreaShell, type ThreadComposerAreaShellProps, ThreadContainer, type ThreadContainerProps, type ThreadGroupPart, ThreadListContainer, type ThreadListContainerProps, ThreadListEmptyState, type ThreadListEmptyStateProps, ThreadListNewButton, type ThreadListNewButtonProps, ThreadListRow, type ThreadListRowProps, ThreadListRowSkeleton, type ThreadListRowSkeletonProps, ThreadListShell, type ThreadListShellProps, type ThreadPauseState, ThreadRootShell, type ThreadRootShellProps, ThreadViewportShell, type ThreadViewportShellProps, Toast, type ToastProps, ToastStack, type ToastStackProps, ToasterProvider, ToolApprovalBar, type ToolApprovalBarProps, ToolApprovalContainer, type ToolApprovalOption, ToolCallCard, type ToolCallCardProps, ToolCallContainer, ToolCallContentBlock, ToolCallContentBlockContainer, type ToolCallContentBlockProps, type ToolCallStatus, ToolGroupCard, type ToolGroupCardProps, ToolGroupContainer, type TrueForgeBuiltInServerConfig, type TrueForgeServerConfig, TrueForgeUI, type TrueForgeUIProps, TrueFoundryChatProvider, type TrueFoundryChatProviderProps, USER_MESSAGE_ATTACHMENT_PREVIEW_REM, type UseMCPAuthOptions, UserEditComposerContainer, UserMessageActionBar, type UserMessageActionBarProps, UserMessageBubble, type UserMessageBubbleProps, UserMessageContainer, UserMessageEdit, type UserMessageEditProps, WelcomeScreen, type WelcomeScreenProps, computeAgentStepsSplit, defaultSlots, getErrorMessage, isCreateAgentMetadataValue, libraryAgentId, preloadMarkdownOpenUI, readSessionIsCreateAgent, resolveBrandChrome, resolvePresetTokens, sessionIsCreateAgent, shellIsCreateAgent, shellIsMutable, threadHasPendingMcpAuth, useAgentMetricsServer, useAgentSessionsServer, useBrand, useBrandName, useCatalogServer, useComposerBusyState, useComposerPauseView, useContentClassNames, useDraftCatalog, useMCPAuth, useOptionalAgentMetricsServer, useOptionalAgentSessionsServer, useOptionalCatalogServer, useOptionalContentClassNames, useOptionalCustomActionRenderers, useOptionalScheduleServer, useOptionalServer, useOptionalShellMode, useScheduleServer, useServer, useServerCapabilities, useShellMode, useSlot, useTheme, useThemeIcons, useThemeMode, useToaster, useToasterOptional };
+export { AgentCodeBlock, type AgentCodeBlockProps, type AgentCodeSnippetsProps, type AgentConfig, type AgentConfigEditor, AgentConfigEditors, type AgentConfigEditorsProps, AgentConfigPanel, type AgentConfigPanelProps, AgentConfigSection, AgentCustomParametersEditor, type AgentCustomParametersEditorProps, AgentDetailsHeader, type AgentDetailsHeaderProps, AgentDetailsPage, type AgentDetailsPageProps, type AgentDetailsTab, AgentDetailsTabs, type AgentDetailsTabsProps, AgentDetailsUnavailable, type AgentDetailsUnavailableProps, AgentInstructionsDrawer, type AgentInstructionsDrawerProps, AgentMcpEditorContent, type AgentMcpEditorContentProps, AgentMetricCard, type AgentMetricCardProps, AgentMetricChart, type AgentMetricChartProps, type AgentMetricChartResult, AgentMetricStatistics, type AgentMetricStatisticsProps, AgentMetricsContainer, type AgentMetricsProps, AgentMetricsTimeRangeFilter, type AgentMetricsTimeRangeFilterProps, AgentMetricsView, type AgentMetricsViewProps, AgentModelConfigModal, type AgentModelConfigModalProps, AgentModelEditorContent, type AgentModelEditorContentProps, AgentModelSettingsContent, type AgentModelSettingsContentProps, AgentOverviewCard, type AgentOverviewCardProps, type AgentOverviewProps, AgentResourceConfigModal, type AgentResourceConfigModalProps, AgentResourceEditorContent, type AgentResourceEditorContentProps, AgentRuntimeConfigDrawer, type AgentRuntimeConfigDrawerProps, AgentRuntimeConfigFields, type AgentRuntimeConfigFieldsProps, AgentRuntimeEditorContent, type AgentRuntimeEditorContentProps, type AgentSessionDetailHeaderProps, type AgentSessionEventTimelineChartProps, type AgentSessionEventTimelineProps, type AgentSessionListRowProps, type AgentSessionMetricsStripProps, type AgentSessionTurnHeaderProps, AgentSessionsFilters, type AgentSessionsFiltersProps, type AgentSessionsProps, AgentSkillsEditorContent, type AgentSkillsEditorContentProps, type AgentStepPart, AgentStepsCard, type AgentStepsCardProps, AgentStepsContainer, type AgentStepsContainerProps, type AgentStepsSplitResult, AgentsLibrary, AgentsLibraryButton, type AgentsLibraryButtonProps, type AgentsLibraryProps, ApprovalNavBanner, type ApprovalNavBannerProps, ApprovalNavContainer, type ApprovalNavState, type AskUserAnswerDraft, type AnsweredQuestion as AskUserAnsweredQuestion, AskUserContainer, type AskUserPromptProps, type Question as AskUserQuestion, type AskUserPromptProps as AskUserQuestionCardProps, AssistantMessageBubble, type AssistantMessageBubbleProps, AssistantMessageContainer, AssistantTextContainer, type PublicAtomSlots as AtomSlots, AttachmentCard, type AttachmentCardProps, type AttachmentCardSize, AttachmentPickerButton, type AttachmentPickerButtonProps, AttachmentPreviewDialog, type AttachmentPreviewDialogProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, BottomSheet, type BottomSheetProps, type BrandChrome, type BrandConfig, type BrandImage, BrandLogo, type BrandLogoConfig, type BrandMode, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CenteredModal, type CenteredModalProps, ChatFileDownload, type ChatFileDownloadFile, type ChatFileDownloadProps, type ChatLayout, ClearChatButton, CodeEditor, type CodeEditorProps, ComposerAttachmentPickerContainer, ComposerAttachmentsContainer, ComposerBusyProvider, type ComposerBusyState, ComposerContainer, type ComposerContainerProps, ComposerLeftSection, type ComposerLeftSectionProps, type ComposerPauseView, ComposerRightSection, type ComposerRightSectionProps, ComposerSendButton, type ComposerSendButtonProps, ComposerShell, type ComposerShellProps, type ContentClassNames, type CurrentUser, CustomActionContainer, type CustomActionRendererProps, type CustomActionRenderers, CustomActionRenderersProvider, DEFAULT_AGENT_CONFIG, DEFAULT_TABLE_PAGE_SIZE, DraftAgentConfigTrigger, type DraftAgentConfigTriggerProps, DraftCapabilitiesPanel, DraftCatalogProvider, type DraftComposerAction, DraftComposerActionsMenu, type DraftComposerActionsMenuProps, DraftComposerLeftSection, DraftComposerRightSection, DraftCompositeSelector, type DraftCompositeSelectorProps, DraftModelSelector, type DraftModelSelectorProps, type FixedVariantButtonProps, HistoryLoader, HistoryLoaderContainer, type HistoryLoaderProps, IS_CREATE_AGENT_METADATA_KEY, Icon, type IconButtonProps, type IconMap, type IconProps, type LayoutProp, MCP_AUTH_POPUP_CHANNEL, Markdown, type MarkdownProps, type McpAuthCallback, type McpAuthPromptProps as McpAuthCardProps, McpAuthContainer, type McpAuthPopupMessage, type McpAuthPromptProps, type McpServer as McpAuthServer, MessageActionBar, type MessageActionBarProps, MessageAttachmentsContainer, MessageErrorBanner, type MessageErrorBannerProps, MessageGroup, type MessageGroupProps, MessageIndicator, type MessageIndicatorProps, MessageListSkeleton, type MessageListSkeletonProps, MessageTimestamp, type MessageTimestampProps, MonacoEditorCore, type MonacoEditorCoreProps, OpenUiFenceBlock, type OpenUiFenceBlockProps, PRESETS, PermissionGuard, type PermissionGuardProps, PopoverSelect, type PopoverSelectOption, type PopoverSelectProps, PostMcpOauthScreen, type ReasoningCardProps, ReasoningContainer, ResponsiveDropdownMenu, type ResponsiveDropdownMenuProps, ResumeUnavailable, ResumeUnavailableContainer, type ResumeUnavailableProps, type RoutePlace, type RoutesConfig, SandboxArtifactDownload, type SandboxArtifactDownloadProps, SandboxToolCallCard, type SandboxToolCallCardProps, SaveAgentButton, type SaveAgentButtonProps, SaveAgentForm, type SaveAgentFormProps, ScheduleFormDrawer, type ScheduleFormDrawerProps, ScheduleFormFields, type ScheduleFormFieldsProps, ScheduleLastRunsCell, type ScheduleMcpMount, ScheduleRunChip, ScheduleStatusBadge, SchedulesButton, type SchedulesButtonProps, SchedulesPage, type SchedulesPageProps, ScrollToBottomButton, type ScrollToBottomButtonProps, SelectAgentEmptyState, type SelectLibraryAgentRequest, type SemanticTokens, ServerProvider, type SessionEventTimelineSegment, type SessionEventType, type SessionTurnView, SessionsBrowserButton, type SessionsBrowserButtonProps, SessionsPage, ShellActionsActionSlot, type ShellMode, ShellModeProvider, SideDrawer, type SideDrawerAnchor, type SideDrawerProps, type SideDrawerSize, type SlotOverrides, SlotsProvider, SubAgentCard, type SubAgentCardProps, Switch, type SwitchProps, type SwitchSize, SyntaxHighlighter, type SyntaxHighlighterProps, TABLE_PAGE_SIZE_OPTIONS, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, TableTokenPagination, type TableTokenPaginationProps, TestScheduleScreen, type TestScheduleScreenProps, type ThemeConfig, type IconProps$1 as ThemeIconProps, type ThemeMode, type ThemePreset, ThemeProvider, Thread, ThreadComposerAreaShell, type ThreadComposerAreaShellProps, ThreadContainer, type ThreadContainerProps, type ThreadGroupPart, ThreadListContainer, type ThreadListContainerProps, ThreadListEmptyState, type ThreadListEmptyStateProps, ThreadListNewButton, type ThreadListNewButtonProps, ThreadListRow, type ThreadListRowProps, ThreadListRowSkeleton, type ThreadListRowSkeletonProps, ThreadListShell, type ThreadListShellProps, type ThreadPauseState, ThreadRootShell, type ThreadRootShellProps, ThreadViewportShell, type ThreadViewportShellProps, Toast, type ToastProps, ToastStack, type ToastStackProps, ToasterProvider, ToolApprovalBar, type ToolApprovalBarProps, ToolApprovalContainer, type ToolApprovalOption, ToolCallCard, type ToolCallCardProps, ToolCallContainer, ToolCallContentBlock, ToolCallContentBlockContainer, type ToolCallContentBlockProps, type ToolCallStatus, ToolGroupCard, type ToolGroupCardProps, ToolGroupContainer, type TrueForgeBuiltInServerConfig, type TrueForgeServerConfig, TrueForgeUI, type TrueForgeUIProps, TrueFoundryChatProvider, type TrueFoundryChatProviderProps, USER_MESSAGE_ATTACHMENT_PREVIEW_REM, type UseMCPAuthOptions, type UseResourcePermissionsOptions, type UseResourcePermissionsResult, UserAvatar, type UserAvatarProps, UserEditComposerContainer, UserMessageActionBar, type UserMessageActionBarProps, UserMessageBubble, type UserMessageBubbleProps, UserMessageContainer, UserMessageEdit, type UserMessageEditProps, WelcomeScreen, type WelcomeScreenProps, computeAgentStepsSplit, defaultSlots, findSubAgentAncestorsForApproval, getErrorMessage, isCreateAgentMetadataValue, libraryAgentId, preloadMarkdownOpenUI, readSessionIsCreateAgent, resolveBrandChrome, resolvePresetTokens, sessionIsCreateAgent, shellIsCreateAgent, shellIsMutable, threadHasPendingMcpAuth, useAgentMetricsServer, useAgentSessionsServer, useApprovalNav, useBrand, useBrandName, useCatalogServer, useComposerBusyState, useComposerPauseView, useContentClassNames, useDraftCatalog, useMCPAuth, useOptionalAgentMetricsServer, useOptionalAgentSessionsServer, useOptionalCatalogServer, useOptionalContentClassNames, useOptionalCurrentUser, useOptionalCustomActionRenderers, useOptionalPermissionsServer, useOptionalScheduleServer, useOptionalServer, useOptionalShellMode, useResourcePermissions, useScheduleServer, useServer, useServerCapabilities, useShellMode, useSlot, useTheme, useThemeIcons, useThemeMode, useToaster, useToasterOptional };