@hachej/boring-workspace 0.1.23 → 0.1.24

package/dist/app-server.d.ts

@@ -1,9 +1,9 @@
 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, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, c as createInMemoryBridge } from './createInMemoryBridge-CYNW1h_o.js';
-export { d as ServerWorkspaceRuntimeProvisioningInput } from './createInMemoryBridge-CYNW1h_o.js';
-import './ui-bridge-CT18yqwN.js';
+import { W as WorkspaceServerPlugin, S as ServerBootstrapOptions, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, c as createInMemoryBridge } from './createInMemoryBridge-DLckqafe.js';
+export { d as ServerWorkspaceRuntimeProvisioningInput } from './createInMemoryBridge-DLckqafe.js';
+import './ui-bridge-Bdgl2hR8.js';
 
 /**
  * Directory-source entry: `{ dir, options?, hotReload? }`. Resolved via

package/dist/app-server.js

@@ -162,8 +162,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))) {
@@ -177,6 +177,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 } : {}
@@ -343,6 +344,8 @@ function resolveSafePluginEntryPath({
 
 // src/server/agentPlugins/scan.ts
 function pluginIdFromPackageJson(pkg, rootDir) {
+  const explicitId = typeof pkg.boring?.id === "string" && pkg.boring.id.trim() ? pkg.boring.id.trim() : void 0;
+  if (explicitId) return explicitId;
   const name = typeof pkg.name === "string" && pkg.name.trim() ? pkg.name.trim() : void 0;
   return (name ?? rootDir.split(/[\\/]/).at(-1) ?? "plugin").replace(/^@/, "").replaceAll("/", "-");
 }
@@ -526,8 +529,8 @@ import { dirname as dirname4, join as join3 } from "path";
 var PLUGIN_SIGNATURE_CACHE_FILE = ".boring-signature.json";
 function pluginFileSignature(path) {
   if (!path || !existsSync3(path)) return "missing";
-  const stat = statSync2(path);
-  return `${stat.mtimeMs}:${stat.size}`;
+  const stat2 = statSync2(path);
+  return `${stat2.mtimeMs}:${stat2.size}`;
 }
 function cachePath(pluginRootDir) {
   return join3(pluginRootDir, PLUGIN_SIGNATURE_CACHE_FILE);
@@ -571,8 +574,8 @@ function directorySignature(root) {
       count++;
       const path = join4(dir, entry.name);
       const rel = relative2(root, path);
-      const stat = lstatSync(path);
-      if (stat.isSymbolicLink()) {
+      const stat2 = lstatSync(path);
+      if (stat2.isSymbolicLink()) {
         let target;
         try {
           target = realpathSync2(path);
@@ -597,9 +600,9 @@ function directorySignature(root) {
         continue;
       }
       hash.update(rel);
-      hash.update(String(stat.mtimeMs));
-      hash.update(String(stat.size));
-      if (stat.isDirectory()) {
+      hash.update(String(stat2.mtimeMs));
+      hash.update(String(stat2.size));
+      if (stat2.isDirectory()) {
         visit(path, depth + 1);
       }
     }
@@ -1393,7 +1396,7 @@ function createInMemoryBridge() {
 }
 
 // src/server/ui-control/tools/uiTools.ts
-import { access } from "fs/promises";
+import { stat } from "fs/promises";
 import { resolve as resolve6, isAbsolute as isAbsolute4, relative as relative3, win32 } from "path";
 function makeError(message) {
   return {
@@ -1431,7 +1434,7 @@ function validatePathSyntax(relPath, workspaceRoot) {
   }
   return { ok: true };
 }
-async function validatePath(workspaceRoot, relPath) {
+async function validateExistingPath(workspaceRoot, relPath) {
   const syntax = validatePathSyntax(relPath, workspaceRoot);
   if (!syntax.ok) return syntax;
   const resolved = resolve6(workspaceRoot, relPath);
@@ -1443,8 +1446,8 @@ async function validatePath(workspaceRoot, relPath) {
     };
   }
   try {
-    await access(resolved);
-    return { ok: true };
+    const fileStat = await stat(resolved);
+    return { ok: true, kind: fileStat.isDirectory() ? "dir" : "file" };
   } catch {
     return {
       ok: false,
@@ -1455,6 +1458,7 @@ async function validatePath(workspaceRoot, relPath) {
 function createGetUiStateTool(uiBridge) {
   return {
     name: "get_ui_state",
+    readinessRequirements: ["ui-bridge"],
     description: [
       "Read the current workspace UI state. Returns a JSON object with:",
       "- workbenchOpen (boolean): is the right-side workbench pane visible?",
@@ -1508,12 +1512,13 @@ function isVerified(kind, params, state) {
   return true;
 }
 function createExecUiTool(uiBridge, opts = {}) {
-  const { workspaceRoot } = opts;
+  const { workspaceRoot, resolvePathKind } = opts;
   const verifyDelayMs = opts.verifyDelayMs ?? 200;
   const verifyRetries = opts.verifyRetries ?? 2;
   const verifyIntervalMs = opts.verifyIntervalMs ?? 200;
   return {
     name: "exec_ui",
+    readinessRequirements: ["ui-bridge"],
     description: [
       "Execute a UI command in the workspace. Use this to open files, panels,",
       "navigate to lines, or show notifications.",
@@ -1547,6 +1552,8 @@ function createExecUiTool(uiBridge, opts = {}) {
       "                 returned \u2014 don't give up and don't switch to the read",
       "                 tool. Repeat until openFile succeeds or no candidate",
       "                 is found.",
+      "                 If the path is a folder, openFile reveals/selects it in",
+      "                 the file tree instead of opening an editor tab.",
       "                 Example: {kind:'openFile', params:{path:'README.md'}}",
       "",
       "  openPanel    params: { id: string, component: string,",
@@ -1630,6 +1637,7 @@ function createExecUiTool(uiBridge, opts = {}) {
           return makeError("openSurface: meta must be an object when provided");
         }
       }
+      let effectiveKind = kind;
       if (PATH_BEARING_KINDS.has(kind)) {
         const relPath = getPathParam(kind, cmdParams);
         if (!relPath) {
@@ -1640,14 +1648,25 @@ function createExecUiTool(uiBridge, opts = {}) {
         const syntax = validatePathSyntax(relPath, workspaceRoot);
         if (!syntax.ok) return makeError(syntax.reason);
         if (workspaceRoot) {
-          const check = await validatePath(workspaceRoot, relPath);
+          const check = await validateExistingPath(workspaceRoot, relPath);
           if (!check.ok) {
             return makeError(check.reason);
           }
+          if (kind === "openFile" && check.kind === "dir") {
+            effectiveKind = "expandToFile";
+          }
+        } else if (resolvePathKind) {
+          const pathKind = await resolvePathKind(relPath);
+          if (!pathKind) {
+            return makeError(`file not found at "${relPath}". Try find or grep to locate the file before retrying openFile.`);
+          }
+          if (kind === "openFile" && pathKind === "dir") {
+            effectiveKind = "expandToFile";
+          }
         }
       }
       try {
-        const command = { kind, params: cmdParams };
+        const command = { kind: effectiveKind, params: cmdParams };
         const result = await uiBridge.postCommand(command);
         if (result.status === "error") {
           return {
@@ -1656,11 +1675,11 @@ function createExecUiTool(uiBridge, opts = {}) {
             details: result
           };
         }
-        if (verifyDelayMs > 0 && VERIFIABLE_KINDS.has(kind)) {
+        if (verifyDelayMs > 0 && VERIFIABLE_KINDS.has(effectiveKind)) {
           await new Promise((r) => setTimeout(r, verifyDelayMs));
           let uiState = await uiBridge.getState();
           for (let i = 0; i < verifyRetries; i++) {
-            if (isVerified(kind, cmdParams, uiState)) break;
+            if (isVerified(effectiveKind, cmdParams, uiState)) break;
             await new Promise((r) => setTimeout(r, verifyIntervalMs));
             uiState = await uiBridge.getState();
           }
@@ -1831,6 +1850,15 @@ function resolveWorkspacePackageRoot() {
   }
   return join7(__dirname, "../../..");
 }
+function readPackageVersion(packageRoot) {
+  if (!packageRoot) return void 0;
+  try {
+    const pkg = JSON.parse(readFileSync6(join7(packageRoot, "package.json"), "utf8"));
+    return typeof pkg.version === "string" && pkg.version.length > 0 ? pkg.version : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function nodePackageContribution(contributionId, nodePackageId, packageName, packageRoot) {
   if (!packageRoot || !existsSync7(join7(packageRoot, "package.json"))) return null;
   return {
@@ -1840,6 +1868,24 @@ function nodePackageContribution(contributionId, nodePackageId, packageName, pac
     }
   };
 }
+function publishedNodePackageContribution(contributionId, nodePackageId, packageName, version, expectedBins) {
+  return {
+    id: contributionId,
+    provisioning: {
+      nodePackages: [
+        {
+          id: nodePackageId,
+          packageName,
+          ...version ? { version } : {},
+          ...expectedBins ? { expectedBins } : {}
+        }
+      ]
+    }
+  };
+}
+function useLocalPackageProvisioning() {
+  return process.env.BORING_USE_LOCAL_PACKAGES === "1";
+}
 function createWorkspacePackageProvisioningContribution() {
   return nodePackageContribution(
     "boring-workspace-package",
@@ -1890,11 +1936,21 @@ function resolveBoringUiCliPackageRoot() {
   }
 }
 function createBoringUiCliPackageProvisioningContribution() {
-  return nodePackageContribution(
+  const packageRoot = resolveBoringUiCliPackageRoot();
+  if (useLocalPackageProvisioning()) {
+    return nodePackageContribution(
+      "boring-ui-cli-package",
+      "boring-ui-cli",
+      "@hachej/boring-ui-cli",
+      packageRoot
+    );
+  }
+  return publishedNodePackageContribution(
     "boring-ui-cli-package",
     "boring-ui-cli",
     "@hachej/boring-ui-cli",
-    resolveBoringUiCliPackageRoot()
+    readPackageVersion(packageRoot) ?? readPackageVersion(resolveWorkspacePackageRoot()),
+    ["boring-ui"]
   );
 }
 function createBoringPiPackageSource(workspaceRoot) {
@@ -2008,6 +2064,12 @@ function skillNameFromResolvedPath(path) {
   if (leaf.toLowerCase() !== "skill.md") return leaf;
   return path.split(/[\\/]/).filter(Boolean).at(-2) ?? "skill";
 }
+function skillPathForPiLoader(path) {
+  return existsSync7(join7(path, "SKILL.md")) ? dirname7(path) : path;
+}
+function uniqueStrings(values) {
+  return [...new Set(values)];
+}
 function readWorkspacePluginPackageRuntimePlugins(pluginDirs) {
   const scan = scanBoringPlugins(pluginDirs);
   return scan.plugins.map((plugin) => ({
@@ -2032,7 +2094,9 @@ function readWorkspacePluginPackagePiSnapshot(pluginDirs) {
     const scan = scanBoringPlugins(pluginDirs);
     const systemPromptAppend = aggregatePluginSystemPromptsFromScan(scan);
     return {
-      additionalSkillPaths: scan.plugins.flatMap((plugin) => plugin.skillPaths ?? []),
+      additionalSkillPaths: uniqueStrings(
+        scan.plugins.flatMap((plugin) => plugin.skillPaths ?? []).map(skillPathForPiLoader)
+      ),
       packages: compactPiPackages(normalizeBoringPluginPiPackages(scan.plugins)),
       extensionPaths: scan.plugins.flatMap((plugin) => plugin.extensionPaths ?? []),
       ...systemPromptAppend ? { systemPromptAppend } : {}

package/dist/{createInMemoryBridge-CYNW1h_o.d.ts → createInMemoryBridge-DLckqafe.d.ts}

@@ -1,6 +1,6 @@
 import { PiPackageSource, PluginSkillSource, ProvisionWorkspaceRuntimeOptions } from '@hachej/boring-agent/server';
 import { FastifyPluginAsync } from 'fastify';
-import { A as AgentTool, U as UiBridge } from './ui-bridge-CT18yqwN.js';
+import { A as AgentTool, U as UiBridge } from './ui-bridge-Bdgl2hR8.js';
 
 type WorkspaceRuntimeProvisioning = NonNullable<ProvisionWorkspaceRuntimeOptions["plugins"][number]["provisioning"]>;
 interface WorkspaceServerPlugin {

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,8 +1,8 @@
-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';
+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-DLckqafe.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 { B as BoringPackageBoringField, a as BoringPackagePiField } from './manifest-C2vVgH_e.js';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 
 interface UiRoutesOptions {
@@ -29,6 +29,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

package/dist/server.js

@@ -165,7 +165,7 @@ data: ${JSON.stringify({ v: UI_BRIDGE_PROTOCOL_VERSION })}
 }
 
 // src/server/ui-control/tools/uiTools.ts
-import { access } from "fs/promises";
+import { stat } from "fs/promises";
 import { resolve, isAbsolute, relative, win32 } from "path";
 function makeError(message) {
   return {
@@ -203,7 +203,7 @@ function validatePathSyntax(relPath, workspaceRoot) {
   }
   return { ok: true };
 }
-async function validatePath(workspaceRoot, relPath) {
+async function validateExistingPath(workspaceRoot, relPath) {
   const syntax = validatePathSyntax(relPath, workspaceRoot);
   if (!syntax.ok) return syntax;
   const resolved = resolve(workspaceRoot, relPath);
@@ -215,8 +215,8 @@ async function validatePath(workspaceRoot, relPath) {
     };
   }
   try {
-    await access(resolved);
-    return { ok: true };
+    const fileStat = await stat(resolved);
+    return { ok: true, kind: fileStat.isDirectory() ? "dir" : "file" };
   } catch {
     return {
       ok: false,
@@ -227,6 +227,7 @@ async function validatePath(workspaceRoot, relPath) {
 function createGetUiStateTool(uiBridge) {
   return {
     name: "get_ui_state",
+    readinessRequirements: ["ui-bridge"],
     description: [
       "Read the current workspace UI state. Returns a JSON object with:",
       "- workbenchOpen (boolean): is the right-side workbench pane visible?",
@@ -280,12 +281,13 @@ function isVerified(kind, params, state) {
   return true;
 }
 function createExecUiTool(uiBridge, opts = {}) {
-  const { workspaceRoot } = opts;
+  const { workspaceRoot, resolvePathKind } = opts;
   const verifyDelayMs = opts.verifyDelayMs ?? 200;
   const verifyRetries = opts.verifyRetries ?? 2;
   const verifyIntervalMs = opts.verifyIntervalMs ?? 200;
   return {
     name: "exec_ui",
+    readinessRequirements: ["ui-bridge"],
     description: [
       "Execute a UI command in the workspace. Use this to open files, panels,",
       "navigate to lines, or show notifications.",
@@ -319,6 +321,8 @@ function createExecUiTool(uiBridge, opts = {}) {
       "                 returned \u2014 don't give up and don't switch to the read",
       "                 tool. Repeat until openFile succeeds or no candidate",
       "                 is found.",
+      "                 If the path is a folder, openFile reveals/selects it in",
+      "                 the file tree instead of opening an editor tab.",
       "                 Example: {kind:'openFile', params:{path:'README.md'}}",
       "",
       "  openPanel    params: { id: string, component: string,",
@@ -402,6 +406,7 @@ function createExecUiTool(uiBridge, opts = {}) {
           return makeError("openSurface: meta must be an object when provided");
         }
       }
+      let effectiveKind = kind;
       if (PATH_BEARING_KINDS.has(kind)) {
         const relPath = getPathParam(kind, cmdParams);
         if (!relPath) {
@@ -412,14 +417,25 @@ function createExecUiTool(uiBridge, opts = {}) {
         const syntax = validatePathSyntax(relPath, workspaceRoot);
         if (!syntax.ok) return makeError(syntax.reason);
         if (workspaceRoot) {
-          const check = await validatePath(workspaceRoot, relPath);
+          const check = await validateExistingPath(workspaceRoot, relPath);
           if (!check.ok) {
             return makeError(check.reason);
           }
+          if (kind === "openFile" && check.kind === "dir") {
+            effectiveKind = "expandToFile";
+          }
+        } else if (resolvePathKind) {
+          const pathKind = await resolvePathKind(relPath);
+          if (!pathKind) {
+            return makeError(`file not found at "${relPath}". Try find or grep to locate the file before retrying openFile.`);
+          }
+          if (kind === "openFile" && pathKind === "dir") {
+            effectiveKind = "expandToFile";
+          }
         }
       }
       try {
-        const command = { kind, params: cmdParams };
+        const command = { kind: effectiveKind, params: cmdParams };
         const result = await uiBridge.postCommand(command);
         if (result.status === "error") {
           return {
@@ -428,11 +444,11 @@ function createExecUiTool(uiBridge, opts = {}) {
             details: result
           };
         }
-        if (verifyDelayMs > 0 && VERIFIABLE_KINDS.has(kind)) {
+        if (verifyDelayMs > 0 && VERIFIABLE_KINDS.has(effectiveKind)) {
           await new Promise((r) => setTimeout(r, verifyDelayMs));
           let uiState = await uiBridge.getState();
           for (let i = 0; i < verifyRetries; i++) {
-            if (isVerified(kind, cmdParams, uiState)) break;
+            if (isVerified(effectiveKind, cmdParams, uiState)) break;
             await new Promise((r) => setTimeout(r, verifyIntervalMs));
             uiState = await uiBridge.getState();
           }
@@ -854,8 +870,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))) {
@@ -869,6 +885,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 } : {}
@@ -998,6 +1015,8 @@ function resolveContainedPluginPath(rootDir, value, options = {}) {
 
 // src/server/agentPlugins/scan.ts
 function pluginIdFromPackageJson(pkg, rootDir) {
+  const explicitId = typeof pkg.boring?.id === "string" && pkg.boring.id.trim() ? pkg.boring.id.trim() : void 0;
+  if (explicitId) return explicitId;
   const name = typeof pkg.name === "string" && pkg.name.trim() ? pkg.name.trim() : void 0;
   return (name ?? rootDir.split(/[\\/]/).at(-1) ?? "plugin").replace(/^@/, "").replaceAll("/", "-");
 }
@@ -1177,8 +1196,8 @@ import { dirname as dirname4, join as join3 } from "path";
 var PLUGIN_SIGNATURE_CACHE_FILE = ".boring-signature.json";
 function pluginFileSignature(path) {
   if (!path || !existsSync3(path)) return "missing";
-  const stat = statSync2(path);
-  return `${stat.mtimeMs}:${stat.size}`;
+  const stat2 = statSync2(path);
+  return `${stat2.mtimeMs}:${stat2.size}`;
 }
 function cachePath(pluginRootDir) {
   return join3(pluginRootDir, PLUGIN_SIGNATURE_CACHE_FILE);
@@ -1245,8 +1264,8 @@ function directorySignature(root) {
       count++;
       const path = join4(dir, entry.name);
       const rel = relative3(root, path);
-      const stat = lstatSync(path);
-      if (stat.isSymbolicLink()) {
+      const stat2 = lstatSync(path);
+      if (stat2.isSymbolicLink()) {
         let target;
         try {
           target = realpathSync2(path);
@@ -1271,9 +1290,9 @@ function directorySignature(root) {
         continue;
       }
       hash.update(rel);
-      hash.update(String(stat.mtimeMs));
-      hash.update(String(stat.size));
-      if (stat.isDirectory()) {
+      hash.update(String(stat2.mtimeMs));
+      hash.update(String(stat2.size));
+      if (stat2.isDirectory()) {
         visit(path, depth + 1);
       }
     }

package/dist/shared.d.ts

@@ -1,5 +1,5 @@
-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-CT18yqwN.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-COYagY2m.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 './ui-bridge-Bdgl2hR8.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-CEEkd81D.js';
 import 'react';
 import 'dockview-react';
 

package/dist/{surface-COYagY2m.d.ts → surface-CEEkd81D.d.ts}

@@ -46,6 +46,7 @@ interface PanelConfig<T = any> {
     requiresCapabilities?: string[];
     essential?: boolean;
     chromeless?: boolean;
+    supportsFullPage?: boolean;
     /** Source: "builtin" | "app" */
     source?: string;
     pluginId?: string;

package/dist/testing.d.ts

@@ -230,6 +230,7 @@ declare interface PanelConfig<T = any> {
     requiresCapabilities?: string[];
     essential?: boolean;
     chromeless?: boolean;
+    supportsFullPage?: boolean;
     /** Source: "builtin" | "app" */
     source?: string;
     pluginId?: string;