@amplitude/ai 0.1.0

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,31 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+export { __commonJSMin, __toESM };

package/dist/bound-agent.d.ts

@@ -0,0 +1,56 @@
+import { SessionEnrichments } from "./core/enrichments.js";
+import { AmplitudeAI } from "./client.js";
+import { Session } from "./session.js";
+
+//#region src/bound-agent.d.ts
+
+type UserMessageOpts = Partial<Omit<Parameters<AmplitudeAI['trackUserMessage']>[0], 'content'>>;
+type AiMessageOpts = Partial<Omit<Parameters<AmplitudeAI['trackAiMessage']>[0], 'content' | 'model' | 'provider' | 'latencyMs'>>;
+type ToolCallOpts = Partial<Omit<Parameters<AmplitudeAI['trackToolCall']>[0], 'toolName' | 'latencyMs' | 'success'>>;
+type EmbeddingOpts = Partial<Omit<Parameters<AmplitudeAI['trackEmbedding']>[0], 'model' | 'provider' | 'latencyMs'>>;
+type SpanOpts = Partial<Omit<Parameters<AmplitudeAI['trackSpan']>[0], 'spanName' | 'latencyMs'>>;
+type SessionEndOpts = Partial<Parameters<AmplitudeAI['trackSessionEnd']>[0]>;
+type SessionEnrichmentOpts = Partial<Omit<Parameters<AmplitudeAI['trackSessionEnrichment']>[0], 'enrichments'>>;
+type ScoreOpts = Partial<Omit<Parameters<AmplitudeAI['score']>[0], 'name' | 'value' | 'targetId'>>;
+declare class BoundAgent {
+  readonly _ai: AmplitudeAI;
+  readonly _defaults: Record<string, unknown>;
+  constructor(ai: AmplitudeAI, opts: {
+    agentId: string;
+    userId?: string | null;
+    parentAgentId?: string | null;
+    customerOrgId?: string | null;
+    agentVersion?: string | null;
+    context?: Record<string, unknown> | null;
+    env?: string | null;
+    sessionId?: string | null;
+    traceId?: string | null;
+    groups?: Record<string, unknown> | null;
+    deviceId?: string | null;
+    browserSessionId?: string | null;
+  });
+  get agentId(): string;
+  get ai(): AmplitudeAI;
+  child(agentId: string, overrides?: Record<string, unknown>): BoundAgent;
+  private _merge;
+  trackUserMessage(content: string, opts?: UserMessageOpts): string;
+  trackAiMessage(content: string, model: string, provider: string, latencyMs: number, opts?: AiMessageOpts): string;
+  trackToolCall(toolName: string, latencyMs: number, success: boolean, opts?: ToolCallOpts): string;
+  trackEmbedding(model: string, provider: string, latencyMs: number, opts?: EmbeddingOpts): string;
+  trackSpan(spanName: string, latencyMs: number, opts?: SpanOpts): string;
+  trackSessionEnd(opts?: SessionEndOpts): void;
+  trackSessionEnrichment(enrichments: SessionEnrichments, opts?: SessionEnrichmentOpts): void;
+  score(name: string, value: number, targetId: string, opts?: ScoreOpts): void;
+  session(opts?: {
+    sessionId?: string | null;
+    idleTimeoutMinutes?: number | null;
+    userId?: string | null;
+    deviceId?: string | null;
+    browserSessionId?: string | null;
+  }): Session;
+  flush(): unknown;
+  shutdown(): void;
+}
+//#endregion
+export { AiMessageOpts, BoundAgent, EmbeddingOpts, ScoreOpts, SessionEndOpts, SessionEnrichmentOpts, SpanOpts, ToolCallOpts, UserMessageOpts };
+//# sourceMappingURL=bound-agent.d.ts.map

package/dist/bound-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound-agent.d.ts","names":[],"sources":["../src/bound-agent.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/bound-agent.js

