@buzzni/saycode-cli 0.9.8 → 0.9.9

package/channel-extension-host.mjs

@@ -48,6 +48,15 @@ function contributionList(value, path2, allowedKeys, parse) {
     return parse(entry, entryPath);
   });
 }
+const ENTRYPOINT_PATTERN = /\.(?:cjs|mjs|js)$/;
+function relativePath(value, path2, requireScript = false) {
+  const parsed = string(value, path2);
+  const segments = parsed.split("/");
+  if (parsed.startsWith("/") || parsed.includes("\\") || segments.some((segment) => segment === "" || segment === "." || segment === "..") || requireScript && !ENTRYPOINT_PATTERN.test(parsed)) {
+    fail$5(path2, "expected safe relative path");
+  }
+  return parsed;
+}
 function keys$1(value, allowed) {
   const result = record$1(value, "widget");
   assertOnlyKeys(result, new Set(allowed), "widget");
@@ -138,6 +147,23 @@ function assertExtensionFileViewers(extensionId2, viewers, panels, permissions)
     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");
   }
 }
+const ELEMENT_PICK_INSPECT_PERMISSION = "browserPicks.inspect";
+function parseExtensionElementPickInspectors(value, apiVersion) {
+  if (apiVersion < 4) fail$5("manifest.contributes.elementPickInspectors", "requires Extension API version 4");
+  return contributionList(value, "manifest.contributes.elementPickInspectors", ["id", "title", "script"], (entry, path2) => ({
+    id: id(entry.id, `${path2}.id`),
+    title: string(entry.title, `${path2}.title`),
+    script: relativePath(entry.script, `${path2}.script`, true)
+  }));
+}
+function assertExtensionElementPickInspectors(extensionId2, inspectors, permissions) {
+  if (inspectors.length > 0 !== permissions.includes(ELEMENT_PICK_INSPECT_PERMISSION)) {
+    fail$5("manifest.contributes.elementPickInspectors", `requires ${ELEMENT_PICK_INSPECT_PERMISSION} permission and an inspector that uses it`);
+  }
+  for (const inspector of inspectors) {
+    if (!inspector.id.startsWith(`${extensionId2}.`)) fail$5("manifest.contributes.elementPickInspectors", "expected an id declared by the same extension");
+  }
+}
 function parseMachineCommands(value, extensionId2, apiVersion) {
   if (apiVersion < 3) fail$5("manifest.machineCommands", "requires Extension API version 3");
   const root = record$1(value, "manifest.machineCommands");
@@ -594,6 +620,7 @@ const EXTENSION_PERMISSIONS = [
   "browserViewer.installChrome",
   "artifacts.publishPublic",
   "filePreviews.read",
+  "browserPicks.inspect",
   // 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
@@ -633,9 +660,8 @@ class UnsupportedExtensionApiVersionError extends Error {
 }
 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(["chatWidgets", "commands", "settings", "panels", "projectTemplates", "machineActions", "projectTools", "artifactActions", "channels", "fileViewers"]);
+const CONTRIBUTION_KEYS = /* @__PURE__ */ new Set(["chatWidgets", "commands", "settings", "panels", "projectTemplates", "machineActions", "projectTools", "artifactActions", "channels", "fileViewers", "elementPickInspectors"]);
 const V2_PERMISSIONS = /* @__PURE__ */ new Set([
   "browserViewer.open",
   "browserViewer.install",
@@ -707,14 +733,6 @@ function parseApiVersion(value, options) {
   }
   return value;
 }
-function relativePath(value, path2, requireScript = false) {
-  const parsed = string(value, path2);
-  const segments = parsed.split("/");
-  if (parsed.startsWith("/") || parsed.includes("\\") || segments.some((segment) => segment === "" || segment === "." || segment === "..") || requireScript && !ENTRYPOINT_PATTERN.test(parsed)) {
-    fail$5(path2, "expected safe relative path");
-  }
-  return parsed;
-}
 function parseChannelApiVersion(value, apiVersion) {
   if (value === void 0) return void 0;
   if (apiVersion < 3) fail$5("manifest.channelApiVersion", "requires Extension API version 3");
@@ -738,6 +756,7 @@ function parseContributions(value, apiVersion, channelApiVersion) {
   }
   const result = {};
   if (parsed.fileViewers !== void 0) result.fileViewers = parseExtensionFileViewers(parsed.fileViewers, apiVersion);
+  if (parsed.elementPickInspectors !== void 0) result.elementPickInspectors = parseExtensionElementPickInspectors(parsed.elementPickInspectors, apiVersion);
   if (parsed.commands !== void 0) {
     result.commands = contributionList(
       parsed.commands,
@@ -860,7 +879,8 @@ function parseContributions(value, apiVersion, channelApiVersion) {
     ...result.machineActions ?? [],
     ...result.projectTools ?? [],
     ...result.artifactActions ?? [],
-    ...result.channels ?? []
+    ...result.channels ?? [],
+    ...result.elementPickInspectors ?? []
   ].map((entry) => entry.id);
   if (new Set(ids).size !== ids.length) fail$5("manifest.contributes", "duplicate contribution id");
   return result;
@@ -893,6 +913,7 @@ function parseExtensionManifest(value, options) {
     const typed = parsed;
     if (typed.startsWith("sessionContext.") && apiVersion !== 5) fail$5("manifest.permissions", "sessionContext requires API 5");
     if (typed === "filePreviews.read" && apiVersion < 4) fail$5("manifest.permissions", "filePreviews.read requires Extension API version 4");
+    if (typed === "browserPicks.inspect" && apiVersion < 4) fail$5("manifest.permissions", "browserPicks.inspect requires Extension API version 4");
     if (apiVersion < 2 && V2_PERMISSIONS.has(typed)) {
       fail$5(`manifest.permissions[${index}]`, "requires Extension API version 2");
     }
@@ -971,6 +992,7 @@ function parseExtensionManifest(value, options) {
     }
   }
   assertExtensionFileViewers(parsedId, contributes.fileViewers ?? [], contributes.panels ?? [], permissions);
+  assertExtensionElementPickInspectors(parsedId, contributes.elementPickInspectors ?? [], permissions);
   assertExtensionProjectToolTargets(parsedId, contributes.projectTools ?? [], contributes.commands ?? []);
   return {
     id: parsedId,
@@ -1120,6 +1142,13 @@ function parseRequest(message) {
         connectionRevision: Number(params.connectionRevision)
       } };
     }
+    case "channel.intake": {
+      exactKeys(params, ["apiVersion", "channelId", "connectionId", "provider", "connectionRevision"], "request.params");
+      const lifecycle = parseRequest({ kind: "request", id: id2, method: "channel.lifecycle", params: { ...params, state: "start" } });
+      if (lifecycle.method !== "channel.lifecycle") fail("invalid channel intake");
+      const { state: _state, ...identity } = lifecycle.params;
+      return { kind: "request", id: id2, method, params: identity };
+    }
     case "channel.formatReply": {
       const formatKeys = [
         "apiVersion",
@@ -1268,6 +1297,7 @@ class ExtensionHostRuntime {
   widgets = /* @__PURE__ */ new Map();
   channelHandlers = /* @__PURE__ */ new Map();
   channelFormatters = /* @__PURE__ */ new Map();
+  channelIntakeHandlers = /* @__PURE__ */ new Map();
   channelStates = /* @__PURE__ */ new Map();
   channelCalls = /* @__PURE__ */ new Map();
   channelEpoch = 0;
@@ -1402,6 +1432,7 @@ class ExtensionHostRuntime {
       this.commandHandlers.clear();
       this.channelHandlers.clear();
       this.channelFormatters.clear();
+      this.channelIntakeHandlers.clear();
       this.channelStates.clear();
       this.channelCalls.clear();
     }
@@ -1444,6 +1475,7 @@ class ExtensionHostRuntime {
         this.commandHandlers.clear();
         this.channelHandlers.clear();
         this.channelFormatters.clear();
+        this.channelIntakeHandlers.clear();
         this.channelStates.clear();
         this.channelCalls.clear();
         this.deactivating = false;
@@ -1463,6 +1495,7 @@ class ExtensionHostRuntime {
     }
     if (request.method === "channel.lifecycle") return this.deliverChannel(request.params);
     if (request.method === "channel.formatReply") return this.formatChannelReply(request.params);
+    if (request.method === "channel.intake") return this.deliverChannelIntake(request.params);
     const handler = this.commandHandlers.get(request.params.commandId);
     if (!handler) {
       throw { code: "COMMAND_NOT_REGISTERED", message: `extension command is not registered: ${request.params.commandId}` };
@@ -1511,6 +1544,14 @@ class ExtensionHostRuntime {
       if (this.channelCalls.get(key) === next) this.channelCalls.delete(key);
     }
   }
+  /** A hint for a live connection only; anything else is answered and dropped, never an error. */
+  async deliverChannelIntake(input) {
+    const current = this.channelStates.get(JSON.stringify([input.channelId, input.connectionId]));
+    const handler = this.channelIntakeHandlers.get(input.channelId);
+    if (!handler || this.deactivating || current?.state !== "start" || current.provider !== input.provider || current.connectionRevision !== input.connectionRevision) return null;
+    await handler(Object.freeze({ ...input }));
+    return null;
+  }
   async formatChannelReply(input) {
     const key = JSON.stringify([input.channelId, input.connectionId]);
     const current = this.channelStates.get(key);
@@ -1555,6 +1596,7 @@ class ExtensionHostRuntime {
       const registered = /* @__PURE__ */ new Map();
       const registeredChannels = /* @__PURE__ */ new Map();
       const registeredFormatters = /* @__PURE__ */ new Map();
+      const registeredIntake = /* @__PURE__ */ new Map();
       await loaded.activate({
         extensionId: this.options.manifest.id,
         chatWidgets: { register: (id2, render) => {
@@ -1573,6 +1615,12 @@ class ExtensionHostRuntime {
               throw { code: "INVALID_CHANNEL_REGISTRATION", message: "formatter must be declared and registered once" };
             }
             registeredFormatters.set(channelId, formatter);
+          },
+          onIntake: (channelId, handler) => {
+            if (!this.activating || this.options.manifest.channelApiVersion !== 1 || !this.options.manifest.contributes.channels?.some((channel) => channel.id === channelId) || typeof handler !== "function" || registeredIntake.has(channelId)) {
+              throw { code: "INVALID_CHANNEL_REGISTRATION", message: "intake handler must be declared and registered once" };
+            }
+            registeredIntake.set(channelId, handler);
           }
         },
         commands: {
@@ -1592,6 +1640,8 @@ class ExtensionHostRuntime {
       this.channelHandlers.clear();
       this.channelFormatters.clear();
       for (const [id2, formatter] of registeredFormatters) this.channelFormatters.set(id2, formatter);
+      this.channelIntakeHandlers.clear();
+      for (const [id2, handler] of registeredIntake) this.channelIntakeHandlers.set(id2, handler);
       for (const [id2, handler] of registeredChannels) this.channelHandlers.set(id2, handler);
       this.commandHandlers.clear();
       for (const [commandId, handler] of registered) this.commandHandlers.set(commandId, handler);