@hachej/boring-workspace 0.1.33 → 0.1.35

package/dist/workspace.d.ts

@@ -100,6 +100,7 @@ declare interface BoringFrontAPI {
     registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
     registerLeftTab<T = LeftTabParams>(registration: BoringFrontLeftTabRegistration<T>): void;
     registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): void;
+    registerToolRenderer(registration: BoringFrontToolRendererRegistration): void;
 }
 
 declare interface BoringFrontBindingRegistration {
@@ -173,6 +174,13 @@ declare interface BoringFrontSurfaceResolverRegistration {
     resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
 }
 
+declare type BoringFrontToolRenderer = (part: unknown) => ReactNode;
+
+declare interface BoringFrontToolRendererRegistration {
+    id: string;
+    render: BoringFrontToolRenderer;
+}
+
 export declare interface BridgeClient {
     connect(): void;
     disconnect(): void;
@@ -251,6 +259,7 @@ declare interface CapturedBoringFrontRegistrations {
     panelCommands: BoringFrontPanelCommandRegistration[];
     leftTabs: BoringFrontLeftTabRegistration<any>[];
     surfaceResolvers: BoringFrontSurfaceResolverRegistration[];
+    toolRenderers: BoringFrontToolRendererRegistration[];
 }
 
 declare interface CapturedFrontPlugin {
@@ -367,6 +376,20 @@ export declare interface ChatLayoutProps {
     navParams?: Record<string, unknown>;
     center?: string;
     centerParams?: Record<string, unknown>;
+    chatPanes?: ChatPaneDescriptor[];
+    activeChatPaneId?: string | null;
+    onActiveChatPaneChange?: (id: string) => void;
+    onCloseChatPane?: (id: string) => void;
+    onCreateChatPaneAfter?: (id: string) => void;
+    onDropChatSession?: (sessionId: string) => void;
+    flashChatPaneId?: string | null;
+    /**
+     * Chat stage layout engine. `dock` enables the dockview-backed stage
+     * (drag headers to split in any direction); defaults to the flex row.
+     * The `boring-workspace:chat-pane-engine` localStorage key overrides
+     * when no explicit value is passed.
+     */
+    chatPaneEngine?: ChatPaneEngine | null;
     surface?: string | null;
     surfaceParams?: Record<string, unknown>;
     surfaceOverlay?: ReactNode;
@@ -380,6 +403,25 @@ export declare interface ChatLayoutProps {
     className?: string;
 }
 
+declare interface ChatPaneDescriptor {
+    id: string;
+    title?: string | null;
+    panel?: string;
+    params?: Record<string, unknown>;
+}
+
+/**
+ * Layout engine for the chat pane stage.
+ *
+ * - `flex` (default): panes lay out as a single row of vertical splits.
+ * - `dock`: dockview-backed stage — drag pane headers to split in any
+ *   direction and resize; geometry persists per workspace.
+ *
+ * Resolution order: explicit prop, then the
+ * `boring-workspace:chat-pane-engine` localStorage override, then `flex`.
+ */
+declare type ChatPaneEngine = "flex" | "dock";
+
 export declare const closePanelSchema: z.ZodObject<{
     id: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -674,6 +716,7 @@ declare class FetchClient {
     }>;
     deleteFile(path: string): Promise<void>;
     stat(path: string, signal?: AbortSignal): 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>;
@@ -920,6 +963,12 @@ 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";
@@ -1337,12 +1386,18 @@ export declare interface ResponsiveDockviewShellProps {
 
 export declare type SerializedLayout = Parameters<DockviewApi["fromJSON"]>[0];
 
-export declare function SessionBrowser({ sessions, activeId, onSwitch, onCreate, onDelete, onLoadMore, hasMore, loadingMore, onClose, className, }: SessionBrowserProps): JSX.Element;
+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;
@@ -1955,6 +2010,15 @@ 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 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 {
@@ -2071,7 +2135,7 @@ 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, debug, frontPluginHotReload, fullPageBasePath, }: WorkspaceProviderProps): JSX.Element;
+export declare function WorkspaceProvider({ children, chatPanel, plugins, excludeDefaults, panels, commands, catalogs, capabilities, apiBaseUrl, authHeaders, apiTimeout, defaultTheme, onThemeChange, workspaceId, workspaceLabel, storageKey, persistenceEnabled, manageDocumentTitle, bridgeEndpoint, onAuthError, onOpenFile, debug, frontPluginHotReload, fullPageBasePath, }: WorkspaceProviderProps): JSX.Element;
 
 export declare interface WorkspaceProviderProps {
     children: ReactNode;
@@ -2093,8 +2157,10 @@ export declare interface WorkspaceProviderProps {
     defaultTheme?: "light" | "dark" | undefined;
     onThemeChange?: (theme: "light" | "dark") => void;
     workspaceId?: string;
+    workspaceLabel?: string;
     storageKey?: string;
     persistenceEnabled?: boolean;
+    manageDocumentTitle?: boolean;
     bridgeEndpoint?: string | null;
     onAuthError?: (statusCode: number) => void;
     onOpenFile?: (path: string) => void;

package/dist/workspace.js

@@ -1,19 +1,19 @@
 var V = Object.defineProperty;
 var X = (e, t, a) => t in e ? V(e, t, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[t] = a;
 var T = (e, t, a) => X(e, typeof t != "symbol" ? t + "" : t, a);
-import { u as K, p as Q, a as Y, b as Z, D as ee } from "./WorkspaceProvider-CuIZx1ua.js";
-import { A as Je, C as Ge, c as Ve, d as Xe, e as Qe, F as Ye, f as Ze, M as et, g as tt, P as at, h as rt, i as nt, j as st, k as ot, R as it, S as lt, l as ct, m as dt, T as ut, U as pt, W as ft, n as mt, o as ht, q as gt, r as bt, s as yt, t as vt, v as xt, w as kt, x as wt, y as Pt, z as St, B as Ct, E as Nt, G as Rt, H as Et, I as Tt, J as It, K as Ot, L as Ft, N as Lt, O as Mt, Q as Bt, V as Wt, X as Dt, Y as Kt, Z as $t, _ as jt, $ as zt, a0 as Ht, a1 as Ut, a2 as _t, a3 as qt, a4 as At, a5 as Jt, a6 as Gt, a7 as Vt, a8 as Xt, a9 as Qt, aa as Yt, ab as Zt, ac as ea, ad as ta, ae as aa, af as ra, ag as na, ah as sa, ai as oa, aj as ia, ak as la, al as ca, am as da, an as ua, ao as pa, ap as fa, aq as ma, ar as ha } from "./WorkspaceProvider-CuIZx1ua.js";
+import { u as K, p as Q, a as Y, b as Z, D as ee } from "./WorkspaceProvider-BhRPFy5R.js";
+import { A as Je, C as Ge, c as Ve, d as Xe, e as Qe, F as Ye, f as Ze, M as et, g as tt, P as at, h as rt, i as nt, j as st, k as ot, R as it, S as lt, l as ct, m as dt, T as ut, U as pt, W as ft, n as mt, o as ht, q as gt, r as bt, s as yt, t as vt, v as xt, w as kt, x as wt, y as Pt, z as St, B as Ct, E as Nt, G as Et, H as Rt, I as Tt, J as It, K as Ot, L as Ft, N as Lt, O as Mt, Q as Bt, V as Wt, X as Dt, Y as Kt, Z as $t, _ as jt, $ as zt, a0 as Ht, a1 as Ut, a2 as _t, a3 as qt, a4 as At, a5 as Jt, a6 as Gt, a7 as Vt, a8 as Xt, a9 as Qt, aa as Yt, ab as Zt, ac as ea, ad as ta, ae as aa, af as ra, ag as na, ah as sa, ai as oa, aj as ia, ak as la, al as ca, am as da, an as ua, ao as pa, ap as fa, aq as ma, ar as ha, as as ga } from "./WorkspaceProvider-BhRPFy5R.js";
 import { c as C } from "./utils-B6yFEsav.js";
-import { C as ba, T as ya, W as va, b as xa } from "./WorkspaceLoadingState-BlvZXmFg.js";
+import { C as ya, T as va, W as xa, b as ka } from "./WorkspaceLoadingState-Bl-92Dly.js";
 import { jsx as r, jsxs as g, Fragment as te } from "react/jsx-runtime";
 import { Button as P, Sheet as ae, SheetContent as re, SheetHeader as ne, SheetTitle as se, SheetDescription as oe, EmptyState as ie, Kbd as I, ErrorState as le, IconButton as O } from "@hachej/boring-ui-kit";
-import { Toaster as wa, dismissToast as Pa, toast as Sa } from "@hachej/boring-ui-kit";
+import { Toaster as Pa, dismissToast as Sa, toast as Ca } from "@hachej/boring-ui-kit";
 import { useSyncExternalStore as $, useState as N, useEffect as k, useRef as S, useCallback as b, useMemo as w, Suspense as ce, Component as de } from "react";
-import { C as Na, c as Ra } from "./CodeEditor-DQqOn4xz.js";
-import { FileTree as Ta } from "./FileTree-SmsE0Raq.js";
-import { MarkdownEditor as Oa } from "./MarkdownEditor-zbp8ezds.js";
+import { C as Ea, c as Ra } from "./CodeEditor-DQqOn4xz.js";
+import { FileTree as Ia } from "./FileTree-CkCxHBDu.js";
+import { MarkdownEditor as Fa } from "./MarkdownEditor-CtPphEVP.js";
 import { MenuIcon as ue, PanelLeftOpenIcon as pe, PanelLeftCloseIcon as fe, PinIcon as me, CheckIcon as he, CopyIcon as ge } from "lucide-react";
-import { d as La } from "./panel-DnvDNQac.js";
+import { d as Ma } from "./panel-DnvDNQac.js";
 function We() {
   const e = K();
   return $(e.subscribe, e.getSnapshot);
@@ -217,14 +217,14 @@ function Ce({
     () => f ? e : Se(e),
     [f, e]
   ), z = w(() => {
-    const x = f ? "inline-sidebar" : "overlay-sidebar", M = v.groups.map((R) => {
-      let E = "";
+    const x = f ? "inline-sidebar" : "overlay-sidebar", M = v.groups.map((E) => {
+      let R = "";
       try {
-        E = JSON.stringify(R.params ?? null);
+        R = JSON.stringify(E.params ?? null);
       } catch {
-        E = "unserializable";
+        R = "unserializable";
       }
-      return `${R.id}:${R.panel ?? ""}:${E}`;
+      return `${E.id}:${E.panel ?? ""}:${R}`;
     }).join(",");
     return `${v.version}:${x}:${M}`;
   }, [v, f]), H = $(
@@ -501,7 +501,7 @@ function _e({
         /* @__PURE__ */ g("div", { className: "flex-1 overflow-y-auto", role: "list", "aria-label": "Session list", children: [
           e.length === 0 && /* @__PURE__ */ r("div", { className: "px-3 py-6 text-center text-sm text-muted-foreground", children: "No sessions" }),
           e.map((s) => /* @__PURE__ */ r(
-            Ee,
+            Re,
             {
               session: s,
               isActive: s.id === t,
@@ -521,7 +521,7 @@ function _e({
     }
   );
 }
-async function Re(e) {
+async function Ee(e) {
   var a, n;
   if (typeof navigator < "u" && ((a = navigator.clipboard) != null && a.writeText))
     try {
@@ -539,7 +539,7 @@ async function Re(e) {
     document.body.removeChild(t);
   }
 }
-function Ee({
+function Re({
   session: e,
   isActive: t,
   isFocused: a,
@@ -550,7 +550,7 @@ function Ee({
   rowRef: d
 }) {
   const [l, c] = N(!1), p = b((m) => {
-    m.stopPropagation(), Re(e.id).then((s) => {
+    m.stopPropagation(), Ee(e.id).then((s) => {
       s && (c(!0), window.setTimeout(() => c(!1), 1200));
     });
   }, [e.id]);
@@ -629,19 +629,19 @@ function Ee({
 export {
   Je as ArtifactSurfacePane,
   Ge as CatalogRegistry,
-  ba as ChatLayout,
-  Na as CodeEditor,
+  ya as ChatLayout,
+  Ea as CodeEditor,
   Ve as CodeEditorPane,
   Xe as CommandPalette,
   Qe as CommandRegistry,
   ee as DockviewShell,
   He as EmptyPane,
-  Ta as FileTree,
+  Ia as FileTree,
   Ye as FileTreePane,
   Ze as FileTreeView,
   ze as IdeLayout,
   et as MAX_PANELS,
-  Oa as MarkdownEditor,
+  Fa as MarkdownEditor,
   tt as MarkdownEditorPane,
   at as PanelChrome,
   Ue as PanelErrorBoundary,
@@ -656,19 +656,19 @@ export {
   ct as SurfaceResolverRegistry,
   dt as SurfaceShell,
   ut as ThemeProvider,
-  wa as Toaster,
-  ya as TopBar,
+  Pa as Toaster,
+  va as TopBar,
   pt as UI_COMMAND_EVENT,
   ft as WORKSPACE_OPEN_PATH_SURFACE_KIND,
   mt as WorkbenchLeftPane,
   ht as WorkspaceFilesProvider,
   De as WorkspaceLink,
-  va as WorkspaceLoadingState,
+  xa as WorkspaceLoadingState,
   gt as WorkspaceProvider,
   bt as agentMeta,
   yt as bindStore,
   vt as bootstrap,
-  xa as buildChatLayout,
+  ka as buildChatLayout,
   xt as buildFullPagePanelHref,
   Ne as buildIdeLayout,
   kt as closePanelSchema,
@@ -677,12 +677,12 @@ export {
   Pt as createBridgeClient,
   Ra as createShadcnTheme,
   St as createWorkspaceStore,
-  La as definePanel,
-  Pa as dismissToast,
+  Ma as definePanel,
+  Sa as dismissToast,
   Ct as emitAgentData,
   Nt as emitFilesystemAgentFileChange,
-  Rt as events,
-  Et as expandToFileSchema,
+  Et as events,
+  Rt as expandToFileSchema,
   Tt as filesystemEvents,
   It as filesystemPlugin,
   Ot as formatShortcut,
@@ -694,7 +694,7 @@ export {
   Dt as openPanelSchema,
   Q as postUiCommand,
   Ke as readFileRecords,
-  Sa as toast,
+  Ca as toast,
   Kt as useActiveFile,
   $t as useActivePanel,
   We as useActivePanels,
@@ -735,6 +735,7 @@ export {
   fa as useWorkspaceContextOptional,
   ma as useWorkspaceRequestId,
   ha as userMeta,
+  ga as workspaceEvents,
   j as workspaceLinkCommand,
   be as workspaceLinkHref
 };

package/docs/PLUGIN_SYSTEM.md

@@ -243,14 +243,13 @@ plugins. That template is an app/internal publishable package example.
 
 ### 4.7 `pluginHotReload`
 
-`createWorkspaceAgentServer({ pluginHotReload })` controls runtime plugin
-reload endpoints and dynamic Pi/package refresh.
+`createWorkspaceAgentServer({ pluginHotReload })` controls dynamic Pi/package
+refresh through the canonical `/api/v1/agent/reload` path.
 
-- `true` (default): registers `/api/boring.reload`, keeps
-  `/api/v1/agent-plugins/events` active, and refreshes discovered plugin Pi
-  resources on `/api/v1/agent/reload`.
+- `true` (default): keeps `/api/v1/agent-plugins/events` active and refreshes
+  discovered plugin Pi resources on `/api/v1/agent/reload`.
 - `false`: static discovery/listing remains available, but package resources
-  are snapped once at boot and the developer reload endpoint is disabled.
+  are snapped once at boot and canonical reload skips plugin hot-refresh work.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-workspace",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "type": "module",
   "license": "MIT",
   "description": "Workspace UI, plugin, and bridge package for composing chat, files, catalogs, editors, and app-specific panes.",
@@ -49,6 +49,11 @@
       "import": "./dist/server.js",
       "default": "./dist/server.js"
     },
+    "./runtime-server": {
+      "types": "./dist/runtime-server.d.ts",
+      "import": "./dist/runtime-server.js",
+      "default": "./dist/runtime-server.js"
+    },
     "./events": {
       "types": "./dist/events.d.ts",
       "import": "./dist/events.js"
@@ -130,8 +135,9 @@
     "tailwind-merge": "^2.0.0",
     "zod": "^3.23.0",
     "zustand": "^5.0.0",
-    "@hachej/boring-agent": "0.1.33",
-    "@hachej/boring-ui-kit": "0.1.33"
+    "@hachej/boring-agent": "0.1.35",
+    "@hachej/boring-ui-plugin-cli": "0.1.35",
+    "@hachej/boring-ui-kit": "0.1.35"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.0.0",
@@ -154,7 +160,7 @@
     "typescript": "^5.4.0",
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^2.0.0",
+    "vitest": "^3.2.6",
     "@boring-fixtures/default-plugin": "0.0.0"
   },
   "scripts": {