@openattribution/telemetry 0.1.0

package/dist/index.cjs

@@ -0,0 +1,442 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MCPSessionTracker: () => MCPSessionTracker,
+  TelemetryClient: () => TelemetryClient,
+  extractCitationUrls: () => extractCitationUrls,
+  extractResultUrls: () => extractResultUrls,
+  sessionToAttribution: () => sessionToAttribution,
+  sessionToContentAttribution: () => sessionToContentAttribution
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var TRANSIENT_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+function turnToWire(turn) {
+  return {
+    privacy_level: turn.privacyLevel,
+    query_text: turn.queryText,
+    response_text: turn.responseText,
+    query_intent: turn.queryIntent,
+    response_type: turn.responseType,
+    topics: turn.topics,
+    content_urls_retrieved: turn.contentUrlsRetrieved,
+    content_urls_cited: turn.contentUrlsCited,
+    query_tokens: turn.queryTokens,
+    response_tokens: turn.responseTokens,
+    model_id: turn.modelId
+  };
+}
+function eventToWire(event) {
+  return {
+    id: event.id,
+    type: event.type,
+    timestamp: event.timestamp,
+    content_url: event.contentUrl,
+    product_id: event.productId,
+    turn: event.turn != null ? turnToWire(event.turn) : void 0,
+    data: event.data ?? {}
+  };
+}
+function initiatorToWire(i) {
+  return {
+    agent_id: i.agentId,
+    manifest_ref: i.manifestRef,
+    operator_id: i.operatorId
+  };
+}
+function userContextToWire(uc) {
+  return {
+    external_id: uc.externalId,
+    segments: uc.segments ?? [],
+    attributes: uc.attributes ?? {}
+  };
+}
+function outcomeToWire(o) {
+  return {
+    type: o.type,
+    value_amount: o.valueAmount ?? 0,
+    currency: o.currency ?? "USD",
+    products: o.products ?? [],
+    metadata: o.metadata ?? {}
+  };
+}
+var TelemetryClient = class {
+  constructor(options) {
+    this.endpoint = options.endpoint.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.failSilently = options.failSilently ?? true;
+    this.timeout = options.timeout ?? 3e4;
+    this.maxRetries = options.maxRetries ?? 3;
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.apiKey != null) h["X-API-Key"] = this.apiKey;
+    return h;
+  }
+  async post(path, body) {
+    const url = `${this.endpoint}${path}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeout);
+      try {
+        const res = await fetch(url, {
+          method: "POST",
+          headers: this.headers(),
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+        if (TRANSIENT_STATUS_CODES.has(res.status) && attempt < this.maxRetries) {
+          const wait = 2 ** attempt * 1e3 + Math.random() * 500;
+          await sleep(wait);
+          continue;
+        }
+        if (!res.ok) {
+          throw new Error(`HTTP ${res.status} ${res.statusText} from ${url}`);
+        }
+        return await res.json();
+      } catch (err) {
+        lastError = err;
+        if (attempt < this.maxRetries && isTransientError(err)) {
+          const wait = 2 ** attempt * 1e3 + Math.random() * 500;
+          await sleep(wait);
+        } else {
+          break;
+        }
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+    if (this.failSilently) {
+      return null;
+    }
+    throw lastError;
+  }
+  /**
+   * Start a new telemetry session.
+   *
+   * @returns Session ID string, or null on silent failure.
+   */
+  async startSession(options = {}) {
+    const result = await this.post("/session/start", {
+      initiator_type: options.initiatorType ?? "user",
+      initiator: options.initiator != null ? initiatorToWire(options.initiator) : null,
+      content_scope: options.contentScope,
+      agent_id: options.agentId,
+      external_session_id: options.externalSessionId,
+      user_context: options.userContext != null ? userContextToWire(options.userContext) : {},
+      manifest_ref: options.manifestRef,
+      prior_session_ids: options.priorSessionIds ?? []
+    });
+    return result?.session_id ?? null;
+  }
+  /**
+   * Record a single telemetry event.
+   */
+  async recordEvent(sessionId, eventType, options = {}) {
+    if (sessionId == null) return;
+    await this.recordEvents(sessionId, [
+      {
+        id: crypto.randomUUID(),
+        type: eventType,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...options
+      }
+    ]);
+  }
+  /**
+   * Record a batch of telemetry events.
+   */
+  async recordEvents(sessionId, events) {
+    if (sessionId == null || events.length === 0) return;
+    await this.post("/events", {
+      session_id: sessionId,
+      events: events.map(eventToWire)
+    });
+  }
+  /**
+   * End a session with an outcome.
+   */
+  async endSession(sessionId, outcome) {
+    if (sessionId == null) return;
+    await this.post("/session/end", {
+      session_id: sessionId,
+      outcome: outcomeToWire(outcome)
+    });
+  }
+  /**
+   * Upload a complete session in one request (bulk path).
+   *
+   * Useful for post-hoc reporting or when you've built the session
+   * locally and want to submit it in one shot.
+   *
+   * @returns Server-assigned session ID, or null on silent failure.
+   */
+  async uploadSession(session) {
+    const result = await this.post("/session/bulk", sessionToWire(session));
+    return result?.session_id ?? null;
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isTransientError(err) {
+  if (err instanceof Error) {
+    return err.name === "AbortError" || err.name === "TypeError" || err.message.includes("fetch");
+  }
+  return false;
+}
+function sessionToWire(session) {
+  return {
+    schema_version: session.schemaVersion ?? "0.4",
+    session_id: session.sessionId,
+    initiator_type: session.initiatorType ?? "user",
+    initiator: session.initiator != null ? initiatorToWire(session.initiator) : null,
+    agent_id: session.agentId,
+    content_scope: session.contentScope,
+    manifest_ref: session.manifestRef,
+    prior_session_ids: session.priorSessionIds ?? [],
+    started_at: session.startedAt,
+    ended_at: session.endedAt,
+    user_context: session.userContext != null ? userContextToWire(session.userContext) : {},
+    events: session.events.map(eventToWire),
+    outcome: session.outcome != null ? outcomeToWire(session.outcome) : void 0
+  };
+}
+
+// src/mcp.ts
+var MCPSessionTracker = class {
+  /**
+   * @param client - Configured TelemetryClient instance.
+   * @param contentScope - Stable identifier for this agent's content scope
+   *   (e.g. mix ID, manifest reference, or descriptive slug like "my-shopping-agent").
+   */
+  constructor(client, contentScope = "mcp-agent") {
+    this.registry = /* @__PURE__ */ new Map();
+    this.client = client;
+    this.contentScope = contentScope;
+  }
+  /**
+   * Get or create an OA session for the given external session ID.
+   *
+   * If `externalSessionId` is undefined, a new anonymous session is created
+   * on every call (no continuity across tool calls).
+   *
+   * @returns OA session ID string, or null on silent failure.
+   */
+  async getOrCreateSession(externalSessionId) {
+    if (externalSessionId != null && this.registry.has(externalSessionId)) {
+      return this.registry.get(externalSessionId) ?? null;
+    }
+    const sessionId = await this.client.startSession({
+      contentScope: this.contentScope,
+      ...externalSessionId != null && { externalSessionId }
+    });
+    if (externalSessionId != null) {
+      this.registry.set(externalSessionId, sessionId);
+    }
+    return sessionId;
+  }
+  /**
+   * Emit `content_retrieved` events for a list of URLs.
+   *
+   * Call this after fetching products, search results, or any content
+   * that influenced the agent's response.
+   *
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param urls - URLs of content retrieved during this tool call.
+   */
+  async trackRetrieved(externalSessionId, urls) {
+    if (urls.length === 0) return;
+    const sessionId = await this.getOrCreateSession(externalSessionId);
+    if (sessionId == null) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const events = urls.map((url) => ({
+      id: crypto.randomUUID(),
+      type: "content_retrieved",
+      timestamp: now,
+      contentUrl: url
+    }));
+    await this.client.recordEvents(sessionId, events);
+  }
+  /**
+   * Emit `content_cited` events for content explicitly referenced in a response.
+   *
+   * Call this when you know which content the agent cited — e.g. the top
+   * search result, an editorial quote, or a product recommendation.
+   *
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param urls - URLs of content cited in the agent's response.
+   * @param options - Optional citation metadata.
+   */
+  async trackCited(externalSessionId, urls, options = {}) {
+    if (urls.length === 0) return;
+    const sessionId = await this.getOrCreateSession(externalSessionId);
+    if (sessionId == null) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const events = urls.map((url) => ({
+      id: crypto.randomUUID(),
+      type: "content_cited",
+      timestamp: now,
+      contentUrl: url,
+      data: {
+        ...options.citationType != null && { citation_type: options.citationType },
+        ...options.position != null && { position: options.position }
+      }
+    }));
+    await this.client.recordEvents(sessionId, events);
+  }
+  /**
+   * End a session with an outcome.
+   *
+   * Call this when the conversation concludes — at checkout, after
+   * the user clicks a link, or when the session times out.
+   */
+  async endSession(externalSessionId, outcome) {
+    const sessionId = externalSessionId != null ? this.registry.get(externalSessionId) ?? null : null;
+    if (sessionId == null) return;
+    await this.client.endSession(sessionId, {
+      type: outcome.type,
+      ...outcome.valueAmount != null && { valueAmount: outcome.valueAmount },
+      ...outcome.currency != null && { currency: outcome.currency }
+    });
+    this.registry.delete(externalSessionId);
+  }
+  /** Number of active sessions in the registry. */
+  get sessionCount() {
+    return this.registry.size;
+  }
+};
+
+// src/extract.ts
+var MARKDOWN_LINK_RE = /\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g;
+var BARE_URL_RE = /https?:\/\/[^\s<>"')\]]+/g;
+function extractCitationUrls(text) {
+  const urls = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(MARKDOWN_LINK_RE)) {
+    const url = match[2];
+    if (url != null) urls.add(cleanUrl(url));
+  }
+  for (const match of text.matchAll(BARE_URL_RE)) {
+    urls.add(cleanUrl(match[0]));
+  }
+  return [...urls];
+}
+function extractResultUrls(results) {
+  const urls = [];
+  for (const r of results) {
+    const url = r.url ?? r.link;
+    if (url != null && url.startsWith("http")) {
+      urls.push(url);
+    }
+  }
+  return [...new Set(urls)];
+}
+function cleanUrl(url) {
+  return url.replace(/[.,;:!?]+$/, "");
+}
+
+// src/acp.ts
+function sessionToContentAttribution(session) {
+  const retrieved = session.events.filter((e) => e.type === "content_retrieved" && e.contentUrl != null).map((e) => ({
+    content_url: e.contentUrl,
+    timestamp: e.timestamp
+  }));
+  const cited = session.events.filter((e) => e.type === "content_cited" && e.contentUrl != null).map((e) => ({
+    content_url: e.contentUrl,
+    timestamp: e.timestamp,
+    ...e.data?.["citation_type"] != null && {
+      citation_type: String(e.data["citation_type"])
+    },
+    ...e.data?.["excerpt_tokens"] != null && {
+      excerpt_tokens: Number(e.data["excerpt_tokens"])
+    },
+    ...e.data?.["position"] != null && {
+      position: String(e.data["position"])
+    },
+    ...e.data?.["content_hash"] != null && {
+      content_hash: String(e.data["content_hash"])
+    }
+  }));
+  const turnEvents = session.events.filter(
+    (e) => e.type === "turn_completed" || e.type === "turn_started"
+  );
+  const turnCount = Math.max(
+    session.events.filter((e) => e.type === "turn_completed").length,
+    1
+  );
+  const topics = [
+    ...new Set(
+      session.events.flatMap((e) => e.turn?.topics ?? [])
+    )
+  ];
+  const result = {
+    ...session.contentScope != null && { content_scope: session.contentScope },
+    content_retrieved: retrieved,
+    ...cited.length > 0 && { content_cited: cited },
+    ...(turnEvents.length > 0 || topics.length > 0) && {
+      conversation_summary: { turn_count: turnCount, topics }
+    }
+  };
+  return result;
+}
+
+// src/ucp.ts
+function sessionToAttribution(session) {
+  const retrieved = session.events.filter((e) => e.type === "content_retrieved" && e.contentUrl != null).map((e) => ({ content_url: e.contentUrl, timestamp: e.timestamp }));
+  const cited = session.events.filter((e) => e.type === "content_cited" && e.contentUrl != null).map((e) => ({
+    content_url: e.contentUrl,
+    timestamp: e.timestamp,
+    ...e.data?.["citation_type"] != null && {
+      citation_type: String(e.data["citation_type"])
+    },
+    ...e.data?.["position"] != null && {
+      position: String(e.data["position"])
+    }
+  }));
+  const turnCount = Math.max(
+    session.events.filter((e) => e.type === "turn_completed").length,
+    1
+  );
+  const topics = [...new Set(session.events.flatMap((e) => e.turn?.topics ?? []))];
+  const priorIds = (session.priorSessionIds ?? []).filter(Boolean);
+  return {
+    ...session.contentScope != null && { content_scope: session.contentScope },
+    ...priorIds.length > 0 && { prior_session_ids: priorIds },
+    content_retrieved: retrieved,
+    ...cited.length > 0 && { content_cited: cited },
+    ...(topics.length > 0 || turnCount > 0) && {
+      conversation_summary: { turn_count: turnCount, topics }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MCPSessionTracker,
+  TelemetryClient,
+  extractCitationUrls,
+  extractResultUrls,
+  sessionToAttribution,
+  sessionToContentAttribution
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/mcp.ts","../src/extract.ts","../src/acp.ts","../src/ucp.ts"],"sourcesContent":["/**\n * @openattribution/telemetry\n *\n * OpenAttribution Telemetry SDK for TypeScript/JavaScript.\n * Track content attribution in AI agent interactions.\n *\n * Specification: https://openattribution.org/telemetry\n *\n * @example\n * ```ts\n * import { TelemetryClient, MCPSessionTracker, extractCitationUrls } from \"@openattribution/telemetry\";\n *\n * // Direct client usage\n * const client = new TelemetryClient({\n *   endpoint: \"https://telemetry.example.com\",\n *   apiKey: process.env.TELEMETRY_API_KEY,\n *   failSilently: true,\n * });\n *\n * // MCP agent usage\n * const tracker = new MCPSessionTracker(client, \"my-shopping-agent\");\n * await tracker.trackRetrieved(sessionId, productUrls);\n *\n * // Extract citation URLs from AI response text\n * const urls = extractCitationUrls(assistantMessage);\n * await tracker.trackCited(sessionId, urls);\n * ```\n */\n\nexport { TelemetryClient } from \"./client.js\";\nexport { MCPSessionTracker } from \"./mcp.js\";\nexport { extractCitationUrls, extractResultUrls } from \"./extract.js\";\nexport { sessionToContentAttribution } from \"./acp.js\";\nexport { sessionToAttribution } from \"./ucp.js\";\n\nexport type {\n  // Types\n  TelemetryClientOptions,\n  TelemetrySession,\n  TelemetryEvent,\n  SessionOutcome,\n  StartSessionOptions,\n  ConversationTurn,\n  UserContext,\n  Initiator,\n  // Enumerations\n  EventType,\n  OutcomeType,\n  PrivacyLevel,\n  IntentCategory,\n  InitiatorType,\n  CitationType,\n  CitationPosition,\n} from \"./types.js\";\n\nexport type { ContentAttribution, ContentAttributionRetrieved, ContentAttributionCited } from \"./acp.js\";\nexport type { UCPAttribution } from \"./ucp.js\";\n","/**\n * OpenAttribution Telemetry — HTTP client.\n *\n * Zero dependencies — uses native fetch (Node 18+, Deno, browsers, Edge).\n */\n\nimport type {\n  ConversationTurn,\n  EventType,\n  Initiator,\n  SessionOutcome,\n  StartSessionOptions,\n  TelemetryClientOptions,\n  TelemetryEvent,\n  TelemetrySession,\n  UserContext,\n} from \"./types.js\";\n\nconst TRANSIENT_STATUS_CODES = new Set([429, 500, 502, 503, 504]);\n\n// ---------------------------------------------------------------------------\n// Wire format helpers (camelCase → snake_case for the JSON body)\n// ---------------------------------------------------------------------------\n\nfunction turnToWire(turn: ConversationTurn): Record<string, unknown> {\n  return {\n    privacy_level: turn.privacyLevel,\n    query_text: turn.queryText,\n    response_text: turn.responseText,\n    query_intent: turn.queryIntent,\n    response_type: turn.responseType,\n    topics: turn.topics,\n    content_urls_retrieved: turn.contentUrlsRetrieved,\n    content_urls_cited: turn.contentUrlsCited,\n    query_tokens: turn.queryTokens,\n    response_tokens: turn.responseTokens,\n    model_id: turn.modelId,\n  };\n}\n\nfunction eventToWire(event: TelemetryEvent): Record<string, unknown> {\n  return {\n    id: event.id,\n    type: event.type,\n    timestamp: event.timestamp,\n    content_url: event.contentUrl,\n    product_id: event.productId,\n    turn: event.turn != null ? turnToWire(event.turn) : undefined,\n    data: event.data ?? {},\n  };\n}\n\nfunction initiatorToWire(i: Initiator): Record<string, unknown> {\n  return {\n    agent_id: i.agentId,\n    manifest_ref: i.manifestRef,\n    operator_id: i.operatorId,\n  };\n}\n\nfunction userContextToWire(uc: UserContext): Record<string, unknown> {\n  return {\n    external_id: uc.externalId,\n    segments: uc.segments ?? [],\n    attributes: uc.attributes ?? {},\n  };\n}\n\nfunction outcomeToWire(o: SessionOutcome): Record<string, unknown> {\n  return {\n    type: o.type,\n    value_amount: o.valueAmount ?? 0,\n    currency: o.currency ?? \"USD\",\n    products: o.products ?? [],\n    metadata: o.metadata ?? {},\n  };\n}\n\n// ---------------------------------------------------------------------------\n// TelemetryClient\n// ---------------------------------------------------------------------------\n\n/**\n * Async client for recording OpenAttribution telemetry.\n *\n * Works in Node.js ≥ 18, Deno, browsers, and Edge runtimes (Vercel, Cloudflare).\n *\n * @example\n * ```ts\n * const client = new TelemetryClient({\n *   endpoint: \"https://telemetry.example.com\",\n *   apiKey: \"your-api-key\",\n *   failSilently: true,\n * });\n *\n * const sessionId = await client.startSession({ contentScope: \"my-mix\" });\n *\n * await client.recordEvents(sessionId, [\n *   { id: crypto.randomUUID(), type: \"content_retrieved\",\n *     timestamp: new Date().toISOString(), contentUrl: \"https://...\" }\n * ]);\n *\n * await client.endSession(sessionId, { type: \"browse\" });\n * ```\n */\nexport class TelemetryClient {\n  private readonly endpoint: string;\n  private readonly apiKey: string | undefined;\n  private readonly failSilently: boolean;\n  private readonly timeout: number;\n  private readonly maxRetries: number;\n\n  constructor(options: TelemetryClientOptions) {\n    this.endpoint = options.endpoint.replace(/\\/$/, \"\");\n    this.apiKey = options.apiKey;\n    this.failSilently = options.failSilently ?? true;\n    this.timeout = options.timeout ?? 30_000;\n    this.maxRetries = options.maxRetries ?? 3;\n  }\n\n  private headers(): Record<string, string> {\n    const h: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (this.apiKey != null) h[\"X-API-Key\"] = this.apiKey;\n    return h;\n  }\n\n  private async post(path: string, body: unknown): Promise<unknown> {\n    const url = `${this.endpoint}${path}`;\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const res = await fetch(url, {\n          method: \"POST\",\n          headers: this.headers(),\n          body: JSON.stringify(body),\n          signal: controller.signal,\n        });\n\n        if (TRANSIENT_STATUS_CODES.has(res.status) && attempt < this.maxRetries) {\n          const wait = 2 ** attempt * 1000 + Math.random() * 500;\n          await sleep(wait);\n          continue;\n        }\n\n        if (!res.ok) {\n          throw new Error(`HTTP ${res.status} ${res.statusText} from ${url}`);\n        }\n\n        return await res.json();\n      } catch (err) {\n        lastError = err;\n        if (attempt < this.maxRetries && isTransientError(err)) {\n          const wait = 2 ** attempt * 1000 + Math.random() * 500;\n          await sleep(wait);\n        } else {\n          break;\n        }\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    if (this.failSilently) {\n      return null;\n    }\n    throw lastError;\n  }\n\n  /**\n   * Start a new telemetry session.\n   *\n   * @returns Session ID string, or null on silent failure.\n   */\n  async startSession(options: StartSessionOptions = {}): Promise<string | null> {\n    const result = await this.post(\"/session/start\", {\n      initiator_type: options.initiatorType ?? \"user\",\n      initiator:\n        options.initiator != null ? initiatorToWire(options.initiator) : null,\n      content_scope: options.contentScope,\n      agent_id: options.agentId,\n      external_session_id: options.externalSessionId,\n      user_context:\n        options.userContext != null\n          ? userContextToWire(options.userContext)\n          : {},\n      manifest_ref: options.manifestRef,\n      prior_session_ids: options.priorSessionIds ?? [],\n    }) as { session_id?: string } | null;\n\n    return result?.session_id ?? null;\n  }\n\n  /**\n   * Record a single telemetry event.\n   */\n  async recordEvent(\n    sessionId: string | null,\n    eventType: EventType,\n    options: {\n      contentUrl?: string;\n      productId?: string;\n      turn?: ConversationTurn;\n      data?: Record<string, unknown>;\n    } = {},\n  ): Promise<void> {\n    if (sessionId == null) return;\n    await this.recordEvents(sessionId, [\n      {\n        id: crypto.randomUUID(),\n        type: eventType,\n        timestamp: new Date().toISOString(),\n        ...options,\n      },\n    ]);\n  }\n\n  /**\n   * Record a batch of telemetry events.\n   */\n  async recordEvents(\n    sessionId: string | null,\n    events: TelemetryEvent[],\n  ): Promise<void> {\n    if (sessionId == null || events.length === 0) return;\n    await this.post(\"/events\", {\n      session_id: sessionId,\n      events: events.map(eventToWire),\n    });\n  }\n\n  /**\n   * End a session with an outcome.\n   */\n  async endSession(\n    sessionId: string | null,\n    outcome: SessionOutcome,\n  ): Promise<void> {\n    if (sessionId == null) return;\n    await this.post(\"/session/end\", {\n      session_id: sessionId,\n      outcome: outcomeToWire(outcome),\n    });\n  }\n\n  /**\n   * Upload a complete session in one request (bulk path).\n   *\n   * Useful for post-hoc reporting or when you've built the session\n   * locally and want to submit it in one shot.\n   *\n   * @returns Server-assigned session ID, or null on silent failure.\n   */\n  async uploadSession(session: TelemetrySession): Promise<string | null> {\n    const result = await this.post(\"/session/bulk\", sessionToWire(session)) as\n      | { session_id?: string }\n      | null;\n    return result?.session_id ?? null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction isTransientError(err: unknown): boolean {\n  if (err instanceof Error) {\n    // AbortError (timeout), network errors\n    return (\n      err.name === \"AbortError\" ||\n      err.name === \"TypeError\" ||\n      err.message.includes(\"fetch\")\n    );\n  }\n  return false;\n}\n\nfunction sessionToWire(session: TelemetrySession): Record<string, unknown> {\n  return {\n    schema_version: session.schemaVersion ?? \"0.4\",\n    session_id: session.sessionId,\n    initiator_type: session.initiatorType ?? \"user\",\n    initiator:\n      session.initiator != null ? initiatorToWire(session.initiator) : null,\n    agent_id: session.agentId,\n    content_scope: session.contentScope,\n    manifest_ref: session.manifestRef,\n    prior_session_ids: session.priorSessionIds ?? [],\n    started_at: session.startedAt,\n    ended_at: session.endedAt,\n    user_context:\n      session.userContext != null\n        ? userContextToWire(session.userContext)\n        : {},\n    events: session.events.map(eventToWire),\n    outcome:\n      session.outcome != null ? outcomeToWire(session.outcome) : undefined,\n  };\n}\n","/**\n * OpenAttribution Telemetry — MCP session tracker.\n *\n * Provides session continuity across stateless MCP tool calls.\n * The calling agent passes a stable `sessionId` string; this module\n * maps it to an OA session UUID and reuses it across tool calls within\n * the same server process.\n *\n * Usage in an MCP tool:\n *\n * ```ts\n * import { TelemetryClient, MCPSessionTracker } from \"@openattribution/telemetry\";\n *\n * const client = new TelemetryClient({ endpoint: \"...\", apiKey: \"...\" });\n * const tracker = new MCPSessionTracker(client, \"my-agent\");\n *\n * // In your MCP tool handler:\n * server.tool(\"search_products\", { query: z.string(), sessionId: z.string().optional() },\n *   async ({ query, sessionId }) => {\n *     const results = await searchProducts(query);\n *     await tracker.trackRetrieved(sessionId, results.map(r => r.url));\n *     return formatResults(results);\n *   }\n * );\n * ```\n */\n\nimport type { TelemetryEvent } from \"./types.js\";\nimport type { TelemetryClient } from \"./client.js\";\n\n/**\n * Session tracker for MCP agents.\n *\n * Maintains an in-process mapping of external session IDs to OA session UUIDs.\n * Sessions are created on first use and reused across subsequent tool calls.\n *\n * The in-process registry is intentionally simple — it works correctly for\n * single-process MCP servers. For distributed deployments, pass a shared\n * external store to the constructor.\n */\nexport class MCPSessionTracker {\n  private readonly client: TelemetryClient;\n  private readonly contentScope: string;\n  private readonly registry = new Map<string, string | null>();\n\n  /**\n   * @param client - Configured TelemetryClient instance.\n   * @param contentScope - Stable identifier for this agent's content scope\n   *   (e.g. mix ID, manifest reference, or descriptive slug like \"my-shopping-agent\").\n   */\n  constructor(client: TelemetryClient, contentScope = \"mcp-agent\") {\n    this.client = client;\n    this.contentScope = contentScope;\n  }\n\n  /**\n   * Get or create an OA session for the given external session ID.\n   *\n   * If `externalSessionId` is undefined, a new anonymous session is created\n   * on every call (no continuity across tool calls).\n   *\n   * @returns OA session ID string, or null on silent failure.\n   */\n  async getOrCreateSession(\n    externalSessionId: string | undefined,\n  ): Promise<string | null> {\n    if (externalSessionId != null && this.registry.has(externalSessionId)) {\n      return this.registry.get(externalSessionId) ?? null;\n    }\n\n    const sessionId = await this.client.startSession({\n      contentScope: this.contentScope,\n      ...(externalSessionId != null && { externalSessionId }),\n    });\n\n    if (externalSessionId != null) {\n      this.registry.set(externalSessionId, sessionId);\n    }\n\n    return sessionId;\n  }\n\n  /**\n   * Emit `content_retrieved` events for a list of URLs.\n   *\n   * Call this after fetching products, search results, or any content\n   * that influenced the agent's response.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param urls - URLs of content retrieved during this tool call.\n   */\n  async trackRetrieved(\n    externalSessionId: string | undefined,\n    urls: string[],\n  ): Promise<void> {\n    if (urls.length === 0) return;\n    const sessionId = await this.getOrCreateSession(externalSessionId);\n    if (sessionId == null) return;\n\n    const now = new Date().toISOString();\n    const events: TelemetryEvent[] = urls.map((url) => ({\n      id: crypto.randomUUID(),\n      type: \"content_retrieved\" as const,\n      timestamp: now,\n      contentUrl: url,\n    }));\n\n    await this.client.recordEvents(sessionId, events);\n  }\n\n  /**\n   * Emit `content_cited` events for content explicitly referenced in a response.\n   *\n   * Call this when you know which content the agent cited — e.g. the top\n   * search result, an editorial quote, or a product recommendation.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param urls - URLs of content cited in the agent's response.\n   * @param options - Optional citation metadata.\n   */\n  async trackCited(\n    externalSessionId: string | undefined,\n    urls: string[],\n    options: {\n      citationType?: \"direct_quote\" | \"paraphrase\" | \"reference\" | \"contradiction\";\n      position?: \"primary\" | \"supporting\" | \"mentioned\";\n    } = {},\n  ): Promise<void> {\n    if (urls.length === 0) return;\n    const sessionId = await this.getOrCreateSession(externalSessionId);\n    if (sessionId == null) return;\n\n    const now = new Date().toISOString();\n    const events: TelemetryEvent[] = urls.map((url) => ({\n      id: crypto.randomUUID(),\n      type: \"content_cited\" as const,\n      timestamp: now,\n      contentUrl: url,\n      data: {\n        ...(options.citationType != null && { citation_type: options.citationType }),\n        ...(options.position != null && { position: options.position }),\n      },\n    }));\n\n    await this.client.recordEvents(sessionId, events);\n  }\n\n  /**\n   * End a session with an outcome.\n   *\n   * Call this when the conversation concludes — at checkout, after\n   * the user clicks a link, or when the session times out.\n   */\n  async endSession(\n    externalSessionId: string | undefined,\n    outcome: { type: \"conversion\" | \"abandonment\" | \"browse\"; valueAmount?: number; currency?: string },\n  ): Promise<void> {\n    const sessionId = externalSessionId != null\n      ? (this.registry.get(externalSessionId) ?? null)\n      : null;\n\n    if (sessionId == null) return;\n\n    await this.client.endSession(sessionId, {\n      type: outcome.type,\n      ...(outcome.valueAmount != null && { valueAmount: outcome.valueAmount }),\n      ...(outcome.currency != null && { currency: outcome.currency }),\n    });\n\n    this.registry.delete(externalSessionId!);\n  }\n\n  /** Number of active sessions in the registry. */\n  get sessionCount(): number {\n    return this.registry.size;\n  }\n}\n","/**\n * OpenAttribution Telemetry — content URL extraction utilities.\n *\n * Helpers for extracting content URLs from AI-generated text, so they\n * can be recorded as telemetry events without manual instrumentation.\n */\n\n/** Matches `[text](url)` — standard Markdown links. */\nconst MARKDOWN_LINK_RE = /\\[([^\\]]+)\\]\\((https?:\\/\\/[^)]+)\\)/g;\n\n/** Matches bare URLs starting with http/https. */\nconst BARE_URL_RE = /https?:\\/\\/[^\\s<>\"')\\]]+/g;\n\n/**\n * Extract all HTTP/HTTPS URLs from Markdown-formatted text.\n *\n * Finds URLs in two forms:\n * - Markdown links: `[anchor text](https://...)`\n * - Bare URLs: `https://...`\n *\n * Results are deduplicated. Useful for extracting citation URLs from\n * AI model responses that include web search results.\n *\n * @example\n * ```ts\n * const text = \"According to [Wirecutter](https://nytimes.com/wirecutter/reviews/...), ...\";\n * const urls = extractCitationUrls(text);\n * // [\"https://nytimes.com/wirecutter/reviews/...\"]\n * ```\n */\nexport function extractCitationUrls(text: string): string[] {\n  const urls = new Set<string>();\n\n  for (const match of text.matchAll(MARKDOWN_LINK_RE)) {\n    const url = match[2];\n    if (url != null) urls.add(cleanUrl(url));\n  }\n\n  // Only look for bare URLs if Markdown links didn't cover everything\n  for (const match of text.matchAll(BARE_URL_RE)) {\n    urls.add(cleanUrl(match[0]));\n  }\n\n  return [...urls];\n}\n\n/**\n * Extract URLs from a list of search result objects.\n *\n * Accepts any object with a `url` string property — works with\n * Channel3, Exa, Tavily, and most search API responses.\n *\n * @example\n * ```ts\n * const products = await channel3.search({ query: \"headphones\" });\n * const urls = extractResultUrls(products);\n * await tracker.trackRetrieved(sessionId, urls);\n * ```\n */\nexport function extractResultUrls(\n  results: Array<{ url?: string | null; link?: string | null }>,\n): string[] {\n  const urls: string[] = [];\n  for (const r of results) {\n    const url = r.url ?? r.link;\n    if (url != null && url.startsWith(\"http\")) {\n      urls.push(url);\n    }\n  }\n  return [...new Set(urls)];\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Remove trailing punctuation that commonly attaches to bare URLs. */\nfunction cleanUrl(url: string): string {\n  return url.replace(/[.,;:!?]+$/, \"\");\n}\n","/**\n * OpenAttribution Telemetry — ACP (Agentic Commerce Protocol) bridge.\n *\n * Converts a TelemetrySession into the `content_attribution` object\n * defined in the ACP RFC. Include this in a CheckoutSessionCreateRequest\n * or CheckoutSessionCompleteRequest.\n *\n * Reference: acp/rfc.content_attribution.md\n */\n\nimport type { TelemetrySession } from \"./types.js\";\n\nexport interface ContentAttributionRetrieved {\n  content_url: string;\n  timestamp: string;\n}\n\nexport interface ContentAttributionCited {\n  content_url: string;\n  timestamp: string;\n  citation_type?: string;\n  excerpt_tokens?: number;\n  position?: string;\n  content_hash?: string;\n}\n\nexport interface ConversationSummary {\n  turn_count: number;\n  topics: string[];\n}\n\n/**\n * ACP `content_attribution` object.\n * Include in CheckoutSessionCreateRequest.content_attribution.\n */\nexport interface ContentAttribution {\n  content_scope?: string;\n  content_retrieved: ContentAttributionRetrieved[];\n  content_cited?: ContentAttributionCited[];\n  conversation_summary?: ConversationSummary;\n}\n\n/**\n * Convert a TelemetrySession into an ACP `content_attribution` object.\n *\n * @example\n * ```ts\n * import { sessionToContentAttribution } from \"@openattribution/telemetry/acp\";\n *\n * const attribution = sessionToContentAttribution(session);\n *\n * // Include in ACP checkout request:\n * await acp.createCheckout({\n *   cart: { ... },\n *   content_attribution: attribution,\n * });\n * ```\n */\nexport function sessionToContentAttribution(\n  session: TelemetrySession,\n): ContentAttribution {\n  const retrieved: ContentAttributionRetrieved[] = session.events\n    .filter((e) => e.type === \"content_retrieved\" && e.contentUrl != null)\n    .map((e) => ({\n      content_url: e.contentUrl!,\n      timestamp: e.timestamp,\n    }));\n\n  const cited: ContentAttributionCited[] = session.events\n    .filter((e) => e.type === \"content_cited\" && e.contentUrl != null)\n    .map((e) => ({\n      content_url: e.contentUrl!,\n      timestamp: e.timestamp,\n      ...(e.data?.[\"citation_type\"] != null && {\n        citation_type: String(e.data[\"citation_type\"]),\n      }),\n      ...(e.data?.[\"excerpt_tokens\"] != null && {\n        excerpt_tokens: Number(e.data[\"excerpt_tokens\"]),\n      }),\n      ...(e.data?.[\"position\"] != null && {\n        position: String(e.data[\"position\"]),\n      }),\n      ...(e.data?.[\"content_hash\"] != null && {\n        content_hash: String(e.data[\"content_hash\"]),\n      }),\n    }));\n\n  const turnEvents = session.events.filter(\n    (e) => e.type === \"turn_completed\" || e.type === \"turn_started\",\n  );\n  const turnCount = Math.max(\n    session.events.filter((e) => e.type === \"turn_completed\").length,\n    1,\n  );\n\n  const topics = [\n    ...new Set(\n      session.events.flatMap((e) => e.turn?.topics ?? []),\n    ),\n  ];\n\n  const result: ContentAttribution = {\n    ...(session.contentScope != null && { content_scope: session.contentScope }),\n    content_retrieved: retrieved,\n    ...(cited.length > 0 && { content_cited: cited }),\n    ...((turnEvents.length > 0 || topics.length > 0) && {\n      conversation_summary: { turn_count: turnCount, topics },\n    }),\n  };\n\n  return result;\n}\n","/**\n * OpenAttribution Telemetry — UCP (Universal Checkout Protocol) bridge.\n *\n * Converts a TelemetrySession into the UCP attribution extension object.\n *\n * Reference: ucp/EXTENSION.md\n */\n\nimport type { TelemetrySession } from \"./types.js\";\n\nexport interface UCPAttribution {\n  content_scope?: string;\n  prior_session_ids?: string[];\n  content_retrieved: Array<{ content_url: string; timestamp: string }>;\n  content_cited?: Array<{\n    content_url: string;\n    timestamp: string;\n    citation_type?: string;\n    position?: string;\n  }>;\n  conversation_summary?: {\n    turn_count: number;\n    topics: string[];\n  };\n}\n\n/**\n * Convert a TelemetrySession into a UCP attribution extension object.\n *\n * @example\n * ```ts\n * import { sessionToAttribution } from \"@openattribution/telemetry/ucp\";\n *\n * const attribution = sessionToAttribution(session);\n *\n * // Include in UCP checkout:\n * await ucp.completeCheckout({\n *   order: { ... },\n *   extensions: { \"org.openattribution.telemetry\": attribution },\n * });\n * ```\n */\nexport function sessionToAttribution(session: TelemetrySession): UCPAttribution {\n  const retrieved = session.events\n    .filter((e) => e.type === \"content_retrieved\" && e.contentUrl != null)\n    .map((e) => ({ content_url: e.contentUrl!, timestamp: e.timestamp }));\n\n  const cited = session.events\n    .filter((e) => e.type === \"content_cited\" && e.contentUrl != null)\n    .map((e) => ({\n      content_url: e.contentUrl!,\n      timestamp: e.timestamp,\n      ...(e.data?.[\"citation_type\"] != null && {\n        citation_type: String(e.data[\"citation_type\"]),\n      }),\n      ...(e.data?.[\"position\"] != null && {\n        position: String(e.data[\"position\"]),\n      }),\n    }));\n\n  const turnCount = Math.max(\n    session.events.filter((e) => e.type === \"turn_completed\").length,\n    1,\n  );\n  const topics = [...new Set(session.events.flatMap((e) => e.turn?.topics ?? []))];\n  const priorIds = (session.priorSessionIds ?? []).filter(Boolean);\n\n  return {\n    ...(session.contentScope != null && { content_scope: session.contentScope }),\n    ...(priorIds.length > 0 && { prior_session_ids: priorIds }),\n    content_retrieved: retrieved,\n    ...(cited.length > 0 && { content_cited: cited }),\n    ...((topics.length > 0 || turnCount > 0) && {\n      conversation_summary: { turn_count: turnCount, topics },\n    }),\n  };\n}\n"],"mappings":"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","names":[]}