@mcp-b/react-components 0.44.0 → 0.45.0

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

@@ -1,13 +1,12 @@
+import { n as ResponsiveSidebarShell } from "../../ResponsiveSidebarShell-BTVPxLJK.js";
 import * as React from "react";
 
 //#region src/components/agents-sdk/ManagerOffice.d.ts
 type ManagerOfficeWorkStatus = "idle" | "running" | "attention" | "error" | "interrupted";
-/**
- * The rail already lists every employee, so there is no separate roster view:
- * the office opens on the one thing that needs a person, and an employee is a
- * selection in the rail rather than a page reached through a second list.
- */
+/** The app-owned projection currently shown by the manager office. */
 type ManagerOfficeView = {
+  kind: "dashboard";
+} | {
   kind: "attention";
 } | {
   kind: "employee";
@@ -40,6 +39,8 @@ interface ManagerOfficeWork {
   title: string;
   /** Canonical thread lifecycle status. */
   status: ManagerOfficeWorkStatus;
+  /** Concise result shown to managers when the work is ready for review. */
+  summary?: string;
   /** Unix timestamp in milliseconds of the latest lifecycle transition. */
   updatedAt: number;
 }
@@ -75,6 +76,30 @@ interface ManagerOfficeChannel {
    */
   icon?: React.ReactNode;
 }
+interface ManagerOfficeBrowserPreview {
+  /** Title of the tab currently visible on the employee's browser. */
+  title: string;
+  /** Display-safe URL supplied by the host. */
+  url: string;
+}
+interface ManagerOfficeAnalyticsPoint {
+  /** Start of the reporting bucket as a Unix timestamp in milliseconds. */
+  timestamp: number;
+  /** Outcomes completed during this bucket. */
+  completed: number;
+  /** Employee runtime consumed during this bucket. */
+  workloadHours: number;
+  /** Host-estimated inference and tool cost during this bucket. */
+  estimatedCost: number;
+}
+interface ManagerOfficeEmployeeAnalytics {
+  employeeId: string;
+  points: readonly ManagerOfficeAnalyticsPoint[];
+}
+interface ManagerOfficeReportSelection {
+  employeeIds: readonly string[];
+  rangeDays: 7 | 30 | 90;
+}
 interface ManagerOfficeEmployeeBase {
   /** Stable employee identity used by routes and list keys. */
   id: string;
@@ -94,6 +119,8 @@ interface ManagerOfficeConnectedEmployee extends ManagerOfficeEmployeeBase {
   routines: readonly ManagerOfficeRoutine[];
   /** Every service the employee reads from or acts on. Empty is meaningful. */
   channels: readonly ManagerOfficeChannel[];
+  /** The live tab the manager can glance at from the office. */
+  browserPreview?: ManagerOfficeBrowserPreview;
 }
 interface ManagerOfficeDisconnectedEmployee extends ManagerOfficeEmployeeBase {
   status: "offline" | "connecting" | "unavailable";
@@ -127,6 +154,9 @@ type ManagerOfficeDestination = {
 } | {
   kind: "new-work";
   employee: ManagerOfficeConnectedEmployee;
+} | {
+  kind: "new-routine";
+  employee: ManagerOfficeConnectedEmployee;
 } | {
   kind: "workspace";
   employee: ManagerOfficeConnectedEmployee;
@@ -138,8 +168,10 @@ interface ManagerOfficeProps extends React.HTMLAttributes<HTMLDivElement> {
   employees: readonly ManagerOfficeEmployee[];
   /** Returns an app-owned route element for every office destination. */
   renderLink: (destination: ManagerOfficeDestination) => React.ReactElement;
-  /** Add/sign-out controls rendered in the office rail. */
+  /** Add/sign-out controls rendered in the app bar or office rail. */
   officeActions?: React.ReactNode;
+  /** Place the wide-layout Workforce toggle. Defaults to the Workforce sidebar. */
+  sidebarTogglePlacement?: React.ComponentProps<typeof ResponsiveSidebarShell>["sidebarTogglePlacement"];
   /**
    * Actions rendered for the selected connected employee. Compose interactive
    * controls through `AppTopBar.Control` so they join the toolbar.
@@ -147,22 +179,84 @@ interface ManagerOfficeProps extends React.HTMLAttributes<HTMLDivElement> {
   renderEmployeeActions?: (employee: ManagerOfficeConnectedEmployee) => React.ReactNode;
   /** Action shown in the empty office. */
   emptyOfficeAction?: React.ReactNode;
+  /** Per-employee reporting buckets used by the executive analytics view. */
+  analytics?: readonly ManagerOfficeEmployeeAnalytics[];
+  /** Currency used for cost estimates. Defaults to USD. */
+  analyticsCurrency?: string;
+  /** Export the exact filtered portfolio and time range currently on screen. */
+  onExportReport?: (selection: ManagerOfficeReportSelection) => void;
 }
+interface ManagerOfficeSidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, "content"> {
+  /** Close the office drawer after a compact-width selection. */
+  closeSidebarOnCompact?: () => void;
+  /** Employees projected from their owning runtimes. */
+  employees: readonly ManagerOfficeEmployee[];
+  /** App-owned route element for an employee selection. */
+  renderLink: ManagerOfficeProps["renderLink"];
+  /** Add/sign-out/toggle controls rendered beside Workforce. */
+  officeActions?: React.ReactNode;
+  /** Employee whose row and optional nested content are active. */
+  selectedEmployeeId?: string | null;
+  /** App-specific selected-employee content shown after the switcher. */
+  content?: React.ReactNode;
+  /** Persistent sidebar action, such as starting a conversation with the selected employee. */
+  footer?: React.ReactNode;
+}
+type ManagerOfficeSidebarAlertProps = {
+  "aria-label"?: string;
+  className?: string;
+  onClick?: React.MouseEventHandler<HTMLAnchorElement>; /** Primary actionable issue title. */
+  title: React.ReactNode; /** Quiet owning-work or source context. */
+  detail?: React.ReactNode;
+} & ({
+  href: string;
+  render?: never;
+} | {
+  render: React.ReactElement;
+  href?: never;
+});
+/** Dense nested action for an employee alert already signalled by the roster status. */
+declare function ManagerOfficeSidebarAlert({
+  className,
+  detail,
+  title,
+  ...props
+}: ManagerOfficeSidebarAlertProps): React.JSX.Element;
+/**
+ * Shared Manager Office rail. Stories and host shells may add employee-owned
+ * content, but the Workforce header, roster identity, status language, scrolling,
+ * and footer placement stay component-owned and therefore cannot drift.
+ */
+declare function ManagerOfficeSidebar({
+  className,
+  closeSidebarOnCompact,
+  content,
+  employees,
+  renderLink,
+  footer,
+  officeActions,
+  selectedEmployeeId,
+  ...props
+}: ManagerOfficeSidebarProps): React.JSX.Element;
 /**
- * Multi-employee manager office: aggregate handoffs, employee roster, and one
- * employee dossier. The consuming app owns authentication, Agent connections,
- * routing, and the selected employee's full work surface.
+ * Multi-employee manager office: a dashboard, aggregate handoffs, employee
+ * roster, and one employee dossier. The consuming app owns authentication,
+ * Agent connections, routing, and the selected employee's full work surface.
  */
 declare function ManagerOffice({
+  analytics,
+  analyticsCurrency,
   className,
   emptyOfficeAction,
   employees,
   renderLink,
   officeActions,
+  onExportReport,
   renderEmployeeActions,
+  sidebarTogglePlacement,
   style,
   view,
   ...props
 }: ManagerOfficeProps): React.JSX.Element;
 //#endregion
-export { ManagerOffice, ManagerOfficeChannel, ManagerOfficeChannelDirection, ManagerOfficeChannelStatus, ManagerOfficeConnectedEmployee, ManagerOfficeDestination, ManagerOfficeDisconnectedEmployee, ManagerOfficeEmployee, ManagerOfficeEmployeeStatus, ManagerOfficeHandoff, ManagerOfficeProps, ManagerOfficeRoutine, ManagerOfficeView, ManagerOfficeWork, ManagerOfficeWorkStatus };
+export { ManagerOffice, ManagerOfficeAnalyticsPoint, ManagerOfficeBrowserPreview, ManagerOfficeChannel, ManagerOfficeChannelDirection, ManagerOfficeChannelStatus, ManagerOfficeConnectedEmployee, ManagerOfficeDestination, ManagerOfficeDisconnectedEmployee, ManagerOfficeEmployee, ManagerOfficeEmployeeAnalytics, ManagerOfficeEmployeeStatus, ManagerOfficeHandoff, ManagerOfficeProps, ManagerOfficeReportSelection, ManagerOfficeRoutine, ManagerOfficeSidebar, ManagerOfficeSidebarAlert, ManagerOfficeSidebarAlertProps, ManagerOfficeSidebarProps, ManagerOfficeView, ManagerOfficeWork, ManagerOfficeWorkStatus };