@hachej/boring-workspace 0.1.17 → 0.1.20

package/dist/workspace.d.ts

@@ -43,20 +43,6 @@ export declare interface AgentTool {
     execute(params: Record<string, unknown>, ctx: ToolExecContext): Promise<ToolResult>;
 }
 
-export declare interface AgentToolOutput {
-    /**
-     * @deprecated Executable agent tools should be contributed by server
-     * plugins. This output remains for migration only.
-     */
-    type: "agent-tool";
-    id: string;
-    tool: AgentTool;
-}
-
-export declare interface AgentToolRegistry {
-    register(tool: AgentTool, pluginId: string): void;
-}
-
 export declare interface ArtifactPanel {
     id: string;
     component: string;
@@ -82,33 +68,106 @@ export declare interface ArtifactSurfacePaneProps {
     className?: string;
 }
 
-export declare interface BindingOutput {
-    type: "binding";
-    id: string;
-    component: PluginBinding;
-}
-
 export declare function bindStore(store: WorkspaceStoreApi): void;
 
 export declare function bootstrap(options: BootstrapOptions): BootstrapResult;
 
 export declare interface BootstrapOptions {
     chatPanel: unknown;
-    plugins?: WorkspaceFrontPlugin[];
-    defaults?: WorkspaceFrontPlugin[];
+    plugins?: BoringFrontFactoryWithId[];
+    defaults?: BoringFrontFactoryWithId[];
     excludeDefaults?: string[];
     registries: {
         panels: PanelRegistryLike;
         commands: CommandRegistryLike;
         catalogs: CatalogRegistryLike;
         surfaceResolvers?: SurfaceResolverRegistryLike;
-        agentTools?: AgentToolRegistry;
     };
 }
 
 export declare interface BootstrapResult {
     registered: string[];
-    systemPromptAppend: 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;
+    registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
+    registerLeftTab<T = LeftTabParams>(registration: BoringFrontLeftTabRegistration<T>): void;
+    registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): 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 BoringFrontLeftTabRegistration<T = LeftTabParams> {
+    id: string;
+    title: string;
+    panelId: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    component?: PanelConfig<T>["component"];
+    lazy?: boolean;
+    chromeless?: boolean;
+    requiresCapabilities?: string[];
+    source?: 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?: string;
+    requiresCapabilities?: string[];
+    essential?: boolean;
+    lazy?: boolean;
+    chromeless?: boolean;
+    source?: string;
+}
+
+declare interface BoringFrontProviderRegistration {
+    id: string;
+    component: PluginProvider;
+}
+
+declare interface BoringFrontSurfaceResolverRegistration {
+    id?: string;
+    kind: string;
+    source?: string;
+    resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
 }
 
 export declare interface BridgeClient {
@@ -173,6 +232,22 @@ export declare function buildChatLayout(props?: ChatLayoutProps): LayoutConfig;
 
 export declare function buildIdeLayout(props?: IdeLayoutProps): LayoutConfig;
 
+declare interface CapturedBoringFrontRegistrations {
+    providers: BoringFrontProviderRegistration[];
+    bindings: BoringFrontBindingRegistration[];
+    catalogs: CatalogConfig[];
+    panels: BoringFrontPanelRegistration<any>[];
+    panelCommands: BoringFrontPanelCommandRegistration[];
+    leftTabs: BoringFrontLeftTabRegistration<any>[];
+    surfaceResolvers: BoringFrontSurfaceResolverRegistration[];
+}
+
+declare interface CapturedFrontPlugin {
+    id: string;
+    label?: string;
+    registrations: CapturedBoringFrontRegistrations;
+}
+
 export declare type CatalogAdapter = {
     search(args: CatalogSearchArgs): Promise<CatalogSearchResult>;
     fetchFacets?(args: CatalogFacetsArgs): Promise<CatalogFacets>;
@@ -211,11 +286,6 @@ export declare type CatalogFacetValue = {
     count: number;
 };
 
-export declare interface CatalogOutput {
-    type: "catalog";
-    catalog: CatalogConfig;
-}
-
 export declare class CatalogRegistry {
     private catalogs;
     private listeners;
@@ -225,6 +295,15 @@ export declare class CatalogRegistry {
     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);
@@ -326,11 +405,6 @@ export declare interface CommandConfig {
     pluginId?: string;
 }
 
-export declare interface CommandOutput {
-    type: "command";
-    command: CommandConfig;
-}
-
 export declare function CommandPalette(_props?: CommandPaletteProps): JSX.Element;
 
 export declare type CommandPaletteProps = Record<string, never>;
@@ -342,6 +416,14 @@ export declare class CommandRegistry {
     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[];
@@ -363,31 +445,6 @@ export declare interface CommandResult {
     };
 }
 
-/**
- * Compose a parent plugin from smaller child plugins without introducing a new
- * enhancer/mixin lifecycle. Contributions are flattened into PluginOutput
- * values so normal plugin bootstrap remains the single registration path.
- */
-export declare function composePlugins(options: ComposePluginsOptions): WorkspaceFrontPlugin;
-
-export declare interface ComposePluginsOptions {
-    id: string;
-    label?: string;
-    plugins: WorkspaceFrontPlugin[];
-    outputs?: PluginOutput[];
-    panels?: WorkspaceFrontPlugin["panels"];
-    commands?: WorkspaceFrontPlugin["commands"];
-    catalogs?: WorkspaceFrontPlugin["catalogs"];
-    agentTools?: WorkspaceFrontPlugin["agentTools"];
-    systemPrompt?: string;
-    /**
-     * When true (default), child contributions are registered as owned by the
-     * composed parent plugin. When false, output contributions carry the child
-     * plugin id so bootstrap can preserve child ownership in registries.
-     */
-    adoptOutputs?: boolean;
-}
-
 export declare function createBridge(store: StoreApi): WorkspaceBridge;
 
 export declare function createBridgeClient(options: BridgeClientOptions): BridgeClient;
@@ -430,8 +487,6 @@ export declare interface CreateWorkspaceStoreOptions {
     onLayoutVersionMismatch?: () => void;
 }
 
-export declare function defineFrontPlugin(spec: WorkspaceFrontPlugin): WorkspaceFrontPlugin;
-
 /**
  * Identity helper for type-safe panel registration. Pure runtime
  * passthrough — the value of this is forcing TypeScript to verify that
@@ -611,7 +666,7 @@ export declare const filesystemEvents: {
     readonly deleted: "filesystem:file.deleted";
 };
 
-export declare const filesystemPlugin: WorkspaceFrontPlugin;
+export declare const filesystemPlugin: BoringFrontFactoryWithId;
 
 export declare function FileTree({ files, selectedPath, searchQuery, height, editing, revealPath, pendingPaths, onSelect, onExpand, onCollapse, onContextMenu, onSubmitEdit, onCancelEdit, onDragDrop, className, }: FileTreeProps): JSX.Element;
 
@@ -715,6 +770,8 @@ export declare interface FileTreeViewProps {
 
 export declare function formatShortcut(binding: Pick<ShortcutBinding, "key" | "mod" | "shift">): string;
 
+export declare type FrontPluginHotReloadMode = "vite" | false;
+
 export declare function getFileIcon(filename: string): LucideIcon;
 
 export declare interface GroupConfig {
@@ -755,18 +812,6 @@ export declare interface LayoutConfig {
 
 export declare type LeftTabComponent = ComponentType<PaneProps<LeftTabParams>>;
 
-export declare interface LeftTabOutput<T = LeftTabParams> {
-    type: "left-tab";
-    id: string;
-    title: string;
-    icon?: PanelConfig<T>["icon"];
-    component: PanelConfig<T>["component"];
-    lazy?: PanelConfig<T>["lazy"];
-    requiresCapabilities?: PanelConfig<T>["requiresCapabilities"];
-    source?: PanelConfig<T>["source"];
-    chromeless?: PanelConfig<T>["chromeless"];
-}
-
 export declare interface LeftTabParams {
     rootDir?: string;
     query?: string;
@@ -961,11 +1006,6 @@ export declare interface PanelLifecycleApi {
     isActive: boolean;
 }
 
-export declare interface PanelOutput<T = any> {
-    type: "panel";
-    panel: PanelConfig<T>;
-}
-
 export declare type PanelRegistration<T = any> = Omit<PanelConfig<T>, 'id'>;
 
 export declare class PanelRegistry {
@@ -974,15 +1014,33 @@ export declare class PanelRegistry {
     private capabilities;
     private listeners;
     private snapshotCache;
+    private lazyComponentCache;
+    private wrapperComponentCache;
+    private generation;
     constructor(capabilities?: Record<string, boolean>);
     register(id: string, config: PanelRegistration): void;
-    unregisterByPluginId(pluginId: string): 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;
@@ -1060,14 +1118,12 @@ declare interface PluginErrorContextValue {
     reportPluginError: (error: PluginContributionError) => void;
 }
 
-export declare type PluginErrorKind = "validation" | "duplicate-id" | "mount" | "contribution";
+export declare type PluginErrorKind = "duplicate-id" | "validation" | "runtime";
 
 export declare function PluginErrorProvider({ children }: {
     children: ReactNode;
 }): JSX.Element;
 
-export declare type PluginOutput = LeftTabOutput | PanelOutput | CommandOutput | CatalogOutput | BindingOutput | ProviderOutput | SurfaceResolverOutput | AgentToolOutput;
-
 export declare type PluginProvider = ComponentType<PluginProviderProps>;
 
 export declare interface PluginProviderProps {
@@ -1087,16 +1143,9 @@ declare interface Props {
     children?: ReactNode;
 }
 
-export declare interface ProviderOutput {
-    type: "provider";
-    id: string;
-    component: PluginProvider;
-}
-
 declare interface RegisteredPluginMeta {
     id: string;
     label?: string;
-    systemPrompt?: string;
 }
 
 export declare function RegistryProvider({ panelRegistry, commandRegistry, catalogRegistry, surfaceResolverRegistry, children, }: RegistryProviderProps): JSX.Element;
@@ -1201,11 +1250,6 @@ export declare interface SurfaceResolverConfig {
     pluginId?: string;
 }
 
-export declare interface SurfaceResolverOutput {
-    type: "surface-resolver";
-    resolver: SurfaceResolverConfig;
-}
-
 export declare type SurfaceResolverRegistration = Omit<SurfaceResolverConfig, "id">;
 
 export declare class SurfaceResolverRegistry {
@@ -1214,7 +1258,15 @@ export declare class SurfaceResolverRegistry {
     private listeners;
     private snapshotCache;
     register(id: string, config: SurfaceResolverRegistration): void;
-    unregisterByPluginId(pluginId: string): 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[];
@@ -1228,7 +1280,7 @@ export declare interface SurfaceResolverRegistryLike {
     register(id: string, config: SurfaceResolverRegistration): void;
 }
 
-export declare function SurfaceShell({ rootDir, sidebarDefaultWidth, sidebarMinWidth, sidebarMaxWidth, storageKey, onReady, onChange, onClose, extraPanels, className, }: SurfaceShellProps): JSX.Element;
+export declare function SurfaceShell({ rootDir, sidebarDefaultWidth, sidebarMinWidth, sidebarMaxWidth, storageKey, onReady, onChange, onClose, extraPanels, defaultLeftTab, className, }: SurfaceShellProps): JSX.Element;
 
 export declare interface SurfaceShellApi {
     /** Open a file in the workbench. Idempotent — re-activates an existing pane for the same path. */
@@ -1272,6 +1324,7 @@ export declare interface SurfaceShellProps {
      * inside THIS surface (so a host can gate panels per shell instance).
      */
     extraPanels?: string[];
+    defaultLeftTab?: string;
     className?: string;
 }
 
@@ -1623,6 +1676,7 @@ export declare interface WorkspaceChatPanelProps {
 export declare interface WorkspaceContextValue {
     chatPanel: WorkspaceChatPanelComponent | null;
     registeredPlugins: RegisteredPluginMeta[];
+    debug: boolean;
 }
 
 export declare interface WorkspaceEventMap extends WorkspaceHostEventMap, WorkspacePluginEventMap {
@@ -1631,27 +1685,6 @@ export declare interface WorkspaceEventMap extends WorkspaceHostEventMap, Worksp
 /** Names that share a prefix can be filtered with `startsWith`. */
 export declare type WorkspaceEventName = keyof WorkspaceEventMap;
 
-export declare interface WorkspaceFrontPlugin {
-    id: string;
-    label?: string;
-    /**
-     * Context prepended to the agent's system prompt at boot. Concatenated
-     * across all registered plugins (in registration order) and joined with
-     * double-newlines. Plain Markdown. ~200-500 chars recommended.
-     */
-    systemPrompt?: string;
-    panels?: PanelConfig[];
-    commands?: CommandConfig[];
-    catalogs?: CatalogConfig[];
-    bindings?: PluginBinding[];
-    /**
-     * @deprecated Executable agent tools should be contributed by server
-     * plugins. This field remains for migration only.
-     */
-    agentTools?: AgentTool[];
-    outputs?: PluginOutput[];
-}
-
 declare interface WorkspaceHostEventMap {
     /** Shared UI manipulation contract used by the agent stream and plugin bindings. */
     [WORKSPACE_UI_COMMAND_EVENT]: EventMeta & {
@@ -1728,12 +1761,16 @@ export declare interface WorkspacePluginEventMap {
     };
 }
 
-export declare function WorkspaceProvider({ children, chatPanel, plugins, excludeDefaults, panels, commands, catalogs, capabilities, apiBaseUrl, authHeaders, apiTimeout, defaultTheme, onThemeChange, workspaceId, storageKey, persistenceEnabled, bridgeEndpoint, onAuthError, onOpenFile, }: WorkspaceProviderProps): JSX.Element;
+export declare function WorkspaceProvider({ children, chatPanel, plugins, excludeDefaults, panels, commands, catalogs, capabilities, apiBaseUrl, authHeaders, apiTimeout, defaultTheme, onThemeChange, workspaceId, storageKey, persistenceEnabled, bridgeEndpoint, onAuthError, onOpenFile, debug, frontPluginHotReload, }: WorkspaceProviderProps): JSX.Element;
 
 export declare interface WorkspaceProviderProps {
     children: ReactNode;
     chatPanel?: WorkspaceChatPanelComponent;
-    plugins?: WorkspaceFrontPlugin[];
+    /**
+     * Front plugin entries produced by `definePlugin({ id, ... })` from
+     * `@hachej/boring-workspace/plugin`.
+     */
+    plugins?: BoringFrontFactoryWithId[];
     excludeDefaults?: string[];
     panels?: PanelConfig[];
     commands?: CommandConfig[];
@@ -1751,6 +1788,14 @@ export declare interface WorkspaceProviderProps {
     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;
 }
 
 export declare interface WorkspaceState {