@openattribution/telemetry 0.1.0 → 0.1.1

package/README.md

@@ -166,6 +166,49 @@ await ucpClient.completeCheckout({
 });
 ```
 
+## Tracking the full funnel
+
+The four tracker methods cover the complete content attribution chain:
+
+```ts
+// 1. Content fetched — what the agent retrieved to answer the query
+await tracker.trackRetrieved(sessionId, productUrls);
+
+// 2. Content cited — what the agent explicitly recommended
+await tracker.trackCited(sessionId, citedUrls, { citationType: "reference" });
+
+// 3. Content engaged — what the user clicked or viewed
+await tracker.trackEngaged(sessionId, [clickedUrl], { interactionType: "click" });
+
+// 4. Checkout — purchase completed (ends the session)
+await tracker.trackCheckout(sessionId, { type: "completed", valueAmount: 4999, currency: "USD" });
+```
+
+### Click tracking with a redirect endpoint
+
+The most reliable way to track clicks is a server-side redirect. Use `createTrackingUrl` to build proxied links, then implement a lightweight redirect handler:
+
+```ts
+import { createTrackingUrl, MCPSessionTracker } from "@openattribution/telemetry";
+
+// Build tracked links for your products
+const trackedUrl = createTrackingUrl("https://shop.example.com/product/123", {
+  endpoint: "https://myagent.com/api/track",
+  sessionId: "conv-abc123",
+});
+// → "https://myagent.com/api/track?url=https%3A%2F%2F...&session_id=conv-abc123"
+
+// Next.js redirect handler (app/api/track/route.ts)
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const url = searchParams.get("url");
+  const sessionId = searchParams.get("session_id") ?? undefined;
+  if (!url) return new Response("Missing url", { status: 400 });
+  void tracker.trackEngaged(sessionId, [url], { interactionType: "click" });
+  return Response.redirect(url, 302);
+}
+```
+
 ## API reference
 
 ### `TelemetryClient`
@@ -184,9 +227,15 @@ await ucpClient.completeCheckout({
 |--------|-------------|
 | `trackRetrieved(externalId, urls[])` | Emit `content_retrieved` events. Creates session if needed. |
 | `trackCited(externalId, urls[], options?)` | Emit `content_cited` events. |
-| `endSession(externalId, outcome)` | End the session and remove from registry. |
+| `trackEngaged(externalId, urls[], options?)` | Emit `content_engaged` events (clicks, views). |
+| `trackCheckout(externalId, outcome)` | Emit checkout event and end session. |
+| `endSession(externalId, outcome)` | End session with explicit outcome. |
 | `getOrCreateSession(externalId)` | Get or create an OA session ID. |
 
+### `createTrackingUrl(contentUrl, options)`
+
+Build a server-side redirect URL for reliable click tracking. Pass to your product links instead of the raw destination URL. See the redirect endpoint example above.
+
 ### `extractCitationUrls(text)`
 
 Extract HTTP/HTTPS URLs from Markdown-formatted text. Finds both `[anchor](url)` links and bare URLs. Returns deduplicated array.

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   MCPSessionTracker: () => MCPSessionTracker,
   TelemetryClient: () => TelemetryClient,
+  createTrackingUrl: () => createTrackingUrl,
   extractCitationUrls: () => extractCitationUrls,
   extractResultUrls: () => extractResultUrls,
   sessionToAttribution: () => sessionToAttribution,
@@ -307,10 +308,89 @@ var MCPSessionTracker = class {
     await this.client.recordEvents(sessionId, events);
   }
   /**
-   * End a session with an outcome.
+   * Emit `content_engaged` events when a user interacts with content.
+   *
+   * Call this when a user clicks a link, views an embedded product, or
+   * otherwise actively engages with retrieved content. This is the
+   * strongest attribution signal before a purchase event.
    *
-   * Call this when the conversation concludes — at checkout, after
-   * the user clicks a link, or when the session times out.
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param urls - URLs the user engaged with.
+   * @param options - Optional engagement metadata.
+   *
+   * @example
+   * ```ts
+   * // In a redirect/tracking endpoint
+   * await tracker.trackEngaged(sessionId, [productUrl], {
+   *   interactionType: "click",
+   * });
+   * ```
+   */
+  async trackEngaged(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_engaged",
+      timestamp: now,
+      contentUrl: url,
+      data: {
+        ...options.interactionType != null && {
+          interaction_type: options.interactionType
+        }
+      }
+    }));
+    await this.client.recordEvents(sessionId, events);
+  }
+  /**
+   * Record a checkout outcome and end the session.
+   *
+   * Call this when a user completes a purchase, abandons checkout, or
+   * the conversation concludes with a clear commerce outcome.
+   * Emits a `checkout_completed` or `checkout_abandoned` event then
+   * ends the session with the appropriate outcome type.
+   *
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param outcome - Purchase details.
+   *
+   * @example
+   * ```ts
+   * // User completed a purchase
+   * await tracker.trackCheckout(sessionId, {
+   *   type: "completed",
+   *   valueAmount: 4999, // $49.99 in minor units (cents)
+   *   currency: "USD",
+   * });
+   *
+   * // User abandoned checkout
+   * await tracker.trackCheckout(sessionId, { type: "abandoned" });
+   * ```
+   */
+  async trackCheckout(externalSessionId, outcome) {
+    const sessionId = externalSessionId != null ? this.registry.get(externalSessionId) ?? null : null;
+    if (sessionId == null) return;
+    const eventType = outcome.type === "completed" ? "checkout_completed" : outcome.type === "abandoned" ? "checkout_abandoned" : "checkout_started";
+    await this.client.recordEvent(sessionId, eventType);
+    if (outcome.type === "completed" || outcome.type === "abandoned") {
+      const outcomeType = outcome.type === "completed" ? "conversion" : "abandonment";
+      await this.client.endSession(sessionId, {
+        type: outcomeType,
+        ...outcome.valueAmount != null && { valueAmount: outcome.valueAmount },
+        ...outcome.currency != null && { currency: outcome.currency },
+        ...outcome.products != null && { products: outcome.products }
+      });
+      if (externalSessionId != null) {
+        this.registry.delete(externalSessionId);
+      }
+    }
+  }
+  /**
+   * End a session with an explicit outcome.
+   *
+   * Use `trackCheckout` for commerce outcomes. Use this for non-commerce
+   * session endings (browse sessions, timeouts, explicit abandonment).
    */
   async endSession(externalSessionId, outcome) {
     const sessionId = externalSessionId != null ? this.registry.get(externalSessionId) ?? null : null;
@@ -352,6 +432,14 @@ function extractResultUrls(results) {
   }
   return [...new Set(urls)];
 }
+function createTrackingUrl(contentUrl, options) {
+  const url = new URL(options.endpoint);
+  url.searchParams.set("url", contentUrl);
+  if (options.sessionId != null) {
+    url.searchParams.set("session_id", options.sessionId);
+  }
+  return url.toString();
+}
 function cleanUrl(url) {
   return url.replace(/[.,;:!?]+$/, "");
 }
@@ -434,6 +522,7 @@ function sessionToAttribution(session) {
 0 && (module.exports = {
   MCPSessionTracker,
   TelemetryClient,
+  createTrackingUrl,
   extractCitationUrls,
   extractResultUrls,
   sessionToAttribution,

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"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, createTrackingUrl } 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   * Emit `content_engaged` events when a user interacts with content.\n   *\n   * Call this when a user clicks a link, views an embedded product, or\n   * otherwise actively engages with retrieved content. This is the\n   * strongest attribution signal before a purchase event.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param urls - URLs the user engaged with.\n   * @param options - Optional engagement metadata.\n   *\n   * @example\n   * ```ts\n   * // In a redirect/tracking endpoint\n   * await tracker.trackEngaged(sessionId, [productUrl], {\n   *   interactionType: \"click\",\n   * });\n   * ```\n   */\n  async trackEngaged(\n    externalSessionId: string | undefined,\n    urls: string[],\n    options: {\n      interactionType?: \"click\" | \"view\" | \"expand\" | \"share\";\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_engaged\" as const,\n      timestamp: now,\n      contentUrl: url,\n      data: {\n        ...(options.interactionType != null && {\n          interaction_type: options.interactionType,\n        }),\n      },\n    }));\n\n    await this.client.recordEvents(sessionId, events);\n  }\n\n  /**\n   * Record a checkout outcome and end the session.\n   *\n   * Call this when a user completes a purchase, abandons checkout, or\n   * the conversation concludes with a clear commerce outcome.\n   * Emits a `checkout_completed` or `checkout_abandoned` event then\n   * ends the session with the appropriate outcome type.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param outcome - Purchase details.\n   *\n   * @example\n   * ```ts\n   * // User completed a purchase\n   * await tracker.trackCheckout(sessionId, {\n   *   type: \"completed\",\n   *   valueAmount: 4999, // $49.99 in minor units (cents)\n   *   currency: \"USD\",\n   * });\n   *\n   * // User abandoned checkout\n   * await tracker.trackCheckout(sessionId, { type: \"abandoned\" });\n   * ```\n   */\n  async trackCheckout(\n    externalSessionId: string | undefined,\n    outcome: {\n      type: \"completed\" | \"abandoned\" | \"started\";\n      valueAmount?: number;\n      currency?: string;\n      products?: string[];\n    },\n  ): Promise<void> {\n    const sessionId = externalSessionId != null\n      ? (this.registry.get(externalSessionId) ?? null)\n      : null;\n\n    if (sessionId == null) return;\n\n    // Emit the checkout event\n    const eventType = outcome.type === \"completed\"\n      ? \"checkout_completed\" as const\n      : outcome.type === \"abandoned\"\n      ? \"checkout_abandoned\" as const\n      : \"checkout_started\" as const;\n\n    await this.client.recordEvent(sessionId, eventType);\n\n    // End the session with an outcome for completed/abandoned\n    if (outcome.type === \"completed\" || outcome.type === \"abandoned\") {\n      const outcomeType = outcome.type === \"completed\" ? \"conversion\" as const : \"abandonment\" as const;\n      await this.client.endSession(sessionId, {\n        type: outcomeType,\n        ...(outcome.valueAmount != null && { valueAmount: outcome.valueAmount }),\n        ...(outcome.currency != null && { currency: outcome.currency }),\n        ...(outcome.products != null && { products: outcome.products }),\n      });\n      if (externalSessionId != null) {\n        this.registry.delete(externalSessionId);\n      }\n    }\n  }\n\n  /**\n   * End a session with an explicit outcome.\n   *\n   * Use `trackCheckout` for commerce outcomes. Use this for non-commerce\n   * session endings (browse sessions, timeouts, explicit abandonment).\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 * Build a tracking URL that routes through your server-side redirect endpoint.\n *\n * Your endpoint emits a `content_engaged` event then redirects the user to\n * the original URL. This is the most reliable pattern for click tracking —\n * it fires server-side before the redirect, so it works regardless of\n * browser JS state or navigation timing.\n *\n * @param contentUrl - The destination URL to redirect to after tracking.\n * @param options.endpoint - Your tracking endpoint base URL (e.g. `https://example.com/api/track`).\n * @param options.sessionId - Optional session ID to link the click to an existing session.\n *\n * @example\n * ```ts\n * // Build a tracked URL for a product link\n * const trackedUrl = createTrackingUrl(\"https://shop.example.com/product\", {\n *   endpoint: \"https://myagent.com/api/track\",\n *   sessionId: \"conv-abc123\",\n * });\n * // → \"https://myagent.com/api/track?url=https%3A%2F%2Fshop.example.com%2Fproduct&session_id=conv-abc123\"\n *\n * // Server-side handler (Next.js example):\n * export async function GET(req: Request) {\n *   const { searchParams } = new URL(req.url);\n *   const url = searchParams.get(\"url\");\n *   const sessionId = searchParams.get(\"session_id\") ?? undefined;\n *   if (!url) return new Response(\"Missing url\", { status: 400 });\n *   void tracker.trackEngaged(sessionId, [url], { interactionType: \"click\" });\n *   return Response.redirect(url, 302);\n * }\n * ```\n */\nexport function createTrackingUrl(\n  contentUrl: string,\n  options: {\n    endpoint: string;\n    sessionId?: string;\n  },\n): string {\n  const url = new URL(options.endpoint);\n  url.searchParams.set(\"url\", contentUrl);\n  if (options.sessionId != null) {\n    url.searchParams.set(\"session_id\", options.sessionId);\n  }\n  return url.toString();\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":[]}

