@amplitude/ai 0.1.0

package/dist/integrations/opentelemetry.js

@@ -0,0 +1,146 @@
+import { calculateCost } from "../utils/costs.js";
+
+//#region src/integrations/opentelemetry.ts
+var AmplitudeAgentExporter = class {
+	_ai;
+	_defaultUserId;
+	constructor(options) {
+		this._ai = options.amplitudeAI;
+		this._defaultUserId = options.defaultUserId ?? "otel-user";
+	}
+	export(spans, resultCallback) {
+		for (const span of spans) try {
+			this._processSpan(span);
+		} catch {}
+		resultCallback({ code: 0 });
+	}
+	shutdown() {
+		return Promise.resolve();
+	}
+	forceFlush() {
+		this._ai.flush();
+		return Promise.resolve();
+	}
+	_processSpan(span) {
+		const attrs = span.attributes ?? {};
+		const providerName = attrs["gen_ai.provider.name"] ?? attrs["gen_ai.system"];
+		if (!providerName) return;
+		const startNanos = Number(span.startTimeUnixNano ?? 0);
+		const latencyMs = (Number(span.endTimeUnixNano ?? 0) - startNanos) / 1e6;
+		const isError = span.status?.code === 2;
+		const spanCtx = span.spanContext?.();
+		const operation = attrs["gen_ai.operation.name"] ?? attrs["gen_ai.operation"];
+		const userId = _normalizeOtelString(attrs["amplitude.user_id"]) ?? this._defaultUserId;
+		const sessionId = _normalizeOtelString(attrs["amplitude.session_id"]) ?? "otel-session";
+		const modelName = String(attrs["gen_ai.response.model"] ?? attrs["gen_ai.request.model"] ?? "unknown");
+		if (operation === "tool" || operation === "tool_call" || operation === "execute_tool") {
+			this._ai.trackToolCall({
+				userId,
+				toolName: String(attrs["gen_ai.tool.name"] ?? span.name ?? "tool"),
+				latencyMs,
+				success: !isError,
+				sessionId,
+				traceId: spanCtx?.traceId,
+				input: attrs["gen_ai.tool.arguments"] ?? attrs["gen_ai.request.prompt"] ?? void 0,
+				output: attrs["gen_ai.response.text"] ?? void 0,
+				errorMessage: isError ? span.status?.message : void 0
+			});
+			return;
+		}
+		if (operation === "embedding" || operation === "embeddings") {
+			this._ai.trackEmbedding({
+				userId,
+				model: modelName,
+				provider: providerName,
+				latencyMs,
+				sessionId,
+				traceId: spanCtx?.traceId,
+				inputTokens: attrs["gen_ai.usage.input_tokens"],
+				dimensions: attrs["gen_ai.embedding.vector_size"] ?? attrs["gen_ai.response.embedding_dimensions"] ?? attrs["gen_ai.embeddings.dimension.count"]
+			});
+			return;
+		}
+		const inputMessages = attrs["gen_ai.input.messages"];
+		if (inputMessages != null) {
+			const messages = typeof inputMessages === "string" ? _tryParseJsonArray(inputMessages) : Array.isArray(inputMessages) ? inputMessages : [];
+			for (const msg of messages) {
+				const m = msg;
+				if (m?.role === "user" && typeof m.content === "string" && m.content.length > 0) this._ai.trackUserMessage({
+					userId,
+					content: m.content,
+					sessionId,
+					traceId: spanCtx?.traceId
+				});
+			}
+		}
+		const inputTokens = _toOtelNumber(attrs["gen_ai.usage.input_tokens"]);
+		const outputTokens = _toOtelNumber(attrs["gen_ai.usage.output_tokens"]);
+		const totalTokens = inputTokens != null || outputTokens != null ? (inputTokens ?? 0) + (outputTokens ?? 0) : void 0;
+		const cacheReadTokens = _toOtelNumber(attrs["gen_ai.usage.cache_read.input_tokens"]);
+		const cacheCreationTokens = _toOtelNumber(attrs["gen_ai.usage.cache_creation.input_tokens"]);
+		let costUsd = _toOtelNumber(attrs["gen_ai.usage.cost"]);
+		if (costUsd == null && modelName !== "unknown" && inputTokens != null && outputTokens != null) try {
+			const computed = calculateCost({
+				modelName,
+				inputTokens,
+				outputTokens,
+				cacheReadInputTokens: cacheReadTokens ?? 0,
+				cacheCreationInputTokens: cacheCreationTokens ?? 0
+			});
+			if (computed > 0) costUsd = computed;
+		} catch {}
+		this._ai.trackAiMessage({
+			userId,
+			content: String(attrs["gen_ai.response.text"] ?? ""),
+			sessionId,
+			model: modelName,
+			provider: providerName,
+			latencyMs,
+			traceId: spanCtx?.traceId,
+			inputTokens,
+			outputTokens,
+			totalTokens,
+			cacheReadTokens,
+			cacheCreationTokens,
+			totalCostUsd: costUsd,
+			finishReason: _normalizeFinishReason(attrs["gen_ai.response.finish_reasons"]),
+			isError,
+			errorMessage: isError ? span.status?.message : void 0,
+			temperature: _toOtelNumber(attrs["gen_ai.request.temperature"]),
+			maxOutputTokens: _toOtelNumber(attrs["gen_ai.request.max_tokens"]),
+			topP: _toOtelNumber(attrs["gen_ai.request.top_p"])
+		});
+	}
+};
+const AmplitudeGenAIExporter = AmplitudeAgentExporter;
+const AmplitudeSpanExporter = AmplitudeAgentExporter;
+function _normalizeFinishReason(value) {
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) {
+		const first = value[0];
+		return typeof first === "string" ? first : void 0;
+	}
+}
+function _toOtelNumber(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "string") {
+		const parsed = Number(value);
+		return Number.isNaN(parsed) ? void 0 : parsed;
+	}
+}
+function _tryParseJsonArray(value) {
+	try {
+		const parsed = JSON.parse(value);
+		return Array.isArray(parsed) ? parsed : [];
+	} catch {
+		return [];
+	}
+}
+function _normalizeOtelString(value) {
+	if (typeof value === "string" && value.length > 0) return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+}
+
+//#endregion
+export { AmplitudeAgentExporter, AmplitudeGenAIExporter, AmplitudeSpanExporter };
+//# sourceMappingURL=opentelemetry.js.map

