@amplitude/ai 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+import { PrivacyConfig } from "./core/privacy.js";
+
+//#region src/config.d.ts
+
+/**
+ * Content privacy mode for LLM message tracking.
+ *
+ * - `FULL`: Capture complete message content (default).
+ * - `METADATA_ONLY`: Strip content, keep token counts and metadata.
+ * - `CUSTOMER_ENRICHED`: Let customer enrich events post-hoc.
+ *
+ * Both `ContentMode.FULL` (const accessor) and `'full'` (string literal)
+ * are valid — they produce the same value.
+ */
+type ContentMode = 'full' | 'metadata_only' | 'customer_enriched';
+declare const ContentMode: {
+  readonly FULL: ContentMode;
+  readonly METADATA_ONLY: ContentMode;
+  readonly CUSTOMER_ENRICHED: ContentMode;
+};
+interface AIConfigOptions {
+  contentMode?: ContentMode;
+  redactPii?: boolean;
+  customRedactionPatterns?: string[];
+  onEventCallback?: (event: unknown, statusCode: number, message: string | null) => void;
+  debug?: boolean;
+  dryRun?: boolean;
+  validate?: boolean;
+  propagateContext?: boolean;
+}
+/**
+ * Configuration for the Amplitude AI SDK.
+ *
+ * Controls content capture mode, PII redaction, debug output,
+ * and validation behavior.
+ *
+ * @example
+ * ```typescript
+ * const config = new AIConfig({
+ *   contentMode: ContentMode.METADATA_ONLY,
+ *   redactPii: true,
+ *   debug: true,
+ * });
+ * ```
+ */
+declare class AIConfig {
+  readonly contentMode: ContentMode;
+  readonly redactPii: boolean;
+  readonly customRedactionPatterns: string[];
+  readonly onEventCallback: ((event: unknown, statusCode: number, message: string | null) => void) | null;
+  readonly debug: boolean;
+  readonly dryRun: boolean;
+  readonly validate: boolean;
+  readonly propagateContext: boolean;
+  constructor(options?: AIConfigOptions);
+  toPrivacyConfig(): PrivacyConfig;
+}
+//#endregion
+export { AIConfig, AIConfigOptions, ContentMode };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;AAEA;;;;;AAMA;AA8BA;AACwB,KAvCZ,WAAA,GAuCY,MAAA,GAAA,eAAA,GAAA,mBAAA;AAWD,cAhDV,WAgDU,EAAA;EAWF,SAAA,IAAA,EA1DH,WA0DG;EAAa,SAAA,aAAA,EAzDE,WAyDF;8BAxDU;;UAG3B,eAAA;gBACD;;;;;;;;;;;;;;;;;;;;;;;;cA6BH,QAAA;wBACW;;;;;;;;wBAWD;qBAWF"}

package/dist/config.js

@@ -0,0 +1,57 @@
+import { PrivacyConfig } from "./core/privacy.js";
+
+//#region src/config.ts
+const ContentMode = {
+	FULL: "full",
+	METADATA_ONLY: "metadata_only",
+	CUSTOMER_ENRICHED: "customer_enriched"
+};
+/**
+* Configuration for the Amplitude AI SDK.
+*
+* Controls content capture mode, PII redaction, debug output,
+* and validation behavior.
+*
+* @example
+* ```typescript
+* const config = new AIConfig({
+*   contentMode: ContentMode.METADATA_ONLY,
+*   redactPii: true,
+*   debug: true,
+* });
+* ```
+*/
+var AIConfig = class {
+	contentMode;
+	redactPii;
+	customRedactionPatterns;
+	onEventCallback;
+	debug;
+	dryRun;
+	validate;
+	propagateContext;
+	constructor(options = {}) {
+		this.contentMode = options.contentMode ?? ContentMode.FULL;
+		this.redactPii = options.redactPii ?? false;
+		this.customRedactionPatterns = options.customRedactionPatterns ?? [];
+		this.onEventCallback = options.onEventCallback ?? null;
+		this.debug = options.debug ?? false;
+		this.dryRun = options.dryRun ?? false;
+		this.validate = options.validate ?? false;
+		this.propagateContext = options.propagateContext ?? false;
+	}
+	toPrivacyConfig() {
+		return new PrivacyConfig({
+			privacyMode: this.contentMode === ContentMode.METADATA_ONLY || this.contentMode === ContentMode.CUSTOMER_ENRICHED,
+			redactPii: this.redactPii,
+			customRedactionPatterns: this.customRedactionPatterns,
+			contentMode: this.contentMode,
+			validate: this.validate,
+			debug: this.debug
+		});
+	}
+};
+
+//#endregion
+export { AIConfig, ContentMode };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { PrivacyConfig } from './core/privacy.js';\n\n/**\n * Content privacy mode for LLM message tracking.\n *\n * - `FULL`: Capture complete message content (default).\n * - `METADATA_ONLY`: Strip content, keep token counts and metadata.\n * - `CUSTOMER_ENRICHED`: Let customer enrich events post-hoc.\n *\n * Both `ContentMode.FULL` (const accessor) and `'full'` (string literal)\n * are valid — they produce the same value.\n */\nexport type ContentMode = 'full' | 'metadata_only' | 'customer_enriched';\n\nexport const ContentMode = {\n  FULL: 'full' as ContentMode,\n  METADATA_ONLY: 'metadata_only' as ContentMode,\n  CUSTOMER_ENRICHED: 'customer_enriched' as ContentMode,\n} as const;\n\nexport interface AIConfigOptions {\n  contentMode?: ContentMode;\n  redactPii?: boolean;\n  customRedactionPatterns?: string[];\n  onEventCallback?: (\n    event: unknown,\n    statusCode: number,\n    message: string | null,\n  ) => void;\n  debug?: boolean;\n  dryRun?: boolean;\n  validate?: boolean;\n  propagateContext?: boolean;\n}\n\n/**\n * Configuration for the Amplitude AI SDK.\n *\n * Controls content capture mode, PII redaction, debug output,\n * and validation behavior.\n *\n * @example\n * ```typescript\n * const config = new AIConfig({\n *   contentMode: ContentMode.METADATA_ONLY,\n *   redactPii: true,\n *   debug: true,\n * });\n * ```\n */\nexport class AIConfig {\n  readonly contentMode: ContentMode;\n  readonly redactPii: boolean;\n  readonly customRedactionPatterns: string[];\n  readonly onEventCallback:\n    | ((event: unknown, statusCode: number, message: string | null) => void)\n    | null;\n  readonly debug: boolean;\n  readonly dryRun: boolean;\n  readonly validate: boolean;\n  readonly propagateContext: boolean;\n\n  constructor(options: AIConfigOptions = {}) {\n    this.contentMode = options.contentMode ?? ContentMode.FULL;\n    this.redactPii = options.redactPii ?? false;\n    this.customRedactionPatterns = options.customRedactionPatterns ?? [];\n    this.onEventCallback = options.onEventCallback ?? null;\n    this.debug = options.debug ?? false;\n    this.dryRun = options.dryRun ?? false;\n    this.validate = options.validate ?? false;\n    this.propagateContext = options.propagateContext ?? false;\n  }\n\n  toPrivacyConfig(): PrivacyConfig {\n    const privacyMode =\n      this.contentMode === ContentMode.METADATA_ONLY ||\n      this.contentMode === ContentMode.CUSTOMER_ENRICHED;\n\n    return new PrivacyConfig({\n      privacyMode,\n      redactPii: this.redactPii,\n      customRedactionPatterns: this.customRedactionPatterns,\n      contentMode: this.contentMode,\n      validate: this.validate,\n      debug: this.debug,\n    });\n  }\n}\n"],"mappings":";;;AAcA,MAAa,cAAc;CACzB,MAAM;CACN,eAAe;CACf,mBAAmB;CACpB;;;;;;;;;;;;;;;;AAgCD,IAAa,WAAb,MAAsB;CACpB,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAGT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAET,YAAY,UAA2B,EAAE,EAAE;AACzC,OAAK,cAAc,QAAQ,eAAe,YAAY;AACtD,OAAK,YAAY,QAAQ,aAAa;AACtC,OAAK,0BAA0B,QAAQ,2BAA2B,EAAE;AACpE,OAAK,kBAAkB,QAAQ,mBAAmB;AAClD,OAAK,QAAQ,QAAQ,SAAS;AAC9B,OAAK,SAAS,QAAQ,UAAU;AAChC,OAAK,WAAW,QAAQ,YAAY;AACpC,OAAK,mBAAmB,QAAQ,oBAAoB;;CAGtD,kBAAiC;AAK/B,SAAO,IAAI,cAAc;GACvB,aAJA,KAAK,gBAAgB,YAAY,iBACjC,KAAK,gBAAgB,YAAY;GAIjC,WAAW,KAAK;GAChB,yBAAyB,KAAK;GAC9B,aAAa,KAAK;GAClB,UAAU,KAAK;GACf,OAAO,KAAK;GACb,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,44 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/context.d.ts
+interface SessionContextOptions {
+  sessionId: string;
+  traceId?: string | null;
+  userId?: string | null;
+  agentId?: string | null;
+  parentAgentId?: string | null;
+  env?: string | null;
+  customerOrgId?: string | null;
+  agentVersion?: string | null;
+  context?: Record<string, unknown> | null;
+  groups?: Record<string, unknown> | null;
+  idleTimeoutMinutes?: number | null;
+  deviceId?: string | null;
+  browserSessionId?: string | null;
+  nextTurnIdFn?: (() => number) | null;
+}
+declare class SessionContext {
+  readonly sessionId: string;
+  traceId: string | null;
+  readonly userId: string | null;
+  readonly agentId: string | null;
+  readonly parentAgentId: string | null;
+  readonly env: string | null;
+  readonly customerOrgId: string | null;
+  readonly agentVersion: string | null;
+  readonly context: Record<string, unknown> | null;
+  readonly groups: Record<string, unknown> | null;
+  readonly idleTimeoutMinutes: number | null;
+  readonly deviceId: string | null;
+  readonly browserSessionId: string | null;
+  private readonly _nextTurnIdFn;
+  constructor(options: SessionContextOptions);
+  nextTurnId(): number | null;
+}
+declare const _sessionStorage: AsyncLocalStorage<SessionContext | null>;
+declare function getActiveContext(): SessionContext | null;
+declare function runWithContext<T>(ctx: SessionContext, fn: () => T): T;
+declare function runWithContextAsync<T>(ctx: SessionContext, fn: () => Promise<T>): Promise<T>;
+//#endregion
+export { SessionContext, SessionContextOptions, _sessionStorage, getActiveContext, runWithContext, runWithContextAsync };
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../src/context.ts"],"sourcesContent":[],"mappings":";;;UAEiB,qBAAA;;EAAA,OAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAiBJ,MAAA,CAAA,EAAA,MAAA,GAAc,IAAA;EASP,OAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EACD,aAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAMI,GAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAqB,aAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAuBtC,YAAA,CAAA,EAAA,MAAgE,GAAA,IAAA;EAEtD,OAAA,CAAA,EAjDJ,MAiDI,CAAA,MAAgB,EAAA,OAAI,CAAA,GAAA,IAAA;EAIpB,MAAA,CAAA,EApDL,MAoDK,CAAA,MAAc,EAAA,OAAA,CAAA,GAAA,IAAA;EAAS,kBAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAA0B,QAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAI,gBAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAC,YAAA,CAAA,EAAA,CAAA,GAAA,GAAA,MAAA,CAAA,GAAA,IAAA;AAItE;AACO,cAlDM,cAAA,CAkDN;EACa,SAAA,SAAA,EAAA,MAAA;EAAR,OAAA,EAAA,MAAA,GAAA,IAAA;EACD,SAAA,MAAA,EAAA,MAAA,GAAA,IAAA;EAAR,SAAA,OAAA,EAAA,MAAA,GAAA,IAAA;EAAO,SAAA,aAAA,EAAA,MAAA,GAAA,IAAA;;;;oBA3CU;mBACD;;;;;uBAMI;;;cAuBjB,iBAAe,kBAAA;iBAEL,gBAAA,CAAA,GAAoB;iBAIpB,uBAAuB,0BAA0B,IAAI;iBAIrD,4BACT,0BACK,QAAQ,KACjB,QAAQ"}

