@hachej/boring-workspace 0.1.34 → 0.1.36

package/dist/app-server.d.ts

@@ -1,10 +1,11 @@
 import { PiPackageSource, PiExtensionFactory, CreateAgentAppOptions, ProvisionWorkspaceRuntimeOptions } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 import { FastifyInstance } from 'fastify';
-import { W as WorkspaceServerPlugin, S as ServerBootstrapOptions, B as BoringPluginSourceInput, a as BoringPluginFrontTargetResolver, b as WorkspaceProvisioningContribution, c as WorkspaceRouteContribution, d as createInMemoryBridge } from './createInMemoryBridge-zb8MpO60.js';
-export { e as ServerWorkspaceRuntimeProvisioningInput } from './createInMemoryBridge-zb8MpO60.js';
+import { W as WorkspaceServerPlugin, S as ServerBootstrapOptions, B as BoringPluginSourceInput, a as BoringPluginFrontTargetResolver, b as WorkspaceProvisioningContribution, c as WorkspaceRouteContribution, d as createInMemoryBridge } from './createInMemoryBridge-e7QdNLSA.js';
+export { e as ServerWorkspaceRuntimeProvisioningInput } from './createInMemoryBridge-e7QdNLSA.js';
 import './manifest-C2vVgH_e.js';
-import './ui-bridge-DFNem0df.js';
+import './agent-tool-CB0RQyx9.js';
+import './ui-bridge-LeBuZqfA.js';
 
 /**
  * Directory-source entry: `{ dir, options?, hotReload? }`. Resolved via

package/dist/app-server.js

@@ -111,6 +111,12 @@ function buildBoringSystemPrompt(opts) {
       "- Dependency installs: do NOT install plugin UI dependencies at the workspace root. Install them inside `.pi/extensions/<name>/` and keep React/workspace/boring-ui-kit imports as host singletons, not plugin dependencies.",
       "- Hot-reload agent tools: do NOT put them in `.pi/extensions/<name>/server/index.ts`; use `pi.extensions` instead. `boring.server` requires static composition plus process restart."
     ].join("\n"),
+    [
+      "## Installing an existing or published plugin",
+      "To ADD an existing or published plugin (not author a new one), use `boring-ui-plugin install <source>` via bash \u2014 `<source>` is `npm:<package>`, `git:<repo>`, `github:<owner>/<repo>`, an `http(s)` git URL, or a local path; add `--global` for all workspaces (default is this workspace).",
+      "A bare `npm install <package>` does NOT register it as a plugin (no `.pi/settings.json` package source), so it will NOT load \u2014 always use `boring-ui-plugin install`, then ask the user to `/reload` (a `boring.server` backend also needs a process restart).",
+      "Inspect with `boring-ui-plugin list [--json]`; remove with `boring-ui-plugin remove <id-or-source>`."
+    ].join("\n"),
     docsBlock
   ].join("\n\n");
 }
@@ -994,6 +1000,16 @@ var BoringPluginAssetManager = class {
     this.frontTargetResolver = options.frontTargetResolver;
     this.includeLegacyFrontUrl = options.includeLegacyFrontUrl ?? true;
   }
+  /**
+   * Replace the scanned source roots. Lets hosts re-resolve discovery inputs
+   * (e.g. workspace `.pi/settings.json` package sources, which can gain
+   * entries after `boring-ui-plugin install`) before the next load() so
+   * `/reload` picks up newly installed plugin sources without a process
+   * restart.
+   */
+  setPluginDirs(pluginDirs) {
+    this.pluginDirs = pluginDirs;
+  }
   preflight() {
     return preflightBoringPlugins(this.pluginDirs);
   }
@@ -1973,6 +1989,20 @@ function createInMemoryBridge() {
   };
 }
 
+// src/shared/plugins/uiBridgeRegistry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@hachej/boring-workspace:active-ui-bridge");
+function slot() {
+  return globalThis;
+}
+function registerWorkspaceUiBridge(bridge) {
+  slot()[REGISTRY_KEY] = bridge;
+  return () => {
+    if (slot()[REGISTRY_KEY] === bridge) {
+      slot()[REGISTRY_KEY] = void 0;
+    }
+  };
+}
+
 // src/server/ui-control/tools/uiTools.ts
 import { stat } from "fs/promises";
 import { resolve as resolve6, isAbsolute as isAbsolute4, relative as relative3, win32 } from "path";
