@dexto/analytics 1.4.0 → 1.5.0

package/dist/events.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var events_exports = {};
+module.exports = __toCommonJS(events_exports);

package/dist/events.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Platform source for analytics events.
+ * Used to distinguish which interface generated the event.
+ */
+export type AnalyticsSource = 'cli' | 'webui';
+/**
+ * LLM token consumption event.
+ * Emitted after each LLM response with token usage data.
+ *
+ */
+export interface LLMTokensConsumedEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    reasoningTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+}
+/**
+ * Message sent event.
+ * Emitted when user sends a message to the agent.
+ */
+export interface MessageSentEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    provider: string;
+    model: string;
+    hasImage: boolean;
+    hasFile: boolean;
+    messageLength: number;
+    messageCount?: number | undefined;
+    isQueued?: boolean | undefined;
+}
+/**
+ * Tool called event.
+ * Emitted when a tool is invoked by the LLM.
+ */
+export interface ToolCalledEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    toolName: string;
+    mcpServer?: string | undefined;
+}
+/**
+ * Tool result event.
+ * Emitted when a tool execution completes.
+ */
+export interface ToolResultEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    toolName: string;
+    success: boolean;
+    approvalStatus?: 'approved' | 'rejected' | undefined;
+}
+/**
+ * Session created event.
+ */
+export interface SessionCreatedEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    trigger: 'first_message' | 'manual' | 'resume';
+}
+/**
+ * Session reset event (conversation cleared).
+ */
+export interface SessionResetEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    messageCount: number;
+}
+/**
+ * LLM switched event.
+ */
+export interface LLMSwitchedEvent {
+    source: AnalyticsSource;
+    sessionId?: string | undefined;
+    fromProvider: string;
+    fromModel: string;
+    toProvider: string;
+    toModel: string;
+    trigger: 'user_action' | 'config_change';
+}
+/**
+ * Session switched event.
+ * Emitted when user switches to a different session.
+ */
+export interface SessionSwitchedEvent {
+    source: AnalyticsSource;
+    fromSessionId: string | null;
+    toSessionId: string;
+}
+/**
+ * Agent switched event.
+ * Emitted when user switches to a different agent.
+ */
+export interface AgentSwitchedEvent {
+    source: AnalyticsSource;
+    fromAgentId: string | null;
+    toAgentId: string;
+    toAgentName?: string | undefined;
+    sessionId?: string | undefined;
+}
+/**
+ * MCP server connected event.
+ * Emitted when an MCP server connects successfully.
+ */
+export interface MCPServerConnectedEvent {
+    source: AnalyticsSource;
+    serverName: string;
+    transportType: 'stdio' | 'http' | 'sse';
+    toolCount?: number | undefined;
+}
+/**
+ * File attached event.
+ * Emitted when user attaches a file to a message.
+ */
+export interface FileAttachedEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    fileType: string;
+    fileSizeBytes?: number | undefined;
+}
+/**
+ * Image attached event.
+ * Emitted when user attaches an image to a message.
+ */
+export interface ImageAttachedEvent {
+    source: AnalyticsSource;
+    sessionId: string;
+    imageType: string;
+    imageSizeBytes?: number | undefined;
+}
+/**
+ * Shared analytics event map containing events supported by ALL platforms.
+ * CLI and WebUI extend this map with platform-specific events.
+ *
+ * IMPORTANT: If an event is tracked by both CLI and WebUI, add it here.
+ * Platform-specific events should be added to the respective platform's event map.
+ */
+export interface SharedAnalyticsEventMap {
+    dexto_llm_tokens_consumed: LLMTokensConsumedEvent;
+    dexto_message_sent: MessageSentEvent;
+    dexto_tool_called: ToolCalledEvent;
+    dexto_tool_result: ToolResultEvent;
+    dexto_session_created: SessionCreatedEvent;
+    dexto_session_reset: SessionResetEvent;
+    dexto_llm_switched: LLMSwitchedEvent;
+    dexto_session_switched: SessionSwitchedEvent;
+    dexto_agent_switched: AgentSwitchedEvent;
+    dexto_mcp_server_connected: MCPServerConnectedEvent;
+    dexto_image_attached: ImageAttachedEvent;
+}
+export type SharedAnalyticsEventName = keyof SharedAnalyticsEventMap;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/index.cjs

@@ -15,6 +15,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
@@ -28,6 +29,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_constants = require("./constants.js");
 var import_state = require("./state.js");
+__reExport(index_exports, require("./events.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMAND_TIMEOUT_MS,
@@ -35,5 +37,6 @@ var import_state = require("./state.js");
   DEFAULT_POSTHOG_KEY,
   isAnalyticsDisabled,
   loadState,
-  saveState
+  saveState,
+  ...require("./events.js")
 });

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { DEFAULT_POSTHOG_KEY, DEFAULT_POSTHOG_HOST, COMMAND_TIMEOUT_MS, isAnalyticsDisabled, } from './constants.js';
 export { loadState, saveState } from './state.js';
 export type { AnalyticsState } from './state.js';
+export * from './events.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ import {
   isAnalyticsDisabled
 } from "./constants.js";
 import { loadState, saveState } from "./state.js";
+export * from "./events.js";
 export {
   COMMAND_TIMEOUT_MS,
   DEFAULT_POSTHOG_HOST,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/analytics",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -14,8 +14,8 @@
   },
   "dependencies": {
     "node-machine-id": "^1.1.12",
-    "@dexto/agent-management": "1.4.0",
-    "@dexto/core": "1.4.0"
+    "@dexto/agent-management": "1.5.0",
+    "@dexto/core": "1.5.0"
   },
   "files": [
     "dist",