@@ -0,0 +1,155 @@
+import { PROP_SESSION_REPLAY_ID } from "./core/constants.js";
+import { Session } from "./session.js";
+
+//#region src/bound-agent.ts
+const CONTEXT_FIELDS = [
+	"userId",
+	"agentId",
+	"parentAgentId",
+	"customerOrgId",
+	"agentVersion",
+	"context",
+	"env",
+	"sessionId",
+	"traceId",
+	"groups"
+];
+var BoundAgent = class BoundAgent {
+	_ai;
+	_defaults;
+	constructor(ai, opts) {
+		this._ai = ai;
+		this._defaults = {
+			userId: opts.userId ?? null,
+			agentId: opts.agentId,
+			parentAgentId: opts.parentAgentId ?? null,
+			customerOrgId: opts.customerOrgId ?? null,
+			agentVersion: opts.agentVersion ?? null,
+			context: opts.context ?? null,
+			env: opts.env ?? null,
+			sessionId: opts.sessionId ?? null,
+			traceId: opts.traceId ?? null,
+			groups: opts.groups ?? null,
+			deviceId: opts.deviceId ?? null,
+			browserSessionId: opts.browserSessionId ?? null
+		};
+	}
+	get agentId() {
+		return String(this._defaults.agentId);
+	}
+	get ai() {
+		return this._ai;
+	}
+	child(agentId, overrides = {}) {
+		const inherited = {
+			userId: this._defaults.userId,
+			env: this._defaults.env,
+			customerOrgId: this._defaults.customerOrgId,
+			agentVersion: this._defaults.agentVersion,
+			sessionId: this._defaults.sessionId,
+			traceId: this._defaults.traceId,
+			groups: this._defaults.groups,
+			deviceId: this._defaults.deviceId,
+			browserSessionId: this._defaults.browserSessionId
+		};
+		const parentCtx = this._defaults.context;
+		const childCtx = overrides.context;
+		const overrideEntries = Object.entries(overrides).filter(([k]) => k !== "context");
+		if (parentCtx || childCtx) {
+			const merged = { ...parentCtx ?? {} };
+			if (childCtx) Object.assign(merged, childCtx);
+			inherited.context = merged;
+		}
+		for (const [k, v] of overrideEntries) if (v != null) inherited[k] = v;
+		const { parentAgentId: inheritedParentAgentId, ...inheritedWithoutParent } = inherited;
+		const explicitParent = inheritedParentAgentId ?? this._defaults.agentId;
+		return new BoundAgent(this._ai, {
+			agentId,
+			parentAgentId: explicitParent,
+			...inheritedWithoutParent
+		});
+	}
+	_merge(kwargs, fields = CONTEXT_FIELDS) {
+		const merged = { ...kwargs };
+		for (const field of fields) if (merged[field] == null && this._defaults[field] != null) merged[field] = this._defaults[field];
+		const deviceId = this._defaults.deviceId;
+		const browserSessionId = this._defaults.browserSessionId;
+		if (deviceId && browserSessionId) {
+			const existingEp = merged.eventProperties;
+			const ep = existingEp != null ? { ...existingEp } : {};
+			if (!(PROP_SESSION_REPLAY_ID in ep)) {
+				ep[PROP_SESSION_REPLAY_ID] = `${deviceId}/${browserSessionId}`;
+				merged.eventProperties = ep;
+			}
+		}
+		return merged;
+	}
+	trackUserMessage(content, opts = {}) {
+		return this._ai.trackUserMessage({
+			...this._merge(opts),
+			content
+		});
+	}
+	trackAiMessage(content, model, provider, latencyMs, opts = {}) {
+		return this._ai.trackAiMessage({
+			...this._merge(opts),
+			content,
+			model,
+			provider,
+			latencyMs
+		});
+	}
+	trackToolCall(toolName, latencyMs, success, opts = {}) {
+		return this._ai.trackToolCall({
+			...this._merge(opts),
+			toolName,
+			latencyMs,
+			success
+		});
+	}
+	trackEmbedding(model, provider, latencyMs, opts = {}) {
+		return this._ai.trackEmbedding({
+			...this._merge(opts),
+			model,
+			provider,
+			latencyMs
+		});
+	}
+	trackSpan(spanName, latencyMs, opts = {}) {
+		return this._ai.trackSpan({
+			...this._merge(opts),
+			spanName,
+			latencyMs
+		});
+	}
+	trackSessionEnd(opts = {}) {
+		this._ai.trackSessionEnd(this._merge(opts));
+	}
+	trackSessionEnrichment(enrichments, opts = {}) {
+		this._ai.trackSessionEnrichment({
+			...this._merge(opts),
+			enrichments
+		});
+	}
+	score(name, value, targetId, opts = {}) {
+		this._ai.score({
+			...this._merge(opts),
+			name,
+			value,
+			targetId
+		});
+	}
+	session(opts = {}) {
+		return new Session(this, opts);
+	}
+	flush() {
+		return this._ai.flush();
+	}
+	shutdown() {
+		this._ai.shutdown();
+	}
+};
+
+//#endregion
+export { BoundAgent };
+//# sourceMappingURL=bound-agent.js.map

