@crashsense/ai 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { AIConfig, CrashEvent, AIResponse, AIPayload, ClassificationResult, CrashAnalysis } from '@crashsense/types';
+export { AIConfig, AIPayload, AIResponse, CrashAnalysis } from '@crashsense/types';
+
+declare function createAIClient(config: AIConfig): {
+    analyze(event: CrashEvent): Promise<AIResponse | null>;
+};
+
+declare function buildAIPayload(event: CrashEvent): AIPayload;
+
+declare function mergeAnalysis(heuristic: ClassificationResult, aiResponse: AIResponse | null): CrashAnalysis;
+
+declare function parseAIResponse(raw: string): AIResponse | null;
+
+declare const SYSTEM_PROMPT = "You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.\n\nYour task: Given a crash report, provide:\n1. ROOT CAUSE: The specific technical root cause (1-2 sentences)\n2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)\n3. FIX: Working code example that fixes the issue\n4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)\n5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)\n\nRules:\n- Be specific. \"Check your code\" is not acceptable. Name the exact issue.\n- Fix code must be syntactically correct and production-ready.\n- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.\n- Reference the specific component, file, or line from the stack trace.\n- Consider the system state (memory, CPU, network) as contributing factors.\n- Consider the device context (mobile, low memory, slow network).\n\nOutput ONLY valid JSON matching this schema:\n{\n  \"rootCause\": \"string\",\n  \"explanation\": \"string\",\n  \"fix\": {\n    \"description\": \"string\",\n    \"code\": \"string\",\n    \"filename\": \"string\"\n  },\n  \"prevention\": [\"string\"],\n  \"confidence\": number,\n  \"alternativeCauses\": [{\"cause\": \"string\", \"likelihood\": number}]\n}";
+
+export { SYSTEM_PROMPT, buildAIPayload, createAIClient, mergeAnalysis, parseAIResponse };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { AIConfig, CrashEvent, AIResponse, AIPayload, ClassificationResult, CrashAnalysis } from '@crashsense/types';
+export { AIConfig, AIPayload, AIResponse, CrashAnalysis } from '@crashsense/types';
+
+declare function createAIClient(config: AIConfig): {
+    analyze(event: CrashEvent): Promise<AIResponse | null>;
+};
+
+declare function buildAIPayload(event: CrashEvent): AIPayload;
+
+declare function mergeAnalysis(heuristic: ClassificationResult, aiResponse: AIResponse | null): CrashAnalysis;
+
+declare function parseAIResponse(raw: string): AIResponse | null;
+
+declare const SYSTEM_PROMPT = "You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.\n\nYour task: Given a crash report, provide:\n1. ROOT CAUSE: The specific technical root cause (1-2 sentences)\n2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)\n3. FIX: Working code example that fixes the issue\n4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)\n5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)\n\nRules:\n- Be specific. \"Check your code\" is not acceptable. Name the exact issue.\n- Fix code must be syntactically correct and production-ready.\n- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.\n- Reference the specific component, file, or line from the stack trace.\n- Consider the system state (memory, CPU, network) as contributing factors.\n- Consider the device context (mobile, low memory, slow network).\n\nOutput ONLY valid JSON matching this schema:\n{\n  \"rootCause\": \"string\",\n  \"explanation\": \"string\",\n  \"fix\": {\n    \"description\": \"string\",\n    \"code\": \"string\",\n    \"filename\": \"string\"\n  },\n  \"prevention\": [\"string\"],\n  \"confidence\": number,\n  \"alternativeCauses\": [{\"cause\": \"string\", \"likelihood\": number}]\n}";
+
+export { SYSTEM_PROMPT, buildAIPayload, createAIClient, mergeAnalysis, parseAIResponse };

package/dist/index.js

