@hachej/boring-workspace 0.1.12 → 0.1.14

package/dist/workspace.d.ts

@@ -57,8 +57,6 @@ export declare interface AgentToolRegistry {
     register(tool: AgentTool, pluginId: string): void;
 }
 
-export declare function appendDataCatalogOutputs<T extends WorkspaceFrontPlugin>(plugin: T, options: CreateDataCatalogOutputsOptions): T;
-
 export declare interface ArtifactPanel {
     id: string;
     component: string;
@@ -84,24 +82,6 @@ export declare interface ArtifactSurfacePaneProps {
     className?: string;
 }
 
-export declare type Badge = {
-    /** 1–4 char mono code rendered as a chip. */
-    code: string;
-    tooltip?: string;
-};
-
-/**
- * DataExplorer shared types — no runtime deps.
- *
- * Importable from BOTH front and server bundles without dragging in
- * platform-specific code.
- */
-declare type Badge_2 = {
-    /** 1–4 char mono code rendered as a chip. */
-    code: string;
-    tooltip?: string;
-};
-
 export declare interface BindingOutput {
     type: "binding";
     id: string;
@@ -193,14 +173,44 @@ export declare function buildChatLayout(props?: ChatLayoutProps): LayoutConfig;
 
 export declare function buildIdeLayout(props?: IdeLayoutProps): LayoutConfig;
 
+export declare type CatalogAdapter = {
+    search(args: CatalogSearchArgs): Promise<CatalogSearchResult>;
+    fetchFacets?(args: CatalogFacetsArgs): Promise<CatalogFacets>;
+};
+
+export declare type CatalogBadge = {
+    /** 1–4 char mono code rendered as a chip. */
+    code: string;
+    tooltip?: string;
+};
+
 export declare interface CatalogConfig {
     id: string;
     label: string;
-    adapter: ExplorerAdapter_2;
-    onSelect: (row: ExplorerRow_2) => void;
+    adapter: CatalogAdapter;
+    onSelect: (row: CatalogRow) => void;
     pluginId?: string;
 }
 
+export declare type CatalogFacetConfig = {
+    key: string;
+    label: string;
+    order?: string[];
+    formatValue?: (value: string) => string;
+};
+
+export declare type CatalogFacets = Record<string, CatalogFacetValue[]>;
+
+export declare type CatalogFacetsArgs = {
+    filters: Record<string, string[]>;
+    signal?: AbortSignal;
+};
+
+export declare type CatalogFacetValue = {
+    value: string;
+    count: number;
+};
+
 export declare interface CatalogOutput {
     type: "catalog";
     catalog: CatalogConfig;
@@ -230,6 +240,34 @@ export declare interface CatalogRegistryOptions {
     warnOnDuplicate?: boolean;
 }
 
+export declare type CatalogRow = {
+    id: string;
+    title: string;
+    subtitle?: string;
+    group?: string;
+    leading?: CatalogBadge;
+    trailing?: CatalogBadge[];
+    meta?: string;
+};
+
+export declare type CatalogSearchArgs = {
+    query: string;
+    filters: Record<string, string[]>;
+    group?: {
+        key: string;
+        value: string;
+    };
+    limit: number;
+    offset: number;
+    signal?: AbortSignal;
+};
+
+export declare type CatalogSearchResult = {
+    items: CatalogRow[];
+    total: number;
+    hasMore: boolean;
+};
+
 export declare type CausedBy = "user" | "agent" | "restore";
 
 export declare function ChatLayout(props: ChatLayoutProps): JSX.Element;
@@ -246,6 +284,7 @@ export declare interface ChatLayoutProps {
     storageKey?: string;
     onOpenNav?: () => void;
     onOpenSurface?: () => void;
+    onOpenSidebar?: () => void;
     className?: string;
 }
 
@@ -353,96 +392,6 @@ export declare function createBridge(store: StoreApi): WorkspaceBridge;
 
 export declare function createBridgeClient(options: BridgeClientOptions): BridgeClient;
 
-export declare function createDataCatalogCatalog(options: Pick<CreateDataCatalogOutputsOptions, "id" | "label" | "adapter" | "catalogId" | "catalogLabel" | "onSelect">): CatalogConfig;
-
-export declare function createDataCatalogOpenHandler(options: OpenDataCatalogVisualizationOptions): (row: ExplorerRow) => void;
-
-export declare function createDataCatalogOutputs(options: CreateDataCatalogOutputsOptions): PluginOutput[];
-
-export declare interface CreateDataCatalogOutputsOptions {
-    /**
-     * Base contribution id. Defaults catalog id to this value and left tab /
-     * visualization panel ids to derived names.
-     */
-    id?: string;
-    label?: string;
-    adapter: ExplorerAdapter;
-    facets?: FacetConfig[];
-    groupBy?: string;
-    getDragPayload?: (row: ExplorerRow) => DragPayload | null | undefined;
-    onSelect?: (row: ExplorerRow, context: DataCatalogSelectContext) => void;
-    emptyState?: ReactNode;
-    searchPlaceholder?: string;
-    pageSize?: number;
-    debounceMs?: number;
-    leftTabId?: string;
-    leftTabTitle?: string;
-    leftTabIcon?: PanelConfig["icon"];
-    includeLeftTab?: boolean;
-    catalogId?: string;
-    catalogLabel?: string;
-    includeCatalog?: boolean;
-    visualizationPanelId?: string;
-    visualizationTitle?: string;
-    visualizationIcon?: PanelConfig["icon"];
-    visualizationComponent?: ComponentType<PaneProps<DataCatalogVisualizationParams>>;
-    includeVisualizationPanel?: boolean;
-    surfaceKind?: string;
-    surfaceResolverId?: string;
-    includeSurfaceResolver?: boolean;
-    source?: PanelConfig["source"];
-}
-
-export declare function createDataCatalogPlugin(options: CreateDataCatalogPluginOptions): WorkspaceFrontPlugin;
-
-export declare interface CreateDataCatalogPluginOptions extends CreateDataCatalogOutputsOptions {
-    pluginId?: string;
-}
-
-export declare function createDataCatalogSurfaceResolver(options: CreateDataCatalogSurfaceResolverOptions): SurfaceResolverConfig;
-
-export declare interface CreateDataCatalogSurfaceResolverOptions {
-    id: string;
-    catalogId: string;
-    visualizationPanelId: string;
-    visualizationTitle: string;
-    panelIdPrefix?: string;
-    surfaceKind?: string;
-    surfaceResolverId?: string;
-    source?: string;
-}
-
-export declare function createExplorerOutputs(options: CreateExplorerOutputsOptions): PluginOutput[];
-
-export declare interface CreateExplorerOutputsOptions {
-    id: string;
-    label?: string;
-    mode?: ExplorerMode;
-    adapter?: ExplorerAdapter;
-    sectionedAdapter?: SectionedExplorerAdapter;
-    facets?: FacetConfig[];
-    groupBy?: string;
-    onActivate?: (row: ExplorerRow) => void;
-    getDragPayload?: (row: ExplorerRow) => DragPayload | null | undefined;
-    emptyState?: ReactNode;
-    searchPlaceholder?: string;
-    searchable?: boolean;
-    query?: string;
-    pageSize?: number;
-    debounceMs?: number;
-    className?: string;
-    leftTab?: false | ExplorerContributionConfig;
-    panel?: false | ExplorerContributionConfig;
-    catalog?: false | ExplorerCatalogConfig;
-    source?: PanelConfig["source"];
-}
-
-export declare function createExplorerPlugin(options: CreateExplorerPluginOptions): WorkspaceFrontPlugin;
-
-export declare interface CreateExplorerPluginOptions extends CreateExplorerOutputsOptions {
-    pluginId?: string;
-}
-
 export declare function createShadcnTheme(options?: {
     dark?: boolean;
 }): Extension[];
@@ -481,65 +430,6 @@ export declare interface CreateWorkspaceStoreOptions {
     onLayoutVersionMismatch?: () => void;
 }
 
-export declare const DATA_CATALOG_DEFAULT_TOOL_NAME = "query_data_catalog";
-
-export declare const DATA_CATALOG_PLUGIN_ID = "data-catalog";
-
-export declare const DATA_CATALOG_ROW_SURFACE_KIND = "data-catalog.open-row";
-
-export declare function dataCatalogPanelInstanceId(rowId: string, prefix?: string): string;
-
-export declare interface DataCatalogResolvedQuery {
-    query?: string;
-    controlled: boolean;
-}
-
-export declare interface DataCatalogSelectContext {
-    params?: LeftTabParams;
-    bridge?: WorkspaceBridge;
-}
-
-export declare interface DataCatalogVisualizationParams {
-    row?: ExplorerRow;
-    query?: string;
-}
-
-export declare interface DataCatalogVisualizationState extends DataCatalogResolvedQuery {
-    row?: ExplorerRow;
-    title: string;
-}
-
-export declare function DataExplorer({ adapter, facets: facetConfigs, groupBy, onActivate, getDragPayload, emptyState, searchPlaceholder, searchable, query, onQueryChange, pageSize, debounceMs, className, }: DataExplorerProps): JSX.Element;
-
-export declare type DataExplorerProps = {
-    adapter: ExplorerAdapter;
-    /** Facets shown in the toolbar popover. Adapter must implement fetchFacets for this to work. */
-    facets?: FacetConfig[];
-    /** Single grouping axis (must match a facet key). When set, renders tree mode. */
-    groupBy?: string;
-    /** Activated when a row is clicked, double-clicked, or Enter-pressed. */
-    onActivate?: (row: ExplorerRow) => void;
-    /** Returning a payload makes rows draggable. */
-    getDragPayload?: (row: ExplorerRow) => DragPayload | null | undefined;
-    /** Empty state shown when the top-level result has no rows and no query/filters. */
-    emptyState?: ReactNode;
-    searchPlaceholder?: string;
-    /** Hide the search input. Default true. */
-    searchable?: boolean;
-    /**
-     * Controlled query. When set, the toolbar's search input is hidden and the
-     * caller is responsible for supplying (and debouncing) the query value.
-     * Useful when an outer chrome already owns a search box.
-     */
-    query?: string;
-    /** Called when the toolbar search changes. Use with `query` for controlled per-tab search. */
-    onQueryChange?: (query: string) => void;
-    /** Page size and debounce — passed through to useExplorerState. */
-    pageSize?: number;
-    debounceMs?: number;
-    className?: string;
-};
-
 export declare function defineFrontPlugin(spec: WorkspaceFrontPlugin): WorkspaceFrontPlugin;
 
 /**
@@ -573,6 +463,8 @@ export declare interface DispatchContext {
     isWorkbenchOpen: () => boolean;
     /** Toggle the workbench pane open. Must be a no-op when already open. */
     openWorkbench: () => void;
+    /** Close the workbench pane when a command opened it only for an ephemeral task. */
+    closeWorkbench?: () => void;
 }
 
 export declare function DockviewShell({ layout, persistedLayout, onReady, onLayoutChange, allowedPanels, className, prefixHeaderActions, rightHeaderActions, watermarkComponent, }: DockviewShellProps): JSX.Element;
@@ -615,11 +507,6 @@ export declare interface DockviewShellProps {
     watermarkComponent?: React.FunctionComponent<unknown>;
 }
 
-export declare type DragPayload = {
-    mimeType: string;
-    value: string;
-};
-
 export declare interface DynamicPaneConfig {
     id: string;
     component: string;
@@ -680,131 +567,6 @@ export declare const expandToFileSchema: z.ZodObject<{
     path: string;
 }>;
 
-export declare const EXPLORER_PLUGIN_ID = "explorer";
-
-export declare type ExplorerAdapter = {
-    search(args: SearchArgs): Promise<SearchResult>;
-    /** Optional. When omitted, the explorer renders flat (no facet popover). */
-    fetchFacets?(args: FacetsArgs): Promise<Facets>;
-};
-
-declare type ExplorerAdapter_2 = {
-    search(args: SearchArgs_2): Promise<SearchResult_2>;
-    /** Optional. When omitted, the explorer renders flat (no facet popover). */
-    fetchFacets?(args: FacetsArgs_2): Promise<Facets_2>;
-};
-
-export declare interface ExplorerCatalogConfig {
-    id?: string;
-    label?: string;
-    onSelect?: (row: ExplorerRow) => void;
-}
-
-export declare interface ExplorerContributionConfig {
-    id?: string;
-    title?: string;
-    label?: string;
-    icon?: PanelConfig["icon"];
-}
-
-export declare type ExplorerMode = "flat" | "grouped" | "sectioned";
-
-export declare type ExplorerRow = {
-    id: string;
-    title: string;
-    /** Optional muted second line (truncates with title). */
-    subtitle?: string;
-    /** Group key — must match one of the facet values for `groupBy`. */
-    group?: string;
-    /** Leading mono chip (e.g. type code, frequency). */
-    leading?: Badge;
-    /** Trailing mono chips for status flags (e.g. [D] derived, [LIVE]). */
-    trailing?: Badge[];
-    /** Right-aligned plain text for numeric metadata (e.g. "1.2M", "2.4s"). */
-    meta?: string;
-};
-
-declare type ExplorerRow_2 = {
-    id: string;
-    title: string;
-    /** Optional muted second line (truncates with title). */
-    subtitle?: string;
-    /** Group key — must match one of the facet values for `groupBy`. */
-    group?: string;
-    /** Leading mono chip (e.g. type code, frequency). */
-    leading?: Badge_2;
-    /** Trailing mono chips for status flags (e.g. [D] derived, [LIVE]). */
-    trailing?: Badge_2[];
-    /** Right-aligned plain text for numeric metadata (e.g. "1.2M", "2.4s"). */
-    meta?: string;
-};
-
-export declare interface ExplorerSection {
-    id: string;
-    title: string;
-    subtitle?: string;
-    count?: number;
-    filters?: ExplorerSectionFilter[];
-    defaultExpanded?: boolean;
-}
-
-export declare interface ExplorerSectionFilter extends FacetConfig {
-    values?: FacetValue[];
-}
-
-export declare function ExplorerView(props: ExplorerViewProps): JSX.Element;
-
-export declare type ExplorerViewProps = (Omit<DataExplorerProps, "groupBy"> & {
-    mode?: "flat";
-    groupBy?: never;
-    sectionedAdapter?: never;
-}) | (DataExplorerProps & {
-    mode: "grouped";
-    groupBy: string;
-    sectionedAdapter?: never;
-}) | (Omit<SectionedExplorerProps, "adapter"> & {
-    mode: "sectioned";
-    adapter?: never;
-    sectionedAdapter: SectionedExplorerAdapter;
-    facets?: never;
-    groupBy?: never;
-});
-
-export declare type FacetConfig = {
-    /** Filter key sent to the adapter (e.g. "frequency"). */
-    key: string;
-    /** Display label (e.g. "Frequency"). */
-    label: string;
-    /** Explicit display order; unknown values go after in adapter order. */
-    order?: string[];
-    /** Display formatter for raw values (e.g. "M" → "Monthly"). */
-    formatValue?: (value: string) => string;
-};
-
-export declare type Facets = Record<string, FacetValue[]>;
-
-declare type Facets_2 = Record<string, FacetValue_2[]>;
-
-export declare type FacetsArgs = {
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-};
-
-declare type FacetsArgs_2 = {
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-};
-
-export declare type FacetValue = {
-    value: string;
-    count: number;
-};
-
-declare type FacetValue_2 = {
-    value: string;
-    count: number;
-};
-
 declare const FILESYSTEM_FILE_CHANGED_EVENT = "filesystem:file.changed";
 
 declare const FILESYSTEM_FILE_CREATED_EVENT = "filesystem:file.created";
@@ -975,13 +737,6 @@ export declare interface GroupConfig {
     };
 }
 
-declare type GroupState = {
-    items: ExplorerRow[];
-    total: number;
-    hasMore: boolean;
-    loading: boolean;
-};
-
 export declare function IdeLayout(props: IdeLayoutProps): JSX.Element;
 
 export declare interface IdeLayoutProps {
@@ -1077,15 +832,6 @@ export declare function onFilesystemChanged(handler: (payload: FilesystemEventMe
 
 export declare type OpenArtifactHandler = (path: string) => void;
 
-export declare function openDataCatalogVisualization(row: ExplorerRow, options: OpenDataCatalogVisualizationOptions): void;
-
-export declare interface OpenDataCatalogVisualizationOptions {
-    catalogId: string;
-    surfaceKind?: string;
-    title?: string;
-    params?: Record<string, unknown>;
-}
-
 export declare const openFileSchema: z.ZodObject<{
     path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     mode: z.ZodOptional<z.ZodEnum<["view", "edit", "diff"]>>;
@@ -1150,6 +896,19 @@ export declare type Origin = {
     toolCallId?: string;
 };
 
+export declare function PanelChrome({ title, icon: Icon, essential, children, className, panelApi, }: PanelChromeProps): JSX.Element;
+
+declare interface PanelChromeProps {
+    title: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    essential?: boolean;
+    children: ReactNode;
+    className?: string;
+    panelApi?: DockviewPanelApi;
+}
+
 export declare interface PanelConfig<T = any> {
     id: string;
     title: string;
@@ -1334,8 +1093,6 @@ export declare interface ProviderOutput {
     component: PluginProvider;
 }
 
-export declare function readDataCatalogRow(value: unknown): ExplorerRow | undefined;
-
 declare interface RegisteredPluginMeta {
     id: string;
     label?: string;
@@ -1352,12 +1109,6 @@ declare interface RegistryProviderProps {
     children: ReactNode;
 }
 
-export declare function resolveDataCatalogControlledQuery(params: LeftTabParams | DataCatalogVisualizationParams | undefined): DataCatalogResolvedQuery;
-
-export declare function resolveDataCatalogQuery(params: LeftTabParams | DataCatalogVisualizationParams | undefined): string | undefined;
-
-export declare function resolveDataCatalogVisualizationState(params: DataCatalogVisualizationParams | undefined, fallbackTitle: string): DataCatalogVisualizationState;
-
 export declare function ResponsiveDockviewShell({ layout, className, }: ResponsiveDockviewShellProps): JSX.Element;
 
 export declare interface ResponsiveDockviewShellProps {
@@ -1365,86 +1116,6 @@ export declare interface ResponsiveDockviewShellProps {
     className?: string;
 }
 
-export declare type SearchArgs = {
-    query: string;
-    filters: Record<string, string[]>;
-    /** Scope to a single group's value (only set when paginating inside a group). */
-    group?: {
-        key: string;
-        value: string;
-    };
-    limit: number;
-    offset: number;
-    signal?: AbortSignal;
-};
-
-declare type SearchArgs_2 = {
-    query: string;
-    filters: Record<string, string[]>;
-    /** Scope to a single group's value (only set when paginating inside a group). */
-    group?: {
-        key: string;
-        value: string;
-    };
-    limit: number;
-    offset: number;
-    signal?: AbortSignal;
-};
-
-export declare type SearchResult = {
-    items: ExplorerRow[];
-    /** Total count for the current scope (query + filters + optional group). */
-    total: number;
-    hasMore: boolean;
-};
-
-declare type SearchResult_2 = {
-    items: ExplorerRow_2[];
-    /** Total count for the current scope (query + filters + optional group). */
-    total: number;
-    hasMore: boolean;
-};
-
-export declare interface SectionedExplorerAdapter {
-    sections(args: SectionedExplorerSectionsArgs): Promise<ExplorerSection[]>;
-    searchSection(sectionId: string, args: SectionedExplorerSearchArgs): Promise<SearchResult>;
-    fetchSectionFacets?(sectionId: string, args: SectionedExplorerFacetArgs): Promise<Facets>;
-}
-
-export declare interface SectionedExplorerFacetArgs {
-    query: string;
-    globalFilters: Record<string, string[]>;
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-}
-
-export declare interface SectionedExplorerProps {
-    adapter: SectionedExplorerAdapter;
-    onActivate?: (row: ExplorerRow) => void;
-    getDragPayload?: (row: ExplorerRow) => DragPayload | null | undefined;
-    emptyState?: ReactNode;
-    searchPlaceholder?: string;
-    searchable?: boolean;
-    query?: string;
-    pageSize?: number;
-    className?: string;
-}
-
-export declare interface SectionedExplorerSearchArgs {
-    query: string;
-    globalFilters: Record<string, string[]>;
-    filters: Record<string, string[]>;
-    limit: number;
-    offset: number;
-    signal?: AbortSignal;
-}
-
-export declare interface SectionedExplorerSectionsArgs {
-    query: string;
-    globalFilters: Record<string, string[]>;
-    signal?: AbortSignal;
-}
-
 export declare type SerializedLayout = Parameters<DockviewApi["fromJSON"]>[0];
 
 export declare function SessionBrowser({ sessions, activeId, onSwitch, onCreate, onDelete, onClose, className, }: SessionBrowserProps): JSX.Element;
@@ -1641,6 +1312,8 @@ export declare interface ToolExecContext {
     abortSignal: AbortSignal;
     toolCallId: string;
     onUpdate?: (partial: string) => void;
+    /** Agent chat/session id executing this tool, when known. */
+    sessionId?: string;
 }
 
 export declare interface ToolResult {
@@ -1670,6 +1343,8 @@ export declare interface TopBarProps {
     className?: string;
 }
 
+export declare const UI_COMMAND_EVENT = "boring-workspace:ui-command";
+
 export declare interface UiCommand {
     v?: number;
     seq?: number;
@@ -1734,12 +1409,6 @@ export declare function useCommandRegistry(): CommandRegistry;
 
 export declare function useCommands(): readonly CommandConfig[];
 
-export declare function useDataCatalogOpenVisualization(options: OpenDataCatalogVisualizationOptions): (row: ExplorerRow) => void;
-
-export declare function useDataCatalogQuery(params: LeftTabParams | DataCatalogVisualizationParams | undefined): DataCatalogResolvedQuery;
-
-export declare function useDataCatalogVisualizationState(params: DataCatalogVisualizationParams | undefined, fallbackTitle: string): DataCatalogVisualizationState;
-
 export declare function useDirtyFiles(): Record<string, {
     panelId: string;
     savedAt: number | null;
@@ -1778,45 +1447,6 @@ export declare interface UseEditorLifecycleReturn {
  */
 export declare function useEvent<K extends keyof WorkspaceEventMap>(name: K, handler: (payload: WorkspaceEventMap[K]) => void): void;
 
-export declare function useExplorerState(options: UseExplorerStateOptions): {
-    query: string;
-    filters: Record<string, string[]>;
-    facets: Facets | null;
-    topItems: ExplorerRow[];
-    topTotal: number;
-    topHasMore: boolean;
-    loading: boolean;
-    getGroup: (value: string) => GroupState;
-    isExpanded: (value: string) => boolean;
-    setQuery: (q: string) => void;
-    toggleFilter: (key: string, value: string) => void;
-    clearFilters: () => void;
-    expandGroup: (value: string) => void;
-    collapseGroup: (value: string) => void;
-    loadMoreTop: () => void;
-    loadMoreGroup: (value: string) => void;
-};
-
-export declare type UseExplorerStateOptions = {
-    adapter: ExplorerAdapter;
-    /** Facets shown in the toolbar popover. Adapter must implement fetchFacets. */
-    facets?: FacetConfig[];
-    /** Facet key used as the single grouping axis (tree mode). */
-    groupBy?: string;
-    /** Page size for both top-level and per-group pagination. */
-    pageSize?: number;
-    /** Debounce window (ms) applied to setQuery. */
-    debounceMs?: number;
-    /**
-     * Controlled query. When set, the hook bypasses internal debounce and
-     * `setQuery` becomes a no-op — the caller owns the value (and any debounce
-     * the caller wants to apply). Searches re-run when this prop changes.
-     */
-    query?: string;
-};
-
-export declare type UseExplorerStateReturn = ReturnType<typeof useExplorerState>;
-
 export declare function useHydrationComplete(): boolean;
 
 export declare function useKeyboardShortcuts({ shortcuts, enabled }: UseKeyboardShortcutsOptions): void;
@@ -1864,6 +1494,8 @@ export declare function useThemePreference(): "light" | "dark";
 
 export declare function useViewportBreakpoint(maxWidth?: number): boolean;
 
+export declare function useWorkspaceAttention(): WorkspaceAttentionContextValue;
+
 export declare function useWorkspaceBridge(): WorkspaceBridgeContextValue;
 
 export declare function useWorkspaceChatPanel(): WorkspaceChatPanelComponent;
@@ -1916,6 +1548,27 @@ export declare interface WorkspaceActions {
     resetLayout: () => void;
 }
 
+export declare type WorkspaceAttentionBlocker = {
+    id: string;
+    reason: string;
+    surfaceKind?: string;
+    target?: string;
+    label?: string;
+    sessionId?: string;
+    actions?: WorkspaceAttentionBlockerAction[];
+};
+
+declare type WorkspaceAttentionBlockerAction = {
+    id: string;
+    label: string;
+};
+
+export declare interface WorkspaceAttentionContextValue {
+    blockers: WorkspaceAttentionBlocker[];
+    addBlocker: (blocker: WorkspaceAttentionBlocker) => void;
+    removeBlocker: (id: string) => void;
+}
+
 export declare interface WorkspaceBridge {
     getOpenPanels(): PanelState[];
     getActiveFile(): string | null;
@@ -1956,6 +1609,14 @@ export declare interface WorkspaceChatPanelProps {
     isWorkbenchOpen?: () => boolean;
     /** Opens the visible workbench surface before dispatching a command. */
     openWorkbench?: () => void;
+    /** Closes the visible workbench surface after an ephemeral command finishes. */
+    closeWorkbench?: () => void;
+    /** Generic workspace blockers that should prevent submitting new chat turns. */
+    composerBlockers?: WorkspaceAttentionBlocker[];
+    /** Called when the user presses Stop in the composer. */
+    onComposerStop?: () => void;
+    /** Called when the chat implementation wants to run an action exposed by a blocker. */
+    onComposerBlockerAction?: (blocker: WorkspaceAttentionBlocker, action: string) => void;
     [key: string]: unknown;
 }