@hachej/boring-workspace 0.1.23 → 0.1.26

package/dist/createInMemoryBridge--ZFPAgXy.d.ts

@@ -0,0 +1,161 @@
+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-Bdgl2hR8.js';
+
+type BoringPluginNativeFrontTargetTrust$1 = "local-trusted-native";
+/**
+ * Host-owned runtime import target for a plugin front entry.
+ *
+ * Only the trusted native/browser-module case exists today. Future
+ * target kinds (iframe/artifact/...) can extend the union without
+ * rewriting list/event payload shapes.
+ */
+interface BoringPluginNativeFrontTarget$1 {
+    kind: "native";
+    entryUrl: string;
+    revision: number;
+    trust: BoringPluginNativeFrontTargetTrust$1;
+}
+type BoringPluginFrontTarget$1 = BoringPluginNativeFrontTarget$1;
+type BoringPluginEvent$1 = {
+    type: "boring.plugin.load";
+    id: string;
+    boring: BoringPackageBoringField;
+    version: string;
+    revision: number;
+    frontUrl?: string;
+    frontTarget?: BoringPluginFrontTarget$1;
+} | {
+    type: "boring.plugin.unload";
+    id: string;
+    revision: number;
+} | {
+    type: "boring.plugin.error";
+    id: string;
+    revision: number;
+    message: string;
+};
+interface BoringPluginListEntry$1 {
+    id: string;
+    boring: BoringPackageBoringField;
+    pi?: BoringPackagePiField;
+    version: string;
+    revision: number;
+    frontUrl?: string;
+    frontTarget?: BoringPluginFrontTarget$1;
+}
+
+interface BoringServerPluginManifest {
+    id: string;
+    rootDir: string;
+    version: string;
+    boring: BoringPackageBoringField;
+    pi?: BoringPackagePiField;
+    frontPath?: string;
+    /** Legacy Vite-dev browser import fallback (`/@fs/...`). */
+    frontUrl?: string;
+    serverPath?: string;
+    extensionPaths?: string[];
+    skillPaths?: string[];
+}
+type BoringPluginNativeFrontTargetTrust = BoringPluginNativeFrontTargetTrust$1;
+type BoringPluginNativeFrontTarget = BoringPluginNativeFrontTarget$1;
+type BoringPluginFrontTarget = BoringPluginFrontTarget$1;
+type BoringPluginListEntry = BoringPluginListEntry$1;
+interface BoringPluginFrontTargetResolverContext {
+    revision: number;
+    /** Plugin-root-relative front entry path normalized for URL-like consumers. */
+    frontEntrySubpath: string;
+}
+type BoringPluginFrontTargetResolver = (plugin: BoringServerPluginManifest, context: BoringPluginFrontTargetResolverContext) => BoringPluginFrontTarget | undefined;
+/**
+ * Surfaces whose changes the hot-reload pipeline can't re-load mid-
+ * session — set when a plugin's load DID succeed but a sub-surface
+ * (the agent-tools registry, Fastify routes) carries stale code from
+ * the previous revision. The /reload caller (chat UI, verify-plugin,
+ * etc.) should surface a "restart needed for X" warning.
+ *
+ * - `'routes'`: a `WorkspaceServerPlugin.routes` function changed. The
+ *   workspace's Fastify instance can't unregister + re-register routes
+ *   mid-flight; the previous routes stay live until next boot.
+ * - `'agentTools'`: a `WorkspaceServerPlugin.agentTools` array changed.
+ *   The current Pi session still has the old tool list; new sessions
+ *   get the new list.
+ * - Multiple surfaces: order is deterministic (`routes` before
+ *   `agentTools`) so subscribers can format consistently.
+ */
+type PluginRestartSurface = "routes" | "agentTools";
+type BoringPluginEvent = (Extract<BoringPluginEvent$1, {
+    type: "boring.plugin.load";
+}> & {
+    /**
+     * Non-empty when the plugin loaded but one or more server-side
+     * surfaces still hold pre-load code. UI consumers should render
+     * a "restart needed: <surfaces>" hint. Empty/omitted = fully
+     * live.
+     */
+    requiresRestart?: PluginRestartSurface[];
+}) | Extract<BoringPluginEvent$1, {
+    type: "boring.plugin.unload";
+}> | Extract<BoringPluginEvent$1, {
+    type: "boring.plugin.error";
+}>;
+
+type WorkspaceRuntimeProvisioning = NonNullable<ProvisionWorkspaceRuntimeOptions["plugins"][number]["provisioning"]>;
+interface WorkspaceServerPlugin {
+    id: string;
+    label?: string;
+    /**
+     * Native Pi package sources required by this workspace integration.
+     * Workspace declares them; @hachej/boring-agent applies them through Pi's native
+     * resource loader without asking Pi packages to export Boring adapters.
+     */
+    piPackages?: PiPackageSource[];
+    /**
+     * Native pi extension entrypoints contributed by this plugin.
+     * Passed to DefaultResourceLoader.additionalExtensionPaths so pi owns jiti
+     * loading and ctx.reload() re-imports fresh source.
+     */
+    extensionPaths?: string[];
+    systemPrompt?: string;
+    skills?: PluginSkillSource[];
+    agentTools?: AgentTool[];
+    provisioning?: WorkspaceRuntimeProvisioning;
+    routes?: FastifyPluginAsync;
+    /** UI state keys owned by this plugin that browser state PUTs must not overwrite. */
+    preservedUiStateKeys?: string[];
+}
+declare function validateServerPlugin(plugin: WorkspaceServerPlugin): void;
+declare function defineServerPlugin<T extends WorkspaceServerPlugin>(plugin: T): T;
+
+interface ServerBootstrapOptions {
+    plugins?: WorkspaceServerPlugin[];
+    defaults?: WorkspaceServerPlugin[];
+    excludeDefaults?: string[];
+}
+type WorkspaceRuntimeProvisioningInput = ProvisionWorkspaceRuntimeOptions["plugins"][number];
+type WorkspaceProvisioningContribution = {
+    id: string;
+    provisioning: NonNullable<WorkspaceRuntimeProvisioningInput["provisioning"]>;
+};
+type WorkspaceRouteContribution = {
+    id: string;
+    routes: FastifyPluginAsync;
+};
+interface ServerBootstrapResult {
+    registered: string[];
+    systemPromptAppend: string;
+    piPackages: PiPackageSource[];
+    extensionPaths: string[];
+    agentTools: AgentTool[];
+    runtimePlugins: WorkspaceRuntimeProvisioningInput[];
+    provisioningContributions: WorkspaceProvisioningContribution[];
+    routeContributions: WorkspaceRouteContribution[];
+    preservedUiStateKeys: string[];
+}
+declare function bootstrapServer(options: ServerBootstrapOptions): ServerBootstrapResult;
+
+declare function createInMemoryBridge(): UiBridge;
+
+export { type BoringPluginFrontTargetResolver as B, type PluginRestartSurface as P, type ServerBootstrapOptions as S, type WorkspaceServerPlugin as W, type WorkspaceProvisioningContribution as a, type WorkspaceRouteContribution as b, createInMemoryBridge as c, type WorkspaceRuntimeProvisioningInput as d, type BoringServerPluginManifest as e, type BoringPluginListEntry as f, type BoringPluginFrontTarget as g, type BoringPluginEvent as h, type BoringPluginFrontTargetResolverContext as i, type BoringPluginNativeFrontTarget as j, type BoringPluginNativeFrontTargetTrust as k, type ServerBootstrapResult as l, bootstrapServer as m, defineServerPlugin as n, validateServerPlugin as v };

