@hachej/boring-workspace 0.1.62 → 0.1.64

package/dist/app-front.d.ts

@@ -167,6 +167,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;
@@ -230,6 +232,8 @@ export declare interface CreateLocalStorageSessionsOptions {
     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";
@@ -244,6 +248,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;
@@ -347,6 +355,7 @@ declare interface SessionItem {
 declare interface SurfaceOpenRequest {
     kind: string;
     target: string;
+    filesystem?: FilesystemId;
     meta?: Record<string, unknown>;
 }
 
@@ -365,10 +374,8 @@ declare interface SurfaceResolverExample {
 }
 
 declare interface SurfaceShellApi {
-    /** Open a file in the workbench. Idempotent — re-activates an existing pane for the same path. */
-    openFile: (path: string, opts?: {
-        mode?: "view" | "edit" | "diff";
-    }) => void;
+    /** 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;
     /**
@@ -386,6 +393,11 @@ declare interface SurfaceShellApi {
     getSnapshot: () => SurfaceShellSnapshot;
 }
 
+declare interface SurfaceShellOpenFileOptions {
+    filesystem?: FilesystemId;
+    mode?: "view" | "edit" | "diff";
+}
+
 declare interface SurfaceShellProps {
     rootDir?: string;
     sidebarDefaultWidth?: number;
@@ -460,6 +472,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;
@@ -477,9 +505,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, 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 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>;
@@ -535,6 +563,8 @@ export declare interface WorkspaceAgentFrontProps<TSession extends WorkspaceAgen
     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;
@@ -651,8 +681,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. */