@hachej/boring-workspace 0.1.71 → 0.1.73

package/dist/src/plugins/filesystemPlugin/front/empty-file-panel/EmptyFilePanel.d.ts

@@ -0,0 +1,6 @@
+import { PaneProps } from '../../../../front/registry/types';
+interface EmptyFilePanelParams {
+    path: string;
+}
+export declare function EmptyFilePanel({ params }: PaneProps<EmptyFilePanelParams>): import("react").JSX.Element;
+export {};

package/dist/src/plugins/filesystemPlugin/front/empty-file-panel/definition.d.ts

@@ -0,0 +1,8 @@
+import { EmptyFilePanel } from './EmptyFilePanel';
+export declare const emptyFilePanelDef: {
+    id: string;
+    title: string;
+    component: typeof EmptyFilePanel;
+    placement: "center";
+    source: string;
+};

package/dist/src/plugins/filesystemPlugin/front/events.d.ts

@@ -0,0 +1,6 @@
+import { FilesystemEventMap } from '../shared/events';
+declare module "../../../front/events/types" {
+    interface WorkspacePluginEventMap extends FilesystemEventMap {
+    }
+}
+export type { FilesystemEventMap, FilesystemEventMeta } from '../shared/events';

package/dist/src/plugins/filesystemPlugin/front/file-tree/FileTree.d.ts

@@ -0,0 +1,59 @@
+export 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;
+}
+export 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 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;
+}
+export interface SanitizeFileTreeResult {
+    nodes: FileTreeNode[];
+    /** How many nodes were removed (pathless or duplicate id). */
+    dropped: number;
+}
+/**
+ * Make tree data safe for react-arborist (`idAccessor="path"`), which THROWS
+ * "Data must contain an 'id' property …" on a non-string id and misbehaves on a duplicate
+ * id. Drops any node without a non-empty string `path`, and any node whose `path` was
+ * already seen (ids must be unique), recursively. Both are unrenderable as distinct nodes
+ * anyway, so dropping them is correct and stops one malformed listing entry from crashing
+ * the whole file panel. PURE: no logging side effect — the caller surfaces `dropped`.
+ */
+export declare function sanitizeFileTree(nodes: FileTreeNode[]): SanitizeFileTreeResult;
+export declare function FileTree({ files, selectedPath, searchQuery, height, editing, revealPath, pendingPaths, onSelect, onExpand, onCollapse, onContextMenu, onSubmitEdit, onCancelEdit, onRevealHandled, onDragDrop, className, }: FileTreeProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/file-tree/FileTreeView.d.ts

@@ -0,0 +1,83 @@
+import { DockviewPanelApi } from 'dockview-react';
+import { FileTreeBridge } from '../../../../front/bridge/types';
+import { FilesystemId } from '../../../../shared/types/filesystem';
+import { PaneProps } from '../../../../shared/types/panel';
+import { LeftTabParams } from '../../../../shared/plugins/types';
+export { copyToClipboard } from './clipboard';
+export declare function preloadFileTreeComponent(): void;
+declare function clampContextMenuPosition(x: number, y: number, menuRect: Pick<DOMRect, "width" | "height">, viewportWidth: number, viewportHeight: number): {
+    x: number;
+    y: number;
+};
+export 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;
+}
+/**
+ * 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): import("react").JSX.Element;
+export { clampContextMenuPosition };
+export interface FileTreeRootConfig {
+    filesystem: FilesystemId;
+    label: string;
+    rootDir?: string;
+    access?: "readonly" | "readwrite";
+    searchPlaceholder?: string;
+}
+export 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 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;
+}
+/**
+ * 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): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/file-tree/__tests__/FileTree.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/file-tree/__tests__/FileTreePane.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/file-tree/__tests__/copyToClipboard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/file-tree/clipboard.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copy `text` to the clipboard. Falls back to a hidden-textarea + execCommand
+ * when `navigator.clipboard` is unavailable (non-secure contexts: plain http
+ * served from a non-localhost IP, file://, etc.).
+ */
+export declare function copyToClipboard(text: string): Promise<void>;

