@hachej/boring-workspace 0.1.71 → 0.1.72

package/dist/app-front.d.ts

@@ -1,883 +1,2 @@
-import { ComponentType } from 'react';
-import { DockviewApi } from 'dockview-react';
-import { DockviewPanelApi } from 'dockview-react';
-import { JSX } from 'react';
-import { PiChatPanelProps } from '@hachej/boring-agent/front';
-import { ReactNode } from 'react';
-import { SlashCommand } from '@hachej/boring-agent/front';
-
-declare interface BoringFrontAPI {
-    registerProvider(registration: BoringFrontProviderRegistration): void;
-    registerBinding(registration: BoringFrontBindingRegistration): void;
-    registerCatalog(registration: CatalogConfig): void;
-    registerPanel<T = unknown>(registration: BoringFrontPanelRegistration<T>): void;
-    registerWorkspaceSource<T = unknown>(registration: BoringFrontWorkspaceSourceRegistration<T>): void;
-    registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
-    registerAppLeftAction(registration: BoringFrontAppLeftActionRegistration): void;
-    registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): void;
-    registerToolRenderer(registration: BoringFrontToolRendererRegistration): void;
-}
-
-declare interface BoringFrontAppLeftActionRegistration {
-    id: string;
-    label: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    trailing?: ComponentType;
-    overlay: ComponentType<BoringFrontAppLeftOverlayProps>;
-    order?: number;
-    emphasis?: boolean;
-}
-
-declare interface BoringFrontAppLeftOverlayProps {
-    onClose: () => void;
-}
-
-declare interface BoringFrontBindingRegistration {
-    id: string;
-    component: PluginBinding;
-}
-
-declare type BoringFrontFactory = (api: BoringFrontAPI) => void | Promise<void>;
-
-/**
- * A `BoringFrontFactory` that carries its own plugin id (and optional
- * label) as static properties. Produced by `definePlugin({ ... })` and used
- * directly by `WorkspaceProvider.plugins`.
- */
-declare type BoringFrontFactoryWithId = BoringFrontFactory & {
-    pluginId: string;
-    pluginLabel?: string;
-};
-
-declare interface BoringFrontPanelCommandRegistration {
-    id: string;
-    title: string;
-    panelId?: string;
-    run?: () => void;
-    keywords?: string[];
-    shortcut?: string;
-    when?: () => boolean;
-}
-
-declare interface BoringFrontPanelRegistration<T = unknown> {
-    id: string;
-    component: ComponentType<PaneProps<T>> | (() => Promise<{
-        default: ComponentType<PaneProps<T>>;
-    }>);
-    label?: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    placement?: PanelConfig["placement"];
-    requiresCapabilities?: string[];
-    essential?: boolean;
-    lazy?: boolean;
-    chromeless?: boolean;
-    supportsFullPage?: boolean;
-    source?: string;
-}
-
-declare interface BoringFrontProviderRegistration {
-    id: string;
-    component: PluginProvider;
-}
-
-declare interface BoringFrontSurfaceResolverRegistration {
-    id?: string;
-    kind: string;
-    title?: string;
-    description?: string;
-    targetHint?: string;
-    examples?: SurfaceResolverExample[];
-    metaSchema?: Record<string, unknown>;
-    source?: string;
-    resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
-}
-
-declare type BoringFrontToolRenderer = (part: unknown) => ReactNode;
-
-declare interface BoringFrontToolRendererRegistration {
-    id: string;
-    render: BoringFrontToolRenderer;
-}
-
-declare interface BoringFrontWorkspaceSourceRegistration<T = unknown> {
-    id: string;
-    component: ComponentType<WorkspaceSourceProps<T>> | (() => Promise<{
-        default: ComponentType<WorkspaceSourceProps<T>>;
-    }>);
-    label?: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    requiresCapabilities?: string[];
-    lazy?: boolean;
-    chromeless?: boolean;
-    defaultPanelId?: string;
-    source?: string;
-}
-
-declare interface CapturedBoringFrontRegistrations {
-    providers: BoringFrontProviderRegistration[];
-    bindings: BoringFrontBindingRegistration[];
-    catalogs: CatalogConfig[];
-    panels: BoringFrontPanelRegistration<any>[];
-    workspaceSources: BoringFrontWorkspaceSourceRegistration<any>[];
-    panelCommands: BoringFrontPanelCommandRegistration[];
-    appLeftActions: BoringFrontAppLeftActionRegistration[];
-    surfaceResolvers: BoringFrontSurfaceResolverRegistration[];
-    toolRenderers: BoringFrontToolRendererRegistration[];
-}
-
-declare interface CapturedFrontPlugin {
-    id: string;
-    label?: string;
-    registrations: CapturedBoringFrontRegistrations;
-}
-
-declare type CatalogAdapter = {
-    search(args: CatalogSearchArgs): Promise<CatalogSearchResult>;
-    fetchFacets?(args: CatalogFacetsArgs): Promise<CatalogFacets>;
-};
-
-declare type CatalogBadge = {
-    /** 1–4 char mono code rendered as a chip. */
-    code: string;
-    tooltip?: string;
-};
-
-declare interface CatalogConfig {
-    id: string;
-    label: string;
-    adapter: CatalogAdapter;
-    onSelect: (row: CatalogRow) => void;
-    pluginId?: string;
-}
-
-declare type CatalogFacets = Record<string, CatalogFacetValue[]>;
-
-declare type CatalogFacetsArgs = {
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-};
-
-declare type CatalogFacetValue = {
-    value: string;
-    count: number;
-};
-
-declare type CatalogRow = {
-    id: string;
-    title: string;
-    subtitle?: string;
-    group?: string;
-    leading?: CatalogBadge;
-    trailing?: CatalogBadge[];
-    meta?: string;
-};
-
-declare type CatalogSearchArgs = {
-    query: string;
-    filters: Record<string, string[]>;
-    group?: {
-        key: string;
-        value: string;
-    };
-    limit: number;
-    offset: number;
-    signal?: AbortSignal;
-};
-
-declare type CatalogSearchResult = {
-    items: CatalogRow[];
-    total: number;
-    hasMore: boolean;
-};
-
-declare interface ChatLayoutProps {
-    nav?: string | null;
-    navParams?: Record<string, unknown>;
-    center?: string;
-    centerParams?: Record<string, unknown>;
-    chatPanes?: ChatPaneDescriptor[];
-    /** Optional host actions rendered in the active chat pane header. */
-    chatTopActions?: ReactNode;
-    activeChatPaneId?: string | null;
-    onActiveChatPaneChange?: (id: string) => void;
-    onCloseChatPane?: (id: string) => void;
-    onCreateChatPaneAfter?: (id: string) => void;
-    onDropChatSession?: (sessionId: string) => void;
-    flashChatPaneId?: string | null;
-    surface?: string | null;
-    surfaceParams?: Record<string, unknown>;
-    /** Opaque overlay rendered over the full chat stage only (not over the workbench). */
-    chatOverlay?: ReactNode;
-    /** Called when shell chrome needs to dismiss the chat overlay before collapsing chat. */
-    onCloseChatOverlay?: () => void;
-    surfaceOverlay?: ReactNode;
-    sidebar?: string | null;
-    sidebarParams?: Record<string, unknown>;
-    storageKey?: string;
-    onOpenNav?: () => void;
-    onOpenSurface?: () => void;
-    surfaceButtonBottomOffset?: number;
-    onOpenSidebar?: () => void;
-    className?: string;
-}
-
-declare interface ChatPaneDescriptor {
-    id: string;
-    title?: string | null;
-    panel?: string;
-    params?: Record<string, unknown>;
-}
-
-declare interface CommandConfig {
-    id: string;
-    title: string;
-    run: () => void;
-    keywords?: string[];
-    shortcut?: string;
-    when?: () => boolean;
-    pluginId?: string;
-}
-
-declare interface CommandPaletteSessionItem {
-    id: string;
-    title?: string | null;
-    updatedAt?: string | number;
-    turnCount?: number;
-}
-
-declare interface CommandPaletteSessionSearchConfig {
-    sessions: CommandPaletteSessionItem[];
-    activeId?: string | null;
-    openIds?: readonly string[];
-    search?: (sessions: readonly CommandPaletteSessionItem[], query: string) => CommandPaletteSessionItem[];
-    onSwitch: (id: string) => void;
-    onOpenAsTab: (id: string) => void;
-}
-
-export declare function createLocalStorageSessions(opts?: CreateLocalStorageSessionsOptions): WorkspaceLocalSessionsStore;
-
-export declare interface CreateLocalStorageSessionsOptions {
-    storageKey?: string;
-    initial?: () => WorkspaceLocalSessionsState;
-}
-
-declare type FilesystemId = "user" | "company_context" | (string & {});
-
-declare type FrontPluginHotReloadMode = "vite" | false;
-
-export declare const FULL_PAGE_PANEL_INVALID_PARAMS_JSON = "FULL_PAGE_PANEL_INVALID_PARAMS_JSON";
-
-export declare const FULL_PAGE_PANEL_MISSING_COMPONENT = "FULL_PAGE_PANEL_MISSING_COMPONENT";
-
-export declare const FULL_PAGE_PANEL_NOT_SUPPORTED = "FULL_PAGE_PANEL_NOT_SUPPORTED";
-
-export declare const FULL_PAGE_PANEL_PARAMS_NOT_OBJECT = "FULL_PAGE_PANEL_PARAMS_NOT_OBJECT";
-
-export declare const FULL_PAGE_PANEL_RENDER_FAILED = "FULL_PAGE_PANEL_RENDER_FAILED";
-
-export declare const FULL_PAGE_PANEL_UNKNOWN_COMPONENT = "FULL_PAGE_PANEL_UNKNOWN_COMPONENT";
-
-declare type OpenArtifactHandler = (path: string, options?: {
-    filesystem?: FilesystemId;
-}) => void;
-
-declare interface OpenPanelConfig {
-    /** Panel instance id. If a panel with this id is already open, it's re-activated instead of duplicated. */
-    id: string;
-    /** Registered component id (must match a `PanelConfig.id` in WorkspaceProvider's panel registry). */
-    component: string;
-    /** Tab title. Defaults to `id`. */
-    title?: string;
-    /** Arbitrary params passed to the pane component. */
-    params?: Record<string, unknown>;
-}
-
-declare interface PanelConfig<T = any> {
-    id: string;
-    title: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    /** Placement hint. Public plugin placements: "workspace-page" | "shared-dockview". */
-    placement?: PanelPlacement | string;
-    requiresCapabilities?: string[];
-    essential?: boolean;
-    chromeless?: boolean;
-    supportsFullPage?: boolean;
-    /** Source: "builtin" | "app" */
-    source?: string;
-    pluginId?: string;
-    /** Revision emitted by the runtime plugin asset manager for hot-loaded panels. */
-    pluginRevision?: number;
-    /**
-     * Whether to wrap the component with React.lazy + Suspense. Omit to let
-     * the registry auto-detect: zero-arg functions (factories) are treated as
-     * lazy; components that accept a props argument are treated as eager.
-     */
-    lazy?: boolean;
-    component: ComponentType<PaneProps<T>> | (() => Promise<{
-        default: ComponentType<PaneProps<T>>;
-    }>);
-}
-
-declare type PanelPlacement = "left" | "center" | "right" | "bottom" | "shared-dockview" | "workspace-page" | "right-tab";
-
-/**
- * Unified prop shape for panel components rendered inside DockviewShell.
- *
- * Structurally mirrors dockview's `IDockviewPanelProps<T>` so dockview
- * can render registered components directly — no wrapper, no field
- * renaming, no `as` casts. We re-state the shape (rather than re-export
- * dockview's type) so the workspace package owns its public contract:
- * if dockview's type ever drifts, only the wiring inside DockviewShell
- * needs to change.
- *
- * Use {@link definePanel} for type-safe registration.
- *
- * @typeParam T - Shape of the panel-specific `params` payload. Defaults
- *   to `unknown` because layouts restored from JSON are inherently
- *   un-typed at runtime; use a generic param when you control the
- *   addPanel call site, otherwise read defensively.
- */
-declare interface PaneProps<T = unknown> {
-    /** App-supplied data for this panel instance (e.g. `{ path: string }`). */
-    params: T;
-    /** Per-panel control surface (close, setActive, setTitle, …). */
-    api: DockviewPanelApi;
-    /** Top-level dockview API (groups, addPanel, removePanel, fromJSON, …). */
-    containerApi: DockviewApi;
-    /** Optional className forwarded to the pane's root element. */
-    className?: string;
-}
-
-export declare interface ParsedFullPagePanelLocation {
-    componentId: string | null;
-    params: Record<string, unknown>;
-    error?: {
-        code: WorkspaceFullPageRouteErrorCode;
-        message: string;
-    };
-}
-
-export declare function parseFullPagePanelLocation(search: string): ParsedFullPagePanelLocation;
-
-declare type PluginBinding = ComponentType<unknown>;
-
-declare type PluginProvider = ComponentType<PluginProviderProps>;
-
-declare interface PluginProviderProps {
-    apiBaseUrl: string;
-    authHeaders?: Record<string, string>;
-    onAuthError?: (statusCode: number) => void;
-    apiTimeout?: number;
-    activeSessionId?: string | null;
-    openSessionIds?: readonly string[];
-    children: ReactNode;
-}
-
-declare interface SessionItem {
-    id: string;
-    title: string;
-    updatedAt?: string | number;
-}
-
-declare interface SurfaceOpenRequest {
-    kind: string;
-    target: string;
-    filesystem?: FilesystemId;
-    meta?: Record<string, unknown>;
-}
-
-declare interface SurfacePanelResolution {
-    component: string;
-    id?: string;
-    title?: string;
-    params?: Record<string, unknown>;
-    score?: number;
-}
-
-declare interface SurfaceResolverExample {
-    target: string;
-    label?: string;
-    meta?: Record<string, unknown>;
-}
-
-declare interface SurfaceShellApi {
-    /** Open a file in the workbench. Idempotent — re-activates an existing pane for the same filesystem/path. */
-    openFile: (path: string, options?: SurfaceShellOpenFileOptions) => void;
-    /** Open a plugin-defined surface target through the registered surface resolvers. */
-    openSurface: (request: SurfaceOpenRequest) => void;
-    /**
-     * Open a non-file pane in the workbench. Idempotent on `id` —
-     * re-activates an existing panel with the same id rather than duplicating.
-     * Use this for app-specific panes (charts, dashboards, log viewers, …) that
-     * aren't anchored to a filesystem path.
-     */
-    openPanel: (config: OpenPanelConfig) => void;
-    /** Hide the workbench's left sources/files pane while leaving the workbench open. */
-    closeWorkbenchLeftPane: () => void;
-    /** Reveal/select a file-tree path without opening an editor pane. */
-    expandToFile: (path: string) => void;
-    /** Current snapshot of open tabs + active tab. */
-    getSnapshot: () => SurfaceShellSnapshot;
-}
-
-declare interface SurfaceShellOpenFileOptions {
-    filesystem?: FilesystemId;
-    mode?: "view" | "edit" | "diff";
-}
-
-declare interface SurfaceShellProps {
-    rootDir?: string;
-    sidebarDefaultWidth?: number;
-    sidebarMinWidth?: number;
-    sidebarMaxWidth?: number;
-    storageKey?: string;
-    /** Called once when the surface dockview becomes ready, with an imperative handle. */
-    onReady?: (api: SurfaceShellApi) => void;
-    /** Called on every panel add/remove/active-change with the current snapshot. */
-    onChange?: (snapshot: SurfaceShellSnapshot) => void;
-    /** Optional close action for hosts that model the workbench as collapsible. */
-    onClose?: () => void;
-    /** Render the built-in top-right close affordance. Hosts can set false when they provide their own chrome. */
-    showCloseAction?: boolean;
-    /**
-     * Extra panel ids (registered via WorkspaceProvider's `panels` prop) that
-     * this workbench is allowed to render. Defaults to the built-in
-     * editor/viewer panels only. Pass app-specific pane ids here so calls
-     * like `surface.openPanel({ component: "chart-canvas" })` actually
-     * instantiate — without this, dockview's components map filters them
-     * out and you get an empty tab. Two-layer defense: SurfaceShell.openPanel
-     * validates against the registry (loud throw on unknown), AND the
-     * dockview allowlist below filters which registered panels can mount
-     * inside THIS surface (so a host can gate panels per shell instance).
-     */
-    extraPanels?: string[];
-    defaultLeftTab?: string;
-    onReloadAgentPlugins?: () => void | Promise<unknown>;
-    initialPanels?: Array<{
-        id: string;
-        component: string;
-        title?: string;
-        params?: Record<string, unknown>;
-    }>;
-    className?: string;
-}
-
-declare interface SurfaceShellSnapshot {
-    openTabs: SurfaceShellTab[];
-    activeTab: string | null;
-}
-
-declare interface SurfaceShellTab {
-    id: string;
-    /** Registered panel component id for this tab. May differ from the tab instance id. */
-    component?: string;
-    title: string;
-    params?: Record<string, unknown>;
-}
-
-export declare function useLocalStorageSessions(store: WorkspaceLocalSessionsStore): WorkspaceLocalSessionsState;
-
-export declare type UseWorkspaceAgentSessions<TSession extends WorkspaceAgentSession = WorkspaceAgentSession> = (options: {
-    requestHeaders: Record<string, string>;
-    storageKey: string;
-    workspaceId?: string;
-    apiBaseUrl?: string;
-    enabled?: boolean;
-    refreshKey?: unknown;
-}) => WorkspaceAgentSessionsApi<TSession>;
-
-declare interface WorkspaceAgentAppLeftAction {
-    id: string;
-    label: string;
-    icon: ReactNode;
-    onClick: () => void;
-    trailing?: ReactNode;
-    emphasis?: boolean;
-}
-
-declare type WorkspaceAgentAppLeftHeaderMode = "full" | "workspace" | "hidden";
-
-declare type WorkspaceAgentAppLeftLayoutMode = "single-project" | "multi-project";
-
-declare interface WorkspaceAgentAppLeftOverlayAction {
-    id: string;
-    label: string;
-    icon: ReactNode;
-    trailing?: ReactNode;
-    emphasis?: boolean;
-    render: (props: WorkspaceAgentAppLeftOverlayRenderProps) => ReactNode;
-}
-
-declare interface WorkspaceAgentAppLeftOverlayRenderProps {
-    onClose: () => void;
-    headerInsetStart: boolean;
-    headerInsetEnd: boolean;
-    workspaceId: string;
-}
-
-declare interface WorkspaceAgentAppLeftProject {
-    id: string;
-    name: string;
-    available?: boolean;
-    sessionCount?: number;
-    blockedCount?: number;
-    sessions?: WorkspaceAgentAppLeftProjectSession[];
-    hasMoreSessions?: boolean;
-    loadingSessions?: boolean;
-}
-
-declare interface WorkspaceAgentAppLeftProjectSession {
-    id: string;
-    title?: string | null;
-    updatedAt?: string | number;
-}
-
-export declare function WorkspaceAgentFront<TSession extends WorkspaceAgentSession = WorkspaceAgentSession>({ workspaceId, chatPanel: chatPanelProp, useSessions: useSessionsProp, requestHeaders, sessionStorageKey, providerStorageKey, surfaceStorageKey, beforeShell, afterShell, panels, commands, catalogs, plugins, excludeDefaults, capabilities, apiBaseUrl, authHeaders, apiTimeout, defaultTheme, onThemeChange, persistenceEnabled, debug, bridgeEndpoint, fullPageBasePath, onAuthError, sessions, activeSessionId, onSwitchSession, onCreateSession, onDeleteSession, onActiveSessionIdChange, appTitle, workspaceLabel, workspaceSectionTitle, appLeftLayoutMode, appLeftHeaderMode, appLeftProjects, appLeftActiveProjectId, onSwitchAppLeftProject, onOpenAppLeftProjectSession, onShowMoreAppLeftProjectSessions, onCreateAppLeftProject, onOpenAppLeftProjectSettings, onOpenAppLeftProjectInNewTab, defaultSessionTitle, workspaceLayout, navEnabled, defaultNavOpen, defaultAppLeftPaneCollapsed, defaultSurfaceOpen, defaultWorkbenchLeftTab, defaultWorkbenchLeftOpen, surfaceInitialPanels, topBarLeft, topBarRight, showThemeToggle, defaultLeftOverlay, showSkills, showPlugins, appLeftActions, appLeftOverlayActions, chatParams, externalPlugins, hotReloadEnabled, frontPluginHotReload, extraPanels, extraCommands, provisionWorkspace, bootPreloadPaths, onWorkspaceWarmupStatusChange, onOpenNav, onOpenSurface, surfaceButtonBottomOffset, className, }: WorkspaceAgentFrontProps<TSession>): JSX.Element;
-
-export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgentSession = WorkspaceAgentSession> extends Omit<WorkspaceProviderProps, "children" | "workspaceId" | "storageKey" | "chatPanel" | "commandPaletteSessionSearch">, Omit<ChatLayoutProps, "nav" | "navParams" | "center" | "centerParams" | "chatPanes" | "chatTopActions" | "activeChatPaneId" | "onActiveChatPaneChange" | "onCloseChatPane" | "onCreateChatPaneAfter" | "onDropChatSession" | "flashChatPaneId" | "surface" | "surfaceParams" | "sidebar" | "sidebarParams" | "storageKey"> {
-    workspaceId: string;
-    chatPanel?: ComponentType<WorkspaceChatPanelProps>;
-    useSessions?: UseWorkspaceAgentSessions<TSession>;
-    requestHeaders?: Record<string, string>;
-    sessionStorageKey?: string;
-    providerStorageKey?: string;
-    surfaceStorageKey?: string;
-    beforeShell?: ReactNode;
-    afterShell?: ReactNode;
-    appTitle?: string;
-    workspaceLabel?: string;
-    /** App-left workspace/project section title. Defaults to "Workspaces". */
-    workspaceSectionTitle?: string;
-    /** App-left layout mode. single-project uses the workspace dropdown; multi-project renders workspaces inline. */
-    appLeftLayoutMode?: WorkspaceAgentAppLeftLayoutMode;
-    /** App-left header mode: full brand, workspace picker only, or hidden with collapse-button clearance. */
-    appLeftHeaderMode?: WorkspaceAgentAppLeftHeaderMode;
-    /** Optional cross-project overview rendered in the app-left workspace/project section. */
-    appLeftProjects?: WorkspaceAgentAppLeftProject[];
-    appLeftActiveProjectId?: string | null;
-    onSwitchAppLeftProject?: (projectId: string) => void;
-    onOpenAppLeftProjectSession?: (projectId: string, sessionId: string) => void;
-    onShowMoreAppLeftProjectSessions?: (projectId: string) => void;
-    onCreateAppLeftProject?: () => void;
-    /** Open a project's workspace settings (host wires routing — workspace pkg has no router). */
-    onOpenAppLeftProjectSettings?: (projectId: string) => void;
-    /** Open a project in a new browser tab (host builds the href). */
-    onOpenAppLeftProjectInNewTab?: (projectId: string) => void;
-    defaultSessionTitle?: string;
-    /**
-     * Opt into the Phase 2 app/session left-pane shell. Defaults to the
-     * existing classic top-bar + session-drawer workspace layout.
-     */
-    workspaceLayout?: WorkspaceAgentLayout;
-    navEnabled?: boolean;
-    defaultNavOpen?: boolean;
-    /** Initial collapsed state for the plugin-tabs app-left pane. */
-    defaultAppLeftPaneCollapsed?: boolean;
-    defaultSurfaceOpen?: boolean;
-    defaultWorkbenchLeftTab?: string;
-    defaultWorkbenchLeftOpen?: boolean;
-    surfaceInitialPanels?: SurfaceShellProps["initialPanels"];
-    topBarLeft?: ReactNode;
-    topBarRight?: ReactNode;
-    /**
-     * Show the built-in top-bar theme toggle. Defaults to true for standalone
-     * hosts (e.g. the workspace playground) that have no other theme control.
-     * Full apps that already expose theme switching elsewhere (e.g. the core
-     * UserMenu) should set this to false to avoid a duplicate control.
-     */
-    showThemeToggle?: boolean;
-    /** Initial plugin-tabs overlay, useful for demos/deep links. */
-    defaultLeftOverlay?: string | null;
-    /** Show the plugin-tabs Skills action/overlay. Defaults to true. */
-    showSkills?: boolean;
-    /** Show the plugin-tabs Plugins action/overlay. Defaults to true. */
-    showPlugins?: boolean;
-    /** Extra actions inserted into the app-left primary action list before built-in management actions. */
-    appLeftActions?: readonly WorkspaceAgentAppLeftAction[];
-    /** Extra chat-hosted management overlays opened from the app-left primary action list. */
-    appLeftOverlayActions?: readonly WorkspaceAgentAppLeftOverlayAction[];
-    sessions?: Array<{
-        id: string;
-        title?: string | null;
-        updatedAt?: string | number;
-        turnCount?: number;
-    }>;
-    activeSessionId?: string | null;
-    onSwitchSession?: (id: string) => void;
-    onCreateSession?: () => unknown | Promise<unknown>;
-    onDeleteSession?: (id: string) => void;
-    onActiveSessionIdChange?: (sessionId: string | null) => void;
-    chatParams?: Record<string, unknown>;
-    /**
-     * Enable user-authored external plugin UX in the frontend. When `false`,
-     * disables front plugin hot reload and hides the chat `/reload` UX. App/
-     * internal statically composed plugins still work.
-     */
-    externalPlugins?: boolean;
-    /**
-     * Forward to ChatPanel — when `false`, the `/reload` slash command is
-     * hidden and the PluginUpdateStatus banner above the composer is
-     * suppressed. Production apps that don't ship live plugin editing
-     * should pass `false`. Defaults to `true` (dev/playground default).
-     */
-    hotReloadEnabled?: boolean;
-    extraPanels?: string[];
-    extraCommands?: SlashCommand[];
-    provisionWorkspace?: boolean;
-    bootPreloadPaths?: string[];
-    onWorkspaceWarmupStatusChange?: (status: WorkspaceWarmupStatus) => void;
-}
-
-export declare type WorkspaceAgentLayout = "classic" | "plugin-tabs";
-
-export declare interface WorkspaceAgentSession {
-    id: string;
-    title?: string | null;
-    updatedAt?: string | number;
-    turnCount?: number;
-}
-
-export declare interface WorkspaceAgentSessionsApi<TSession extends WorkspaceAgentSession = WorkspaceAgentSession> {
-    sessions: TSession[];
-    loading: boolean;
-    loadingMore?: boolean;
-    hasMore?: boolean;
-    error?: Error | null;
-    activeSessionId?: string | null;
-    activeSession?: TSession | null;
-    workspaceId?: string | null;
-    switch: (id: string) => void;
-    create: (input?: {
-        title?: string;
-    }) => void | Promise<unknown>;
-    delete: (id: string) => void | Promise<unknown>;
-    loadMore?: () => void | Promise<unknown>;
-    refresh?: (options?: {
-        background?: boolean;
-    }) => void | Promise<unknown>;
-}
-
-declare type WorkspaceAttentionBlocker = {
-    id: string;
-    /** Plugin/domain-specific reason, e.g. "ask-user.question" or "pr-review.review". */
-    reason: string;
-    surfaceKind?: string;
-    target?: string;
-    label?: string;
-    sessionId?: string;
-    /** Optional generic session-row badge contributed by the plugin that owns this attention. */
-    sessionBadge?: WorkspaceAttentionSessionBadge;
-    /**
-     * Remove this blocker once its workspace chat session disappears from the
-     * authoritative session list. Leave unset for external inbox items whose
-     * `sessionId` is a source/thread identifier rather than a local chat id.
-     */
-    pruneWhenSessionMissing?: boolean;
-    /** Explicit inbox projection metadata. New inbox-aware plugins should provide this instead of relying on reason parsing. */
-    inbox?: WorkspaceAttentionInboxMetadata;
-    /** Optional shell focus behavior requested by the plugin that owns this blocker. */
-    focus?: WorkspaceAttentionFocusMetadata;
-    actions?: WorkspaceAttentionBlockerAction[];
-};
-
-declare type WorkspaceAttentionBlockerAction = {
-    id: string;
-    label: string;
-};
-
-declare type WorkspaceAttentionFocusMetadata = {
-    /** Close the workbench left pane when this blocker becomes active for the current session. */
-    closeWorkbenchLeftPane?: boolean;
-};
-
-declare type WorkspaceAttentionInboxMetadata = {
-    kind: "question" | "review" | "approval" | "notice";
-    sourceLabel: string;
-    createdAt?: string | number | Date;
-    updatedAt?: string | number | Date;
-    priority?: number;
-};
-
-declare type WorkspaceAttentionSessionBadge = {
-    /** Stable badge kind for data attributes and plugin-specific styling hooks. */
-    kind: string;
-    /** Short text rendered on the session row, e.g. "question", "review", "approval". */
-    label: string;
-    /** Visual tone only; semantics are owned by the plugin-specific kind/reason. */
-    tone?: "attention" | "danger" | "neutral" | "warning";
-    /** Higher priority wins when several plugins mark the same session. */
-    priority?: number;
-};
-
-export declare function WorkspaceBackgroundBoot({ workspaceId, requestHeaders, apiBaseUrl, preloadPaths, provisionWorkspace, onStatusChange, }: WorkspaceBackgroundBootProps): null;
-
-export declare interface WorkspaceBackgroundBootProps {
-    workspaceId: string;
-    requestHeaders?: Record<string, string>;
-    apiBaseUrl?: string | null;
-    preloadPaths?: string[];
-    provisionWorkspace?: boolean;
-    onStatusChange?: (status: WorkspaceWarmupStatus) => void;
-}
-
-export declare function WorkspaceBootGate({ workspaceId, requestHeaders, apiBaseUrl, preloadPaths, provisionWorkspace, loadingFallback, errorFallback, children, }: WorkspaceBootGateProps): JSX.Element;
-
-export declare interface WorkspaceBootGateProps {
-    workspaceId: string;
-    requestHeaders?: Record<string, string>;
-    apiBaseUrl?: string | null;
-    preloadPaths?: string[];
-    provisionWorkspace?: boolean;
-    loadingFallback?: ReactNode | ((status: string) => ReactNode);
-    errorFallback?: ReactNode | ((message: string) => ReactNode);
-    children: ReactNode;
-}
-
-declare type WorkspaceChatPanelComponent = ComponentType<any>;
-
-declare interface WorkspaceChatPanelProps extends Omit<PiChatPanelProps<WorkspaceAttentionBlocker>, "onOpenArtifact"> {
-    sessionId: string;
-    onOpenArtifact?: OpenArtifactHandler;
-    /** Endpoint base for agent → visible-workbench UI commands. */
-    bridgeEndpoint?: string | null;
-    /** Imperative handle getter for the visible workbench surface. */
-    getSurface?: () => SurfaceShellApi | null;
-    /** Reads whether the visible workbench surface should be open. */
-    isWorkbenchOpen?: () => boolean;
-    /** Opens the visible workbench surface before dispatching a command. */
-    openWorkbench?: () => void;
-    /** Opens the visible workbench sources/file-tree pane before dispatching a reveal. */
-    openWorkbenchSources?: () => void;
-    /** Closes the visible workbench surface after an ephemeral command finishes. */
-    closeWorkbench?: () => void;
-    /** Host-injected composer blockers (for shell policies such as detached read-only chat). */
-    composerBlockers?: WorkspaceAttentionBlocker[];
-    onComposerStop?: () => void;
-    onComposerBlockerAction?: (blocker: WorkspaceAttentionBlocker, action: string) => void;
-    onData?: (part: unknown) => void;
-}
-
-export declare function WorkspaceFullPagePanel({ componentId, params }: WorkspaceFullPagePanelProps): JSX.Element;
-
-export declare interface WorkspaceFullPagePanelProps {
-    componentId: string;
-    params?: Record<string, unknown>;
-}
-
-export declare type WorkspaceFullPageRouteErrorCode = typeof FULL_PAGE_PANEL_MISSING_COMPONENT | typeof FULL_PAGE_PANEL_INVALID_PARAMS_JSON | typeof FULL_PAGE_PANEL_PARAMS_NOT_OBJECT | typeof FULL_PAGE_PANEL_UNKNOWN_COMPONENT | typeof FULL_PAGE_PANEL_NOT_SUPPORTED | typeof FULL_PAGE_PANEL_RENDER_FAILED;
-
-export declare interface WorkspaceLocalSessionsState {
-    sessions: SessionItem[];
-    activeId: string;
-}
-
-export declare interface WorkspaceLocalSessionsStore {
-    getState: () => WorkspaceLocalSessionsState;
-    subscribe: (fn: () => void) => () => void;
-    switchTo: (id: string) => void;
-    create: () => void;
-    remove: (id: string) => void;
-}
-
-declare interface WorkspaceProviderProps {
-    children: ReactNode;
-    chatPanel?: WorkspaceChatPanelComponent;
-    /**
-     * Front plugin entries produced by `definePlugin({ id, ... })` from
-     * `@hachej/boring-workspace/plugin`.
-     */
-    plugins?: BoringFrontFactoryWithId[];
-    capturedPlugins?: CapturedFrontPlugin[];
-    excludeDefaults?: string[];
-    panels?: PanelConfig[];
-    commands?: CommandConfig[];
-    catalogs?: CatalogConfig[];
-    capabilities?: Record<string, boolean>;
-    apiBaseUrl?: string;
-    authHeaders?: Record<string, string>;
-    /** Per-request timeout for the data layer's FetchClient, in ms. */
-    apiTimeout?: number;
-    /** Active chat/session scope shared with plugin providers that need session-scoped data. */
-    activeSessionId?: string | null;
-    /** Session ids that are currently open in chat panes, for plugins that must avoid opening closed-session UI. */
-    openSessionIds?: readonly string[];
-    /** Authoritative chat session ids used to drop stale session-scoped Inbox/attention entries. */
-    attentionSessionIds?: readonly string[];
-    /** False while session data is loading or paginated; prevents pruning valid off-page attention entries. */
-    attentionSessionsAuthoritative?: boolean;
-    defaultTheme?: "light" | "dark" | undefined;
-    onThemeChange?: (theme: "light" | "dark") => void;
-    workspaceId?: string;
-    workspaceLabel?: string;
-    appTitle?: string;
-    storageKey?: string;
-    persistenceEnabled?: boolean;
-    manageDocumentTitle?: boolean;
-    bridgeEndpoint?: string | null;
-    onAuthError?: (statusCode: number) => void;
-    onOpenFile?: (path: string) => void;
-    debug?: boolean;
-    /**
-     * Hot-load dynamically discovered front plugin modules. The current
-     * implementation relies on Vite's /@fs transform endpoint, so it defaults to
-     * dev-only. Production hosts should keep this false until they provide their
-     * own module asset endpoint.
-     */
-    frontPluginHotReload?: FrontPluginHotReloadMode;
-    fullPageBasePath?: string;
-    commandPaletteSessionSearch?: CommandPaletteSessionSearchConfig;
-}
-
-declare type WorkspaceRuntimeDependenciesWarmupStatus = {
-    state: "preparing" | "ready" | "failed";
-    message?: string;
-    requirement?: string;
-};
-
-declare interface WorkspaceSourceOpenPanelConfig {
-    id: string;
-    component: string;
-    title?: string;
-    params?: Record<string, unknown>;
-}
-
-/**
- * Props for workspace source panes hosted in the left workspace rail.
- * These are not Dockview panels: they receive only source-pane params and
- * the explicit actions that the source host supports.
- */
-declare interface WorkspaceSourceProps<T = unknown> {
-    params: T;
-    className?: string;
-    openPanel?: (config: WorkspaceSourceOpenPanelConfig) => void;
-}
-
-export declare type WorkspaceWarmupStatus = {
-    status: "preparing";
-    requirement?: "workspace-fs" | "sandbox-exec" | "ui-bridge";
-    message?: string;
-    runtimeDependencies?: WorkspaceRuntimeDependenciesWarmupStatus;
-} | {
-    status: "ready";
-    runtimeDependencies?: WorkspaceRuntimeDependenciesWarmupStatus;
-} | {
-    status: "failed";
-    message: string;
-    requirement?: "workspace-fs" | "sandbox-exec" | "ui-bridge";
-    runtimeDependencies?: WorkspaceRuntimeDependenciesWarmupStatus;
-};
-
-export { }
-
-
-declare global {
-    var __BORING_RUNTIME_SINGLETONS__: Record<string, unknown> | undefined;
-}
+export * from './src/app/front/index.js'
+export {}