@hachej/boring-workspace 0.1.70 → 0.1.72

package/dist/workspace.d.ts

@@ -1,2649 +1,2 @@
-import { ClassValue } from 'clsx';
-import { Component } from 'react';
-import { ComponentType } from 'react';
-import { Context } from 'react';
-import { dismissToast } from '@hachej/boring-ui-kit';
-import { DockviewApi } from 'dockview-react';
-import { DockviewPanelApi } from 'dockview-react';
-import { ErrorInfo } from 'react';
-import { Extension } from '@codemirror/state';
-import { FunctionComponentElement } from 'react';
-import { JSX } from 'react';
-import { JSXElementConstructor } from 'react';
-import { LucideIcon } from 'lucide-react';
-import { MouseEvent as MouseEvent_2 } from 'react';
-import { PersistOptions } from 'zustand/middleware';
-import { PiChatPanelProps } from '@hachej/boring-agent/front';
-import { ProviderProps } from 'react';
-import { ReactElement } from 'react';
-import { ReactNode } from 'react';
-import { ReactPortal } from 'react';
-import { StoreApi as StoreApi_3 } from 'zustand';
-import { toast } from '@hachej/boring-ui-kit';
-import { ToastApi } from '@hachej/boring-ui-kit';
-import { Toaster } from '@hachej/boring-ui-kit';
-import { ToasterProps } from '@hachej/boring-ui-kit';
-import { ToastInput } from '@hachej/boring-ui-kit';
-import { ToastRecord } from '@hachej/boring-ui-kit';
-import { ToastVariant } from '@hachej/boring-ui-kit';
-import { z } from 'zod';
-
-export declare function agentMeta(toolCallId: string): {
-    cause: "agent";
-    toolCallId: string;
-    ts: number;
-};
-
-/**
- * Structural tool contract accepted from workspace plugins and UI tool
- * factories. Kept agent-runtime-neutral so only the app integration layer
- * needs to import @hachej/boring-agent.
- */
-export declare interface AgentTool {
-    name: string;
-    description: string;
-    promptSnippet?: string;
-    readinessRequirements?: ToolReadinessRequirement[];
-    parameters: JSONSchema;
-    execute(params: Record<string, unknown>, ctx: ToolExecContext): Promise<ToolResult>;
-}
-
-export declare interface AppLeftOverlayChromeValue {
-    headerInsetStart: boolean;
-    headerInsetEnd: boolean;
-}
-
-export declare interface ArtifactPanel {
-    id: string;
-    component: string;
-    params?: Record<string, unknown>;
-}
-
-export declare function ArtifactSurfacePane({ visible, storageKey, allowedPanels, persistedLayout, onLayoutChange, onReady, prefixHeaderActions, rightHeaderActions, watermarkComponent, className, }: ArtifactSurfacePaneProps): JSX.Element | null;
-
-export declare namespace ArtifactSurfacePane {
-    var defaultAllowedPanels: string[];
-}
-
-export declare interface ArtifactSurfacePaneProps {
-    visible?: boolean;
-    storageKey?: string;
-    allowedPanels?: string[];
-    persistedLayout?: SerializedLayout;
-    onLayoutChange?: (layout: SerializedLayout) => void;
-    onReady?: (api: DockviewApi) => void;
-    prefixHeaderActions?: React.FunctionComponent<unknown>;
-    rightHeaderActions?: React.FunctionComponent<unknown>;
-    watermarkComponent?: React.FunctionComponent<unknown>;
-    className?: string;
-}
-
-export declare function bindStore(store: WorkspaceStoreApi): void;
-
-export declare function bootstrap(options: BootstrapOptions): BootstrapResult;
-
-export declare interface BootstrapOptions {
-    chatPanel: unknown;
-    plugins?: BoringFrontFactoryWithId[];
-    capturedPlugins?: CapturedFrontPlugin[];
-    defaults?: BoringFrontFactoryWithId[];
-    excludeDefaults?: string[];
-    registries: {
-        panels: PanelRegistryLike;
-        workspaceSources?: WorkspaceSourceRegistryLike;
-        commands: CommandRegistryLike;
-        catalogs: CatalogRegistryLike;
-        surfaceResolvers?: SurfaceResolverRegistryLike;
-    };
-    panelCommandRunner?: (command: BoringFrontPanelCommandRegistration) => (() => void) | undefined;
-}
-
-export declare interface BootstrapResult {
-    registered: string[];
-    plugins: CapturedFrontPlugin[];
-}
-
-declare interface BoringFrontAPI {
-    registerProvider(registration: BoringFrontProviderRegistration): void;
-    registerBinding(registration: BoringFrontBindingRegistration): void;
-    registerCatalog(registration: CatalogConfig): void;
-    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;
-}
-
-declare type BoringFrontFactory = (api: BoringFrontAPI) => void | Promise<void>;
-
-/**
- * A `BoringFrontFactory` that carries its own plugin id (and optional
- * label) as static properties. Produced by `definePlugin({ ... })` and used
- * directly by `WorkspaceProvider.plugins`.
- */
-declare type BoringFrontFactoryWithId = BoringFrontFactory & {
-    pluginId: string;
-    pluginLabel?: string;
-};
-
-declare interface BoringFrontPanelCommandRegistration {
-    id: string;
-    title: string;
-    panelId?: string;
-    run?: () => void;
-    keywords?: string[];
-    shortcut?: string;
-    when?: () => boolean;
-}
-
-declare interface BoringFrontPanelRegistration<T = unknown> {
-    id: string;
-    component: ComponentType<PaneProps<T>> | (() => Promise<{
-        default: ComponentType<PaneProps<T>>;
-    }>);
-    label?: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    placement?: PanelConfig["placement"];
-    requiresCapabilities?: string[];
-    essential?: boolean;
-    lazy?: boolean;
-    chromeless?: boolean;
-    supportsFullPage?: boolean;
-    source?: string;
-}
-
-declare interface BoringFrontProviderRegistration {
-    id: string;
-    component: PluginProvider;
-}
-
-declare interface BoringFrontSurfaceResolverRegistration {
-    id?: string;
-    kind: string;
-    title?: string;
-    description?: string;
-    targetHint?: string;
-    examples?: SurfaceResolverExample[];
-    metaSchema?: Record<string, unknown>;
-    source?: string;
-    resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
-}
-
-declare type BoringFrontToolRenderer = (part: unknown) => ReactNode;
-
-declare interface BoringFrontToolRendererRegistration {
-    id: string;
-    render: BoringFrontToolRenderer;
-}
-
-declare interface BoringFrontWorkspaceSourceRegistration<T = unknown> {
-    id: string;
-    component: ComponentType<WorkspaceSourceProps<T>> | (() => Promise<{
-        default: ComponentType<WorkspaceSourceProps<T>>;
-    }>);
-    label?: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    requiresCapabilities?: string[];
-    lazy?: boolean;
-    chromeless?: boolean;
-    defaultPanelId?: string;
-    source?: string;
-}
-
-export declare interface BridgeClient {
-    connect(): void;
-    disconnect(): void;
-    pushState(causedBy: CausedBy): void;
-}
-
-export declare interface BridgeClientOptions {
-    endpoint: string;
-    bridge: WorkspaceBridge;
-    store: StoreApi_2;
-    authToken?: string;
-    pollMode?: boolean;
-    pollInterval?: number;
-    onAuthError?: (statusCode: number) => void;
-    onVersionMismatch?: (version: number) => void;
-    onConnectionChange?: (connected: boolean) => void;
-}
-
-export declare interface BridgeEventMap {
-    "panel:opened": {
-        panelId: string;
-        params: Record<string, unknown>;
-    };
-    "panel:closed": {
-        panelId: string;
-    };
-    "panel:activated": {
-        panelId: string;
-        previousPanelId: string | null;
-    };
-    "file:opened": {
-        path: string;
-        mode: "view" | "edit" | "diff";
-        filesystem?: FilesystemId;
-    };
-    "file:saved": {
-        path: string;
-    };
-    "file:dirty": {
-        path: string;
-        dirty: boolean;
-    };
-    "sidebar:toggled": {
-        collapsed: boolean;
-    };
-    "tree:expand": {
-        path: string;
-    };
-    "notification:shown": {
-        message: string;
-        level: "info" | "warn" | "error";
-    };
-    "pane:error": {
-        panelId: string;
-        error: string;
-        stack?: string;
-    };
-}
-
-export declare function buildChatLayout(props?: ChatLayoutProps): LayoutConfig;
-
-export declare function buildFullPagePanelHref({ componentId, params, basePath }: BuildFullPagePanelHrefInput): string;
-
-export declare interface BuildFullPagePanelHrefInput {
-    componentId: string;
-    params?: Record<string, unknown>;
-    basePath: string;
-}
-
-export declare function buildIdeLayout(props?: IdeLayoutProps): LayoutConfig;
-
-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;
-}
-
-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: 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 class CatalogRegistry {
-    private catalogs;
-    private listeners;
-    private snapshotCache;
-    private warnOnDuplicate;
-    constructor(options?: CatalogRegistryOptions);
-    register(config: CatalogConfig, sourcePluginId: string): void;
-    unregister(id: string): void;
-    unregisterByPluginId(pluginId: string): void;
-    /**
-     * Atomic replace by pluginId: drop owned catalogs and register the new
-     * set in one emit. Pi parity for reload semantics.
-     *
-     * Collision policy: a new catalog id already owned by a DIFFERENT pluginId
-     * is skipped with a warning — same posture as `register`'s warnOnDuplicate
-     * but never silently overwriting another plugin's contribution.
-     */
-    replaceByPluginId(pluginId: string, catalogs: CatalogConfig[]): void;
-    list(): readonly CatalogConfig[];
-    get(id: string): CatalogConfig | undefined;
-    subscribe: (cb: () => void) => (() => void);
-    getSnapshot: () => readonly CatalogConfig[];
-    private emit;
-}
-
-export declare interface CatalogRegistryLike {
-    register(catalog: CatalogConfig, pluginId: string): void;
-}
-
-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;
-
-export declare interface ChatLayoutProps {
-    nav?: string | null;
-    navParams?: Record<string, unknown>;
-    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;
-    onCreateChatPaneAfter?: (id: string) => void;
-    onDropChatSession?: (sessionId: string) => void;
-    flashChatPaneId?: string | null;
-    surface?: string | null;
-    surfaceParams?: Record<string, unknown>;
-    /** Opaque overlay rendered over the full chat stage only (not over the workbench). */
-    chatOverlay?: ReactNode;
-    /** Called when shell chrome needs to dismiss the chat overlay before collapsing chat. */
-    onCloseChatOverlay?: () => void;
-    surfaceOverlay?: ReactNode;
-    sidebar?: string | null;
-    sidebarParams?: Record<string, unknown>;
-    storageKey?: string;
-    onOpenNav?: () => void;
-    onOpenSurface?: () => void;
-    surfaceButtonBottomOffset?: number;
-    onOpenSidebar?: () => void;
-    className?: string;
-}
-
-declare interface ChatPaneDescriptor {
-    id: string;
-    title?: string | null;
-    panel?: string;
-    params?: Record<string, unknown>;
-}
-
-export declare const closePanelSchema: z.ZodObject<{
-    id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-}, {
-    id: string;
-}>;
-
-export declare function cn(...inputs: ClassValue[]): string;
-
-export declare function CodeEditor({ content, onChange, language, readOnly, lineNumbers, wordWrap, className, }: CodeEditorProps): JSX.Element;
-
-export declare function CodeEditorPane({ params, api, className }: CodeEditorPaneProps): JSX.Element;
-
-export declare type CodeEditorPaneProps = PaneProps<{
-    path?: string;
-    filesystem?: FilesystemId;
-    mode?: "view" | "edit" | "diff";
-}>;
-
-export declare interface CodeEditorProps {
-    content: string;
-    onChange?: (content: string) => void;
-    language?: string;
-    readOnly?: boolean;
-    lineNumbers?: boolean;
-    wordWrap?: boolean;
-    className?: string;
-}
-
-export declare interface CommandConfig {
-    id: string;
-    title: string;
-    run: () => void;
-    keywords?: string[];
-    shortcut?: string;
-    when?: () => boolean;
-    pluginId?: string;
-}
-
-export declare function CommandPalette({ sessionSearch, apiBaseUrl, authHeaders }?: CommandPaletteProps): JSX.Element;
-
-export declare interface CommandPaletteProps {
-    sessionSearch?: CommandPaletteSessionSearchConfig;
-    apiBaseUrl?: string;
-    authHeaders?: Record<string, string>;
-}
-
-declare interface CommandPaletteSessionItem {
-    id: string;
-    title?: string | null;
-    updatedAt?: string | number;
-    turnCount?: number;
-}
-
-declare interface CommandPaletteSessionSearchConfig {
-    sessions: CommandPaletteSessionItem[];
-    activeId?: string | null;
-    openIds?: readonly string[];
-    search?: (sessions: readonly CommandPaletteSessionItem[], query: string) => CommandPaletteSessionItem[];
-    onSwitch: (id: string) => void;
-    onOpenAsTab: (id: string) => void;
-}
-
-export declare class CommandRegistry {
-    private commands;
-    private listeners;
-    private snapshotCache;
-    registerCommand(config: CommandConfig): void;
-    unregisterByPluginId(pluginId: string): void;
-    unregisterCommand(id: string): void;
-    /**
-     * Atomic replace by pluginId: drop owned commands and register the new
-     * set in one emit. Pi parity for reload semantics.
-     *
-     * Collision policy: a new command id already owned by a DIFFERENT pluginId
-     * is skipped with a warning — preserves cross-plugin isolation on reload.
-     */
-    replaceByPluginId(pluginId: string, commands: CommandConfig[]): void;
-    getCommand(id: string): CommandConfig | undefined;
-    getCommands(): CommandConfig[];
-    getActiveCommands(): CommandConfig[];
-    subscribe: (cb: () => void) => (() => void);
-    getSnapshot: () => readonly CommandConfig[];
-    private emit;
-}
-
-export declare interface CommandRegistryLike {
-    registerCommand(command: CommandConfig): void;
-}
-
-export declare interface CommandResult {
-    seq: number;
-    status: "ok" | "error";
-    error?: {
-        code: string;
-        message: string;
-    };
-}
-
-export declare function createBridge(store: StoreApi): WorkspaceBridge;
-
-export declare function createBridgeClient(options: BridgeClientOptions): BridgeClient;
-
-export declare function createShadcnTheme(options?: {
-    dark?: boolean;
-}): Extension[];
-
-export declare function createWorkspacePluginClient(apiBaseUrl: string, workspaceId?: string, authHeaders?: Record<string, string>): WorkspacePluginClient;
-
-export declare function createWorkspaceStore(options?: CreateWorkspaceStoreOptions): {
-    (): WorkspaceStore;
-    <U>(selector: (state: WorkspaceStore) => U): U;
-} & Omit< StoreApi_3<WorkspaceStore>, "setState" | "persist"> & {
-    setState(partial: WorkspaceStore | Partial<WorkspaceStore> | ((state: WorkspaceStore) => WorkspaceStore | Partial<WorkspaceStore>), replace?: false | undefined): unknown;
-    setState(state: WorkspaceStore | ((state: WorkspaceStore) => WorkspaceStore), replace: true): unknown;
-    persist: {
-        setOptions: (options: Partial< PersistOptions<WorkspaceStore, {
-            layout: unknown;
-            sidebar: SidebarState;
-            panelSizes: Record<string, number>;
-        }, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: WorkspaceStore) => void) => () => void;
-        onFinishHydration: (fn: (state: WorkspaceStore) => void) => () => void;
-        getOptions: () => Partial< PersistOptions<WorkspaceStore, {
-            layout: unknown;
-            sidebar: SidebarState;
-            panelSizes: Record<string, number>;
-        }, unknown>>;
-    };
-} & {
-    cleanup: () => void;
-};
-
-export declare interface CreateWorkspaceStoreOptions {
-    workspaceId?: string;
-    storageKey?: string;
-    persistenceEnabled?: boolean;
-    onLayoutVersionMismatch?: () => void;
-}
-
-declare interface DataProviderProps {
-    apiBaseUrl: string;
-    authHeaders?: Record<string, string>;
-    onAuthError?: (statusCode: number) => void;
-    timeout?: number;
-    client?: FetchClient;
-    children: ReactNode;
-}
-
-/**
- * Identity helper for type-safe panel registration. Pure runtime
- * passthrough — the value of this is forcing TypeScript to verify that
- * the registered component accepts the params shape declared on the
- * config. Without it, apps tend to widen `component` to
- * `ComponentType<PaneProps<unknown>>` and lose the link.
- *
- * ```ts
- * const editorPanel = definePanel<{ path: string }>({
- *   id: "code-editor",
- *   title: "Editor",
- *   component: CodeEditorPane, // typechecked against PaneProps<{ path: string }>
- *   placement: "center",
- * })
- * ```
- */
-export declare function definePanel<T = unknown>(config: PanelConfig<T>): PanelConfig<T>;
-
-export { dismissToast }
-
-export declare interface DispatchContext {
-    /**
-     * Imperative handle to the workbench surface. Function (getter) so a
-     * late SurfaceShell mount, or any later swap, is picked up without
-     * restarting the transport. Returns null when the surface isn't ready.
-     */
-    surface: () => SurfaceShellApi | null;
-    /** Read the current open/closed state of the workbench pane. */
-    isWorkbenchOpen: () => boolean;
-    /** Toggle the workbench pane open. Must be a no-op when already open. */
-    openWorkbench: () => void;
-    /** Open the workbench sources/file-tree pane. Must be a no-op when already open. */
-    openWorkbenchSources?: () => void;
-    /** Close the workbench pane when a command opened it only for an ephemeral task. */
-    closeWorkbench?: () => void;
-    /**
-     * Park an op that couldn't run because the surface never mounted within the
-     * retry budget (collapsed surface / warmup overlay). The host flushes parked
-     * ops when the SurfaceShell next becomes ready. Without this the op is
-     * silently dropped.
-     */
-    enqueue?: (run: (surface: SurfaceShellApi) => void) => void;
-    /** Optional host policy hook for surface requests that are only relevant in a visible/open context. */
-    shouldOpenSurface?: (request: SurfaceOpenRequest) => boolean;
-}
-
-export declare function DockviewShell({ layout, persistedLayout, onReady, onLayoutChange, allowedPanels, className, prefixHeaderActions, rightHeaderActions, watermarkComponent, }: DockviewShellProps): JSX.Element;
-
-export declare interface DockviewShellApi {
-    addPanel(groupId: string, config: {
-        id: string;
-        component: string;
-        title?: string;
-        params?: Record<string, unknown>;
-    }): void;
-    removePanel(panelId: string): void;
-    activatePanel(panelId: string): void;
-    movePanel(panelId: string, target: {
-        groupId: string;
-    } | {
-        direction: "left" | "right" | "above" | "below";
-        referencePanelId: string;
-    }): void;
-    updatePanelParams(panelId: string, params: Record<string, unknown>): void;
-    setPanelTitle(panelId: string, title: string): void;
-    findPanelsByParam(key: string, value: unknown): string[];
-    getActivePanel(): string | null;
-    toJSON(): SerializedLayout;
-}
-
-export declare interface DockviewShellProps {
-    layout: LayoutConfig;
-    persistedLayout?: SerializedLayout;
-    onReady?: (api: DockviewApi) => void;
-    onLayoutChange?: (layout: SerializedLayout) => void;
-    storageKey?: string;
-    allowedPanels?: string[];
-    className?: string;
-    /** Component rendered in the tab strip BEFORE the tabs. Useful for inline controls. */
-    prefixHeaderActions?: React.FunctionComponent<unknown>;
-    /** Component rendered in the tab strip on the far right. */
-    rightHeaderActions?: React.FunctionComponent<unknown>;
-    /** Component used as the empty-state watermark when a group has no panels. */
-    watermarkComponent?: React.FunctionComponent<unknown>;
-}
-
-export declare interface DynamicPaneConfig {
-    id: string;
-    component: string;
-    params?: Record<string, unknown>;
-    title?: string;
-}
-
-export declare interface EditorLifecycleAdapter {
-    isDirty: () => boolean;
-    save: () => Promise<void>;
-    getContent: () => string;
-}
-
-export declare function emitAgentData(part: unknown): void;
-
-export declare function emitFilesystemAgentFileChange(part: unknown): void;
-
-export declare function emitWorkspaceAttentionAction(detail: WorkspaceAttentionActionDetail): void;
-
-export declare function emitWorkspaceComposerStop(detail: WorkspaceComposerStopDetail): void;
-
-export declare function EmptyPane({ className, onOpenFile }: EmptyPaneProps): JSX.Element;
-
-export declare interface EmptyPaneProps {
-    className?: string;
-    onOpenFile?: () => void;
-}
-
-/**
- * Tiny typed event bus. ~30 lines, no runtime deps.
- *
- * Design constraints (locked by reviewer feedback in
- * `packages/workspace/docs/plans/archive/UNIFIED_EVENT_BUS.md`):
- *
- * - Synchronous emit only. Slow subscribers fire-and-forget their own async work.
- * - Snapshot listeners before iterating so subscribe / unsubscribe
- *   during dispatch is safe.
- * - One thrown listener does not stop the chain. Errors go to console.error.
- * - Bus emits transitions only — no replay-on-subscribe.
- */
-declare interface EventBus<TMap extends Record<string, any>> {
-    /** Subscribe to one event name. Returns an unsubscribe function. */
-    on<K extends keyof TMap>(name: K, fn: (payload: TMap[K]) => void): () => void;
-    /** Synchronously dispatch to every matching listener. */
-    emit<K extends keyof TMap>(name: K, payload: TMap[K]): void;
-    /** Test-only — never call from production code. Underscore-prefixed by convention. */
-    _reset(): void;
-}
-
-/** Common envelope on every payload. */
-export declare type EventMeta = Origin & {
-    ts: number;
-};
-
-export declare const events: EventBus<WorkspaceEventMap>;
-
-export declare const expandToFileSchema: z.ZodObject<{
-    path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-}, {
-    path: string;
-}>;
-
-declare class FetchClient {
-    private baseUrl;
-    private headers;
-    private onAuthError?;
-    private onTimeout?;
-    private timeout;
-    private maxRetries;
-    private retryBaseMs;
-    constructor(opts: FetchClientOptions);
-    private request;
-    getTree(path: string, signal?: AbortSignal, filesystem?: string): Promise<FileEntry[]>;
-    getFile(path: string, signal?: AbortSignal, filesystem?: string): Promise<FileContent>;
-    /**
-     * Write file content. When `expectedMtimeMs` is supplied, the server
-     * runs an optimistic-concurrency check and returns 409 if the file
-     * has been modified since that mtime — surfaced here as a typed
-     * `FileConflictError` so the editor can ask the user to reload or
-     * force-overwrite. The returned `mtimeMs` is the server's stat
-     * after the write; callers use it as the OCC baseline for the
-     * next save. Set `returnMtimeMs: false` only for writes that do
-     * not need a fresh OCC baseline (for example, creating an empty
-     * file before immediately opening/refetching it). That lets remote
-     * sandboxes skip an expensive post-write stat.
-     */
-    writeFile(path: string, content: string, opts?: {
-        expectedMtimeMs?: number;
-        returnMtimeMs?: boolean;
-        filesystem?: string;
-    }): Promise<{
-        mtimeMs?: number;
-    }>;
-    deleteFile(path: string, options?: {
-        filesystem?: string;
-    }): Promise<void>;
-    stat(path: string, signal?: AbortSignal, filesystem?: string): Promise<FileStat>;
-    getGitUrlMetadata(path: string, signal?: AbortSignal): Promise<GitUrlMetadata>;
-    search(query: string, limit?: number, signal?: AbortSignal): Promise<string[]>;
-    createDir(path: string, options?: {
-        filesystem?: string;
-    }): Promise<void>;
-    moveFile(from: string, to: string, options?: {
-        filesystem?: string;
-    }): Promise<void>;
-}
-
-declare interface FetchClientOptions {
-    apiBaseUrl: string;
-    authHeaders?: Record<string, string>;
-    onAuthError?: (statusCode: number) => void;
-    onTimeout?: (route: string) => void;
-    timeout?: number;
-    maxRetries?: number;
-    retryBaseMs?: number;
-}
-
-declare class FetchError extends Error {
-    readonly status: number;
-    readonly body?: unknown | undefined;
-    constructor(status: number, message: string, body?: unknown | undefined);
-}
-
-/**
- * Thrown by `writeFile` when the server returns 409 because the file
- * has been modified since the client's last read. Carries the
- * server's current mtime so the editor can show the user a
- * Reload-vs-Overwrite choice with the actual conflict context.
- */
-declare class FileConflictError extends Error {
-    readonly path: string;
-    readonly currentMtimeMs: number | null;
-    readonly expectedMtimeMs: number | null;
-    constructor(path: string, currentMtimeMs: number | null, expectedMtimeMs: number | null);
-    static from(err: FetchError, path: string): FileConflictError;
-}
-
-declare interface FileContent {
-    content: string;
-    /** Access granted by the resolved filesystem binding, when the server exposes it. */
-    access?: "readonly" | "readwrite";
-    /**
-     * Server-stat'd modification time. Used as the OCC baseline for the
-     * next write — the client sends it back as `expectedMtimeMs` so the
-     * server can return 409 if the file changed underneath. Optional
-     * because not every workspace impl can stat cheaply (sandbox
-     * impl is best-effort).
-     */
-    mtimeMs?: number;
-}
-
-declare interface FileEntry {
-    name: string;
-    kind: "file" | "dir";
-    path: string;
-}
-
-export declare type FileRecordsFormat = "json-array" | "ndjson" | "csv";
-
-export declare interface FileRecordsResult {
-    source: FileRecordsSource;
-    path: string;
-    format: FileRecordsFormat;
-    columns: {
-        name: string;
-        type: string;
-    }[];
-    rows: Record<string, unknown>[];
-    total: number;
-    hasMore: boolean;
-    offset: number;
-    limit: number;
-    mtimeMs?: number;
-}
-
-export declare interface FileRecordsSource {
-    kind: "file";
-    path: string;
-    format: FileRecordsFormat;
-    recordSet?: string;
-}
-
-declare interface FileStat {
-    size: number;
-    mtimeMs: number;
-    kind: "file" | "dir";
-}
-
-declare const FILESYSTEM_FILE_CHANGED_EVENT = "filesystem:file.changed";
-
-declare const FILESYSTEM_FILE_CREATED_EVENT = "filesystem:file.created";
-
-declare const FILESYSTEM_FILE_DELETED_EVENT = "filesystem:file.deleted";
-
-declare const FILESYSTEM_FILE_MOVED_EVENT = "filesystem:file.moved";
-
-export declare interface FilesystemEventMap {
-    [FILESYSTEM_FILE_MOVED_EVENT]: FilesystemEventMeta & {
-        from: string;
-        to: string;
-    };
-    [FILESYSTEM_FILE_DELETED_EVENT]: FilesystemEventMeta & {
-        path: string;
-    };
-    [FILESYSTEM_FILE_CREATED_EVENT]: FilesystemEventMeta & {
-        path: string;
-        kind: "file" | "dir";
-    };
-    [FILESYSTEM_FILE_CHANGED_EVENT]: FilesystemEventMeta & {
-        path: string;
-    };
-}
-
-export declare type FilesystemEventMeta = ({
-    cause: "user";
-} | {
-    cause: "agent";
-    toolCallId: string;
-} | {
-    cause: "remote";
-    toolCallId?: string;
-}) & {
-    ts: number;
-    filesystem?: FilesystemId;
-};
-
-export declare const filesystemEvents: {
-    readonly changed: "filesystem:file.changed";
-    readonly created: "filesystem:file.created";
-    readonly moved: "filesystem:file.moved";
-    readonly deleted: "filesystem:file.deleted";
-};
-
-declare type FilesystemId = "user" | "company_context" | (string & {});
-
-export declare const filesystemPlugin: BoringFrontFactoryWithId;
-
-export declare function FileTree({ files, selectedPath, searchQuery, height, editing, revealPath, pendingPaths, onSelect, onExpand, onCollapse, onContextMenu, onSubmitEdit, onCancelEdit, onRevealHandled, onDragDrop, className, }: FileTreeProps): JSX.Element;
-
-/**
- * The minimal slice of {@link WorkspaceBridge} a file tree needs: click-to-open
- * (`openFile`), initial selection (`getActiveFile`), reactive reveal (`select`,
- * plus optional `subscribe`). Lives here (core bridge layer) — not in the
- * filesystem plugin — so core chrome (WorkbenchLeftPane) can forward a
- * surface-backed adapter without importing a plugin module.
- */
-declare type FileTreeBridge = Pick<WorkspaceBridge, "openFile" | "getActiveFile" | "select"> & Partial<Pick<WorkspaceBridge, "subscribe">>;
-
-declare interface FileTreeEditState {
-    /** Path of the row currently being edited (rename target or draft path). */
-    path: string;
-    /** When true, treat blank/Esc as cancel-without-error (new-file/folder flow). */
-    isDraft: boolean;
-    /** Pre-filled value (for rename). */
-    initialValue?: string;
-}
-
-export declare interface FileTreeNode {
-    name: string;
-    kind: "file" | "dir";
-    path: string;
-    children?: FileTreeNode[];
-    /**
-     * Internal: marks a placeholder row used for inline new-file/new-folder
-     * input. Consumers (FileTreeView) inject this when the user starts a
-     * create action; FileTree renders an <input> instead of a name.
-     */
-    isDraft?: boolean;
-}
-
-/**
- * Default "Files" panel: `PanelChrome` + always-visible search input wired to
- * `<FileTreeView>`. Drop into a dockview registry as-is, or compose
- * `FileTreeView` directly when you want different chrome/search UX.
- */
-export declare function FileTreePane({ params, rootDir, searchQuery: controlledSearchQuery, panelApi, bridge, api, chromeless, filesystem, access, roots, className, }: FileTreePaneProps): JSX.Element;
-
-declare interface FileTreePaneParams extends LeftTabParams {
-    rootDir?: string;
-    searchQuery?: string;
-    query?: string;
-    bridge?: unknown;
-    chromeless?: boolean;
-    filesystem?: FilesystemId;
-    access?: "readonly" | "readwrite";
-    roots?: FileTreeRootConfig[];
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-}
-
-export declare interface FileTreePaneProps extends Partial<PaneProps<FileTreePaneParams>> {
-    rootDir?: string;
-    searchQuery?: string;
-    panelApi?: DockviewPanelApi;
-    bridge?: FileTreeBridge;
-    chromeless?: boolean;
-    filesystem?: FilesystemId;
-    access?: "readonly" | "readwrite";
-    roots?: FileTreeRootConfig[];
-    className?: string;
-}
-
-export declare interface FileTreeProps {
-    files: FileTreeNode[];
-    selectedPath?: string | null;
-    searchQuery?: string;
-    height?: number;
-    /** Path of the row whose name should render as an <input>. */
-    editing?: FileTreeEditState | null;
-    /** Path that should be scrolled into view, opening parent folders if needed. */
-    revealPath?: string | null;
-    /** Paths currently being mutated — render a small spinner on those rows. */
-    pendingPaths?: ReadonlySet<string>;
-    onSelect?: (path: string) => void;
-    onExpand?: (path: string) => void;
-    onCollapse?: (path: string) => void;
-    onContextMenu?: (event: React.MouseEvent, node: FileTreeNode) => void;
-    onDragDrop?: (sourcePath: string, targetDirPath: string) => void;
-    /** Called after a reveal request has opened parents and scheduled scrolling. */
-    onRevealHandled?: (path: string) => void;
-    /** Called when the user presses Enter on an inline-edit input. */
-    onSubmitEdit?: (path: string, value: string) => void;
-    /** Called when the user presses Esc or blurs without submitting. */
-    onCancelEdit?: () => void;
-    className?: string;
-}
-
-declare interface FileTreeRootConfig {
-    filesystem: FilesystemId;
-    label: string;
-    rootDir?: string;
-    access?: "readonly" | "readwrite";
-    searchPlaceholder?: string;
-}
-
-/**
- * File tree with the full workbench actions: tracks container height,
- * routes selects through `bridge.openFile`, and provides a right-click
- * context menu (new file/folder, rename, delete, copy path) plus a
- * delete-confirmation dialog.
- *
- * The chrome (PanelChrome, search input) is the consumer's responsibility.
- * `FileTreePane` (below) is the default chromed wrapper for hosts that just
- * want a "Files" panel; `WorkbenchLeftPane` uses this primitive directly to
- * share its search input with the Data tab.
- */
-export declare function FileTreeView({ rootDir, searchQuery, bridge, revealFileTreeRequest, filesystem, access, ignoreNames, className, }: FileTreeViewProps): JSX.Element;
-
-export declare interface FileTreeViewProps {
-    rootDir?: string;
-    /** Already-debounced query. Empty/undefined means no filter. */
-    searchQuery?: string;
-    bridge?: FileTreeBridge;
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-    filesystem?: FilesystemId;
-    access?: "readonly" | "readwrite";
-    /**
-     * Names (or regex patterns) to hide from the tree. Defaults to
-     * `DEFAULT_TREE_IGNORE` (node_modules, .git, dist, …). Pass `[]` to
-     * show everything; pass your own array to override entirely. Patterns
-     * match on file/folder NAME, not the full path.
-     */
-    ignoreNames?: ReadonlyArray<string | RegExp>;
-    /** Forwarded to the inner <FileTree>. */
-    className?: string;
-}
-
-export declare function formatShortcut(binding: Pick<ShortcutBinding, "key" | "mod" | "shift">): string;
-
-export declare type FrontPluginHotReloadMode = "vite" | false;
-
-export declare function getFileIcon(filename: string): LucideIcon;
-
-declare interface GitUrlMetadata {
-    enabled: boolean;
-    reason?: string;
-    url?: string;
-}
-
-export declare interface GroupConfig {
-    id: string;
-    position: "left" | "center" | "right" | "bottom";
-    panel?: string;
-    params?: Record<string, unknown>;
-    locked?: boolean;
-    hideHeader?: boolean;
-    dynamic?: boolean;
-    placeholder?: string;
-    collapsible?: boolean;
-    collapsedWidth?: number;
-    constraints?: {
-        minWidth?: number;
-        maxWidth?: number;
-        maxWidthViewportRatio?: number;
-        minHeight?: number;
-        maxHeight?: number;
-    };
-}
-
-export declare function IdeLayout(props: IdeLayoutProps): JSX.Element;
-
-export declare interface IdeLayoutProps {
-    sidebar?: string;
-    center?: string;
-    right?: string;
-    className?: string;
-}
-
-export declare function isWorkspaceComposerStopDetail(value: unknown): value is WorkspaceComposerStopDetail;
-
-export declare function isWorkspaceComposerStopReason(value: unknown): value is WorkspaceComposerStopReason;
-
-export declare type JSONSchema = Record<string, unknown>;
-
-export declare interface LayoutConfig {
-    version: string;
-    groups: GroupConfig[];
-}
-
-export declare type LeftTabComponent = ComponentType<WorkspaceSourceProps<LeftTabParams>>;
-
-export declare interface LeftTabParams {
-    rootDir?: string;
-    query?: string;
-    searchQuery?: string;
-    bridge?: unknown;
-    chromeless?: boolean;
-    /** Optional DOM target for left-tab toolbar actions owned by the pane. */
-    chromeActionsElement?: Element | null;
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-}
-
-export declare function MarkdownEditor({ content, onChange, readOnly, placeholder, className, documentPath, filesystem: rawFilesystem, }: MarkdownEditorProps): JSX.Element;
-
-export declare function MarkdownEditorPane({ params, api, className }: MarkdownEditorPaneProps): JSX.Element;
-
-export declare type MarkdownEditorPaneProps = PaneProps<{
-    path?: string;
-    filesystem?: FilesystemId;
-    mode?: "view" | "edit" | "diff";
-}>;
-
-export declare interface MarkdownEditorProps {
-    content: string;
-    onChange?: (content: string) => void;
-    readOnly?: boolean;
-    placeholder?: string;
-    className?: string;
-    /** Workspace-relative markdown file path, used to make uploaded image links relative. */
-    documentPath?: string;
-    /** Filesystem identity for relative markdown links/assets. Defaults to user. */
-    filesystem?: FilesystemId;
-}
-
-export declare const MAX_PANELS = 50;
-
-export declare const navigateToLineSchema: z.ZodObject<{
-    file: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-    line: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    line: number;
-    file: string;
-}, {
-    line: number;
-    file: string;
-}>;
-
-declare interface Notification_2 {
-    id: string;
-    message: string;
-    type: "info" | "warning" | "error";
-    timestamp: number;
-}
-export { Notification_2 as Notification }
-
-export declare const notificationSchema: z.ZodObject<{
-    msg: z.ZodString;
-    level: z.ZodOptional<z.ZodEnum<["info", "warn", "error"]>>;
-}, "strip", z.ZodTypeAny, {
-    msg: string;
-    level?: "error" | "info" | "warn" | undefined;
-}, {
-    msg: string;
-    level?: "error" | "info" | "warn" | undefined;
-}>;
-
-/** Subscribe to file-changed events. Returns the unsubscribe function. */
-export declare function onFilesystemChanged(handler: (payload: FilesystemEventMeta & {
-    path: string;
-}) => void): () => void;
-
-export declare type OpenArtifactHandler = (path: string, options?: {
-    filesystem?: FilesystemId;
-}) => void;
-
-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"]>>;
-    filesystem: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    filesystem?: string | undefined;
-    mode?: "view" | "edit" | "diff" | undefined;
-}, {
-    path: string;
-    filesystem?: string | undefined;
-    mode?: "view" | "edit" | "diff" | undefined;
-}>;
-
-export declare interface OpenPanelConfig {
-    /** Panel instance id. If a panel with this id is already open, it's re-activated instead of duplicated. */
-    id: string;
-    /** Registered component id (must match a `PanelConfig.id` in WorkspaceProvider's panel registry). */
-    component: string;
-    /** Tab title. Defaults to `id`. */
-    title?: string;
-    /** Arbitrary params passed to the pane component. */
-    params?: Record<string, unknown>;
-}
-
-export declare const openPanelSchema: z.ZodObject<{
-    id: z.ZodString;
-    component: z.ZodString;
-    params: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>, Record<string, unknown> | undefined, Record<string, unknown> | undefined>;
-    title: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    component: string;
-    title?: string | undefined;
-    params?: Record<string, unknown> | undefined;
-}, {
-    id: string;
-    component: string;
-    title?: string | undefined;
-    params?: Record<string, unknown> | undefined;
-}>;
-
-/**
- * Discriminated origin metadata. Encoded as a union (rather than a
- * flat `cause` + optional `toolCallId`) so the type system enforces
- * that agent-originated events always carry a tool call id.
- */
-export declare type Origin = {
-    cause: "user";
-} | {
-    cause: "agent";
-    toolCallId: string;
-}
-/**
-* Anything observed via the server-side fs watcher: a collaborator
-* editing the same workspace, a git pull, an external editor, the
-* agent in another tab. Carries the tool call id ONLY when the
-* server can attribute the change (sandbox emits its own writes
-* with attribution; chokidar can't). Consumers that want to
-* suppress UX side-effects on self-echo compare `actorClientId` (a
-* future field) against their own.
-*/
-| {
-    cause: "remote";
-    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;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    /** Placement hint. Public plugin placements: "workspace-page" | "shared-dockview". */
-    placement?: PanelPlacement | string;
-    requiresCapabilities?: string[];
-    essential?: boolean;
-    chromeless?: boolean;
-    supportsFullPage?: boolean;
-    /** Source: "builtin" | "app" */
-    source?: string;
-    pluginId?: string;
-    /** Revision emitted by the runtime plugin asset manager for hot-loaded panels. */
-    pluginRevision?: number;
-    /**
-     * Whether to wrap the component with React.lazy + Suspense. Omit to let
-     * the registry auto-detect: zero-arg functions (factories) are treated as
-     * lazy; components that accept a props argument are treated as eager.
-     */
-    lazy?: boolean;
-    component: ComponentType<PaneProps<T>> | (() => Promise<{
-        default: ComponentType<PaneProps<T>>;
-    }>);
-}
-
-export declare class PanelErrorBoundary extends Component<PanelErrorBoundaryProps, State_2> {
-    state: State_2;
-    static getDerivedStateFromError(error: Error): State_2;
-    componentDidCatch(error: Error, info: ErrorInfo): void;
-    handleRetry: () => void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | JSX.Element | null | undefined;
-}
-
-export declare interface PanelErrorBoundaryProps {
-    panelId: string;
-    onError?: (data: {
-        panelId: string;
-        error: string;
-        stack?: string;
-    }) => void;
-    children: ReactNode;
-}
-
-export declare interface PanelLifecycleApi {
-    panelId: string;
-    title: string;
-    setTitle(title: string): void;
-    close(): void;
-    focus(): void;
-    isActive: boolean;
-}
-
-declare type PanelPlacement = "left" | "center" | "right" | "bottom" | "shared-dockview" | "workspace-page" | "right-tab";
-
-export declare type PanelRegistration<T = any> = Omit<PanelConfig<T>, 'id'>;
-
-export declare class PanelRegistry {
-    private panels;
-    private registrationOrder;
-    private capabilities;
-    private listeners;
-    private snapshotCache;
-    private lazyComponentCache;
-    private wrapperComponentCache;
-    private generation;
-    constructor(capabilities?: Record<string, boolean>);
-    register(id: string, config: PanelRegistration): void;
-    unregister(id: string): void;
-    /**
-     * Atomic replace: unregister all panels owned by `pluginId`, then register
-     * the new set, in one emit cycle. Subscribers see exactly one intermediate
-     * state — never an empty registry between unregister and re-register.
-     *
-     * Collision policy: a new registration whose id is already owned by a
-     * DIFFERENT pluginId is skipped with a warning. Preserves cross-plugin
-     * isolation during reload — a renamed plugin can't silently steal another
-     * plugin's panel id. Teardown + rebuild as a single observable transition,
-     * driven by the front-side SSE reload subscriber.
-     */
-    replaceByPluginId(pluginId: string, panels: PanelConfig[]): void;
-    get(id: string): PanelConfig | undefined;
-    has(id: string): boolean;
-    list(): PanelConfig[];
-    listAll(): PanelConfig[];
-    getComponents(): Record<string, ComponentType<any>>;
-    subscribe: (cb: () => void) => (() => void);
-    getSnapshot: () => readonly PanelConfig[];
-    private getWrappedComponent;
-    private getLazyComponent;
-    private emit;
-    private filteredPanels;
-    private satisfiesCapabilities;
-}
-
-export declare interface PanelRegistryLike {
-    register(id: string, config: PanelRegistration): void;
-}
-
-export declare type PanelRenderMode = "dock" | "full-page";
-
-export declare interface PanelState {
-    id: string;
-    component: string;
-    params?: Record<string, unknown>;
-    groupId?: string;
-    essential?: boolean;
-}
-
-/**
- * Unified prop shape for panel components rendered inside DockviewShell.
- *
- * Structurally mirrors dockview's `IDockviewPanelProps<T>` so dockview
- * can render registered components directly — no wrapper, no field
- * renaming, no `as` casts. We re-state the shape (rather than re-export
- * dockview's type) so the workspace package owns its public contract:
- * if dockview's type ever drifts, only the wiring inside DockviewShell
- * needs to change.
- *
- * Use {@link definePanel} for type-safe registration.
- *
- * @typeParam T - Shape of the panel-specific `params` payload. Defaults
- *   to `unknown` because layouts restored from JSON are inherently
- *   un-typed at runtime; use a generic param when you control the
- *   addPanel call site, otherwise read defensively.
- */
-export declare interface PaneProps<T = unknown> {
-    /** App-supplied data for this panel instance (e.g. `{ path: string }`). */
-    params: T;
-    /** Per-panel control surface (close, setActive, setTitle, …). */
-    api: DockviewPanelApi;
-    /** Top-level dockview API (groups, addPanel, removePanel, fromJSON, …). */
-    containerApi: DockviewApi;
-    /** Optional className forwarded to the pane's root element. */
-    className?: string;
-}
-
-export declare type PluginBinding = ComponentType<unknown>;
-
-export declare interface PluginContributionError {
-    kind: "contribution";
-    pluginId: string;
-    contributionKind: "panel" | "workspace-source" | "catalog-row" | "chat-suggestion" | "app-left-action";
-    contributionId?: string;
-    error: Error;
-    componentStack?: string | null;
-}
-
-export declare class PluginError extends Error {
-    readonly kind: PluginErrorKind;
-    constructor(kind: PluginErrorKind, message: string);
-}
-
-export declare class PluginErrorBoundary extends Component<Props, State> {
-    static contextType: Context< PluginErrorContextValue | null>;
-    context: React.ContextType<typeof PluginErrorContext>;
-    state: State;
-    static getDerivedStateFromError(error: Error): State;
-    componentDidCatch(error: Error, info: ErrorInfo): void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | JSX.Element | null | undefined;
-}
-
-declare const PluginErrorContext: Context<PluginErrorContextValue | null>;
-
-declare interface PluginErrorContextValue {
-    errors: PluginContributionError[];
-    reportPluginError: (error: PluginContributionError) => void;
-}
-
-export declare type PluginErrorKind = "duplicate-id" | "validation" | "runtime";
-
-export declare function PluginErrorProvider({ children }: {
-    children: ReactNode;
-}): JSX.Element;
-
-export declare type PluginProvider = ComponentType<PluginProviderProps>;
-
-export declare interface PluginProviderProps {
-    apiBaseUrl: string;
-    authHeaders?: Record<string, string>;
-    onAuthError?: (statusCode: number) => void;
-    apiTimeout?: number;
-    activeSessionId?: string | null;
-    openSessionIds?: readonly string[];
-    children: ReactNode;
-}
-
-export declare function postUiCommand(command: UiCommand): void;
-
-declare interface Props {
-    pluginId: string;
-    contributionKind: "panel" | "workspace-source" | "catalog-row" | "chat-suggestion" | "app-left-action";
-    contributionId?: string;
-    children?: ReactNode;
-    onError?: (error: Error, info: ErrorInfo) => void;
-}
-
-export declare function readFileRecords(options: ReadFileRecordsOptions): Promise<FileRecordsResult>;
-
-export declare interface ReadFileRecordsOptions {
-    path: string;
-    recordSet?: string;
-    offset?: number;
-    limit?: number;
-    q?: string;
-    apiBaseUrl?: string;
-    headers?: Record<string, string>;
-    workspaceId?: string;
-    signal?: AbortSignal;
-}
-
-declare interface RegisteredPluginMeta {
-    id: string;
-    label?: string;
-}
-
-export declare function RegistryProvider({ panelRegistry, workspaceSourceRegistry, commandRegistry, catalogRegistry, surfaceResolverRegistry, children, }: RegistryProviderProps): JSX.Element;
-
-declare interface RegistryProviderProps {
-    panelRegistry: PanelRegistry;
-    workspaceSourceRegistry?: WorkspaceSourceRegistry;
-    commandRegistry: CommandRegistry;
-    catalogRegistry?: CatalogRegistry;
-    surfaceResolverRegistry?: SurfaceResolverRegistry;
-    children: ReactNode;
-}
-
-export declare function ResponsiveDockviewShell({ layout, className, }: ResponsiveDockviewShellProps): JSX.Element;
-
-export declare interface ResponsiveDockviewShellProps {
-    layout: LayoutConfig;
-    className?: string;
-}
-
-export declare type SerializedLayout = Parameters<DockviewApi["fromJSON"]>[0];
-
-export declare function SessionBrowser({ sessions, activeId, openIds, pinnedIds, onTogglePin, onSwitch, onOpenAsTab, onCreate, onDelete, onLoadMore, hasMore, loadingMore, onClose, className, }: SessionBrowserProps): JSX.Element;
-
-export declare interface SessionBrowserProps {
-    sessions: SessionItem[];
-    activeId?: string | null;
-    /** Session ids currently open as chat panes, in pane order. */
-    openIds?: string[];
-    /** Session ids the user pinned; surfaced in a Pinned section on top. */
-    pinnedIds?: string[];
-    onTogglePin?: (id: string) => void;
-    onSwitch?: (id: string) => void;
-    onOpenAsTab?: (id: string) => void;
-    onCreate?: () => void;
-    onDelete?: (id: string) => void;
-    onLoadMore?: () => void;
-    hasMore?: boolean;
-    loadingMore?: boolean;
-    onClose?: () => void;
-    className?: string;
-}
-
-export declare interface SessionItem {
-    id: string;
-    title: string;
-    updatedAt?: string | number;
-}
-
-export declare function SessionList({ sessions, activeId, onSwitch, onCreate, onDelete, className, }: SessionListProps): JSX.Element;
-
-export declare interface SessionListProps {
-    sessions: SessionItem[];
-    activeId?: string | null;
-    onSwitch?: (id: string) => void;
-    onCreate?: () => void;
-    onDelete?: (id: string) => void;
-    onRename?: (id: string, newTitle: string) => void;
-    className?: string;
-}
-
-export declare interface ShortcutBinding {
-    key: string;
-    mod?: boolean;
-    shift?: boolean;
-    allowInEditable?: boolean;
-    handler: () => void;
-}
-
-export declare interface SidebarState {
-    collapsed: boolean;
-    width: number;
-}
-
-declare interface State {
-    error: Error | null;
-}
-
-declare interface State_2 {
-    hasError: boolean;
-    error: Error | null;
-}
-
-declare type StoreApi = {
-    getState: () => WorkspaceStore;
-    subscribe: (listener: (state: WorkspaceStore, prev: WorkspaceStore) => void) => () => void;
-};
-
-declare type StoreApi_2 = {
-    getState: () => WorkspaceStore;
-    subscribe: (listener: (state: WorkspaceStore, prev: WorkspaceStore) => void) => () => void;
-};
-
-export declare interface SurfaceOpenRequest {
-    kind: string;
-    target: string;
-    filesystem?: FilesystemId;
-    meta?: Record<string, unknown>;
-}
-
-export declare interface SurfacePanelResolution {
-    component: string;
-    id?: string;
-    title?: string;
-    params?: Record<string, unknown>;
-    score?: number;
-}
-
-export declare interface SurfaceResolverConfig extends SurfaceResolverMetadata {
-    id: string;
-    resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | undefined;
-    source?: string;
-    pluginId?: string;
-}
-
-declare interface SurfaceResolverExample {
-    target: string;
-    label?: string;
-    meta?: Record<string, unknown>;
-}
-
-declare interface SurfaceResolverMetadata {
-    kind?: string;
-    title?: string;
-    description?: string;
-    targetHint?: string;
-    examples?: SurfaceResolverExample[];
-    metaSchema?: Record<string, unknown>;
-}
-
-export declare type SurfaceResolverRegistration = Omit<SurfaceResolverConfig, "id">;
-
-export declare class SurfaceResolverRegistry {
-    private resolvers;
-    private registrationOrder;
-    private listeners;
-    private snapshotCache;
-    register(id: string, config: SurfaceResolverRegistration): void;
-    unregister(id: string): void;
-    /**
-     * Atomic replace by pluginId: drop owned resolvers and register the new
-     * set in one emit. Pi parity for reload semantics.
-     *
-     * Collision policy: a new resolver id already owned by a DIFFERENT
-     * pluginId is skipped with a warning.
-     */
-    replaceByPluginId(pluginId: string, resolvers: SurfaceResolverConfig[]): void;
-    get(id: string): SurfaceResolverConfig | undefined;
-    has(id: string): boolean;
-    list(): SurfaceResolverConfig[];
-    resolve(request: SurfaceOpenRequest): SurfacePanelResolution | undefined;
-    subscribe: (cb: () => void) => (() => void);
-    getSnapshot: () => readonly SurfaceResolverConfig[];
-    private emit;
-}
-
-export declare interface SurfaceResolverRegistryLike {
-    register(id: string, config: SurfaceResolverRegistration): void;
-}
-
-export declare function SurfaceShell({ rootDir, sidebarDefaultWidth, sidebarMinWidth, sidebarMaxWidth, storageKey, onReady, onChange, onClose, showCloseAction, extraPanels, defaultLeftTab, onReloadAgentPlugins, initialPanels, className, }: SurfaceShellProps): JSX.Element;
-
-export declare interface SurfaceShellApi {
-    /** 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;
-    /**
-     * Open a non-file pane in the workbench. Idempotent on `id` —
-     * re-activates an existing panel with the same id rather than duplicating.
-     * Use this for app-specific panes (charts, dashboards, log viewers, …) that
-     * aren't anchored to a filesystem path.
-     */
-    openPanel: (config: OpenPanelConfig) => void;
-    /** Hide the workbench's left sources/files pane while leaving the workbench open. */
-    closeWorkbenchLeftPane: () => void;
-    /** Reveal/select a file-tree path without opening an editor pane. */
-    expandToFile: (path: string) => void;
-    /** Current snapshot of open tabs + active tab. */
-    getSnapshot: () => SurfaceShellSnapshot;
-}
-
-declare interface SurfaceShellOpenFileOptions {
-    filesystem?: FilesystemId;
-    mode?: "view" | "edit" | "diff";
-}
-
-export declare interface SurfaceShellProps {
-    rootDir?: string;
-    sidebarDefaultWidth?: number;
-    sidebarMinWidth?: number;
-    sidebarMaxWidth?: number;
-    storageKey?: string;
-    /** Called once when the surface dockview becomes ready, with an imperative handle. */
-    onReady?: (api: SurfaceShellApi) => void;
-    /** Called on every panel add/remove/active-change with the current snapshot. */
-    onChange?: (snapshot: SurfaceShellSnapshot) => void;
-    /** Optional close action for hosts that model the workbench as collapsible. */
-    onClose?: () => void;
-    /** Render the built-in top-right close affordance. Hosts can set false when they provide their own chrome. */
-    showCloseAction?: boolean;
-    /**
-     * Extra panel ids (registered via WorkspaceProvider's `panels` prop) that
-     * this workbench is allowed to render. Defaults to the built-in
-     * editor/viewer panels only. Pass app-specific pane ids here so calls
-     * like `surface.openPanel({ component: "chart-canvas" })` actually
-     * instantiate — without this, dockview's components map filters them
-     * out and you get an empty tab. Two-layer defense: SurfaceShell.openPanel
-     * validates against the registry (loud throw on unknown), AND the
-     * dockview allowlist below filters which registered panels can mount
-     * inside THIS surface (so a host can gate panels per shell instance).
-     */
-    extraPanels?: string[];
-    defaultLeftTab?: string;
-    onReloadAgentPlugins?: () => void | Promise<unknown>;
-    initialPanels?: Array<{
-        id: string;
-        component: string;
-        title?: string;
-        params?: Record<string, unknown>;
-    }>;
-    className?: string;
-}
-
-export declare interface SurfaceShellSnapshot {
-    openTabs: SurfaceShellTab[];
-    activeTab: string | null;
-}
-
-export declare interface SurfaceShellTab {
-    id: string;
-    /** Registered panel component id for this tab. May differ from the tab instance id. */
-    component?: string;
-    title: string;
-    params?: Record<string, unknown>;
-}
-
-export declare function ThemeProvider({ children, defaultTheme, onThemeChange }: ThemeProviderProps): JSX.Element;
-
-export declare interface ThemeProviderProps {
-    children: ReactNode;
-    defaultTheme?: "light" | "dark";
-    onThemeChange?: (theme: "light" | "dark") => void;
-}
-
-export { toast }
-
-export { ToastApi }
-
-export { Toaster }
-
-export { ToasterProps }
-
-export { ToastInput }
-
-export { ToastRecord }
-
-export { ToastVariant }
-
-export declare interface ToolExecContext {
-    abortSignal: AbortSignal;
-    toolCallId: string;
-    onUpdate?: (partial: string) => void;
-    /** Agent chat/session id executing this tool, when known. */
-    sessionId?: string;
-}
-
-declare type ToolReadinessRequirement = 'workspace-fs' | 'sandbox-exec' | 'ui-bridge' | 'runtime-dependencies' | `runtime:${string}`;
-
-export declare interface ToolResult {
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-    isError?: boolean;
-    details?: unknown;
-}
-
-export declare function TopBar({ appTitle, sessionTitle, onCommandPalette, onNewChat, topBarLeft, topBarRight, className, }: TopBarProps): JSX.Element;
-
-export declare interface TopBarProps {
-    appTitle?: string;
-    sessionTitle?: string;
-    onCommandPalette?: () => void;
-    onNewChat?: () => void;
-    /** Override the brand/title block on the left. Hosts pass workspace
-     *  switchers, breadcrumbs, etc. here. When set, the default
-     *  `[B] appTitle / sessionTitle` block is replaced entirely. */
-    topBarLeft?: ReactNode;
-    /** Override the avatar on the right. The new-chat (+) button stays —
-     *  it's session-mechanic, not host chrome. Hosts pass theme toggles,
-     *  user menus, etc. here. */
-    topBarRight?: ReactNode;
-    className?: string;
-}
-
-export declare const UI_COMMAND_EVENT = "boring-workspace:ui-command";
-
-export declare interface UiCommand {
-    v?: number;
-    seq?: number;
-    kind: string;
-    params: Record<string, unknown>;
-}
-
-export declare interface UIStatePut {
-    v: 1;
-    causedBy: CausedBy;
-    openPanels: PanelState[];
-    activePanel: string | null;
-    activeFile: string | null;
-    visibleFiles: string[];
-    dirtyFiles: string[];
-}
-
-export declare type Unsubscribe = () => void;
-
-export declare function useActiveFile(): string | null;
-
-export declare function useActivePanel(): string | null;
-
-export declare function useActivePanels(): readonly PanelConfig[];
-
-export declare function useApiBaseUrl(): string;
-
-export declare function useAppLeftOverlayChrome(): AppLeftOverlayChromeValue;
-
-export declare function useArtifactPanels(surfaceApi: DockviewShellApi | null): UseArtifactPanelsReturn;
-
-export declare interface UseArtifactPanelsReturn {
-    panels: ArtifactPanel[];
-    open: (panel: ArtifactPanel) => void;
-    close: (panelId: string) => void;
-    activate: (panelId: string) => void;
-    isOpen: (panelId: string) => boolean;
-}
-
-export declare function useArtifactRouting(artifactPanels: UseArtifactPanelsReturn, opts?: UseArtifactRoutingOptions): UseArtifactRoutingReturn;
-
-export declare interface UseArtifactRoutingOptions {
-    toolPanelMap?: Record<string, string>;
-}
-
-export declare interface UseArtifactRoutingReturn {
-    openForTool: (toolName: string, params: {
-        path: string;
-        [key: string]: unknown;
-    }) => void;
-    resolvePanel: (toolName: string) => string | undefined;
-}
-
-export declare function useAutoOpenAgentFiles(onOpen: (path: string) => void, options?: UseAutoOpenAgentFilesOptions): void;
-
-export declare interface UseAutoOpenAgentFilesOptions {
-    skip?: (path: string) => boolean;
-    filesOnly?: boolean;
-}
-
-export declare function useCatalogRegistry(): CatalogRegistry;
-
-export declare function useCatalogs(): readonly CatalogConfig[];
-
-export declare function useCommandRegistry(): CommandRegistry;
-
-export declare function useCommands(): readonly CommandConfig[];
-
-export declare function useDirtyFiles(): Record<string, {
-    panelId: string;
-    savedAt: number | null;
-}>;
-
-export declare function useDockviewApi(): DockviewShellApi;
-
-export declare function useEditorLifecycle(path: string | null, opts: UseEditorLifecycleOptions): UseEditorLifecycleReturn;
-
-export declare interface UseEditorLifecycleOptions {
-    adapter: EditorLifecycleAdapter | null;
-    panelId: string;
-    onDirtyChange?: (path: string, dirty: boolean) => void;
-    serverMtime?: number | null;
-}
-
-export declare interface UseEditorLifecycleReturn {
-    isDirty: boolean;
-    isSaving: boolean;
-    lastSavedAt: number | null;
-    markDirty: () => void;
-    markClean: () => void;
-    flushSave: () => Promise<void>;
-    shouldSync: boolean;
-    ackSync: () => void;
-    /** True when the file was modified externally while the editor has unsaved changes. */
-    externalChangeWhileDirty: boolean;
-    ackExternalChange: () => void;
-    /** Call after a successful save with the mtime the server returned. */
-    notifySaved: (mtime: number) => void;
-}
-
-/**
- * React hook: subscribe to a workspace event for the lifetime of the
- * component. The handler ref is stable across renders so changing the
- * handler doesn't tear down and re-subscribe.
- */
-export declare function useEvent<K extends keyof WorkspaceEventMap>(name: K, handler: (payload: WorkspaceEventMap[K]) => void): void;
-
-/**
- * Shared hook for file-based panes (code editor, markdown editor, etc.).
- *
- * Handles:
- * - File loading via React Query
- * - Local content state with dirty tracking
- * - Optimistic concurrency control (OCC) via mtime
- * - External file change detection
- * - Conflict resolution (reload vs overwrite)
- * - Panel title updates with dirty indicator
- *
- * @example
- * ```typescript
- * function MyEditorPane({ params, api }) {
- *   const { content, setContent, isLoading, error, conflict, ... } = useFilePane({
- *     path: params.path,
- *     panelId: api.id,
- *   })
- *
- *   if (!params.path) return <NoFileSelected />
- *   if (error) return <ErrorBanner error={error} />
- *
- *   return (
- *     <>
- *       {conflict && <ConflictBanner onReload={onReloadFromServer} onOverwrite={onOverwrite} />}
- *       <MyEditor content={content} onChange={setContent} />
- *     </>
- *   )
- * }
- * ```
- */
-export declare function useFilePane(options: UseFilePaneOptions): UseFilePaneReturn;
-
-export declare interface UseFilePaneOptions {
-    /** The file path to load/edit. If empty/undefined, pane shows "no file selected". */
-    path: string;
-    /** Filesystem identity for cache/dirty/stale separation. Defaults to user. */
-    filesystem?: FilesystemId;
-    /** Unique panel ID for lifecycle tracking. Omit to use a stable per-pane fallback ID. */
-    panelId?: string;
-    /** Initial content (optional, for draft/unsaved files). */
-    initialContent?: string;
-    /** When supplied, auto-create the file with this content if it does not exist. */
-    createIfMissing?: string;
-}
-
-export declare interface UseFilePaneReturn {
-    isLoading: boolean;
-    error: Error | null;
-    content: string | null;
-    isDirty: boolean;
-    isReadonly: boolean;
-    conflict: FileConflictError | null;
-    onReloadFromServer: () => Promise<void>;
-    onOverwrite: () => Promise<void>;
-    setContent: (content: string) => void;
-    save: () => Promise<void>;
-    flushSave: () => Promise<void>;
-    fileName: string;
-    tabTitle: string;
-}
-
-export declare function useFullPagePanelHref(input: {
-    componentId: string;
-    params?: Record<string, unknown>;
-}): string | null;
-
-export declare function useHasWorkspaceFilesProvider(): boolean;
-
-export declare function useHydrationComplete(): boolean;
-
-export declare function useIsFullPagePanel(): boolean;
-
-export declare function useKeyboardShortcuts({ shortcuts, enabled }: UseKeyboardShortcutsOptions): void;
-
-export declare interface UseKeyboardShortcutsOptions {
-    shortcuts: ShortcutBinding[];
-    enabled?: boolean;
-}
-
-export declare function useOpenPanels(): PanelState[];
-
-export declare function usePanelRenderMode(): PanelRenderMode;
-
-export declare function usePluginErrors(): PluginErrorContextValue;
-
-export declare function useRegistry(): PanelRegistry;
-
-export declare function useResetLayout(): () => void;
-
-export declare function useResponsiveSidebarCollapse({ isNarrowViewport, isCollapsed, setCollapsed, }: UseResponsiveSidebarCollapseOptions): () => void;
-
-export declare interface UseResponsiveSidebarCollapseOptions {
-    isNarrowViewport: boolean;
-    isCollapsed: boolean;
-    setCollapsed: (collapsed: boolean) => void;
-}
-
-/** Helper for emitting a user-originated event payload. */
-export declare function userMeta(): {
-    cause: "user";
-    ts: number;
-};
-
-export declare function useSetSidebar(): (sidebar: Partial< SidebarState>) => void;
-
-export declare function useSidebarState(): SidebarState;
-
-export declare function useSurfaceResolverRegistry(): SurfaceResolverRegistry;
-
-export declare function useTheme(): {
-    theme: "light" | "dark";
-    setTheme: (theme: "light" | "dark") => void;
-    toggleTheme: () => void;
-};
-
-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;
-
-export declare function useWorkspaceContext(): WorkspaceContextValue;
-
-export declare function useWorkspaceContextOptional(): WorkspaceContextValue | null;
-
-export declare function useWorkspaceLeftPaneActions(options?: UseWorkspaceLeftPaneActionsOptions): WorkspaceLeftPaneAction[];
-
-export declare interface UseWorkspaceLeftPaneActionsOptions {
-    defaultTab?: WorkbenchLeftTabId;
-    activeTab?: WorkbenchLeftTabId;
-    activePanelId?: string | null;
-    onActiveTabChange?: (tab: WorkbenchLeftTabId) => void;
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-    onOpenPanel?: (config: WorkspaceLeftPaneOpenPanelConfig) => void;
-    onReloadAgentPlugins?: () => void | Promise<unknown>;
-    onExpand?: (tab?: WorkbenchLeftTabId) => void;
-    onCloseSourcePane?: () => void;
-    railOnly?: boolean;
-}
-
-export declare function useWorkspacePluginClient(): WorkspacePluginClient;
-
-export declare function useWorkspaceRequestId(): string | null;
-
-export declare function useWorkspaceShellCapabilities(): WorkspaceShellCapabilities;
-
-export declare function useWorkspaceSourceRegistry(): WorkspaceSourceRegistry;
-
-export declare function WorkbenchLeftPane({ rootDir, bridge, defaultTab, activeTab: controlledActiveTab, activePanelId, onActiveTabChange, revealFileTreeRequest, onOpenPanel, onReloadAgentPlugins, onCollapse, onExpand, onCloseSourcePane, railOnly, className, }: WorkbenchLeftPaneProps): JSX.Element;
-
-export declare interface WorkbenchLeftPaneProps {
-    rootDir?: string;
-    bridge?: FileTreeBridge;
-    defaultTab?: WorkbenchLeftTabId;
-    activeTab?: WorkbenchLeftTabId;
-    /**
-     * Id of the currently-focused surface tab (dockview's active panel). Drives the
-     * accent for "workspace-page" rail icons so a page only glows while it's the open
-     * tab — `activeTab` is the rail's own click state and goes stale on tab switches.
-     */
-    activePanelId?: string | null;
-    onActiveTabChange?: (tab: WorkbenchLeftTabId) => void;
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-    onOpenPanel?: (config: WorkspaceLeftPaneOpenPanelConfig) => void;
-    onReloadAgentPlugins?: () => void | Promise<unknown>;
-    onCollapse?: () => void;
-    onExpand?: (tab?: WorkbenchLeftTabId) => void;
-    onCloseSourcePane?: () => void;
-    railOnly?: boolean;
-    className?: string;
-}
-
-export declare type WorkbenchLeftTabId = string;
-
-declare const WORKSPACE_AGENT_DATA_EVENT = "workspace:agent.data";
-
-export declare const WORKSPACE_ATTENTION_ACTION_EVENT: "boring-workspace:attention-action";
-
-export declare const WORKSPACE_COMPOSER_STOP_EVENT: "boring:workspace-composer-stop";
-
-export declare const WORKSPACE_COMPOSER_STOP_REASONS: {
-    readonly sessionSwitch: "session-switch";
-    readonly userStop: "user-stop";
-};
-
-declare const WORKSPACE_EDITOR_SAVE_END_EVENT = "workspace:editor.save.end";
-
-declare const WORKSPACE_EDITOR_SAVE_START_EVENT = "workspace:editor.save.start";
-
-export declare const WORKSPACE_OPEN_PATH_SURFACE_KIND = "workspace.open.path";
-
-declare const WORKSPACE_PANEL_CLOSE_EVENT = "workspace:panel.close";
-
-declare const WORKSPACE_PANEL_UPDATE_EVENT = "workspace:panel.update";
-
-export declare const WORKSPACE_SURFACE_OPEN_SKIPPED_EVENT = "boring-workspace:surface-open-skipped";
-
-declare const WORKSPACE_UI_COMMAND_EVENT = "workspace:ui.command";
-
-export declare interface WorkspaceActions {
-    setHydrationComplete: (complete: boolean) => void;
-    setLayout: (layout: unknown) => void;
-    setSidebar: (sidebar: Partial<SidebarState>) => void;
-    setPanelSize: (panelId: string, size: number) => void;
-    setTheme: (theme: "light" | "dark") => void;
-    openPanel: (panel: PanelState) => void;
-    closePanel: (panelId: string) => void;
-    activatePanel: (panelId: string) => void;
-    openFile: (file: string, panelId?: string) => void;
-    markDirty: (file: string, panelId: string) => void;
-    markClean: (file: string) => void;
-    showNotification: (notification: Omit<Notification_2, "id" | "timestamp">) => void;
-    dismissNotification: (id: string) => void;
-    navigateToLine: (file: string, line: number) => void;
-    resetLayout: () => void;
-}
-
-export declare type WorkspaceAttentionActionDetail = {
-    blockerId: string;
-    actionId: string;
-    blocker: WorkspaceAttentionBlocker;
-    sessionId?: string;
-};
-
-export declare type WorkspaceAttentionBlocker = {
-    id: string;
-    /** Plugin/domain-specific reason, e.g. "ask-user.question" or "pr-review.review". */
-    reason: string;
-    surfaceKind?: string;
-    target?: string;
-    label?: string;
-    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[];
-};
-
-export declare type WorkspaceAttentionBlockerAction = {
-    id: string;
-    label: string;
-};
-
-export declare interface WorkspaceAttentionContextValue {
-    blockers: WorkspaceAttentionBlocker[];
-    addBlocker: (blocker: WorkspaceAttentionBlocker) => void;
-    removeBlocker: (id: string) => void;
-}
-
-export 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;
-};
-
-export declare type WorkspaceAttentionProviderProps = {
-    children: ReactNode;
-    /** Authoritative set of existing chat sessions. Blockers that opt into pruning outside this set are stale and removed. */
-    knownSessionIds?: readonly string[];
-    /** Keep false while sessions are still loading/paginated so valid blockers are not pruned early. */
-    knownSessionsAuthoritative?: boolean;
-};
-
-export declare type WorkspaceAttentionSessionBadge = {
-    /** Stable badge kind for data attributes and plugin-specific styling hooks. */
-    kind: string;
-    /** Short text rendered on the session row, e.g. "question", "review", "approval". */
-    label: string;
-    /** Visual tone only; semantics are owned by the plugin-specific kind/reason. */
-    tone?: "attention" | "danger" | "neutral" | "warning";
-    /** Higher priority wins when several plugins mark the same session. */
-    priority?: number;
-};
-
-export declare function workspaceAttentionSessionBadgeForBlocker(blocker: Pick<WorkspaceAttentionBlocker, "reason" | "sessionBadge">): WorkspaceAttentionSessionBadge | null;
-
-export declare interface WorkspaceBridge {
-    getOpenPanels(): PanelState[];
-    getActiveFile(): string | null;
-    getDirtyFiles(): string[];
-    getVisibleFiles(): string[];
-    openFile(path: string, opts?: {
-        mode?: "view" | "edit" | "diff";
-        filesystem?: FilesystemId;
-    }): Promise<CommandResult>;
-    openPanel(config: DynamicPaneConfig): Promise<CommandResult>;
-    closePanel(id: string): Promise<CommandResult>;
-    closeWorkbenchLeftPane(): Promise<CommandResult>;
-    showNotification(msg: string, level?: "info" | "warn" | "error"): Promise<CommandResult>;
-    navigateToLine(file: string, line: number): Promise<CommandResult>;
-    expandToFile(path: string): Promise<CommandResult>;
-    markDirty(path: string): void;
-    markClean(path: string): void;
-    subscribe<K extends keyof BridgeEventMap>(event: K, handler: (data: BridgeEventMap[K]) => void): Unsubscribe;
-    select<T>(selector: (state: WorkspaceState) => T, handler: (value: T) => void): Unsubscribe;
-}
-
-export declare interface WorkspaceBridgeContextValue {
-    connected: boolean;
-}
-
-export declare type WorkspaceChatPanelComponent = ComponentType<any>;
-
-export 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. */
-    getSurface?: () => SurfaceShellApi | null;
-    /** Reads whether the visible workbench surface should be open. */
-    isWorkbenchOpen?: () => boolean;
-    /** Opens the visible workbench surface before dispatching a command. */
-    openWorkbench?: () => void;
-    /** Opens the visible workbench sources/file-tree pane before dispatching a reveal. */
-    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 workspaceComposerStopAppliesToSession(detail: unknown, sessionId: string, options?: WorkspaceComposerStopMatchOptions): boolean;
-
-export declare type WorkspaceComposerStopDetail = {
-    sessionId?: string;
-    reason: WorkspaceComposerStopReason;
-};
-
-export declare type WorkspaceComposerStopMatchOptions = {
-    fallbackSessionId?: string | null;
-    ignoredReasons?: readonly WorkspaceComposerStopReason[];
-};
-
-export declare type WorkspaceComposerStopReason = typeof WORKSPACE_COMPOSER_STOP_REASONS[keyof typeof WORKSPACE_COMPOSER_STOP_REASONS];
-
-export declare function workspaceComposerStopTargetSessionId(detail: unknown, fallbackSessionId?: string | null): string | undefined;
-
-export declare interface WorkspaceContextValue {
-    chatPanel: WorkspaceChatPanelComponent | null;
-    registeredPlugins: RegisteredPluginMeta[];
-    workspaceId?: string;
-    debug: boolean;
-}
-
-export declare interface WorkspaceEventMap extends WorkspaceHostEventMap, WorkspacePluginEventMap {
-}
-
-/** Names that share a prefix can be filtered with `startsWith`. */
-export declare type WorkspaceEventName = keyof WorkspaceEventMap;
-
-export declare const workspaceEvents: {
-    readonly uiCommand: "workspace:ui.command";
-    readonly editorSaveStart: "workspace:editor.save.start";
-    readonly editorSaveEnd: "workspace:editor.save.end";
-    readonly panelUpdate: "workspace:panel.update";
-    readonly panelClose: "workspace:panel.close";
-    readonly agentData: "workspace:agent.data";
-};
-
-export declare function WorkspaceFilesProvider({ apiBaseUrl, authHeaders, onAuthError, timeout, client: providedClient, children, }: DataProviderProps): JSX.Element;
-
-declare interface WorkspaceHostEventMap {
-    /** Shared UI manipulation contract used by the agent stream and plugin bindings. */
-    [WORKSPACE_UI_COMMAND_EVENT]: EventMeta & {
-        command: UiCommand;
-    };
-    [WORKSPACE_EDITOR_SAVE_START_EVENT]: {
-        panelId: string;
-    };
-    [WORKSPACE_EDITOR_SAVE_END_EVENT]: {
-        panelId: string;
-        ok?: boolean;
-        error?: string;
-    };
-    [WORKSPACE_PANEL_UPDATE_EVENT]: EventMeta & {
-        match: WorkspacePanelMatch | WorkspacePanelMatch[];
-        params?: Record<string, unknown>;
-        title?: string;
-    };
-    [WORKSPACE_PANEL_CLOSE_EVENT]: EventMeta & {
-        match: WorkspacePanelMatch | WorkspacePanelMatch[];
-    };
-    /**
-     * Raw agent stream data observed by ChatPanelHost. Core treats this as an
-     * opaque packet; plugins translate packets they understand into their own
-     * plugin-keyed events.
-     */
-    [WORKSPACE_AGENT_DATA_EVENT]: {
-        ts: number;
-        part: unknown;
-    };
-}
-
-export declare interface WorkspaceLeftPaneAction {
-    id: WorkbenchLeftTabId;
-    title: string;
-    icon: ReactNode;
-    kind: "source" | "workspace-page";
-    active: boolean;
-    select: () => void;
-    reloadAgentPlugins?: () => void | Promise<unknown>;
-}
-
-export declare interface WorkspaceLeftPaneOpenPanelConfig {
-    id: string;
-    component: string;
-    title?: string;
-    params?: Record<string, unknown>;
-}
-
-export declare function WorkspaceLink({ to, children, className, title, href, onClick }: WorkspaceLinkProps): ReactElement;
-
-export declare function workspaceLinkCommand(to: WorkspaceLinkTarget): UiCommand;
-
-export declare function workspaceLinkHref(to: WorkspaceLinkTarget): string;
-
-export declare interface WorkspaceLinkProps {
-    to: WorkspaceLinkTarget;
-    children: ReactNode;
-    className?: string;
-    title?: string;
-    href?: string;
-    onClick?: (event: MouseEvent_2<HTMLAnchorElement>) => void;
-}
-
-export declare type WorkspaceLinkTarget = {
-    kind: "openFile";
-    path: string;
-    mode?: "view" | "edit" | "diff";
-    filesystem?: FilesystemId;
-} | {
-    kind: "openSurface";
-    surfaceKind: string;
-    target: string;
-    filesystem?: FilesystemId;
-    meta?: Record<string, unknown>;
-} | {
-    kind: "openPanel";
-    id: string;
-    component: string;
-    title?: string;
-    params?: Record<string, unknown>;
-} | {
-    kind: "expandToFile";
-    path: string;
-};
-
-export declare function WorkspaceLoadingState({ title, description, status, fullscreen, className, }: WorkspaceLoadingStateProps): JSX.Element;
-
-export declare interface WorkspaceLoadingStateProps {
-    title?: string;
-    description?: string;
-    status?: string;
-    fullscreen?: boolean;
-    className?: string;
-}
-
-declare type WorkspacePanelMatch = {
-    id: string;
-} | {
-    param: string;
-    value: unknown;
-} | {
-    params: Record<string, unknown>;
-} | {
-    paramPrefix: string;
-    value: string;
-    params?: Record<string, unknown>;
-};
-
-export declare interface WorkspacePluginClient {
-    apiBaseUrl: string;
-    workspaceId?: string;
-    workspaceHeaders(): Record<string, string>;
-    getJson<T = unknown>(path: string, options?: {
-        missingMessage?: string;
-    }): Promise<T>;
-    readJsonFile<T>(path: string, options?: {
-        missingMessage?: string;
-    }): Promise<T>;
-    postJson<T = unknown>(path: string, body?: unknown, options?: {
-        headers?: Record<string, string>;
-    }): Promise<T>;
-    sendAgentPrompt(message: string, options?: {
-        title?: string;
-        noncePrefix?: string;
-    }): Promise<void>;
-}
-
-export declare function WorkspacePluginClientProvider({ apiBaseUrl, workspaceId, authHeaders, children, }: WorkspacePluginClientProviderProps): FunctionComponentElement<ProviderProps<WorkspacePluginClient | null>>;
-
-declare interface WorkspacePluginClientProviderProps {
-    apiBaseUrl: string;
-    workspaceId?: string;
-    authHeaders?: Record<string, string>;
-    children: ReactNode;
-}
-
-/**
- * Built-in plugin events baked into the public workspace event map.
- *
- * Filesystem events are declared inline (using EventMeta which is structurally
- * identical to FilesystemEventMeta) so the keys survive vite's rollupTypes
- * bundling without importing plugin-domain modules.
- *
- * Third-party plugins can extend this interface via declare module augmentation,
- * though that only works in source compilation — it does not survive dist bundling.
- */
-export declare interface WorkspacePluginEventMap {
-    "filesystem:file.changed": EventMeta & {
-        filesystem?: FilesystemId;
-        path: string;
-    };
-    "filesystem:file.created": EventMeta & {
-        filesystem?: FilesystemId;
-        path: string;
-        kind: "file" | "dir";
-    };
-    "filesystem:file.moved": EventMeta & {
-        filesystem?: FilesystemId;
-        from: string;
-        to: string;
-    };
-    "filesystem:file.deleted": EventMeta & {
-        filesystem?: FilesystemId;
-        path: string;
-    };
-}
-
-export declare function WorkspaceProvider({ children, chatPanel, plugins, capturedPlugins, excludeDefaults, panels, commands, catalogs, capabilities, apiBaseUrl, authHeaders, apiTimeout, activeSessionId, openSessionIds, attentionSessionIds, attentionSessionsAuthoritative, defaultTheme, onThemeChange, workspaceId, workspaceLabel, appTitle, storageKey, persistenceEnabled, manageDocumentTitle, bridgeEndpoint, onAuthError, onOpenFile, debug, frontPluginHotReload, fullPageBasePath, commandPaletteSessionSearch, }: WorkspaceProviderProps): JSX.Element;
-
-export declare interface WorkspaceProviderProps {
-    children: ReactNode;
-    chatPanel?: WorkspaceChatPanelComponent;
-    /**
-     * Front plugin entries produced by `definePlugin({ id, ... })` from
-     * `@hachej/boring-workspace/plugin`.
-     */
-    plugins?: BoringFrontFactoryWithId[];
-    capturedPlugins?: CapturedFrontPlugin[];
-    excludeDefaults?: string[];
-    panels?: PanelConfig[];
-    commands?: CommandConfig[];
-    catalogs?: CatalogConfig[];
-    capabilities?: Record<string, boolean>;
-    apiBaseUrl?: string;
-    authHeaders?: Record<string, string>;
-    /** Per-request timeout for the data layer's FetchClient, in ms. */
-    apiTimeout?: number;
-    /** Active chat/session scope shared with plugin providers that need session-scoped data. */
-    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;
-    workspaceLabel?: string;
-    appTitle?: string;
-    storageKey?: string;
-    persistenceEnabled?: boolean;
-    manageDocumentTitle?: boolean;
-    bridgeEndpoint?: string | null;
-    onAuthError?: (statusCode: number) => void;
-    onOpenFile?: (path: string) => void;
-    debug?: boolean;
-    /**
-     * Hot-load dynamically discovered front plugin modules. The current
-     * implementation relies on Vite's /@fs transform endpoint, so it defaults to
-     * dev-only. Production hosts should keep this false until they provide their
-     * own module asset endpoint.
-     */
-    frontPluginHotReload?: FrontPluginHotReloadMode;
-    fullPageBasePath?: string;
-    commandPaletteSessionSearch?: CommandPaletteSessionSearchConfig;
-}
-
-export declare interface WorkspaceShellAnchorRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
-
-export declare type WorkspaceShellArtifactTarget = {
-    type: "surface";
-    surfaceKind: string;
-    target?: string;
-    params?: Record<string, unknown>;
-} | {
-    type: "panel";
-    panelComponentId: string;
-    params?: Record<string, unknown>;
-};
-
-export declare interface WorkspaceShellCapabilities {
-    openArtifact(target: WorkspaceShellArtifactTarget | null, options?: {
-        sessionId?: string | null;
-        title?: string;
-        instanceId?: string;
-    }): WorkspaceShellCapabilityResult;
-    openDetachedChat(sessionId: string, options?: {
-        anchor?: WorkspaceShellAnchorRect;
-        title?: string;
-    }): WorkspaceShellCapabilityResult;
-}
-
-export declare type WorkspaceShellCapabilityResult = {
-    success: true;
-} | {
-    success: false;
-    reason: "no-artifact" | "open-failed" | "invalid-session" | "placement-failed";
-    message: string;
-};
-
-export declare interface WorkspaceSourceConfig<T = any> {
-    id: string;
-    title: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    component: ComponentType<WorkspaceSourceProps<T>> | (() => Promise<{
-        default: ComponentType<WorkspaceSourceProps<T>>;
-    }>);
-    requiresCapabilities?: string[];
-    chromeless?: boolean;
-    /** Panel id opened in the main workspace when this source is selected. */
-    defaultPanelId?: string;
-    /** Source: "builtin" | "app" */
-    source?: string;
-    pluginId?: string;
-    /** Revision emitted by the runtime plugin asset manager for hot-loaded sources. */
-    pluginRevision?: number;
-    lazy?: boolean;
-}
-
-export declare interface WorkspaceSourceOpenPanelConfig {
-    id: string;
-    component: string;
-    title?: string;
-    params?: Record<string, unknown>;
-}
-
-/**
- * Props for workspace source panes hosted in the left workspace rail.
- * These are not Dockview panels: they receive only source-pane params and
- * the explicit actions that the source host supports.
- */
-export declare interface WorkspaceSourceProps<T = unknown> {
-    params: T;
-    className?: string;
-    openPanel?: (config: WorkspaceSourceOpenPanelConfig) => void;
-}
-
-export declare type WorkspaceSourceRegistration<T = any> = Omit<WorkspaceSourceConfig<T>, 'id'>;
-
-export declare class WorkspaceSourceRegistry {
-    private sources;
-    private registrationOrder;
-    private capabilities;
-    private listeners;
-    private snapshotCache;
-    private lazyComponentCache;
-    constructor(capabilities?: Record<string, boolean>);
-    register(id: string, config: WorkspaceSourceRegistration): void;
-    unregister(id: string): void;
-    replaceByPluginId(pluginId: string, sources: WorkspaceSourceConfig[]): void;
-    get(id: string): WorkspaceSourceConfig | undefined;
-    has(id: string): boolean;
-    getComponent(sourceId: string): ComponentType<any> | undefined;
-    list(): WorkspaceSourceConfig[];
-    listAll(): WorkspaceSourceConfig[];
-    subscribe: (cb: () => void) => (() => void);
-    getSnapshot: () => readonly WorkspaceSourceConfig[];
-    private getLazyComponent;
-    private emit;
-    private filteredSources;
-    private satisfiesCapabilities;
-}
-
-export declare interface WorkspaceSourceRegistryLike {
-    register(id: string, config: WorkspaceSourceRegistration): void;
-}
-
-export declare interface WorkspaceState {
-    hydrationComplete: boolean;
-    layout: unknown | null;
-    sidebar: SidebarState;
-    panelSizes: Record<string, number>;
-    preferences: {
-        theme: "light" | "dark";
-    };
-    panels: PanelState[];
-    activePanel: string | null;
-    activeFile: string | null;
-    visibleFiles: string[];
-    dirtyFiles: Record<string, {
-        panelId: string;
-        savedAt: number | null;
-    }>;
-    notifications: Notification_2[];
-}
-
-export declare type WorkspaceStore = WorkspaceState & WorkspaceActions;
-
-declare type WorkspaceStoreApi = {
-    getState: () => WorkspaceStore;
-    subscribe: (listener: (state: WorkspaceStore, prevState: WorkspaceStore) => void) => () => void;
-    setState: (partial: Partial<WorkspaceStore>) => void;
-    getInitialState: () => WorkspaceStore;
-};
-
-export { }
-
-
-declare global {
-    var __BORING_RUNTIME_SINGLETONS__: Record<string, unknown> | undefined;
-}
+export * from './src/index.js'
+export {}