package/dist/integrations/opentelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.js","names":[],"sources":["../../src/integrations/opentelemetry.ts"],"sourcesContent":["/**\n * OpenTelemetry integration — maps GenAI OTEL spans to Amplitude events.\n *\n * Provides AmplitudeAgentExporter (SpanExporter) that converts\n * OpenTelemetry spans with GenAI semantic conventions into\n * Amplitude [Agent] events.\n */\n\nimport type { AmplitudeAI } from '../client.js';\nimport { calculateCost } from '../utils/costs.js';\n\nexport interface ExporterOptions {\n  amplitudeAI: AmplitudeAI;\n  defaultUserId?: string;\n}\n\ninterface OTELSpan {\n  name: string;\n  kind?: number;\n  attributes?: Record<string, unknown>;\n  startTimeUnixNano?: bigint | number;\n  endTimeUnixNano?: bigint | number;\n  status?: { code?: number; message?: string };\n  parentSpanId?: string;\n  spanContext?: () => { traceId: string; spanId: string };\n}\n\nexport class AmplitudeAgentExporter {\n  private _ai: AmplitudeAI;\n  private _defaultUserId: string;\n\n  constructor(options: ExporterOptions) {\n    this._ai = options.amplitudeAI;\n    this._defaultUserId = options.defaultUserId ?? 'otel-user';\n  }\n\n  export(\n    spans: OTELSpan[],\n    resultCallback: (result: { code: number }) => void,\n  ): void {\n    for (const span of spans) {\n      try {\n        this._processSpan(span);\n      } catch {\n        // Skip individual span failures\n      }\n    }\n    resultCallback({ code: 0 });\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    this._ai.flush();\n    return Promise.resolve();\n  }\n\n  private _processSpan(span: OTELSpan): void {\n    const attrs = span.attributes ?? {};\n    const providerName =\n      (attrs['gen_ai.provider.name'] as string | undefined) ??\n      (attrs['gen_ai.system'] as string | undefined);\n\n    if (!providerName) return; // Not a GenAI span\n\n    const startNanos = Number(span.startTimeUnixNano ?? 0);\n    const endNanos = Number(span.endTimeUnixNano ?? 0);\n    const latencyMs = (endNanos - startNanos) / 1_000_000;\n    const isError = span.status?.code === 2;\n    const spanCtx = span.spanContext?.();\n    const operation =\n      (attrs['gen_ai.operation.name'] as string | undefined) ??\n      (attrs['gen_ai.operation'] as string | undefined);\n    const userId =\n      _normalizeOtelString(attrs['amplitude.user_id']) ?? this._defaultUserId;\n    const sessionId =\n      _normalizeOtelString(attrs['amplitude.session_id']) ?? 'otel-session';\n\n    // Prefer response.model (actual versioned model) over request.model\n    const modelName = String(\n      attrs['gen_ai.response.model'] ??\n        attrs['gen_ai.request.model'] ??\n        'unknown',\n    );\n\n    if (\n      operation === 'tool' ||\n      operation === 'tool_call' ||\n      operation === 'execute_tool'\n    ) {\n      this._ai.trackToolCall({\n        userId,\n        toolName: String(attrs['gen_ai.tool.name'] ?? span.name ?? 'tool'),\n        latencyMs,\n        success: !isError,\n        sessionId,\n        traceId: spanCtx?.traceId,\n        input:\n          attrs['gen_ai.tool.arguments'] ??\n          attrs['gen_ai.request.prompt'] ??\n          undefined,\n        output: attrs['gen_ai.response.text'] ?? undefined,\n        errorMessage: isError ? span.status?.message : undefined,\n      });\n      return;\n    }\n\n    if (operation === 'embedding' || operation === 'embeddings') {\n      this._ai.trackEmbedding({\n        userId,\n        model: modelName,\n        provider: providerName,\n        latencyMs,\n        sessionId,\n        traceId: spanCtx?.traceId,\n        inputTokens: attrs['gen_ai.usage.input_tokens'] as number | undefined,\n        dimensions:\n          (attrs['gen_ai.embedding.vector_size'] as number | undefined) ??\n          (attrs['gen_ai.response.embedding_dimensions'] as\n            | number\n            | undefined) ??\n          (attrs['gen_ai.embeddings.dimension.count'] as number | undefined),\n      });\n      return;\n    }\n\n    // Track user messages from gen_ai.input.messages when available\n    const inputMessages = attrs['gen_ai.input.messages'];\n    if (inputMessages != null) {\n      const messages =\n        typeof inputMessages === 'string'\n          ? _tryParseJsonArray(inputMessages)\n          : Array.isArray(inputMessages)\n            ? inputMessages\n            : [];\n      for (const msg of messages) {\n        const m = msg as Record<string, unknown> | undefined;\n        if (\n          m?.role === 'user' &&\n          typeof m.content === 'string' &&\n          m.content.length > 0\n        ) {\n          this._ai.trackUserMessage({\n            userId,\n            content: m.content,\n            sessionId,\n            traceId: spanCtx?.traceId,\n          });\n        }\n      }\n    }\n\n    const inputTokens = _toOtelNumber(attrs['gen_ai.usage.input_tokens']);\n    const outputTokens = _toOtelNumber(attrs['gen_ai.usage.output_tokens']);\n    const totalTokens =\n      inputTokens != null || outputTokens != null\n        ? (inputTokens ?? 0) + (outputTokens ?? 0)\n        : undefined;\n    const cacheReadTokens = _toOtelNumber(\n      attrs['gen_ai.usage.cache_read.input_tokens'],\n    );\n    const cacheCreationTokens = _toOtelNumber(\n      attrs['gen_ai.usage.cache_creation.input_tokens'],\n    );\n\n    let costUsd = _toOtelNumber(attrs['gen_ai.usage.cost']);\n    if (\n      costUsd == null &&\n      modelName !== 'unknown' &&\n      inputTokens != null &&\n      outputTokens != null\n    ) {\n      try {\n        const computed = calculateCost({\n          modelName,\n          inputTokens,\n          outputTokens,\n          cacheReadInputTokens: cacheReadTokens ?? 0,\n          cacheCreationInputTokens: cacheCreationTokens ?? 0,\n        });\n        if (computed > 0) costUsd = computed;\n      } catch {\n        // cost calculation is best-effort\n      }\n    }\n\n    this._ai.trackAiMessage({\n      userId,\n      content: String(attrs['gen_ai.response.text'] ?? ''),\n      sessionId,\n      model: modelName,\n      provider: providerName,\n      latencyMs,\n      traceId: spanCtx?.traceId,\n      inputTokens,\n      outputTokens,\n      totalTokens,\n      cacheReadTokens,\n      cacheCreationTokens,\n      totalCostUsd: costUsd,\n      finishReason: _normalizeFinishReason(\n        attrs['gen_ai.response.finish_reasons'],\n      ),\n      isError,\n      errorMessage: isError ? span.status?.message : undefined,\n      temperature: _toOtelNumber(attrs['gen_ai.request.temperature']),\n      maxOutputTokens: _toOtelNumber(attrs['gen_ai.request.max_tokens']),\n      topP: _toOtelNumber(attrs['gen_ai.request.top_p']),\n    });\n  }\n}\n\nexport const AmplitudeGenAIExporter = AmplitudeAgentExporter;\nexport const AmplitudeSpanExporter = AmplitudeAgentExporter;\n\nfunction _normalizeFinishReason(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    const first = value[0];\n    return typeof first === 'string' ? first : undefined;\n  }\n  return undefined;\n}\n\nfunction _toOtelNumber(value: unknown): number | undefined {\n  if (typeof value === 'number') return value;\n  if (typeof value === 'string') {\n    const parsed = Number(value);\n    return Number.isNaN(parsed) ? undefined : parsed;\n  }\n  return undefined;\n}\n\nfunction _tryParseJsonArray(value: string): unknown[] {\n  try {\n    const parsed = JSON.parse(value);\n    return Array.isArray(parsed) ? parsed : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction _normalizeOtelString(value: unknown): string | undefined {\n  if (typeof value === 'string' && value.length > 0) return value;\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/internals.d.ts

@@ -0,0 +1,5 @@
+import { TrackAiMessageOptions, TrackConversationOptions, TrackEmbeddingOptions, TrackScoreOptions, TrackSessionEndOptions, TrackSessionEnrichmentOptions, TrackSpanOptions, TrackToolCallOptions, TrackUserMessageOptions } from "./core/tracking.js";
+import { StreamingAccumulator } from "./utils/streaming.js";
+import { BaseAIProvider, ProviderTrackOptions, SimpleStreamingTracker, applySessionContext } from "./providers/base.js";
+import { inferProvider, stripProviderPrefix } from "./utils/costs.js";
+export { BaseAIProvider, type ProviderTrackOptions, SimpleStreamingTracker, StreamingAccumulator, type TrackAiMessageOptions, type TrackConversationOptions, type TrackEmbeddingOptions, type TrackScoreOptions, type TrackSessionEndOptions, type TrackSessionEnrichmentOptions, type TrackSpanOptions, type TrackToolCallOptions, type TrackUserMessageOptions, applySessionContext, inferProvider, stripProviderPrefix };

package/dist/internals.js

@@ -0,0 +1,5 @@
+import { inferProvider, stripProviderPrefix } from "./utils/costs.js";
+import { StreamingAccumulator } from "./utils/streaming.js";
+import { BaseAIProvider, SimpleStreamingTracker, applySessionContext } from "./providers/base.js";
+
+export { BaseAIProvider, SimpleStreamingTracker, StreamingAccumulator, applySessionContext, inferProvider, stripProviderPrefix };

package/dist/mcp/contract.d.ts

@@ -0,0 +1,27 @@
+//#region src/mcp/contract.d.ts
+declare const MCP_SERVER_NAME = "amplitude-ai-mcp";
+declare const MCP_TOOLS: {
+  readonly getEventSchema: "get_event_schema";
+  readonly getIntegrationPattern: "get_integration_pattern";
+  readonly validateSetup: "validate_setup";
+  readonly suggestInstrumentation: "suggest_instrumentation";
+  readonly validateFile: "validate_file";
+  readonly searchDocs: "search_docs";
+};
+declare const MCP_RESOURCES: {
+  readonly eventSchema: "amplitude-ai://event-schema";
+  readonly integrationPatterns: "amplitude-ai://integration-patterns";
+};
+declare const MCP_PROMPTS: {
+  readonly instrumentApp: "instrument_app";
+};
+declare const GENERATED_FILES: {
+  readonly agents: "AGENTS.md";
+  readonly llms: "llms.txt";
+  readonly llmsFull: "llms-full.txt";
+  readonly mcpSchema: "mcp.schema.json";
+};
+type MToolName = (typeof MCP_TOOLS)[keyof typeof MCP_TOOLS];
+//#endregion
+export { GENERATED_FILES, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS, MToolName };
+//# sourceMappingURL=contract.d.ts.map

package/dist/mcp/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","names":[],"sources":["../../src/mcp/contract.ts"],"sourcesContent":[],"mappings":";cAAa,eAAA;AAAA,cAEA,SAFe,EAAA;EAEf,SAAA,cAOH,EAAA,kBAAA;EAEG,SAAA,qBAGH,EAAA,yBAAA;EAEG,SAAA,aAEH,EAAA,gBAAA;EAEG,SAAA,sBAKH,EAAA,yBAAA;EAEE,SAAA,YAAS,EAAA,eAAmC;;;cAhB3C;;;;cAKA;;;cAIA;;;;;;KAOD,SAAA,WAAoB,wBAAwB"}

package/dist/mcp/contract.js

@@ -0,0 +1,25 @@
+//#region src/mcp/contract.ts
+const MCP_SERVER_NAME = "amplitude-ai-mcp";
+const MCP_TOOLS = {
+	getEventSchema: "get_event_schema",
+	getIntegrationPattern: "get_integration_pattern",
+	validateSetup: "validate_setup",
+	suggestInstrumentation: "suggest_instrumentation",
+	validateFile: "validate_file",
+	searchDocs: "search_docs"
+};
+const MCP_RESOURCES = {
+	eventSchema: "amplitude-ai://event-schema",
+	integrationPatterns: "amplitude-ai://integration-patterns"
+};
+const MCP_PROMPTS = { instrumentApp: "instrument_app" };
+const GENERATED_FILES = {
+	agents: "AGENTS.md",
+	llms: "llms.txt",
+	llmsFull: "llms-full.txt",
+	mcpSchema: "mcp.schema.json"
+};
+
+//#endregion
+export { GENERATED_FILES, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS };
+//# sourceMappingURL=contract.js.map

package/dist/mcp/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","names":[],"sources":["../../src/mcp/contract.ts"],"sourcesContent":["export const MCP_SERVER_NAME = 'amplitude-ai-mcp';\n\nexport const MCP_TOOLS = {\n  getEventSchema: 'get_event_schema',\n  getIntegrationPattern: 'get_integration_pattern',\n  validateSetup: 'validate_setup',\n  suggestInstrumentation: 'suggest_instrumentation',\n  validateFile: 'validate_file',\n  searchDocs: 'search_docs',\n} as const;\n\nexport const MCP_RESOURCES = {\n  eventSchema: 'amplitude-ai://event-schema',\n  integrationPatterns: 'amplitude-ai://integration-patterns',\n} as const;\n\nexport const MCP_PROMPTS = {\n  instrumentApp: 'instrument_app',\n} as const;\n\nexport const GENERATED_FILES = {\n  agents: 'AGENTS.md',\n  llms: 'llms.txt',\n  llmsFull: 'llms-full.txt',\n  mcpSchema: 'mcp.schema.json',\n} as const;\n\nexport type MToolName = (typeof MCP_TOOLS)[keyof typeof MCP_TOOLS];\n"],"mappings":";AAAA,MAAa,kBAAkB;AAE/B,MAAa,YAAY;CACvB,gBAAgB;CAChB,uBAAuB;CACvB,eAAe;CACf,wBAAwB;CACxB,cAAc;CACd,YAAY;CACb;AAED,MAAa,gBAAgB;CAC3B,aAAa;CACb,qBAAqB;CACtB;AAED,MAAa,cAAc,EACzB,eAAe,kBAChB;AAED,MAAa,kBAAkB;CAC7B,QAAQ;CACR,MAAM;CACN,UAAU;CACV,WAAW;CACZ"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,4 @@
+import { GENERATED_FILES, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS, MToolName } from "./contract.js";
+import { IntegrationPattern, getIntegrationPatterns } from "./patterns.js";
+import { buildInstrumentationGuidance, createServer, runMcpServer } from "./server.js";
+export { GENERATED_FILES, IntegrationPattern, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS, MToolName, buildInstrumentationGuidance, createServer, getIntegrationPatterns, runMcpServer };

package/dist/mcp/index.js

@@ -0,0 +1,5 @@
+import { GENERATED_FILES, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS } from "./contract.js";
+import { getIntegrationPatterns } from "./patterns.js";
+import { buildInstrumentationGuidance, createServer, runMcpServer } from "./server.js";
+
+export { GENERATED_FILES, MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS, buildInstrumentationGuidance, createServer, getIntegrationPatterns, runMcpServer };

package/dist/mcp/patterns.d.ts

@@ -0,0 +1,11 @@
+//#region src/mcp/patterns.d.ts
+type IntegrationPattern = {
+  id: string;
+  title: string;
+  whenToUse: string;
+  snippet: string;
+};
+declare const getIntegrationPatterns: () => IntegrationPattern[];
+//#endregion
+export { type IntegrationPattern, getIntegrationPatterns };
+//# sourceMappingURL=patterns.d.ts.map

package/dist/mcp/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","names":[],"sources":["../../src/mcp/patterns.ts"],"sourcesContent":[],"mappings":";KAAK,kBAAA;EAAA,EAAA,EAAA,MAAA;EAgDC,KAAA,EAAA,MAAA;;;;cAAA,8BAA6B"}

package/dist/mcp/patterns.js

@@ -0,0 +1,38 @@
+//#region src/mcp/patterns.ts
+const INTEGRATION_PATTERNS = [
+	{
+		id: "wrap-openai",
+		title: "Recommended production default: wrap provider + session context",
+		whenToUse: "Best balance of effort and value: high-fidelity provider telemetry plus session lineage.",
+		snippet: "import { AmplitudeAI, OpenAI } from \"@amplitude/ai\";\nconst ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY!, contentMode: \"full\", redactPii: true });\nconst client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY!, amplitude: ai });\nconst session = ai.agent(\"assistant\", { userId: \"u1\" }).session({ sessionId: \"s1\" });\nawait session.run(async () => client.chat.completions.create({ model: \"gpt-4o\", messages: [{ role: \"user\", content: \"hi\" }] }));"
+	},
+	{
+		id: "bound-agent-session",
+		title: "Bound agent + session lifecycle",
+		whenToUse: "Need strong user/session lineage, multi-agent orchestration, and session-level analytics.",
+		snippet: "const ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });\nconst agent = ai.agent(\"assistant\", { userId: \"u1\" });\nconst session = agent.session({ sessionId: \"s1\" });"
+	},
+	{
+		id: "zero-code",
+		title: "Zero-code patching (migration fallback)",
+		whenToUse: "Existing codebase; want immediate coverage before upgrading to wrapper + session context.",
+		snippet: "import { AmplitudeAI, patch } from \"@amplitude/ai\";\nconst ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });\npatch({ amplitudeAI: ai });"
+	},
+	{
+		id: "tool-decorator",
+		title: "Tool instrumentation",
+		whenToUse: "Need explicit visibility into tool calls and outcomes.",
+		snippet: "import { tool } from \"@amplitude/ai\";\nconst searchProducts = tool(async (query: string) => ({ items: [] }), {\n  name: \"search_products\",\n  inputSchema: { type: \"object\", properties: { query: { type: \"string\" } }, required: [\"query\"] },\n});"
+	},
+	{
+		id: "express-middleware",
+		title: "Express middleware propagation",
+		whenToUse: "Server app needs per-request context propagation.",
+		snippet: "import { createAmplitudeAIMiddleware } from \"@amplitude/ai\";\napp.use(createAmplitudeAIMiddleware());"
+	}
+];
+const getIntegrationPatterns = () => INTEGRATION_PATTERNS.map((pattern) => ({ ...pattern }));
+
+//#endregion
+export { getIntegrationPatterns };
+//# sourceMappingURL=patterns.js.map

package/dist/mcp/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","names":["INTEGRATION_PATTERNS: IntegrationPattern[]"],"sources":["../../src/mcp/patterns.ts"],"sourcesContent":["type IntegrationPattern = {\n  id: string;\n  title: string;\n  whenToUse: string;\n  snippet: string;\n};\n\nconst INTEGRATION_PATTERNS: IntegrationPattern[] = [\n  {\n    id: 'wrap-openai',\n    title: 'Recommended production default: wrap provider + session context',\n    whenToUse:\n      'Best balance of effort and value: high-fidelity provider telemetry plus session lineage.',\n    snippet:\n      'import { AmplitudeAI, OpenAI } from \"@amplitude/ai\";\\nconst ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY!, contentMode: \"full\", redactPii: true });\\nconst client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY!, amplitude: ai });\\nconst session = ai.agent(\"assistant\", { userId: \"u1\" }).session({ sessionId: \"s1\" });\\nawait session.run(async () => client.chat.completions.create({ model: \"gpt-4o\", messages: [{ role: \"user\", content: \"hi\" }] }));',\n  },\n  {\n    id: 'bound-agent-session',\n    title: 'Bound agent + session lifecycle',\n    whenToUse:\n      'Need strong user/session lineage, multi-agent orchestration, and session-level analytics.',\n    snippet:\n      'const ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });\\nconst agent = ai.agent(\"assistant\", { userId: \"u1\" });\\nconst session = agent.session({ sessionId: \"s1\" });',\n  },\n  {\n    id: 'zero-code',\n    title: 'Zero-code patching (migration fallback)',\n    whenToUse:\n      'Existing codebase; want immediate coverage before upgrading to wrapper + session context.',\n    snippet:\n      'import { AmplitudeAI, patch } from \"@amplitude/ai\";\\nconst ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });\\npatch({ amplitudeAI: ai });',\n  },\n  {\n    id: 'tool-decorator',\n    title: 'Tool instrumentation',\n    whenToUse: 'Need explicit visibility into tool calls and outcomes.',\n    snippet:\n      'import { tool } from \"@amplitude/ai\";\\nconst searchProducts = tool(async (query: string) => ({ items: [] }), {\\n  name: \"search_products\",\\n  inputSchema: { type: \"object\", properties: { query: { type: \"string\" } }, required: [\"query\"] },\\n});',\n  },\n  {\n    id: 'express-middleware',\n    title: 'Express middleware propagation',\n    whenToUse: 'Server app needs per-request context propagation.',\n    snippet:\n      'import { createAmplitudeAIMiddleware } from \"@amplitude/ai\";\\napp.use(createAmplitudeAIMiddleware());',\n  },\n];\n\nconst getIntegrationPatterns = (): IntegrationPattern[] =>\n  INTEGRATION_PATTERNS.map((pattern) => ({ ...pattern }));\n\nexport { getIntegrationPatterns, type IntegrationPattern };\n"],"mappings":";AAOA,MAAMA,uBAA6C;CACjD;EACE,IAAI;EACJ,OAAO;EACP,WACE;EACF,SACE;EACH;CACD;EACE,IAAI;EACJ,OAAO;EACP,WACE;EACF,SACE;EACH;CACD;EACE,IAAI;EACJ,OAAO;EACP,WACE;EACF,SACE;EACH;CACD;EACE,IAAI;EACJ,OAAO;EACP,WAAW;EACX,SACE;EACH;CACD;EACE,IAAI;EACJ,OAAO;EACP,WAAW;EACX,SACE;EACH;CACF;AAED,MAAM,+BACJ,qBAAqB,KAAK,aAAa,EAAE,GAAG,SAAS,EAAE"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/server.d.ts
+type ContentTier = 'full' | 'metadata_only' | 'customer_enriched';
+declare const buildInstrumentationGuidance: (framework: string, provider: string, contentTier: ContentTier) => string[];
+declare const createServer: () => McpServer;
+declare const runMcpServer: () => Promise<void>;
+//#endregion
+export { buildInstrumentationGuidance, createServer, runMcpServer };
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/mcp/server.ts"],"sourcesContent":[],"mappings":";;;KAqCK,WAAA;cAaC,iFAGS;AAlDqD,cA2H9D,YAzFU,EAAA,GAAA,GAyFS,SAzFT;AAAA,cAqaV,YAxZA,EAAA,GAAA,GAwZyB,OAhW9B,CAAA,IAAA,CArDc"}

package/dist/mcp/server.js

@@ -0,0 +1,241 @@
+import { MCP_PROMPTS, MCP_RESOURCES, MCP_SERVER_NAME, MCP_TOOLS } from "./contract.js";
+import { getIntegrationPatterns } from "./patterns.js";
+import { enumType, numberType, stringType } from "../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js";
+import { McpServer } from "../node_modules/.pnpm/@modelcontextprotocol_sdk@1.27.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js";
+import { StdioServerTransport } from "../node_modules/.pnpm/@modelcontextprotocol_sdk@1.27.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js";
+import { analyzeFileInstrumentation } from "./validate-file.js";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/mcp/server.ts
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+let _catalogCache;
+const readEventCatalog = () => {
+	if (_catalogCache) return _catalogCache;
+	const raw = readFileSync(join(packageRoot, "data", "agent_event_catalog.json"), "utf8");
+	_catalogCache = JSON.parse(raw);
+	return _catalogCache;
+};
+const normalizeContentTier = (value) => {
+	if (value === "full" || value === "metadata_only" || value === "customer_enriched") return value;
+	return "full";
+};
+const buildInstrumentationGuidance = (framework, provider, contentTier) => {
+	const providerSetup = provider === "openai" || provider === "anthropic" ? `use ${provider} wrapper/swap integration (for example: \`new ${provider === "openai" ? "OpenAI" : "Anthropic"}({ amplitude: ai, ... })\`)` : `use the ${provider} provider wrapper class from @amplitude/ai`;
+	const frameworkStep = framework === "express" || framework === "koa" || framework === "fastify" ? "wire `createAmplitudeAIMiddleware()` for per-request identity propagation and run LLM calls inside session context" : framework === "next" || framework === "nextjs" ? "wrap route handlers in `session.run()` so every LLM call inherits user/session lineage" : "attach `ai.agent(...).session(...)` where request or conversation identity exists";
+	const tierGuidance = contentTier === "full" ? "Content tier (`full`): maximum insight and automatic server enrichments. Prefer `redactPii: true` (+ optional `customRedactionPatterns`)." : contentTier === "metadata_only" ? "Content tier (`metadata_only`): no content leaves your infrastructure; keep token/cost/latency/session analytics." : "Content tier (`customer_enriched`): no content leaves infra; send your own labels via `trackSessionEnrichment(...)` for advanced analytics.";
+	const nextForTier = contentTier === "metadata_only" ? "if you need quality/topic analytics without sending content, move to `customer_enriched` and emit structured enrichments." : contentTier === "customer_enriched" ? "if policy allows and you want zero eval-code overhead, consider `full` with redaction for automatic server enrichments." : "if policy prohibits content egress, switch to `metadata_only` or `customer_enriched` without changing session instrumentation.";
+	return [
+		`Framework: ${framework}`,
+		`Provider: ${provider}`,
+		`Content tier: ${contentTier}`,
+		"",
+		"Now:",
+		"1) install @amplitude/ai and @amplitude/analytics-node",
+		"2) initialize `AmplitudeAI` with API key",
+		`3) ${providerSetup}`,
+		"4) bind session context with `const session = ai.agent(...).session(...)` and run calls in `session.run(...)`",
+		`5) ${frameworkStep}`,
+		"",
+		"Next:",
+		`- ${nextForTier}`,
+		"- treat `patch({ amplitudeAI: ai })` as migration quickstart, not steady-state production.",
+		"",
+		"Why:",
+		"- session lineage unlocks scoring, enrichments, and reliable product-to-AI funnels.",
+		"- wrapper/swap integration preserves fidelity while keeping implementation effort low.",
+		`- ${tierGuidance}`,
+		"- privacy controls apply before events leave your process.",
+		"",
+		"Validate:",
+		"- run `amplitude-ai doctor` and verify [Agent] session-scoped events."
+	];
+};
+const headingPriority = (heading) => {
+	const normalized = heading.toLowerCase();
+	if (normalized.includes("choose your integration tier") || normalized.includes("privacy & content control")) return 3;
+	if (normalized.includes("boundagent") || normalized.includes("bound agent") || normalized.includes("session")) return 2;
+	return 1;
+};
+const createServer = () => {
+	const server = new McpServer({
+		name: MCP_SERVER_NAME,
+		version: "0.1.0"
+	});
+	server.registerTool(MCP_TOOLS.getEventSchema, {
+		title: "Get Event Schema",
+		description: "Return Amplitude AI event schema and event-property definitions.",
+		inputSchema: { event_type: stringType().optional() }
+	}, async (args) => {
+		const eventType = typeof args?.event_type === "string" ? args.event_type : void 0;
+		const events = readEventCatalog().events ?? [];
+		const selected = eventType ? events.filter((event) => event.event_type === eventType) : events;
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({
+				total: selected.length,
+				events: selected
+			}, null, 2)
+		}] };
+	});
+	server.registerTool(MCP_TOOLS.getIntegrationPattern, {
+		title: "Get Integration Pattern",
+		description: "Return canonical instrumentation patterns for @amplitude/ai.",
+		inputSchema: { id: stringType().optional() }
+	}, async (args) => {
+		const id = typeof args?.id === "string" ? args.id : void 0;
+		const patterns = getIntegrationPatterns();
+		const selected = id ? patterns.filter((pattern) => pattern.id === id) : patterns;
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({ patterns: selected }, null, 2)
+		}] };
+	});
+	server.registerTool(MCP_TOOLS.validateSetup, {
+		title: "Validate Setup",
+		description: "Validate environment variables required for @amplitude/ai.",
+		inputSchema: {}
+	}, async () => {
+		const missing = ["AMPLITUDE_AI_API_KEY"].filter((name) => !process.env[name]);
+		const status = missing.length === 0 ? "ok" : "missing_env";
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({
+				status,
+				missing_env: missing
+			}, null, 2)
+		}] };
+	});
+	server.registerTool(MCP_TOOLS.suggestInstrumentation, {
+		title: "Suggest Instrumentation",
+		description: "Suggest practical next instrumentation steps from minimal hints.",
+		inputSchema: {
+			framework: stringType().optional(),
+			provider: stringType().optional(),
+			content_tier: enumType([
+				"full",
+				"metadata_only",
+				"customer_enriched"
+			]).optional().describe("Desired content tier (default: full)")
+		}
+	}, async (args) => {
+		return { content: [{
+			type: "text",
+			text: buildInstrumentationGuidance(typeof args?.framework === "string" ? args.framework : "node", typeof args?.provider === "string" ? args.provider : "openai", normalizeContentTier(args?.content_tier)).join("\n")
+		}] };
+	});
+	server.registerTool(MCP_TOOLS.validateFile, {
+		title: "Validate File Instrumentation",
+		description: "Analyze source code to detect LLM call sites and report which are instrumented vs uninstrumented.",
+		inputSchema: { source: stringType().describe("Source code content to analyze") }
+	}, async (args) => {
+		const result = analyzeFileInstrumentation(typeof args?.source === "string" ? args.source : "");
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+	server.registerTool(MCP_TOOLS.searchDocs, {
+		title: "Search Documentation",
+		description: "Search the SDK README and API reference for a keyword or phrase. Returns matching sections with surrounding context.",
+		inputSchema: {
+			query: stringType().describe("Keyword or phrase to search for"),
+			max_results: numberType().optional().describe("Maximum number of results to return (default: 5)")
+		}
+	}, async (args) => {
+		const query = typeof args?.query === "string" ? args.query.toLowerCase() : "";
+		const maxResults = typeof args?.max_results === "number" ? args.max_results : 5;
+		if (!query) return { content: [{
+			type: "text",
+			text: JSON.stringify({ error: "query is required" })
+		}] };
+		const sources = [{
+			name: "README.md",
+			path: join(packageRoot, "README.md")
+		}, {
+			name: "llms-full.txt",
+			path: join(packageRoot, "llms-full.txt")
+		}];
+		const results = [];
+		for (const { name, path } of sources) {
+			let content;
+			try {
+				content = readFileSync(path, "utf8");
+			} catch {
+				continue;
+			}
+			const lines = content.split("\n");
+			let currentHeading = "(top)";
+			for (let i = 0; i < lines.length; i++) {
+				const line = lines[i] ?? "";
+				if (line.startsWith("#")) currentHeading = line.replace(/^#+\s*/, "");
+				if (line.toLowerCase().includes(query)) {
+					const start = Math.max(0, i - 2);
+					const end = Math.min(lines.length, i + 3);
+					results.push({
+						source: name,
+						heading: currentHeading,
+						snippet: lines.slice(start, end).join("\n"),
+						line: i + 1,
+						priority: headingPriority(currentHeading)
+					});
+				}
+			}
+		}
+		results.sort((a, b) => b.priority - a.priority || a.line - b.line);
+		const selected = results.slice(0, maxResults);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({
+				query,
+				total: selected.length,
+				results: selected.map(({ priority, ...rest }) => rest)
+			}, null, 2)
+		}] };
+	});
+	server.registerResource("event_schema", MCP_RESOURCES.eventSchema, {
+		title: "Amplitude AI Event Schema",
+		description: "Current event and property catalog for @amplitude/ai.",
+		mimeType: "application/json"
+	}, async () => ({ contents: [{
+		uri: MCP_RESOURCES.eventSchema,
+		mimeType: "application/json",
+		text: JSON.stringify(readEventCatalog(), null, 2)
+	}] }));
+	server.registerResource("integration_patterns", MCP_RESOURCES.integrationPatterns, {
+		title: "Amplitude AI Integration Patterns",
+		description: "Canonical setup patterns used by docs and agent workflows.",
+		mimeType: "application/json"
+	}, async () => ({ contents: [{
+		uri: MCP_RESOURCES.integrationPatterns,
+		mimeType: "application/json",
+		text: JSON.stringify({ patterns: getIntegrationPatterns() }, null, 2)
+	}] }));
+	server.registerPrompt(MCP_PROMPTS.instrumentApp, {
+		title: "Instrument App",
+		description: "Guided checklist for instrumenting an app with @amplitude/ai from zero to validated setup.",
+		argsSchema: {
+			framework: stringType().optional(),
+			provider: stringType().optional()
+		}
+	}, async (args) => {
+		return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: `Instrument this ${typeof args?.framework === "string" ? args.framework : "node"} app with ${typeof args?.provider === "string" ? args.provider : "openai"} using @amplitude/ai. Start from the production default: wrapper/swap integration plus ai.agent(...).session(...), choose a content tier (full/metadata_only/customer_enriched) with privacy defaults, and treat patch() only as a migration fallback. Then validate setup and annotate any uninstrumented call sites.`
+			}
+		}] };
+	});
+	return server;
+};
+const runMcpServer = async () => {
+	const server = createServer();
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+};
+
+//#endregion
+export { buildInstrumentationGuidance, createServer, runMcpServer };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":["_catalogCache: EventCatalog | undefined","z.string","z\n          .enum","z\n          .number","sources: Array<{ name: string; path: string }>","results: Array<{\n        source: string;\n        heading: string;\n        snippet: string;\n        line: number;\n        priority: number;\n      }>","content: string"],"sources":["../../src/mcp/server.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport {\n  MCP_PROMPTS,\n  MCP_RESOURCES,\n  MCP_SERVER_NAME,\n  MCP_TOOLS,\n} from './contract.js';\nimport { getIntegrationPatterns } from './patterns.js';\nimport { analyzeFileInstrumentation } from './validate-file.js';\n\ntype EventSchema = {\n  event_type: string;\n  description?: string;\n  event_properties?: Record<string, unknown>;\n};\n\ntype EventCatalog = {\n  events?: EventSchema[];\n};\n\nconst packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');\n\nlet _catalogCache: EventCatalog | undefined;\n\nconst readEventCatalog = (): EventCatalog => {\n  if (_catalogCache) return _catalogCache;\n  const filePath = join(packageRoot, 'data', 'agent_event_catalog.json');\n  const raw = readFileSync(filePath, 'utf8');\n  _catalogCache = JSON.parse(raw) as EventCatalog;\n  return _catalogCache;\n};\n\ntype ContentTier = 'full' | 'metadata_only' | 'customer_enriched';\n\nconst normalizeContentTier = (value: unknown): ContentTier => {\n  if (\n    value === 'full' ||\n    value === 'metadata_only' ||\n    value === 'customer_enriched'\n  ) {\n    return value;\n  }\n  return 'full';\n};\n\nconst buildInstrumentationGuidance = (\n  framework: string,\n  provider: string,\n  contentTier: ContentTier,\n): string[] => {\n  const providerSetup =\n    provider === 'openai' || provider === 'anthropic'\n      ? `use ${provider} wrapper/swap integration (for example: \\`new ${provider === 'openai' ? 'OpenAI' : 'Anthropic'}({ amplitude: ai, ... })\\`)`\n      : `use the ${provider} provider wrapper class from @amplitude/ai`;\n\n  const frameworkStep =\n    framework === 'express' || framework === 'koa' || framework === 'fastify'\n      ? 'wire `createAmplitudeAIMiddleware()` for per-request identity propagation and run LLM calls inside session context'\n      : framework === 'next' || framework === 'nextjs'\n        ? 'wrap route handlers in `session.run()` so every LLM call inherits user/session lineage'\n        : 'attach `ai.agent(...).session(...)` where request or conversation identity exists';\n\n  const tierGuidance =\n    contentTier === 'full'\n      ? 'Content tier (`full`): maximum insight and automatic server enrichments. Prefer `redactPii: true` (+ optional `customRedactionPatterns`).'\n      : contentTier === 'metadata_only'\n        ? 'Content tier (`metadata_only`): no content leaves your infrastructure; keep token/cost/latency/session analytics.'\n        : 'Content tier (`customer_enriched`): no content leaves infra; send your own labels via `trackSessionEnrichment(...)` for advanced analytics.';\n\n  const nextForTier =\n    contentTier === 'metadata_only'\n      ? 'if you need quality/topic analytics without sending content, move to `customer_enriched` and emit structured enrichments.'\n      : contentTier === 'customer_enriched'\n        ? 'if policy allows and you want zero eval-code overhead, consider `full` with redaction for automatic server enrichments.'\n        : 'if policy prohibits content egress, switch to `metadata_only` or `customer_enriched` without changing session instrumentation.';\n\n  return [\n    `Framework: ${framework}`,\n    `Provider: ${provider}`,\n    `Content tier: ${contentTier}`,\n    '',\n    'Now:',\n    '1) install @amplitude/ai and @amplitude/analytics-node',\n    '2) initialize `AmplitudeAI` with API key',\n    `3) ${providerSetup}`,\n    '4) bind session context with `const session = ai.agent(...).session(...)` and run calls in `session.run(...)`',\n    `5) ${frameworkStep}`,\n    '',\n    'Next:',\n    `- ${nextForTier}`,\n    '- treat `patch({ amplitudeAI: ai })` as migration quickstart, not steady-state production.',\n    '',\n    'Why:',\n    '- session lineage unlocks scoring, enrichments, and reliable product-to-AI funnels.',\n    '- wrapper/swap integration preserves fidelity while keeping implementation effort low.',\n    `- ${tierGuidance}`,\n    '- privacy controls apply before events leave your process.',\n    '',\n    'Validate:',\n    '- run `amplitude-ai doctor` and verify [Agent] session-scoped events.',\n  ];\n};\n\nconst headingPriority = (heading: string): number => {\n  const normalized = heading.toLowerCase();\n  if (\n    normalized.includes('choose your integration tier') ||\n    normalized.includes('privacy & content control')\n  ) {\n    return 3;\n  }\n  if (\n    normalized.includes('boundagent') ||\n    normalized.includes('bound agent') ||\n    normalized.includes('session')\n  ) {\n    return 2;\n  }\n  return 1;\n};\n\nconst createServer = (): McpServer => {\n  const server = new McpServer({\n    name: MCP_SERVER_NAME,\n    version: '0.1.0',\n  });\n\n  server.registerTool(\n    MCP_TOOLS.getEventSchema,\n    {\n      title: 'Get Event Schema',\n      description:\n        'Return Amplitude AI event schema and event-property definitions.',\n      inputSchema: {\n        event_type: z.string().optional(),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const eventType =\n        typeof args?.event_type === 'string' ? args.event_type : undefined;\n      const catalog = readEventCatalog();\n      const events = catalog.events ?? [];\n      const selected = eventType\n        ? events.filter((event) => event.event_type === eventType)\n        : events;\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                total: selected.length,\n                events: selected,\n              },\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    MCP_TOOLS.getIntegrationPattern,\n    {\n      title: 'Get Integration Pattern',\n      description:\n        'Return canonical instrumentation patterns for @amplitude/ai.',\n      inputSchema: {\n        id: z.string().optional(),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const id = typeof args?.id === 'string' ? args.id : undefined;\n      const patterns = getIntegrationPatterns();\n      const selected = id\n        ? patterns.filter((pattern) => pattern.id === id)\n        : patterns;\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify({ patterns: selected }, null, 2),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    MCP_TOOLS.validateSetup,\n    {\n      title: 'Validate Setup',\n      description: 'Validate environment variables required for @amplitude/ai.',\n      inputSchema: {},\n    },\n    async () => {\n      const required = ['AMPLITUDE_AI_API_KEY'];\n      const missing = required.filter((name) => !process.env[name]);\n      const status = missing.length === 0 ? 'ok' : 'missing_env';\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                status,\n                missing_env: missing,\n              },\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    MCP_TOOLS.suggestInstrumentation,\n    {\n      title: 'Suggest Instrumentation',\n      description:\n        'Suggest practical next instrumentation steps from minimal hints.',\n      inputSchema: {\n        framework: z.string().optional(),\n        provider: z.string().optional(),\n        content_tier: z\n          .enum(['full', 'metadata_only', 'customer_enriched'])\n          .optional()\n          .describe('Desired content tier (default: full)'),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const framework =\n        typeof args?.framework === 'string' ? args.framework : 'node';\n      const provider =\n        typeof args?.provider === 'string' ? args.provider : 'openai';\n      const contentTier = normalizeContentTier(args?.content_tier);\n      const guidance = buildInstrumentationGuidance(\n        framework,\n        provider,\n        contentTier,\n      );\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: guidance.join('\\n'),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    MCP_TOOLS.validateFile,\n    {\n      title: 'Validate File Instrumentation',\n      description:\n        'Analyze source code to detect LLM call sites and report which are instrumented vs uninstrumented.',\n      inputSchema: {\n        source: z.string().describe('Source code content to analyze'),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const source = typeof args?.source === 'string' ? args.source : '';\n      const result = analyzeFileInstrumentation(source);\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(result, null, 2),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    MCP_TOOLS.searchDocs,\n    {\n      title: 'Search Documentation',\n      description:\n        'Search the SDK README and API reference for a keyword or phrase. Returns matching sections with surrounding context.',\n      inputSchema: {\n        query: z.string().describe('Keyword or phrase to search for'),\n        max_results: z\n          .number()\n          .optional()\n          .describe('Maximum number of results to return (default: 5)'),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const query =\n        typeof args?.query === 'string' ? args.query.toLowerCase() : '';\n      const maxResults =\n        typeof args?.max_results === 'number' ? args.max_results : 5;\n\n      if (!query) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify({ error: 'query is required' }),\n            },\n          ],\n        };\n      }\n\n      const sources: Array<{ name: string; path: string }> = [\n        { name: 'README.md', path: join(packageRoot, 'README.md') },\n        { name: 'llms-full.txt', path: join(packageRoot, 'llms-full.txt') },\n      ];\n\n      const results: Array<{\n        source: string;\n        heading: string;\n        snippet: string;\n        line: number;\n        priority: number;\n      }> = [];\n\n      for (const { name, path } of sources) {\n        let content: string;\n        try {\n          content = readFileSync(path, 'utf8');\n        } catch {\n          continue;\n        }\n        const lines = content.split('\\n');\n        let currentHeading = '(top)';\n        for (let i = 0; i < lines.length; i++) {\n          const line = lines[i] ?? '';\n          if (line.startsWith('#')) {\n            currentHeading = line.replace(/^#+\\s*/, '');\n          }\n          if (line.toLowerCase().includes(query)) {\n            const start = Math.max(0, i - 2);\n            const end = Math.min(lines.length, i + 3);\n            results.push({\n              source: name,\n              heading: currentHeading,\n              snippet: lines.slice(start, end).join('\\n'),\n              line: i + 1,\n              priority: headingPriority(currentHeading),\n            });\n          }\n        }\n      }\n\n      results.sort((a, b) => b.priority - a.priority || a.line - b.line);\n      const selected = results.slice(0, maxResults);\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(\n              {\n                query,\n                total: selected.length,\n                results: selected.map(({ priority, ...rest }) => rest),\n              },\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerResource(\n    'event_schema',\n    MCP_RESOURCES.eventSchema,\n    {\n      title: 'Amplitude AI Event Schema',\n      description: 'Current event and property catalog for @amplitude/ai.',\n      mimeType: 'application/json',\n    },\n    async () => ({\n      contents: [\n        {\n          uri: MCP_RESOURCES.eventSchema,\n          mimeType: 'application/json',\n          text: JSON.stringify(readEventCatalog(), null, 2),\n        },\n      ],\n    }),\n  );\n\n  server.registerResource(\n    'integration_patterns',\n    MCP_RESOURCES.integrationPatterns,\n    {\n      title: 'Amplitude AI Integration Patterns',\n      description: 'Canonical setup patterns used by docs and agent workflows.',\n      mimeType: 'application/json',\n    },\n    async () => ({\n      contents: [\n        {\n          uri: MCP_RESOURCES.integrationPatterns,\n          mimeType: 'application/json',\n          text: JSON.stringify({ patterns: getIntegrationPatterns() }, null, 2),\n        },\n      ],\n    }),\n  );\n\n  server.registerPrompt(\n    MCP_PROMPTS.instrumentApp,\n    {\n      title: 'Instrument App',\n      description:\n        'Guided checklist for instrumenting an app with @amplitude/ai from zero to validated setup.',\n      argsSchema: {\n        framework: z.string().optional(),\n        provider: z.string().optional(),\n      },\n    },\n    // biome-ignore lint/suspicious/noExplicitAny: SDK callback type is intentionally broad.\n    async (args: any) => {\n      const framework =\n        typeof args?.framework === 'string' ? args.framework : 'node';\n      const provider =\n        typeof args?.provider === 'string' ? args.provider : 'openai';\n      return {\n        messages: [\n          {\n            role: 'user',\n            content: {\n              type: 'text',\n              text: `Instrument this ${framework} app with ${provider} using @amplitude/ai. Start from the production default: wrapper/swap integration plus ai.agent(...).session(...), choose a content tier (full/metadata_only/customer_enriched) with privacy defaults, and treat patch() only as a migration fallback. Then validate setup and annotate any uninstrumented call sites.`,\n            },\n          },\n        ],\n      };\n    },\n  );\n\n  return server;\n};\n\nconst runMcpServer = async (): Promise<void> => {\n  const server = createServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n};\n\nexport { buildInstrumentationGuidance, createServer, runMcpServer };\n"],"mappings":"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"}