@hachej/boring-workspace 0.1.62 → 0.1.64

package/dist/workspace.d.ts

@@ -226,6 +226,7 @@ export declare interface BridgeEventMap {
     "file:opened": {
         path: string;
         mode: "view" | "edit" | "diff";
+        filesystem?: FilesystemId;
     };
     "file:saved": {
         path: string;
@@ -389,6 +390,8 @@ export declare interface ChatLayoutProps {
     center?: string;
     centerParams?: Record<string, unknown>;
     chatPanes?: ChatPaneDescriptor[];
+    /** Optional host actions rendered in the active chat pane header. */
+    chatTopActions?: ReactNode;
     activeChatPaneId?: string | null;
     onActiveChatPaneChange?: (id: string) => void;
     onCloseChatPane?: (id: string) => void;
@@ -435,6 +438,7 @@ export declare function CodeEditorPane({ params, api, className }: CodeEditorPan
 
 export declare type CodeEditorPaneProps = PaneProps<{
     path?: string;
+    filesystem?: FilesystemId;
     mode?: "view" | "edit" | "diff";
 }>;
 
@@ -731,8 +735,8 @@ declare class FetchClient {
     private retryBaseMs;
     constructor(opts: FetchClientOptions);
     private request;
-    getTree(path: string, signal?: AbortSignal): Promise<FileEntry[]>;
-    getFile(path: string, signal?: AbortSignal): Promise<FileContent>;
+    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
@@ -748,15 +752,22 @@ declare class FetchClient {
     writeFile(path: string, content: string, opts?: {
         expectedMtimeMs?: number;
         returnMtimeMs?: boolean;
+        filesystem?: string;
     }): Promise<{
         mtimeMs?: number;
     }>;
-    deleteFile(path: string): Promise<void>;
-    stat(path: string, signal?: AbortSignal): Promise<FileStat>;
+    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): Promise<void>;
-    moveFile(from: string, to: string): Promise<void>;
+    createDir(path: string, options?: {
+        filesystem?: string;
+    }): Promise<void>;
+    moveFile(from: string, to: string, options?: {
+        filesystem?: string;
+    }): Promise<void>;
 }
 
 declare interface FetchClientOptions {
@@ -791,6 +802,8 @@ declare class FileConflictError extends Error {
 
 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
@@ -873,6 +886,7 @@ export declare type FilesystemEventMeta = ({
     toolCallId?: string;
 }) & {
     ts: number;
+    filesystem?: FilesystemId;
 };
 
 export declare const filesystemEvents: {
@@ -882,6 +896,8 @@ export declare const filesystemEvents: {
     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;
@@ -922,7 +938,7 @@ export declare interface FileTreeNode {
  * `<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, className, }: FileTreePaneProps): JSX.Element;
+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;
@@ -930,6 +946,9 @@ declare interface FileTreePaneParams extends LeftTabParams {
     query?: string;
     bridge?: unknown;
     chromeless?: boolean;
+    filesystem?: FilesystemId;
+    access?: "readonly" | "readwrite";
+    roots?: FileTreeRootConfig[];
     revealFileTreeRequest?: {
         path: string;
         seq: number;
@@ -942,6 +961,9 @@ export declare interface FileTreePaneProps extends Partial<PaneProps<FileTreePan
     panelApi?: DockviewPanelApi;
     bridge?: FileTreeBridge;
     chromeless?: boolean;
+    filesystem?: FilesystemId;
+    access?: "readonly" | "readwrite";
+    roots?: FileTreeRootConfig[];
     className?: string;
 }
 
@@ -970,6 +992,14 @@ export declare interface FileTreeProps {
     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
@@ -981,7 +1011,7 @@ export declare interface FileTreeProps {
  * 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, ignoreNames, className, }: FileTreeViewProps): JSX.Element;
+export declare function FileTreeView({ rootDir, searchQuery, bridge, revealFileTreeRequest, filesystem, access, ignoreNames, className, }: FileTreeViewProps): JSX.Element;
 
 export declare interface FileTreeViewProps {
     rootDir?: string;
@@ -992,6 +1022,8 @@ export declare interface FileTreeViewProps {
         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
@@ -1071,12 +1103,13 @@ export declare interface LeftTabParams {
     } | null;
 }
 
-export declare function MarkdownEditor({ content, onChange, readOnly, placeholder, className, documentPath, }: MarkdownEditorProps): JSX.Element;
+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";
 }>;
 
@@ -1088,6 +1121,8 @@ export declare interface MarkdownEditorProps {
     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;
@@ -1127,16 +1162,21 @@ export declare function onFilesystemChanged(handler: (payload: FilesystemEventMe
     path: string;
 }) => void): () => void;
 
-export declare type OpenArtifactHandler = (path: string) => 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;
 }>;
 
@@ -1518,6 +1558,7 @@ declare type StoreApi_2 = {
 export declare interface SurfaceOpenRequest {
     kind: string;
     target: string;
+    filesystem?: FilesystemId;
     meta?: Record<string, unknown>;
 }
 
@@ -1584,10 +1625,8 @@ export declare interface SurfaceResolverRegistryLike {
 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 path. */
-    openFile: (path: string, opts?: {
-        mode?: "view" | "edit" | "diff";
-    }) => void;
+    /** Open a file in the workbench. Idempotent — re-activates an existing pane for the same filesystem/path. */
+    openFile: (path: string, options?: SurfaceShellOpenFileOptions) => void;
     /** Open a plugin-defined surface target through the registered surface resolvers. */
     openSurface: (request: SurfaceOpenRequest) => void;
     /**
@@ -1605,6 +1644,11 @@ export declare interface SurfaceShellApi {
     getSnapshot: () => SurfaceShellSnapshot;
 }
 
+declare interface SurfaceShellOpenFileOptions {
+    filesystem?: FilesystemId;
+    mode?: "view" | "edit" | "diff";
+}
+
 export declare interface SurfaceShellProps {
     rootDir?: string;
     sidebarDefaultWidth?: number;
@@ -1857,6 +1901,8 @@ export declare function useFilePane(options: UseFilePaneOptions): UseFilePaneRet
 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). */
@@ -1870,6 +1916,7 @@ export declare interface UseFilePaneReturn {
     error: Error | null;
     content: string | null;
     isDirty: boolean;
+    isReadonly: boolean;
     conflict: FileConflictError | null;
     onReloadFromServer: () => Promise<void>;
     onOverwrite: () => Promise<void>;
@@ -1948,6 +1995,24 @@ 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;
@@ -1956,13 +2021,6 @@ 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;
 
-declare interface WorkbenchLeftPaneOpenPanelConfig {
-    id: string;
-    component: string;
-    title?: string;
-    params?: Record<string, unknown>;
-}
-
 export declare interface WorkbenchLeftPaneProps {
     rootDir?: string;
     bridge?: FileTreeBridge;
@@ -1979,7 +2037,7 @@ export declare interface WorkbenchLeftPaneProps {
         path: string;
         seq: number;
     } | null;
-    onOpenPanel?: (config: WorkbenchLeftPaneOpenPanelConfig) => void;
+    onOpenPanel?: (config: WorkspaceLeftPaneOpenPanelConfig) => void;
     onReloadAgentPlugins?: () => void | Promise<unknown>;
     onCollapse?: () => void;
     onExpand?: (tab?: WorkbenchLeftTabId) => void;
@@ -2084,6 +2142,7 @@ export declare interface WorkspaceBridge {
     getVisibleFiles(): string[];
     openFile(path: string, opts?: {
         mode?: "view" | "edit" | "diff";
+        filesystem?: FilesystemId;
     }): Promise<CommandResult>;
     openPanel(config: DynamicPaneConfig): Promise<CommandResult>;
     closePanel(id: string): Promise<CommandResult>;
@@ -2103,8 +2162,9 @@ export declare interface WorkspaceBridgeContextValue {
 
 export declare type WorkspaceChatPanelComponent = ComponentType<any>;
 
-export declare interface WorkspaceChatPanelProps extends PiChatPanelProps<WorkspaceAttentionBlocker> {
+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. */
@@ -2190,6 +2250,23 @@ declare interface WorkspaceHostEventMap {
     };
 }
 
+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;
@@ -2209,10 +2286,12 @@ 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";
@@ -2240,9 +2319,12 @@ declare type WorkspacePanelMatch = {
 } | {
     param: string;
     value: unknown;
+} | {
+    params: Record<string, unknown>;
 } | {
     paramPrefix: string;
     value: string;
+    params?: Record<string, unknown>;
 };
 
 export declare interface WorkspacePluginClient {
@@ -2285,17 +2367,21 @@ declare interface WorkspacePluginClientProviderProps {
  */
 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;
     };
 }