@hachej/boring-workspace 0.1.63 → 0.1.65

package/dist/app-front.d.ts

@@ -1,7 +1,7 @@
 import { ComponentType } from 'react';
 import { DockviewApi } from 'dockview-react';
 import { DockviewPanelApi } from 'dockview-react';
-import { JSX } from 'react/jsx-runtime';
+import { JSX } from 'react';
 import { PiChatPanelProps } from '@hachej/boring-agent/front';
 import { ReactNode } from 'react';
 import { SlashCommand } from '@hachej/boring-agent/front';
@@ -13,10 +13,27 @@ declare interface BoringFrontAPI {
     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;
@@ -102,6 +119,24 @@ declare interface BoringFrontWorkspaceSourceRegistration<T = unknown> {
     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>;
@@ -167,6 +202,8 @@ declare interface ChatLayoutProps {
     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;
@@ -246,6 +283,10 @@ export declare const FULL_PAGE_PANEL_RENDER_FAILED = "FULL_PAGE_PANEL_RENDER_FAI
 
 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;
@@ -466,6 +507,22 @@ 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;
@@ -483,9 +540,9 @@ declare interface WorkspaceAgentAppLeftProjectSession {
     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, defaultSurfaceOpen, defaultWorkbenchLeftTab, defaultWorkbenchLeftOpen, surfaceInitialPanels, topBarLeft, topBarRight, showThemeToggle, showSkills, showPlugins, appLeftActions, chatParams, externalPlugins, 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, 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" | "activeChatPaneId" | "onActiveChatPaneChange" | "onCloseChatPane" | "onCreateChatPaneAfter" | "onDropChatSession" | "flashChatPaneId" | "surface" | "surfaceParams" | "sidebar" | "sidebarParams" | "storageKey"> {
+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>;
@@ -522,6 +579,8 @@ export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgen
     workspaceLayout?: WorkspaceAgentLayout;
     navEnabled?: boolean;
     defaultNavOpen?: boolean;
+    /** Initial collapsed state for the plugin-tabs app-left pane. */
+    defaultAppLeftPaneCollapsed?: boolean;
     defaultSurfaceOpen?: boolean;
     defaultWorkbenchLeftTab?: string;
     defaultWorkbenchLeftOpen?: boolean;
@@ -535,12 +594,16 @@ export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgen
      * 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;
@@ -612,6 +675,16 @@ declare type WorkspaceAttentionBlocker = {
     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[];
 };
 
@@ -620,6 +693,19 @@ declare type WorkspaceAttentionBlockerAction = {
     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;
@@ -657,8 +743,9 @@ export declare interface WorkspaceBootGateProps {
 
 declare type WorkspaceChatPanelComponent = ComponentType<any>;
 
-declare interface WorkspaceChatPanelProps extends PiChatPanelProps<WorkspaceAttentionBlocker> {
+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. */
@@ -671,6 +758,11 @@ declare interface WorkspaceChatPanelProps extends PiChatPanelProps<WorkspaceAtte
     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;
@@ -703,6 +795,7 @@ declare interface WorkspaceProviderProps {
      * `@hachej/boring-workspace/plugin`.
      */
     plugins?: BoringFrontFactoryWithId[];
+    capturedPlugins?: CapturedFrontPlugin[];
     excludeDefaults?: string[];
     panels?: PanelConfig[];
     commands?: CommandConfig[];
@@ -716,6 +809,10 @@ declare interface WorkspaceProviderProps {
     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;
@@ -779,3 +876,8 @@ export declare type WorkspaceWarmupStatus = {
 };
 
 export { }
+
+
+declare global {
+    var __BORING_RUNTIME_SINGLETONS__: Record<string, unknown> | undefined;
+}