@salesforce/platform-sdk 9.15.0 → 9.16.0

package/dist/TelemetryUploader-DKkdppe9.js

@@ -0,0 +1,135 @@
+import { encodeCoreEnvelopeContentsRaw as a } from "o11y/collectors";
+import { SimpleCollector as h } from "o11y/simple_collector";
+const c = 1e4, d = 10, u = 10, _ = 250, m = 1e3;
+function s(i, e) {
+  if (i !== void 0 && (typeof i != "number" || !Number.isFinite(i) || i <= 0))
+    throw new Error(`${e}, if defined, must be a finite number greater than 0`);
+}
+function g(i, e) {
+  if (typeof i != "function")
+    throw new Error(`${e} must be a function`);
+}
+class f {
+  _collector;
+  _onEnvelope;
+  _onError;
+  _enableClickTrigger;
+  _enableVisibilityTrigger;
+  _messagesLimit;
+  _metricsLimit;
+  _uploadInterval;
+  _clickUploadDelay;
+  _clickTriggerCooldown;
+  _boundClickListener = this._handleClick.bind(this);
+  _boundVisibilityChangeListener = this._handleVisibilityChange.bind(this);
+  _boundPageHideListener = this._handlePageHide.bind(this);
+  _intervalHandle;
+  _clickTimeoutHandle;
+  _flushPromise;
+  _pendingFlushReason;
+  _lastClickTriggeredAt = 0;
+  _isDisposed = !1;
+  constructor(e) {
+    g(e?.onEnvelope, "options.onEnvelope"), s(e.uploadInterval, "options.uploadInterval"), s(e.messagesLimit, "options.messagesLimit"), s(e.metricsLimit, "options.metricsLimit"), s(e.maxUniqueSchemas, "options.maxUniqueSchemas"), s(e.clickUploadDelay, "options.clickUploadDelay"), s(e.clickTriggerCooldown, "options.clickTriggerCooldown"), this._onEnvelope = e.onEnvelope, this._onError = e.onError, this._messagesLimit = e.messagesLimit ?? d, this._metricsLimit = e.metricsLimit ?? u, this._uploadInterval = e.uploadInterval ?? c, this._clickUploadDelay = e.clickUploadDelay ?? _, this._clickTriggerCooldown = e.clickTriggerCooldown ?? m, this._enableClickTrigger = e.enableClickTrigger !== !1, this._enableVisibilityTrigger = e.enableVisibilityTrigger !== !1, this._collector = new h({
+      environment: e.environment,
+      maxUniqueSchemas: e.maxUniqueSchemas
+    }), this._restartInterval(), this._attachWindowListeners();
+  }
+  get hasData() {
+    return this._collector.hasData;
+  }
+  get estimatedByteSize() {
+    return this._collector.estimatedByteSize;
+  }
+  get messagesCount() {
+    return this._collector.messagesCount;
+  }
+  get metricsCount() {
+    return this._collector.metricsCount;
+  }
+  getIsCollectDisabled() {
+    return this._isDisposed;
+  }
+  collect(e, t, r) {
+    this._collector.collect(
+      e,
+      t,
+      r
+    ), this._shouldFlushForThreshold() && this.flush("threshold");
+  }
+  receiveMetricsExtractors(e) {
+    this._collector.receiveMetricsExtractors(
+      e
+    );
+  }
+  async flush(e = "manual") {
+    return this._flushPromise ? (this._pendingFlushReason = this._pendingFlushReason ?? e, this._flushPromise) : (this._flushPromise = this._flushInternal(e).then(() => {
+      const t = this._pendingFlushReason;
+      this._pendingFlushReason = void 0, t && this.hasData && !this._isDisposed && this.flush(t);
+    }).finally(() => {
+      this._flushPromise = void 0;
+    }), this._flushPromise);
+  }
+  async dispose(e) {
+    this._isDisposed = !0, this._detachWindowListeners(), this._stopInterval(), this._clickTimeoutHandle !== void 0 && (clearTimeout(this._clickTimeoutHandle), this._clickTimeoutHandle = void 0), e?.flush !== !1 && this.hasData && await this.flush("dispose");
+  }
+  _attachWindowListeners() {
+    typeof document == "object" && this._enableClickTrigger && document.addEventListener("click", this._boundClickListener, !0), typeof window == "object" && this._enableVisibilityTrigger && (document.addEventListener("visibilitychange", this._boundVisibilityChangeListener, !0), window.addEventListener("pagehide", this._boundPageHideListener, !0));
+  }
+  _detachWindowListeners() {
+    typeof document == "object" && (document.removeEventListener("click", this._boundClickListener, !0), document.removeEventListener("visibilitychange", this._boundVisibilityChangeListener, !0)), typeof window == "object" && window.removeEventListener("pagehide", this._boundPageHideListener, !0);
+  }
+  _handleClick() {
+    !this.hasData || this._isDisposed || Date.now() - this._lastClickTriggeredAt < this._clickTriggerCooldown || (this._clickTimeoutHandle !== void 0 && clearTimeout(this._clickTimeoutHandle), this._clickTimeoutHandle = setTimeout(() => {
+      this._clickTimeoutHandle = void 0, !(!this.hasData || this._isDisposed) && (this._lastClickTriggeredAt = Date.now(), this.flush("click"));
+    }, this._clickUploadDelay));
+  }
+  _handleVisibilityChange() {
+    typeof document != "object" || document.visibilityState !== "hidden" || !this.hasData || this.flush("visibilitychange");
+  }
+  _handlePageHide() {
+    this.hasData && this.flush("pagehide");
+  }
+  _restartInterval() {
+    this._stopInterval(), this._intervalHandle = setInterval(() => {
+      this.hasData && !this._isDisposed && this.flush("interval");
+    }, this._uploadInterval);
+  }
+  _stopInterval() {
+    this._intervalHandle !== void 0 && (clearInterval(this._intervalHandle), this._intervalHandle = void 0);
+  }
+  _shouldFlushForThreshold() {
+    return this.messagesCount >= this._messagesLimit || this.metricsCount >= this._metricsLimit;
+  }
+  async _flushInternal(e) {
+    if (!this.hasData)
+      return;
+    const t = {
+      reason: e,
+      messagesCount: this.messagesCount,
+      metricsCount: this.metricsCount,
+      estimatedByteSize: this.estimatedByteSize,
+      triggeredAt: Date.now()
+    }, r = this._collector.getRawContentsOfCoreEnvelope(), o = a(r);
+    this._restartInterval();
+    try {
+      await this._onEnvelope(o, t);
+    } catch (n) {
+      const l = {
+        ...t,
+        error: n
+      };
+      throw this._onError?.(l), n;
+    }
+  }
+}
+function b(i, e) {
+  if (!i)
+    throw new Error("instrumentedApp is required");
+  const t = new f(e);
+  return i.registerLogCollector(t), i.registerMetricsCollector(t), e.enableClickTrigger !== !1 && i.activateClickTracker?.(), t;
+}
+export {
+  f as T,
+  b as r
+};

