@cryptiklemur/lattice 1.4.0 → 1.6.0

package/shared/src/analytics.ts

@@ -0,0 +1,28 @@
+export interface AnalyticsPayload {
+  totalCost: number;
+  totalSessions: number;
+  totalTokens: { input: number; output: number; cacheRead: number; cacheCreation: number };
+  cacheHitRate: number;
+  avgSessionCost: number;
+  avgSessionDuration: number;
+
+  costOverTime: Array<{ date: string; total: number; opus: number; sonnet: number; haiku: number; other: number }>;
+  cumulativeCost: Array<{ date: string; total: number }>;
+  sessionsOverTime: Array<{ date: string; count: number }>;
+  tokensOverTime: Array<{ date: string; input: number; output: number; cacheRead: number }>;
+  cacheHitRateOverTime: Array<{ date: string; rate: number }>;
+
+  costDistribution: Array<{ bucket: string; count: number }>;
+  sessionBubbles: Array<{ id: string; title: string; cost: number; tokens: number; timestamp: number; project: string }>;
+
+  modelUsage: Array<{ model: string; sessions: number; cost: number; tokens: number; percentage: number }>;
+  projectBreakdown: Array<{ project: string; cost: number; sessions: number; tokens: number }>;
+  toolUsage: Array<{ tool: string; count: number; avgCost: number }>;
+
+  responseTimeData: Array<{ tokens: number; duration: number; model: string; sessionId: string }>;
+  contextUtilization: Array<{ messageIndex: number; contextPercent: number; sessionId: string; title: string }>;
+  tokenFlowSankey: { nodes: Array<{ name: string }>; links: Array<{ source: number; target: number; value: number }> };
+}
+
+export type AnalyticsPeriod = "24h" | "7d" | "30d" | "90d" | "all";
+export type AnalyticsScope = "global" | "project" | "session";

package/shared/src/index.ts

@@ -1,3 +1,4 @@
+export * from "./analytics.js";
 export * from "./constants.js";
 export * from "./messages.js";
 export * from "./models.js";

package/shared/src/messages.ts

@@ -1,3 +1,4 @@
+import type { AnalyticsPayload } from "./analytics.js";
 import type {
   FileEntry,
   HistoryMessage,
@@ -384,6 +385,30 @@ export interface SessionStopExternalMessage {
   sessionId: string;
 }
 
+export interface AnalyticsRequestMessage {
+  type: "analytics:request";
+  requestId: string;
+  scope: "global" | "project" | "session";
+  projectSlug?: string;
+  sessionId?: string;
+  period: "24h" | "7d" | "30d" | "90d" | "all";
+  forceRefresh?: boolean;
+}
+
+export interface AnalyticsDataMessage {
+  type: "analytics:data";
+  requestId: string;
+  scope: "global" | "project" | "session";
+  period: "24h" | "7d" | "30d" | "90d" | "all";
+  data: AnalyticsPayload;
+}
+
+export interface AnalyticsErrorMessage {
+  type: "analytics:error";
+  scope: "global" | "project" | "session";
+  message: string;
+}
+
 export type ClientMessage =
   | SessionCreateMessage
   | SessionActivateMessage
@@ -439,7 +464,8 @@ export type ClientMessage =
   | BrowseSuggestionsMessage
   | EditorOpenMessage
   | EditorDetectMessage
-  | ChatPromptResponseMessage;
+  | ChatPromptResponseMessage
+  | AnalyticsRequestMessage;
 
 export interface SessionListMessage {
   type: "session:list";
@@ -828,7 +854,9 @@ export type ServerMessage =
   | ChatPromptRequestMessage
   | ChatPromptResolvedMessage
   | ChatTodoUpdateMessage
-  | ChatPlanModeMessage;
+  | ChatPlanModeMessage
+  | AnalyticsDataMessage
+  | AnalyticsErrorMessage;
 
 export interface MeshHelloMessage {
   type: "mesh:hello";