package/dist/index.d.cts

@@ -283,10 +283,62 @@ declare class MCPSessionTracker {
         position?: "primary" | "supporting" | "mentioned";
     }): Promise<void>;
     /**
-     * End a session with an outcome.
+     * Emit `content_engaged` events when a user interacts with content.
+     *
+     * Call this when a user clicks a link, views an embedded product, or
+     * otherwise actively engages with retrieved content. This is the
+     * strongest attribution signal before a purchase event.
+     *
+     * @param externalSessionId - Caller-supplied conversation identifier.
+     * @param urls - URLs the user engaged with.
+     * @param options - Optional engagement metadata.
      *
-     * Call this when the conversation concludes — at checkout, after
-     * the user clicks a link, or when the session times out.
+     * @example
+     * ```ts
+     * // In a redirect/tracking endpoint
+     * await tracker.trackEngaged(sessionId, [productUrl], {
+     *   interactionType: "click",
+     * });
+     * ```
+     */
+    trackEngaged(externalSessionId: string | undefined, urls: string[], options?: {
+        interactionType?: "click" | "view" | "expand" | "share";
+    }): Promise<void>;
+    /**
+     * Record a checkout outcome and end the session.
+     *
+     * Call this when a user completes a purchase, abandons checkout, or
+     * the conversation concludes with a clear commerce outcome.
+     * Emits a `checkout_completed` or `checkout_abandoned` event then
+     * ends the session with the appropriate outcome type.
+     *
+     * @param externalSessionId - Caller-supplied conversation identifier.
+     * @param outcome - Purchase details.
+     *
+     * @example
+     * ```ts
+     * // User completed a purchase
+     * await tracker.trackCheckout(sessionId, {
+     *   type: "completed",
+     *   valueAmount: 4999, // $49.99 in minor units (cents)
+     *   currency: "USD",
+     * });
+     *
+     * // User abandoned checkout
+     * await tracker.trackCheckout(sessionId, { type: "abandoned" });
+     * ```
+     */
+    trackCheckout(externalSessionId: string | undefined, outcome: {
+        type: "completed" | "abandoned" | "started";
+        valueAmount?: number;
+        currency?: string;
+        products?: string[];
+    }): Promise<void>;
+    /**
+     * End a session with an explicit outcome.
+     *
+     * Use `trackCheckout` for commerce outcomes. Use this for non-commerce
+     * session endings (browse sessions, timeouts, explicit abandonment).
      */
     endSession(externalSessionId: string | undefined, outcome: {
         type: "conversion" | "abandonment" | "browse";
@@ -338,6 +390,42 @@ declare function extractResultUrls(results: Array<{
     url?: string | null;
     link?: string | null;
 }>): string[];
+/**
+ * Build a tracking URL that routes through your server-side redirect endpoint.
+ *
+ * Your endpoint emits a `content_engaged` event then redirects the user to
+ * the original URL. This is the most reliable pattern for click tracking —
+ * it fires server-side before the redirect, so it works regardless of
+ * browser JS state or navigation timing.
+ *
+ * @param contentUrl - The destination URL to redirect to after tracking.
+ * @param options.endpoint - Your tracking endpoint base URL (e.g. `https://example.com/api/track`).
+ * @param options.sessionId - Optional session ID to link the click to an existing session.
+ *
+ * @example
+ * ```ts
+ * // Build a tracked URL for a product link
+ * const trackedUrl = createTrackingUrl("https://shop.example.com/product", {
+ *   endpoint: "https://myagent.com/api/track",
+ *   sessionId: "conv-abc123",
+ * });
+ * // → "https://myagent.com/api/track?url=https%3A%2F%2Fshop.example.com%2Fproduct&session_id=conv-abc123"
+ *
+ * // Server-side handler (Next.js example):
+ * export async function GET(req: Request) {
+ *   const { searchParams } = new URL(req.url);
+ *   const url = searchParams.get("url");
+ *   const sessionId = searchParams.get("session_id") ?? undefined;
+ *   if (!url) return new Response("Missing url", { status: 400 });
+ *   void tracker.trackEngaged(sessionId, [url], { interactionType: "click" });
+ *   return Response.redirect(url, 302);
+ * }
+ * ```
+ */
+declare function createTrackingUrl(contentUrl: string, options: {
+    endpoint: string;
+    sessionId?: string;
+}): string;
 
 /**
  * OpenAttribution Telemetry — ACP (Agentic Commerce Protocol) bridge.
@@ -437,4 +525,4 @@ interface UCPAttribution {
  */
 declare function sessionToAttribution(session: TelemetrySession): UCPAttribution;
 
-export { type CitationPosition, type CitationType, type ContentAttribution, type ContentAttributionCited, type ContentAttributionRetrieved, type ConversationTurn, type EventType, type Initiator, type InitiatorType, type IntentCategory, MCPSessionTracker, type OutcomeType, type PrivacyLevel, type SessionOutcome, type StartSessionOptions, TelemetryClient, type TelemetryClientOptions, type TelemetryEvent, type TelemetrySession, type UCPAttribution, type UserContext, extractCitationUrls, extractResultUrls, sessionToAttribution, sessionToContentAttribution };
+export { type CitationPosition, type CitationType, type ContentAttribution, type ContentAttributionCited, type ContentAttributionRetrieved, type ConversationTurn, type EventType, type Initiator, type InitiatorType, type IntentCategory, MCPSessionTracker, type OutcomeType, type PrivacyLevel, type SessionOutcome, type StartSessionOptions, TelemetryClient, type TelemetryClientOptions, type TelemetryEvent, type TelemetrySession, type UCPAttribution, type UserContext, createTrackingUrl, extractCitationUrls, extractResultUrls, sessionToAttribution, sessionToContentAttribution };

package/dist/index.d.ts

@@ -283,10 +283,62 @@ declare class MCPSessionTracker {
         position?: "primary" | "supporting" | "mentioned";
     }): Promise<void>;
     /**
-     * End a session with an outcome.
+     * Emit `content_engaged` events when a user interacts with content.
+     *
+     * Call this when a user clicks a link, views an embedded product, or
+     * otherwise actively engages with retrieved content. This is the
+     * strongest attribution signal before a purchase event.
+     *
+     * @param externalSessionId - Caller-supplied conversation identifier.
+     * @param urls - URLs the user engaged with.
+     * @param options - Optional engagement metadata.
      *
-     * Call this when the conversation concludes — at checkout, after
-     * the user clicks a link, or when the session times out.
+     * @example
+     * ```ts
+     * // In a redirect/tracking endpoint
+     * await tracker.trackEngaged(sessionId, [productUrl], {
+     *   interactionType: "click",
+     * });
+     * ```
+     */
+    trackEngaged(externalSessionId: string | undefined, urls: string[], options?: {
+        interactionType?: "click" | "view" | "expand" | "share";
+    }): Promise<void>;
+    /**
+     * Record a checkout outcome and end the session.
+     *
+     * Call this when a user completes a purchase, abandons checkout, or
+     * the conversation concludes with a clear commerce outcome.
+     * Emits a `checkout_completed` or `checkout_abandoned` event then
+     * ends the session with the appropriate outcome type.
+     *
+     * @param externalSessionId - Caller-supplied conversation identifier.
+     * @param outcome - Purchase details.
+     *
+     * @example
+     * ```ts
+     * // User completed a purchase
+     * await tracker.trackCheckout(sessionId, {
+     *   type: "completed",
+     *   valueAmount: 4999, // $49.99 in minor units (cents)
+     *   currency: "USD",
+     * });
+     *
+     * // User abandoned checkout
+     * await tracker.trackCheckout(sessionId, { type: "abandoned" });
+     * ```
+     */
+    trackCheckout(externalSessionId: string | undefined, outcome: {
+        type: "completed" | "abandoned" | "started";
+        valueAmount?: number;
+        currency?: string;
+        products?: string[];
+    }): Promise<void>;
+    /**
+     * End a session with an explicit outcome.
+     *
+     * Use `trackCheckout` for commerce outcomes. Use this for non-commerce
+     * session endings (browse sessions, timeouts, explicit abandonment).
      */
     endSession(externalSessionId: string | undefined, outcome: {
         type: "conversion" | "abandonment" | "browse";
@@ -338,6 +390,42 @@ declare function extractResultUrls(results: Array<{
     url?: string | null;
     link?: string | null;
 }>): string[];
+/**
+ * Build a tracking URL that routes through your server-side redirect endpoint.
+ *
+ * Your endpoint emits a `content_engaged` event then redirects the user to
+ * the original URL. This is the most reliable pattern for click tracking —
+ * it fires server-side before the redirect, so it works regardless of
+ * browser JS state or navigation timing.
+ *
+ * @param contentUrl - The destination URL to redirect to after tracking.
+ * @param options.endpoint - Your tracking endpoint base URL (e.g. `https://example.com/api/track`).
+ * @param options.sessionId - Optional session ID to link the click to an existing session.
+ *
+ * @example
+ * ```ts
+ * // Build a tracked URL for a product link
+ * const trackedUrl = createTrackingUrl("https://shop.example.com/product", {
+ *   endpoint: "https://myagent.com/api/track",
+ *   sessionId: "conv-abc123",
+ * });
+ * // → "https://myagent.com/api/track?url=https%3A%2F%2Fshop.example.com%2Fproduct&session_id=conv-abc123"
+ *
+ * // Server-side handler (Next.js example):
+ * export async function GET(req: Request) {
+ *   const { searchParams } = new URL(req.url);
+ *   const url = searchParams.get("url");
+ *   const sessionId = searchParams.get("session_id") ?? undefined;
+ *   if (!url) return new Response("Missing url", { status: 400 });
+ *   void tracker.trackEngaged(sessionId, [url], { interactionType: "click" });
+ *   return Response.redirect(url, 302);
+ * }
+ * ```
+ */
+declare function createTrackingUrl(contentUrl: string, options: {
+    endpoint: string;
+    sessionId?: string;
+}): string;
 
 /**
  * OpenAttribution Telemetry — ACP (Agentic Commerce Protocol) bridge.
@@ -437,4 +525,4 @@ interface UCPAttribution {
  */
 declare function sessionToAttribution(session: TelemetrySession): UCPAttribution;
 
-export { type CitationPosition, type CitationType, type ContentAttribution, type ContentAttributionCited, type ContentAttributionRetrieved, type ConversationTurn, type EventType, type Initiator, type InitiatorType, type IntentCategory, MCPSessionTracker, type OutcomeType, type PrivacyLevel, type SessionOutcome, type StartSessionOptions, TelemetryClient, type TelemetryClientOptions, type TelemetryEvent, type TelemetrySession, type UCPAttribution, type UserContext, extractCitationUrls, extractResultUrls, sessionToAttribution, sessionToContentAttribution };
+export { type CitationPosition, type CitationType, type ContentAttribution, type ContentAttributionCited, type ContentAttributionRetrieved, type ConversationTurn, type EventType, type Initiator, type InitiatorType, type IntentCategory, MCPSessionTracker, type OutcomeType, type PrivacyLevel, type SessionOutcome, type StartSessionOptions, TelemetryClient, type TelemetryClientOptions, type TelemetryEvent, type TelemetrySession, type UCPAttribution, type UserContext, createTrackingUrl, extractCitationUrls, extractResultUrls, sessionToAttribution, sessionToContentAttribution };

package/dist/index.js

@@ -276,10 +276,89 @@ var MCPSessionTracker = class {
     await this.client.recordEvents(sessionId, events);
   }
   /**
-   * End a session with an outcome.
+   * Emit `content_engaged` events when a user interacts with content.
+   *
+   * Call this when a user clicks a link, views an embedded product, or
+   * otherwise actively engages with retrieved content. This is the
+   * strongest attribution signal before a purchase event.
    *
-   * Call this when the conversation concludes — at checkout, after
-   * the user clicks a link, or when the session times out.
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param urls - URLs the user engaged with.
+   * @param options - Optional engagement metadata.
+   *
+   * @example
+   * ```ts
+   * // In a redirect/tracking endpoint
+   * await tracker.trackEngaged(sessionId, [productUrl], {
+   *   interactionType: "click",
+   * });
+   * ```
+   */
+  async trackEngaged(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_engaged",
+      timestamp: now,
+      contentUrl: url,
+      data: {
+        ...options.interactionType != null && {
+          interaction_type: options.interactionType
+        }
+      }
+    }));
+    await this.client.recordEvents(sessionId, events);
+  }
+  /**
+   * Record a checkout outcome and end the session.
+   *
+   * Call this when a user completes a purchase, abandons checkout, or
+   * the conversation concludes with a clear commerce outcome.
+   * Emits a `checkout_completed` or `checkout_abandoned` event then
+   * ends the session with the appropriate outcome type.
+   *
+   * @param externalSessionId - Caller-supplied conversation identifier.
+   * @param outcome - Purchase details.
+   *
+   * @example
+   * ```ts
+   * // User completed a purchase
+   * await tracker.trackCheckout(sessionId, {
+   *   type: "completed",
+   *   valueAmount: 4999, // $49.99 in minor units (cents)
+   *   currency: "USD",
+   * });
+   *
+   * // User abandoned checkout
+   * await tracker.trackCheckout(sessionId, { type: "abandoned" });
+   * ```
+   */
+  async trackCheckout(externalSessionId, outcome) {
+    const sessionId = externalSessionId != null ? this.registry.get(externalSessionId) ?? null : null;
+    if (sessionId == null) return;
+    const eventType = outcome.type === "completed" ? "checkout_completed" : outcome.type === "abandoned" ? "checkout_abandoned" : "checkout_started";
+    await this.client.recordEvent(sessionId, eventType);
+    if (outcome.type === "completed" || outcome.type === "abandoned") {
+      const outcomeType = outcome.type === "completed" ? "conversion" : "abandonment";
+      await this.client.endSession(sessionId, {
+        type: outcomeType,
+        ...outcome.valueAmount != null && { valueAmount: outcome.valueAmount },
+        ...outcome.currency != null && { currency: outcome.currency },
+        ...outcome.products != null && { products: outcome.products }
+      });
+      if (externalSessionId != null) {
+        this.registry.delete(externalSessionId);
+      }
+    }
+  }
+  /**
+   * End a session with an explicit outcome.
+   *
+   * Use `trackCheckout` for commerce outcomes. Use this for non-commerce
+   * session endings (browse sessions, timeouts, explicit abandonment).
    */
   async endSession(externalSessionId, outcome) {
     const sessionId = externalSessionId != null ? this.registry.get(externalSessionId) ?? null : null;
@@ -321,6 +400,14 @@ function extractResultUrls(results) {
   }
   return [...new Set(urls)];
 }
