@buzzni/saycode-cli 0.9.1 → 0.9.3

package/channel-extension-host.mjs

@@ -48,6 +48,18 @@ function contributionList(value, path2, allowedKeys, parse) {
     return parse(entry, entryPath);
   });
 }
+function parseExtensionFileViewers(value, apiVersion) {
+  if (apiVersion < 4) fail$5("manifest.contributes.fileViewers", "requires Extension API version 4");
+  return contributionList(value, "manifest.contributes.fileViewers", ["id", "title", "extensions", "panelId"], (entry, path2) => {
+    if (!Array.isArray(entry.extensions) || !entry.extensions.length || entry.extensions.length > 30 || entry.extensions.some((extension) => typeof extension !== "string" || !/^[a-z0-9]{1,12}$/.test(extension)) || new Set(entry.extensions).size !== entry.extensions.length) fail$5(`${path2}.extensions`, "expected unique lowercase file extensions");
+    return { id: id(entry.id, `${path2}.id`), title: string(entry.title, `${path2}.title`), extensions: entry.extensions, panelId: id(entry.panelId, `${path2}.panelId`) };
+  });
+}
+function assertExtensionFileViewers(extensionId2, viewers, panels, permissions) {
+  for (const viewer of viewers) {
+    if (!permissions.includes("filePreviews.read") || !viewer.id.startsWith(`${extensionId2}.`) || !viewer.panelId.startsWith(`${extensionId2}.`) || !panels.some((panel) => panel.id === viewer.panelId)) fail$5("manifest.contributes.fileViewers", "requires filePreviews.read and an owned panel");
+  }
+}
 function parseMachineCommands(value, extensionId2, apiVersion) {
   if (apiVersion < 3) fail$5("manifest.machineCommands", "requires Extension API version 3");
   const root = record$1(value, "manifest.machineCommands");
@@ -240,6 +252,23 @@ const EXTENSION_PANEL_SURFACE_SIZES = ["compact", "standard", "wide"];
 function isExtensionPanelSurfaceSize(value) {
   return EXTENSION_PANEL_SURFACE_SIZES.some((size) => size === value);
 }
+function parseExtensionProjectTools(value, apiVersion) {
+  if (apiVersion < 3) fail$5("manifest.contributes.projectTools", "requires Extension API version 3");
+  return contributionList(value, "manifest.contributes.projectTools", ["id", "title", "command"], (entry, path2) => ({
+    id: id(entry.id, `${path2}.id`),
+    title: string(entry.title, `${path2}.title`),
+    command: id(entry.command, `${path2}.command`)
+  }));
+}
+function assertExtensionProjectToolTargets(extensionId2, tools, commands) {
+  for (const [index, tool] of tools.entries()) {
+    const path2 = `manifest.contributes.projectTools[${index}]`;
+    if (!tool.id.startsWith(`${extensionId2}.`)) fail$5(`${path2}.id`, "expected an id declared by the same extension");
+    const command = tool.command.startsWith(`${extensionId2}.`) ? commands.find((candidate) => candidate.id === tool.command) : void 0;
+    if (!command) fail$5(`${path2}.command`, "expected a command declared by the same extension");
+    if (!command.panelId) fail$5(`${path2}.command`, "expected a command that opens a panel");
+  }
+}
 const EXTENSION_ARTIFACT_ACTION_OPERATIONS = ["publishPublic"];
 const EXTENSION_ARTIFACT_SOURCE_TYPES = ["project-file", "personal-chat-file"];
 const ID_PATTERN$1 = /^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/;
@@ -484,6 +513,7 @@ const EXTENSION_PERMISSIONS = [
   "browserViewer.install",
   "browserViewer.installChrome",
   "artifacts.publishPublic",
+  "filePreviews.read",
   // One permission per channel wire method (`src/domain/channelProtocol.ts`), deliberately not a
   // single adapter grant. Receiving and acking messages is transport work; reading a session,
   // driving it, or approving a tool call once are three larger and separately-refusable
@@ -498,10 +528,10 @@ const EXTENSION_PERMISSIONS = [
   "sessions.control",
   "sessions.approveOnce"
 ];
-const SAYCODE_EXTENSION_API_VERSION = 3;
+const SAYCODE_EXTENSION_API_VERSION = 4;
 const SAYCODE_EXTENSION_MINIMUM_API_VERSION = 2;
 const MAX_EXTENSION_API_WINDOW_WIDTH = 2;
-const SAYCODE_EXTENSION_ENGINE_VERSION = "1.1.0";
+const SAYCODE_EXTENSION_ENGINE_VERSION = "1.2.0";
 const SAYCODE_CHANNEL_API_VERSION = CHANNEL_API_VERSION;
 const SAYCODE_CHANNEL_MINIMUM_API_VERSION = CHANNEL_MINIMUM_API_VERSION;
 class UnsupportedChannelApiVersionError extends Error {
@@ -524,7 +554,7 @@ const SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$
 const ENGINE_RANGE_PATTERN = /^(?:\^|~|>=|<=|>|<)?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 const ENTRYPOINT_PATTERN = /\.(?:cjs|mjs|js)$/;
 const LOCALE_PATTERN = /^[a-z]{2,3}(?:-[A-Z]{2})?$/;
-const CONTRIBUTION_KEYS = /* @__PURE__ */ new Set(["commands", "settings", "panels", "projectTemplates", "machineActions", "artifactActions", "channels"]);
+const CONTRIBUTION_KEYS = /* @__PURE__ */ new Set(["commands", "settings", "panels", "projectTemplates", "machineActions", "projectTools", "artifactActions", "channels", "fileViewers"]);
 const V2_PERMISSIONS = /* @__PURE__ */ new Set([
   "browserViewer.open",
   "browserViewer.install",
@@ -585,7 +615,7 @@ function engineSupports(range, version) {
 function parseApiVersion(value, options) {
   const current = options.supportedApiVersion;
   const floor = options.minimumSupportedApiVersion ?? current;
-  if (floor > current || current - floor + 1 > MAX_EXTENSION_API_WINDOW_WIDTH) {
+  if (floor > current || current - floor + 1 > (current === 4 && floor === 2 ? 3 : MAX_EXTENSION_API_WINDOW_WIDTH)) {
     fail$5(
       "manifest.apiVersion",
       `invalid Desktop API support window [${floor}, ${current}]`
@@ -626,6 +656,7 @@ function parseContributions(value, apiVersion, channelApiVersion) {
     fail$5("manifest.contributes.artifactActions", "requires Extension API version 3");
   }
   const result = {};
+  if (parsed.fileViewers !== void 0) result.fileViewers = parseExtensionFileViewers(parsed.fileViewers, apiVersion);
   if (parsed.commands !== void 0) {
     result.commands = contributionList(
       parsed.commands,
@@ -731,6 +762,7 @@ function parseContributions(value, apiVersion, channelApiVersion) {
       }
     );
   }
+  if (parsed.projectTools !== void 0) result.projectTools = parseExtensionProjectTools(parsed.projectTools, apiVersion);
   if (parsed.artifactActions !== void 0) {
     result.artifactActions = parseExtensionArtifactActions(parsed.artifactActions);
   }
@@ -743,6 +775,7 @@ function parseContributions(value, apiVersion, channelApiVersion) {
     ...result.panels ?? [],
     ...result.projectTemplates ?? [],
     ...result.machineActions ?? [],
+    ...result.projectTools ?? [],
     ...result.artifactActions ?? [],
     ...result.channels ?? []
   ].map((entry) => entry.id);
@@ -775,6 +808,7 @@ function parseExtensionManifest(value, options) {
       fail$5("manifest.permissions", `unknown permission ${parsed}`);
     }
     const typed = parsed;
+    if (typed === "filePreviews.read" && apiVersion < 4) fail$5("manifest.permissions", "filePreviews.read requires Extension API version 4");
     if (apiVersion < 2 && V2_PERMISSIONS.has(typed)) {
       fail$5(`manifest.permissions[${index}]`, "requires Extension API version 2");
     }
@@ -846,6 +880,8 @@ function parseExtensionManifest(value, options) {
       );
     }
   }
+  assertExtensionFileViewers(parsedId, contributes.fileViewers ?? [], contributes.panels ?? [], permissions);
+  assertExtensionProjectToolTargets(parsedId, contributes.projectTools ?? [], contributes.commands ?? []);
   return {
     id: parsedId,
     version,