package/dist/bound-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound-agent.js","names":["inherited: Record<string, unknown>"],"sources":["../src/bound-agent.ts"],"sourcesContent":["/**\n * BoundAgent — agent with pre-bound defaults for tracking context fields.\n *\n * Created via `ai.agent(agentId, opts)`. All tracking calls\n * automatically inherit agentId, userId, env, and other defaults.\n */\n\nimport type { AmplitudeAI } from './client.js';\nimport type { SessionEnrichments } from './core/enrichments.js';\nimport { PROP_SESSION_REPLAY_ID } from './core/tracking.js';\nimport { Session } from './session.js';\n\nexport type UserMessageOpts = Partial<\n  Omit<Parameters<AmplitudeAI['trackUserMessage']>[0], 'content'>\n>;\n\nexport type AiMessageOpts = Partial<\n  Omit<\n    Parameters<AmplitudeAI['trackAiMessage']>[0],\n    'content' | 'model' | 'provider' | 'latencyMs'\n  >\n>;\n\nexport type ToolCallOpts = Partial<\n  Omit<\n    Parameters<AmplitudeAI['trackToolCall']>[0],\n    'toolName' | 'latencyMs' | 'success'\n  >\n>;\n\nexport type EmbeddingOpts = Partial<\n  Omit<\n    Parameters<AmplitudeAI['trackEmbedding']>[0],\n    'model' | 'provider' | 'latencyMs'\n  >\n>;\n\nexport type SpanOpts = Partial<\n  Omit<Parameters<AmplitudeAI['trackSpan']>[0], 'spanName' | 'latencyMs'>\n>;\n\nexport type SessionEndOpts = Partial<\n  Parameters<AmplitudeAI['trackSessionEnd']>[0]\n>;\n\nexport type SessionEnrichmentOpts = Partial<\n  Omit<Parameters<AmplitudeAI['trackSessionEnrichment']>[0], 'enrichments'>\n>;\n\nexport type ScoreOpts = Partial<\n  Omit<Parameters<AmplitudeAI['score']>[0], 'name' | 'value' | 'targetId'>\n>;\n\nconst CONTEXT_FIELDS = [\n  'userId',\n  'agentId',\n  'parentAgentId',\n  'customerOrgId',\n  'agentVersion',\n  'context',\n  'env',\n  'sessionId',\n  'traceId',\n  'groups',\n] as const;\n\nexport class BoundAgent {\n  readonly _ai: AmplitudeAI;\n  readonly _defaults: Record<string, unknown>;\n\n  constructor(\n    ai: AmplitudeAI,\n    opts: {\n      agentId: string;\n      userId?: string | null;\n      parentAgentId?: string | null;\n      customerOrgId?: string | null;\n      agentVersion?: string | null;\n      context?: Record<string, unknown> | null;\n      env?: string | null;\n      sessionId?: string | null;\n      traceId?: string | null;\n      groups?: Record<string, unknown> | null;\n      deviceId?: string | null;\n      browserSessionId?: string | null;\n    },\n  ) {\n    this._ai = ai;\n    this._defaults = {\n      userId: opts.userId ?? null,\n      agentId: opts.agentId,\n      parentAgentId: opts.parentAgentId ?? null,\n      customerOrgId: opts.customerOrgId ?? null,\n      agentVersion: opts.agentVersion ?? null,\n      context: opts.context ?? null,\n      env: opts.env ?? null,\n      sessionId: opts.sessionId ?? null,\n      traceId: opts.traceId ?? null,\n      groups: opts.groups ?? null,\n      deviceId: opts.deviceId ?? null,\n      browserSessionId: opts.browserSessionId ?? null,\n    };\n  }\n\n  get agentId(): string {\n    return String(this._defaults.agentId);\n  }\n\n  get ai(): AmplitudeAI {\n    return this._ai;\n  }\n\n  child(agentId: string, overrides: Record<string, unknown> = {}): BoundAgent {\n    const inherited: Record<string, unknown> = {\n      userId: this._defaults.userId,\n      env: this._defaults.env,\n      customerOrgId: this._defaults.customerOrgId,\n      agentVersion: this._defaults.agentVersion,\n      sessionId: this._defaults.sessionId,\n      traceId: this._defaults.traceId,\n      groups: this._defaults.groups,\n      deviceId: this._defaults.deviceId,\n      browserSessionId: this._defaults.browserSessionId,\n    };\n\n    const parentCtx = this._defaults.context as Record<string, unknown> | null;\n    const childCtx = overrides.context as\n      | Record<string, unknown>\n      | null\n      | undefined;\n    const overrideEntries = Object.entries(overrides).filter(\n      ([k]) => k !== 'context',\n    );\n    if (parentCtx || childCtx) {\n      const merged = { ...(parentCtx ?? {}) };\n      if (childCtx) Object.assign(merged, childCtx);\n      inherited.context = merged;\n    }\n\n    for (const [k, v] of overrideEntries) {\n      if (v != null) inherited[k] = v;\n    }\n\n    const { parentAgentId: inheritedParentAgentId, ...inheritedWithoutParent } =\n      inherited;\n    const explicitParent =\n      (inheritedParentAgentId as string | null) ??\n      (this._defaults.agentId as string);\n\n    return new BoundAgent(this._ai, {\n      agentId,\n      parentAgentId: explicitParent,\n      ...(inheritedWithoutParent as Record<string, string | null>),\n    });\n  }\n\n  private _merge<T extends Record<string, unknown>>(\n    kwargs: T,\n    fields: readonly string[] = CONTEXT_FIELDS,\n  ): T {\n    const merged = { ...kwargs } as Record<string, unknown>;\n    for (const field of fields) {\n      if (merged[field] == null && this._defaults[field] != null) {\n        merged[field] = this._defaults[field];\n      }\n    }\n    const deviceId = this._defaults.deviceId as string | null;\n    const browserSessionId = this._defaults.browserSessionId as string | null;\n    if (deviceId && browserSessionId) {\n      const existingEp = merged.eventProperties as\n        | Record<string, unknown>\n        | undefined;\n      const ep = existingEp != null ? { ...existingEp } : {};\n      if (!(PROP_SESSION_REPLAY_ID in ep)) {\n        ep[PROP_SESSION_REPLAY_ID] = `${deviceId}/${browserSessionId}`;\n        merged.eventProperties = ep;\n      }\n    }\n    return merged as T;\n  }\n\n  trackUserMessage(content: string, opts: UserMessageOpts = {}): string {\n    return this._ai.trackUserMessage({\n      ...this._merge(opts),\n      content,\n    } as Parameters<AmplitudeAI['trackUserMessage']>[0]);\n  }\n\n  trackAiMessage(\n    content: string,\n    model: string,\n    provider: string,\n    latencyMs: number,\n    opts: AiMessageOpts = {},\n  ): string {\n    return this._ai.trackAiMessage({\n      ...this._merge(opts),\n      content,\n      model,\n      provider,\n      latencyMs,\n    } as Parameters<AmplitudeAI['trackAiMessage']>[0]);\n  }\n\n  trackToolCall(\n    toolName: string,\n    latencyMs: number,\n    success: boolean,\n    opts: ToolCallOpts = {},\n  ): string {\n    return this._ai.trackToolCall({\n      ...this._merge(opts),\n      toolName,\n      latencyMs,\n      success,\n    } as Parameters<AmplitudeAI['trackToolCall']>[0]);\n  }\n\n  trackEmbedding(\n    model: string,\n    provider: string,\n    latencyMs: number,\n    opts: EmbeddingOpts = {},\n  ): string {\n    return this._ai.trackEmbedding({\n      ...this._merge(opts),\n      model,\n      provider,\n      latencyMs,\n    } as Parameters<AmplitudeAI['trackEmbedding']>[0]);\n  }\n\n  trackSpan(spanName: string, latencyMs: number, opts: SpanOpts = {}): string {\n    return this._ai.trackSpan({\n      ...this._merge(opts),\n      spanName,\n      latencyMs,\n    } as Parameters<AmplitudeAI['trackSpan']>[0]);\n  }\n\n  trackSessionEnd(opts: SessionEndOpts = {}): void {\n    this._ai.trackSessionEnd(\n      this._merge(opts) as Parameters<AmplitudeAI['trackSessionEnd']>[0],\n    );\n  }\n\n  trackSessionEnrichment(\n    enrichments: SessionEnrichments,\n    opts: SessionEnrichmentOpts = {},\n  ): void {\n    this._ai.trackSessionEnrichment({\n      ...this._merge(opts),\n      enrichments,\n    } as Parameters<AmplitudeAI['trackSessionEnrichment']>[0]);\n  }\n\n  score(\n    name: string,\n    value: number,\n    targetId: string,\n    opts: ScoreOpts = {},\n  ): void {\n    this._ai.score({\n      ...this._merge(opts),\n      name,\n      value,\n      targetId,\n    } as Parameters<AmplitudeAI['score']>[0]);\n  }\n\n  session(\n    opts: {\n      sessionId?: string | null;\n      idleTimeoutMinutes?: number | null;\n      userId?: string | null;\n      deviceId?: string | null;\n      browserSessionId?: string | null;\n    } = {},\n  ): Session {\n    return new Session(this, opts);\n  }\n\n  flush(): unknown {\n    return this._ai.flush();\n  }\n\n  shutdown(): void {\n    this._ai.shutdown();\n  }\n}\n"],"mappings":"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"}