+function createTrackingUrl(contentUrl, options) {
+  const url = new URL(options.endpoint);
+  url.searchParams.set("url", contentUrl);
+  if (options.sessionId != null) {
+    url.searchParams.set("session_id", options.sessionId);
+  }
+  return url.toString();
+}
 function cleanUrl(url) {
   return url.replace(/[.,;:!?]+$/, "");
 }
@@ -402,6 +489,7 @@ function sessionToAttribution(session) {
 export {
   MCPSessionTracker,
   TelemetryClient,
+  createTrackingUrl,
   extractCitationUrls,
   extractResultUrls,
   sessionToAttribution,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/mcp.ts","../src/extract.ts","../src/acp.ts","../src/ucp.ts"],"sourcesContent":["/**\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":[]}
+{"version":3,"sources":["../src/client.ts","../src/mcp.ts","../src/extract.ts","../src/acp.ts","../src/ucp.ts"],"sourcesContent":["/**\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   * Emit `content_engaged` events when a user interacts with content.\n   *\n   * Call this when a user clicks a link, views an embedded product, or\n   * otherwise actively engages with retrieved content. This is the\n   * strongest attribution signal before a purchase event.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param urls - URLs the user engaged with.\n   * @param options - Optional engagement metadata.\n   *\n   * @example\n   * ```ts\n   * // In a redirect/tracking endpoint\n   * await tracker.trackEngaged(sessionId, [productUrl], {\n   *   interactionType: \"click\",\n   * });\n   * ```\n   */\n  async trackEngaged(\n    externalSessionId: string | undefined,\n    urls: string[],\n    options: {\n      interactionType?: \"click\" | \"view\" | \"expand\" | \"share\";\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_engaged\" as const,\n      timestamp: now,\n      contentUrl: url,\n      data: {\n        ...(options.interactionType != null && {\n          interaction_type: options.interactionType,\n        }),\n      },\n    }));\n\n    await this.client.recordEvents(sessionId, events);\n  }\n\n  /**\n   * Record a checkout outcome and end the session.\n   *\n   * Call this when a user completes a purchase, abandons checkout, or\n   * the conversation concludes with a clear commerce outcome.\n   * Emits a `checkout_completed` or `checkout_abandoned` event then\n   * ends the session with the appropriate outcome type.\n   *\n   * @param externalSessionId - Caller-supplied conversation identifier.\n   * @param outcome - Purchase details.\n   *\n   * @example\n   * ```ts\n   * // User completed a purchase\n   * await tracker.trackCheckout(sessionId, {\n   *   type: \"completed\",\n   *   valueAmount: 4999, // $49.99 in minor units (cents)\n   *   currency: \"USD\",\n   * });\n   *\n   * // User abandoned checkout\n   * await tracker.trackCheckout(sessionId, { type: \"abandoned\" });\n   * ```\n   */\n  async trackCheckout(\n    externalSessionId: string | undefined,\n    outcome: {\n      type: \"completed\" | \"abandoned\" | \"started\";\n      valueAmount?: number;\n      currency?: string;\n      products?: string[];\n    },\n  ): Promise<void> {\n    const sessionId = externalSessionId != null\n      ? (this.registry.get(externalSessionId) ?? null)\n      : null;\n\n    if (sessionId == null) return;\n\n    // Emit the checkout event\n    const eventType = outcome.type === \"completed\"\n      ? \"checkout_completed\" as const\n      : outcome.type === \"abandoned\"\n      ? \"checkout_abandoned\" as const\n      : \"checkout_started\" as const;\n\n    await this.client.recordEvent(sessionId, eventType);\n\n    // End the session with an outcome for completed/abandoned\n    if (outcome.type === \"completed\" || outcome.type === \"abandoned\") {\n      const outcomeType = outcome.type === \"completed\" ? \"conversion\" as const : \"abandonment\" as const;\n      await this.client.endSession(sessionId, {\n        type: outcomeType,\n        ...(outcome.valueAmount != null && { valueAmount: outcome.valueAmount }),\n        ...(outcome.currency != null && { currency: outcome.currency }),\n        ...(outcome.products != null && { products: outcome.products }),\n      });\n      if (externalSessionId != null) {\n        this.registry.delete(externalSessionId);\n      }\n    }\n  }\n\n  /**\n   * End a session with an explicit outcome.\n   *\n   * Use `trackCheckout` for commerce outcomes. Use this for non-commerce\n   * session endings (browse sessions, timeouts, explicit abandonment).\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 * Build a tracking URL that routes through your server-side redirect endpoint.\n *\n * Your endpoint emits a `content_engaged` event then redirects the user to\n * the original URL. This is the most reliable pattern for click tracking —\n * it fires server-side before the redirect, so it works regardless of\n * browser JS state or navigation timing.\n *\n * @param contentUrl - The destination URL to redirect to after tracking.\n * @param options.endpoint - Your tracking endpoint base URL (e.g. `https://example.com/api/track`).\n * @param options.sessionId - Optional session ID to link the click to an existing session.\n *\n * @example\n * ```ts\n * // Build a tracked URL for a product link\n * const trackedUrl = createTrackingUrl(\"https://shop.example.com/product\", {\n *   endpoint: \"https://myagent.com/api/track\",\n *   sessionId: \"conv-abc123\",\n * });\n * // → \"https://myagent.com/api/track?url=https%3A%2F%2Fshop.example.com%2Fproduct&session_id=conv-abc123\"\n *\n * // Server-side handler (Next.js example):\n * export async function GET(req: Request) {\n *   const { searchParams } = new URL(req.url);\n *   const url = searchParams.get(\"url\");\n *   const sessionId = searchParams.get(\"session_id\") ?? undefined;\n *   if (!url) return new Response(\"Missing url\", { status: 400 });\n *   void tracker.trackEngaged(sessionId, [url], { interactionType: \"click\" });\n *   return Response.redirect(url, 302);\n * }\n * ```\n */\nexport function createTrackingUrl(\n  contentUrl: string,\n  options: {\n    endpoint: string;\n    sessionId?: string;\n  },\n): string {\n  const url = new URL(options.endpoint);\n  url.searchParams.set(\"url\", contentUrl);\n  if (options.sessionId != null) {\n    url.searchParams.set(\"session_id\", options.sessionId);\n  }\n  return url.toString();\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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openattribution/telemetry",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenAttribution Telemetry SDK for TypeScript/JavaScript — track content attribution in AI agent interactions",
   "license": "Apache-2.0",
   "author": "OpenAttribution Project",