@pstdio/ui 0.40.0 → 0.42.0

package/dist/chat-ui.d.ts

@@ -1,5 +1,5 @@
-import { n as ResourceBadgeProps, r as ScrollArea$1 } from "./resource-badge-95WPVlZf.js";
-import { T as ReferenceItem } from "./index-Bfddrlz8.js";
+import { n as ResourceBadgeProps, r as ScrollArea$1 } from "./resource-badge-nOWPqxFU.js";
+import { d as ChatLinkCandidate, f as ChatLinkHandler, j as PromptCommand, k as PromptSelectionSnapshot, m as parseChatLink, p as ChatLinkProps } from "./index-B79hwNcB.js";
 import { HTMLChakraProps, IconButtonProps, RecipeVariantProps } from "@chakra-ui/react";
 import { StickToBottom } from "use-stick-to-bottom";
 import { ReactNode } from "react";
@@ -10,19 +10,23 @@ type ConversationScrollButtonProps = IconButtonProps;
 export declare const ChatPrimitives: {
   readonly Root: import("@chakra-ui/react").ChakraComponent<import("react").ElementType, {
     resize?: import("use-stick-to-bottom").Animation | undefined;
+    is?: string | undefined | undefined;
     onChange?: import("react").ChangeEventHandler<HTMLDivElement, Element> | undefined;
     onError?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
     onSubmit?: import("react").SubmitEventHandler<HTMLDivElement> | undefined;
-    content?: string | undefined | undefined;
+    resource?: string | undefined | undefined;
+    id?: string | undefined | undefined;
+    children: ((context: import("use-stick-to-bottom").StickToBottomContext) => import("react").ReactNode) | import("react").ReactNode;
+    slot?: string | undefined | undefined;
+    style?: import("react").CSSProperties | undefined;
+    title?: string | undefined | undefined;
     color?: string | undefined | undefined;
+    content?: string | undefined | undefined;
     translate?: "yes" | "no" | undefined | undefined;
     initial?: (import("use-stick-to-bottom").Animation | boolean) | undefined;
     hidden?: boolean | undefined | undefined;
-    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
-    radioGroup?: string | undefined | undefined;
-    slot?: string | undefined | undefined;
-    style?: import("react").CSSProperties | undefined;
-    title?: string | undefined | undefined;
+    "aria-roledescription"?: string | undefined | undefined;
+    role?: import("react").AriaRole | undefined;
     defaultChecked?: boolean | undefined | undefined;
     defaultValue?: string | number | readonly string[] | undefined;
     suppressContentEditableWarning?: boolean | undefined | undefined;
@@ -36,19 +40,17 @@ export declare const ChatPrimitives: {
     dir?: string | undefined | undefined;
     draggable?: (boolean | "true" | "false") | undefined;
     enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
-    id?: string | undefined | undefined;
     lang?: string | undefined | undefined;
     nonce?: string | undefined | undefined;
     spellCheck?: (boolean | "true" | "false") | undefined;
     tabIndex?: number | undefined | undefined;
-    role?: import("react").AriaRole | undefined;
+    radioGroup?: string | undefined | undefined;
     about?: string | undefined | undefined;
     datatype?: string | undefined | undefined;
     inlist?: any;
     prefix?: string | undefined | undefined;
     property?: string | undefined | undefined;
     rel?: string | undefined | undefined;
-    resource?: string | undefined | undefined;
     rev?: string | undefined | undefined;
     typeof?: string | undefined | undefined;
     vocab?: string | undefined | undefined;
@@ -62,11 +64,11 @@ export declare const ChatPrimitives: {
     results?: number | undefined | undefined;
     security?: string | undefined | undefined;
     unselectable?: "on" | "off" | undefined | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
     popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
     popoverTarget?: string | undefined | undefined;
     inert?: boolean | undefined | undefined;
     inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
-    is?: string | undefined | undefined;
     exportparts?: string | undefined | undefined;
     part?: string | undefined | undefined;
     "aria-activedescendant"?: string | undefined | undefined;
@@ -110,7 +112,6 @@ export declare const ChatPrimitives: {
     "aria-readonly"?: (boolean | "true" | "false") | undefined;
     "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
     "aria-required"?: (boolean | "true" | "false") | undefined;
-    "aria-roledescription"?: string | undefined | undefined;
     "aria-rowcount"?: number | undefined | undefined;
     "aria-rowindex"?: number | undefined | undefined;
     "aria-rowindextext"?: string | undefined | undefined;
@@ -122,7 +123,6 @@ export declare const ChatPrimitives: {
     "aria-valuemin"?: number | undefined | undefined;
     "aria-valuenow"?: number | undefined | undefined;
     "aria-valuetext"?: string | undefined | undefined;
-    children: ((context: import("use-stick-to-bottom").StickToBottomContext) => import("react").ReactNode) | import("react").ReactNode;
     dangerouslySetInnerHTML?: {
       __html: string | TrustedHTML;
     } | undefined | undefined;
@@ -451,13 +451,37 @@ interface ChatInputQuestion {
 }
 interface ChatInputQuestionPrompt {
   questions: ChatInputQuestion[];
+  callId?: string;
+  /** Async requests open from their chat bubble and preselect their first offered options. */
+  delivery?: "async";
 }
 interface ChatInputQuestionResponse {
   answers: string[][];
+  callId?: string;
+}
+//#endregion
+//#region src/components/chat-ui/components/composer-decision.d.ts
+/** A native decision occupies the composer without submitting the saved draft. */
+interface ComposerDecision {
+  id: string;
+  controls?: ReactNode;
+  model?: string;
+  pending?: boolean;
+  actions: {
+    id: string;
+    label: string;
+    variant: "primary" | "subtle" | "ghost";
+    disabled?: boolean;
+  }[];
+  onAction: (actionId: string) => void | Promise<void>;
 }
 //#endregion
 //#region src/components/chat-ui/components/chat-input.d.ts
 interface ChatInputProps {
+  /**
+   * Serialized editor state for the text to show. The editor adopts it whenever its text differs
+   * from what the editor shows, so a host can pass its live draft. It is never echoed to `onChange`.
+   */
   defaultState: string;
   /** Plain-text prompts from the active conversation, newest first. */
   recentUserMessages?: string[];
@@ -476,15 +500,24 @@ interface ChatInputProps {
   onChange?: (text: string) => void;
   attachmentList?: ReactNode;
   actions?: ReactNode;
+  /** Secondary actions immediately before the submit button. */
+  submitActions?: ReactNode;
+  /** Attachment controls shown only while editing a message draft. */
+  attachmentActions?: ReactNode;
   attachedToTop?: boolean;
   /** Recede the resting border to border.subtle when nested inside a stronger shell (the workspace hub). */
   recessed?: boolean;
   questionPrompt?: ChatInputQuestionPrompt;
+  decision?: ComposerDecision;
   autoFocus?: boolean;
   focusSignal?: number;
   submitTitle?: string;
-  references?: ReferenceItem[];
-  onAddReference?: (resourceId: string, resourceType: ReferenceItem["resourceType"]) => void;
+  submitLabel?: string;
+  initialSelection?: PromptSelectionSnapshot;
+  onSelectionChange?: (selection: PromptSelectionSnapshot) => void;
+  onEditorStateChange?: (text: string, state: string) => void;
+  retainTextUntilAcknowledged?: boolean;
+  commands?: PromptCommand[];
 }
 export declare const ChatInput: (props: ChatInputProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
@@ -581,11 +614,20 @@ type SessionMessage = {
   };
 };
 type QueuedFollowUp = {
+  revision?: string;
+  model?: string | null;
+  params?: Record<string, string | boolean>;
+  steeringUnavailableReason?: string | null;
+  steeringDelivery?: {
+    id: string;
+    runStartedAt: string;
+  } | null;
   id: string;
   prompt: string;
   attachments?: Array<{
     id: string;
     name: string;
+    size?: number;
     mediaType?: string;
     url?: string;
   }>;
@@ -597,7 +639,7 @@ type QueuedFollowUpMoveDirection = "up" | "down";
 //#endregion
 //#region src/components/chat-ui/components/chat-panel.d.ts
 /** Full conversation shell for agent sessions, including messages, input, attachments, and host-provided slots. */
-interface ChatPanelProps {
+interface ChatPanelProps extends ChatLinkProps {
   /** Stable conversation identity used to reset ready state when switching sessions. */
   conversationKey?: string;
   messages: SessionMessage[];
@@ -616,8 +658,11 @@ interface ChatPanelProps {
   onAttachFiles?: (files: File[]) => void;
   onAttachText?: (text: string) => void;
   onChatInputChange?: (text: string) => void;
-  /** Extra controls rendered in the chat input toolbar (attach, model, params). */
+  /** Controls shared by the message and question toolbars (model, params). */
   actions?: ReactNode;
+  /** Attachment controls shown only while editing a message draft. */
+  attachmentActions?: ReactNode;
+  composerHeader?: ReactNode;
   attachedResources?: string[];
   onClearAttachments?: () => void;
   attachmentList?: ReactNode;
@@ -631,13 +676,28 @@ interface ChatPanelProps {
   /** Blocks sending while the editor stays usable, for example while no model is selected. */
   submitDisabled?: boolean;
   chatInputQuestionPrompt?: ChatInputQuestionPrompt;
+  composerDecision?: ComposerDecision;
   chatInputAutoFocus?: boolean;
   queuedFollowUps?: QueuedFollowUp[];
-  onQueuedFollowUpUpdate?: (itemId: string, prompt: string) => void;
+  onQueuedFollowUpUpdate?: (itemId: string, prompt: string) => void | Promise<void>;
+  /** Submit the retained edit's settings and files as a new request. */
+  onQueuedFollowUpCreate?: (itemId: string, prompt: string) => void | Promise<void>;
+  /** Move the retained edit's settings and files into the normal draft before its text changes. */
+  onQueuedFollowUpRestoreDraft?: (itemId: string) => void;
+  /** Allow recovery only when the normal draft has no files or uploads and the host can transfer the edit. */
+  canRestoreQueuedEditToDraft?: boolean;
+  onQueuedFollowUpSelect?: (item: QueuedFollowUp | null) => void;
+  onQueuedFollowUpDiscard?: (itemId: string) => void;
+  onQueuedFollowUpSteer?: (item: QueuedFollowUp) => void | Promise<void>;
+  onQueuedFollowUpCombine?: (source: QueuedFollowUp, target: QueuedFollowUp) => void | Promise<void>;
+  queueSteeringUnavailableReason?: string | null;
+  unsavedQueueItemIds?: string[];
   onQueuedFollowUpRemove?: (itemId: string) => void;
-  onQueuedFollowUpMove?: (itemId: string, direction: QueuedFollowUpMoveDirection, steps?: number) => void;
-  chatInputReferences?: ReferenceItem[];
-  onChatInputAddReference?: (resourceId: string, resourceType: ReferenceItem["resourceType"]) => void;
+  onQueuedFollowUpMove?: (itemId: string, direction: QueuedFollowUpMoveDirection, steps?: number, selection?: {
+    source: QueuedFollowUp;
+    items: QueuedFollowUp[];
+  }) => void;
+  chatInputCommands?: PromptCommand[];
 }
 export declare const ChatPanel: (props: ChatPanelProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
@@ -667,6 +727,52 @@ interface ConversationBrowseProps {
  */
 export declare const ConversationBrowse: (props: ConversationBrowseProps) => import("react/jsx-runtime").JSX.Element | null;
 //#endregion
+//#region src/components/chat-ui/components/harness-controls.d.ts
+interface HarnessAction {
+  id: string;
+  label: string;
+  icon?: string;
+  argument?: {
+    label: string;
+    value?: string;
+  };
+}
+interface HarnessMode {
+  id: string;
+  label: string;
+  description: string;
+  state: string;
+  indicator?: {
+    label: string;
+    tone: "neutral" | "info" | "success" | "warning" | "error";
+  };
+  tagText?: string;
+  closeActionId?: string;
+  confirmation?: {
+    id: string;
+    title: string;
+    actionId: string;
+    cancelLabel?: string;
+  };
+  actions: HarnessAction[];
+}
+interface LocalTag {
+  label: string;
+  description: string;
+  onClose: () => void;
+  closeLabel?: string;
+}
+interface HarnessControlsProps {
+  modes: HarnessMode[];
+  draftTag?: LocalTag;
+  sentTag?: LocalTag;
+  pending?: boolean;
+  unavailable?: boolean;
+  onRequestConfirmation?: (modeId: string) => void;
+  onAction: (modeId: string, actionId: string, argument?: string, modeSnapshot?: HarnessMode) => Promise<void>;
+}
+export declare const HarnessControls: (props: HarnessControlsProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
 //#region src/components/chat-ui/components/send-button.d.ts
 interface SendButtonProps extends IconButtonProps {
   shortcut?: string;
@@ -697,5 +803,5 @@ export declare const ChatWorkspaceHub: (props: ChatWorkspaceHubProps) => import(
 //#region src/components/chat-ui/utils/editor-state.d.ts
 export declare const createSerializedPromptState: (input?: string) => string;
 //#endregion
-export type { AlertPart, AutoScrollProps, ChatInputProps, ChatInputQuestionPrompt, ChatInputQuestionResponse, ChatMessagePart, ConversationBrowseItem, ConversationContentProps, ConversationRootProps, ConversationScrollButtonProps, MessageContentProps, MessageRootProps, QueuedFollowUp, QueuedFollowUpMoveDirection, SendButtonProps, SessionMessage, SessionMessagePart, ToolPart };
+export { type AlertPart, type AutoScrollProps, type ChatInputProps, type ChatInputQuestionPrompt, type ChatInputQuestionResponse, type ChatLinkCandidate, type ChatLinkHandler, type ChatLinkProps, type ChatMessagePart, type ComposerDecision, type ConversationBrowseItem, type ConversationContentProps, type ConversationRootProps, type ConversationScrollButtonProps, type HarnessControlsProps, type MessageContentProps, type MessageRootProps, type QueuedFollowUp, type QueuedFollowUpMoveDirection, type SendButtonProps, type SessionMessage, type SessionMessagePart, type ToolPart, parseChatLink };
 export {};