@hachej/boring-workspace 0.1.34 → 0.1.35

package/dist/app-front.d.ts

@@ -13,6 +13,7 @@ declare interface BoringFrontAPI {
     registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
     registerLeftTab<T = LeftTabParams>(registration: BoringFrontLeftTabRegistration<T>): void;
     registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): void;
+    registerToolRenderer(registration: BoringFrontToolRendererRegistration): void;
 }
 
 declare interface BoringFrontBindingRegistration {
@@ -86,6 +87,13 @@ declare interface BoringFrontSurfaceResolverRegistration {
     resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
 }
 
+declare type BoringFrontToolRenderer = (part: unknown) => ReactNode;
+
+declare interface BoringFrontToolRendererRegistration {
+    id: string;
+    render: BoringFrontToolRenderer;
+}
+
 declare type CatalogAdapter = {
     search(args: CatalogSearchArgs): Promise<CatalogSearchResult>;
     fetchFacets?(args: CatalogFacetsArgs): Promise<CatalogFacets>;
@@ -150,6 +158,20 @@ declare interface ChatLayoutProps {
     navParams?: Record<string, unknown>;
     center?: string;
     centerParams?: Record<string, unknown>;
+    chatPanes?: ChatPaneDescriptor[];
+    activeChatPaneId?: string | null;
+    onActiveChatPaneChange?: (id: string) => void;
+    onCloseChatPane?: (id: string) => void;
+    onCreateChatPaneAfter?: (id: string) => void;
+    onDropChatSession?: (sessionId: string) => void;
+    flashChatPaneId?: string | null;
+    /**
+     * Chat stage layout engine. `dock` enables the dockview-backed stage
+     * (drag headers to split in any direction); defaults to the flex row.
+     * The `boring-workspace:chat-pane-engine` localStorage key overrides
+     * when no explicit value is passed.
+     */
+    chatPaneEngine?: ChatPaneEngine | null;
     surface?: string | null;
     surfaceParams?: Record<string, unknown>;
     surfaceOverlay?: ReactNode;
@@ -163,6 +185,25 @@ declare interface ChatLayoutProps {
     className?: string;
 }
 
+declare interface ChatPaneDescriptor {
+    id: string;
+    title?: string | null;
+    panel?: string;
+    params?: Record<string, unknown>;
+}
+
+/**
+ * Layout engine for the chat pane stage.
+ *
+ * - `flex` (default): panes lay out as a single row of vertical splits.
+ * - `dock`: dockview-backed stage — drag pane headers to split in any
+ *   direction and resize; geometry persists per workspace.
+ *
+ * Resolution order: explicit prop, then the
+ * `boring-workspace:chat-pane-engine` localStorage override, then `flex`.
+ */
+declare type ChatPaneEngine = "flex" | "dock";
+
 declare interface CommandConfig {
     id: string;
     title: string;
@@ -388,13 +429,15 @@ export declare function useLocalStorageSessions(store: WorkspaceLocalSessionsSto
 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>;
 
-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, bridgeEndpoint, fullPageBasePath, onAuthError, sessions, activeSessionId, onSwitchSession, onCreateSession, onDeleteSession, onActiveSessionIdChange, appTitle, defaultSessionTitle, navEnabled, defaultNavOpen, defaultSurfaceOpen, defaultWorkbenchLeftTab, surfaceInitialPanels, topBarLeft, topBarRight, showThemeToggle, chatParams, hotReloadEnabled, frontPluginHotReload, extraPanels, extraCommands, provisionWorkspace, bootPreloadPaths, onWorkspaceWarmupStatusChange, onOpenNav, onOpenSurface, surfaceButtonBottomOffset, className, }: WorkspaceAgentFrontProps<TSession>): JSX.Element;
+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, bridgeEndpoint, fullPageBasePath, onAuthError, sessions, activeSessionId, onSwitchSession, onCreateSession, onDeleteSession, onActiveSessionIdChange, appTitle, workspaceLabel, defaultSessionTitle, navEnabled, defaultNavOpen, defaultSurfaceOpen, defaultWorkbenchLeftTab, surfaceInitialPanels, topBarLeft, topBarRight, showThemeToggle, chatParams, hotReloadEnabled, frontPluginHotReload, extraPanels, extraCommands, provisionWorkspace, bootPreloadPaths, onWorkspaceWarmupStatusChange, onOpenNav, onOpenSurface, surfaceButtonBottomOffset, chatPaneEngine, className, }: WorkspaceAgentFrontProps<TSession>): JSX.Element;
 
-export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgentSession = WorkspaceAgentSession> extends Omit<WorkspaceProviderProps, "children" | "workspaceId" | "storageKey" | "chatPanel">, Omit<ChatLayoutProps, "nav" | "navParams" | "center" | "centerParams" | "surface" | "surfaceParams" | "sidebar" | "sidebarParams" | "storageKey"> {
+export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgentSession = WorkspaceAgentSession> extends Omit<WorkspaceProviderProps, "children" | "workspaceId" | "storageKey" | "chatPanel">, Omit<ChatLayoutProps, "nav" | "navParams" | "center" | "centerParams" | "chatPanes" | "activeChatPaneId" | "onActiveChatPaneChange" | "onCloseChatPane" | "onCreateChatPaneAfter" | "onDropChatSession" | "flashChatPaneId" | "surface" | "surfaceParams" | "sidebar" | "sidebarParams" | "storageKey"> {
     workspaceId: string;
     chatPanel?: ComponentType<WorkspaceChatPanelProps>;
     useSessions?: UseWorkspaceAgentSessions<TSession>;
@@ -405,6 +448,7 @@ export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgen
     beforeShell?: ReactNode;
     afterShell?: ReactNode;
     appTitle?: string;
+    workspaceLabel?: string;
     defaultSessionTitle?: string;
     navEnabled?: boolean;
     defaultNavOpen?: boolean;
@@ -428,7 +472,7 @@ export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgen
     }>;
     activeSessionId?: string | null;
     onSwitchSession?: (id: string) => void;
-    onCreateSession?: () => void;
+    onCreateSession?: () => unknown | Promise<unknown>;
     onDeleteSession?: (id: string) => void;
     onActiveSessionIdChange?: (sessionId: string | null) => void;
     chatParams?: Record<string, unknown>;
@@ -461,6 +505,7 @@ export declare interface WorkspaceAgentSessionsApi<TSession extends WorkspaceAge
     error?: Error | null;
     activeSessionId?: string | null;
     activeSession?: TSession | null;
+    workspaceId?: string | null;
     switch: (id: string) => void;
     create: (input?: {
         title?: string;
@@ -579,8 +624,10 @@ declare interface WorkspaceProviderProps {
     defaultTheme?: "light" | "dark" | undefined;
     onThemeChange?: (theme: "light" | "dark") => void;
     workspaceId?: string;
+    workspaceLabel?: string;
     storageKey?: string;
     persistenceEnabled?: boolean;
+    manageDocumentTitle?: boolean;
     bridgeEndpoint?: string | null;
     onAuthError?: (statusCode: number) => void;
     onOpenFile?: (path: string) => void;