@hachej/boring-workspace 0.1.23 → 0.1.26

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();
           }
@@ -746,7 +762,7 @@ function buildBoringSystemPrompt(opts) {
   if (opts.scaffoldCommand) {
     n += 1;
     steps.push(
-      `**${n}. Scaffold.** Bash \`${opts.scaffoldCommand} <kebab-name> "$BORING_AGENT_WORKSPACE_ROOT"\` \u2014 writes canonical files under \`$BORING_AGENT_WORKSPACE_ROOT/.pi/extensions/<kebab-name>/\`. Read the generated \`package.json\` + \`front/index.tsx\`. Do NOT skip this or write from memory. Never \`cd\` to a parent repo or write plugins outside \`$BORING_AGENT_WORKSPACE_ROOT/.pi/extensions/\`.`
+      `**${n}. Check plugin-root support, then scaffold.** Bash \`boring-ui plugin-status --json\`; continue only if \`workspaceLocalPluginRoots\` is \`true\`. Then bash \`${opts.scaffoldCommand} <kebab-name> "$BORING_AGENT_WORKSPACE_ROOT"\`. Read generated \`package.json\` + \`front/index.tsx\`; do NOT write from memory.`
     );
   } else {
     n += 1;
@@ -772,7 +788,7 @@ function buildBoringSystemPrompt(opts) {
   steps.push(`**${n}. Ask the user to run \`/reload\`** to publish the change.`);
   const docsBlock = boringPiRoot ? [
     "## boring-ui plugin authoring documentation",
-    "Read these only when the user asks to build, modify, or debug a workspace plugin. Use your `read` tool with the absolute path; the agent runtime guarantees these files exist on the host:",
+    "Read these only when the user asks to build, modify, or debug a workspace plugin. Use your `read` tool with these workspace-relative paths; the agent runtime guarantees they exist inside `$BORING_AGENT_WORKSPACE_ROOT`:",
     ...buildDocsRefs(boringPiRoot).map((r) => `- ${r.topic}: ${r.path}`),
     "Follow .md cross-references when present (e.g. SKILL.md may link to a reference doc \u2014 read both)."
   ].join("\n") : [
@@ -780,7 +796,7 @@ function buildBoringSystemPrompt(opts) {
     "The `boring-plugin-authoring` skill listed under `<available_skills>` is the authoritative reference (read its `<location>`). Additional reference docs (`panels.md`, `bridge.md`, `plugins.md`) are unavailable on this host \u2014 `@hachej/boring-pi` is not installed."
   ].join("\n");
   return [
-    "You are operating inside boring-ui. Workspace root: `$BORING_AGENT_WORKSPACE_ROOT`; plugin files go under `$BORING_AGENT_WORKSPACE_ROOT/.pi/extensions/<name>/`.",
+    "You are operating inside boring-ui. Before `.pi/extensions/<name>/`, run `boring-ui plugin-status --json`; continue only when `workspaceLocalPluginRoots` is `true`. Default to `.pi/extensions/<name>/`. Global `~/.pi/agent/extensions/` only for explicit requests.",
     [
       "## Plugin authoring \u2014 required workflow",
       "",
@@ -790,7 +806,7 @@ function buildBoringSystemPrompt(opts) {
       "- API factories: `createPlugin`, `defineFrontPlugin`, `defineComponent` \u2014 use `definePlugin({id, panels, commands, ...})` from `@hachej/boring-workspace/plugin`.",
       "- Imperative method names: `registerComponent`, `addPanel`, `registerCommand` (no `Panel`), `registerTab` \u2014 the actual names are `registerPanel`, `registerPanelCommand`, `registerLeftTab`, `registerSurfaceResolver` (and you usually express these declaratively, not as method calls).",
       "- Import paths: `@hachej/boring-pi` (it's a skills package, not for code), `@boring-ui/*`, `@hachej/pi-sdk` \u2014 use `@hachej/boring-workspace/plugin` for front and `@hachej/boring-workspace/server` for server.",
-      '- File visualizers: for `.csv`/file-tree opens, import `WORKSPACE_OPEN_PATH_SURFACE_KIND` (and `PaneProps`) from `@hachej/boring-workspace/plugin`, read `request.target`, and fetch `/api/v1/files/raw?path=${encodeURIComponent(request.target)}`. Never import these from the root package, use `/workspace/read`, or string kind `"WORKSPACE_OPEN_PATH_SURFACE_KIND"`.',
+      '- File visualizers: import `WORKSPACE_OPEN_PATH_SURFACE_KIND`/`PaneProps` from `@hachej/boring-workspace/plugin`; import `useApiBaseUrl`/`useWorkspaceRequestId` from `@hachej/boring-workspace`; read `request.target`; fetch `${apiBaseUrl}/api/v1/files/raw?...` with `credentials: "include"` and `x-boring-workspace-id` when present. Never use `/workspace/read` or string kind `"WORKSPACE_OPEN_PATH_SURFACE_KIND"`.',
       "- Pi extension tools: `defineTool` and `export const tools` do NOT exist. Export `default function (pi) { pi.registerTool({ name, description, execute }) }`.",
       '- Server/Pi tool method: `handler` \u2014 use `execute`. Return shape: `{ content: [{ type: "text", text }] }` (NEVER a bare string).',
       "- Manifest values: `boring.server: true` \u2014 use `false`/omit for hot-reload user plugins, or a relative path string only for advanced boot-time/static server integration.",
@@ -804,7 +820,7 @@ function buildBoringSystemPrompt(opts) {
 // src/server/agentPlugins/manager.ts
 import { createHash } from "crypto";
 import { existsSync as existsSync4, lstatSync, mkdirSync as mkdirSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, realpathSync as realpathSync2, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname5, isAbsolute as isAbsolute3, join as join4, relative as relative3, resolve as resolve4 } from "path";
+import { dirname as dirname5, isAbsolute as isAbsolute3, join as join4, relative as relative3, resolve as resolve5 } from "path";
 
 // src/shared/plugins/manifest.ts
 var SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
@@ -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);
@@ -1222,7 +1241,48 @@ function clearPluginSignatureCache(pluginRootDir) {
   if (existsSync3(path)) rmSync(path, { force: true });
 }
 
+// src/server/agentPlugins/piPackages.ts
+import { resolve as resolve4 } from "path";
+var REMOTE_PI_PACKAGE_PREFIXES2 = ["npm:", "git:", "github:", "http:", "https:", "ssh:"];
+function isRemotePiPackageSource2(source) {
+  return REMOTE_PI_PACKAGE_PREFIXES2.some((prefix) => source.startsWith(prefix));
+}
+function packageLocalPathFromSource(source) {
+  if (isRemotePiPackageSource2(source)) return null;
+  return source.startsWith("file:") ? source.slice("file:".length) : source;
+}
+function normalizeLocalPiPackageSource(pluginRoot, source) {
+  const localPath = packageLocalPathFromSource(source);
+  if (localPath == null) return source;
+  if (localPath === "." || localPath === "./") return resolve4(pluginRoot);
+  const normalized = localPath.startsWith("./") ? localPath.slice(2) : localPath;
+  if (!isSafePluginRelativePath(normalized)) {
+    throw new Error(`unsafe Pi package source: ${source}`);
+  }
+  return resolve4(pluginRoot, normalized);
+}
+function normalizeBoringPluginPiPackageSource(pluginRoot, source) {
+  if (typeof source === "string") return normalizeLocalPiPackageSource(pluginRoot, source);
+  return {
+    source: normalizeLocalPiPackageSource(pluginRoot, source.source),
+    ...source.extensions ? { extensions: source.extensions } : {},
+    ...source.skills ? { skills: source.skills } : {},
+    ...source.prompts ? { prompts: source.prompts } : {},
+    ...source.themes ? { themes: source.themes } : {}
+  };
+}
+function normalizeBoringPluginPiPackages(plugins) {
+  return plugins.flatMap(
+    (plugin) => (plugin.pi?.packages ?? []).map(
+      (source) => normalizeBoringPluginPiPackageSource(plugin.rootDir, source)
+    )
+  );
+}
+
 // src/server/agentPlugins/manager.ts
+function skillPathForPiLoader(path) {
+  return existsSync4(join4(path, "SKILL.md")) ? dirname5(path) : path;
+}
 function preflightErrorId(pluginDir) {
   return `preflight-${createHash("sha256").update(pluginDir).digest("hex").slice(0, 12)}`;
 }
@@ -1245,8 +1305,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 +1331,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);
       }
     }
@@ -1281,8 +1341,17 @@ function directorySignature(root) {
   visit(root, 0);
   return hash.digest("hex");
 }
+function normalizePluginSubpath(rootDir, path) {
+  return relative3(rootDir, path).replaceAll("\\", "/");
+}
+function frontSignatureRoot(plugin) {
+  if (!plugin.frontPath) return void 0;
+  const frontRoot = join4(plugin.rootDir, "front");
+  const rel = relative3(frontRoot, plugin.frontPath);
+  return rel === "" || !rel.startsWith("..") && !isAbsolute3(rel) ? frontRoot : dirname5(plugin.frontPath);
+}
 function pluginSignature(plugin) {
-  return createHash("sha256").update(JSON.stringify(plugin.boring)).update(JSON.stringify(plugin.pi ?? {})).update(plugin.version).update(plugin.frontPath ?? "").update(pluginFileSignature(plugin.frontPath)).update(directorySignature(plugin.frontPath ? dirname5(plugin.frontPath) : void 0)).update(directorySignature(join4(plugin.rootDir, "shared"))).update(plugin.serverPath ?? "").update(pluginFileSignature(plugin.serverPath)).update(directorySignature(plugin.serverPath ? dirname5(plugin.serverPath) : void 0)).update((plugin.extensionPaths ?? []).join("\0")).update((plugin.skillPaths ?? []).join("\0")).digest("hex");
+  return createHash("sha256").update(JSON.stringify(plugin.boring)).update(JSON.stringify(plugin.pi ?? {})).update(plugin.version).update(plugin.frontPath ?? "").update(pluginFileSignature(plugin.frontPath)).update(directorySignature(frontSignatureRoot(plugin))).update(directorySignature(join4(plugin.rootDir, "shared"))).update(plugin.serverPath ?? "").update(pluginFileSignature(plugin.serverPath)).update(directorySignature(plugin.serverPath ? dirname5(plugin.serverPath) : void 0)).update((plugin.extensionPaths ?? []).join("\0")).update((plugin.skillPaths ?? []).join("\0")).digest("hex");
 }
 function computeRequiresRestart(previous, next) {
   if (!previous) return [];
@@ -1297,32 +1366,55 @@ function computeRequiresRestart(previous, next) {
 var BoringPluginAssetManager = class {
   pluginDirs;
   errorRoot;
+  frontTargetResolver;
+  includeLegacyFrontUrl;
   loaded = /* @__PURE__ */ new Map();
   revisions = /* @__PURE__ */ new Map();
   listeners = /* @__PURE__ */ new Set();
+  lastErrors = /* @__PURE__ */ new Map();
   loading = null;
   reloadQueued = false;
   constructor(options) {
     this.pluginDirs = options.pluginDirs;
     this.errorRoot = options.errorRoot ?? join4(process.cwd(), ".pi", "extensions");
+    this.frontTargetResolver = options.frontTargetResolver;
+    this.includeLegacyFrontUrl = options.includeLegacyFrontUrl ?? true;
   }
   preflight() {
     return preflightBoringPlugins(this.pluginDirs);
   }
   list() {
+    return [...this.loaded.values()].map((plugin) => this.toListEntry(plugin));
+  }
+  getError(pluginId) {
+    const path = this.errorPath(pluginId);
+    if (!path || !existsSync4(path)) return null;
+    return readFileSync3(path, "utf8");
+  }
+  getErrors() {
+    return [...this.lastErrors.values()];
+  }
+  inspectLoaded() {
     return [...this.loaded.values()].map((plugin) => ({
       id: plugin.id,
-      boring: plugin.boring,
-      ...plugin.pi ? { pi: plugin.pi } : {},
       version: plugin.version,
       revision: plugin.revision,
-      ...plugin.frontUrl ? { frontUrl: plugin.frontUrl } : {}
+      rootDir: plugin.rootDir,
+      ...plugin.frontPath ? { frontPath: plugin.frontPath } : {},
+      ...plugin.frontTarget ? { frontTarget: plugin.frontTarget } : {}
     }));
   }
-  getError(pluginId) {
-    const path = this.errorPath(pluginId);
-    if (!path || !existsSync4(path)) return null;
-    return readFileSync3(path, "utf8");
+  inspectLoadedPiSnapshot() {
+    const plugins = [...this.loaded.values()];
+    const prompts = plugins.map((plugin) => plugin.pi?.systemPrompt?.trim()).filter((prompt) => Boolean(prompt));
+    return {
+      additionalSkillPaths: [...new Set(plugins.flatMap((plugin) => plugin.skillPaths ?? []).map(skillPathForPiLoader))],
+      packages: compactPiPackages(normalizeBoringPluginPiPackages(plugins)),
+      extensionPaths: plugins.flatMap((plugin) => plugin.extensionPaths ?? []),
+      ...prompts.length > 0 ? { systemPromptAppend: `# Loaded boring-ui plugin context
+
+${prompts.join("\n\n")}` } : {}
+    };
   }
   subscribe(listener) {
     this.listeners.add(listener);
@@ -1347,19 +1439,21 @@ var BoringPluginAssetManager = class {
     return result;
   }
   async doLoadOnce() {
+    this.lastErrors.clear();
     const scan = scanBoringPlugins(this.pluginDirs);
     const nextPlugins = scan.plugins;
     const nextIds = new Set(nextPlugins.map((plugin) => plugin.id));
-    const invalidPluginDirs = new Set(scan.preflight.errors.map((error) => resolve4(error.pluginDir)));
+    const invalidPluginDirs = new Set(scan.preflight.errors.map((error) => resolve5(error.pluginDir)));
     const events = [];
     const errors = [];
     this.collectPreflightErrors(scan.preflight, events, errors);
     for (const id of [...this.loaded.keys()]) {
       if (nextIds.has(id)) continue;
       const previous = this.loaded.get(id);
-      if (previous && invalidPluginDirs.has(resolve4(previous.rootDir))) continue;
+      if (previous && invalidPluginDirs.has(resolve5(previous.rootDir))) continue;
       const revision = this.bumpRevision(id);
       this.loaded.delete(id);
+      this.lastErrors.delete(id);
       if (previous) {
         try {
           clearPluginSignatureCache(previous.rootDir);
@@ -1376,9 +1470,17 @@ var BoringPluginAssetManager = class {
         const previous = this.loaded.get(plugin.id);
         if (previous?.signature === signature) continue;
         const revision = this.bumpRevision(plugin.id);
+        const frontTarget = this.resolveFrontTarget(plugin, revision);
         const serverSignature = plugin.serverPath ? pluginFileSignature(plugin.serverPath) : null;
-        const record = { ...plugin, revision, signature, serverSignature };
+        const record = {
+          ...plugin,
+          revision,
+          signature,
+          ...frontTarget ? { frontTarget } : {},
+          serverSignature
+        };
         this.loaded.set(plugin.id, record);
+        this.lastErrors.delete(plugin.id);
         this.clearError(plugin.id);
         try {
           writePluginSignatureCache(plugin.rootDir, { serverSignature });
@@ -1391,7 +1493,8 @@ var BoringPluginAssetManager = class {
           boring: plugin.boring,
           version: plugin.version,
           revision,
-          ...plugin.frontUrl ? { frontUrl: plugin.frontUrl } : {},
+          ...this.frontUrlPayload(plugin.frontUrl),
+          ...frontTarget ? { frontTarget } : {},
           ...requiresRestart.length > 0 ? { requiresRestart } : {}
         };
         events.push(event);
@@ -1401,7 +1504,9 @@ var BoringPluginAssetManager = class {
         const message = error instanceof Error ? error.stack ?? error.message : String(error);
         this.writeError(plugin.id, message);
         const event = { type: "boring.plugin.error", id: plugin.id, revision, message };
-        errors.push({ id: plugin.id, revision, message });
+        const loadError = { id: plugin.id, revision, message };
+        this.lastErrors.set(plugin.id, loadError);
+        errors.push(loadError);
         events.push(event);
         this.emit(event);
       }
@@ -1416,6 +1521,7 @@ var BoringPluginAssetManager = class {
 
 Plugin dir: ${error.pluginDir}`;
       const loadError = { id, revision, message };
+      this.lastErrors.set(id, loadError);
       errors.push(loadError);
       this.writeError(id, message);
       const event = { type: "boring.plugin.error", id, revision, message };
@@ -1428,6 +1534,31 @@ Plugin dir: ${error.pluginDir}`;
     this.revisions.set(id, next);
     return next;
   }
+  toListEntry(plugin) {
+    return {
+      id: plugin.id,
+      boring: plugin.boring,
+      ...plugin.pi ? { pi: plugin.pi } : {},
+      version: plugin.version,
+      revision: plugin.revision,
+      ...this.frontUrlPayload(plugin.frontUrl),
+      ...plugin.frontTarget ? { frontTarget: plugin.frontTarget } : {}
+    };
+  }
+  frontUrlPayload(frontUrl) {
+    if (!this.includeLegacyFrontUrl || !frontUrl) return {};
+    return { frontUrl };
+  }
+  resolveFrontTarget(plugin, revision) {
+    if (!plugin.frontPath || !this.frontTargetResolver) return void 0;
+    const frontEntrySubpath = typeof plugin.boring.front === "string" ? plugin.boring.front.replace(/^\.\//, "") : normalizePluginSubpath(plugin.rootDir, plugin.frontPath);
+    const frontTarget = this.frontTargetResolver(plugin, {
+      revision,
+      frontEntrySubpath
+    });
+    if (!frontTarget) return void 0;
+    return { ...frontTarget, revision };
+  }
   emit(event) {
     for (const listener of [...this.listeners]) {
       try {
@@ -1440,8 +1571,8 @@ Plugin dir: ${error.pluginDir}`;
   }
   errorPath(pluginId) {
     if (!isValidBoringPluginId(pluginId)) return null;
-    const root = resolve4(this.errorRoot);
-    const path = resolve4(root, pluginId, ".error");
+    const root = resolve5(this.errorRoot);
+    const path = resolve5(root, pluginId, ".error");
     const rel = relative3(root, path);
     if (rel.startsWith("..") || isAbsolute3(rel)) return null;
     return path;
@@ -1516,27 +1647,44 @@ async function boringPluginRoutes(app, opts) {
     res.setHeader("Connection", "keep-alive");
     res.setHeader("X-Accel-Buffering", "no");
     res.flushHeaders?.();
-    const write = (event) => {
+    const write = (eventName, payload) => {
       try {
-        res.write(`event: ${event.type}
+        res.write(`event: ${eventName}
 `);
-        res.write(`data: ${JSON.stringify(event)}
+        res.write(`data: ${JSON.stringify(payload)}
 
 `);
       } catch {
       }
     };
+    const liveQueue = [];
+    let replaying = true;
+    const unsubscribe = manager.subscribe((event) => {
+      const payload = { ...event, replay: false };
+      if (replaying) {
+        liveQueue.push({ eventName: event.type, payload });
+        return;
+      }
+      write(event.type, payload);
+    });
     for (const plugin of manager.list()) {
-      write({
+      write("boring.plugin.load", {
         type: "boring.plugin.load",
         id: plugin.id,
         boring: plugin.boring,
         version: plugin.version,
         revision: plugin.revision,
-        ...plugin.frontUrl ? { frontUrl: plugin.frontUrl } : {}
+        ...plugin.frontUrl ? { frontUrl: plugin.frontUrl } : {},
+        ...plugin.frontTarget ? { frontTarget: plugin.frontTarget } : {},
+        replay: true
       });
     }
-    const unsubscribe = manager.subscribe(write);
+    write("boring.plugin.replay-complete", {
+      type: "boring.plugin.replay-complete",
+      replay: true
+    });
+    replaying = false;
+    for (const event of liveQueue) write(event.eventName, event.payload);
     const heartbeat = setInterval(() => {
       try {
         res.write(": heartbeat\n\n");

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;