@mcp-b/react-components 0.42.0 → 0.44.0

package/dist/components/agents-sdk/ThinkSidepanel.d.ts

@@ -0,0 +1,173 @@
+import { ThinkChatDraft } from "./ThinkChat.js";
+import { ThinkThreadItem } from "./ThinkThreadPicker.js";
+import { ThinkFullAppAgent, ThinkFullAppConversation, ThinkFullAppProps } from "./ThinkFullApp.js";
+import { ThinkRoutine } from "./ThinkRoutine.js";
+import { SetupChecklistEntry } from "../general-purpose/SetupChecklist.js";
+import * as React from "react";
+import { UIMessage } from "ai";
+
+//#region src/components/agents-sdk/ThinkSidepanel.d.ts
+type ThinkSidepanelView = "chat" | "files" | "plugins" | "schedules" | "live";
+type ThinkSidepanelDestination = {
+  kind: "thread";
+  threadId: string;
+} | {
+  kind: "new-thread";
+} | {
+  kind: "view";
+  view: ThinkSidepanelView;
+} | {
+  kind: "agent-run";
+  runId: string;
+} | {
+  kind: "routine";
+  routineId: string;
+} | {
+  kind: "create-routine";
+} | {
+  kind: "edit-routine";
+  routineId: string;
+} | {
+  kind: "routine-run";
+  routineId: string;
+  runId: string;
+};
+type ThinkSidepanelStatus = "ready" | "connecting" | "offline" | "identity-blocked" | "needs-model";
+interface ThinkSidepanelModelSetup {
+  onSignIn?: () => void;
+  busy?: boolean;
+  error?: React.ReactNode;
+  label?: string;
+  onCustomEndpoint?: () => void;
+}
+interface ThinkSidepanelFollow {
+  followed: boolean;
+  onCheckedChange: (followed: boolean) => void;
+}
+interface ThinkSidepanelCompanion {
+  enabled: boolean;
+  origin: string;
+  setEnabled: (enabled: boolean) => void;
+}
+interface ThinkSidepanelPasskeyVault {
+  enabled: boolean;
+  setEnabled: (enabled: boolean) => void;
+}
+interface ThinkSidepanelConnection {
+  configured: boolean;
+  description?: string;
+  onSelect: () => void;
+}
+interface ThinkSidepanelStart {
+  onSubmit: ThinkChatDraft["onSubmit"];
+  suggestions?: readonly {
+    label: string;
+    value: string;
+  }[];
+  suggestionsError?: boolean;
+  onRetrySuggestions?: () => void;
+  hasConnectedApps?: boolean;
+  slack?: ThinkSidepanelConnection;
+  discord?: ThinkSidepanelConnection;
+  onAttachFolder?: () => void;
+  attachFolderBusy?: boolean;
+  personalization?: {
+    entries: readonly SetupChecklistEntry[];
+    onSelect: (id: string) => void;
+  };
+}
+interface ThinkSidepanelSchedules<TRoutine extends ThinkRoutine = ThinkRoutine> {
+  routines: readonly TRoutine[];
+  selectedRoutineId: string | null;
+  onRunRoutine?: (routine: TRoutine) => void | Promise<void>;
+  onRoutineEnabledChange?: (routine: TRoutine, enabled: boolean) => void | Promise<void>;
+  onDeleteRoutine?: (routine: TRoutine) => void | Promise<void>;
+  error?: React.ReactNode;
+  /** Host-owned create/edit form. The side panel only frames it. */
+  editor?: React.ReactNode;
+}
+interface ThinkSidepanelAgentRun {
+  title: string;
+  running?: boolean;
+  onCancel?: () => void;
+}
+interface ThinkSidepanelIdentity {
+  email?: string;
+  liveProfile: string;
+  assignedAccount: string;
+  managed?: boolean;
+  canBind?: boolean;
+  onBind?: () => void | Promise<void>;
+  onUnbind?: () => void | Promise<void>;
+}
+interface ThinkSidepanelProps<AgentT extends ThinkFullAppAgent<State>, State = unknown, MessageT extends UIMessage = UIMessage, TRoutine extends ThinkRoutine = ThinkRoutine> extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+  sourceKey: string;
+  view: ThinkSidepanelView;
+  thread?: {
+    id: string;
+    title: string;
+  };
+  threads?: readonly ThinkThreadItem[];
+  conversation?: ThinkFullAppConversation<AgentT, State, MessageT>;
+  workspace?: ThinkFullAppProps<AgentT, State, MessageT>["workspace"];
+  plugins?: ThinkFullAppProps<AgentT, State, MessageT>["plugins"];
+  messages?: ThinkFullAppProps<AgentT, State, MessageT>["messages"];
+  /** App-authored TanStack Link for a thread, view, routine, or agent-run destination. */
+  renderLink: (destination: ThinkSidepanelDestination) => React.ReactElement;
+  onDeleteThread?: (thread: ThinkThreadItem) => void | Promise<void>;
+  follow?: ThinkSidepanelFollow;
+  companion?: ThinkSidepanelCompanion;
+  passkeyVault?: ThinkSidepanelPasskeyVault;
+  identity?: ThinkSidepanelIdentity;
+  onModel?: () => void;
+  onSignOut?: () => void;
+  brand: {
+    logo: React.ReactNode;
+    name: string;
+  };
+  appBarLeading?: React.ReactNode;
+  status?: ThinkSidepanelStatus;
+  connectingLabel?: string;
+  modelSetup?: ThinkSidepanelModelSetup;
+  start?: ThinkSidepanelStart;
+  schedules?: ThinkSidepanelSchedules<TRoutine>;
+  agentRun?: ThinkSidepanelAgentRun;
+  /** Host-owned live view. The side panel only frames it. */
+  live?: React.ReactNode;
+}
+/**
+ * The employee side panel: icon-and-tooltip chrome, start screen, schedules,
+ * conversation plus workbench. Hosts hydrate conversation, workspace,
+ * plugins, and callables. Storybook is the place to iterate the chrome.
+ */
+declare function ThinkSidepanel<AgentT extends ThinkFullAppAgent<State>, State = unknown, MessageT extends UIMessage = UIMessage, TRoutine extends ThinkRoutine = ThinkRoutine>({
+  agentRun,
+  appBarLeading,
+  brand,
+  className,
+  companion,
+  connectingLabel,
+  conversation,
+  follow,
+  identity,
+  live,
+  messages,
+  modelSetup,
+  onDeleteThread,
+  onModel,
+  onSignOut,
+  passkeyVault,
+  plugins,
+  renderLink,
+  schedules,
+  sourceKey,
+  start,
+  status,
+  thread,
+  threads,
+  view,
+  workspace,
+  ...props
+}: ThinkSidepanelProps<AgentT, State, MessageT, TRoutine>): React.JSX.Element;
+//#endregion
+export { ThinkSidepanel, ThinkSidepanelAgentRun, ThinkSidepanelCompanion, ThinkSidepanelConnection, ThinkSidepanelDestination, ThinkSidepanelFollow, ThinkSidepanelIdentity, ThinkSidepanelModelSetup, ThinkSidepanelPasskeyVault, ThinkSidepanelProps, ThinkSidepanelSchedules, ThinkSidepanelStart, ThinkSidepanelStatus, ThinkSidepanelView };