package/dist/analytics/index.js

@@ -0,0 +1,6 @@
+import { P as e, c as s, v as c } from "../analytics-496rdIN5.js";
+export {
+  e as PFT_META_KEY,
+  s as createAnalytics,
+  c as validatePftId
+};

package/dist/analytics-496rdIN5.js

@@ -0,0 +1,163 @@
+import { registerInstrumentedApp as x } from "o11y/client";
+import { g as I } from "./sdk-promise-7SpSqah5.js";
+import { getChatSDK as h } from "./chat/index.js";
+import { r as E } from "./TelemetryUploader-DKkdppe9.js";
+import { analyticsContextSchema as P, sessionSchema as S, pageViewSchema as v, errorContextSchema as k, interactionSchema as C, customEventSchema as _ } from "o11y_schema/sf_mcpanalytics";
+function b(e) {
+  const t = (o, d, y, c, s) => {
+    e.error(s ?? o);
+  }, n = (o) => {
+    e.error(o.reason);
+  };
+  return window.addEventListener("error", t), window.addEventListener("unhandledrejection", n), () => {
+    window.removeEventListener("error", t), window.removeEventListener("unhandledrejection", n);
+  };
+}
+const D = "aJC", R = "sfdc.pftId", w = /* @__PURE__ */ new Set(), F = /^aJC[0-9A-Za-z]{12}(?:[0-9A-Za-z]{3})?$/;
+function T(e) {
+  return typeof e != "string" || e.length === 0 ? !1 : e.length !== 15 && e.length !== 18 ? (A(e, "Expected a 15- or 18-character Salesforce ID"), !1) : F.test(e) ? !0 : (A(e, `Expected a Product Feature Id (prefix "${D}", base62).`), !1);
+}
+function A(e, t) {
+  w.has(e) || (w.add(e), console.debug(`[platform-sdk:analytics] Ignoring invalid PFT Id "${e}". ${t}`));
+}
+function u(e, t) {
+  return { surface: t };
+}
+const L = {
+  callTool: {
+    isAsync: !0,
+    extractTags: (e, t) => ({ toolName: e[0]?.toolName ?? "unknown", surface: t })
+  },
+  setWidgetState: {
+    isAsync: !1,
+    extractTags: u
+  },
+  getWidgetState: {
+    isAsync: !1,
+    extractTags: u
+  },
+  sendMessageToHost: {
+    isAsync: !0,
+    extractTags: u
+  },
+  openLink: {
+    isAsync: !0,
+    extractTags: u
+  },
+  subscribe: {
+    isAsync: !1,
+    extractTags: u,
+    wrapArgs: (e, t) => {
+      const n = e[0];
+      return [
+        () => {
+          t.activity("sdk.subscribe_callback", () => n());
+        }
+      ];
+    }
+  },
+  readResource: {
+    isAsync: !0,
+    extractTags: (e, t) => ({ uri: e[0]?.uri ?? "unknown", surface: t })
+  },
+  setDisplayMode: {
+    isAsync: !0,
+    extractTags: (e, t) => ({ mode: e[0] ?? "unknown", surface: t })
+  },
+  accessToolOutput: {
+    isAsync: !1,
+    extractTags: u
+  },
+  accessToolInput: {
+    isAsync: !1,
+    extractTags: u
+  },
+  accessToolMetadata: {
+    isAsync: !1,
+    extractTags: u
+  }
+};
+function N(e, t, n) {
+  return new Proxy(e, {
+    get(o, d, y) {
+      const c = Reflect.get(o, d, y), s = L[d];
+      return !s || typeof c != "function" ? c : (...a) => {
+        const p = s.extractTags(a, n), m = s.wrapArgs ? s.wrapArgs(a, t) : a, l = `sdk.${String(d)}`;
+        return s.isAsync ? t.activityAsync(l, async () => {
+          try {
+            const g = await c.apply(
+              o,
+              m
+            );
+            return t.incrementCounter(l, 1, !1, p), g;
+          } catch (g) {
+            throw t.incrementCounter(l, 1, !0, p), g;
+          }
+        }) : (t.incrementCounter(l, 1, !1, p), c.apply(o, m));
+      };
+    }
+  });
+}
+async function j(e) {
+  const { appId: t, clientSessionId: n } = e, o = I(), d = Date.now(), y = e.sdk ?? await h();
+  let c = null;
+  e.pftId !== void 0 && T(e.pftId) && (c = e.pftId);
+  const s = x("mcp-widget", {
+    appPayloadProvider: {
+      getPayload: () => ({
+        schema: P,
+        payload: {
+          appId: t,
+          surface: o,
+          ...c !== null ? { pftId: c } : {}
+        }
+      })
+    },
+    clientSessionId: n
+  }), a = s, p = N(y, a, o), m = b(a);
+  let l;
+  e.transport && (l = E(s, {
+    onEnvelope: (r) => {
+      e.transport.enqueue(r);
+    }
+  }));
+  let g, f = !1;
+  return {
+    instrumentedSDK: p,
+    app: s,
+    trackEvent(r, i) {
+      f || a.log(_, {
+        eventName: r,
+        properties: i ? JSON.stringify(i) : ""
+      });
+    },
+    trackInteraction(r, i) {
+      f || a.log(C, {
+        elementId: r,
+        properties: i ? JSON.stringify(i) : ""
+      });
+    },
+    trackError(r, i) {
+      f || a.error(r, k, {
+        properties: i ? JSON.stringify(i) : ""
+      });
+    },
+    trackPageView(r) {
+      f || r !== g && (g = r, a.log(v, { componentRef: r }));
+    },
+    setPftId(r) {
+      f || T(r) && (c = r);
+    },
+    dispose() {
+      if (f) return;
+      f = !0, m();
+      const r = Date.now() - d;
+      a.log(S, { durationMs: r }), l?.dispose();
+    }
+  };
+}
+export {
+  R as P,
+  j as c,
+  T as v
+};