@@ -0,0 +1,251 @@
+'use strict';
+
+// src/payload-builder.ts
+function truncate(str, maxLen) {
+  return str.length > maxLen ? str.slice(0, maxLen) + "..." : str;
+}
+function formatRelativeTime(eventTimestamp, referenceTimestamp) {
+  const delta = (eventTimestamp - referenceTimestamp) / 1e3;
+  if (delta >= 0) return "0s";
+  return `${delta.toFixed(1)}s`;
+}
+function buildAIPayload(event) {
+  const stackTop5 = event.error.stack.slice(0, 5).map(
+    (f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`
+  );
+  const userCodeFrames = event.error.stack.filter((f) => f.inApp).slice(0, 5).map((f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`);
+  const memUtil = event.system.memory.utilizationPercent;
+  const memUtilStr = memUtil !== null ? `${memUtil}%` : "N/A";
+  const last5Breadcrumbs = event.breadcrumbs.slice(-5).map((bc) => ({
+    type: bc.type,
+    message: truncate(bc.message, 100),
+    time: formatRelativeTime(bc.timestamp, event.timestamp)
+  }));
+  return {
+    crash_summary: {
+      category: event.category,
+      subcategory: event.subcategory,
+      heuristic_confidence: event.confidence,
+      severity: event.severity
+    },
+    error: {
+      type: event.error.type,
+      message: truncate(event.error.message, 500),
+      stack_top_5: stackTop5,
+      user_code_frames: userCodeFrames
+    },
+    system_state: {
+      memory_utilization: memUtilStr,
+      memory_trend: event.system.memory.trend,
+      long_tasks_last_30s: event.system.cpu.longTasksLast30s,
+      fps_at_crash: event.system.eventLoop.fps,
+      pending_network_requests: event.system.network.pendingRequests,
+      failed_requests_last_60s: event.system.network.failedRequestsLast60s
+    },
+    device: {
+      platform: truncate(event.device.userAgent, 80),
+      memory: event.device.deviceMemory !== null ? `${event.device.deviceMemory}GB` : "N/A",
+      viewport: `${event.device.viewport.width}x${event.device.viewport.height}`,
+      connection: event.system.network.connectionType ?? "unknown"
+    },
+    framework: {
+      name: event.framework.name,
+      version: event.framework.version,
+      lifecycle_stage: event.framework.lifecycleStage ?? "unknown",
+      component_path: event.framework.componentTree ?? [],
+      render_count_since_nav: event.framework.renderCount ?? 0
+    },
+    breadcrumbs_last_5: last5Breadcrumbs,
+    contributing_factors: event.contributingFactors.map((f) => ({
+      factor: f.factor,
+      weight: f.weight,
+      evidence: truncate(f.evidence, 150)
+    }))
+  };
+}
+
+// src/prompt.ts
+var SYSTEM_PROMPT = `You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.
+
+Your task: Given a crash report, provide:
+1. ROOT CAUSE: The specific technical root cause (1-2 sentences)
+2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)
+3. FIX: Working code example that fixes the issue
+4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)
+5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)
+
+Rules:
+- Be specific. "Check your code" is not acceptable. Name the exact issue.
+- Fix code must be syntactically correct and production-ready.
+- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.
+- Reference the specific component, file, or line from the stack trace.
+- Consider the system state (memory, CPU, network) as contributing factors.
+- Consider the device context (mobile, low memory, slow network).
+
+Output ONLY valid JSON matching this schema:
+{
+  "rootCause": "string",
+  "explanation": "string",
+  "fix": {
+    "description": "string",
+    "code": "string",
+    "filename": "string"
+  },
+  "prevention": ["string"],
+  "confidence": number,
+  "alternativeCauses": [{"cause": "string", "likelihood": number}]
+}`;
+function buildMessages(payload) {
+  return [
+    { role: "system", content: SYSTEM_PROMPT },
+    { role: "user", content: JSON.stringify(payload, null, 2) }
+  ];
+}
+
+// src/response-parser.ts
+function extractJsonFromMarkdown(raw) {
+  const codeBlockMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+  if (codeBlockMatch) return codeBlockMatch[1].trim();
+  return raw.trim();
+}
+function isValidAIResponse(obj) {
+  if (typeof obj !== "object" || obj === null) return false;
+  const o = obj;
+  if (typeof o.rootCause !== "string") return false;
+  if (typeof o.explanation !== "string") return false;
+  if (typeof o.confidence !== "number" || o.confidence < 0 || o.confidence > 1) return false;
+  if (!Array.isArray(o.prevention)) return false;
+  if (o.fix !== null && o.fix !== void 0) {
+    const fix = o.fix;
+    if (typeof fix.description !== "string") return false;
+    if (typeof fix.code !== "string") return false;
+    if (typeof fix.filename !== "string") return false;
+  }
+  if (!Array.isArray(o.alternativeCauses)) return false;
+  return true;
+}
+function parseAIResponse(raw) {
+  try {
+    const jsonStr = extractJsonFromMarkdown(raw);
+    const parsed = JSON.parse(jsonStr);
+    if (!isValidAIResponse(parsed)) return null;
+    return {
+      rootCause: parsed.rootCause,
+      explanation: parsed.explanation,
+      fix: parsed.fix ?? { description: "", code: "", filename: "" },
+      prevention: parsed.prevention,
+      confidence: Math.min(1, Math.max(0, parsed.confidence)),
+      alternativeCauses: parsed.alternativeCauses ?? []
+    };
+  } catch {
+    return null;
+  }
+}
+
+// src/client.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function createAIClient(config) {
+  const timeout = config.timeout ?? 3e4;
+  const maxRetries = config.retries ?? 2;
+  async function sendRequest(event) {
+    const payload = buildAIPayload(event);
+    const messages = buildMessages(payload);
+    const body = {
+      messages,
+      temperature: config.temperature ?? 0.1,
+      max_tokens: config.maxTokens ?? 2e3
+    };
+    if (config.model) {
+      body.model = config.model;
+    }
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), timeout);
+      try {
+        const response = await fetch(config.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${config.apiKey}`
+          },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          if (attempt < maxRetries) {
+            await sleep(1e3 * (attempt + 1));
+            continue;
+          }
+          return null;
+        }
+        const data = await response.json();
+        return data.choices?.[0]?.message?.content ?? null;
+      } catch {
+        clearTimeout(timeoutId);
+        if (attempt < maxRetries) {
+          await sleep(1e3 * (attempt + 1));
+          continue;
+        }
+        return null;
+      }
+    }
+    return null;
+  }
+  return {
+    async analyze(event) {
+      const rawResponse = await sendRequest(event);
+      if (!rawResponse) return null;
+      return parseAIResponse(rawResponse);
+    }
+  };
+}
+
+// src/hybrid-merger.ts
+function generateHeuristicExplanation(classification) {
+  const { category, subcategory, confidence } = classification;
+  return `Heuristic analysis identified this as a ${category} issue (${subcategory}) with ${(confidence * 100).toFixed(0)}% confidence. ` + classification.contributingFactors.map((f) => f.evidence).join(" ");
+}
+function mergeAnalysis(heuristic, aiResponse) {
+  if (!aiResponse) {
+    return {
+      rootCause: `${heuristic.category}: ${heuristic.subcategory}`,
+      explanation: generateHeuristicExplanation(heuristic),
+      fix: null,
+      prevention: [],
+      confidence: heuristic.confidence,
+      alternativeCauses: [],
+      source: "heuristic"
+    };
+  }
+  if (aiResponse.confidence > 0.8) {
+    return {
+      rootCause: aiResponse.rootCause,
+      explanation: aiResponse.explanation,
+      fix: aiResponse.fix,
+      prevention: aiResponse.prevention,
+      confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,
+      alternativeCauses: aiResponse.alternativeCauses,
+      source: "ai"
+    };
+  }
+  return {
+    rootCause: aiResponse.rootCause || `${heuristic.category}: ${heuristic.subcategory}`,
+    explanation: aiResponse.explanation || generateHeuristicExplanation(heuristic),
+    fix: aiResponse.fix,
+    prevention: aiResponse.prevention,
+    confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,
+    alternativeCauses: aiResponse.alternativeCauses,
+    source: "hybrid"
+  };
+}
+
+exports.SYSTEM_PROMPT = SYSTEM_PROMPT;
+exports.buildAIPayload = buildAIPayload;
+exports.createAIClient = createAIClient;
+exports.mergeAnalysis = mergeAnalysis;
+exports.parseAIResponse = parseAIResponse;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/payload-builder.ts","../src/prompt.ts","../src/response-parser.ts","../src/client.ts","../src/hybrid-merger.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { CrashEvent, AIPayload } from '@crashsense/types';\n\nfunction truncate(str: string, maxLen: number): string {\n  return str.length > maxLen ? str.slice(0, maxLen) + '...' : str;\n}\n\nfunction formatRelativeTime(eventTimestamp: number, referenceTimestamp: number): string {\n  const delta = (eventTimestamp - referenceTimestamp) / 1000;\n  if (delta >= 0) return '0s';\n  return `${delta.toFixed(1)}s`;\n}\n\nexport function buildAIPayload(event: CrashEvent): AIPayload {\n  const stackTop5 = event.error.stack.slice(0, 5).map(\n    (f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`,\n  );\n\n  const userCodeFrames = event.error.stack\n    .filter((f) => f.inApp)\n    .slice(0, 5)\n    .map((f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`);\n\n  const memUtil = event.system.memory.utilizationPercent;\n  const memUtilStr = memUtil !== null ? `${memUtil}%` : 'N/A';\n\n  const last5Breadcrumbs = event.breadcrumbs.slice(-5).map((bc) => ({\n    type: bc.type,\n    message: truncate(bc.message, 100),\n    time: formatRelativeTime(bc.timestamp, event.timestamp),\n  }));\n\n  return {\n    crash_summary: {\n      category: event.category,\n      subcategory: event.subcategory,\n      heuristic_confidence: event.confidence,\n      severity: event.severity,\n    },\n    error: {\n      type: event.error.type,\n      message: truncate(event.error.message, 500),\n      stack_top_5: stackTop5,\n      user_code_frames: userCodeFrames,\n    },\n    system_state: {\n      memory_utilization: memUtilStr,\n      memory_trend: event.system.memory.trend,\n      long_tasks_last_30s: event.system.cpu.longTasksLast30s,\n      fps_at_crash: event.system.eventLoop.fps,\n      pending_network_requests: event.system.network.pendingRequests,\n      failed_requests_last_60s: event.system.network.failedRequestsLast60s,\n    },\n    device: {\n      platform: truncate(event.device.userAgent, 80),\n      memory: event.device.deviceMemory !== null ? `${event.device.deviceMemory}GB` : 'N/A',\n      viewport: `${event.device.viewport.width}x${event.device.viewport.height}`,\n      connection: event.system.network.connectionType ?? 'unknown',\n    },\n    framework: {\n      name: event.framework.name,\n      version: event.framework.version,\n      lifecycle_stage: event.framework.lifecycleStage ?? 'unknown',\n      component_path: event.framework.componentTree ?? [],\n      render_count_since_nav: event.framework.renderCount ?? 0,\n    },\n    breadcrumbs_last_5: last5Breadcrumbs,\n    contributing_factors: event.contributingFactors.map((f) => ({\n      factor: f.factor,\n      weight: f.weight,\n      evidence: truncate(f.evidence, 150),\n    })),\n  };\n}\n","import type { AIPayload } from '@crashsense/types';\n\nexport const SYSTEM_PROMPT = `You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.\n\nYour task: Given a crash report, provide:\n1. ROOT CAUSE: The specific technical root cause (1-2 sentences)\n2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)\n3. FIX: Working code example that fixes the issue\n4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)\n5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)\n\nRules:\n- Be specific. \"Check your code\" is not acceptable. Name the exact issue.\n- Fix code must be syntactically correct and production-ready.\n- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.\n- Reference the specific component, file, or line from the stack trace.\n- Consider the system state (memory, CPU, network) as contributing factors.\n- Consider the device context (mobile, low memory, slow network).\n\nOutput ONLY valid JSON matching this schema:\n{\n  \"rootCause\": \"string\",\n  \"explanation\": \"string\",\n  \"fix\": {\n    \"description\": \"string\",\n    \"code\": \"string\",\n    \"filename\": \"string\"\n  },\n  \"prevention\": [\"string\"],\n  \"confidence\": number,\n  \"alternativeCauses\": [{\"cause\": \"string\", \"likelihood\": number}]\n}`;\n\nexport function buildMessages(\n  payload: AIPayload,\n): Array<{ role: string; content: string }> {\n  return [\n    { role: 'system', content: SYSTEM_PROMPT },\n    { role: 'user', content: JSON.stringify(payload, null, 2) },\n  ];\n}\n","import type { AIResponse } from '@crashsense/types';\n\nfunction extractJsonFromMarkdown(raw: string): string {\n  const codeBlockMatch = raw.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?```/);\n  if (codeBlockMatch) return codeBlockMatch[1].trim();\n  return raw.trim();\n}\n\nfunction isValidAIResponse(obj: unknown): obj is AIResponse {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const o = obj as Record<string, unknown>;\n\n  if (typeof o.rootCause !== 'string') return false;\n  if (typeof o.explanation !== 'string') return false;\n  if (typeof o.confidence !== 'number' || o.confidence < 0 || o.confidence > 1) return false;\n  if (!Array.isArray(o.prevention)) return false;\n\n  if (o.fix !== null && o.fix !== undefined) {\n    const fix = o.fix as Record<string, unknown>;\n    if (typeof fix.description !== 'string') return false;\n    if (typeof fix.code !== 'string') return false;\n    if (typeof fix.filename !== 'string') return false;\n  }\n\n  if (!Array.isArray(o.alternativeCauses)) return false;\n\n  return true;\n}\n\nexport function parseAIResponse(raw: string): AIResponse | null {\n  try {\n    const jsonStr = extractJsonFromMarkdown(raw);\n    const parsed = JSON.parse(jsonStr);\n\n    if (!isValidAIResponse(parsed)) return null;\n\n    return {\n      rootCause: parsed.rootCause,\n      explanation: parsed.explanation,\n      fix: parsed.fix ?? { description: '', code: '', filename: '' },\n      prevention: parsed.prevention,\n      confidence: Math.min(1, Math.max(0, parsed.confidence)),\n      alternativeCauses: parsed.alternativeCauses ?? [],\n    };\n  } catch {\n    return null;\n  }\n}\n","import type { AIConfig, AIResponse, CrashEvent } from '@crashsense/types';\nimport { buildAIPayload } from './payload-builder';\nimport { buildMessages } from './prompt';\nimport { parseAIResponse } from './response-parser';\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport function createAIClient(config: AIConfig) {\n  const timeout = config.timeout ?? 30000;\n  const maxRetries = config.retries ?? 2;\n\n  async function sendRequest(event: CrashEvent): Promise<string | null> {\n    const payload = buildAIPayload(event);\n    const messages = buildMessages(payload);\n\n    const body: Record<string, unknown> = {\n      messages,\n      temperature: config.temperature ?? 0.1,\n      max_tokens: config.maxTokens ?? 2000,\n    };\n\n    if (config.model) {\n      body.model = config.model;\n    }\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n      try {\n        const response = await fetch(config.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'Authorization': `Bearer ${config.apiKey}`,\n          },\n          body: JSON.stringify(body),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!response.ok) {\n          if (attempt < maxRetries) {\n            await sleep(1000 * (attempt + 1));\n            continue;\n          }\n          return null;\n        }\n\n        const data = await response.json() as {\n          choices?: Array<{ message?: { content?: string } }>;\n        };\n\n        return data.choices?.[0]?.message?.content ?? null;\n      } catch {\n        clearTimeout(timeoutId);\n        if (attempt < maxRetries) {\n          await sleep(1000 * (attempt + 1));\n          continue;\n        }\n        return null;\n      }\n    }\n\n    return null;\n  }\n\n  return {\n    async analyze(event: CrashEvent): Promise<AIResponse | null> {\n      const rawResponse = await sendRequest(event);\n      if (!rawResponse) return null;\n      return parseAIResponse(rawResponse);\n    },\n  };\n}\n","import type { ClassificationResult, AIResponse, CrashAnalysis } from '@crashsense/types';\n\nfunction generateHeuristicExplanation(classification: ClassificationResult): string {\n  const { category, subcategory, confidence } = classification;\n  return `Heuristic analysis identified this as a ${category} issue (${subcategory}) ` +\n    `with ${(confidence * 100).toFixed(0)}% confidence. ` +\n    classification.contributingFactors\n      .map((f) => f.evidence)\n      .join(' ');\n}\n\nexport function mergeAnalysis(\n  heuristic: ClassificationResult,\n  aiResponse: AIResponse | null,\n): CrashAnalysis {\n  if (!aiResponse) {\n    return {\n      rootCause: `${heuristic.category}: ${heuristic.subcategory}`,\n      explanation: generateHeuristicExplanation(heuristic),\n      fix: null,\n      prevention: [],\n      confidence: heuristic.confidence,\n      alternativeCauses: [],\n      source: 'heuristic',\n    };\n  }\n\n  if (aiResponse.confidence > 0.8) {\n    return {\n      rootCause: aiResponse.rootCause,\n      explanation: aiResponse.explanation,\n      fix: aiResponse.fix,\n      prevention: aiResponse.prevention,\n      confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,\n      alternativeCauses: aiResponse.alternativeCauses,\n      source: 'ai',\n    };\n  }\n\n  return {\n    rootCause: aiResponse.rootCause || `${heuristic.category}: ${heuristic.subcategory}`,\n    explanation: aiResponse.explanation || generateHeuristicExplanation(heuristic),\n    fix: aiResponse.fix,\n    prevention: aiResponse.prevention,\n    confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,\n    alternativeCauses: aiResponse.alternativeCauses,\n    source: 'hybrid',\n  };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,245 @@
+// src/payload-builder.ts
+function truncate(str, maxLen) {
+  return str.length > maxLen ? str.slice(0, maxLen) + "..." : str;
+}
+function formatRelativeTime(eventTimestamp, referenceTimestamp) {
+  const delta = (eventTimestamp - referenceTimestamp) / 1e3;
+  if (delta >= 0) return "0s";
+  return `${delta.toFixed(1)}s`;
+}
+function buildAIPayload(event) {
+  const stackTop5 = event.error.stack.slice(0, 5).map(
+    (f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`
+  );
+  const userCodeFrames = event.error.stack.filter((f) => f.inApp).slice(0, 5).map((f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`);
+  const memUtil = event.system.memory.utilizationPercent;
+  const memUtilStr = memUtil !== null ? `${memUtil}%` : "N/A";
+  const last5Breadcrumbs = event.breadcrumbs.slice(-5).map((bc) => ({
+    type: bc.type,
+    message: truncate(bc.message, 100),
+    time: formatRelativeTime(bc.timestamp, event.timestamp)
+  }));
+  return {
+    crash_summary: {
+      category: event.category,
+      subcategory: event.subcategory,
+      heuristic_confidence: event.confidence,
+      severity: event.severity
+    },
+    error: {
+      type: event.error.type,
+      message: truncate(event.error.message, 500),
+      stack_top_5: stackTop5,
+      user_code_frames: userCodeFrames
+    },
+    system_state: {
+      memory_utilization: memUtilStr,
+      memory_trend: event.system.memory.trend,
+      long_tasks_last_30s: event.system.cpu.longTasksLast30s,
+      fps_at_crash: event.system.eventLoop.fps,
+      pending_network_requests: event.system.network.pendingRequests,
+      failed_requests_last_60s: event.system.network.failedRequestsLast60s
+    },
+    device: {
+      platform: truncate(event.device.userAgent, 80),
+      memory: event.device.deviceMemory !== null ? `${event.device.deviceMemory}GB` : "N/A",
+      viewport: `${event.device.viewport.width}x${event.device.viewport.height}`,
+      connection: event.system.network.connectionType ?? "unknown"
+    },
+    framework: {
+      name: event.framework.name,
+      version: event.framework.version,
+      lifecycle_stage: event.framework.lifecycleStage ?? "unknown",
+      component_path: event.framework.componentTree ?? [],
+      render_count_since_nav: event.framework.renderCount ?? 0
+    },
+    breadcrumbs_last_5: last5Breadcrumbs,
+    contributing_factors: event.contributingFactors.map((f) => ({
+      factor: f.factor,
+      weight: f.weight,
+      evidence: truncate(f.evidence, 150)
+    }))
+  };
+}
+
+// src/prompt.ts
+var SYSTEM_PROMPT = `You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.
+
+Your task: Given a crash report, provide:
+1. ROOT CAUSE: The specific technical root cause (1-2 sentences)
+2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)
+3. FIX: Working code example that fixes the issue
+4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)
+5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)
+
+Rules:
+- Be specific. "Check your code" is not acceptable. Name the exact issue.
+- Fix code must be syntactically correct and production-ready.
+- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.
+- Reference the specific component, file, or line from the stack trace.
+- Consider the system state (memory, CPU, network) as contributing factors.
+- Consider the device context (mobile, low memory, slow network).
+
+Output ONLY valid JSON matching this schema:
+{
+  "rootCause": "string",
+  "explanation": "string",
+  "fix": {
+    "description": "string",
+    "code": "string",
+    "filename": "string"
+  },
+  "prevention": ["string"],
+  "confidence": number,
+  "alternativeCauses": [{"cause": "string", "likelihood": number}]
+}`;
+function buildMessages(payload) {
+  return [
+    { role: "system", content: SYSTEM_PROMPT },
+    { role: "user", content: JSON.stringify(payload, null, 2) }
+  ];
+}
+
+// src/response-parser.ts
+function extractJsonFromMarkdown(raw) {
+  const codeBlockMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+  if (codeBlockMatch) return codeBlockMatch[1].trim();
+  return raw.trim();
+}
+function isValidAIResponse(obj) {
+  if (typeof obj !== "object" || obj === null) return false;
+  const o = obj;
+  if (typeof o.rootCause !== "string") return false;
+  if (typeof o.explanation !== "string") return false;
+  if (typeof o.confidence !== "number" || o.confidence < 0 || o.confidence > 1) return false;
+  if (!Array.isArray(o.prevention)) return false;
+  if (o.fix !== null && o.fix !== void 0) {
+    const fix = o.fix;
+    if (typeof fix.description !== "string") return false;
+    if (typeof fix.code !== "string") return false;
+    if (typeof fix.filename !== "string") return false;
+  }
+  if (!Array.isArray(o.alternativeCauses)) return false;
+  return true;
+}
+function parseAIResponse(raw) {
+  try {
+    const jsonStr = extractJsonFromMarkdown(raw);
+    const parsed = JSON.parse(jsonStr);
+    if (!isValidAIResponse(parsed)) return null;
+    return {
+      rootCause: parsed.rootCause,
+      explanation: parsed.explanation,
+      fix: parsed.fix ?? { description: "", code: "", filename: "" },
+      prevention: parsed.prevention,
+      confidence: Math.min(1, Math.max(0, parsed.confidence)),
+      alternativeCauses: parsed.alternativeCauses ?? []
+    };
+  } catch {
+    return null;
+  }
+}
+
+// src/client.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function createAIClient(config) {
+  const timeout = config.timeout ?? 3e4;
+  const maxRetries = config.retries ?? 2;
+  async function sendRequest(event) {
+    const payload = buildAIPayload(event);
+    const messages = buildMessages(payload);
+    const body = {
+      messages,
+      temperature: config.temperature ?? 0.1,
+      max_tokens: config.maxTokens ?? 2e3
+    };
+    if (config.model) {
+      body.model = config.model;
+    }
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), timeout);
+      try {
+        const response = await fetch(config.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${config.apiKey}`
+          },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          if (attempt < maxRetries) {
+            await sleep(1e3 * (attempt + 1));
+            continue;
+          }
+          return null;
+        }
+        const data = await response.json();
+        return data.choices?.[0]?.message?.content ?? null;
+      } catch {
+        clearTimeout(timeoutId);
+        if (attempt < maxRetries) {
+          await sleep(1e3 * (attempt + 1));
+          continue;
+        }
+        return null;
+      }
+    }
+    return null;
+  }
+  return {
+    async analyze(event) {
+      const rawResponse = await sendRequest(event);
+      if (!rawResponse) return null;
+      return parseAIResponse(rawResponse);
+    }
+  };
+}
+
+// src/hybrid-merger.ts
+function generateHeuristicExplanation(classification) {
+  const { category, subcategory, confidence } = classification;
+  return `Heuristic analysis identified this as a ${category} issue (${subcategory}) with ${(confidence * 100).toFixed(0)}% confidence. ` + classification.contributingFactors.map((f) => f.evidence).join(" ");
+}
+function mergeAnalysis(heuristic, aiResponse) {
+  if (!aiResponse) {
+    return {
+      rootCause: `${heuristic.category}: ${heuristic.subcategory}`,
+      explanation: generateHeuristicExplanation(heuristic),
+      fix: null,
+      prevention: [],
+      confidence: heuristic.confidence,
+      alternativeCauses: [],
+      source: "heuristic"
+    };
+  }
+  if (aiResponse.confidence > 0.8) {
+    return {
+      rootCause: aiResponse.rootCause,
+      explanation: aiResponse.explanation,
+      fix: aiResponse.fix,
+      prevention: aiResponse.prevention,
+      confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,
+      alternativeCauses: aiResponse.alternativeCauses,
+      source: "ai"
+    };
+  }
+  return {
+    rootCause: aiResponse.rootCause || `${heuristic.category}: ${heuristic.subcategory}`,
+    explanation: aiResponse.explanation || generateHeuristicExplanation(heuristic),
+    fix: aiResponse.fix,
+    prevention: aiResponse.prevention,
+    confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,
+    alternativeCauses: aiResponse.alternativeCauses,
+    source: "hybrid"
+  };
+}
+
+export { SYSTEM_PROMPT, buildAIPayload, createAIClient, mergeAnalysis, parseAIResponse };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/payload-builder.ts","../src/prompt.ts","../src/response-parser.ts","../src/client.ts","../src/hybrid-merger.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { CrashEvent, AIPayload } from '@crashsense/types';\n\nfunction truncate(str: string, maxLen: number): string {\n  return str.length > maxLen ? str.slice(0, maxLen) + '...' : str;\n}\n\nfunction formatRelativeTime(eventTimestamp: number, referenceTimestamp: number): string {\n  const delta = (eventTimestamp - referenceTimestamp) / 1000;\n  if (delta >= 0) return '0s';\n  return `${delta.toFixed(1)}s`;\n}\n\nexport function buildAIPayload(event: CrashEvent): AIPayload {\n  const stackTop5 = event.error.stack.slice(0, 5).map(\n    (f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`,\n  );\n\n  const userCodeFrames = event.error.stack\n    .filter((f) => f.inApp)\n    .slice(0, 5)\n    .map((f) => `at ${f.function} (${f.filename}:${f.lineno}:${f.colno})`);\n\n  const memUtil = event.system.memory.utilizationPercent;\n  const memUtilStr = memUtil !== null ? `${memUtil}%` : 'N/A';\n\n  const last5Breadcrumbs = event.breadcrumbs.slice(-5).map((bc) => ({\n    type: bc.type,\n    message: truncate(bc.message, 100),\n    time: formatRelativeTime(bc.timestamp, event.timestamp),\n  }));\n\n  return {\n    crash_summary: {\n      category: event.category,\n      subcategory: event.subcategory,\n      heuristic_confidence: event.confidence,\n      severity: event.severity,\n    },\n    error: {\n      type: event.error.type,\n      message: truncate(event.error.message, 500),\n      stack_top_5: stackTop5,\n      user_code_frames: userCodeFrames,\n    },\n    system_state: {\n      memory_utilization: memUtilStr,\n      memory_trend: event.system.memory.trend,\n      long_tasks_last_30s: event.system.cpu.longTasksLast30s,\n      fps_at_crash: event.system.eventLoop.fps,\n      pending_network_requests: event.system.network.pendingRequests,\n      failed_requests_last_60s: event.system.network.failedRequestsLast60s,\n    },\n    device: {\n      platform: truncate(event.device.userAgent, 80),\n      memory: event.device.deviceMemory !== null ? `${event.device.deviceMemory}GB` : 'N/A',\n      viewport: `${event.device.viewport.width}x${event.device.viewport.height}`,\n      connection: event.system.network.connectionType ?? 'unknown',\n    },\n    framework: {\n      name: event.framework.name,\n      version: event.framework.version,\n      lifecycle_stage: event.framework.lifecycleStage ?? 'unknown',\n      component_path: event.framework.componentTree ?? [],\n      render_count_since_nav: event.framework.renderCount ?? 0,\n    },\n    breadcrumbs_last_5: last5Breadcrumbs,\n    contributing_factors: event.contributingFactors.map((f) => ({\n      factor: f.factor,\n      weight: f.weight,\n      evidence: truncate(f.evidence, 150),\n    })),\n  };\n}\n","import type { AIPayload } from '@crashsense/types';\n\nexport const SYSTEM_PROMPT = `You are CrashSense AI, a specialized web application crash diagnostician. You analyze structured crash reports from JavaScript web applications (React, Vue, vanilla JS) running in browsers and mobile WebViews.\n\nYour task: Given a crash report, provide:\n1. ROOT CAUSE: The specific technical root cause (1-2 sentences)\n2. EXPLANATION: Why this happened, including the chain of events (3-5 sentences)\n3. FIX: Working code example that fixes the issue\n4. PREVENTION: How to prevent this class of bug in the future (2-3 bullet points)\n5. CONFIDENCE: Your confidence in this diagnosis (0.0-1.0)\n\nRules:\n- Be specific. \"Check your code\" is not acceptable. Name the exact issue.\n- Fix code must be syntactically correct and production-ready.\n- If you are not confident (< 0.6), say so and list the top 2-3 possible causes.\n- Reference the specific component, file, or line from the stack trace.\n- Consider the system state (memory, CPU, network) as contributing factors.\n- Consider the device context (mobile, low memory, slow network).\n\nOutput ONLY valid JSON matching this schema:\n{\n  \"rootCause\": \"string\",\n  \"explanation\": \"string\",\n  \"fix\": {\n    \"description\": \"string\",\n    \"code\": \"string\",\n    \"filename\": \"string\"\n  },\n  \"prevention\": [\"string\"],\n  \"confidence\": number,\n  \"alternativeCauses\": [{\"cause\": \"string\", \"likelihood\": number}]\n}`;\n\nexport function buildMessages(\n  payload: AIPayload,\n): Array<{ role: string; content: string }> {\n  return [\n    { role: 'system', content: SYSTEM_PROMPT },\n    { role: 'user', content: JSON.stringify(payload, null, 2) },\n  ];\n}\n","import type { AIResponse } from '@crashsense/types';\n\nfunction extractJsonFromMarkdown(raw: string): string {\n  const codeBlockMatch = raw.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?```/);\n  if (codeBlockMatch) return codeBlockMatch[1].trim();\n  return raw.trim();\n}\n\nfunction isValidAIResponse(obj: unknown): obj is AIResponse {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const o = obj as Record<string, unknown>;\n\n  if (typeof o.rootCause !== 'string') return false;\n  if (typeof o.explanation !== 'string') return false;\n  if (typeof o.confidence !== 'number' || o.confidence < 0 || o.confidence > 1) return false;\n  if (!Array.isArray(o.prevention)) return false;\n\n  if (o.fix !== null && o.fix !== undefined) {\n    const fix = o.fix as Record<string, unknown>;\n    if (typeof fix.description !== 'string') return false;\n    if (typeof fix.code !== 'string') return false;\n    if (typeof fix.filename !== 'string') return false;\n  }\n\n  if (!Array.isArray(o.alternativeCauses)) return false;\n\n  return true;\n}\n\nexport function parseAIResponse(raw: string): AIResponse | null {\n  try {\n    const jsonStr = extractJsonFromMarkdown(raw);\n    const parsed = JSON.parse(jsonStr);\n\n    if (!isValidAIResponse(parsed)) return null;\n\n    return {\n      rootCause: parsed.rootCause,\n      explanation: parsed.explanation,\n      fix: parsed.fix ?? { description: '', code: '', filename: '' },\n      prevention: parsed.prevention,\n      confidence: Math.min(1, Math.max(0, parsed.confidence)),\n      alternativeCauses: parsed.alternativeCauses ?? [],\n    };\n  } catch {\n    return null;\n  }\n}\n","import type { AIConfig, AIResponse, CrashEvent } from '@crashsense/types';\nimport { buildAIPayload } from './payload-builder';\nimport { buildMessages } from './prompt';\nimport { parseAIResponse } from './response-parser';\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport function createAIClient(config: AIConfig) {\n  const timeout = config.timeout ?? 30000;\n  const maxRetries = config.retries ?? 2;\n\n  async function sendRequest(event: CrashEvent): Promise<string | null> {\n    const payload = buildAIPayload(event);\n    const messages = buildMessages(payload);\n\n    const body: Record<string, unknown> = {\n      messages,\n      temperature: config.temperature ?? 0.1,\n      max_tokens: config.maxTokens ?? 2000,\n    };\n\n    if (config.model) {\n      body.model = config.model;\n    }\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n      try {\n        const response = await fetch(config.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'Authorization': `Bearer ${config.apiKey}`,\n          },\n          body: JSON.stringify(body),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!response.ok) {\n          if (attempt < maxRetries) {\n            await sleep(1000 * (attempt + 1));\n            continue;\n          }\n          return null;\n        }\n\n        const data = await response.json() as {\n          choices?: Array<{ message?: { content?: string } }>;\n        };\n\n        return data.choices?.[0]?.message?.content ?? null;\n      } catch {\n        clearTimeout(timeoutId);\n        if (attempt < maxRetries) {\n          await sleep(1000 * (attempt + 1));\n          continue;\n        }\n        return null;\n      }\n    }\n\n    return null;\n  }\n\n  return {\n    async analyze(event: CrashEvent): Promise<AIResponse | null> {\n      const rawResponse = await sendRequest(event);\n      if (!rawResponse) return null;\n      return parseAIResponse(rawResponse);\n    },\n  };\n}\n","import type { ClassificationResult, AIResponse, CrashAnalysis } from '@crashsense/types';\n\nfunction generateHeuristicExplanation(classification: ClassificationResult): string {\n  const { category, subcategory, confidence } = classification;\n  return `Heuristic analysis identified this as a ${category} issue (${subcategory}) ` +\n    `with ${(confidence * 100).toFixed(0)}% confidence. ` +\n    classification.contributingFactors\n      .map((f) => f.evidence)\n      .join(' ');\n}\n\nexport function mergeAnalysis(\n  heuristic: ClassificationResult,\n  aiResponse: AIResponse | null,\n): CrashAnalysis {\n  if (!aiResponse) {\n    return {\n      rootCause: `${heuristic.category}: ${heuristic.subcategory}`,\n      explanation: generateHeuristicExplanation(heuristic),\n      fix: null,\n      prevention: [],\n      confidence: heuristic.confidence,\n      alternativeCauses: [],\n      source: 'heuristic',\n    };\n  }\n\n  if (aiResponse.confidence > 0.8) {\n    return {\n      rootCause: aiResponse.rootCause,\n      explanation: aiResponse.explanation,\n      fix: aiResponse.fix,\n      prevention: aiResponse.prevention,\n      confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,\n      alternativeCauses: aiResponse.alternativeCauses,\n      source: 'ai',\n    };\n  }\n\n  return {\n    rootCause: aiResponse.rootCause || `${heuristic.category}: ${heuristic.subcategory}`,\n    explanation: aiResponse.explanation || generateHeuristicExplanation(heuristic),\n    fix: aiResponse.fix,\n    prevention: aiResponse.prevention,\n    confidence: heuristic.confidence * 0.4 + aiResponse.confidence * 0.6,\n    alternativeCauses: aiResponse.alternativeCauses,\n    source: 'hybrid',\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@crashsense/ai",
+  "version": "0.1.0",
+  "description": "CrashSense AI integration — LLM client, crash payload builder, response parser",
+  "author": "hoainho <nhoxtvt@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hoainho/crashsense.git",
+    "directory": "packages/ai"
+  },
+  "homepage": "https://github.com/hoainho/crashsense/tree/main/packages/ai",
+  "bugs": {
+    "url": "https://github.com/hoainho/crashsense/issues"
+  },
+  "keywords": [
+    "crashsense",
+    "ai",
+    "llm",
+    "crash-analysis",
+    "root-cause-analysis",
+    "openai",
+    "anthropic"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@crashsense/types": "*"
+  },
+  "sideEffects": false
+}