@hachej/boring-workspace 0.1.64 → 0.1.66

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>;
@@ -505,7 +540,7 @@ 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, appLeftOverlayActions, 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" | "chatTopActions" | "activeChatPaneId" | "onActiveChatPaneChange" | "onCloseChatPane" | "onCreateChatPaneAfter" | "onDropChatSession" | "flashChatPaneId" | "surface" | "surfaceParams" | "sidebar" | "sidebarParams" | "storageKey"> {
     workspaceId: string;
@@ -544,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;
@@ -557,6 +594,8 @@ 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. */
@@ -636,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[];
 };
 
@@ -644,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;
@@ -696,6 +758,11 @@ declare interface WorkspaceChatPanelProps extends Omit<PiChatPanelProps<Workspac
     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;
@@ -728,6 +795,7 @@ declare interface WorkspaceProviderProps {
      * `@hachej/boring-workspace/plugin`.
      */
     plugins?: BoringFrontFactoryWithId[];
+    capturedPlugins?: CapturedFrontPlugin[];
     excludeDefaults?: string[];
     panels?: PanelConfig[];
     commands?: CommandConfig[];
@@ -741,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;
@@ -804,3 +876,8 @@ export declare type WorkspaceWarmupStatus = {
 };
 
 export { }
+
+
+declare global {
+    var __BORING_RUNTIME_SINGLETONS__: Record<string, unknown> | undefined;
+}