package/dist/src/plugins/filesystemPlugin/front/file-tree/dndManager.d.ts

@@ -0,0 +1,8 @@
+import { DragDropManager } from 'dnd-core';
+/**
+ * react-arborist mounts a react-dnd HTML5 backend for every tree by default.
+ * That can trip react-dnd's global HTML5 backend guard when multiple file-tree
+ * panes, React roots, or Vite HMR remnants overlap briefly. Keep one manager for
+ * all workspace file trees in this JS realm and hand it to arborist.
+ */
+export declare function getFileTreeDndManager(): DragDropManager;

package/dist/src/plugins/filesystemPlugin/front/file-tree/treeModel.d.ts

@@ -0,0 +1,20 @@
+import { FileEntry } from '../data/types';
+import { FileTreeNode } from './FileTree';
+export declare function buildTree(entries: FileEntry[], childrenByDir: Map<string, FileEntry[]>): FileTreeNode[];
+export declare function parentDir(path: string): string;
+export declare function dirKey(dir: string): string;
+export declare function mergeEntries(base: FileEntry[] | undefined, optimistic: FileEntry[] | undefined): FileEntry[] | undefined;
+export type DraftEditing = {
+    kind: 'create-file';
+    parentDir: string;
+    path: string;
+} | {
+    kind: 'create-folder';
+    parentDir: string;
+    path: string;
+} | {
+    kind: 'rename';
+    path: string;
+    initialValue: string;
+} | null;
+export declare function injectDraftIntoTree(tree: FileTreeNode[], editing: DraftEditing, rootDir: string): FileTreeNode[];

package/dist/src/plugins/filesystemPlugin/front/filePanelBinding.d.ts

@@ -0,0 +1 @@
+export declare function FilesystemFilePanelBinding(): null;

package/dist/src/plugins/filesystemPlugin/front/html-viewer/HtmlViewer.d.ts

