@get-bb/plugin-sdk 0.4.9 → 0.4.10

package/dist/app.js

@@ -3,6 +3,8 @@ var runtime = globalThis.__bbPluginRuntime?.pluginSdkApp ?? {};
 var definePluginApp = runtime.definePluginApp;
 var ThreadChat = runtime.ThreadChat;
 var Markdown = runtime.Markdown;
+var experimental_FileLink = runtime.experimental_FileLink;
+var experimental_UrlLink = runtime.experimental_UrlLink;
 var experimental_NewThreadComposer = runtime.experimental_NewThreadComposer;
 var experimental_SourceCode = runtime.experimental_SourceCode;
 var experimental_Diff = runtime.experimental_Diff;
@@ -12,6 +14,8 @@ var useRealtimeConnectionState = runtime.useRealtimeConnectionState;
 var useSettings = runtime.useSettings;
 var useBbContext = runtime.useBbContext;
 var useBbNavigate = runtime.useBbNavigate;
+var experimental_useAppPanel = runtime.experimental_useAppPanel;
+var experimental_useFixedTabTarget = runtime.experimental_useFixedTabTarget;
 var useComposer = runtime.useComposer;
 var useComposerView = runtime.useComposerView;
 var experimental_useSidebarThreads = runtime.experimental_useSidebarThreads;
@@ -23,8 +27,12 @@ export {
   ThreadChat,
   definePluginApp,
   experimental_Diff,
+  experimental_FileLink,
   experimental_NewThreadComposer,
   experimental_SourceCode,
+  experimental_UrlLink,
+  experimental_useAppPanel,
+  experimental_useFixedTabTarget,
   experimental_useSidebarThreadActions,
   experimental_useSidebarThreadPullRequest,
   experimental_useSidebarThreadSplit,

package/dist/internal/file-navigation-validation.js

@@ -0,0 +1,135 @@
+// src/internal/file-navigation-validation.ts
+var FILE_PATH_MAX_LENGTH = 32768;
+var WINDOWS_DRIVE_ABSOLUTE_PATH = /^[A-Za-z]:[\\/]/u;
+var WINDOWS_UNC_ABSOLUTE_PATH = /^\\\\/u;
+function isJsonObject(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function hasExactKeys(value, keys) {
+  const actualKeys = Object.keys(value);
+  return actualKeys.length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function isNonEmptyIdentity(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= FILE_PATH_MAX_LENGTH && value.trim() === value;
+}
+function hasControlCharacter(value) {
+  for (const character of value) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint !== void 0 && codePoint < 32) return true;
+  }
+  return false;
+}
+function hasUnpairedSurrogate(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    const codeUnit = value.charCodeAt(index);
+    if (codeUnit >= 55296 && codeUnit <= 56319) {
+      if (index + 1 >= value.length) return true;
+      const nextCodeUnit = value.charCodeAt(index + 1);
+      if (nextCodeUnit < 56320 || nextCodeUnit > 57343) return true;
+      index += 1;
+    } else if (codeUnit >= 56320 && codeUnit <= 57343) {
+      return true;
+    }
+  }
+  return false;
+}
+function isValidPathSegment(segment) {
+  return segment.length > 0 && segment !== "." && segment !== "..";
+}
+function isPositiveSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isValidRelativeFilePath(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > FILE_PATH_MAX_LENGTH || value.trim() !== value || value.includes("\\") || hasControlCharacter(value) || hasUnpairedSurrogate(value)) {
+    return false;
+  }
+  return value.split("/").every(isValidPathSegment);
+}
+function isValidAbsoluteHostFilePath(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > FILE_PATH_MAX_LENGTH || value.trim() !== value || hasControlCharacter(value) || hasUnpairedSurrogate(value)) {
+    return false;
+  }
+  if (value.startsWith("/") && !value.startsWith("//")) {
+    const segments = value.slice(1).split("/");
+    return segments.length > 0 && segments.every(isValidPathSegment);
+  }
+  if (WINDOWS_DRIVE_ABSOLUTE_PATH.test(value)) {
+    const segments = value.slice(3).split(/[\\/]/u);
+    return segments.length > 0 && segments.every(isValidPathSegment);
+  }
+  if (WINDOWS_UNC_ABSOLUTE_PATH.test(value)) {
+    const segments = value.slice(2).split(/[\\/]/u);
+    return segments.length >= 3 && segments.every(isValidPathSegment);
+  }
+  return false;
+}
+function normalizeExperimentalLiveFileTarget(value) {
+  if (!isJsonObject(value) || typeof value.kind !== "string") return null;
+  switch (value.kind) {
+    case "workspace":
+      if (!hasExactKeys(value, ["kind", "environmentId", "path"]) || !isNonEmptyIdentity(value.environmentId) || !isValidRelativeFilePath(value.path)) {
+        return null;
+      }
+      return {
+        kind: value.kind,
+        environmentId: value.environmentId,
+        path: value.path
+      };
+    case "host":
+      if (!hasExactKeys(value, ["kind", "hostId", "path"]) || !isNonEmptyIdentity(value.hostId) || !isValidAbsoluteHostFilePath(value.path)) {
+        return null;
+      }
+      return { kind: value.kind, hostId: value.hostId, path: value.path };
+    case "thread-storage":
+      if (!hasExactKeys(value, ["kind", "threadId", "path"]) || !isNonEmptyIdentity(value.threadId) || !isValidRelativeFilePath(value.path)) {
+        return null;
+      }
+      return { kind: value.kind, threadId: value.threadId, path: value.path };
+    default:
+      return null;
+  }
+}
+function normalizeExperimentalFileLocation(value) {
+  if (value === null) return null;
+  if (!isJsonObject(value) || typeof value.kind !== "string") return void 0;
+  switch (value.kind) {
+    case "line":
+      if (!hasExactKeys(value, ["kind", "line", "column"]) || !isPositiveSafeInteger(value.line) || value.column !== null && !isPositiveSafeInteger(value.column)) {
+        return void 0;
+      }
+      return {
+        kind: value.kind,
+        line: value.line,
+        column: value.column
+      };
+    case "range":
+      if (!hasExactKeys(value, ["kind", "startLine", "endLine"]) || !isPositiveSafeInteger(value.startLine) || !isPositiveSafeInteger(value.endLine) || value.endLine < value.startLine) {
+        return void 0;
+      }
+      return {
+        kind: value.kind,
+        startLine: value.startLine,
+        endLine: value.endLine
+      };
+    default:
+      return void 0;
+  }
+}
+function normalizeExperimentalFileOpenOptions(value) {
+  if (!isJsonObject(value) || !hasExactKeys(value, ["target", "location"])) {
+    return null;
+  }
+  const target = normalizeExperimentalLiveFileTarget(value.target);
+  const location = normalizeExperimentalFileLocation(value.location);
+  if (target === null || location === void 0) return null;
+  return { target, location };
+}
+export {
+  normalizeExperimentalFileLocation,
+  normalizeExperimentalFileOpenOptions,
+  normalizeExperimentalLiveFileTarget
+};

