@truefoundry/agent-ui-sdk 0.0.3 → 0.0.5

package/README.md

@@ -150,7 +150,7 @@ import {
 
 const client = new AgentSessionClient({
   apiKey: process.env.TFY_API_KEY!,
-  environment: process.env.TFY_GATEWAY_URL!, // https://gateway.truefoundry.ai/<tenant>
+  baseUrl: process.env.TFY_GATEWAY_URL!, // https://gateway.truefoundry.ai/<tenant>
 });
 
 export function App() {
@@ -179,6 +179,40 @@ export function App() {
 }
 ```
 
+### Draft mode and sandbox downloads
+
+Named-agent mode only needs `AgentSessionClient`. Draft mode and sandbox file
+downloads also need a `PrivateAgentSessionClient`:
+
+```tsx
+import { PrivateAgentSessionClient } from "truefoundry-gateway-sdk/agents/private";
+
+const privateClient = new PrivateAgentSessionClient({
+  apiKey: process.env.TFY_API_KEY!,
+  baseUrl: process.env.TFY_GATEWAY_URL!,
+});
+
+const runtime = useTrueFoundryAgentRuntime({
+  client,
+  privateClient,
+  agent: {
+    mode: "draft",
+    defaultAgentSpec: { model: { name: "anthropic/claude-sonnet-4-6" } },
+  },
+  adapters: { attachments: trueFoundryAttachmentAdapter },
+});
+```
+
+### Cross-agent History (owned sessions)
+
+`<ThreadListContainer />` lists whatever thread-list adapter the runtime
+installed — typically one named agent or the caller's drafts. For a History
+sidebar of **every** session the user owns (named + draft), use
+`createTrueFoundryOwnedSessionsThreadListAdapter({ privateClient })` or call
+`privateClient.listOwnedSessions()` directly and render your own list. That
+adapter is read-only (`initialize` throws); keep a separate named/draft
+runtime for creating and sending turns.
+
 That's the whole integration. Three things to know:
 
 - `**<Thread />**` is the fully-assembled message list + composer. It handles

package/dist/index.d.ts

@@ -16,9 +16,10 @@ import Dialog from 'tfy-web-components/components/molecules/Dialog';
 export { default as Dialog } from 'tfy-web-components/components/molecules/Dialog';
 export { IconProp, default as IconProvider, registerIcons, registerImgIcons } from 'tfy-web-components/components/atoms/IconProvider';
 import { UserMessageEditProps as UserMessageEditProps$1 } from 'tfy-web-components/components/molecules/agent-chat/UserMessageEdit';
-import { ToolCallCardProps as ToolCallCardProps$1, ToolCallContentBlockProps as ToolCallContentBlockProps$1, ToolApprovalBlockProps, ReasoningCardProps, AskUserQuestionCardProps, McpAuthCardProps } from 'tfy-web-components/components/molecules/agent-chat';
-export { AskUserAnswerDraft, AnsweredQuestion as AskUserAnsweredQuestion, Question as AskUserQuestion, McpServer as McpAuthServer, ReasoningCardProps } from 'tfy-web-components/components/molecules/agent-chat';
+import { ToolCallCardProps as ToolCallCardProps$1, ToolCallContentBlockProps as ToolCallContentBlockProps$1, ToolApprovalBlockProps, AgentStepsCardProps, ReasoningCardProps, AskUserQuestionCardProps, McpAuthCardProps } from 'tfy-web-components/components/molecules/agent-chat';
+export { AgentStepsCardProps, AskUserAnswerDraft, AnsweredQuestion as AskUserAnsweredQuestion, Question as AskUserQuestion, McpServer as McpAuthServer, ReasoningCardProps } from 'tfy-web-components/components/molecules/agent-chat';
 import { ToolCallMessagePartComponent, MessagePrimitive } from '@assistant-ui/react';
+import { PartState } from '@assistant-ui/core/react';
 
 type ComposerLeftSectionProps = {
     disabled: boolean;
@@ -273,6 +274,22 @@ declare module "../theme/SlotsProvider.js" {
     }
 }
 
+type HistoryLoaderProps = ComponentPropsWithRef<"div"> & {
+    /** True while an older-history page is being fetched. */
+    isLoading?: boolean;
+};
+/**
+ * Inline status row shown at the top of the message list when older history
+ * pages are available. Doubles as the scroll sentinel observed by
+ * `HistoryLoaderContainer`.
+ */
+declare const HistoryLoader: react.ForwardRefExoticComponent<Omit<HistoryLoaderProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+declare module "../theme/SlotsProvider.js" {
+    interface AtomSlots {
+        HistoryLoader: typeof HistoryLoader;
+    }
+}
+
 type ThreadRootShellProps = ComponentPropsWithRef<"div">;
 declare const ThreadRootShell: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 type ThreadViewportShellProps = ComponentPropsWithRef<"div"> & {
@@ -382,6 +399,14 @@ declare module "../theme/SlotsProvider.js" {
     }
 }
 
+/** Typed SDK slot adapter over tfy-web-components AgentStepsCard. */
+declare function AgentStepsCard(props: AgentStepsCardProps): react.JSX.Element;
+declare module "../../theme/SlotsProvider.js" {
+    interface AtomSlots {
+        AgentStepsCard: typeof AgentStepsCard;
+    }
+}
+
 /** Typed SDK slot adapter over tfy-web-components ReasoningCard. */
 declare function ReasoningCard(props: ReasoningCardProps): react.JSX.Element;
 declare module "../../theme/SlotsProvider.js" {
@@ -545,6 +570,16 @@ type ThreadContainerProps = {
 };
 declare function ThreadContainer({ composer }: ThreadContainerProps): react.JSX.Element;
 
+/**
+ * Renders the `HistoryLoader` slot at the top of the message list and fetches
+ * the next older history page when the user scrolls near it. Scroll position
+ * is preserved across the prepend so the list doesn't jump.
+ *
+ * Must be rendered inside `ThreadViewportShell` (it locates the scroll root
+ * via the `aui_thread-viewport` data-slot on its nearest scrollable ancestor).
+ */
+declare function HistoryLoaderContainer(): react.JSX.Element | null;
+
 declare function AssistantMessageContainer(): react.JSX.Element;
 
 declare function UserMessageContainer(): react.JSX.Element;
@@ -579,6 +614,18 @@ declare function ToolGroupContainer({ children, group, }: PropsWithChildren<{
     group: ThreadGroupPart;
 }>): react.JSX.Element;
 
+interface AgentStepsContainerProps {
+    toolCount: number;
+    thinkingCount: number;
+    hasFinal: boolean;
+    active: boolean;
+}
+/**
+ * Container for "Agent steps" section — groups reasoning, intermediate text, and tools
+ * in a collapsible accordion that auto-collapses once final answer is confirmed.
+ */
+declare function AgentStepsContainer({ children, toolCount, thinkingCount, hasFinal, active, }: PropsWithChildren<AgentStepsContainerProps>): react.JSX.Element;
+
 declare function ReasoningContainer({ group }: {
     group: ThreadGroupPart;
 }): react.JSX.Element;
@@ -663,4 +710,12 @@ declare function useErrorToasterOptional(): ErrorToasterContextValue | null;
 /** The full assembled thread view: message list + composer. */
 declare function Thread(): react.JSX.Element;
 
-export { AskUserContainer, type AskUserPromptProps, type AskUserPromptProps as AskUserQuestionCardProps, AssistantMessageBubble, type AssistantMessageBubbleProps, AssistantMessageContainer, AssistantTextContainer, type AtomSlots, AttachmentCard, type AttachmentCardProps, type AttachmentCardSize, AttachmentPickerButton, type AttachmentPickerButtonProps, AttachmentPreviewDialog, type AttachmentPreviewDialogProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, type ColorToken, ComposerAttachmentPickerContainer, ComposerAttachmentsContainer, ComposerBusyProvider, type ComposerBusyState, ComposerContainer, type ComposerContainerProps, ComposerLeftSection, type ComposerLeftSectionProps, type ComposerPauseView, ComposerRightSection, type ComposerRightSectionProps, ComposerSendButton, type ComposerSendButtonProps, ComposerShell, type ComposerShellProps, type DesignTokens, ErrorToasterProvider, Markdown, type MarkdownProps, type McpAuthPromptProps as McpAuthCardProps, McpAuthContainer, type McpAuthPromptProps, MessageActionBar, type MessageActionBarProps, MessageAttachmentsContainer, MessageErrorBanner, type MessageErrorBannerProps, MessageGroup, type MessageGroupProps, MessageIndicator, type MessageIndicatorProps, MessageListSkeleton, type MessageListSkeletonProps, MessageTimestamp, type MessageTimestampProps, type RadiusToken, ReasoningContainer, SandboxToolCallCard, type SandboxToolCallCardProps, ScrollToBottomButton, type ScrollToBottomButtonProps, type SlotOverrides, SlotsProvider, type SpacingToken, SubAgentCard, type SubAgentCardProps, type ThemeMode, Thread, ThreadComposerAreaShell, type ThreadComposerAreaShellProps, ThreadContainer, type ThreadContainerProps, type ThreadGroupPart, ThreadListContainer, 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, TokensProvider, ToolApprovalBar, type ToolApprovalBarProps, ToolApprovalContainer, type ToolApprovalOption, ToolCallCard, type ToolCallCardProps, ToolCallContainer, ToolCallContentBlock, ToolCallContentBlockContainer, type ToolCallContentBlockProps, type ToolCallStatus, ToolGroupCard, type ToolGroupCardProps, ToolGroupContainer, type TypeRoleToken, type TypeRoleValue, USER_MESSAGE_ATTACHMENT_PREVIEW_REM, UserEditComposerContainer, UserMessageActionBar, type UserMessageActionBarProps, UserMessageBubble, type UserMessageBubbleProps, UserMessageContainer, UserMessageEdit, type UserMessageEditProps, WelcomeScreen, type WelcomeScreenProps, defaultSlots, defaultTokens, threadHasPendingMcpAuth, useComposerBusyState, useComposerPauseView, useErrorToaster, useErrorToasterOptional, useSlot, useThemeMode, useTokens };
+interface AgentStepsSplitResult {
+    cutIndex: number;
+    hasFinal: boolean;
+    toolCount: number;
+    thinkingCount: number;
+}
+declare function computeAgentStepsSplit(parts: readonly PartState[], isRunning: boolean): AgentStepsSplitResult;
+
+export { AgentStepsCard, AgentStepsContainer, type AgentStepsContainerProps, type AgentStepsSplitResult, AskUserContainer, type AskUserPromptProps, type AskUserPromptProps as AskUserQuestionCardProps, AssistantMessageBubble, type AssistantMessageBubbleProps, AssistantMessageContainer, AssistantTextContainer, type AtomSlots, AttachmentCard, type AttachmentCardProps, type AttachmentCardSize, AttachmentPickerButton, type AttachmentPickerButtonProps, AttachmentPreviewDialog, type AttachmentPreviewDialogProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, type ColorToken, ComposerAttachmentPickerContainer, ComposerAttachmentsContainer, ComposerBusyProvider, type ComposerBusyState, ComposerContainer, type ComposerContainerProps, ComposerLeftSection, type ComposerLeftSectionProps, type ComposerPauseView, ComposerRightSection, type ComposerRightSectionProps, ComposerSendButton, type ComposerSendButtonProps, ComposerShell, type ComposerShellProps, type DesignTokens, ErrorToasterProvider, HistoryLoader, HistoryLoaderContainer, type HistoryLoaderProps, Markdown, type MarkdownProps, type McpAuthPromptProps as McpAuthCardProps, McpAuthContainer, type McpAuthPromptProps, MessageActionBar, type MessageActionBarProps, MessageAttachmentsContainer, MessageErrorBanner, type MessageErrorBannerProps, MessageGroup, type MessageGroupProps, MessageIndicator, type MessageIndicatorProps, MessageListSkeleton, type MessageListSkeletonProps, MessageTimestamp, type MessageTimestampProps, type RadiusToken, ReasoningContainer, SandboxToolCallCard, type SandboxToolCallCardProps, ScrollToBottomButton, type ScrollToBottomButtonProps, type SlotOverrides, SlotsProvider, type SpacingToken, SubAgentCard, type SubAgentCardProps, type ThemeMode, Thread, ThreadComposerAreaShell, type ThreadComposerAreaShellProps, ThreadContainer, type ThreadContainerProps, type ThreadGroupPart, ThreadListContainer, 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, TokensProvider, ToolApprovalBar, type ToolApprovalBarProps, ToolApprovalContainer, type ToolApprovalOption, ToolCallCard, type ToolCallCardProps, ToolCallContainer, ToolCallContentBlock, ToolCallContentBlockContainer, type ToolCallContentBlockProps, type ToolCallStatus, ToolGroupCard, type ToolGroupCardProps, ToolGroupContainer, type TypeRoleToken, type TypeRoleValue, USER_MESSAGE_ATTACHMENT_PREVIEW_REM, UserEditComposerContainer, UserMessageActionBar, type UserMessageActionBarProps, UserMessageBubble, type UserMessageBubbleProps, UserMessageContainer, UserMessageEdit, type UserMessageEditProps, WelcomeScreen, type WelcomeScreenProps, computeAgentStepsSplit, defaultSlots, defaultTokens, threadHasPendingMcpAuth, useComposerBusyState, useComposerPauseView, useErrorToaster, useErrorToasterOptional, useSlot, useThemeMode, useTokens };