@hachej/boring-workspace 0.1.13 → 0.1.16

package/dist/app-server.d.ts

@@ -1,9 +1,9 @@
-import { CreateAgentAppOptions, PiPackageSource } from '@hachej/boring-agent/server';
+import { PiPackageSource, CreateAgentAppOptions } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 import { FastifyInstance } from 'fastify';
-import { S as ServerBootstrapOptions, W as WorkspaceProvisioningContribution, a as WorkspaceRouteContribution } from './bootstrapServer-BRUqUpVW.js';
-export { C as ComposeServerPluginsOptions, b as WorkspaceServerPlugin, c as composeServerPlugins, d as defineServerPlugin } from './bootstrapServer-BRUqUpVW.js';
-import './agent-tool-NvxKfist.js';
+import { S as ServerBootstrapOptions, c as createInMemoryBridge, W as WorkspaceServerPlugin, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution } from './bootstrapServer-BreQ9QBc.js';
+export { C as ComposeServerPluginsOptions, d as composeServerPlugins, e as defineServerPlugin } from './bootstrapServer-BreQ9QBc.js';
+import './agent-tool-DEtfQPVB.js';
 
 /**
  * Standalone workspace + agent Fastify composition.
@@ -21,27 +21,32 @@ interface WorkspaceAgentResourceLoaderOptions {
 type WorkspaceAgentCreateOptions = Omit<CreateAgentAppOptions, "resourceLoaderOptions"> & {
     resourceLoaderOptions?: WorkspaceAgentResourceLoaderOptions;
 };
+interface WorkspaceAgentServerPluginContext {
+    workspaceRoot: string;
+    bridge: ReturnType<typeof createInMemoryBridge>;
+}
+type WorkspaceAgentServerPluginFactory = (context: WorkspaceAgentServerPluginContext) => WorkspaceServerPlugin;
 interface CreateWorkspaceAgentServerOptions extends WorkspaceAgentCreateOptions, Pick<ServerBootstrapOptions, "plugins" | "defaults" | "excludeDefaults"> {
+    pluginFactories?: WorkspaceAgentServerPluginFactory[];
     provisionWorkspace?: boolean;
     workspaceProvisioning?: {
         force?: boolean;
     };
-    /**
-     * Whether exec_ui should stat-check file paths against the workspaceRoot
-     * before queueing the command. Defaults to true only for local host-backed
-     * modes (direct/local). Remote sandbox modes should leave this false because
-     * workspace files may not exist on the host server running Fastify.
-     */
     validateUiPaths?: boolean;
 }
 
 interface WorkspaceAgentServerPluginCollection {
     provisioningContributions: WorkspaceProvisioningContribution[];
     routeContributions: WorkspaceRouteContribution[];
+    preservedUiStateKeys: string[];
     agentOptions: Pick<WorkspaceAgentCreateOptions, "extraTools" | "systemPromptAppend" | "resourceLoaderOptions">;
 }