package/dist/events.d.ts

@@ -58,6 +58,9 @@ type WorkspacePanelMatch = {
 } | {
     param: string;
     value: unknown;
+} | {
+    paramPrefix: string;
+    value: string;
 };
 /**
  * Discriminated origin metadata. Encoded as a union (rather than a

package/dist/{manifest-CyNNdfYz.d.ts → manifest-C2vVgH_e.d.ts}

@@ -8,6 +8,8 @@
  * - `boring`: workspace/UI package discovery (front/server entrypoints and labels)
  */
 interface BoringPackageBoringField {
+    /** Optional stable plugin id. Defaults to package.json#name normalized for package discovery. */
+    id?: string;
     /** Browser entry that default-exports a BoringFrontFactory. */
     front?: string;
     /** Workspace/UI support server entry. Set false to disable convention lookup. */

package/dist/plugin.d.ts

@@ -1,7 +1,7 @@
 import { ComponentType, ReactNode } from 'react';
-import { P as PaneProps, a as PanelConfig, S as SurfaceOpenRequest, c as SurfacePanelResolution } from './surface-COYagY2m.js';
-export { W as WORKSPACE_OPEN_PATH_SURFACE_KIND } from './surface-COYagY2m.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-CyNNdfYz.js';
+import { P as PaneProps, a as PanelConfig, S as SurfaceOpenRequest, c as SurfacePanelResolution } from './surface-CEEkd81D.js';
+export { W as WORKSPACE_OPEN_PATH_SURFACE_KIND } from './surface-CEEkd81D.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 'dockview-react';
 
 type CatalogBadge = {
@@ -69,6 +69,10 @@ interface LeftTabParams {
     searchQuery?: string;
     bridge?: unknown;
     chromeless?: boolean;
+    revealFileTreeRequest?: {
+        path: string;
+        seq: number;
+    } | null;
 }
 
 interface BoringFrontPanelRegistration<T = unknown> {
@@ -85,6 +89,7 @@ interface BoringFrontPanelRegistration<T = unknown> {
     essential?: boolean;
     lazy?: boolean;
     chromeless?: boolean;
+    supportsFullPage?: boolean;
     source?: string;
 }
 interface BoringFrontPanelCommandRegistration {

package/dist/plugin.js

@@ -183,8 +183,8 @@ function validateBoringField(issues, boring) {
       ));
     }
   }
-  if (boring.id !== void 0) {
-    issues.push(issue("INVALID_FIELD", "boring.id", "boring.id is not supported; package discovery identity comes from package.json#name"));
+  if (boring.id !== void 0 && (typeof boring.id !== "string" || !isValidBoringPluginId(boring.id))) {
+    issues.push(issue("INVALID_ID", "boring.id", "boring.id must start with a letter or number and use only letters, numbers, dot, underscore, colon, or dash"));
   }
   const front = boring.front;
   if (front !== void 0 && (typeof front !== "string" || !isSafePluginRelativePath(front))) {
@@ -198,6 +198,7 @@ function validateBoringField(issues, boring) {
     issues.push(issue("INVALID_FIELD", "boring.label", "boring.label must be a string when provided"));
   }
   return {
+    ...typeof boring.id === "string" ? { id: boring.id } : {},
     ...typeof boring.front === "string" ? { front: boring.front } : {},
     ...typeof boring.server === "string" || boring.server === false ? { server: boring.server } : {},
     ...typeof boring.label === "string" ? { label: boring.label } : {}

package/dist/server.d.ts

@@ -1,9 +1,11 @@
-export { S as ServerBootstrapOptions, e as ServerBootstrapResult, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, W as WorkspaceServerPlugin, f as bootstrapServer, c as createInMemoryBridge, g as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge-CYNW1h_o.js';
+import { e as BoringServerPluginManifest, B as BoringPluginFrontTargetResolver, f as BoringPluginListEntry, g as BoringPluginFrontTarget, h as BoringPluginEvent, P as PluginRestartSurface } from './createInMemoryBridge--ZFPAgXy.js';
+export { i as BoringPluginFrontTargetResolverContext, j as BoringPluginNativeFrontTarget, k as BoringPluginNativeFrontTargetTrust, S as ServerBootstrapOptions, l as ServerBootstrapResult, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, W as WorkspaceServerPlugin, m as bootstrapServer, c as createInMemoryBridge, n as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge--ZFPAgXy.js';
 import { FastifyRequest, FastifyInstance } from 'fastify';
-import { U as UiBridge, A as AgentTool } from './ui-bridge-CT18yqwN.js';
-export { C as CommandResult, a as UiCommand, b as UiState } from './ui-bridge-CT18yqwN.js';
-import { B as BoringPackageBoringField, a as BoringPackagePiField } from './manifest-CyNNdfYz.js';
+import { U as UiBridge, A as AgentTool } from './ui-bridge-Bdgl2hR8.js';
+export { C as CommandResult, a as UiCommand, b as UiState } from './ui-bridge-Bdgl2hR8.js';
+import { PiPackageSource } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
+import './manifest-C2vVgH_e.js';
 
 interface UiRoutesOptions {
     bridge?: UiBridge;
@@ -29,6 +31,13 @@ interface ExecUiToolOptions {
      * but existence is left to the frontend/remote filesystem.
      */
     workspaceRoot?: string;
+    /**
+     * Optional workspace-backed stat hook for modes where the host path is not
+     * directly stat-able (for example remote sandboxes). When provided, path-
+     * bearing UI commands can still reject missing paths and convert folders to
+     * file-tree reveal commands.
+     */
+    resolvePathKind?: (relPath: string) => Promise<"file" | "dir" | null>;
     /**
      * After dispatching a state-changing command (openFile, openPanel,
      * openSurface, closePanel), wait this many ms before the first state
@@ -62,9 +71,9 @@ declare function createWorkspaceUiTools(uiBridge: UiBridge, opts?: ExecUiToolOpt
 
 /**
  * boring-ui system prompt — workflow steps + a Pi-style docs pointer
- * block (per DECISIONS.md #17). The block lists absolute paths into the
- * installed `@hachej/boring-pi` package so the agent's `read` tool can
- * fetch the SKILL.md + reference docs on demand, without inlining their
+ * block (per DECISIONS.md #17). The block lists workspace-readable paths
+ * into the installed `@hachej/boring-pi` package so the agent's `read` tool
+ * can fetch the SKILL.md + reference docs on demand, without inlining their
  * ~12-30 KB of markdown into every system prompt.
  *
  * `@hachej/boring-pi` is a runtime dep of `@hachej/boring-workspace`;
@@ -95,68 +104,6 @@ interface BuildBoringSystemPromptOptions {
 }
 declare function buildBoringSystemPrompt(opts: BuildBoringSystemPromptOptions): string;
 
-interface BoringServerPluginManifest {
-    id: string;
-    rootDir: string;
-    version: string;
-    boring: BoringPackageBoringField;
-    pi?: BoringPackagePiField;
-    frontPath?: string;
-    frontUrl?: string;
-    serverPath?: string;
-    extensionPaths?: string[];
-    skillPaths?: string[];
-}
-/**
- * Surfaces whose changes the hot-reload pipeline can't re-load mid-
- * session — set when a plugin's load DID succeed but a sub-surface
- * (the agent-tools registry, Fastify routes) carries stale code from
- * the previous revision. The /reload caller (chat UI, verify-plugin,
- * etc.) should surface a "restart needed for X" warning.
- *
- * - `'routes'`: a `WorkspaceServerPlugin.routes` function changed. The
- *   workspace's Fastify instance can't unregister + re-register routes
- *   mid-flight; the previous routes stay live until next boot.
- * - `'agentTools'`: a `WorkspaceServerPlugin.agentTools` array changed.
- *   The current Pi session still has the old tool list; new sessions
- *   get the new list.
- * - Multiple surfaces: order is deterministic (`routes` before
- *   `agentTools`) so subscribers can format consistently.
- */
-type PluginRestartSurface = "routes" | "agentTools";
-type BoringPluginEvent = {
-    type: "boring.plugin.load";
-    id: string;
-    boring: BoringPackageBoringField;
-    version: string;
-    revision: number;
-    frontUrl?: string;
-    /**
-     * Non-empty when the plugin loaded but one or more server-side
-     * surfaces still hold pre-load code. UI consumers should render
-     * a "restart needed: <surfaces>" hint. Empty/omitted = fully
-     * live.
-     */
-    requiresRestart?: PluginRestartSurface[];
-} | {
-    type: "boring.plugin.unload";
-    id: string;
-    revision: number;
-} | {
-    type: "boring.plugin.error";
-    id: string;
-    revision: number;
-    message: string;
-};
-interface BoringPluginListEntry {
-    id: string;
-    boring: BoringPackageBoringField;
-    pi?: BoringPackagePiField;
-    version: string;
-    revision: number;
-    frontUrl?: string;
-}
-
 interface BoringPluginPreflightIssue {
     pluginDir: string;
     pluginId?: string;
@@ -184,6 +131,16 @@ interface BoringPluginAssetManagerOptions {
      * the default assumes workspace root equals `process.cwd()`.
      */
     errorRoot?: string;
+    /**
+     * Optional host-owned runtime front-target resolver. When omitted, list/event
+     * payloads preserve the existing `frontUrl` (`/@fs/...`) fallback only.
+     */
+    frontTargetResolver?: BoringPluginFrontTargetResolver;
+    /**
+     * Keep legacy `/@fs/...` frontUrl payloads alongside frontTarget. Defaults
+     * to true for back-compat; packaged CLI folder/workspaces mode can disable it.
+     */
+    includeLegacyFrontUrl?: boolean;
 }
 interface LoadBoringAssetsError {
     id: string;
@@ -195,25 +152,48 @@ interface LoadBoringAssetsResult {
     events: BoringPluginEvent[];
     errors: LoadBoringAssetsError[];
 }
+interface LoadedBoringPluginInspection {
+    id: string;
+    version: string;
+    revision: number;
+    rootDir: string;
+    frontPath?: string;
+    frontTarget?: BoringPluginFrontTarget;
+}
+interface LoadedBoringPluginPiSnapshot {
+    additionalSkillPaths: string[];
+    packages: PiPackageSource[];
+    extensionPaths: string[];
+    systemPromptAppend?: string;
+}
 type Listener = (event: BoringPluginEvent) => void;
 declare class BoringPluginAssetManager {
     private readonly pluginDirs;
     private readonly errorRoot;
+    private readonly frontTargetResolver?;
+    private readonly includeLegacyFrontUrl;
     private readonly loaded;
     private readonly revisions;
     private readonly listeners;
+    private readonly lastErrors;
     private loading;
     private reloadQueued;
     constructor(options: BoringPluginAssetManagerOptions);
     preflight(): BoringPluginPreflightResult;
     list(): BoringPluginListEntry[];
     getError(pluginId: string): string | null;
+    getErrors(): LoadBoringAssetsError[];
+    inspectLoaded(): LoadedBoringPluginInspection[];
+    inspectLoadedPiSnapshot(): LoadedBoringPluginPiSnapshot;
     subscribe(listener: Listener): () => void;
     load(): Promise<LoadBoringAssetsResult>;
     private drainLoads;
     private doLoadOnce;
     private collectPreflightErrors;
     private bumpRevision;
+    private toListEntry;
+    private frontUrlPayload;
+    private resolveFrontTarget;
     private emit;
     private errorPath;
     private writeError;
@@ -294,4 +274,4 @@ declare function pluginFileSignature(path: string | undefined): string;
 declare function writePluginSignatureCache(pluginRootDir: string, payload: Omit<PluginSignatureCachePayload, "version" | "loadedAt"> & Partial<Pick<PluginSignatureCachePayload, "loadedAt">>): void;
 declare function readPluginSignatureCache(pluginRootDir: string): PluginSignatureCachePayload | null;
 
-export { BoringPluginAssetManager, type BoringPluginEvent, type BoringPluginListEntry, type BoringPluginScanResult, type BoringServerPluginManifest, type PluginReloadRebuild, type PluginRestartWarning, UiBridge, type UiRoutesOptions, aggregatePluginPrompts, boringPluginRoutes, buildBoringSystemPrompt, collectRestartWarnings, createExecUiTool, createGetUiStateTool, createWorkspaceUiTools, pluginFileSignature, preflightBoringPlugins, readBoringPlugins, readPluginSignatureCache, scanBoringPlugins, uiRoutes, writePluginSignatureCache };
+export { BoringPluginAssetManager, BoringPluginEvent, BoringPluginFrontTarget, BoringPluginFrontTargetResolver, BoringPluginListEntry, type BoringPluginScanResult, BoringServerPluginManifest, type PluginReloadRebuild, type PluginRestartWarning, UiBridge, type UiRoutesOptions, aggregatePluginPrompts, boringPluginRoutes, buildBoringSystemPrompt, collectRestartWarnings, createExecUiTool, createGetUiStateTool, createWorkspaceUiTools, pluginFileSignature, preflightBoringPlugins, readBoringPlugins, readPluginSignatureCache, scanBoringPlugins, uiRoutes, writePluginSignatureCache };