package/dist/context.js

@@ -0,0 +1,53 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/context.ts
+var SessionContext = class {
+	sessionId;
+	traceId;
+	userId;
+	agentId;
+	parentAgentId;
+	env;
+	customerOrgId;
+	agentVersion;
+	context;
+	groups;
+	idleTimeoutMinutes;
+	deviceId;
+	browserSessionId;
+	_nextTurnIdFn;
+	constructor(options) {
+		this.sessionId = options.sessionId;
+		this.traceId = options.traceId ?? null;
+		this.userId = options.userId ?? null;
+		this.agentId = options.agentId ?? null;
+		this.parentAgentId = options.parentAgentId ?? null;
+		this.env = options.env ?? null;
+		this.customerOrgId = options.customerOrgId ?? null;
+		this.agentVersion = options.agentVersion ?? null;
+		this.context = options.context ?? null;
+		this.groups = options.groups ?? null;
+		this.idleTimeoutMinutes = options.idleTimeoutMinutes ?? null;
+		this.deviceId = options.deviceId ?? null;
+		this.browserSessionId = options.browserSessionId ?? null;
+		this._nextTurnIdFn = options.nextTurnIdFn ?? null;
+	}
+	nextTurnId() {
+		if (this._nextTurnIdFn != null) return this._nextTurnIdFn();
+		return null;
+	}
+};
+const _sessionStorage = new AsyncLocalStorage();
+function getActiveContext() {
+	return _sessionStorage.getStore() ?? null;
+}
+function runWithContext(ctx, fn) {
+	return _sessionStorage.run(ctx, fn);
+}
+function runWithContextAsync(ctx, fn) {
+	return _sessionStorage.run(ctx, fn);
+}
+
+//#endregion
+export { SessionContext, _sessionStorage, getActiveContext, runWithContext, runWithContextAsync };
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface SessionContextOptions {\n  sessionId: string;\n  traceId?: string | null;\n  userId?: string | null;\n  agentId?: string | null;\n  parentAgentId?: string | null;\n  env?: string | null;\n  customerOrgId?: string | null;\n  agentVersion?: string | null;\n  context?: Record<string, unknown> | null;\n  groups?: Record<string, unknown> | null;\n  idleTimeoutMinutes?: number | null;\n  deviceId?: string | null;\n  browserSessionId?: string | null;\n  nextTurnIdFn?: (() => number) | null;\n}\n\nexport class SessionContext {\n  readonly sessionId: string;\n  traceId: string | null;\n  readonly userId: string | null;\n  readonly agentId: string | null;\n  readonly parentAgentId: string | null;\n  readonly env: string | null;\n  readonly customerOrgId: string | null;\n  readonly agentVersion: string | null;\n  readonly context: Record<string, unknown> | null;\n  readonly groups: Record<string, unknown> | null;\n  readonly idleTimeoutMinutes: number | null;\n  readonly deviceId: string | null;\n  readonly browserSessionId: string | null;\n  private readonly _nextTurnIdFn: (() => number) | null;\n\n  constructor(options: SessionContextOptions) {\n    this.sessionId = options.sessionId;\n    this.traceId = options.traceId ?? null;\n    this.userId = options.userId ?? null;\n    this.agentId = options.agentId ?? null;\n    this.parentAgentId = options.parentAgentId ?? null;\n    this.env = options.env ?? null;\n    this.customerOrgId = options.customerOrgId ?? null;\n    this.agentVersion = options.agentVersion ?? null;\n    this.context = options.context ?? null;\n    this.groups = options.groups ?? null;\n    this.idleTimeoutMinutes = options.idleTimeoutMinutes ?? null;\n    this.deviceId = options.deviceId ?? null;\n    this.browserSessionId = options.browserSessionId ?? null;\n    this._nextTurnIdFn = options.nextTurnIdFn ?? null;\n  }\n\n  nextTurnId(): number | null {\n    if (this._nextTurnIdFn != null) return this._nextTurnIdFn();\n    return null;\n  }\n}\n\nconst _sessionStorage = new AsyncLocalStorage<SessionContext | null>();\n\nexport function getActiveContext(): SessionContext | null {\n  return _sessionStorage.getStore() ?? null;\n}\n\nexport function runWithContext<T>(ctx: SessionContext, fn: () => T): T {\n  return _sessionStorage.run(ctx, fn);\n}\n\nexport function runWithContextAsync<T>(\n  ctx: SessionContext,\n  fn: () => Promise<T>,\n): Promise<T> {\n  return _sessionStorage.run(ctx, fn);\n}\n\nexport { _sessionStorage };\n"],"mappings":";;;AAmBA,IAAa,iBAAb,MAA4B;CAC1B,AAAS;CACT;CACA,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAiB;CAEjB,YAAY,SAAgC;AAC1C,OAAK,YAAY,QAAQ;AACzB,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,SAAS,QAAQ,UAAU;AAChC,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,gBAAgB,QAAQ,iBAAiB;AAC9C,OAAK,MAAM,QAAQ,OAAO;AAC1B,OAAK,gBAAgB,QAAQ,iBAAiB;AAC9C,OAAK,eAAe,QAAQ,gBAAgB;AAC5C,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,SAAS,QAAQ,UAAU;AAChC,OAAK,qBAAqB,QAAQ,sBAAsB;AACxD,OAAK,WAAW,QAAQ,YAAY;AACpC,OAAK,mBAAmB,QAAQ,oBAAoB;AACpD,OAAK,gBAAgB,QAAQ,gBAAgB;;CAG/C,aAA4B;AAC1B,MAAI,KAAK,iBAAiB,KAAM,QAAO,KAAK,eAAe;AAC3D,SAAO;;;AAIX,MAAM,kBAAkB,IAAI,mBAA0C;AAEtE,SAAgB,mBAA0C;AACxD,QAAO,gBAAgB,UAAU,IAAI;;AAGvC,SAAgB,eAAkB,KAAqB,IAAgB;AACrE,QAAO,gBAAgB,IAAI,KAAK,GAAG;;AAGrC,SAAgB,oBACd,KACA,IACY;AACZ,QAAO,gBAAgB,IAAI,KAAK,GAAG"}