package/dist/internal/host-policy.js

@@ -54,6 +54,7 @@ var PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS = 4096;
 var PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES = 128 * 1024;
 var MENTION_PROVIDER_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var PROVIDER_ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,63}$/;
+var PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES = 64 * 1024;
 var SETTING_KEY_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var settingsBaseFields = {
   label: z2.string().min(1),
@@ -255,6 +256,70 @@ function validateProviderLiteralArray(args) {
   }
   return Object.freeze(normalized);
 }
+function normalizeProviderBridgeOptions(providerId, value) {
+  const active = /* @__PURE__ */ new Set();
+  function visit(current, path) {
+    if (current === null || typeof current === "string" || typeof current === "boolean") {
+      return current;
+    }
+    if (typeof current === "number") {
+      if (!Number.isFinite(current)) {
+        throw new Error(
+          `provider "${providerId}" experimental_bridgeOptions${path} must be finite JSON`
+        );
+      }
+      return current;
+    }
+    if (typeof current !== "object") {
+      throw new Error(
+        `provider "${providerId}" experimental_bridgeOptions${path} must be JSON`
+      );
+    }
+    if (active.has(current)) {
+      throw new Error(
+        `provider "${providerId}" experimental_bridgeOptions must not contain cycles`
+      );
+    }
+    active.add(current);
+    try {
+      if (Array.isArray(current)) {
+        const normalized3 = current.map(
+          (entry, index) => visit(entry, `${path}[${index}]`)
+        );
+        Object.freeze(normalized3);
+        return normalized3;
+      }
+      const prototype = Object.getPrototypeOf(current);
+      if (prototype !== Object.prototype && prototype !== null) {
+        throw new Error(
+          `provider "${providerId}" experimental_bridgeOptions${path} must contain only plain JSON objects`
+        );
+      }
+      const normalized2 = Object.fromEntries(
+        Object.entries(current).map(([key, entry]) => [
+          key,
+          visit(entry, `${path}.${key}`)
+        ])
+      );
+      Object.freeze(normalized2);
+      return normalized2;
+    } finally {
+      active.delete(current);
+    }
+  }
+  const normalized = visit(value, "");
+  if (normalized === null || Array.isArray(normalized) || typeof normalized !== "object") {
+    throw new Error(
+      `provider "${providerId}" experimental_bridgeOptions must be an object`
+    );
+  }
+  if (Buffer.byteLength(JSON.stringify(normalized), "utf8") > PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES) {
+    throw new Error(
+      `provider "${providerId}" experimental_bridgeOptions exceeds ${PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES} bytes`
+    );
+  }
+  return normalized;
+}
 function validatePluginProviderDeclaration(declaration) {
   if (typeof declaration !== "object" || declaration === null) {
     throw new Error("provider declaration must be an object");
@@ -292,6 +357,24 @@ function validatePluginProviderDeclaration(declaration) {
   if (typeof capabilities !== "object" || capabilities === null) {
     throw new Error(`provider "${id}" capabilities must be an object`);
   }
+  const experimentalProviderHealth = capabilities.experimental_providerHealth ?? false;
+  const experimentalProviderUsage = capabilities.experimental_providerUsage ?? false;
+  const experimentalProviderInstallation = capabilities.experimental_providerInstallation ?? false;
+  if (typeof experimentalProviderHealth !== "boolean") {
+    throw new Error(
+      `provider "${id}" capabilities.experimental_providerHealth must be a boolean`
+    );
+  }
+  if (typeof experimentalProviderUsage !== "boolean") {
+    throw new Error(
+      `provider "${id}" capabilities.experimental_providerUsage must be a boolean`
+    );
+  }
+  if (typeof experimentalProviderInstallation !== "boolean") {
+    throw new Error(
+      `provider "${id}" capabilities.experimental_providerInstallation must be a boolean`
+    );
+  }
   const booleanCapabilityFields = [
     "supportsServiceTier",
     "supportsNativeUserQuestion",
@@ -313,6 +396,9 @@ function validatePluginProviderDeclaration(declaration) {
     );
   }
   const normalizedCapabilities = Object.freeze({
+    experimental_providerHealth: experimentalProviderHealth,
+    experimental_providerUsage: experimentalProviderUsage,
+    experimental_providerInstallation: experimentalProviderInstallation,
     supportsServiceTier: capabilities.supportsServiceTier,
     supportsNativeUserQuestion: capabilities.supportsNativeUserQuestion,
     fork: capabilities.fork,
@@ -342,10 +428,27 @@ function validatePluginProviderDeclaration(declaration) {
     allowed: PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES,
     requireNonEmpty: false
   });
+  const bridgeOptions = declaration.experimental_bridgeOptions === void 0 ? void 0 : normalizeProviderBridgeOptions(
+    id,
+    declaration.experimental_bridgeOptions
+  );
+  const visibility = declaration.experimental_visibility ?? "always";
+  if (visibility !== "always" && visibility !== "installed") {
+    throw new Error(
+      `provider "${id}" experimental_visibility must be "always" or "installed"`
+    );
+  }
+  if (visibility === "installed" && !normalizedCapabilities.experimental_providerHealth) {
+    throw new Error(
+      `provider "${id}" experimental_visibility "installed" requires experimental_providerHealth`
+    );
+  }
   return Object.freeze({
     id,
     displayName,
     ...icon === void 0 ? {} : { icon },
+    ...bridgeOptions === void 0 ? {} : { experimental_bridgeOptions: bridgeOptions },
+    experimental_visibility: visibility,
     capabilities: normalizedCapabilities,
     composerActions
   });
@@ -608,6 +711,7 @@ export {
   PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES,
   PLUGIN_HTTP_METHODS,
   PLUGIN_MENTION_TRIGGER_VALUES,
+  PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES,
   PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES,
   PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS,
   PLUGIN_PROVIDER_PERMISSION_MODE_VALUES,

package/dist/internal/plugin-app-collector.js

@@ -276,6 +276,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
         const kind = "slots.navPanel";
         const id = requireSlotId(kind, registration?.id);
         requireUniqueId(kind, seenIds.navPanel, id);
+        const panelId = id;
         const path = requireNonEmptyString(kind, "path", registration.path);
         if (!PLUGIN_SLOT_ID_PATTERN.test(path)) {
           throw new Error(
@@ -311,8 +312,25 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
                 `${fixedTabKind}: "layout" must be "padded" or "flush" when set`
               );
             }
+            const fixedTabPanelId = requireNonEmptyString(
+              fixedTabKind,
+              "panelId",
+              fixedTab?.panelId
+            );
+            if (fixedTabPanelId !== panelId) {
+              throw new Error(
+                `${fixedTabKind}: "panelId" must match its containing navPanel id ${JSON.stringify(panelId)}`
+              );
+            }
+            const experimentalTarget = fixedTab?.experimental_target;
+            if (experimentalTarget !== void 0 && (typeof experimentalTarget !== "object" || experimentalTarget === null || typeof Reflect.get(experimentalTarget, "validate") !== "function")) {
+              throw new Error(
+                `${fixedTabKind}: "experimental_target.validate" must be a function when set`
+              );
+            }
             return {
               id: id2,
+              panelId: fixedTabPanelId,
               title: requireNonEmptyString(
                 fixedTabKind,
                 "title",
@@ -324,7 +342,10 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
                 fixedTab?.icon
               ),
               component: requireComponent(fixedTabKind, fixedTab?.component),
-              ...layout === void 0 ? {} : { layout }
+              ...layout === void 0 ? {} : { layout },
+              ...experimentalTarget === void 0 ? {} : {
+                experimental_target: experimentalTarget
+              }
             };
           });
         })();