@@ -2879,6 +2909,7 @@ function readWorkspacePluginPackagePiSnapshot(pluginDirs) {
 async function createWorkspaceAgentServer(opts = {}) {
   const workspaceRoot = opts.workspaceRoot ?? process.cwd();
   const bridge = createInMemoryBridge();
+  const unregisterUiBridge = registerWorkspaceUiBridge(bridge);
   const resolvedMode = opts.runtimeModeAdapter?.id ?? opts.mode ?? autoDetectMode();
   const modeAdapter = opts.runtimeModeAdapter ?? resolveMode(resolvedMode);
   const workspaceFsCapability = modeAdapter.workspaceFsCapability ?? "best-effort";
@@ -3056,6 +3087,7 @@ async function createWorkspaceAgentServer(opts = {}) {
   if (typeof app.addHook === "function") {
     app.addHook("onClose", async () => {
       await runtimeBackendRegistry.close();
+      unregisterUiBridge();
     });
   }
   await app.register(uiRoutes, { bridge, preserveStateKeys: pluginCollection.preservedUiStateKeys });

package/dist/boring-workspace.css

@@ -1 +1 @@
-.dv-shell{--dv-background-color: var(--background);--dv-paneview-header-border-color: var(--border);--dv-tabs-and-actions-container-font-size: .8125rem;--dv-tabs-and-actions-container-height: 52px;--dv-tab-close-icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='10' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E");--dv-group-view-background-color: var(--background);--dv-tabs-and-actions-container-background-color: var(--background);--dv-activegroup-visiblepanel-tab-background-color: var(--background);--dv-activegroup-hiddenpanel-tab-background-color: var(--muted);--dv-inactivegroup-visiblepanel-tab-background-color: var(--background);--dv-inactivegroup-hiddenpanel-tab-background-color: var(--muted);--dv-activegroup-visiblepanel-tab-color: var(--foreground);--dv-activegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-inactivegroup-visiblepanel-tab-color: var(--foreground);--dv-inactivegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-tab-divider-color: transparent;--dv-drag-over-background-color: oklch(from var(--accent) l c h / .3);--dv-drag-over-border-color: var(--accent);--dv-separator-border: var(--border);color:var(--foreground);background-color:var(--background)}.dv-shell .dv-tabs-and-actions-container,.dv-shell .tabs-and-actions-container{background-color:var(--background)!important;border-bottom:1px solid oklch(from var(--border) l c h / .4);padding:6px 8px 0;gap:4px;align-items:flex-end}.dv-shell .dv-tabs-container,.dv-shell .tab-container{background-color:transparent!important;gap:4px;align-self:stretch;display:flex;align-items:flex-end}.workbench-dockview .dv-shell .dv-tabs-and-actions-container,.workbench-dockview .dv-shell .tabs-and-actions-container,.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{height:44px!important}.workbench-dockview[data-collapsed-sources=true] .dv-tabs-and-actions-container,.workbench-dockview[data-collapsed-sources=true] .tabs-and-actions-container{padding-left:44px!important}.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{padding-right:44px!important}.dv-shell .dv-tab,.dv-shell .tab{color:var(--muted-foreground)!important;background-color:transparent!important;border:1px solid transparent;border-top-left-radius:8px;border-top-right-radius:8px;transition:color .18s cubic-bezier(.22,1,.36,1),background-color .18s cubic-bezier(.22,1,.36,1),border-color .18s cubic-bezier(.22,1,.36,1);min-width:120px;max-width:220px;padding:0;height:34px;align-self:end;font-size:12.5px;letter-spacing:-.01em}.dv-shell .dv-tab:hover,.dv-shell .tab:hover{color:var(--foreground)!important;background-color:oklch(from var(--foreground) l c h / .04)!important}.dv-shell .dv-tab>*,.dv-shell .tab>*{width:100%;height:100%}.dv-shell .dv-tab.dv-active-tab,.dv-shell .tab.active-tab{color:var(--foreground)!important;background-color:var(--background)!important;border-color:oklch(from var(--border) l c h / .5);border-bottom-color:var(--background);margin-bottom:-1px;position:relative;z-index:1;font-weight:500}.dv-shell .dv-tab.dv-active-tab:before,.dv-shell .tab.active-tab:before{content:"";position:absolute;left:10px;right:10px;top:-1px;height:2px;background:var(--accent);border-radius:0 0 2px 2px;opacity:0;transition:opacity .2s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-tab.dv-active-tab:hover:before,.dv-shell .tab.active-tab:hover:before{opacity:.7}.dv-shell .sash-container .sash,.dv-shell .dv-sash-container .dv-sash{transition:background-color .2s}.dv-shell .sash-container .sash:hover,.dv-shell .sash-container .sash.active,.dv-shell .dv-sash-container .dv-sash:hover,.dv-shell .dv-sash-container .dv-sash.dv-active{background-color:var(--primary);transition-delay:.15s}.dv-shell .drop-target-dropzone>.drop-target-selection,.dv-shell .dv-drop-target-dropzone>.dv-drop-target-selection{background-color:oklch(from var(--primary) l c h / .15);border:2px dashed var(--primary);border-radius:calc(var(--radius) - 2px)}.dv-shell .watermark,.dv-shell .dv-watermark{color:var(--muted-foreground)}.dv-shell,.dv-shell .dv-dockview,.dv-shell .dv-groupview,.dv-shell .groupview,.dv-shell .groupview>.content-container,.dv-shell .dv-view-container,.dv-shell .view-container{background-color:var(--background)}.dv-shell .dv-groupview,.dv-shell .groupview{color:var(--foreground)}.dv-shell .right-actions-container,.dv-shell .left-actions-container,.dv-shell .dv-right-actions-container,.dv-shell .dv-left-actions-container{color:var(--muted-foreground);display:flex;align-items:center;align-self:stretch}.dv-shell .right-actions-container:hover,.dv-shell .left-actions-container:hover,.dv-shell .dv-right-actions-container:hover,.dv-shell .dv-left-actions-container:hover{color:var(--foreground)}.dv-shell .dv-drag-image{opacity:.85;border:1px solid var(--border);border-radius:calc(var(--radius) - 2px);box-shadow:0 4px 12px #00000026}
+.dv-shell{--dv-background-color: var(--background);--dv-paneview-header-border-color: var(--border);--dv-tabs-and-actions-container-font-size: .8125rem;--dv-tabs-and-actions-container-height: 52px;--dv-tab-close-icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='10' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E");--dv-group-view-background-color: var(--background);--dv-tabs-and-actions-container-background-color: var(--background);--dv-activegroup-visiblepanel-tab-background-color: var(--background);--dv-activegroup-hiddenpanel-tab-background-color: var(--muted);--dv-inactivegroup-visiblepanel-tab-background-color: var(--background);--dv-inactivegroup-hiddenpanel-tab-background-color: var(--muted);--dv-activegroup-visiblepanel-tab-color: var(--foreground);--dv-activegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-inactivegroup-visiblepanel-tab-color: var(--foreground);--dv-inactivegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-tab-divider-color: transparent;--dv-drag-over-background-color: oklch(from var(--accent) l c h / .3);--dv-drag-over-border-color: var(--accent);--dv-separator-border: var(--border);color:var(--foreground);background-color:var(--background)}.dv-shell .dv-tabs-and-actions-container,.dv-shell .tabs-and-actions-container{background-color:var(--background)!important;border-bottom:1px solid oklch(from var(--border) l c h / .4);padding:6px 8px 0;gap:4px;align-items:flex-end}.dv-shell .dv-tabs-container,.dv-shell .tab-container{background-color:transparent!important;gap:4px;align-self:stretch;display:flex;align-items:flex-end}.workbench-dockview .dv-shell .dv-tabs-and-actions-container,.workbench-dockview .dv-shell .tabs-and-actions-container,.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{height:44px!important}.workbench-dockview[data-collapsed-sources=true] .dv-tabs-and-actions-container,.workbench-dockview[data-collapsed-sources=true] .tabs-and-actions-container{padding-left:44px!important}.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{padding-right:44px!important}.dv-shell .dv-tab,.dv-shell .tab{color:var(--muted-foreground)!important;background-color:transparent!important;border:1px solid transparent;border-top-left-radius:8px;border-top-right-radius:8px;transition:color .18s cubic-bezier(.22,1,.36,1),background-color .18s cubic-bezier(.22,1,.36,1),border-color .18s cubic-bezier(.22,1,.36,1);min-width:120px;max-width:220px;padding:0;height:34px;align-self:end;font-size:12.5px;letter-spacing:-.01em}.dv-shell .dv-tab:hover,.dv-shell .tab:hover{color:var(--foreground)!important;background-color:oklch(from var(--foreground) l c h / .04)!important}.dv-shell .dv-tab>*,.dv-shell .tab>*{width:100%;height:100%}.dv-shell .dv-tab.dv-active-tab,.dv-shell .tab.active-tab{color:var(--foreground)!important;background-color:var(--background)!important;border-color:oklch(from var(--border) l c h / .5);border-bottom-color:var(--background);margin-bottom:-1px;position:relative;z-index:1;font-weight:500}.dv-shell .dv-tab.dv-active-tab:before,.dv-shell .tab.active-tab:before{content:"";position:absolute;left:10px;right:10px;top:-1px;height:2px;background:var(--accent);border-radius:0 0 2px 2px;opacity:0;transition:opacity .2s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-tab.dv-active-tab:hover:before,.dv-shell .tab.active-tab:hover:before{opacity:.7}.dv-shell .sash-container .sash,.dv-shell .dv-sash-container .dv-sash{transition:background-color .2s}.dv-shell .sash-container .sash:hover,.dv-shell .sash-container .sash.active,.dv-shell .dv-sash-container .dv-sash:hover,.dv-shell .dv-sash-container .dv-sash.dv-active{background-color:var(--primary);transition-delay:.15s}.dv-shell .drop-target-dropzone>.drop-target-selection,.dv-shell .dv-drop-target-dropzone>.dv-drop-target-selection{background-color:oklch(from var(--primary) l c h / .15);border:2px dashed var(--primary);border-radius:calc(var(--radius) - 2px)}.dv-shell .watermark,.dv-shell .dv-watermark{color:var(--muted-foreground)}.dv-shell,.dv-shell .dv-dockview,.dv-shell .dv-groupview,.dv-shell .groupview,.dv-shell .groupview>.content-container,.dv-shell .dv-view-container,.dv-shell .view-container{background-color:var(--background)}.dv-shell .dv-groupview,.dv-shell .groupview{color:var(--foreground)}.dv-shell .right-actions-container,.dv-shell .left-actions-container,.dv-shell .dv-right-actions-container,.dv-shell .dv-left-actions-container{color:var(--muted-foreground);display:flex;align-items:center;align-self:stretch}.dv-shell .right-actions-container:hover,.dv-shell .left-actions-container:hover,.dv-shell .dv-right-actions-container:hover,.dv-shell .dv-left-actions-container:hover{color:var(--foreground)}.dv-shell .dv-drag-image{opacity:.85;border:1px solid var(--border);border-radius:calc(var(--radius) - 2px);box-shadow:0 4px 12px #00000026}.dv-chat-stage{--dv-tabs-and-actions-container-height: 32px;--dv-tabs-and-actions-container-font-size: .75rem;--dv-activegroup-visiblepanel-tab-background-color: transparent;--dv-activegroup-hiddenpanel-tab-background-color: transparent;--dv-inactivegroup-visiblepanel-tab-background-color: transparent;--dv-inactivegroup-hiddenpanel-tab-background-color: transparent}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container{border-bottom:none;padding:0;gap:0;align-items:stretch}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-tabs-container{width:100%}.dv-shell.dv-chat-stage .dv-tab,.dv-shell.dv-chat-stage .dv-tab.dv-active-tab{width:100%;height:100%;min-width:0;max-width:none;flex:1 1 auto;align-self:stretch;margin-bottom:0;padding:0;border:none;border-radius:0;background-color:transparent!important}.dv-shell.dv-chat-stage .dv-tab.dv-active-tab:before{content:none}.dv-chat-stage .dv-default-tab-action{display:none}.dv-chat-stage .dv-groupview{position:relative}.dv-chat-stage .dv-groupview:after{content:"";position:absolute;top:0;right:0;bottom:0;left:0;z-index:40;pointer-events:none;background:transparent;transition:background-color .22s cubic-bezier(.22,1,.36,1),box-shadow .22s cubic-bezier(.22,1,.36,1)}[data-boring-workspace-part=chat-pane-stage][data-multi-pane=true] .dv-groupview:not(.dv-active-group):after{background:oklch(from var(--foreground) l c h / .035)}

package/dist/{createInMemoryBridge-zb8MpO60.d.ts → createInMemoryBridge-e7QdNLSA.d.ts}

@@ -1,7 +1,8 @@
 import { B as BoringPackageBoringField, a as BoringPackagePiField } from './manifest-C2vVgH_e.js';
 import { PiPackageSource, PluginSkillSource, ProvisionWorkspaceRuntimeOptions } from '@hachej/boring-agent/server';
 import { FastifyPluginAsync } from 'fastify';
-import { A as AgentTool, U as UiBridge } from './ui-bridge-DFNem0df.js';
+import { A as AgentTool } from './agent-tool-CB0RQyx9.js';
+import { U as UiBridge } from './ui-bridge-LeBuZqfA.js';
 
 type BoringPluginNativeFrontTargetTrust$1 = "local-trusted-native";
 /**

package/dist/plugin.d.ts

@@ -2,6 +2,7 @@ import { ComponentType, ReactNode } from 'react';
 import { P as PaneProps, a as PanelConfig, S as SurfaceOpenRequest, c as SurfacePanelResolution } from './surface-obE7YwJk.js';
 export { W as WORKSPACE_OPEN_PATH_SURFACE_KIND } from './surface-obE7YwJk.js';
 export { B as BoringPackageBoringField, a as BoringPackagePiField, b as BoringPackagePiSource, c as BoringPackagePiSourceObject, d as BoringPluginManifestErrorCode, e as BoringPluginManifestIssue, f as BoringPluginManifestValidationResult, g as BoringPluginPackageJson, i as isSafePluginRelativePath, h as isValidBoringPluginId, v as validateBoringPluginManifest } from './manifest-C2vVgH_e.js';
+import { a as UiCommand, C as CommandResult, U as UiBridge } from './ui-bridge-LeBuZqfA.js';
 import 'dockview-react';
 
 type CatalogBadge = {
@@ -128,6 +129,11 @@ interface BoringFrontSurfaceResolverRegistration {
     source?: string;
     resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
 }
+type BoringFrontToolRenderer = (part: unknown) => ReactNode;
+interface BoringFrontToolRendererRegistration {
+    id: string;
+    render: BoringFrontToolRenderer;
+}
 interface BoringFrontAPI {
     registerProvider(registration: BoringFrontProviderRegistration): void;
     registerBinding(registration: BoringFrontBindingRegistration): void;
@@ -136,6 +142,7 @@ interface BoringFrontAPI {
     registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
     registerLeftTab<T = LeftTabParams>(registration: BoringFrontLeftTabRegistration<T>): void;
     registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): void;
+    registerToolRenderer(registration: BoringFrontToolRendererRegistration): void;
 }
 type BoringFrontFactory = (api: BoringFrontAPI) => void | Promise<void>;
 type BoringFrontSetup = (api: BoringFrontAPI) => void;
@@ -164,6 +171,7 @@ interface DefinePluginConfig {
     providers?: ReadonlyArray<BoringFrontProviderRegistration>;
     bindings?: ReadonlyArray<BoringFrontBindingRegistration>;
     catalogs?: ReadonlyArray<CatalogConfig>;
+    toolRenderers?: ReadonlyArray<BoringFrontToolRendererRegistration>;
     /**
      * Escape hatch for registrations that can't be expressed declaratively.
      * Called LAST, after every declarative field has been registered.
@@ -187,6 +195,7 @@ interface CapturedBoringFrontRegistrations {
     panelCommands: BoringFrontPanelCommandRegistration[];
     leftTabs: BoringFrontLeftTabRegistration<any>[];
     surfaceResolvers: BoringFrontSurfaceResolverRegistration[];
+    toolRenderers: BoringFrontToolRendererRegistration[];
 }
 interface CapturedFrontPlugin {
     id: string;
@@ -201,4 +210,67 @@ declare function createCapturingBoringFrontAPI(options?: {
 }): CapturingBoringFrontAPIHandle;
 declare function captureFrontPlugin(plugin: BoringFrontFactoryWithId): CapturedFrontPlugin;
 
-export { type BoringFrontAPI, type BoringFrontBindingRegistration, type BoringFrontFactory, type BoringFrontFactoryWithId, type BoringFrontLeftTabRegistration, type BoringFrontPanelCommandRegistration, type BoringFrontPanelRegistration, type BoringFrontProviderRegistration, type BoringFrontSetup, type BoringFrontSurfaceResolverRegistration, type CapturedBoringFrontRegistrations, type CapturedFrontPlugin, type CapturingBoringFrontAPIHandle, type DefinePluginConfig, PaneProps, captureFrontPlugin, createCapturingBoringFrontAPI, definePlugin };
+/**
+ * In-process registry that lets a plugin's Pi slash command reach the live
+ * workspace `UiBridge` WITHOUT an HTTP round-trip or a `BORING_UI_URL` env var.
+ *
+ * Why this exists
+ * ---------------
+ * A Pi extension slash-command handler only receives Pi's terminal-oriented
+ * `ctx.ui` (notify/select/confirm). It has no concept of the boring-ui
+ * workspace UI bridge, so the old canonical template resorted to
+ * `fetch(BORING_UI_URL + "/api/v1/ui/commands")` — fragile, and it silently
+ * no-op'd whenever the env var was unset (which is the common case). The bridge
+ * is already an in-process object owned by the agent server, so the right thing
+ * is to call `bridge.postCommand(...)` directly — the exact same path the
+ * agent's `exec_ui` tool uses.
+ *
+ * Why globalThis
+ * --------------
+ * Hot-reloadable plugins are loaded by Pi through jiti, which keeps its own
+ * module cache. A plain module-level singleton populated by the server is NOT
+ * guaranteed to be the same instance the plugin imports. `globalThis` is shared
+ * across every module realm in the process, so a `Symbol.for`-keyed slot is the
+ * one storage that both the server and a jiti-loaded plugin observe identically.
+ *
+ * This module is browser-safe (only `globalThis` + types), so it can live on
+ * the `@hachej/boring-workspace/plugin` authoring surface.
+ */
+
+/** The active workspace `UiBridge`, or `undefined` when none is registered. */
+declare function getWorkspaceUiBridge(): UiBridge | undefined;
+/**
+ * Thrown by the plugin-facing helpers when no workspace bridge is active — for
+ * example when plugin code runs under a bare Pi CLI with no workspace UI
+ * attached. The message is deliberately actionable.
+ */
+declare class NoWorkspaceUiBridgeError extends Error {
+    constructor();
+}
+/**
+ * Dispatch an arbitrary UI command through the active workspace bridge. This is
+ * the same call the agent's `exec_ui` tool makes; the connected browser drains
+ * the command. Prefer the named helpers below for common actions.
+ */
+declare function execWorkspaceUi(command: UiCommand): Promise<CommandResult>;
+interface OpenPanelArgs {
+    /** Tab instance id. Reuse the same id to re-activate an existing tab. */
+    id: string;
+    /** Panel component id (one of the workspace's registered panels). */
+    component: string;
+    /** Optional params forwarded to the panel component. */
+    params?: Record<string, unknown>;
+}
+/**
+ * Open an app/plugin panel in the workspace from a plugin slash command.
+ * In-process — no URL, no env. Throws `NoWorkspaceUiBridgeError` if no bridge.
+ */
+declare function openPanel(args: OpenPanelArgs): Promise<CommandResult>;
+/**
+ * Show a workspace notification (toast) from a plugin slash command. Unlike
+ * Pi's `ctx.ui.notify` (a terminal notification that is swallowed in
+ * server/headless mode), this surfaces in the browser via the UI bridge.
+ */
+declare function notify(msg: string, level?: "info" | "warn" | "error"): Promise<CommandResult>;
+
+export { type BoringFrontAPI, type BoringFrontBindingRegistration, type BoringFrontFactory, type BoringFrontFactoryWithId, type BoringFrontLeftTabRegistration, type BoringFrontPanelCommandRegistration, type BoringFrontPanelRegistration, type BoringFrontProviderRegistration, type BoringFrontSetup, type BoringFrontSurfaceResolverRegistration, type CapturedBoringFrontRegistrations, type CapturedFrontPlugin, type CapturingBoringFrontAPIHandle, type DefinePluginConfig, NoWorkspaceUiBridgeError, type OpenPanelArgs, PaneProps, captureFrontPlugin, createCapturingBoringFrontAPI, definePlugin, execWorkspaceUi, getWorkspaceUiBridge, notify, openPanel };

package/dist/plugin.js

@@ -29,6 +29,7 @@ function definePlugin(config) {
     for (const provider of config.providers ?? []) api.registerProvider(provider);
     for (const binding of config.bindings ?? []) api.registerBinding(binding);
     for (const catalog of config.catalogs ?? []) api.registerCatalog(catalog);
+    for (const renderer of config.toolRenderers ?? []) api.registerToolRenderer(renderer);
     if (config.setup) config.setup(api);
     return void 0;
   };
@@ -57,6 +58,7 @@ function createCapturingBoringFrontAPI(options = {}) {
   const panelCommands = [];
   const leftTabs = [];
   const surfaceResolvers = [];
+  const toolRenderers = [];
   const seen = /* @__PURE__ */ new Map();
   const claim = (kind, id) => {
     const key = `${kind}:${id}`;
@@ -104,6 +106,10 @@ function createCapturingBoringFrontAPI(options = {}) {
       }
       surfaceResolvers.push(registration);
     },
+    registerToolRenderer(registration) {
+      claim("tool-renderer", registration.id);
+      toolRenderers.push(registration);
+    },
     flush() {
       return {
         providers: clone(providers),
@@ -112,7 +118,8 @@ function createCapturingBoringFrontAPI(options = {}) {
         panels: clone(panels),
         panelCommands: clone(panelCommands),
         leftTabs: clone(leftTabs),
-        surfaceResolvers: clone(surfaceResolvers)
+        surfaceResolvers: clone(surfaceResolvers),
+        toolRenderers: clone(toolRenderers)
       };
     }
   };
@@ -290,12 +297,51 @@ function validateBoringPluginManifest(raw) {
 
 // src/shared/types/surface.ts
 var WORKSPACE_OPEN_PATH_SURFACE_KIND = "workspace.open.path";
+
+// src/shared/plugins/uiBridgeRegistry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@hachej/boring-workspace:active-ui-bridge");
+function slot() {
+  return globalThis;
+}
+function getWorkspaceUiBridge() {
+  return slot()[REGISTRY_KEY];
+}
+var NoWorkspaceUiBridgeError = class extends Error {
+  constructor() {
+    super(
+      "No workspace UI bridge is active. This plugin command must run inside a boring-ui workspace agent (it cannot open panels from a bare Pi CLI)."
+    );
+    this.name = "NoWorkspaceUiBridgeError";
+  }
+};
+function requireBridge() {
+  const bridge = getWorkspaceUiBridge();
+  if (!bridge) throw new NoWorkspaceUiBridgeError();
+  return bridge;
+}
+async function execWorkspaceUi(command) {
+  return requireBridge().postCommand(command);
+}
+async function openPanel(args) {
+  return execWorkspaceUi({
+    kind: "openPanel",
+    params: { id: args.id, component: args.component, params: args.params }
+  });
+}
+async function notify(msg, level = "info") {
+  return execWorkspaceUi({ kind: "showNotification", params: { msg, level } });
+}
 export {
+  NoWorkspaceUiBridgeError,
   WORKSPACE_OPEN_PATH_SURFACE_KIND,
   captureFrontPlugin,
   createCapturingBoringFrontAPI,
   definePlugin,
+  execWorkspaceUi,
+  getWorkspaceUiBridge,
   isSafePluginRelativePath,
   isValidBoringPluginId,
+  notify,
+  openPanel,
   validateBoringPluginManifest
 };

package/dist/server.d.ts

@@ -1,8 +1,9 @@
-import { f as WorkspaceServerPluginAsset, g as BoringServerPluginManifest, B as BoringPluginSourceInput, a as BoringPluginFrontTargetResolver, h as BoringPluginListEntry, i as BoringPluginFrontTarget, j as BoringPluginSource, k as BoringPluginEvent, P as PluginRestartSurface } from './createInMemoryBridge-zb8MpO60.js';
-export { l as BoringPluginFrontTargetResolverContext, m as BoringPluginNativeFrontTarget, n as BoringPluginNativeFrontTargetTrust, o as BoringPluginSourceKind, S as ServerBootstrapOptions, p as ServerBootstrapResult, b as WorkspaceProvisioningContribution, c as WorkspaceRouteContribution, W as WorkspaceServerPlugin, q as bootstrapServer, d as createInMemoryBridge, r as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge-zb8MpO60.js';
+import { f as WorkspaceServerPluginAsset, g as BoringServerPluginManifest, B as BoringPluginSourceInput, a as BoringPluginFrontTargetResolver, h as BoringPluginListEntry, i as BoringPluginFrontTarget, j as BoringPluginSource, k as BoringPluginEvent, P as PluginRestartSurface } from './createInMemoryBridge-e7QdNLSA.js';
+export { l as BoringPluginFrontTargetResolverContext, m as BoringPluginNativeFrontTarget, n as BoringPluginNativeFrontTargetTrust, o as BoringPluginSourceKind, S as ServerBootstrapOptions, p as ServerBootstrapResult, b as WorkspaceProvisioningContribution, c as WorkspaceRouteContribution, W as WorkspaceServerPlugin, q as bootstrapServer, d as createInMemoryBridge, r as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge-e7QdNLSA.js';
 import { FastifyRequest, FastifyInstance } from 'fastify';
-import { U as UiBridge, A as AgentTool } from './ui-bridge-DFNem0df.js';
-export { C as CommandResult, a as UiCommand, b as UiState } from './ui-bridge-DFNem0df.js';
+import { U as UiBridge } from './ui-bridge-LeBuZqfA.js';
+export { C as CommandResult, a as UiCommand, b as UiState } from './ui-bridge-LeBuZqfA.js';
+import { A as AgentTool } from './agent-tool-CB0RQyx9.js';
 import { PiPackageSource } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 import { PluginLogger } from './runtime-server.js';
@@ -226,7 +227,7 @@ interface LoadedBoringPluginPiSnapshot {
 }
 type Listener = (event: BoringPluginEvent) => void;
 declare class BoringPluginAssetManager {
-    private readonly pluginDirs;
+    private pluginDirs;
     private readonly errorRoot;
     private readonly frontTargetResolver?;
     private readonly includeLegacyFrontUrl;
@@ -237,6 +238,14 @@ declare class BoringPluginAssetManager {
     private loading;
     private reloadQueued;
     constructor(options: BoringPluginAssetManagerOptions);
+    /**
+     * Replace the scanned source roots. Lets hosts re-resolve discovery inputs
+     * (e.g. workspace `.pi/settings.json` package sources, which can gain
+     * entries after `boring-ui-plugin install`) before the next load() so
+     * `/reload` picks up newly installed plugin sources without a process
+     * restart.
+     */
+    setPluginDirs(pluginDirs: BoringPluginSourceInput[]): void;
     preflight(): BoringPluginPreflightResult;
     list(): BoringPluginListEntry[];
     getError(pluginId: string): string | null;

package/dist/server.js

@@ -1026,6 +1026,12 @@ function buildBoringSystemPrompt(opts) {
       "- Dependency installs: do NOT install plugin UI dependencies at the workspace root. Install them inside `.pi/extensions/<name>/` and keep React/workspace/boring-ui-kit imports as host singletons, not plugin dependencies.",
       "- Hot-reload agent tools: do NOT put them in `.pi/extensions/<name>/server/index.ts`; use `pi.extensions` instead. `boring.server` requires static composition plus process restart."
     ].join("\n"),
+    [
+      "## Installing an existing or published plugin",
+      "To ADD an existing or published plugin (not author a new one), use `boring-ui-plugin install <source>` via bash \u2014 `<source>` is `npm:<package>`, `git:<repo>`, `github:<owner>/<repo>`, an `http(s)` git URL, or a local path; add `--global` for all workspaces (default is this workspace).",
+      "A bare `npm install <package>` does NOT register it as a plugin (no `.pi/settings.json` package source), so it will NOT load \u2014 always use `boring-ui-plugin install`, then ask the user to `/reload` (a `boring.server` backend also needs a process restart).",
+      "Inspect with `boring-ui-plugin list [--json]`; remove with `boring-ui-plugin remove <id-or-source>`."
+    ].join("\n"),
     docsBlock
   ].join("\n\n");
 }
@@ -1624,6 +1630,16 @@ var BoringPluginAssetManager = class {
     this.frontTargetResolver = options.frontTargetResolver;
     this.includeLegacyFrontUrl = options.includeLegacyFrontUrl ?? true;
   }
+  /**
+   * Replace the scanned source roots. Lets hosts re-resolve discovery inputs
+   * (e.g. workspace `.pi/settings.json` package sources, which can gain
+   * entries after `boring-ui-plugin install`) before the next load() so
+   * `/reload` picks up newly installed plugin sources without a process
+   * restart.
+   */
+  setPluginDirs(pluginDirs) {
+    this.pluginDirs = pluginDirs;
+  }
   preflight() {
     return preflightBoringPlugins(this.pluginDirs);
   }

package/dist/shared.d.ts

@@ -1,5 +1,6 @@
-export { A as AgentTool, C as CommandResult, J as JSONSchema, T as ToolExecContext, c as ToolResult, U as UiBridge, a as UiCommand, b as UiState } from './ui-bridge-DFNem0df.js';
+export { C as CommandResult, U as UiBridge, a as UiCommand, b as UiState } from './ui-bridge-LeBuZqfA.js';
 export { C as CommandConfig, P as PaneProps, a as PanelConfig, b as PanelRegistration, S as SurfaceOpenRequest, c as SurfacePanelResolution, d as SurfaceResolverConfig, e as SurfaceResolverRegistration, W as WORKSPACE_OPEN_PATH_SURFACE_KIND, f as definePanel } from './surface-obE7YwJk.js';
+export { A as AgentTool, J as JSONSchema, T as ToolExecContext, a as ToolResult } from './agent-tool-CB0RQyx9.js';
 import 'react';
 import 'dockview-react';
 

package/dist/testing.js

@@ -1,7 +1,7 @@
 import { jsx as Ba } from "react/jsx-runtime";
 import * as Pa from "react";
 import { createElement as is, useMemo as wn, useLayoutEffect as us, isValidElement as ss, cloneElement as ds, useSyncExternalStore as Gi } from "react";
-import { h as cs, q as fs, o as ps } from "./WorkspaceProvider-hCE2wXKZ.js";
+import { h as cs, q as fs, o as ps } from "./WorkspaceProvider-CpK401MG.js";
 import { d as ms } from "./panel-DnvDNQac.js";
 import * as bs from "react-dom/test-utils";
 import ka from "react-dom";

package/dist/{ui-bridge-DFNem0df.d.ts → ui-bridge-LeBuZqfA.d.ts}

@@ -1,34 +1,3 @@
-type JSONSchema = Record<string, unknown>;
-type ToolReadinessRequirement = 'workspace-fs' | 'sandbox-exec' | 'ui-bridge' | 'runtime-dependencies' | `runtime:${string}`;
-interface ToolExecContext {
-    abortSignal: AbortSignal;
-    toolCallId: string;
-    onUpdate?: (partial: string) => void;
-    /** Agent chat/session id executing this tool, when known. */
-    sessionId?: string;
-}
-interface ToolResult {
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-    isError?: boolean;
-    details?: unknown;
-}
-/**
- * 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.
- */
-interface AgentTool {
-    name: string;
-    description: string;
-    promptSnippet?: string;
-    readinessRequirements?: ToolReadinessRequirement[];
-    parameters: JSONSchema;
-    execute(params: Record<string, unknown>, ctx: ToolExecContext): Promise<ToolResult>;
-}
-
 interface UiBridge {
     getState(): Promise<UiState | null>;
     setState(state: UiState): Promise<void>;
@@ -99,4 +68,4 @@ interface CommandResult {
     };
 }
 
-export type { AgentTool as A, CommandResult as C, JSONSchema as J, ToolExecContext as T, UiBridge as U, UiCommand as a, UiState as b, ToolResult as c };
+export type { CommandResult as C, UiBridge as U, UiCommand as a, UiState as b };