package/dist/core/constants.d.ts

@@ -0,0 +1,96 @@
+//#region src/core/constants.d.ts
+declare const EVENT_USER_MESSAGE = "[Agent] User Message";
+declare const EVENT_AI_RESPONSE = "[Agent] AI Response";
+declare const EVENT_TOOL_CALL = "[Agent] Tool Call";
+declare const EVENT_EMBEDDING = "[Agent] Embedding";
+declare const EVENT_SPAN = "[Agent] Span";
+declare const EVENT_SESSION_END = "[Agent] Session End";
+declare const EVENT_SESSION_ENRICHMENT = "[Agent] Session Enrichment";
+declare const EVENT_SCORE = "[Agent] Score";
+declare const PROP_SESSION_ID = "[Agent] Session ID";
+declare const PROP_TRACE_ID = "[Agent] Trace ID";
+declare const PROP_TURN_ID = "[Agent] Turn ID";
+declare const PROP_MESSAGE_ID = "[Agent] Message ID";
+declare const PROP_MODEL_NAME = "[Agent] Model Name";
+declare const PROP_PROVIDER = "[Agent] Provider";
+declare const PROP_LATENCY_MS = "[Agent] Latency Ms";
+declare const PROP_TTFB_MS = "[Agent] TTFB Ms";
+declare const PROP_INPUT_TOKENS = "[Agent] Input Tokens";
+declare const PROP_OUTPUT_TOKENS = "[Agent] Output Tokens";
+declare const PROP_TOTAL_TOKENS = "[Agent] Total Tokens";
+declare const PROP_REASONING_TOKENS = "[Agent] Reasoning Tokens";
+declare const PROP_CACHE_READ_TOKENS = "[Agent] Cache Read Tokens";
+declare const PROP_CACHE_CREATION_TOKENS = "[Agent] Cache Creation Tokens";
+declare const PROP_COST_USD = "[Agent] Cost USD";
+declare const PROP_IS_ERROR = "[Agent] Is Error";
+declare const PROP_ERROR_MESSAGE = "[Agent] Error Message";
+declare const PROP_FINISH_REASON = "[Agent] Finish Reason";
+declare const PROP_TOOL_CALLS = "[Agent] Tool Calls";
+declare const PROP_TOOL_NAME = "[Agent] Tool Name";
+declare const PROP_TOOL_SUCCESS = "[Agent] Tool Success";
+declare const PROP_INVOCATION_ID = "[Agent] Invocation ID";
+declare const PROP_PARENT_MESSAGE_ID = "[Agent] Parent Message ID";
+declare const PROP_AGENT_ID = "[Agent] Agent ID";
+declare const PROP_PARENT_AGENT_ID = "[Agent] Parent Agent ID";
+declare const PROP_TOOL_INPUT = "[Agent] Tool Input";
+declare const PROP_TOOL_OUTPUT = "[Agent] Tool Output";
+declare const PROP_SDK_VERSION = "[Agent] SDK Version";
+declare const PROP_RUNTIME = "[Agent] Runtime";
+declare const PROP_ENV = "[Agent] Env";
+declare const PROP_LOCALE = "[Agent] Locale";
+declare const PROP_SPAN_KIND = "[Agent] Span Kind";
+declare const PROP_COMPONENT_TYPE = "[Agent] Component Type";
+declare const PROP_CUSTOMER_ORG_ID = "[Agent] Customer Org ID";
+declare const PROP_AGENT_VERSION = "[Agent] Agent Version";
+declare const PROP_CONTEXT = "[Agent] Context";
+declare const PROP_SPAN_ID = "[Agent] Span ID";
+declare const PROP_SPAN_NAME = "[Agent] Span Name";
+declare const PROP_PARENT_SPAN_ID = "[Agent] Parent Span ID";
+declare const PROP_INPUT_STATE = "[Agent] Input State";
+declare const PROP_OUTPUT_STATE = "[Agent] Output State";
+declare const PROP_EMBEDDING_DIMENSIONS = "[Agent] Embedding Dimensions";
+declare const PROP_ENRICHMENTS = "[Agent] Enrichments";
+declare const PROP_SCORE_NAME = "[Agent] Score Name";
+declare const PROP_SCORE_VALUE = "[Agent] Score Value";
+declare const PROP_TARGET_ID = "[Agent] Target ID";
+declare const PROP_TARGET_TYPE = "[Agent] Target Type";
+declare const PROP_EVALUATION_SOURCE = "[Agent] Evaluation Source";
+declare const PROP_COMMENT = "[Agent] Comment";
+declare const PROP_HAS_REASONING = "[Agent] Has Reasoning";
+declare const PROP_REASONING_CONTENT = "[Agent] Reasoning Content";
+declare const PROP_IDLE_TIMEOUT_MINUTES = "[Agent] Session Idle Timeout Minutes";
+declare const PROP_SYSTEM_PROMPT = "[Agent] System Prompt";
+declare const PROP_SYSTEM_PROMPT_LENGTH = "[Agent] System Prompt Length";
+declare const PROP_TEMPERATURE = "[Agent] Temperature";
+declare const PROP_MAX_OUTPUT_TOKENS = "[Agent] Max Output Tokens";
+declare const PROP_TOP_P = "[Agent] Top P";
+declare const PROP_IS_STREAMING = "[Agent] Is Streaming";
+declare const PROP_PROMPT_ID = "[Agent] Prompt ID";
+declare const PROP_IS_REGENERATION = "[Agent] Is Regeneration";
+declare const PROP_IS_EDIT = "[Agent] Is Edit";
+declare const PROP_EDITED_MESSAGE_ID = "[Agent] Edited Message ID";
+declare const PROP_WAS_COPIED = "[Agent] Was Copied";
+declare const PROP_ABANDONMENT_TURN = "[Agent] Abandonment Turn";
+declare const PROP_WAS_CACHED = "[Agent] Was Cached";
+declare const PROP_MODEL_TIER = "[Agent] Model Tier";
+declare const PROP_HAS_ATTACHMENTS = "[Agent] Has Attachments";
+declare const PROP_ATTACHMENT_TYPES = "[Agent] Attachment Types";
+declare const PROP_ATTACHMENT_COUNT = "[Agent] Attachment Count";
+declare const PROP_TOTAL_ATTACHMENT_SIZE = "[Agent] Total Attachment Size Bytes";
+declare const PROP_ATTACHMENTS = "[Agent] Attachments";
+declare const PROP_MESSAGE_LABELS = "[Agent] Message Labels";
+declare const PROP_MESSAGE_LABEL_MAP = "[Agent] Message Label Map";
+declare const PROP_SESSION_REPLAY_ID = "[Amplitude] Session Replay ID";
+declare const PROP_QUALITY_SCORE = "[Agent] Quality Score";
+declare const PROP_SENTIMENT_SCORE = "[Agent] Sentiment Score";
+declare const PROP_TASK_FAILURE_TYPE = "[Agent] Task Failure Type";
+declare const PROP_TASK_FAILURE_REASON = "[Agent] Task Failure Reason";
+declare const PROP_AGENT_CHAIN = "[Agent] Agent Chain";
+declare const PROP_ROOT_AGENT_NAME = "[Agent] Root Agent Name";
+declare const PROP_REQUEST_COMPLEXITY = "[Agent] Request Complexity";
+declare const SDK_VERSION: string;
+declare const SDK_RUNTIME = "node";
+declare const MAX_SERIALIZED_LENGTH = 10000;
+//#endregion
+export { EVENT_AI_RESPONSE, EVENT_EMBEDDING, EVENT_SCORE, EVENT_SESSION_END, EVENT_SESSION_ENRICHMENT, EVENT_SPAN, EVENT_TOOL_CALL, EVENT_USER_MESSAGE, MAX_SERIALIZED_LENGTH, PROP_ABANDONMENT_TURN, PROP_AGENT_CHAIN, PROP_AGENT_ID, PROP_AGENT_VERSION, PROP_ATTACHMENTS, PROP_ATTACHMENT_COUNT, PROP_ATTACHMENT_TYPES, PROP_CACHE_CREATION_TOKENS, PROP_CACHE_READ_TOKENS, PROP_COMMENT, PROP_COMPONENT_TYPE, PROP_CONTEXT, PROP_COST_USD, PROP_CUSTOMER_ORG_ID, PROP_EDITED_MESSAGE_ID, PROP_EMBEDDING_DIMENSIONS, PROP_ENRICHMENTS, PROP_ENV, PROP_ERROR_MESSAGE, PROP_EVALUATION_SOURCE, PROP_FINISH_REASON, PROP_HAS_ATTACHMENTS, PROP_HAS_REASONING, PROP_IDLE_TIMEOUT_MINUTES, PROP_INPUT_STATE, PROP_INPUT_TOKENS, PROP_INVOCATION_ID, PROP_IS_EDIT, PROP_IS_ERROR, PROP_IS_REGENERATION, PROP_IS_STREAMING, PROP_LATENCY_MS, PROP_LOCALE, PROP_MAX_OUTPUT_TOKENS, PROP_MESSAGE_ID, PROP_MESSAGE_LABELS, PROP_MESSAGE_LABEL_MAP, PROP_MODEL_NAME, PROP_MODEL_TIER, PROP_OUTPUT_STATE, PROP_OUTPUT_TOKENS, PROP_PARENT_AGENT_ID, PROP_PARENT_MESSAGE_ID, PROP_PARENT_SPAN_ID, PROP_PROMPT_ID, PROP_PROVIDER, PROP_QUALITY_SCORE, PROP_REASONING_CONTENT, PROP_REASONING_TOKENS, PROP_REQUEST_COMPLEXITY, PROP_ROOT_AGENT_NAME, PROP_RUNTIME, PROP_SCORE_NAME, PROP_SCORE_VALUE, PROP_SDK_VERSION, PROP_SENTIMENT_SCORE, PROP_SESSION_ID, PROP_SESSION_REPLAY_ID, PROP_SPAN_ID, PROP_SPAN_KIND, PROP_SPAN_NAME, PROP_SYSTEM_PROMPT, PROP_SYSTEM_PROMPT_LENGTH, PROP_TARGET_ID, PROP_TARGET_TYPE, PROP_TASK_FAILURE_REASON, PROP_TASK_FAILURE_TYPE, PROP_TEMPERATURE, PROP_TOOL_CALLS, PROP_TOOL_INPUT, PROP_TOOL_NAME, PROP_TOOL_OUTPUT, PROP_TOOL_SUCCESS, PROP_TOP_P, PROP_TOTAL_ATTACHMENT_SIZE, PROP_TOTAL_TOKENS, PROP_TRACE_ID, PROP_TTFB_MS, PROP_TURN_ID, PROP_WAS_CACHED, PROP_WAS_COPIED, SDK_RUNTIME, SDK_VERSION };
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/core/constants.ts"],"sourcesContent":[],"mappings":";cAIa,kBAAA;AAAA,cACA,iBAAA,GADkB,qBAAA;AAClB,cACA,eAAA,GADiB,mBAAA;AACjB,cACA,eAAA,GADe,mBAAA;AACf,cACA,UAAA,GADe,cAAA;AACf,cACA,iBAAA,GADU,qBAAA;AACV,cACA,wBAAA,GADiB,4BAAA;AACjB,cACA,WAAA,GADwB,eAAA;AACxB,cAGA,eAAA,GAHW,oBAAA;AAGX,cACA,aAAA,GADe,kBAAA;AACf,cACA,YAAA,GADa,iBAAA;AACb,cACA,eAAA,GADY,oBAAA;AACZ,cACA,eAAA,GADe,oBAAA;AACf,cACA,aAAA,GADe,kBAAA;AACf,cACA,eAAA,GADa,oBAAA;AACb,cACA,YAAA,GADe,iBAAA;AACf,cACA,iBAAA,GADY,sBAAA;AACZ,cACA,kBAAA,GADiB,uBAAA;AACjB,cACA,iBAAA,GADkB,sBAAA;AAClB,cACA,qBAAA,GADiB,0BAAA;AACjB,cACA,sBAAA,GADqB,2BAAA;AACrB,cACA,0BAAA,GADsB,+BAAA;AACtB,cACA,aAAA,GAD0B,kBAAA;AAC1B,cACA,aAAA,GADa,kBAAA;AACb,cACA,kBAAA,GADa,uBAAA;AACb,cACA,kBAAA,GADkB,uBAAA;AAClB,cACA,eAAA,GADkB,oBAAA;AAClB,cACA,cAAA,GADe,mBAAA;AACf,cACA,iBAAA,GADc,sBAAA;AACd,cACA,kBAAA,GADiB,uBAAA;AACjB,cACA,sBAAA,GADkB,2BAAA;AAClB,cACA,aAAA,GADsB,kBAAA;AACtB,cACA,oBAAA,GADa,yBAAA;AACb,cACA,eAAA,GADoB,oBAAA;AACpB,cACA,gBAAA,GADe,qBAAA;AACf,cACA,gBAAA,GADgB,qBAAA;AAChB,cACA,YAAA,GADgB,iBAAA;AAChB,cACA,QAAA,GADY,aAAA;AACZ,cACA,WAAA,GADQ,gBAAA;AACR,cACA,cAAA,GADW,mBAAA;AACX,cACA,mBAAA,GADc,wBAAA;AACd,cACA,oBAAA,GADmB,yBAAA;AACnB,cACA,kBAAA,GADoB,uBAAA;AACpB,cACA,YAAA,GADkB,iBAAA;AAClB,cAGA,YAAA,GAHY,iBAAA;AAGZ,cACA,cAAA,GADY,mBAAA;AACZ,cACA,mBAAA,GADc,wBAAA;AACd,cACA,gBAAA,GADmB,qBAAA;AACnB,cACA,iBAAA,GADgB,sBAAA;AAChB,cACA,yBAAA,GADiB,8BAAA;AACjB,cACA,gBAAA,GADyB,qBAAA;AACzB,cACA,eAAA,GADgB,oBAAA;AAChB,cACA,gBAAA,GADe,qBAAA;AACf,cACA,cAAA,GADgB,mBAAA;AAChB,cACA,gBAAA,GADc,qBAAA;AACd,cACA,sBAAA,GADgB,2BAAA;AAChB,cACA,YAAA,GADsB,iBAAA;AACtB,cACA,kBAAA,GADY,uBAAA;AACZ,cACA,sBAAA,GADkB,2BAAA;AAClB,cACA,yBAAA,GADsB,sCAAA;AACtB,cAGA,kBAAA,GAHyB,uBAAA;AAGzB,cACA,yBAAA,GADkB,8BAAA;AAClB,cACA,gBAAA,GADyB,qBAAA;AACzB,cACA,sBAAA,GADgB,2BAAA;AAChB,cACA,UAAA,GADsB,eAAA;AACtB,cACA,iBAAA,GADU,sBAAA;AACV,cACA,cAAA,GADiB,mBAAA;AACjB,cAGA,oBAAA,GAHc,yBAAA;AAGd,cACA,YAAA,GADoB,iBAAA;AACpB,cACA,sBAAA,GADY,2BAAA;AACZ,cACA,eAAA,GADsB,oBAAA;AACtB,cACA,qBAAA,GADe,0BAAA;AACf,cAGA,eAAA,GAHqB,oBAAA;AAGrB,cACA,eAAA,GADe,oBAAA;AACf,cACA,oBAAA,GADe,yBAAA;AACf,cACA,qBAAA,GADoB,0BAAA;AACpB,cACA,qBAAA,GADqB,0BAAA;AACrB,cACA,0BAAA,GADqB,qCAAA;AACrB,cACA,gBAAA,GAD0B,qBAAA;AAC1B,cAGA,mBAAA,GAHgB,wBAAA;AAGhB,cACA,sBAAA,GADmB,2BAAA;AACnB,cAGA,sBAAA,GAHsB,+BAAA;AAGtB,cAGA,kBAAA,GAHsB,uBAAA;AAGtB,cACA,oBAAA,GADkB,yBAAA;AAClB,cACA,sBAAA,GADoB,2BAAA;AACpB,cACA,wBAAA,GADsB,6BAAA;AACtB,cACA,gBAAA,GADwB,qBAAA;AACxB,cACA,oBAAA,GADgB,yBAAA;AAChB,cACA,uBAAA,GADoB,4BAAA;AACpB,cAUA,WAVuB,EAAA,MAAA;AAUvB,cACA,WAAA,GADiC,MAAA;AACjC,cAGA,qBAAA,GAHW,KAAA"}