package/dist/chat/index.js

@@ -0,0 +1,227 @@
+import { w as u, g as c, S as n } from "../sdk-promise-7SpSqah5.js";
+import { M as d } from "../mcpapps-session-BOT5CvWa.js";
+class p {
+  constructor(t) {
+    this.session = t;
+    const e = t.getHostContext();
+    e.toolOutput !== void 0 && (this.globals.toolOutput = e.toolOutput), e.toolStructuredContent !== void 0 && (this.globals.toolStructuredContent = e.toolStructuredContent), e.toolInput !== void 0 && (this.globals.toolInput = e.toolInput), e.toolResponseMetadata !== void 0 && (this.globals.toolResponseMetadata = e.toolResponseMetadata), e.widgetState !== void 0 && (this.globals.widgetState = e.widgetState), t.registerNotificationHandler(
+      "ui/notifications/host-context-changed",
+      () => this.notifySubscribers()
+    ), t.registerNotificationHandler(
+      "ui/notifications/tool-result",
+      (o) => this.handleToolResult(o)
+    ), t.registerNotificationHandler(
+      "ui/notifications/tool-input",
+      (o) => this.handleToolInput(o)
+    ), t.registerNotificationHandler(
+      "ui/notifications/tool-cancelled",
+      (o) => this.handleToolCancelled(o)
+    );
+  }
+  globals = {};
+  canceledCallbacks = /* @__PURE__ */ new Set();
+  subscriptions = /* @__PURE__ */ new Set();
+  /**
+   * Handle tool result notifications from the host
+   * @param params - Tool result data from the host
+   */
+  handleToolResult(t) {
+    const e = t;
+    let o = !1;
+    e.content !== void 0 && (this.globals.toolOutput = e.content, o = !0), e.structuredContent !== void 0 && (this.globals.toolStructuredContent = e.structuredContent, o = !0), e._meta !== void 0 && (this.globals.toolResponseMetadata = e._meta, o = !0), o && this.notifySubscribers();
+  }
+  /**
+   * Handle tool input notifications from the host
+   * @param params - Tool input data from the host
+   */
+  handleToolInput(t) {
+    const e = t;
+    e.arguments !== void 0 && Object.keys(e.arguments).length > 0 && (this.globals.toolInput = e.arguments, this.notifySubscribers());
+  }
+  /**
+   * Handle tool cancelled notifications from the host
+   * @param params - Tool cancellation data from the host
+   */
+  handleToolCancelled(t) {
+    const o = t.reason ?? "";
+    this.canceledCallbacks.forEach((l) => l(o));
+  }
+  /**
+   * Request display mode change from host
+   * @param mode - The requested display mode
+   * @returns Promise with the new display mode (confirmed by host)
+   */
+  async setDisplayMode(t) {
+    return await this.session.request("ui/request-display-mode", {
+      displayMode: t
+    });
+  }
+  async sendMessageToHost(t) {
+    await this.session.request("ui/message", {
+      role: "user",
+      content: [
+        {
+          type: "text",
+          text: t.content
+        }
+      ]
+    });
+  }
+  async callTool(t) {
+    return await this.session.request("tools/call", {
+      name: t.toolName,
+      arguments: t.params ?? {}
+    });
+  }
+  async readResource(t) {
+    return await this.session.request("resources/read", {
+      uri: t.uri
+    });
+  }
+  async openLink(t) {
+    await this.session.request("ui/open-link", { url: t });
+  }
+  accessToolInput() {
+    const t = this.globals.toolInput;
+    return t ? { data: t } : null;
+  }
+  accessToolOutput() {
+    const t = this.globals.toolStructuredContent;
+    if (t)
+      return { data: t };
+    const e = this.globals.toolOutput;
+    return e ? { data: e } : null;
+  }
+  accessToolMetadata() {
+    if (this.globals.toolResponseMetadata)
+      return this.globals.toolResponseMetadata;
+    const t = this.session.getHostContext().toolInfo;
+    return t || null;
+  }
+  getWidgetState() {
+    const t = this.globals.widgetState;
+    return t || null;
+  }
+  setWidgetState(t, e) {
+    this.globals.widgetState = t;
+    const o = { state: t };
+    e?.content !== void 0 && (o.content = e.content), e?.structuredContent !== void 0 && (o.structuredContent = e.structuredContent), this.session.request("ui/update-model-context", o).catch(() => {
+    }), this.notifySubscribers();
+  }
+  /**
+   * Get the current host context.
+   *
+   * Maps MCP Apps wire-format fields to the protocol-agnostic HostContext.
+   * Always returns an object (empty `{}` when no context has been received).
+   */
+  getHostContext() {
+    const t = this.session.getHostContext(), e = {};
+    if (t.theme !== void 0 && (e.theme = t.theme), t.displayMode !== void 0 && (e.displayMode = t.displayMode), t.containerDimensions !== void 0) {
+      const o = t.containerDimensions.maxHeight ?? t.containerDimensions.height;
+      o !== void 0 && (e.maxHeight = o);
+    }
+    return t.safeAreaInsets !== void 0 && (e.safeArea = t.safeAreaInsets), t.userAgent !== void 0 && (e.userAgent = t.userAgent), t.locale !== void 0 && (e.locale = t.locale), t.deviceCapabilities !== void 0 && (e.deviceCapabilities = t.deviceCapabilities), t.styles !== void 0 && (e.styles = t.styles), e;
+  }
+  onToolCanceled(t) {
+    return this.canceledCallbacks.add(t), () => {
+      this.canceledCallbacks.delete(t);
+    };
+  }
+  subscribe(t) {
+    return this.subscriptions.add(t), () => {
+      this.subscriptions.delete(t);
+    };
+  }
+  notifySubscribers() {
+    this.subscriptions.forEach((t) => t());
+  }
+}
+const r = "openai:set_globals";
+class f {
+  sendMessageToHost(t) {
+    return window.openai.sendFollowUpMessage({ prompt: t.content });
+  }
+  callTool(t) {
+    return window.openai.callTool(t.toolName, t.params ?? {});
+  }
+  accessToolInput() {
+    const t = window.openai.toolInput;
+    return t ? { data: t } : null;
+  }
+  accessToolOutput() {
+    const t = window.openai.toolOutput;
+    return t ? { data: t } : null;
+  }
+  accessToolMetadata() {
+    const t = window.openai.toolResponseMetadata;
+    return t || null;
+  }
+  getWidgetState() {
+    const t = window.openai.widgetState;
+    return t || null;
+  }
+  setWidgetState(t, e) {
+    window.openai.setWidgetState(t);
+  }
+  async openLink(t) {
+    const e = window.openai;
+    typeof e?.openExternal == "function" ? await e.openExternal({ href: t }) : window.open(t, "_blank", "noopener,noreferrer");
+  }
+  async setDisplayMode(t) {
+    return window.openai.requestDisplayMode({ mode: t });
+  }
+  subscribe(t) {
+    const e = () => t();
+    return window.addEventListener(r, e), () => {
+      window.removeEventListener(r, e);
+    };
+  }
+}
+class h {
+  async sendMessageToHost(t) {
+    throw console.warn("SalesforceACCChatSDK.sendMessageToHost: stub implementation", t), new Error("SalesforceACCChatSDK.sendMessageToHost not yet implemented");
+  }
+  followUpActions() {
+    return console.warn("SalesforceACCChatSDK.followUpActions: stub implementation"), [];
+  }
+}
+let a = null, i = null;
+function b(s) {
+  return a || (a = g(s).then((t) => (i = t, t))), a;
+}
+function C() {
+  return i;
+}
+function m() {
+  a = null, i = null;
+}
+function g(s) {
+  return u(
+    (async () => {
+      switch (c(s?.surface)) {
+        case n.OpenAI:
+          return new f();
+        case n.WebApp:
+        case n.Mosaic:
+          return {};
+        case n.SalesforceACC:
+          return new h();
+        case n.MicroFrontend:
+        case n.MCPApps: {
+          const e = await d.getInstance(s?.mcpApps);
+          return e.handshakeSucceeded ? new p(e) : {};
+        }
+        default:
+          return {};
+      }
+    })(),
+    "createChatSDK"
+  );
+}
+export {
+  p as MCPAppsChatSDK,
+  g as createChatSDK,
+  b as getChatSDK,
+  C as getChatSDKSync,
+  m as resetChatSDK
+};