-interface CollectWorkspaceAgentServerPluginsOptions extends Pick<WorkspaceAgentCreateOptions, "workspaceRoot" | "systemPromptAppend" | "resourceLoaderOptions">, Pick<ServerBootstrapOptions, "plugins" | "defaults" | "excludeDefaults"> {
+interface CollectWorkspaceAgentServerPluginsOptions extends Pick<ServerBootstrapOptions, "plugins" | "defaults" | "excludeDefaults"> {
+    workspaceRoot?: string;
+    systemPromptAppend?: string;
+    resourceLoaderOptions?: WorkspaceAgentResourceLoaderOptions;
 }
+declare function buildWorkspaceContextPrompt(): string;
 declare function collectWorkspaceAgentServerPlugins(opts?: CollectWorkspaceAgentServerPluginsOptions): WorkspaceAgentServerPluginCollection;
 declare function provisionWorkspaceAgentServer(opts: {
     workspaceRoot: string;
@@ -50,4 +55,4 @@ declare function provisionWorkspaceAgentServer(opts: {
 }): Promise<void>;
 declare function createWorkspaceAgentServer(opts?: CreateWorkspaceAgentServerOptions): Promise<FastifyInstance>;
 
-export { type CollectWorkspaceAgentServerPluginsOptions, type CreateWorkspaceAgentServerOptions, type WorkspaceAgentResourceLoaderOptions, type WorkspaceAgentServerPluginCollection, WorkspaceProvisioningContribution, WorkspaceRouteContribution, collectWorkspaceAgentServerPlugins, createWorkspaceAgentServer, provisionWorkspaceAgentServer };
+export { type CollectWorkspaceAgentServerPluginsOptions, type CreateWorkspaceAgentServerOptions, type WorkspaceAgentResourceLoaderOptions, type WorkspaceAgentServerPluginCollection, type WorkspaceAgentServerPluginContext, type WorkspaceAgentServerPluginFactory, WorkspaceProvisioningContribution, WorkspaceRouteContribution, WorkspaceServerPlugin, buildWorkspaceContextPrompt, collectWorkspaceAgentServerPlugins, createWorkspaceAgentServer, provisionWorkspaceAgentServer };

package/dist/app-server.js

@@ -5,7 +5,54 @@ import {
   provisionRuntimeWorkspace,
   resolveMode
 } from "@hachej/boring-agent/server";
-import { join } from "path";
+import { join as join2 } from "path";
+
+// src/server/boringSystemPrompt.ts
+import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function resolveDocsPath() {
+  const override = process.env.BORING_DOCS_PATH;
+  if (override) return override;
+  const candidates = [
+    join(__dirname, "../docs"),
+    // dist/server.js → packages/workspace/docs/
+    join(__dirname, "../../docs")
+    // src/server/*.ts → packages/workspace/docs/
+  ];
+  return candidates.find(existsSync) ?? null;
+}
+function readDocOrFallback(docsPath, name) {
+  const file = join(docsPath, name);
+  try {
+    return existsSync(file) ? readFileSync(file, "utf-8").trim() : "";
+  } catch {
+    return "";
+  }
+}
+function buildBoringSystemPrompt() {
+  const docsPath = resolveDocsPath();
+  const intro = `You are an expert agent operating inside boring-ui, an open-source workspace for building agent-powered products. You help users by reading files, executing commands, editing code, and opening workspace panels.`;
+  if (!docsPath) {
+    return intro;
+  }
+  const plugins = readDocOrFallback(docsPath, "plugins.md");
+  const panels = readDocOrFallback(docsPath, "panels.md");
+  const bridge = readDocOrFallback(docsPath, "bridge.md");
+  const sections = [
+    plugins && `<boring-ui-docs topic="plugin-system">
+${plugins}
+</boring-ui-docs>`,
+    panels && `<boring-ui-docs topic="panel-components">
+${panels}
+</boring-ui-docs>`,
+    bridge && `<boring-ui-docs topic="ui-bridge">
+${bridge}
+</boring-ui-docs>`
+  ].filter(Boolean);
+  return [intro, ...sections].join("\n\n");
+}
 
 // src/server/bridge/createInMemoryBridge.ts
 var MAX_PENDING_COMMANDS = 1e3;
@@ -222,11 +269,11 @@ function createExecUiTool(uiBridge, opts = {}) {
       "               \u2014 Open a plugin-owned target through the workspace",
       "                 surface resolver registry. Use this when a plugin",
       "                 defines the mapping from domain target to panel",
-      "                 component, for example a data catalog row.",
+      "                 component, for example a catalog row.",
       "                 Example: {kind:'openSurface', params:{",
-      "                          kind:'data-catalog.open-row',",
+      "                          kind:'my-plugin.open-row',",
       "                          target:'orders_daily',",
-      "                          meta:{catalogId:'data-catalog'}}}",
+      "                          meta:{catalogId:'my-plugin'}}}",
       "",
       "  closePanel   params: { id: string }",
       "  closeWorkbenchLeftPane params: {}",
@@ -395,7 +442,11 @@ function uiRoutes(app, opts, done) {
     async (request, reply) => {
       const body = request.body;
       const bridge = await resolveBridge(request);
-      await bridge.setState(body.state);
+      const current = await bridge.getState() ?? {};
+      const preserved = Object.fromEntries(
+        (opts.preserveStateKeys ?? []).filter((key) => !(key in body.state) && key in current).map((key) => [key, current[key]])
+      );
+      await bridge.setState({ ...body.state, ...preserved });
       return reply.code(204).send();
     }
   );
@@ -608,6 +659,11 @@ function validateServerPlugin(plugin) {
   if (plugin.routes !== void 0 && typeof plugin.routes !== "function") {
     fail(plugin.id, "routes must be a Fastify plugin function when provided");
   }
+  if (plugin.preservedUiStateKeys !== void 0) {
+    if (!Array.isArray(plugin.preservedUiStateKeys) || plugin.preservedUiStateKeys.some((key) => typeof key !== "string" || key.length === 0)) {
+      fail(plugin.id, "preservedUiStateKeys must be a non-empty string array when provided");
+    }
+  }
   if (plugin.provisioning !== void 0) {
     validateProvisioning(plugin.id, plugin.provisioning);
   }
@@ -663,6 +719,10 @@ function composeServerPlugins(options) {
     ...options.plugins.map((plugin) => plugin.routes),
     options.routes
   ]);
+  const preservedUiStateKeys = [.../* @__PURE__ */ new Set([
+    ...options.plugins.flatMap((plugin) => plugin.preservedUiStateKeys ?? []),
+    ...options.preservedUiStateKeys ?? []
+  ])];
   return defineServerPlugin({
     id: options.id,
     ...options.label !== void 0 ? { label: options.label } : {},
@@ -670,7 +730,8 @@ function composeServerPlugins(options) {
     ...systemPrompt ? { systemPrompt } : {},
     ...agentTools.length > 0 ? { agentTools } : {},
     ...provisioning ? { provisioning } : {},
-    ...routes ? { routes } : {}
+    ...routes ? { routes } : {},
+    ...preservedUiStateKeys.length > 0 ? { preservedUiStateKeys } : {}
   });
 }
 
@@ -702,13 +763,15 @@ function bootstrapServer(options) {
   const piPackages = collectPiPackages(finalPlugins);
   const provisioningContributions = finalPlugins.filter((p) => p.provisioning).map((p) => ({ id: p.id, provisioning: p.provisioning }));
   const routeContributions = finalPlugins.filter((p) => p.routes).map((p) => ({ id: p.id, routes: p.routes }));
+  const preservedUiStateKeys = [...new Set(finalPlugins.flatMap((p) => p.preservedUiStateKeys ?? []))];
   return {
     registered: finalPlugins.map((p) => p.id),
     systemPromptAppend,
     piPackages,
     agentTools,
     provisioningContributions,
-    routeContributions
+    routeContributions,
+    preservedUiStateKeys
   };
 }
 
@@ -728,12 +791,13 @@ function collectWorkspaceAgentServerPlugins(opts = {}) {
     plugins: opts.plugins,
     excludeDefaults: opts.excludeDefaults
   });
-  const workspaceSkillsDir = join(workspaceRoot, ".agents", "skills");
+  const workspaceSkillsDir = join2(workspaceRoot, ".agents", "skills");
   const callerAdditional = opts.resourceLoaderOptions?.additionalSkillPaths ?? [];
   const callerPiPackages = opts.resourceLoaderOptions?.piPackages ?? [];
   return {
     provisioningContributions: result.provisioningContributions,
     routeContributions: result.routeContributions,
+    preservedUiStateKeys: result.preservedUiStateKeys,
     agentOptions: {
       extraTools: result.agentTools,
       systemPromptAppend: [opts.systemPromptAppend, result.systemPromptAppend].filter(Boolean).join("\n\n") || void 0,
@@ -762,7 +826,11 @@ async function createWorkspaceAgentServer(opts = {}) {
   const uiTools = createWorkspaceUiTools(bridge, {
     workspaceRoot: validateUiPaths ? workspaceRoot : void 0
   });
-  const pluginCollection = collectWorkspaceAgentServerPlugins(opts);
+  const factoryPlugins = opts.pluginFactories?.map((factory) => factory({ workspaceRoot, bridge })) ?? [];
+  const pluginCollection = collectWorkspaceAgentServerPlugins({
+    ...opts,
+    plugins: [...opts.plugins ?? [], ...factoryPlugins]
+  });
   if (opts.provisionWorkspace !== false) {
     await provisionWorkspaceAgentServer({
       workspaceRoot,
@@ -781,17 +849,19 @@ async function createWorkspaceAgentServer(opts = {}) {
     ],
     systemPromptAppend: [
       workspaceFsCapability === "strong" ? buildWorkspaceContextPrompt() : void 0,
+      buildBoringSystemPrompt(),
       pluginCollection.agentOptions.systemPromptAppend
     ].filter(Boolean).join("\n\n") || void 0,
     resourceLoaderOptions: pluginCollection.agentOptions.resourceLoaderOptions
   });
-  await app.register(uiRoutes, { bridge });
+  await app.register(uiRoutes, { bridge, preserveStateKeys: pluginCollection.preservedUiStateKeys });
   for (const { routes } of pluginCollection.routeContributions) {
     await app.register(routes);
   }
   return app;
 }
 export {
+  buildWorkspaceContextPrompt,
   collectWorkspaceAgentServerPlugins,
   composeServerPlugins,
   createWorkspaceAgentServer,

package/dist/{bootstrapServer-BRUqUpVW.d.ts → bootstrapServer-BreQ9QBc.d.ts}

@@ -1,6 +1,8 @@
+import { U as UiBridge, A as AgentTool } from './agent-tool-DEtfQPVB.js';
 import { PiPackageSource, RuntimeProvisioningContribution } from '@hachej/boring-agent/server';
 import { FastifyPluginAsync } from 'fastify';
-import { A as AgentTool } from './agent-tool-NvxKfist.js';
+
+declare function createInMemoryBridge(): UiBridge;
 
 interface WorkspaceServerPlugin {
     id: string;
@@ -15,6 +17,8 @@ interface WorkspaceServerPlugin {
     agentTools?: AgentTool[];
     provisioning?: RuntimeProvisioningContribution;
     routes?: FastifyPluginAsync;
+    /** UI state keys owned by this plugin that browser state PUTs must not overwrite. */
+    preservedUiStateKeys?: string[];
 }
 declare class ServerPluginError extends Error {
     constructor(message: string);
@@ -31,6 +35,7 @@ interface ComposeServerPluginsOptions {
     agentTools?: AgentTool[];
     provisioning?: RuntimeProvisioningContribution;
     routes?: FastifyPluginAsync;
+    preservedUiStateKeys?: string[];
 }
 /**
  * Compose a server plugin from smaller server plugin fragments. Child
@@ -60,7 +65,8 @@ interface ServerBootstrapResult {
     agentTools: AgentTool[];
     provisioningContributions: WorkspaceProvisioningContribution[];
     routeContributions: WorkspaceRouteContribution[];
+    preservedUiStateKeys: string[];
 }
 declare function bootstrapServer(options: ServerBootstrapOptions): ServerBootstrapResult;
 
-export { type ComposeServerPluginsOptions as C, type ServerBootstrapOptions as S, type WorkspaceProvisioningContribution as W, type WorkspaceRouteContribution as a, type WorkspaceServerPlugin as b, composeServerPlugins as c, defineServerPlugin as d, type ServerBootstrapResult as e, ServerPluginError as f, bootstrapServer as g, validateServerPlugin as v };
+export { type ComposeServerPluginsOptions as C, type ServerBootstrapOptions as S, type WorkspaceServerPlugin as W, type WorkspaceProvisioningContribution as a, type WorkspaceRouteContribution as b, createInMemoryBridge as c, composeServerPlugins as d, defineServerPlugin as e, type ServerBootstrapResult as f, ServerPluginError as g, bootstrapServer as h, validateServerPlugin as v };

package/dist/server.d.ts

@@ -1,16 +1,18 @@
-import { U as UiBridge, E as ExplorerAdapter, S as SearchResult } from './explorer-DtLUnuah.js';
-export { C as CommandResult, a as UiCommand, b as UiState } from './explorer-DtLUnuah.js';
+export { C as ComposeServerPluginsOptions, S as ServerBootstrapOptions, f as ServerBootstrapResult, g as ServerPluginError, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, W as WorkspaceServerPlugin, h as bootstrapServer, d as composeServerPlugins, c as createInMemoryBridge, e as defineServerPlugin, v as validateServerPlugin } from './bootstrapServer-BreQ9QBc.js';
 import { FastifyRequest, FastifyInstance } from 'fastify';
-import { A as AgentTool } from './agent-tool-NvxKfist.js';
-import { b as WorkspaceServerPlugin } from './bootstrapServer-BRUqUpVW.js';
-export { C as ComposeServerPluginsOptions, S as ServerBootstrapOptions, e as ServerBootstrapResult, f as ServerPluginError, W as WorkspaceProvisioningContribution, a as WorkspaceRouteContribution, g as bootstrapServer, c as composeServerPlugins, d as defineServerPlugin, v as validateServerPlugin } from './bootstrapServer-BRUqUpVW.js';
+import { U as UiBridge, A as AgentTool } from './agent-tool-DEtfQPVB.js';
+export { C as CommandResult, a as UiCommand, b as UiState } from './agent-tool-DEtfQPVB.js';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 
-declare function createInMemoryBridge(): UiBridge;
-
 interface UiRoutesOptions {
     bridge?: UiBridge;
     getBridge?: (request: FastifyRequest) => UiBridge | Promise<UiBridge>;
+    /**
+     * Server/plugin-owned state slots preserved across browser full-state PUTs.
+     * Browser UI snapshots are replace-style for normal workspace state, but
+     * these slots are published out-of-band by server plugins.
+     */
+    preserveStateKeys?: string[];
 }
 declare function uiRoutes(app: FastifyInstance, opts: UiRoutesOptions, done: (err?: Error) => void): void;
 
@@ -57,28 +59,4 @@ declare function createExecUiTool(uiBridge: UiBridge, opts?: ExecUiToolOptions):
  */
 declare function createWorkspaceUiTools(uiBridge: UiBridge, opts?: ExecUiToolOptions): AgentTool[];
 
-interface DataCatalogAgentToolOptions {
-    name?: string;
-    label?: string;
-    adapter: ExplorerAdapter;
-    defaultLimit?: number;
-    maxLimit?: number;
-}
-interface DataCatalogSkillOptions {
-    label?: string;
-    toolName?: string;
-    surfaceKind?: string;
-    guidance?: string;
-}
-interface DataCatalogServerPluginOptions extends DataCatalogAgentToolOptions, DataCatalogSkillOptions {
-    id?: string;
-}
-declare function formatDataCatalogSearchResult(query: string, result: SearchResult): string;
-declare function createDataCatalogAgentTool(options: DataCatalogAgentToolOptions): AgentTool;
-declare function createDataCatalogSkillPrompt(options?: DataCatalogSkillOptions): string;
-declare function createDataCatalogServerPlugin(options: DataCatalogServerPluginOptions): WorkspaceServerPlugin & {
-    agentTools: AgentTool[];
-    systemPrompt: string;
-};
-
-export { type DataCatalogAgentToolOptions, type DataCatalogServerPluginOptions, type DataCatalogSkillOptions, UiBridge, type UiRoutesOptions, WorkspaceServerPlugin, createDataCatalogAgentTool, createDataCatalogServerPlugin, createDataCatalogSkillPrompt, createExecUiTool, createGetUiStateTool, createInMemoryBridge, createWorkspaceUiTools, formatDataCatalogSearchResult, uiRoutes };
+export { UiBridge, type UiRoutesOptions, createExecUiTool, createGetUiStateTool, createWorkspaceUiTools, uiRoutes };

package/dist/server.js

@@ -93,7 +93,11 @@ function uiRoutes(app, opts, done) {
     async (request, reply) => {
       const body = request.body;
       const bridge = await resolveBridge(request);
-      await bridge.setState(body.state);
+      const current = await bridge.getState() ?? {};
+      const preserved = Object.fromEntries(
+        (opts.preserveStateKeys ?? []).filter((key) => !(key in body.state) && key in current).map((key) => [key, current[key]])
+      );
+      await bridge.setState({ ...body.state, ...preserved });
       return reply.code(204).send();
     }
   );
@@ -333,11 +337,11 @@ function createExecUiTool(uiBridge, opts = {}) {
       "               \u2014 Open a plugin-owned target through the workspace",
       "                 surface resolver registry. Use this when a plugin",
       "                 defines the mapping from domain target to panel",
-      "                 component, for example a data catalog row.",
+      "                 component, for example a catalog row.",
       "                 Example: {kind:'openSurface', params:{",
-      "                          kind:'data-catalog.open-row',",
+      "                          kind:'my-plugin.open-row',",
       "                          target:'orders_daily',",
-      "                          meta:{catalogId:'data-catalog'}}}",
+      "                          meta:{catalogId:'my-plugin'}}}",
       "",
       "  closePanel   params: { id: string }",
       "  closeWorkbenchLeftPane params: {}",
@@ -599,6 +603,11 @@ function validateServerPlugin(plugin) {
   if (plugin.routes !== void 0 && typeof plugin.routes !== "function") {
     fail(plugin.id, "routes must be a Fastify plugin function when provided");
   }
+  if (plugin.preservedUiStateKeys !== void 0) {
+    if (!Array.isArray(plugin.preservedUiStateKeys) || plugin.preservedUiStateKeys.some((key) => typeof key !== "string" || key.length === 0)) {
+      fail(plugin.id, "preservedUiStateKeys must be a non-empty string array when provided");
+    }
+  }
   if (plugin.provisioning !== void 0) {
     validateProvisioning(plugin.id, plugin.provisioning);
   }
@@ -654,6 +663,10 @@ function composeServerPlugins(options) {
     ...options.plugins.map((plugin) => plugin.routes),
     options.routes
   ]);
+  const preservedUiStateKeys = [.../* @__PURE__ */ new Set([
+    ...options.plugins.flatMap((plugin) => plugin.preservedUiStateKeys ?? []),
+    ...options.preservedUiStateKeys ?? []
+  ])];
   return defineServerPlugin({
     id: options.id,
     ...options.label !== void 0 ? { label: options.label } : {},
@@ -661,7 +674,8 @@ function composeServerPlugins(options) {
     ...systemPrompt ? { systemPrompt } : {},
     ...agentTools.length > 0 ? { agentTools } : {},
     ...provisioning ? { provisioning } : {},
-    ...routes ? { routes } : {}
+    ...routes ? { routes } : {},
+    ...preservedUiStateKeys.length > 0 ? { preservedUiStateKeys } : {}
   });
 }
 
@@ -693,145 +707,26 @@ function bootstrapServer(options) {
   const piPackages = collectPiPackages(finalPlugins);
   const provisioningContributions = finalPlugins.filter((p) => p.provisioning).map((p) => ({ id: p.id, provisioning: p.provisioning }));
   const routeContributions = finalPlugins.filter((p) => p.routes).map((p) => ({ id: p.id, routes: p.routes }));
+  const preservedUiStateKeys = [...new Set(finalPlugins.flatMap((p) => p.preservedUiStateKeys ?? []))];
   return {
     registered: finalPlugins.map((p) => p.id),
     systemPromptAppend,
     piPackages,
     agentTools,
     provisioningContributions,
-    routeContributions
-  };
-}
-
-// src/plugins/dataCatalogPlugin/shared/constants.ts
-var DATA_CATALOG_PLUGIN_ID = "data-catalog";
-var DATA_CATALOG_DEFAULT_TOOL_NAME = "query_data_catalog";
-var DATA_CATALOG_ROW_SURFACE_KIND = "data-catalog.open-row";
-
-// src/plugins/dataCatalogPlugin/server/index.ts
-function textResult(text, details) {
-  return { content: [{ type: "text", text }], details };
-}
-function errorResult(text) {
-  return { content: [{ type: "text", text }], isError: true };
-}
-function clampLimit(value, fallback, max) {
-  const numeric = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
-  if (!Number.isFinite(numeric)) return fallback;
-  return Math.max(1, Math.min(max, Math.floor(numeric)));
-}
-function normalizeLimitOptions(options) {
-  const rawMax = options.maxLimit ?? 50;
-  const maxLimit = typeof rawMax === "number" && Number.isFinite(rawMax) ? Math.max(1, Math.floor(rawMax)) : 50;
-  const rawDefault = options.defaultLimit ?? 20;
-  const defaultLimit = typeof rawDefault === "number" && Number.isFinite(rawDefault) ? Math.max(1, Math.min(maxLimit, Math.floor(rawDefault))) : Math.min(20, maxLimit);
-  return { defaultLimit, maxLimit };
-}
-function formatBadge(row) {
-  const parts = [
-    row.leading?.code,
-    ...(row.trailing ?? []).map((badge) => badge.code),
-    row.meta
-  ].filter(Boolean);
-  return parts.length > 0 ? ` [${parts.join(", ")}]` : "";
-}
-function formatDataCatalogSearchResult(query, result) {
-  if (result.items.length === 0) {
-    return `No ${query ? `results for "${query}"` : "catalog results"}.`;
-  }
-  const lines = result.items.map((row) => {
-    const subtitle = row.subtitle ? ` \u2014 ${row.subtitle}` : "";
-    return `${row.id}: ${row.title}${subtitle}${formatBadge(row)}`;
-  });
-  const total = Number.isFinite(result.total) ? result.total : result.items.length;
-  return `Found ${total} results (showing ${result.items.length}):
-
-${lines.join("\n")}`;
-}
-function createDataCatalogAgentTool(options) {
-  const name = options.name ?? DATA_CATALOG_DEFAULT_TOOL_NAME;
-  const label = options.label ?? "data catalog";
-  const { defaultLimit, maxLimit } = normalizeLimitOptions(options);
-  return {
-    name,
-    description: `Search the ${label}. Use this before opening data visualizations or asking for a specific dataset.`,
-    parameters: {
-      type: "object",
-      properties: {
-        query: {
-          type: "string",
-          description: "Search keywords for datasets, series, tables, or metrics."
-        },
-        limit: {
-          type: "number",
-          description: `Maximum number of results. Default ${defaultLimit}, max ${maxLimit}.`,
-          minimum: 1,
-          maximum: maxLimit
-        }
-      },
-      required: ["query"],
-      additionalProperties: false
-    },
-    async execute(params, ctx) {
-      const query = String(params.query ?? "").trim();
-      if (!query) return errorResult("query is required");
-      const limit = clampLimit(params.limit, defaultLimit, maxLimit);
-      try {
-        const result = await options.adapter.search({
-          query,
-          filters: {},
-          limit,
-          offset: 0,
-          signal: ctx.abortSignal
-        });
-        return textResult(formatDataCatalogSearchResult(query, result), result);
-      } catch (error) {
-        return errorResult(error instanceof Error ? error.message : String(error));
-      }
-    }
+    routeContributions,
+    preservedUiStateKeys
   };
 }
-function createDataCatalogSkillPrompt(options = {}) {
-  const label = options.label ?? "data catalog";
-  const toolName = options.toolName ?? DATA_CATALOG_DEFAULT_TOOL_NAME;
-  const surfaceKind = options.surfaceKind ?? DATA_CATALOG_ROW_SURFACE_KIND;
-  const guidance = options.guidance?.trim();
-  return [
-    "## Data Catalog Plugin",
-    "",
-    `Use \`${toolName}\` to search the ${label} before referencing datasets, series, tables, or metrics.`,
-    `When you need to show a catalog row to the user, use the workspace UI bridge \`openSurface\` command with \`{ kind: '${surfaceKind}', target: row.id, meta: { catalogId, row } }\` so the client plugin resolver chooses the panel.`,
-    guidance ? "" : void 0,
-    guidance || void 0
-  ].filter((line) => line !== void 0).join("\n");
-}
-function createDataCatalogServerPlugin(options) {
-  const tool = createDataCatalogAgentTool(options);
-  return defineServerPlugin({
-    id: options.id ?? DATA_CATALOG_PLUGIN_ID,
-    label: options.label ?? "Data Catalog",
-    agentTools: [tool],
-    systemPrompt: createDataCatalogSkillPrompt({
-      label: options.label,
-      toolName: tool.name,
-      surfaceKind: options.surfaceKind,
-      guidance: options.guidance
-    })
-  });
-}
 export {
   ServerPluginError,
   bootstrapServer,
   composeServerPlugins,
-  createDataCatalogAgentTool,
-  createDataCatalogServerPlugin,
-  createDataCatalogSkillPrompt,
   createExecUiTool,
   createGetUiStateTool,
   createInMemoryBridge,
   createWorkspaceUiTools,
   defineServerPlugin,
-  formatDataCatalogSearchResult,
   uiRoutes,
   validateServerPlugin
 };

package/dist/shared.d.ts

@@ -1,7 +1,6 @@
-export { C as CommandResult, E as ExplorerAdapter, c as ExplorerRow, S as SearchResult, U as UiBridge, a as UiCommand, b as UiState } from './explorer-DtLUnuah.js';
+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 './agent-tool-DEtfQPVB.js';
 import { ComponentType } from 'react';
 import { DockviewPanelApi, DockviewApi } from 'dockview-react';
-export { A as AgentTool, J as JSONSchema, T as ToolExecContext, a as ToolResult } from './agent-tool-NvxKfist.js';
 
 /**
  * Shared panel and command types — no runtime deps beyond React/dockview.

package/dist/testing.d.ts

@@ -8,12 +8,6 @@ import { ReactNode } from 'react';
 import { RenderOptions } from '@testing-library/react';
 import { RenderResult } from '@testing-library/react';
 
-declare type Badge = {
-    /** 1–4 char mono code rendered as a chip. */
-    code: string;
-    tooltip?: string;
-};
-
 /**
  * Land on the app with a clean localStorage so persistence-sensitive tests
  * start from defaults. Pre-opens the workbench surface unless told
@@ -135,8 +129,6 @@ export declare interface CreateMockRegistryOptions {
     capabilities?: Record<string, boolean>;
 }
 
-export declare function createMockSeriesAdapter(): ExplorerAdapter;
-
 export declare function createMockSessions(opts?: CreateMockSessionsOptions): MockSessionsStore;
 
 export declare interface CreateMockSessionsOptions {
@@ -146,8 +138,6 @@ export declare interface CreateMockSessionsOptions {
     activeId?: string;
 }
 
-export declare function createMockTablesAdapter(): ExplorerAdapter;
-
 declare interface DynamicPaneConfig {
     id: string;
     component: string;
@@ -155,39 +145,6 @@ declare interface DynamicPaneConfig {
     title?: string;
 }
 
-declare type ExplorerAdapter = {
-    search(args: SearchArgs): Promise<SearchResult>;
-    /** Optional. When omitted, the explorer renders flat (no facet popover). */
-    fetchFacets?(args: FacetsArgs): Promise<Facets>;
-};
-
-declare type ExplorerRow = {
-    id: string;
-    title: string;
-    /** Optional muted second line (truncates with title). */
-    subtitle?: string;
-    /** Group key — must match one of the facet values for `groupBy`. */
-    group?: string;
-    /** Leading mono chip (e.g. type code, frequency). */
-    leading?: Badge;
-    /** Trailing mono chips for status flags (e.g. [D] derived, [LIVE]). */
-    trailing?: Badge[];
-    /** Right-aligned plain text for numeric metadata (e.g. "1.2M", "2.4s"). */
-    meta?: string;
-};
-
-declare type Facets = Record<string, FacetValue[]>;
-
-declare type FacetsArgs = {
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-};
-
-declare type FacetValue = {
-    value: string;
-    count: number;
-};
-
 export declare interface MockBridgeState {
     openPanels: PanelState[];
     activeFile: string | null;
@@ -363,26 +320,6 @@ export declare type RenderPaneResult = RenderResult & {
     registry: PanelRegistry;
 };
 
-declare type SearchArgs = {
-    query: string;
-    filters: Record<string, string[]>;
-    /** Scope to a single group's value (only set when paginating inside a group). */
-    group?: {
-        key: string;
-        value: string;
-    };
-    limit: number;
-    offset: number;
-    signal?: AbortSignal;
-};
-
-declare type SearchResult = {
-    items: ExplorerRow[];
-    /** Total count for the current scope (query + filters + optional group). */
-    total: number;
-    hasMore: boolean;
-};
-
 declare interface SessionItem {
     id: string;
     title: string;