package/dist/core/constants.js

@@ -0,0 +1,105 @@
+import { createRequire } from "node:module";
+
+//#region src/core/constants.ts
+const EVENT_USER_MESSAGE = "[Agent] User Message";
+const EVENT_AI_RESPONSE = "[Agent] AI Response";
+const EVENT_TOOL_CALL = "[Agent] Tool Call";
+const EVENT_EMBEDDING = "[Agent] Embedding";
+const EVENT_SPAN = "[Agent] Span";
+const EVENT_SESSION_END = "[Agent] Session End";
+const EVENT_SESSION_ENRICHMENT = "[Agent] Session Enrichment";
+const EVENT_SCORE = "[Agent] Score";
+const PROP_SESSION_ID = "[Agent] Session ID";
+const PROP_TRACE_ID = "[Agent] Trace ID";
+const PROP_TURN_ID = "[Agent] Turn ID";
+const PROP_MESSAGE_ID = "[Agent] Message ID";
+const PROP_MODEL_NAME = "[Agent] Model Name";
+const PROP_PROVIDER = "[Agent] Provider";
+const PROP_LATENCY_MS = "[Agent] Latency Ms";
+const PROP_TTFB_MS = "[Agent] TTFB Ms";
+const PROP_INPUT_TOKENS = "[Agent] Input Tokens";
+const PROP_OUTPUT_TOKENS = "[Agent] Output Tokens";
+const PROP_TOTAL_TOKENS = "[Agent] Total Tokens";
+const PROP_REASONING_TOKENS = "[Agent] Reasoning Tokens";
+const PROP_CACHE_READ_TOKENS = "[Agent] Cache Read Tokens";
+const PROP_CACHE_CREATION_TOKENS = "[Agent] Cache Creation Tokens";
+const PROP_COST_USD = "[Agent] Cost USD";
+const PROP_IS_ERROR = "[Agent] Is Error";
+const PROP_ERROR_MESSAGE = "[Agent] Error Message";
+const PROP_FINISH_REASON = "[Agent] Finish Reason";
+const PROP_TOOL_CALLS = "[Agent] Tool Calls";
+const PROP_TOOL_NAME = "[Agent] Tool Name";
+const PROP_TOOL_SUCCESS = "[Agent] Tool Success";
+const PROP_INVOCATION_ID = "[Agent] Invocation ID";
+const PROP_PARENT_MESSAGE_ID = "[Agent] Parent Message ID";
+const PROP_AGENT_ID = "[Agent] Agent ID";
+const PROP_PARENT_AGENT_ID = "[Agent] Parent Agent ID";
+const PROP_TOOL_INPUT = "[Agent] Tool Input";
+const PROP_TOOL_OUTPUT = "[Agent] Tool Output";
+const PROP_SDK_VERSION = "[Agent] SDK Version";
+const PROP_RUNTIME = "[Agent] Runtime";
+const PROP_ENV = "[Agent] Env";
+const PROP_LOCALE = "[Agent] Locale";
+const PROP_SPAN_KIND = "[Agent] Span Kind";
+const PROP_COMPONENT_TYPE = "[Agent] Component Type";
+const PROP_CUSTOMER_ORG_ID = "[Agent] Customer Org ID";
+const PROP_AGENT_VERSION = "[Agent] Agent Version";
+const PROP_CONTEXT = "[Agent] Context";
+const PROP_SPAN_ID = "[Agent] Span ID";
+const PROP_SPAN_NAME = "[Agent] Span Name";
+const PROP_PARENT_SPAN_ID = "[Agent] Parent Span ID";
+const PROP_INPUT_STATE = "[Agent] Input State";
+const PROP_OUTPUT_STATE = "[Agent] Output State";
+const PROP_EMBEDDING_DIMENSIONS = "[Agent] Embedding Dimensions";
+const PROP_ENRICHMENTS = "[Agent] Enrichments";
+const PROP_SCORE_NAME = "[Agent] Score Name";
+const PROP_SCORE_VALUE = "[Agent] Score Value";
+const PROP_TARGET_ID = "[Agent] Target ID";
+const PROP_TARGET_TYPE = "[Agent] Target Type";
+const PROP_EVALUATION_SOURCE = "[Agent] Evaluation Source";
+const PROP_COMMENT = "[Agent] Comment";
+const PROP_HAS_REASONING = "[Agent] Has Reasoning";
+const PROP_REASONING_CONTENT = "[Agent] Reasoning Content";
+const PROP_IDLE_TIMEOUT_MINUTES = "[Agent] Session Idle Timeout Minutes";
+const PROP_SYSTEM_PROMPT = "[Agent] System Prompt";
+const PROP_SYSTEM_PROMPT_LENGTH = "[Agent] System Prompt Length";
+const PROP_TEMPERATURE = "[Agent] Temperature";
+const PROP_MAX_OUTPUT_TOKENS = "[Agent] Max Output Tokens";
+const PROP_TOP_P = "[Agent] Top P";
+const PROP_IS_STREAMING = "[Agent] Is Streaming";
+const PROP_PROMPT_ID = "[Agent] Prompt ID";
+const PROP_IS_REGENERATION = "[Agent] Is Regeneration";
+const PROP_IS_EDIT = "[Agent] Is Edit";
+const PROP_EDITED_MESSAGE_ID = "[Agent] Edited Message ID";
+const PROP_WAS_COPIED = "[Agent] Was Copied";
+const PROP_ABANDONMENT_TURN = "[Agent] Abandonment Turn";
+const PROP_WAS_CACHED = "[Agent] Was Cached";
+const PROP_MODEL_TIER = "[Agent] Model Tier";
+const PROP_HAS_ATTACHMENTS = "[Agent] Has Attachments";
+const PROP_ATTACHMENT_TYPES = "[Agent] Attachment Types";
+const PROP_ATTACHMENT_COUNT = "[Agent] Attachment Count";
+const PROP_TOTAL_ATTACHMENT_SIZE = "[Agent] Total Attachment Size Bytes";
+const PROP_ATTACHMENTS = "[Agent] Attachments";
+const PROP_MESSAGE_LABELS = "[Agent] Message Labels";
+const PROP_MESSAGE_LABEL_MAP = "[Agent] Message Label Map";
+const PROP_SESSION_REPLAY_ID = "[Amplitude] Session Replay ID";
+const PROP_QUALITY_SCORE = "[Agent] Quality Score";
+const PROP_SENTIMENT_SCORE = "[Agent] Sentiment Score";
+const PROP_TASK_FAILURE_TYPE = "[Agent] Task Failure Type";
+const PROP_TASK_FAILURE_REASON = "[Agent] Task Failure Reason";
+const PROP_AGENT_CHAIN = "[Agent] Agent Chain";
+const PROP_ROOT_AGENT_NAME = "[Agent] Root Agent Name";
+const PROP_REQUEST_COMPLEXITY = "[Agent] Request Complexity";
+const _require = createRequire(import.meta.url);
+let _sdkVersion = "0.1.0";
+try {
+	const pkg = _require("../../package.json");
+	if (pkg.version) _sdkVersion = pkg.version;
+} catch {}
+const SDK_VERSION = _sdkVersion;
+const SDK_RUNTIME = "node";
+const MAX_SERIALIZED_LENGTH = 1e4;
+
+//#endregion
+export { EVENT_AI_RESPONSE, EVENT_EMBEDDING, EVENT_SCORE, EVENT_SESSION_END, EVENT_SESSION_ENRICHMENT, EVENT_SPAN, EVENT_TOOL_CALL, EVENT_USER_MESSAGE, MAX_SERIALIZED_LENGTH, PROP_ABANDONMENT_TURN, PROP_AGENT_CHAIN, PROP_AGENT_ID, PROP_AGENT_VERSION, PROP_ATTACHMENTS, PROP_ATTACHMENT_COUNT, PROP_ATTACHMENT_TYPES, PROP_CACHE_CREATION_TOKENS, PROP_CACHE_READ_TOKENS, PROP_COMMENT, PROP_COMPONENT_TYPE, PROP_CONTEXT, PROP_COST_USD, PROP_CUSTOMER_ORG_ID, PROP_EDITED_MESSAGE_ID, PROP_EMBEDDING_DIMENSIONS, PROP_ENRICHMENTS, PROP_ENV, PROP_ERROR_MESSAGE, PROP_EVALUATION_SOURCE, PROP_FINISH_REASON, PROP_HAS_ATTACHMENTS, PROP_HAS_REASONING, PROP_IDLE_TIMEOUT_MINUTES, PROP_INPUT_STATE, PROP_INPUT_TOKENS, PROP_INVOCATION_ID, PROP_IS_EDIT, PROP_IS_ERROR, PROP_IS_REGENERATION, PROP_IS_STREAMING, PROP_LATENCY_MS, PROP_LOCALE, PROP_MAX_OUTPUT_TOKENS, PROP_MESSAGE_ID, PROP_MESSAGE_LABELS, PROP_MESSAGE_LABEL_MAP, PROP_MODEL_NAME, PROP_MODEL_TIER, PROP_OUTPUT_STATE, PROP_OUTPUT_TOKENS, PROP_PARENT_AGENT_ID, PROP_PARENT_MESSAGE_ID, PROP_PARENT_SPAN_ID, PROP_PROMPT_ID, PROP_PROVIDER, PROP_QUALITY_SCORE, PROP_REASONING_CONTENT, PROP_REASONING_TOKENS, PROP_REQUEST_COMPLEXITY, PROP_ROOT_AGENT_NAME, PROP_RUNTIME, PROP_SCORE_NAME, PROP_SCORE_VALUE, PROP_SDK_VERSION, PROP_SENTIMENT_SCORE, PROP_SESSION_ID, PROP_SESSION_REPLAY_ID, PROP_SPAN_ID, PROP_SPAN_KIND, PROP_SPAN_NAME, PROP_SYSTEM_PROMPT, PROP_SYSTEM_PROMPT_LENGTH, PROP_TARGET_ID, PROP_TARGET_TYPE, PROP_TASK_FAILURE_REASON, PROP_TASK_FAILURE_TYPE, PROP_TEMPERATURE, PROP_TOOL_CALLS, PROP_TOOL_INPUT, PROP_TOOL_NAME, PROP_TOOL_OUTPUT, PROP_TOOL_SUCCESS, PROP_TOP_P, PROP_TOTAL_ATTACHMENT_SIZE, PROP_TOTAL_TOKENS, PROP_TRACE_ID, PROP_TTFB_MS, PROP_TURN_ID, PROP_WAS_CACHED, PROP_WAS_COPIED, SDK_RUNTIME, SDK_VERSION };
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":["SDK_VERSION: string"],"sources":["../../src/core/constants.ts"],"sourcesContent":["// SDK metadata — version read from package.json to stay in sync\nimport { createRequire } from 'node:module';\n\n// Event type constants — must be byte-identical to Python SDK\nexport const EVENT_USER_MESSAGE = '[Agent] User Message';\nexport const EVENT_AI_RESPONSE = '[Agent] AI Response';\nexport const EVENT_TOOL_CALL = '[Agent] Tool Call';\nexport const EVENT_EMBEDDING = '[Agent] Embedding';\nexport const EVENT_SPAN = '[Agent] Span';\nexport const EVENT_SESSION_END = '[Agent] Session End';\nexport const EVENT_SESSION_ENRICHMENT = '[Agent] Session Enrichment';\nexport const EVENT_SCORE = '[Agent] Score';\n\n// Property name constants — must be byte-identical to Python SDK\nexport const PROP_SESSION_ID = '[Agent] Session ID';\nexport const PROP_TRACE_ID = '[Agent] Trace ID';\nexport const PROP_TURN_ID = '[Agent] Turn ID';\nexport const PROP_MESSAGE_ID = '[Agent] Message ID';\nexport const PROP_MODEL_NAME = '[Agent] Model Name';\nexport const PROP_PROVIDER = '[Agent] Provider';\nexport const PROP_LATENCY_MS = '[Agent] Latency Ms';\nexport const PROP_TTFB_MS = '[Agent] TTFB Ms';\nexport const PROP_INPUT_TOKENS = '[Agent] Input Tokens';\nexport const PROP_OUTPUT_TOKENS = '[Agent] Output Tokens';\nexport const PROP_TOTAL_TOKENS = '[Agent] Total Tokens';\nexport const PROP_REASONING_TOKENS = '[Agent] Reasoning Tokens';\nexport const PROP_CACHE_READ_TOKENS = '[Agent] Cache Read Tokens';\nexport const PROP_CACHE_CREATION_TOKENS = '[Agent] Cache Creation Tokens';\nexport const PROP_COST_USD = '[Agent] Cost USD';\nexport const PROP_IS_ERROR = '[Agent] Is Error';\nexport const PROP_ERROR_MESSAGE = '[Agent] Error Message';\nexport const PROP_FINISH_REASON = '[Agent] Finish Reason';\nexport const PROP_TOOL_CALLS = '[Agent] Tool Calls';\nexport const PROP_TOOL_NAME = '[Agent] Tool Name';\nexport const PROP_TOOL_SUCCESS = '[Agent] Tool Success';\nexport const PROP_INVOCATION_ID = '[Agent] Invocation ID';\nexport const PROP_PARENT_MESSAGE_ID = '[Agent] Parent Message ID';\nexport const PROP_AGENT_ID = '[Agent] Agent ID';\nexport const PROP_PARENT_AGENT_ID = '[Agent] Parent Agent ID';\nexport const PROP_TOOL_INPUT = '[Agent] Tool Input';\nexport const PROP_TOOL_OUTPUT = '[Agent] Tool Output';\nexport const PROP_SDK_VERSION = '[Agent] SDK Version';\nexport const PROP_RUNTIME = '[Agent] Runtime';\nexport const PROP_ENV = '[Agent] Env';\nexport const PROP_LOCALE = '[Agent] Locale';\nexport const PROP_SPAN_KIND = '[Agent] Span Kind';\nexport const PROP_COMPONENT_TYPE = '[Agent] Component Type';\nexport const PROP_CUSTOMER_ORG_ID = '[Agent] Customer Org ID';\nexport const PROP_AGENT_VERSION = '[Agent] Agent Version';\nexport const PROP_CONTEXT = '[Agent] Context';\n\n// v0.3.0 properties\nexport const PROP_SPAN_ID = '[Agent] Span ID';\nexport const PROP_SPAN_NAME = '[Agent] Span Name';\nexport const PROP_PARENT_SPAN_ID = '[Agent] Parent Span ID';\nexport const PROP_INPUT_STATE = '[Agent] Input State';\nexport const PROP_OUTPUT_STATE = '[Agent] Output State';\nexport const PROP_EMBEDDING_DIMENSIONS = '[Agent] Embedding Dimensions';\nexport const PROP_ENRICHMENTS = '[Agent] Enrichments';\nexport const PROP_SCORE_NAME = '[Agent] Score Name';\nexport const PROP_SCORE_VALUE = '[Agent] Score Value';\nexport const PROP_TARGET_ID = '[Agent] Target ID';\nexport const PROP_TARGET_TYPE = '[Agent] Target Type';\nexport const PROP_EVALUATION_SOURCE = '[Agent] Evaluation Source';\nexport const PROP_COMMENT = '[Agent] Comment';\nexport const PROP_HAS_REASONING = '[Agent] Has Reasoning';\nexport const PROP_REASONING_CONTENT = '[Agent] Reasoning Content';\nexport const PROP_IDLE_TIMEOUT_MINUTES = '[Agent] Session Idle Timeout Minutes';\n\n// Model configuration constants (v0.4.0)\nexport const PROP_SYSTEM_PROMPT = '[Agent] System Prompt';\nexport const PROP_SYSTEM_PROMPT_LENGTH = '[Agent] System Prompt Length';\nexport const PROP_TEMPERATURE = '[Agent] Temperature';\nexport const PROP_MAX_OUTPUT_TOKENS = '[Agent] Max Output Tokens';\nexport const PROP_TOP_P = '[Agent] Top P';\nexport const PROP_IS_STREAMING = '[Agent] Is Streaming';\nexport const PROP_PROMPT_ID = '[Agent] Prompt ID';\n\n// Implicit feedback constants (v0.5.0)\nexport const PROP_IS_REGENERATION = '[Agent] Is Regeneration';\nexport const PROP_IS_EDIT = '[Agent] Is Edit';\nexport const PROP_EDITED_MESSAGE_ID = '[Agent] Edited Message ID';\nexport const PROP_WAS_COPIED = '[Agent] Was Copied';\nexport const PROP_ABANDONMENT_TURN = '[Agent] Abandonment Turn';\n\n// Attachment constants (v0.5.0)\nexport const PROP_WAS_CACHED = '[Agent] Was Cached';\nexport const PROP_MODEL_TIER = '[Agent] Model Tier';\nexport const PROP_HAS_ATTACHMENTS = '[Agent] Has Attachments';\nexport const PROP_ATTACHMENT_TYPES = '[Agent] Attachment Types';\nexport const PROP_ATTACHMENT_COUNT = '[Agent] Attachment Count';\nexport const PROP_TOTAL_ATTACHMENT_SIZE = '[Agent] Total Attachment Size Bytes';\nexport const PROP_ATTACHMENTS = '[Agent] Attachments';\n\n// Message label constants (v0.6.0)\nexport const PROP_MESSAGE_LABELS = '[Agent] Message Labels';\nexport const PROP_MESSAGE_LABEL_MAP = '[Agent] Message Label Map';\n\n// Session replay linking (v0.7.0)\nexport const PROP_SESSION_REPLAY_ID = '[Amplitude] Session Replay ID';\n\n// Session-level enrichment property constants (v0.6.0)\nexport const PROP_QUALITY_SCORE = '[Agent] Quality Score';\nexport const PROP_SENTIMENT_SCORE = '[Agent] Sentiment Score';\nexport const PROP_TASK_FAILURE_TYPE = '[Agent] Task Failure Type';\nexport const PROP_TASK_FAILURE_REASON = '[Agent] Task Failure Reason';\nexport const PROP_AGENT_CHAIN = '[Agent] Agent Chain';\nexport const PROP_ROOT_AGENT_NAME = '[Agent] Root Agent Name';\nexport const PROP_REQUEST_COMPLEXITY = '[Agent] Request Complexity';\n\nconst _require = createRequire(import.meta.url);\nlet _sdkVersion = '0.1.0';\ntry {\n  const pkg = _require('../../package.json') as { version?: string };\n  if (pkg.version) _sdkVersion = pkg.version;\n} catch {\n  // Fallback to hardcoded version when running outside the package\n}\nexport const SDK_VERSION: string = _sdkVersion;\nexport const SDK_RUNTIME = 'node';\n\n// Serialization limits\nexport const MAX_SERIALIZED_LENGTH = 10000;\n"],"mappings":";;;AAIA,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AACjC,MAAa,kBAAkB;AAC/B,MAAa,kBAAkB;AAC/B,MAAa,aAAa;AAC1B,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,cAAc;AAG3B,MAAa,kBAAkB;AAC/B,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAC5B,MAAa,kBAAkB;AAC/B,MAAa,kBAAkB;AAC/B,MAAa,gBAAgB;AAC7B,MAAa,kBAAkB;AAC/B,MAAa,eAAe;AAC5B,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AACjC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB;AACtC,MAAa,6BAA6B;AAC1C,MAAa,gBAAgB;AAC7B,MAAa,gBAAgB;AAC7B,MAAa,qBAAqB;AAClC,MAAa,qBAAqB;AAClC,MAAa,kBAAkB;AAC/B,MAAa,iBAAiB;AAC9B,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAClC,MAAa,yBAAyB;AACtC,MAAa,gBAAgB;AAC7B,MAAa,uBAAuB;AACpC,MAAa,kBAAkB;AAC/B,MAAa,mBAAmB;AAChC,MAAa,mBAAmB;AAChC,MAAa,eAAe;AAC5B,MAAa,WAAW;AACxB,MAAa,cAAc;AAC3B,MAAa,iBAAiB;AAC9B,MAAa,sBAAsB;AACnC,MAAa,uBAAuB;AACpC,MAAa,qBAAqB;AAClC,MAAa,eAAe;AAG5B,MAAa,eAAe;AAC5B,MAAa,iBAAiB;AAC9B,MAAa,sBAAsB;AACnC,MAAa,mBAAmB;AAChC,MAAa,oBAAoB;AACjC,MAAa,4BAA4B;AACzC,MAAa,mBAAmB;AAChC,MAAa,kBAAkB;AAC/B,MAAa,mBAAmB;AAChC,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAChC,MAAa,yBAAyB;AACtC,MAAa,eAAe;AAC5B,MAAa,qBAAqB;AAClC,MAAa,yBAAyB;AACtC,MAAa,4BAA4B;AAGzC,MAAa,qBAAqB;AAClC,MAAa,4BAA4B;AACzC,MAAa,mBAAmB;AAChC,MAAa,yBAAyB;AACtC,MAAa,aAAa;AAC1B,MAAa,oBAAoB;AACjC,MAAa,iBAAiB;AAG9B,MAAa,uBAAuB;AACpC,MAAa,eAAe;AAC5B,MAAa,yBAAyB;AACtC,MAAa,kBAAkB;AAC/B,MAAa,wBAAwB;AAGrC,MAAa,kBAAkB;AAC/B,MAAa,kBAAkB;AAC/B,MAAa,uBAAuB;AACpC,MAAa,wBAAwB;AACrC,MAAa,wBAAwB;AACrC,MAAa,6BAA6B;AAC1C,MAAa,mBAAmB;AAGhC,MAAa,sBAAsB;AACnC,MAAa,yBAAyB;AAGtC,MAAa,yBAAyB;AAGtC,MAAa,qBAAqB;AAClC,MAAa,uBAAuB;AACpC,MAAa,yBAAyB;AACtC,MAAa,2BAA2B;AACxC,MAAa,mBAAmB;AAChC,MAAa,uBAAuB;AACpC,MAAa,0BAA0B;AAEvC,MAAM,WAAW,cAAc,OAAO,KAAK,IAAI;AAC/C,IAAI,cAAc;AAClB,IAAI;CACF,MAAM,MAAM,SAAS,qBAAqB;AAC1C,KAAI,IAAI,QAAS,eAAc,IAAI;QAC7B;AAGR,MAAaA,cAAsB;AACnC,MAAa,cAAc;AAG3B,MAAa,wBAAwB"}

