@mcp-b/react-components 0.48.0 → 0.49.0

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

@@ -0,0 +1,212 @@
+import { J as PromptInputMessage } from "../../PromptInput-C4Mofitz.js";
+import { n as AgentToolRunValue } from "../../AgentToolRunsContext-GMe_hSnD.js";
+import { ThinkThreadItem } from "./ThinkThreadPicker.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/EmployeeChrome.d.ts
+/**
+ * Chat, the two exclusive full-screen surfaces (`live`, `schedules`), or an
+ * opaque workbench panel id. Built-in workbench destinations are `files` and
+ * `plugins`; hosts append more through `workbenchNavigation`. An unknown id
+ * keeps the conversation visible without rewriting the host's destination.
+ */
+type EmployeeView = string;
+type EmployeeDestination = {
+  kind: "thread";
+  threadId: string;
+} | {
+  kind: "new-thread";
+} | {
+  kind: "view";
+  view: EmployeeView;
+} | {
+  kind: "agent-run";
+  runId: string;
+} | {
+  kind: "routine";
+  routineId: string;
+} | {
+  kind: "create-routine";
+} | {
+  kind: "edit-routine";
+  routineId: string;
+} | {
+  kind: "routine-run";
+  routineId: string;
+  runId: string;
+};
+/** Host-owned router link for a destination; the chrome has no route vocabulary. */
+type EmployeeRenderLink = (destination: EmployeeDestination) => React.ReactElement;
+type EmployeeStatus = "ready" | "connecting" | "offline" | "identity-blocked" | "needs-model";
+interface EmployeeBrand {
+  logo: React.ReactNode;
+  name: string;
+}
+interface EmployeeIdentity {
+  email?: string;
+  liveProfile: string;
+  assignedAccount: string;
+  managed?: boolean;
+  canBind?: boolean;
+  onBind?: () => void | Promise<void>;
+  onUnbind?: () => void | Promise<void>;
+}
+/** Host-owned follow preference for the selected conversation. */
+interface EmployeeFollow {
+  followed: boolean;
+  onCheckedChange: (followed: boolean) => void;
+}
+/** Companion availability and its destination, both host-owned. */
+interface EmployeeCompanion {
+  enabled: boolean;
+  origin: string;
+  setEnabled: (enabled: boolean) => void;
+}
+/** Host-owned passkey-vault preference; credential storage stays outside the chrome. */
+interface EmployeePasskeyVault {
+  enabled: boolean;
+  setEnabled: (enabled: boolean) => void;
+}
+/** Host sign-in and endpoint-setup controls behind the `needs-model` gate. */
+interface EmployeeModelSetup {
+  onSignIn?: () => void;
+  busy?: boolean;
+  error?: React.ReactNode;
+  label?: string;
+  onCustomEndpoint?: () => void;
+}
+/**
+ * The delegated run the chrome is drilled into. A `ready` run carries the whole
+ * retained record out of the dispatching thread's projection, so status,
+ * progress, and report are the dispatching thread's facts, never the child's.
+ * The host decides which state applies and whether the run may still be
+ * stopped — `onCancel` is the whole Stop affordance's condition.
+ */
+type EmployeeAgentRun = {
+  state: "loading";
+} | {
+  state: "unavailable";
+} | {
+  state: "error";
+  error: string;
+} | {
+  state: "ready";
+  run: AgentToolRunValue; /** Stops the run. Omit while the run cannot be stopped; the bar follows. */
+  onCancel?: () => void; /** A stop already in flight, so the control reads as busy rather than dead. */
+  cancelPending?: boolean;
+};
+/** One host view following Files and Plugins in the bar and the compact overflow. */
+interface EmployeeWorkbenchItem {
+  id: string;
+  label: string;
+  icon: React.ReactNode;
+}
+interface EmployeeMenuProps {
+  renderLink: EmployeeRenderLink;
+  /** Identity assignment and bind/unbind operations behind the account dialog. */
+  identity?: EmployeeIdentity;
+  /** Opens the host's model-selection surface. */
+  onModel?: () => void;
+  /** Requests host sign-out; session teardown stays host-owned. */
+  onSignOut?: () => void;
+  companion?: EmployeeCompanion;
+  passkeys?: EmployeePasskeyVault;
+  /** Shown for a selected conversation; omit when there is nothing to follow. */
+  follow?: EmployeeFollow;
+  /** Additional host views, following Files and Plugins. */
+  workbenchNavigation?: readonly EmployeeWorkbenchItem[];
+}
+/** Employee settings are host-owned state; the menu stores only dialog visibility. */
+declare function EmployeeMenu({
+  renderLink,
+  identity,
+  onModel,
+  onSignOut,
+  companion,
+  passkeys,
+  follow,
+  workbenchNavigation
+}: EmployeeMenuProps): React.JSX.Element;
+/** Bar links to Files, Plugins, and host views; the compact overflow carries them instead. */
+declare function EmployeeWorkbenchLinks({
+  view,
+  renderLink,
+  workbenchNavigation
+}: {
+  view: EmployeeView;
+  renderLink: EmployeeRenderLink;
+  workbenchNavigation?: readonly EmployeeWorkbenchItem[];
+}): React.JSX.Element | null;
+interface EmployeeShellProps<Thread extends ThinkThreadItem = ThinkThreadItem> extends EmployeeMenuProps {
+  view: EmployeeView;
+  /** Host-projected thread history; the chrome neither fetches nor persists it. */
+  threads?: readonly Thread[];
+  /** Selected thread, used for the title, the picker, and the return link. */
+  threadId?: string;
+  /** The delegated run this chrome is drilled into, when it is drilled into one. */
+  agentRun?: EmployeeAgentRun;
+  /** Caller-owned leading bar content, such as the extension's navigation control. */
+  appBarLeading?: React.ReactNode;
+  /** Passed the whole history item after the thread picker confirms removal. */
+  onDeleteThread?: (thread: Thread) => void | Promise<void>;
+  children: React.ReactNode;
+}
+declare function EmployeeShell<Thread extends ThinkThreadItem = ThinkThreadItem>({
+  view,
+  threads,
+  threadId,
+  agentRun,
+  renderLink,
+  appBarLeading,
+  onDeleteThread,
+  children,
+  ...menu
+}: EmployeeShellProps<Thread>): React.JSX.Element;
+/** Policy and connection gates are host facts, not design-system presets. */
+declare function EmployeeGate({
+  status,
+  connectingLabel,
+  identity,
+  brand,
+  modelSetup
+}: {
+  status: EmployeeStatus;
+  connectingLabel?: string;
+  identity?: EmployeeIdentity;
+  brand: EmployeeBrand;
+  modelSetup?: EmployeeModelSetup;
+}): React.JSX.Element | null;
+/** The composer remains under its existing prompt provider; connection controls are explicit slots. */
+declare function EmployeeWelcome({
+  brand,
+  children,
+  suggestions,
+  suggestionsError,
+  onRetrySuggestions,
+  onSubmit,
+  tray,
+  setupActions,
+  hasConnectedApps
+}: {
+  brand: EmployeeBrand;
+  children: React.ReactNode;
+  suggestions?: readonly {
+    label: string;
+    value: string;
+  }[];
+  suggestionsError?: boolean;
+  onRetrySuggestions?: () => void;
+  onSubmit: (message: PromptInputMessage) => void | Promise<void>;
+  tray?: React.ReactNode; /** Slack, Discord, and local-folder actions composed by the host. */
+  setupActions?: React.ReactNode;
+  hasConnectedApps?: boolean;
+}): React.JSX.Element;
+declare const EmployeeChrome: {
+  Shell: typeof EmployeeShell;
+  Menu: typeof EmployeeMenu;
+  WorkbenchLinks: typeof EmployeeWorkbenchLinks;
+  Gate: typeof EmployeeGate;
+  Welcome: typeof EmployeeWelcome;
+};
+//#endregion
+export { EmployeeAgentRun, EmployeeBrand, EmployeeChrome, EmployeeCompanion, EmployeeDestination, EmployeeFollow, EmployeeIdentity, EmployeeMenuProps, EmployeeModelSetup, EmployeePasskeyVault, EmployeeRenderLink, EmployeeShellProps, EmployeeStatus, EmployeeView, EmployeeWorkbenchItem };