package/dist/cli/doctor.d.ts

@@ -0,0 +1,17 @@
+//#region src/cli/doctor.d.ts
+type DoctorResult = {
+  ok: boolean;
+  checks: Array<{
+    name: string;
+    ok: boolean;
+    detail: string;
+    fix?: string;
+  }>;
+};
+type DoctorOptions = {
+  includeMockCheck?: boolean;
+};
+declare const runDoctor: (cwd: string, options?: DoctorOptions) => DoctorResult;
+//#endregion
+export { type DoctorOptions, type DoctorResult, runDoctor };
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","names":[],"sources":["../../src/cli/doctor.ts"],"sourcesContent":[],"mappings":";KAKK,YAAA;EAAA,EAAA,EAAA,OAAA;EAKA,MAAA,EAHK,KAGL,CAAA;IAgCC,IAAA,EAAA,MAkFL;;;;;;KAlHI,aAAA;;;cAgCC,mCAAmC,kBAAqB"}

package/dist/cli/doctor.js

@@ -0,0 +1,89 @@
+import { MockAmplitudeAI } from "../testing.js";
+import { PROVIDER_NPM_PACKAGES } from "./providers.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/cli/doctor.ts
+const readPackageJson = (cwd) => {
+	const path = join(cwd, "package.json");
+	if (!existsSync(path)) return null;
+	const raw = readFileSync(path, "utf8");
+	return JSON.parse(raw);
+};
+const collectDependencyNames = (packageJson) => {
+	const names = /* @__PURE__ */ new Set();
+	if (!packageJson) return names;
+	for (const field of [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies"
+	]) {
+		const value = packageJson[field];
+		if (!value || typeof value !== "object") continue;
+		for (const name of Object.keys(value)) names.add(name);
+	}
+	return names;
+};
+const runDoctor = (cwd, options = {}) => {
+	const checks = [];
+	const hasApiKey = Boolean(process.env.AMPLITUDE_AI_API_KEY);
+	checks.push({
+		name: "env.AMPLITUDE_AI_API_KEY",
+		ok: hasApiKey,
+		detail: hasApiKey ? "present" : "missing",
+		...!hasApiKey && { fix: "export AMPLITUDE_AI_API_KEY=your_project_api_key" }
+	});
+	const packageJson = readPackageJson(cwd);
+	checks.push({
+		name: "package.json",
+		ok: packageJson !== null,
+		detail: packageJson ? "found" : "missing",
+		...!packageJson && { fix: "npm init -y && npx amplitude-ai init" }
+	});
+	const depNames = collectDependencyNames(packageJson);
+	const detectedProviders = PROVIDER_NPM_PACKAGES.filter((pkg) => depNames.has(pkg));
+	checks.push({
+		name: "provider_dependency",
+		ok: detectedProviders.length > 0,
+		detail: detectedProviders.length > 0 ? `found ${detectedProviders.join(", ")}` : "no known provider package found",
+		...detectedProviders.length === 0 && { fix: "pnpm add openai  # or @anthropic-ai/sdk, @google/generative-ai" }
+	});
+	if (options.includeMockCheck ?? true) try {
+		const mock = new MockAmplitudeAI();
+		mock.trackUserMessage({
+			userId: "doctor-user",
+			content: "doctor probe",
+			sessionId: "doctor-session"
+		});
+		const userEvents = mock.getEvents("[Agent] User Message");
+		checks.push({
+			name: "mock_event_delivery",
+			ok: userEvents.length > 0,
+			detail: userEvents.length > 0 ? `captured ${userEvents.length} event(s)` : "no events captured",
+			...userEvents.length === 0 && { fix: "Ensure @amplitude/analytics-node is installed: pnpm add @amplitude/analytics-node" }
+		});
+		const flushed = mock.flush();
+		const flushOk = Array.isArray(flushed);
+		checks.push({
+			name: "mock_flush_path",
+			ok: flushOk,
+			detail: flushOk ? `flush returned ${flushed.length} item(s)` : "flush did not return an array",
+			...!flushOk && { fix: "Check that AmplitudeAI is initialized correctly and flush() is called before exit" }
+		});
+	} catch (error) {
+		checks.push({
+			name: "mock_event_delivery",
+			ok: false,
+			detail: `mock check failed: ${String(error)}`,
+			fix: "Ensure @amplitude/analytics-node is installed: pnpm add @amplitude/analytics-node"
+		});
+	}
+	return {
+		ok: checks.every((check) => check.ok),
+		checks
+	};
+};
+
+//#endregion
+export { runDoctor };
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","names":["checks: DoctorResult['checks']"],"sources":["../../src/cli/doctor.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { MockAmplitudeAI } from '../testing.js';\nimport { PROVIDER_NPM_PACKAGES } from './providers.js';\n\ntype DoctorResult = {\n  ok: boolean;\n  checks: Array<{ name: string; ok: boolean; detail: string; fix?: string }>;\n};\n\ntype DoctorOptions = {\n  includeMockCheck?: boolean;\n};\n\nconst readPackageJson = (cwd: string): Record<string, unknown> | null => {\n  const path = join(cwd, 'package.json');\n  if (!existsSync(path)) {\n    return null;\n  }\n  const raw = readFileSync(path, 'utf8');\n  return JSON.parse(raw) as Record<string, unknown>;\n};\n\nconst collectDependencyNames = (\n  packageJson: Record<string, unknown> | null,\n): Set<string> => {\n  const names = new Set<string>();\n  if (!packageJson) {\n    return names;\n  }\n  for (const field of ['dependencies', 'devDependencies', 'peerDependencies']) {\n    const value = packageJson[field];\n    if (!value || typeof value !== 'object') {\n      continue;\n    }\n    for (const name of Object.keys(value as Record<string, string>)) {\n      names.add(name);\n    }\n  }\n  return names;\n};\n\nconst runDoctor = (cwd: string, options: DoctorOptions = {}): DoctorResult => {\n  const checks: DoctorResult['checks'] = [];\n\n  const hasApiKey = Boolean(process.env.AMPLITUDE_AI_API_KEY);\n  checks.push({\n    name: 'env.AMPLITUDE_AI_API_KEY',\n    ok: hasApiKey,\n    detail: hasApiKey ? 'present' : 'missing',\n    ...(!hasApiKey && {\n      fix: 'export AMPLITUDE_AI_API_KEY=your_project_api_key',\n    }),\n  });\n\n  const packageJson = readPackageJson(cwd);\n  checks.push({\n    name: 'package.json',\n    ok: packageJson !== null,\n    detail: packageJson ? 'found' : 'missing',\n    ...(!packageJson && { fix: 'npm init -y && npx amplitude-ai init' }),\n  });\n\n  const depNames = collectDependencyNames(packageJson);\n  const detectedProviders = PROVIDER_NPM_PACKAGES.filter((pkg) =>\n    depNames.has(pkg),\n  );\n  checks.push({\n    name: 'provider_dependency',\n    ok: detectedProviders.length > 0,\n    detail:\n      detectedProviders.length > 0\n        ? `found ${detectedProviders.join(', ')}`\n        : 'no known provider package found',\n    ...(detectedProviders.length === 0 && {\n      fix: 'pnpm add openai  # or @anthropic-ai/sdk, @google/generative-ai',\n    }),\n  });\n\n  if (options.includeMockCheck ?? true) {\n    try {\n      const mock = new MockAmplitudeAI();\n      mock.trackUserMessage({\n        userId: 'doctor-user',\n        content: 'doctor probe',\n        sessionId: 'doctor-session',\n      });\n      const userEvents = mock.getEvents('[Agent] User Message');\n      checks.push({\n        name: 'mock_event_delivery',\n        ok: userEvents.length > 0,\n        detail:\n          userEvents.length > 0\n            ? `captured ${userEvents.length} event(s)`\n            : 'no events captured',\n        ...(userEvents.length === 0 && {\n          fix: 'Ensure @amplitude/analytics-node is installed: pnpm add @amplitude/analytics-node',\n        }),\n      });\n\n      const flushed = mock.flush();\n      const flushOk = Array.isArray(flushed);\n      checks.push({\n        name: 'mock_flush_path',\n        ok: flushOk,\n        detail: flushOk\n          ? `flush returned ${flushed.length} item(s)`\n          : 'flush did not return an array',\n        ...(!flushOk && {\n          fix: 'Check that AmplitudeAI is initialized correctly and flush() is called before exit',\n        }),\n      });\n    } catch (error) {\n      checks.push({\n        name: 'mock_event_delivery',\n        ok: false,\n        detail: `mock check failed: ${String(error)}`,\n        fix: 'Ensure @amplitude/analytics-node is installed: pnpm add @amplitude/analytics-node',\n      });\n    }\n  }\n\n  const ok = checks.every((check) => check.ok);\n  return { ok, checks };\n};\n\nexport { runDoctor, type DoctorResult, type DoctorOptions };\n"],"mappings":";;;;;;AAcA,MAAM,mBAAmB,QAAgD;CACvE,MAAM,OAAO,KAAK,KAAK,eAAe;AACtC,KAAI,CAAC,WAAW,KAAK,CACnB,QAAO;CAET,MAAM,MAAM,aAAa,MAAM,OAAO;AACtC,QAAO,KAAK,MAAM,IAAI;;AAGxB,MAAM,0BACJ,gBACgB;CAChB,MAAM,wBAAQ,IAAI,KAAa;AAC/B,KAAI,CAAC,YACH,QAAO;AAET,MAAK,MAAM,SAAS;EAAC;EAAgB;EAAmB;EAAmB,EAAE;EAC3E,MAAM,QAAQ,YAAY;AAC1B,MAAI,CAAC,SAAS,OAAO,UAAU,SAC7B;AAEF,OAAK,MAAM,QAAQ,OAAO,KAAK,MAAgC,CAC7D,OAAM,IAAI,KAAK;;AAGnB,QAAO;;AAGT,MAAM,aAAa,KAAa,UAAyB,EAAE,KAAmB;CAC5E,MAAMA,SAAiC,EAAE;CAEzC,MAAM,YAAY,QAAQ,QAAQ,IAAI,qBAAqB;AAC3D,QAAO,KAAK;EACV,MAAM;EACN,IAAI;EACJ,QAAQ,YAAY,YAAY;EAChC,GAAI,CAAC,aAAa,EAChB,KAAK,oDACN;EACF,CAAC;CAEF,MAAM,cAAc,gBAAgB,IAAI;AACxC,QAAO,KAAK;EACV,MAAM;EACN,IAAI,gBAAgB;EACpB,QAAQ,cAAc,UAAU;EAChC,GAAI,CAAC,eAAe,EAAE,KAAK,wCAAwC;EACpE,CAAC;CAEF,MAAM,WAAW,uBAAuB,YAAY;CACpD,MAAM,oBAAoB,sBAAsB,QAAQ,QACtD,SAAS,IAAI,IAAI,CAClB;AACD,QAAO,KAAK;EACV,MAAM;EACN,IAAI,kBAAkB,SAAS;EAC/B,QACE,kBAAkB,SAAS,IACvB,SAAS,kBAAkB,KAAK,KAAK,KACrC;EACN,GAAI,kBAAkB,WAAW,KAAK,EACpC,KAAK,kEACN;EACF,CAAC;AAEF,KAAI,QAAQ,oBAAoB,KAC9B,KAAI;EACF,MAAM,OAAO,IAAI,iBAAiB;AAClC,OAAK,iBAAiB;GACpB,QAAQ;GACR,SAAS;GACT,WAAW;GACZ,CAAC;EACF,MAAM,aAAa,KAAK,UAAU,uBAAuB;AACzD,SAAO,KAAK;GACV,MAAM;GACN,IAAI,WAAW,SAAS;GACxB,QACE,WAAW,SAAS,IAChB,YAAY,WAAW,OAAO,aAC9B;GACN,GAAI,WAAW,WAAW,KAAK,EAC7B,KAAK,qFACN;GACF,CAAC;EAEF,MAAM,UAAU,KAAK,OAAO;EAC5B,MAAM,UAAU,MAAM,QAAQ,QAAQ;AACtC,SAAO,KAAK;GACV,MAAM;GACN,IAAI;GACJ,QAAQ,UACJ,kBAAkB,QAAQ,OAAO,YACjC;GACJ,GAAI,CAAC,WAAW,EACd,KAAK,qFACN;GACF,CAAC;UACK,OAAO;AACd,SAAO,KAAK;GACV,MAAM;GACN,IAAI;GACJ,QAAQ,sBAAsB,OAAO,MAAM;GAC3C,KAAK;GACN,CAAC;;AAKN,QAAO;EAAE,IADE,OAAO,OAAO,UAAU,MAAM,GAAG;EAC/B;EAAQ"}