package/dist/core/enrichments.d.ts

@@ -0,0 +1,139 @@
+//#region src/core/enrichments.d.ts
+interface MessageLabelData {
+  key: string;
+  value: string;
+  confidence?: number;
+}
+declare class MessageLabel {
+  readonly key: string;
+  readonly value: string;
+  readonly confidence: number | null;
+  constructor(options: {
+    key: string;
+    value: string;
+    confidence?: number;
+  });
+  toDict(): MessageLabelData;
+}
+interface EvidenceQuoteData {
+  quote: string;
+  turn_index: number;
+  role?: string;
+}
+declare class EvidenceQuote {
+  readonly quote: string;
+  readonly turnIndex: number;
+  readonly role: string | null;
+  constructor(options: {
+    quote: string;
+    turnIndex: number;
+    role?: string;
+  });
+  toDict(): EvidenceQuoteData;
+}
+interface TopicClassificationData {
+  l1?: string;
+  values?: string[];
+  primary?: string;
+  /** @deprecated Use `subcategories` instead. */
+  l2?: string;
+  subcategories?: string[];
+  topics_covered?: string[];
+  outcomes_by_topic?: Record<string, string>;
+}
+declare class TopicClassification {
+  readonly l1: string | null;
+  readonly values: string[] | null;
+  readonly primary: string | null;
+  /** @deprecated Use {@link subcategories} instead. */
+  readonly l2: string | null;
+  readonly subcategories: string[] | null;
+  readonly topicsCovered: string[] | null;
+  readonly outcomesByTopic: Record<string, string> | null;
+  constructor(options?: {
+    l1?: string;
+    values?: string[];
+    primary?: string;
+    /** @deprecated Use `subcategories` instead. */
+    l2?: string;
+    subcategories?: string[];
+    topicsCovered?: string[];
+    outcomesByTopic?: Record<string, string>;
+  });
+  toDict(): TopicClassificationData;
+}
+interface RubricScoreData {
+  name: string;
+  score: number;
+  rationale?: string;
+  evidence?: EvidenceQuoteData[];
+  improvement_opportunities?: string;
+}
+declare class RubricScore {
+  readonly name: string;
+  readonly score: number;
+  readonly rationale: string | null;
+  readonly evidence: EvidenceQuote[] | null;
+  readonly improvementOpportunities: string | null;
+  constructor(options: {
+    name: string;
+    score: number;
+    rationale?: string;
+    evidence?: EvidenceQuote[];
+    improvementOpportunities?: string;
+  });
+  toDict(): RubricScoreData;
+}
+interface SessionEnrichmentsOptions {
+  topicClassifications?: Record<string, TopicClassification>;
+  rubrics?: RubricScore[];
+  overallOutcome?: string;
+  hasTaskFailure?: boolean;
+  hasNegativeFeedback?: boolean;
+  hasDataQualityIssues?: boolean;
+  hasTechnicalFailure?: boolean;
+  errorCategories?: string[];
+  behavioralPatterns?: string[];
+  customMetadata?: Record<string, unknown>;
+  schemaVersion?: string;
+  qualityScore?: number;
+  sentimentScore?: number;
+  taskFailureType?: string;
+  taskFailureReason?: string;
+  negativeFeedbackPhrases?: string[];
+  dataQualityIssues?: string[];
+  technicalErrorCount?: number;
+  agentChain?: string[];
+  rootAgentName?: string;
+  requestComplexity?: string;
+  messageLabels?: Record<string, MessageLabel[]>;
+}
+declare class SessionEnrichments {
+  readonly topicClassifications: Record<string, TopicClassification> | null;
+  readonly rubrics: RubricScore[] | null;
+  readonly overallOutcome: string | null;
+  readonly hasTaskFailure: boolean;
+  readonly hasNegativeFeedback: boolean;
+  readonly hasDataQualityIssues: boolean;
+  readonly hasTechnicalFailure: boolean;
+  readonly errorCategories: string[] | null;
+  readonly behavioralPatterns: string[] | null;
+  readonly customMetadata: Record<string, unknown> | null;
+  readonly schemaVersion: string;
+  readonly qualityScore: number | null;
+  readonly sentimentScore: number | null;
+  readonly taskFailureType: string | null;
+  readonly taskFailureReason: string | null;
+  readonly negativeFeedbackPhrases: string[] | null;
+  readonly dataQualityIssues: string[] | null;
+  readonly technicalErrorCount: number | null;
+  readonly agentChain: string[] | null;
+  readonly rootAgentName: string | null;
+  readonly requestComplexity: string | null;
+  readonly messageLabels: Record<string, MessageLabel[]> | null;
+  constructor(options?: SessionEnrichmentsOptions);
+  toDict(): Record<string, unknown>;
+}
+//#endregion
+export { EvidenceQuote, EvidenceQuoteData, MessageLabel, MessageLabelData, RubricScore, RubricScoreData, SessionEnrichments, SessionEnrichmentsOptions, TopicClassification, TopicClassificationData };
+//# sourceMappingURL=enrichments.d.ts.map