@@ -0,0 +1,18 @@
+export interface HtmlViewerProps {
+    path: string;
+    filesystem?: string;
+    className?: string;
+}
+export declare function resolveHtmlPreviewAssetPath(sourcePath: string, assetUrl: string): string | null;
+export declare function rawFileUrlFor(base: string, path: string, workspaceRequestId?: string | null, filesystem?: string): string;
+export declare function rewriteCssAssetUrls(css: string, sourcePath: string, base: string, workspaceRequestId?: string | null, filesystem?: string): string;
+export declare function prepareHtmlPreviewDocument(options: {
+    html: string;
+    path: string;
+    apiBaseUrl: string;
+    headers: Record<string, string>;
+    workspaceRequestId?: string | null;
+    filesystem?: string;
+    signal: AbortSignal;
+}): Promise<string>;
+export declare function HtmlViewer({ path, filesystem, className }: HtmlViewerProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/html-viewer/HtmlViewer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/html-viewer/HtmlViewerPane.d.ts

@@ -0,0 +1,7 @@
+import { FilesystemId } from '../../../../shared/types/filesystem';
+import { PaneProps } from '../../../../shared/types/panel';
+export type HtmlViewerPaneProps = PaneProps<{
+    path?: string;
+    filesystem?: FilesystemId;
+}>;
+export declare function HtmlViewerPane({ params, className }: HtmlViewerPaneProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/index.d.ts

@@ -0,0 +1,11 @@
+import { BoringFrontSetup } from '../../../shared/plugins/frontFactory';
+import { BoringFrontFactoryWithId } from '../../../plugin';
+export { useFilePane } from './useFilePane';
+export { FilePaneShell } from './FilePaneShell';
+export { ConflictBanner } from './ConflictBanner';
+export { emitFilesystemAgentFileChange, useAutoOpenAgentFiles, onFilesystemChanged, } from './agentFileBridge';
+export type { UseFilePaneOptions, UseFilePaneReturn } from './useFilePane';
+export type { UseAutoOpenAgentFilesOptions } from './agentFileBridge';
+declare const filesystemFront: BoringFrontSetup;
+export default filesystemFront;
+export declare const filesystemPlugin: BoringFrontFactoryWithId;

package/dist/src/plugins/filesystemPlugin/front/markdown-editor/MarkdownEditor.d.ts

@@ -0,0 +1,44 @@
+import { FilesystemId } from '../../../../shared/types/filesystem';
+export declare function sanitizeHtml(html: string): string;
+export 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 interface MarkdownFrontmatterEntry {
+    key: string;
+    value: string;
+}
+export interface MarkdownFrontmatterSummary {
+    entries: MarkdownFrontmatterEntry[];
+    block: string;
+    raw: string;
+    body: string;
+}
+export declare function parseMarkdownFrontmatter(content: string): MarkdownFrontmatterSummary | null;
+export declare function serializeMarkdownEditorChange(nextBody: string, editorFocused: boolean, frontmatter: MarkdownFrontmatterSummary | null, userInteracted?: boolean): string | null;
+export declare function countMarkdownWords(content: string): number;
+/**
+ * Decide whether a TipTap `onUpdate` emission is a genuine user edit worth
+ * propagating to `onChange`.
+ *
+ * TipTap fires `onUpdate` not only for typed input but also while the editor
+ * settles on init / remount / DOM re-parent. Those unfocused emissions can be
+ * non-empty normalized markdown (for example frontmatter rewritten as a rule +
+ * heading), so saving them can corrupt files before the user touches anything.
+ * Keep toolbar edits working too: focus may be on a toolbar button, so a prior
+ * pointer/key interaction inside this editor shell also marks updates as user
+ * initiated.
+ */
+export declare function isUserEditedChange(_nextContent: string, editorFocused: boolean, userInteracted?: boolean): boolean;
+export declare function rawFileUrlForMarkdownImage(src: string, documentPath: string | undefined, apiBaseUrl: string, workspaceRequestId?: string | null, filesystem?: FilesystemId): string;
+export declare function workspaceFilePathForMarkdownLink(href: string, documentPath?: string): string | null;
+export declare function isSafeUrl(url: string): boolean;
+export declare function readFileAsDataUrl(file: Blob): Promise<string>;
+export declare function MarkdownEditor({ content, onChange, readOnly, placeholder, className, documentPath, filesystem: rawFilesystem, }: MarkdownEditorProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/markdown-editor/MarkdownEditorPane.d.ts

@@ -0,0 +1,8 @@
+import { FilesystemId } from '../../../../shared/types/filesystem';
+import { PaneProps } from '../../../../front/registry/types';
+export type MarkdownEditorPaneProps = PaneProps<{
+    path?: string;
+    filesystem?: FilesystemId;
+    mode?: "view" | "edit" | "diff";
+}>;
+export declare function MarkdownEditorPane({ params, api, className }: MarkdownEditorPaneProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/markdown-editor/ResizableImage.d.ts

@@ -0,0 +1,10 @@
+import { Node } from '@tiptap/core';
+/**
+ * Image extension with persisted width + a corner drag handle.
+ *
+ * The width is stored on the node as a plain numeric attribute. Plain images
+ * serialize as GitHub-compatible markdown (`![alt](src)`). Resized/aligned
+ * images serialize as GitHub-compatible HTML so width/alignment survives.
+ * The NodeView only kicks in inside the editor.
+ */
+export declare const ResizableImage: Node<any, any>;

package/dist/src/plugins/filesystemPlugin/front/markdown-editor/__tests__/MarkdownEditor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/markdown-editor/__tests__/MarkdownEditorPane.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/media-viewer/MediaViewer.d.ts

@@ -0,0 +1,9 @@
+export interface MediaViewerProps {
+    path: string;
+    kind: "image" | "pdf";
+    filesystem?: string;
+    reloadKey?: number;
+    onReload?: () => void;
+    className?: string;
+}
+export declare function MediaViewer({ path, kind, filesystem, reloadKey, onReload, className }: MediaViewerProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/media-viewer/MediaViewer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/media-viewer/MediaViewerPane.d.ts

@@ -0,0 +1,8 @@
+import { FilesystemId } from '../../../../shared/types/filesystem';
+import { PaneProps } from '../../../../shared/types/panel';
+export type MediaViewerPaneProps = PaneProps<{
+    path?: string;
+    kind?: "image" | "pdf";
+    filesystem?: FilesystemId;
+}>;
+export declare function MediaViewerPane({ params, className }: MediaViewerPaneProps): import("react").JSX.Element;

package/dist/src/plugins/filesystemPlugin/front/media-viewer/useMediaViewerReload.d.ts

@@ -0,0 +1,8 @@
+export interface UseMediaViewerReloadOptions {
+    path: string;
+}
+export interface UseMediaViewerReloadReturn {
+    reloadKey: number;
+    reload: () => void;
+}
+export declare function useMediaViewerReload({ path }: UseMediaViewerReloadOptions): UseMediaViewerReloadReturn;

package/dist/src/plugins/filesystemPlugin/front/media-viewer/useMediaViewerReload.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/search.d.ts

@@ -0,0 +1,5 @@
+import { FileEntry } from './data/types';
+export declare const DEFAULT_TREE_IGNORE: ReadonlyArray<string | RegExp>;
+export declare function matchesAny(name: string, patterns: ReadonlyArray<string | RegExp>): boolean;
+export declare function filterIgnoredEntries(entries: FileEntry[] | undefined, ignoreNames: ReadonlyArray<string | RegExp>): FileEntry[] | undefined;
+export declare function toFileSearchGlob(query: string): string;

package/dist/src/plugins/filesystemPlugin/front/search.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/filesystemPlugin/front/surfaceResolver.d.ts

@@ -0,0 +1,10 @@
+import { SurfaceResolverConfig } from '../../../shared/types/surface';
+interface FilesystemSurfaceHandler {
+    component: string;
+    patterns?: string[];
+    fallback?: boolean;
+}
+export declare function patternSpecificity(pattern: string): number;
+export declare const filesystemSurfaceResolver: SurfaceResolverConfig;
+export declare const filesystemSurfaceHandlers: FilesystemSurfaceHandler[];
+export {};

package/dist/src/plugins/filesystemPlugin/front/useFilePane.d.ts

@@ -0,0 +1,61 @@
+import { FilesystemId } from '../../../shared/types/filesystem';
+import { FileConflictError } from './data/fetchClient';
+export 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 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;
+}
+/**
+ * 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;

package/dist/src/plugins/filesystemPlugin/shared/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const FILESYSTEM_PLUGIN_ID = "filesystem";
+export declare const FILES_LEFT_TAB_ID = "files";
+export declare const FILES_CATALOG_ID = "files";
+export declare const FILES_QUERY_KEY_SEGMENT = "files";
+export declare const FILESYSTEM_SURFACE_RESOLVER_ID = "filesystem-path";
+export declare const CODE_EDITOR_PANEL_ID = "code-editor";
+export declare const CSV_VIEWER_PANEL_ID = "csv-viewer";
+export declare const MARKDOWN_EDITOR_PANEL_ID = "markdown-editor";
+export declare const IMAGE_VIEWER_PANEL_ID = "image-viewer";
+export declare const PDF_VIEWER_PANEL_ID = "pdf-viewer";
+export declare const HTML_VIEWER_PANEL_ID = "html-viewer";
+export declare const EMPTY_FILE_PANEL_ID = "empty-file-panel";

package/dist/src/plugins/filesystemPlugin/shared/events.d.ts

@@ -0,0 +1,39 @@
+import { FilesystemId } from '../../../shared/types/filesystem';
+export declare const FILESYSTEM_FILE_CHANGED_EVENT = "filesystem:file.changed";
+export declare const FILESYSTEM_FILE_CREATED_EVENT = "filesystem:file.created";
+export declare const FILESYSTEM_FILE_MOVED_EVENT = "filesystem:file.moved";
+export declare const FILESYSTEM_FILE_DELETED_EVENT = "filesystem:file.deleted";
+export declare const filesystemEvents: {
+    readonly changed: "filesystem:file.changed";
+    readonly created: "filesystem:file.created";
+    readonly moved: "filesystem:file.moved";
+    readonly deleted: "filesystem:file.deleted";
+};
+export type FilesystemEventMeta = ({
+    cause: "user";
+} | {
+    cause: "agent";
+    toolCallId: string;
+} | {
+    cause: "remote";
+    toolCallId?: string;
+}) & {
+    ts: number;
+    filesystem?: FilesystemId;
+};
+export 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;
+    };
+}

package/dist/src/shared/__tests__/filesystem.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/__tests__/telemetry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/__tests__/workspaceBridgeRpc.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @hachej/boring-workspace/shared — shared contract layer.
+ *
+ * Code (types + runtime) that BOTH front and server bundles import.
+ * This is the workspace's public SDK surface for plugin authors and
+ * app shells that wire things together manually.
+ *
+ * Isolation rule: no imports from ../front/** or ../server/**.
+ *
+ * Sub-folders:
+ * - `types/` — pure type definitions, zero runtime
+ * - `plugins/` — shared plugin internals used by the public `/plugin` subpath and bootstrap
+ */
+export type { WorkspaceBridge, UiState, UiCommand, CommandResult } from './ui-bridge';
+export { WorkspaceBridgeErrorCode, createWorkspaceBridgeError, } from './workspace-bridge-rpc';
+export type { BridgeActorAttribution, BridgeActorKind, BridgeAuthContext, BridgeCallerClass, BridgeIdempotencyPolicy, BridgeRedactedActorRef, WorkspaceBridgeCallFailure, WorkspaceBridgeCallRequest, WorkspaceBridgeCallResponse, WorkspaceBridgeCallSuccess, WorkspaceBridgeError, WorkspaceBridgeFileAssetPointer, WorkspaceBridgeJsonValue, WorkspaceBridgeOperationDefinition, } from './workspace-bridge-rpc';
+export type { PanelConfig, CommandConfig, PaneProps, PanelRegistration } from './types/panel';
+export type { FilesystemId, UiFileResource, UiFileResourceInput, } from './types/filesystem';
+export { COMPANY_CONTEXT_FILESYSTEM_ID, USER_FILESYSTEM_ID, normalizeUiFileResource, normalizeUiFilesystem, uiFileResourceKey, withUiFileResource, } from './types/filesystem';
+export type { SurfaceOpenRequest, SurfacePanelResolution, SurfaceResolverConfig, SurfaceResolverRegistration, } from './types/surface';
+export { WORKSPACE_OPEN_PATH_SURFACE_KIND } from './types/surface';
+export { definePanel } from './types/panel';
+export type { AgentTool, JSONSchema, ToolExecContext, ToolResult } from './types/agent-tool';
+export type { TelemetryEvent, TelemetrySink } from './telemetry';
+export { noopTelemetry, safeCapture } from './telemetry';

package/dist/src/shared/plugins/CatalogRegistry.d.ts

@@ -0,0 +1,28 @@
+import { CatalogConfig } from './types';
+export interface CatalogRegistryOptions {
+    warnOnDuplicate?: boolean;
+}
+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;
+}

package/dist/src/shared/plugins/CommandRegistry.d.ts

@@ -0,0 +1,23 @@
+import { CommandConfig } from '../types/panel';
+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;
+}

package/dist/src/shared/plugins/SurfaceResolverRegistry.d.ts

@@ -0,0 +1,24 @@
+import { SurfaceOpenRequest, SurfacePanelResolution, SurfaceResolverConfig, SurfaceResolverRegistration } from '../types/surface';
+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;
+}

package/dist/src/shared/plugins/__tests__/bootstrap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/plugins/__tests__/frontFactory.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/plugins/__tests__/manifest.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/shared/plugins/__tests__/uiBridgeRegistry.test.d.ts

@@ -0,0 +1 @@
+export {};