package/dist/cli/init.d.ts

@@ -0,0 +1,14 @@
+//#region src/cli/init.d.ts
+type InitOptions = {
+  cwd: string;
+  force: boolean;
+  dryRun: boolean;
+};
+type InitResult = {
+  created: string[];
+  skipped: string[];
+};
+declare const runInit: (options: InitOptions) => InitResult;
+//#endregion
+export { type InitOptions, type InitResult, runInit };
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/cli/init.ts"],"sourcesContent":[],"mappings":";KAGK,WAAA;EAAA,GAAA,EAAA,MAAA;EAMA,KAAA,EAAA,OAAU;EAqBT,MAAA,EAAA,OAmBL;;KAxCI,UAAA;;;;cAqBC,mBAAoB,gBAAc"}

package/dist/cli/init.js

@@ -0,0 +1,40 @@
+import { existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/cli/init.ts
+const INIT_FILES = {
+	".env.example": [
+		"AMPLITUDE_AI_API_KEY=your_project_api_key",
+		"AMPLITUDE_AI_AUTO_PATCH=true",
+		""
+	].join("\n"),
+	"amplitude-ai.setup.ts": [
+		"import { AmplitudeAI } from \"@amplitude/ai\";",
+		"",
+		"export const amplitudeAI = new AmplitudeAI({",
+		"  apiKey: process.env.AMPLITUDE_AI_API_KEY ?? \"\",",
+		"});",
+		""
+	].join("\n")
+};
+const runInit = (options) => {
+	const created = [];
+	const skipped = [];
+	for (const [relativePath, contents] of Object.entries(INIT_FILES)) {
+		const absolutePath = join(options.cwd, relativePath);
+		if (existsSync(absolutePath) && !options.force) {
+			skipped.push(relativePath);
+			continue;
+		}
+		if (!options.dryRun) writeFileSync(absolutePath, contents, "utf8");
+		created.push(relativePath);
+	}
+	return {
+		created,
+		skipped
+	};
+};
+
+//#endregion
+export { runInit };
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","names":["INIT_FILES: Record<string, string>","created: string[]","skipped: string[]"],"sources":["../../src/cli/init.ts"],"sourcesContent":["import { existsSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\ntype InitOptions = {\n  cwd: string;\n  force: boolean;\n  dryRun: boolean;\n};\n\ntype InitResult = {\n  created: string[];\n  skipped: string[];\n};\n\nconst INIT_FILES: Record<string, string> = {\n  '.env.example': [\n    'AMPLITUDE_AI_API_KEY=your_project_api_key',\n    'AMPLITUDE_AI_AUTO_PATCH=true',\n    '',\n  ].join('\\n'),\n  'amplitude-ai.setup.ts': [\n    'import { AmplitudeAI } from \"@amplitude/ai\";',\n    '',\n    'export const amplitudeAI = new AmplitudeAI({',\n    '  apiKey: process.env.AMPLITUDE_AI_API_KEY ?? \"\",',\n    '});',\n    '',\n  ].join('\\n'),\n};\n\nconst runInit = (options: InitOptions): InitResult => {\n  const created: string[] = [];\n  const skipped: string[] = [];\n\n  for (const [relativePath, contents] of Object.entries(INIT_FILES)) {\n    const absolutePath = join(options.cwd, relativePath);\n    const alreadyExists = existsSync(absolutePath);\n    if (alreadyExists && !options.force) {\n      skipped.push(relativePath);\n      continue;\n    }\n\n    if (!options.dryRun) {\n      writeFileSync(absolutePath, contents, 'utf8');\n    }\n    created.push(relativePath);\n  }\n\n  return { created, skipped };\n};\n\nexport { runInit, type InitOptions, type InitResult };\n"],"mappings":";;;;AAcA,MAAMA,aAAqC;CACzC,gBAAgB;EACd;EACA;EACA;EACD,CAAC,KAAK,KAAK;CACZ,yBAAyB;EACvB;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;CACb;AAED,MAAM,WAAW,YAAqC;CACpD,MAAMC,UAAoB,EAAE;CAC5B,MAAMC,UAAoB,EAAE;AAE5B,MAAK,MAAM,CAAC,cAAc,aAAa,OAAO,QAAQ,WAAW,EAAE;EACjE,MAAM,eAAe,KAAK,QAAQ,KAAK,aAAa;AAEpD,MADsB,WAAW,aAAa,IACzB,CAAC,QAAQ,OAAO;AACnC,WAAQ,KAAK,aAAa;AAC1B;;AAGF,MAAI,CAAC,QAAQ,OACX,eAAc,cAAc,UAAU,OAAO;AAE/C,UAAQ,KAAK,aAAa;;AAG5B,QAAO;EAAE;EAAS;EAAS"}

package/dist/cli/providers.d.ts

@@ -0,0 +1,32 @@
+//#region src/cli/providers.d.ts
+/**
+ * Single source of truth for provider npm package names.
+ * Used by both doctor.ts and status.ts to avoid drift.
+ */
+declare const PROVIDER_NPM_PACKAGES: readonly ["openai", "@anthropic-ai/sdk", "@google/generative-ai", "@mistralai/mistralai", "@aws-sdk/client-bedrock-runtime"];
+/**
+ * Provider entries with friendly names for status display.
+ * azure-openai shares the openai npm package.
+ */
+declare const PROVIDER_ENTRIES: readonly [{
+  readonly name: "openai";
+  readonly npm: "openai";
+}, {
+  readonly name: "anthropic";
+  readonly npm: "@anthropic-ai/sdk";
+}, {
+  readonly name: "gemini";
+  readonly npm: "@google/generative-ai";
+}, {
+  readonly name: "azure-openai";
+  readonly npm: "openai";
+}, {
+  readonly name: "bedrock";
+  readonly npm: "@aws-sdk/client-bedrock-runtime";
+}, {
+  readonly name: "mistral";
+  readonly npm: "@mistralai/mistralai";
+}];
+//#endregion
+export { PROVIDER_ENTRIES, PROVIDER_NPM_PACKAGES };
+//# sourceMappingURL=providers.d.ts.map

package/dist/cli/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","names":[],"sources":["../../src/cli/providers.ts"],"sourcesContent":[],"mappings":";;AAIA;AAYA;;cAZa;;;;;cAYA"}

package/dist/cli/providers.js

@@ -0,0 +1,46 @@
+//#region src/cli/providers.ts
+/**
+* Single source of truth for provider npm package names.
+* Used by both doctor.ts and status.ts to avoid drift.
+*/
+const PROVIDER_NPM_PACKAGES = [
+	"openai",
+	"@anthropic-ai/sdk",
+	"@google/generative-ai",
+	"@mistralai/mistralai",
+	"@aws-sdk/client-bedrock-runtime"
+];
+/**
+* Provider entries with friendly names for status display.
+* azure-openai shares the openai npm package.
+*/
+const PROVIDER_ENTRIES = [
+	{
+		name: "openai",
+		npm: "openai"
+	},
+	{
+		name: "anthropic",
+		npm: "@anthropic-ai/sdk"
+	},
+	{
+		name: "gemini",
+		npm: "@google/generative-ai"
+	},
+	{
+		name: "azure-openai",
+		npm: "openai"
+	},
+	{
+		name: "bedrock",
+		npm: "@aws-sdk/client-bedrock-runtime"
+	},
+	{
+		name: "mistral",
+		npm: "@mistralai/mistralai"
+	}
+];
+
+//#endregion
+export { PROVIDER_ENTRIES, PROVIDER_NPM_PACKAGES };
+//# sourceMappingURL=providers.js.map

package/dist/cli/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","names":[],"sources":["../../src/cli/providers.ts"],"sourcesContent":["/**\n * Single source of truth for provider npm package names.\n * Used by both doctor.ts and status.ts to avoid drift.\n */\nexport const PROVIDER_NPM_PACKAGES = [\n  'openai',\n  '@anthropic-ai/sdk',\n  '@google/generative-ai',\n  '@mistralai/mistralai',\n  '@aws-sdk/client-bedrock-runtime',\n] as const;\n\n/**\n * Provider entries with friendly names for status display.\n * azure-openai shares the openai npm package.\n */\nexport const PROVIDER_ENTRIES = [\n  { name: 'openai', npm: 'openai' },\n  { name: 'anthropic', npm: '@anthropic-ai/sdk' },\n  { name: 'gemini', npm: '@google/generative-ai' },\n  { name: 'azure-openai', npm: 'openai' },\n  { name: 'bedrock', npm: '@aws-sdk/client-bedrock-runtime' },\n  { name: 'mistral', npm: '@mistralai/mistralai' },\n] as const;\n"],"mappings":";;;;;AAIA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACD;;;;;AAMD,MAAa,mBAAmB;CAC9B;EAAE,MAAM;EAAU,KAAK;EAAU;CACjC;EAAE,MAAM;EAAa,KAAK;EAAqB;CAC/C;EAAE,MAAM;EAAU,KAAK;EAAyB;CAChD;EAAE,MAAM;EAAgB,KAAK;EAAU;CACvC;EAAE,MAAM;EAAW,KAAK;EAAmC;CAC3D;EAAE,MAAM;EAAW,KAAK;EAAwB;CACjD"}

package/dist/cli/status.d.ts

@@ -0,0 +1,14 @@
+//#region src/cli/status.d.ts
+type StatusResult = {
+  version: string;
+  providers: Array<{
+    name: string;
+    installed: boolean;
+  }>;
+  env: Record<string, boolean>;
+  patchActive: boolean;
+};
+declare const runStatus: (cwd: string) => StatusResult;
+//#endregion
+export { type StatusResult, runStatus };
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","names":[],"sources":["../../src/cli/status.ts"],"sourcesContent":[],"mappings":";KAIK,YAAA;EAAA,OAAA,EAAA,MAAY;EAYX,SAAA,EAVO,KAkDZ,CAAA;;;;OAjDM;;;cASD,4BAA2B"}

package/dist/cli/status.js

@@ -0,0 +1,38 @@
+import { PROVIDER_ENTRIES } from "./providers.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/cli/status.ts
+const isPackageInstalled = (cwd, pkg) => {
+	return existsSync(join(cwd, "node_modules", ...pkg.split("/")));
+};
+const runStatus = (cwd) => {
+	let version = "unknown";
+	try {
+		const pkgPath = join(cwd, "node_modules", "@amplitude", "ai", "package.json");
+		if (existsSync(pkgPath)) version = JSON.parse(readFileSync(pkgPath, "utf8")).version ?? "unknown";
+	} catch {}
+	const installedCache = /* @__PURE__ */ new Map();
+	const providers = PROVIDER_ENTRIES.map(({ name, npm }) => {
+		if (!installedCache.has(npm)) installedCache.set(npm, isPackageInstalled(cwd, npm));
+		return {
+			name,
+			installed: installedCache.get(npm) ?? false
+		};
+	});
+	const env = {
+		AMPLITUDE_AI_API_KEY: Boolean(process.env.AMPLITUDE_AI_API_KEY),
+		AMPLITUDE_AI_CONTENT_MODE: Boolean(process.env.AMPLITUDE_AI_CONTENT_MODE),
+		AMPLITUDE_AI_DEBUG: Boolean(process.env.AMPLITUDE_AI_DEBUG)
+	};
+	return {
+		version,
+		providers,
+		env,
+		patchActive: false
+	};
+};
+
+//#endregion
+export { runStatus };
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","names":["env: Record<string, boolean>"],"sources":["../../src/cli/status.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { PROVIDER_ENTRIES } from './providers.js';\n\ntype StatusResult = {\n  version: string;\n  providers: Array<{ name: string; installed: boolean }>;\n  env: Record<string, boolean>;\n  patchActive: boolean;\n};\n\nconst isPackageInstalled = (cwd: string, pkg: string): boolean => {\n  const nmPath = join(cwd, 'node_modules', ...pkg.split('/'));\n  return existsSync(nmPath);\n};\n\nconst runStatus = (cwd: string): StatusResult => {\n  let version = 'unknown';\n  try {\n    const pkgPath = join(\n      cwd,\n      'node_modules',\n      '@amplitude',\n      'ai',\n      'package.json',\n    );\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as {\n        version?: string;\n      };\n      version = pkg.version ?? 'unknown';\n    }\n  } catch {\n    // fall through\n  }\n\n  const installedCache = new Map<string, boolean>();\n  const providers = PROVIDER_ENTRIES.map(({ name, npm }) => {\n    if (!installedCache.has(npm)) {\n      installedCache.set(npm, isPackageInstalled(cwd, npm));\n    }\n    return { name, installed: installedCache.get(npm) ?? false };\n  });\n\n  const env: Record<string, boolean> = {\n    AMPLITUDE_AI_API_KEY: Boolean(process.env.AMPLITUDE_AI_API_KEY),\n    AMPLITUDE_AI_CONTENT_MODE: Boolean(process.env.AMPLITUDE_AI_CONTENT_MODE),\n    AMPLITUDE_AI_DEBUG: Boolean(process.env.AMPLITUDE_AI_DEBUG),\n  };\n\n  return {\n    version,\n    providers,\n    env,\n    patchActive: false,\n  };\n};\n\nexport { runStatus, type StatusResult };\n"],"mappings":";;;;;AAWA,MAAM,sBAAsB,KAAa,QAAyB;AAEhE,QAAO,WADQ,KAAK,KAAK,gBAAgB,GAAG,IAAI,MAAM,IAAI,CAAC,CAClC;;AAG3B,MAAM,aAAa,QAA8B;CAC/C,IAAI,UAAU;AACd,KAAI;EACF,MAAM,UAAU,KACd,KACA,gBACA,cACA,MACA,eACD;AACD,MAAI,WAAW,QAAQ,CAIrB,WAHY,KAAK,MAAM,aAAa,SAAS,OAAO,CAAC,CAGvC,WAAW;SAErB;CAIR,MAAM,iCAAiB,IAAI,KAAsB;CACjD,MAAM,YAAY,iBAAiB,KAAK,EAAE,MAAM,UAAU;AACxD,MAAI,CAAC,eAAe,IAAI,IAAI,CAC1B,gBAAe,IAAI,KAAK,mBAAmB,KAAK,IAAI,CAAC;AAEvD,SAAO;GAAE;GAAM,WAAW,eAAe,IAAI,IAAI,IAAI;GAAO;GAC5D;CAEF,MAAMA,MAA+B;EACnC,sBAAsB,QAAQ,QAAQ,IAAI,qBAAqB;EAC/D,2BAA2B,QAAQ,QAAQ,IAAI,0BAA0B;EACzE,oBAAoB,QAAQ,QAAQ,IAAI,mBAAmB;EAC5D;AAED,QAAO;EACL;EACA;EACA;EACA,aAAa;EACd"}