@agent-native/core 0.114.13 → 0.114.16

package/src/localization/default-messages.ts

@@ -725,9 +725,6 @@ const messages = {
     chatIntegrations: "Chat Integrations",
     chatIntegrationsDescription: "Talk to this agent from other platforms",
     addIntegration: "Add integration",
-    addSomething: "Add something not listed",
-    addSomethingTitle: "Add another integration",
-    addSomethingPlaceholder: "Which integration should we add?",
     dispatchEntrypoint:
       "For a central Slack or Telegram entrypoint that can route work across multiple apps, use the",
     sharedMessaging:
@@ -737,12 +734,9 @@ const messages = {
     menuLabel: "Integrations",
     menuDescription: "Connect MCP tools to the agent",
     title: "Connect integrations",
-    description: "Choose a default MCP integration or add a custom server.",
+    description: "Browse {{count}} MCP integrations or add a custom server.",
     searchPlaceholder: "Search integrations",
     addYourOwn: "Add your own",
-    addSomething: "Add something not listed",
-    addSomethingTitle: "Add another integration",
-    addSomethingPlaceholder: "Which MCP or provider should we add?",
     noMatches: "No integrations match that search.",
     connected: "Connected",
     configure: "Configure",

package/src/server/builder-browser.ts

@@ -8,6 +8,7 @@ import {
 import type { H3Event } from "h3";
 import { getHeader } from "h3";
 
+import { applyBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import {
   getAuthSecret,
   resolveSignupTrackingIdentity,
@@ -920,6 +921,9 @@ export function buildBuilderCliAuthUrl(
   );
   url.searchParams.set("framework", "agent-native");
   applyBuilderConnectTrackingParams(url.searchParams, tracking);
+  applyBuilderUtmTrackingParams(url.searchParams, {
+    content: cleanTrackingParam(tracking.agentNativeConnectSource) ?? null,
+  });
   return url.toString();
 }
 

package/src/server/builder-design-systems.ts

@@ -1,3 +1,4 @@
+import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { FeatureNotConfiguredError } from "./credential-provider.js";
 import {
   getBuilderProxyOrigin,
@@ -356,11 +357,15 @@ function nonEmptyFiles(
 
 export function builderDesignSystemUrl(designSystemId?: string | null): string {
   const host = trimTrailingSlash(getBuilderAppHost());
-  return designSystemId
+  const url = designSystemId
     ? `${host}/app/design-system-intelligence/${encodeURIComponent(
         designSystemId,
       )}`
     : `${host}/app/design-system-intelligence`;
+  return withBuilderUtmTrackingParams(url, {
+    campaign: "product",
+    content: "design_system_intelligence",
+  });
 }
 
 export function localBuilderDesignSystemId(

package/src/server/fusion-app.ts

@@ -24,6 +24,7 @@
  * respond with newline-delimited JSON over chunked HTTP.
  */
 
+import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { getBuilderApiHost, getBuilderAppHost } from "./builder-browser.js";
 
 export interface FusionBranchRef {
@@ -86,7 +87,10 @@ function fusionUrl(
 /** The Builder visual-editor URL for a fusion branch. */
 export function getFusionBranchEditorUrl(ref: FusionBranchRef): string {
   const host = getBuilderAppHost().replace(/\/+$/, "");
-  return `${host}/app/projects/${encodeURIComponent(ref.projectId)}/${encodeURIComponent(ref.branchName)}`;
+  return withBuilderUtmTrackingParams(
+    `${host}/app/projects/${encodeURIComponent(ref.projectId)}/${encodeURIComponent(ref.branchName)}`,
+    { campaign: "product", content: "fusion_editor" },
+  );
 }
 
 /** Public URL for a reserved fusion hosting slug. */

package/src/shared/builder-link-tracking.ts

@@ -0,0 +1,41 @@
+export const BUILDER_UTM_SOURCE = "agent-native";
+export const BUILDER_UTM_MEDIUM = "product";
+export const BUILDER_UTM_CAMPAIGN = "onboarding";
+
+export function applyBuilderUtmTrackingParams(
+  params: URLSearchParams,
+  options: {
+    medium?: string;
+    campaign?: string;
+    content?: string | null;
+  } = {},
+): void {
+  params.set("utm_source", BUILDER_UTM_SOURCE);
+  params.set("utm_medium", options.medium ?? BUILDER_UTM_MEDIUM);
+  params.set("utm_campaign", options.campaign ?? BUILDER_UTM_CAMPAIGN);
+  if (options.content) params.set("utm_content", options.content);
+}
+
+export function withBuilderUtmTrackingParams(
+  url: string,
+  options: {
+    medium?: string;
+    campaign?: string;
+    content?: string | null;
+  } = {},
+): string {
+  let parsed: URL;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return url;
+  }
+  if (
+    parsed.hostname !== "builder.io" &&
+    parsed.hostname !== "www.builder.io"
+  ) {
+    return url;
+  }
+  applyBuilderUtmTrackingParams(parsed.searchParams, options);
+  return parsed.toString();
+}

package/src/shared/index.ts

@@ -7,6 +7,7 @@ export {
 export { agentEnv, type EnvVar } from "./agent-env.js";
 export { extractOAuthStateAppId } from "./oauth-state.js";
 export { truncate } from "./truncate.js";
+export { withBuilderUtmTrackingParams } from "./builder-link-tracking.js";
 export {
   llmConnectionTrackingProperties,
   normalizeLlmConnection,