package/dist/core/enrichments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichments.d.ts","names":[],"sources":["../../src/core/enrichments.ts"],"sourcesContent":[],"mappings":";UAAiB,gBAAA;EAAA,GAAA,EAAA,MAAA;EAMJ,KAAA,EAAA,MAAA;EAoBI,UAAA,CAAA,EAAA,MAAA;AAMjB;AAuBiB,cAjDJ,YAAA,CAiD2B;EAW3B,SAAA,GAAA,EAAA,MAAA;EAQe,SAAA,KAAA,EAAA,MAAA;EAWJ,SAAA,UAAA,EAAA,MAAA,GAAA,IAAA;EAYZ,WAAA,CAAA,OAAA,EAAA;IAAuB,GAAA,EAAA,MAAA;IAclB,KAAA,EAAA,MAAA;IAQJ,UAAW,CAAA,EAAA,MAAA;EAIH,CAAA;EAON,MAAA,CAAA,CAAA,EAjHH,gBAiHG;;AAUY,UAlHV,iBAAA,CAkHU;EAWV,KAAA,EAAA,MAAA;EACuB,UAAA,EAAA,MAAA;EAAf,IAAA,CAAA,EAAA,MAAA;;AASN,cAjIN,aAAA,CAiIM;EAYc,SAAA,KAAA,EAAA,MAAA;EAAf,SAAA,SAAA,EAAA,MAAA;EAAM,SAAA,IAAA,EAAA,MAAA,GAAA,IAAA;EAGX,WAAA,CAAA,OAAA,EAAkB;IACiB,KAAA,EAAA,MAAA;IAAf,SAAA,EAAA,MAAA;IACb,IAAA,CAAA,EAAA,MAAA;EAQO,CAAA;EAYc,MAAA,CAAA,CAAA,EA3J7B,iBA2J6B;;AAElB,UAjJN,uBAAA,CAiJM;EAyBX,EAAA,CAAA,EAAA,MAAA;EAAM,MAAA,CAAA,EAAA,MAAA,EAAA;;;;;;sBAlKI;;cAGT,mBAAA;;;;;;;;4BAQe;;;;;;;;;sBAWJ;;YAYZ;;UAcK,eAAA;;;;aAIJ;;;cAIA,WAAA;;;;qBAIQ;;;;;;eAON;;;YAUH;;UAWK,yBAAA;yBACQ,eAAe;YAC5B;;;;;;;;mBAQO;;;;;;;;;;;;kBAYD,eAAe;;cAGpB,kBAAA;iCACoB,eAAe;oBAC5B;;;;;;;;2BAQO;;;;;;;;;;;;0BAYD,eAAe;wBAElB;YAyBX"}