package/dist/core/index.js

@@ -0,0 +1,107 @@
+import { S as e } from "../sdk-promise-7SpSqah5.js";
+import { g as i, w as f } from "../sdk-promise-7SpSqah5.js";
+import { M as p } from "../mcpapps-session-BOT5CvWa.js";
+const s = {
+  callTool: !0,
+  sendMessageToHost: !0,
+  readResource: !0,
+  openLink: !0,
+  accessToolInput: !0,
+  accessToolOutput: !0,
+  accessToolMetadata: !0,
+  getWidgetState: !0,
+  setWidgetState: !0,
+  setWidgetStateModelContext: !0,
+  onToolCanceled: !0,
+  setDisplayMode: !0,
+  getHostContext: !0,
+  subscribe: !0,
+  displayAlert: !0,
+  displayToast: !0,
+  displayModal: !1,
+  // TODO
+  getTheme: !0,
+  resize: !0
+}, a = {
+  callTool: !0,
+  sendMessageToHost: !0,
+  readResource: !1,
+  openLink: !0,
+  accessToolInput: !0,
+  accessToolOutput: !0,
+  accessToolMetadata: !0,
+  getWidgetState: !0,
+  setWidgetState: !0,
+  setWidgetStateModelContext: !1,
+  onToolCanceled: !1,
+  setDisplayMode: !0,
+  getHostContext: !1,
+  subscribe: !0,
+  displayAlert: !0,
+  displayToast: !0,
+  displayModal: !0,
+  getTheme: !0,
+  resize: !1
+}, o = {
+  callTool: !1,
+  sendMessageToHost: !0,
+  readResource: !1,
+  openLink: !0,
+  accessToolInput: !1,
+  accessToolOutput: !1,
+  accessToolMetadata: !1,
+  getWidgetState: !1,
+  setWidgetState: !1,
+  setWidgetStateModelContext: !1,
+  onToolCanceled: !1,
+  setDisplayMode: !1,
+  getHostContext: !1,
+  subscribe: !0,
+  displayAlert: !0,
+  displayToast: !0,
+  displayModal: !1,
+  getTheme: !0,
+  resize: !1
+}, l = {
+  callTool: !1,
+  sendMessageToHost: !1,
+  readResource: !1,
+  openLink: !1,
+  accessToolInput: !1,
+  accessToolOutput: !1,
+  accessToolMetadata: !1,
+  getWidgetState: !1,
+  setWidgetState: !1,
+  setWidgetStateModelContext: !1,
+  onToolCanceled: !1,
+  setDisplayMode: !1,
+  getHostContext: !1,
+  subscribe: !1,
+  displayAlert: !1,
+  displayToast: !1,
+  displayModal: !1,
+  getTheme: !1,
+  resize: !1
+};
+function u(t) {
+  switch (t) {
+    case e.MCPApps:
+      return { ...s };
+    case e.OpenAI:
+      return { ...a };
+    case e.SalesforceACC:
+      return { ...o };
+    case e.Mosaic:
+    case e.WebApp:
+    case e.MicroFrontend:
+    default:
+      return { ...l };
+  }
+}
+export {
+  p as McpAppsSession,
+  e as Surface,
+  i as getSurface,
+  u as getSurfaceCapabilities,
+  f as wrapSDKPromise
+};