npm - agent-trace - Versions diffs - 0.2.12 → 0.3.0 - Mend

agent-trace 0.2.12 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/agent-trace.cjs +830 -21
package/package.json +1 -1

package/agent-trace.cjs CHANGED Viewed

@@ -24130,6 +24130,40 @@ th{color:var(--text-dim);font-size:10px;text-transform:uppercase;letter-spacing:
 .pr-repo{color:var(--text-muted)}
 .pr-link{color:var(--text-dim);text-decoration:none;font-size:11px}
 .pr-link:hover{color:var(--cyan);text-decoration:underline}
+.settings-btn{position:absolute;right:16px;top:16px;background:var(--panel-muted);border:1px solid var(--panel-border);border-radius:6px;padding:6px 10px;cursor:pointer;color:var(--text-muted);font-size:12px;font-family:inherit;display:flex;align-items:center;gap:4px;transition:border-color .15s,color .15s}
+.settings-btn:hover{border-color:var(--green);color:var(--green)}
+.settings-btn svg{width:14px;height:14px}
+.modal-overlay{display:none;position:fixed;inset:0;background:rgba(0,0,0,.7);z-index:1000;justify-content:center;align-items:center}
+.modal-overlay.open{display:flex}
+.modal{background:var(--panel);border:1px solid var(--panel-border);border-radius:10px;padding:20px;width:420px;max-width:90vw;position:relative}
+.modal h3{margin:0 0 16px;font-size:14px;font-weight:600;color:var(--text-primary)}
+.modal-close{position:absolute;right:12px;top:12px;background:none;border:none;color:var(--text-dim);font-size:18px;cursor:pointer;padding:4px 8px;border-radius:4px}
+.modal-close:hover{color:var(--text-primary);background:var(--panel-hover)}
+.modal label{display:block;font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--text-dim);margin-bottom:4px;margin-top:12px}
+.modal select,.modal input{width:100%;box-sizing:border-box;padding:8px 10px;background:var(--bg);border:1px solid var(--panel-border);border-radius:6px;color:var(--text-primary);font-size:12px;font-family:inherit}
+.modal select:focus,.modal input:focus{outline:none;border-color:var(--green)}
+.modal-actions{margin-top:16px;display:flex;gap:8px;align-items:center}
+.modal-save{padding:8px 16px;background:var(--green);color:#000;border:none;border-radius:6px;font-size:12px;font-weight:600;cursor:pointer;font-family:inherit}
+.modal-save:hover{opacity:.9}
+.modal-save:disabled{opacity:.5;cursor:not-allowed}
+.modal-status{font-size:11px;color:var(--text-muted);flex:1}
+.modal-status.error{color:var(--red)}
+.modal-status.ok{color:var(--green)}
+.insight-panel{border:1px solid rgba(192,132,252,.2);border-radius:8px;padding:12px;margin-bottom:12px;background:rgba(192,132,252,.04)}
+.insight-hd{display:flex;align-items:center;justify-content:space-between;margin-bottom:8px}
+.insight-title{font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.06em;color:var(--purple)}
+.insight-meta{font-size:10px;color:var(--text-dim)}
+.insight-summary{font-size:12px;color:var(--text-primary);line-height:1.6;margin-bottom:8px}
+.insight-section{margin-bottom:6px}
+.insight-section-title{font-size:10px;text-transform:uppercase;letter-spacing:.06em;color:var(--text-dim);margin-bottom:4px}
+.insight-item{font-size:12px;color:var(--text-muted);line-height:1.5;padding:2px 0 2px 12px;position:relative}
+.insight-item::before{content:'>';position:absolute;left:0;color:var(--purple)}
+.insight-cost{font-size:11px;color:var(--orange);margin-top:4px}
+.insight-gen-btn{padding:6px 14px;background:var(--purple-dim);color:var(--purple);border:1px solid rgba(192,132,252,.3);border-radius:6px;font-size:12px;cursor:pointer;font-family:inherit;transition:background .15s}
+.insight-gen-btn:hover{background:rgba(192,132,252,.15)}
+.insight-gen-btn:disabled{opacity:.5;cursor:not-allowed}
+.insight-loading{font-size:12px;color:var(--text-muted);padding:8px 0}
+.insight-error{font-size:12px;color:var(--red);padding:8px 0}
 .pcommits{border:1px solid rgba(250,204,21,.15);border-radius:4px;padding:6px 8px;margin-bottom:8px;background:rgba(250,204,21,.04)}
 .pcommit{display:flex;align-items:center;gap:8px;padding:2px 0;font-size:12px}
 .hljs{background:transparent!important;color:var(--text-primary)}
@@ -24152,11 +24186,34 @@ th{color:var(--text-dim);font-size:10px;text-transform:uppercase;letter-spacing:
 </head>
 <body>
 <main class="shell">
-<section class="hero">
+<section class="hero" style="position:relative">
 <h1>${title}</h1>
 <p>session observability for coding agents</p>
+<button class="settings-btn" onclick="openSettings()"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 15a3 3 0 1 0 0-6 3 3 0 0 0 6 0Z"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1Z"/></svg>AI</button>
 <div id="status" class="status-banner">Connecting...</div>
 </section>
+<div id="settings-modal" class="modal-overlay" onclick="if(event.target===this)closeSettings()">
+<div class="modal">
+<button class="modal-close" onclick="closeSettings()">&times;</button>
+<h3>AI Insights Settings</h3>
+<p style="font-size:11px;color:var(--text-muted);margin:0 0 8px">Configure your own API key to generate AI-powered session insights.</p>
+<label>Provider</label>
+<select id="cfg-provider">
+<option value="anthropic">Anthropic</option>
+<option value="openai">OpenAI</option>
+<option value="gemini">Gemini</option>
+<option value="openrouter">OpenRouter</option>
+</select>
+<label>API Key</label>
+<input type="password" id="cfg-apikey" placeholder="sk-..." autocomplete="off"/>
+<label>Model (optional)</label>
+<input type="text" id="cfg-model" placeholder="leave blank for default"/>
+<div class="modal-actions">
+<button class="modal-save" id="cfg-save" onclick="saveSettings()">Save</button>
+<span class="modal-status" id="cfg-status"></span>
+</div>
+</div>
+</div>
 <section class="mg">
 <article class="mc"><div class="label">Sessions</div><div class="val green" id="m-sessions">0</div></article>
 <article class="mc"><div class="label">Total Cost</div><div class="val orange" id="m-cost">$0.00</div></article>
@@ -24186,6 +24243,92 @@ var selectedId = null;
 var sessions = [];
 var costPoints = [];
 var replay = null;
+var insightsConfigured = false;
+var insightsCache = {};
+window.openSettings = function() {
+  document.getElementById('settings-modal').classList.add('open');
+  fetch('/api/settings/insights',{cache:'no-store'}).then(function(r){return r.json();}).then(function(data){
+    if(data && data.configured){
+      document.getElementById('cfg-provider').value = data.provider || 'anthropic';
+      if(data.model) document.getElementById('cfg-model').value = data.model;
+      document.getElementById('cfg-status').className = 'modal-status ok';
+      document.getElementById('cfg-status').textContent = 'Configured (' + (data.provider||'') + ')';
+      insightsConfigured = true;
+    }
+  }).catch(function(){});
+};
+window.closeSettings = function() {
+  document.getElementById('settings-modal').classList.remove('open');
+};
+window.saveSettings = function() {
+  var btn = document.getElementById('cfg-save');
+  var status = document.getElementById('cfg-status');
+  btn.disabled = true;
+  status.className = 'modal-status';
+  status.textContent = 'Validating...';
+  var body = {
+    provider: document.getElementById('cfg-provider').value,
+    apiKey: document.getElementById('cfg-apikey').value,
+    model: document.getElementById('cfg-model').value || undefined
+  };
+  fetch('/api/settings/insights',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)})
+  .then(function(r){return r.json().then(function(d){return{ok:r.ok,data:d};});})
+  .then(function(res){
+    btn.disabled = false;
+    if(res.ok && res.data.status === 'ok'){
+      status.className = 'modal-status ok';
+      status.textContent = 'Saved! (' + (res.data.provider||'') + ' / ' + (res.data.model||'default') + ')';
+      insightsConfigured = true;
+      document.getElementById('cfg-apikey').value = '';
+      if(replay) renderReplay();
+    } else {
+      status.className = 'modal-status error';
+      status.textContent = res.data.message || 'Save failed';
+    }
+  }).catch(function(e){
+    btn.disabled = false;
+    status.className = 'modal-status error';
+    status.textContent = String(e);
+  });
+};
+window.generateInsight = function(sid) {
+  var panel = document.getElementById('insight-panel');
+  if(!panel) return;
+  panel.innerHTML = '<div class="insight-loading">Generating insight...</div>';
+  fetch('/api/session/' + encodeURIComponent(sid) + '/insights',{method:'POST',headers:{'Content-Type':'application/json'},body:'{}'})
+  .then(function(r){return r.json().then(function(d){return{ok:r.ok,data:d};});})
+  .then(function(res){
+    if(res.ok && res.data.status === 'ok' && res.data.insight){
+      insightsCache[sid] = res.data.insight;
+      renderInsightContent(panel, res.data.insight);
+    } else {
+      panel.innerHTML = '<div class="insight-error">' + esc(res.data.message || 'Failed to generate insight') + '</div>';
+    }
+  }).catch(function(e){
+    panel.innerHTML = '<div class="insight-error">' + esc(String(e)) + '</div>';
+  });
+};
+function renderInsightContent(panel, insight) {
+  var h = '<div class="insight-hd"><span class="insight-title">AI Insight</span><span class="insight-meta">' + esc(insight.provider||'') + ' / ' + esc(insight.model||'') + '</span></div>';
+  h += '<div class="insight-summary">' + esc(insight.summary) + '</div>';
+  if(insight.highlights && insight.highlights.length > 0){
+    h += '<div class="insight-section"><div class="insight-section-title">Highlights</div>';
+    insight.highlights.forEach(function(item){ h += '<div class="insight-item">' + esc(item) + '</div>'; });
+    h += '</div>';
+  }
+  if(insight.suggestions && insight.suggestions.length > 0){
+    h += '<div class="insight-section"><div class="insight-section-title">Suggestions</div>';
+    insight.suggestions.forEach(function(item){ h += '<div class="insight-item">' + esc(item) + '</div>'; });
+    h += '</div>';
+  }
+  if(insight.costNote) h += '<div class="insight-cost">' + esc(insight.costNote) + '</div>';
+  panel.innerHTML = h;
+}
 function esc(s) {
   return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(new RegExp(DQ,'g'),'&quot;');
@@ -24479,6 +24622,17 @@ function renderReplay() {
     }
     h += '</div>';
   }
+  // AI insight panel
+  h += '<div class="insight-panel" id="insight-panel">';
+  var cachedInsight = insightsCache[replay.sessionId];
+  if (cachedInsight) {
+    // will be rendered after innerHTML set
+  } else if (insightsConfigured) {
+    h += '<div style="display:flex;align-items:center;justify-content:space-between"><span class="insight-title">AI Insight</span><button class="insight-gen-btn" data-sid="' + esc(replay.sessionId) + '">Generate Insight</button></div>';
+  } else {
+    h += '<div style="display:flex;align-items:center;justify-content:space-between"><span class="insight-title">AI Insight</span><span style="font-size:11px;color:var(--text-dim)">Configure an API key in settings to enable AI insights</span></div>';
+  }
+  h += '</div>';
   // prompt groups
   var groups = buildPromptGroups(replay.timeline, replay.commits);
   if (groups.length === 0) {
@@ -24487,6 +24641,14 @@ function renderReplay() {
     groups.forEach(function(g, i) { h += renderPromptCard(g, i + 1); });
   }
   area.innerHTML = h;
+  if (cachedInsight) {
+    var ip = document.getElementById('insight-panel');
+    if (ip) renderInsightContent(ip, cachedInsight);
+  }
+  var genBtn = area.querySelector('.insight-gen-btn[data-sid]');
+  if (genBtn) {
+    genBtn.addEventListener('click', function() { generateInsight(genBtn.getAttribute('data-sid')); });
+  }
 }
 function parseSummary(v) {
@@ -24555,6 +24717,9 @@ function loadSnapshot() {
 }
 function boot() {
+  fetch('/api/settings/insights',{cache:'no-store'}).then(function(r){return r.json();}).then(function(data){
+    if(data && data.configured) insightsConfigured = true;
+  }).catch(function(){});
   loadSnapshot().then(function(){
     if (typeof EventSource !== 'undefined') {
       var es = new EventSource('/api/sessions/stream');
@@ -24881,6 +25046,40 @@ async function startDashboardServer(options = {}) {
     const pathname = parsePathname(url);
     const segments = parsePathSegments(pathname);
     const method = req.method ?? "GET";
+    if (method === "POST" && (pathname === "/api/settings/insights" || segments.length === 4 && segments[0] === "api" && segments[1] === "session" && segments[3] === "insights")) {
+      let body = "";
+      req.setEncoding("utf8");
+      req.on("data", (chunk) => {
+        body += chunk;
+      });
+      req.on("end", () => {
+        let parsedBody;
+        try {
+          parsedBody = body.length > 0 ? JSON.parse(body) : {};
+        } catch {
+          sendJson(res, 400, { status: "error", message: "invalid JSON body" });
+          return;
+        }
+        let apiPath;
+        if (pathname === "/api/settings/insights") {
+          apiPath = "/v1/settings/insights";
+        } else {
+          const sessionId = segments[2];
+          apiPath = `/v1/sessions/${encodeURIComponent(sessionId ?? "")}/insights`;
+        }
+        void fetch(`${apiBaseUrl}${apiPath}`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(parsedBody)
+        }).then(async (apiResponse) => {
+          const payload = await apiResponse.json();
+          sendJson(res, apiResponse.status, payload);
+        }).catch((error) => {
+          sendJson(res, 502, { status: "error", message: `proxy error: ${String(error)}` });
+        });
+      });
+      return;
+    }
     if (method !== "GET") {
       sendJson(res, 405, {
         status: "error",
@@ -24972,6 +25171,15 @@ async function startDashboardServer(options = {}) {
       });
       return;
     }
+    if (pathname === "/api/settings/insights") {
+      void fetch(`${apiBaseUrl}/v1/settings/insights`).then(async (apiResponse) => {
+        const payload = await apiResponse.json();
+        sendJson(res, apiResponse.status, payload);
+      }).catch((error) => {
+        sendJson(res, 502, { status: "error", message: `proxy error: ${String(error)}` });
+      });
+      return;
+    }
     if (pathname === "/") {
       sendHtml(res, 200, renderDashboardHtml());
       return;
@@ -25089,6 +25297,12 @@ CREATE TABLE IF NOT EXISTS pull_requests (
 );
 CREATE INDEX IF NOT EXISTS idx_pull_requests_session ON pull_requests(session_id);
+CREATE TABLE IF NOT EXISTS instance_settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
 `;
 function toJsonArray(value) {
   return JSON.stringify(value);
@@ -25382,6 +25596,21 @@ var SqliteClient = class {
       sessionCount: Number(raw["sessions_count"] ?? 0)
     }));
   }
+  getSetting(key) {
+    const row = this.db.prepare(
+      "SELECT value FROM instance_settings WHERE key = ?"
+    ).get(key);
+    return row?.value;
+  }
+  upsertSetting(key, value) {
+    this.db.prepare(`
+      INSERT INTO instance_settings (key, value, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT(key) DO UPDATE SET
+        value = excluded.value,
+        updated_at = excluded.updated_at
+    `).run(key, value);
+  }
   close() {
     this.db.close();
   }
@@ -26432,6 +26661,505 @@ function calculateCostUsd(input) {
 // packages/runtime/src/runtime.ts
 var import_node_http2 = __toESM(require("node:http"));
+// packages/api/src/insights-provider.ts
+var DEFAULT_MODELS = {
+  anthropic: "claude-sonnet-4-20250514",
+  openai: "gpt-4o-mini",
+  gemini: "gemini-2.0-flash",
+  openrouter: "anthropic/claude-sonnet-4"
+};
+function extractTextContent(body) {
+  if (typeof body !== "object" || body === null) return "";
+  const record = body;
+  if (Array.isArray(record["content"])) {
+    for (const block of record["content"]) {
+      if (typeof block === "object" && block !== null) {
+        const b = block;
+        if (b["type"] === "text" && typeof b["text"] === "string") return b["text"];
+      }
+    }
+  }
+  if (Array.isArray(record["choices"])) {
+    const first = record["choices"][0];
+    if (typeof first === "object" && first !== null) {
+      const choice = first;
+      const msg = choice["message"];
+      if (typeof msg === "object" && msg !== null) {
+        const m = msg;
+        if (typeof m["content"] === "string") return m["content"];
+      }
+    }
+  }
+  if (Array.isArray(record["candidates"])) {
+    const first = record["candidates"][0];
+    if (typeof first === "object" && first !== null) {
+      const candidate = first;
+      const content = candidate["content"];
+      if (typeof content === "object" && content !== null) {
+        const c = content;
+        if (Array.isArray(c["parts"])) {
+          for (const part of c["parts"]) {
+            if (typeof part === "object" && part !== null) {
+              const p = part;
+              if (typeof p["text"] === "string") return p["text"];
+            }
+          }
+        }
+      }
+    }
+  }
+  return "";
+}
+function createAnthropicProvider(apiKey, model) {
+  const endpoint = "https://api.anthropic.com/v1/messages";
+  return {
+    provider: "anthropic",
+    model,
+    async complete(system, user) {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": apiKey,
+          "anthropic-version": "2023-06-01"
+        },
+        body: JSON.stringify({
+          model,
+          max_tokens: 1024,
+          system,
+          messages: [{ role: "user", content: user }]
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`anthropic api returned ${String(response.status)}`);
+      }
+      const body = await response.json();
+      return extractTextContent(body);
+    },
+    async validate() {
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+            "anthropic-version": "2023-06-01"
+          },
+          body: JSON.stringify({
+            model,
+            max_tokens: 1,
+            messages: [{ role: "user", content: "hi" }]
+          })
+        });
+        return response.ok || response.status === 400;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+function createOpenAiProvider(apiKey, model) {
+  const endpoint = "https://api.openai.com/v1/chat/completions";
+  return {
+    provider: "openai",
+    model,
+    async complete(system, user) {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          model,
+          max_tokens: 1024,
+          messages: [
+            { role: "system", content: system },
+            { role: "user", content: user }
+          ]
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`openai api returned ${String(response.status)}`);
+      }
+      const body = await response.json();
+      return extractTextContent(body);
+    },
+    async validate() {
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`
+          },
+          body: JSON.stringify({
+            model,
+            max_tokens: 1,
+            messages: [{ role: "user", content: "hi" }]
+          })
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+function createGeminiProvider(apiKey, model) {
+  const baseUrl = "https://generativelanguage.googleapis.com/v1beta";
+  return {
+    provider: "gemini",
+    model,
+    async complete(system, user) {
+      const url = `${baseUrl}/models/${model}:generateContent?key=${apiKey}`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          systemInstruction: { parts: [{ text: system }] },
+          contents: [{ parts: [{ text: user }] }],
+          generationConfig: { maxOutputTokens: 1024 }
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`gemini api returned ${String(response.status)}`);
+      }
+      const body = await response.json();
+      return extractTextContent(body);
+    },
+    async validate() {
+      try {
+        const url = `${baseUrl}/models/${model}:generateContent?key=${apiKey}`;
+        const response = await fetch(url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            contents: [{ parts: [{ text: "hi" }] }],
+            generationConfig: { maxOutputTokens: 1 }
+          })
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+function createOpenRouterProvider(apiKey, model) {
+  const endpoint = "https://openrouter.ai/api/v1/chat/completions";
+  return {
+    provider: "openrouter",
+    model,
+    async complete(system, user) {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          model,
+          max_tokens: 1024,
+          messages: [
+            { role: "system", content: system },
+            { role: "user", content: user }
+          ]
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`openrouter api returned ${String(response.status)}`);
+      }
+      const body = await response.json();
+      return extractTextContent(body);
+    },
+    async validate() {
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`
+          },
+          body: JSON.stringify({
+            model,
+            max_tokens: 1,
+            messages: [{ role: "user", content: "hi" }]
+          })
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+function createLlmProvider(config) {
+  const model = config.model ?? DEFAULT_MODELS[config.provider];
+  switch (config.provider) {
+    case "anthropic":
+      return createAnthropicProvider(config.apiKey, model);
+    case "openai":
+      return createOpenAiProvider(config.apiKey, model);
+    case "gemini":
+      return createGeminiProvider(config.apiKey, model);
+    case "openrouter":
+      return createOpenRouterProvider(config.apiKey, model);
+  }
+}
+// packages/api/src/insights-generator.ts
+var SYSTEM_PROMPT = `You are an AI coding session analyst. You analyze telemetry from AI coding agent sessions and produce structured insights.
+Return ONLY valid JSON with this exact schema:
+{
+  "summary": "2-3 sentence overview of what the session accomplished",
+  "highlights": ["1-3 notable observations about the session"],
+  "suggestions": ["0-3 actionable suggestions for improving efficiency"],
+  "costNote": "optional one-line note about cost efficiency, or null"
+}
+Guidelines:
+- summary: Describe what the agent accomplished concisely. Mention key outcomes (files changed, commits, PRs).
+- highlights: Focus on interesting patterns \u2014 heavy tool usage, large diffs, cache efficiency, model choices.
+- suggestions: Only suggest things that are actionable. If the session looks efficient, return an empty array.
+- costNote: Comment on cost relative to output if noteworthy. Set to null if unremarkable.
+- Be concise and specific. Reference actual numbers from the data.`;
+function condensedTimeline(trace, maxChars) {
+  const lines = [];
+  for (const event of trace.timeline) {
+    const parts = [event.type];
+    if (event.details !== void 0) {
+      const d = event.details;
+      const toolName = d["toolName"] ?? d["tool_name"];
+      if (typeof toolName === "string") parts.push(toolName);
+      const toolInput = d["toolInput"] ?? d["tool_input"];
+      if (typeof toolInput === "object" && toolInput !== null) {
+        const ti = toolInput;
+        const fp = ti["file_path"] ?? ti["filePath"];
+        if (typeof fp === "string") parts.push(fp);
+        const cmd = ti["command"];
+        if (typeof cmd === "string") parts.push(cmd.slice(0, 80));
+      }
+    }
+    if (event.costUsd !== void 0 && event.costUsd > 0) {
+      parts.push(`$${event.costUsd.toFixed(4)}`);
+    }
+    const line = parts.join(" | ");
+    lines.push(line);
+    const totalLength = lines.reduce((sum, l) => sum + l.length + 1, 0);
+    if (totalLength > maxChars) break;
+  }
+  return lines.join("\n");
+}
+function buildInsightPrompt(trace) {
+  const m = trace.metrics;
+  const sections = [];
+  sections.push(`## Session: ${trace.sessionId}`);
+  sections.push(`Started: ${trace.startedAt}${trace.endedAt !== void 0 ? ` | Ended: ${trace.endedAt}` : ""}`);
+  if (trace.environment.gitRepo !== void 0) {
+    sections.push(`Repo: ${trace.environment.gitRepo}${trace.environment.gitBranch !== void 0 ? ` (${trace.environment.gitBranch})` : ""}`);
+  }
+  sections.push(`
+## Metrics`);
+  sections.push(`Prompts: ${String(m.promptCount)} | Tool calls: ${String(m.toolCallCount)} | API calls: ${String(m.apiCallCount)}`);
+  sections.push(`Cost: $${m.totalCostUsd.toFixed(4)}`);
+  sections.push(`Tokens: ${String(m.totalInputTokens)} in / ${String(m.totalOutputTokens)} out | Cache: ${String(m.totalCacheReadTokens)} read / ${String(m.totalCacheWriteTokens)} write`);
+  sections.push(`Lines: +${String(m.linesAdded)} / -${String(m.linesRemoved)} | Files: ${String(m.filesTouched.length)}`);
+  if (m.modelsUsed.length > 0) sections.push(`Models: ${m.modelsUsed.join(", ")}`);
+  if (m.toolsUsed.length > 0) sections.push(`Tools: ${m.toolsUsed.join(", ")}`);
+  if (trace.git.commits.length > 0) {
+    sections.push(`
+## Commits (${String(trace.git.commits.length)})`);
+    trace.git.commits.forEach((c) => {
+      sections.push(`- ${c.sha.slice(0, 7)}: ${c.message ?? "no message"}`);
+    });
+  }
+  if (trace.git.pullRequests.length > 0) {
+    sections.push(`
+## Pull Requests (${String(trace.git.pullRequests.length)})`);
+    trace.git.pullRequests.forEach((pr) => {
+      sections.push(`- PR #${String(pr.prNumber)} (${pr.state}) in ${pr.repo}`);
+    });
+  }
+  sections.push(`
+## Timeline (condensed)`);
+  sections.push(condensedTimeline(trace, 4e3));
+  return sections.join("\n");
+}
+function parseInsightJson(raw) {
+  let jsonStr = raw.trim();
+  const fenceMatch = jsonStr.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+  if (fenceMatch !== null && fenceMatch[1] !== void 0) {
+    jsonStr = fenceMatch[1].trim();
+  }
+  try {
+    const parsed = JSON.parse(jsonStr);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return void 0;
+    const obj = parsed;
+    const summary = typeof obj["summary"] === "string" ? obj["summary"] : "";
+    if (summary.length === 0) return void 0;
+    const highlights = Array.isArray(obj["highlights"]) ? obj["highlights"].filter((h) => typeof h === "string") : [];
+    const suggestions = Array.isArray(obj["suggestions"]) ? obj["suggestions"].filter((s) => typeof s === "string") : [];
+    const costNote = typeof obj["costNote"] === "string" && obj["costNote"].length > 0 ? obj["costNote"] : void 0;
+    return { summary, highlights, suggestions, costNote };
+  } catch {
+    return void 0;
+  }
+}
+async function generateSessionInsight(trace, provider) {
+  const userPrompt = buildInsightPrompt(trace);
+  const rawResponse = await provider.complete(SYSTEM_PROMPT, userPrompt);
+  const parsed = parseInsightJson(rawResponse);
+  if (parsed === void 0) {
+    return {
+      sessionId: trace.sessionId,
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      provider: provider.provider,
+      model: provider.model,
+      summary: rawResponse.slice(0, 500) || "Failed to generate structured insight.",
+      highlights: [],
+      suggestions: []
+    };
+  }
+  const result = {
+    sessionId: trace.sessionId,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    provider: provider.provider,
+    model: provider.model,
+    summary: parsed.summary,
+    highlights: parsed.highlights,
+    suggestions: parsed.suggestions
+  };
+  if (parsed.costNote !== void 0) {
+    return { ...result, costNote: parsed.costNote };
+  }
+  return result;
+}
+// packages/api/src/insights-handler.ts
+var insightsCache = /* @__PURE__ */ new Map();
+var VALID_PROVIDERS = ["anthropic", "openai", "gemini", "openrouter"];
+function isValidProvider(value) {
+  return typeof value === "string" && VALID_PROVIDERS.includes(value);
+}
+function handleGetInsightsSettings(dependencies) {
+  const accessor = dependencies.insightsConfigAccessor;
+  if (accessor === void 0) {
+    return {
+      statusCode: 200,
+      payload: { status: "ok", configured: false }
+    };
+  }
+  const config = accessor.getConfig();
+  if (config === void 0) {
+    return {
+      statusCode: 200,
+      payload: { status: "ok", configured: false }
+    };
+  }
+  return {
+    statusCode: 200,
+    payload: {
+      status: "ok",
+      configured: true,
+      provider: config.provider,
+      ...config.model !== void 0 ? { model: config.model } : {}
+    }
+  };
+}
+async function handlePostInsightsSettings(body, dependencies) {
+  const accessor = dependencies.insightsConfigAccessor;
+  if (accessor === void 0) {
+    return {
+      statusCode: 500,
+      payload: { status: "error", message: "insights settings not available" }
+    };
+  }
+  if (typeof body !== "object" || body === null || Array.isArray(body)) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "request body must be a JSON object" }
+    };
+  }
+  const record = body;
+  const provider = record["provider"];
+  const apiKey = record["apiKey"];
+  const model = record["model"];
+  if (!isValidProvider(provider)) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "invalid provider. must be one of: anthropic, openai, gemini, openrouter" }
+    };
+  }
+  if (typeof apiKey !== "string" || apiKey.length === 0) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "apiKey is required" }
+    };
+  }
+  const config = {
+    provider,
+    apiKey,
+    ...typeof model === "string" && model.length > 0 ? { model } : {}
+  };
+  const llm = createLlmProvider(config);
+  const valid = await llm.validate();
+  if (!valid) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "API key validation failed. Check your key and try again." }
+    };
+  }
+  accessor.setConfig(config);
+  return {
+    statusCode: 200,
+    payload: {
+      status: "ok",
+      message: "insights configuration saved",
+      provider: config.provider,
+      model: llm.model
+    }
+  };
+}
+async function handlePostSessionInsight(sessionId, dependencies) {
+  const accessor = dependencies.insightsConfigAccessor;
+  if (accessor === void 0) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "insights not configured" }
+    };
+  }
+  const config = accessor.getConfig();
+  if (config === void 0) {
+    return {
+      statusCode: 400,
+      payload: { status: "error", message: "no AI provider configured. open settings to add your API key." }
+    };
+  }
+  const cached = insightsCache.get(sessionId);
+  if (cached !== void 0) {
+    return {
+      statusCode: 200,
+      payload: { status: "ok", insight: cached }
+    };
+  }
+  const trace = dependencies.repository.getBySessionId(sessionId);
+  if (trace === void 0) {
+    return {
+      statusCode: 404,
+      payload: { status: "error", message: "session not found" }
+    };
+  }
+  const provider = createLlmProvider(config);
+  const insight = await generateSessionInsight(trace, provider);
+  insightsCache.set(sessionId, insight);
+  return {
+    statusCode: 200,
+    payload: { status: "ok", insight }
+  };
+}
 // packages/api/src/mapper.ts
 function toSessionSummary(trace) {
   return {
@@ -26550,6 +27278,16 @@ async function handleApiRequest(request, dependencies) {
       payload: await buildDailyCostResponse(dependencies, filters)
     };
   }
+  if (request.method === "GET" && pathname === "/v1/settings/insights") {
+    return handleGetInsightsSettings(dependencies);
+  }
+  if (request.method === "POST" && pathname === "/v1/settings/insights") {
+    return handlePostInsightsSettings(request.body, dependencies);
+  }
+  const insightsMatch = pathname.match(/^\/v1\/sessions\/([^/]+)\/insights$/);
+  if (request.method === "POST" && insightsMatch !== null && insightsMatch[1] !== void 0) {
+    return handlePostSessionInsight(decodeURIComponent(insightsMatch[1]), dependencies);
+  }
   if (request.method === "GET") {
     const segments = parseSessionPath(pathname);
     if (segments.length >= 3 && segments[0] === "v1" && segments[1] === "sessions") {
@@ -26597,7 +27335,7 @@ async function handleApiRequest(request, dependencies) {
 // packages/api/src/http.ts
 function normalizeMethod(method) {
-  if (method === "GET") {
+  if (method === "GET" || method === "POST") {
     return method;
   }
   return void 0;
@@ -26664,11 +27402,33 @@ async function handleApiRawHttpRequest(request, dependencies) {
   return handleApiRequest(
     {
       method,
-      url: request.url
+      url: request.url,
+      ...request.body !== void 0 ? { body: request.body } : {}
     },
     dependencies
   );
 }
+function readRequestBody(req) {
+  return new Promise((resolve, reject) => {
+    let data = "";
+    req.setEncoding("utf8");
+    req.on("data", (chunk) => {
+      data += chunk;
+    });
+    req.on("end", () => {
+      if (data.length === 0) {
+        resolve(void 0);
+        return;
+      }
+      try {
+        resolve(JSON.parse(data));
+      } catch {
+        reject(new Error("invalid JSON body"));
+      }
+    });
+    req.on("error", (error) => reject(error));
+  });
+}
 function createApiHttpHandler(dependencies) {
   return (req, res) => {
     const method = req.method ?? "GET";
@@ -26677,17 +27437,29 @@ function createApiHttpHandler(dependencies) {
       startSessionsSseStream(req, res, dependencies);
       return;
     }
-    void handleApiRawHttpRequest(
-      {
-        method,
-        url
-      },
-      dependencies
-    ).then((response) => {
-      sendJson2(res, response.statusCode, response.payload);
-    }).catch(() => {
-      sendJson2(res, 500, { status: "error", message: "internal server error" });
-    });
+    const dispatch = (body) => {
+      void handleApiRawHttpRequest(
+        {
+          method,
+          url,
+          ...body !== void 0 ? { body } : {}
+        },
+        dependencies
+      ).then((response) => {
+        sendJson2(res, response.statusCode, response.payload);
+      }).catch(() => {
+        sendJson2(res, 500, { status: "error", message: "internal server error" });
+      });
+    };
+    if (method === "POST") {
+      readRequestBody(req).then((body) => {
+        dispatch(body);
+      }).catch(() => {
+        sendJson2(res, 400, { status: "error", message: "invalid request body" });
+      });
+      return;
+    }
+    dispatch();
   };
 }
@@ -27014,7 +27786,7 @@ function handleCollectorRawHttpRequest(request, dependencies) {
     dependencies
   );
 }
-async function readRequestBody(req) {
+async function readRequestBody2(req) {
   return new Promise((resolve, reject) => {
     const chunks = [];
     req.on("data", (chunk) => chunks.push(chunk));
@@ -27032,7 +27804,7 @@ function createCollectorHttpHandler(dependencies) {
   return async (req, res) => {
     const method = req.method ?? "GET";
     const url = req.url ?? "/";
-    const rawBody = method === "POST" ? await readRequestBody(req) : void 0;
+    const rawBody = method === "POST" ? await readRequestBody2(req) : void 0;
     const response = handleCollectorRawHttpRequest(
       {
         method,
@@ -28740,7 +29512,8 @@ function resolveRuntimeOptions(input) {
     return {
       startedAtMs: input,
       persistence: new InMemoryRuntimePersistence(),
-      dailyCostReader: void 0
+      dailyCostReader: void 0,
+      insightsConfigAccessor: void 0
     };
   }
   const startedAtMs = input?.startedAtMs ?? Date.now();
@@ -28748,7 +29521,8 @@ function resolveRuntimeOptions(input) {
   return {
     startedAtMs,
     persistence,
-    dailyCostReader: input?.dailyCostReader
+    dailyCostReader: input?.dailyCostReader,
+    insightsConfigAccessor: input?.insightsConfigAccessor
   };
 }
 function createInMemoryRuntime(input) {
@@ -28766,7 +29540,8 @@ function createInMemoryRuntime(input) {
   const apiDependencies = {
     startedAtMs: options.startedAtMs,
     repository: sessionRepository,
-    ...options.dailyCostReader !== void 0 ? { dailyCostReader: options.dailyCostReader } : {}
+    ...options.dailyCostReader !== void 0 ? { dailyCostReader: options.dailyCostReader } : {},
+    ...options.insightsConfigAccessor !== void 0 ? { insightsConfigAccessor: options.insightsConfigAccessor } : {}
   };
   return {
     sessionRepository,
@@ -28775,6 +29550,7 @@ function createInMemoryRuntime(input) {
     collectorService,
     persistence,
     ...options.dailyCostReader !== void 0 ? { dailyCostReader: options.dailyCostReader } : {},
+    ...options.insightsConfigAccessor !== void 0 ? { insightsConfigAccessor: options.insightsConfigAccessor } : {},
     handleCollectorRaw: collectorService.handleRaw,
     handleApiRaw: (request) => handleApiRawHttpRequest(request, apiDependencies)
   };
@@ -28795,7 +29571,8 @@ async function startInMemoryRuntimeServers(runtime, options = {}) {
     createApiHttpHandler({
       startedAtMs: runtime.collectorDependencies.startedAtMs,
       repository: runtime.sessionRepository,
-      ...runtime.dailyCostReader !== void 0 ? { dailyCostReader: runtime.dailyCostReader } : {}
+      ...runtime.dailyCostReader !== void 0 ? { dailyCostReader: runtime.dailyCostReader } : {},
+      ...runtime.insightsConfigAccessor !== void 0 ? { insightsConfigAccessor: runtime.insightsConfigAccessor } : {}
     })
   ) : void 0;
   let otelReceiver;
@@ -28964,14 +29741,46 @@ function hydrateFromSqlite(runtime, sqlite, limit, eventLimit) {
   }
   return traces.length;
 }
+var VALID_INSIGHTS_PROVIDERS = ["anthropic", "openai", "gemini", "openrouter"];
+function createSqliteInsightsConfigAccessor(sqlite) {
+  let cached;
+  const raw = sqlite.getSetting("insights_config");
+  if (raw !== void 0) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+        const obj = parsed;
+        if (typeof obj["provider"] === "string" && VALID_INSIGHTS_PROVIDERS.includes(obj["provider"]) && typeof obj["apiKey"] === "string") {
+          cached = {
+            provider: obj["provider"],
+            apiKey: obj["apiKey"],
+            ...typeof obj["model"] === "string" && obj["model"].length > 0 ? { model: obj["model"] } : {}
+          };
+        }
+      }
+    } catch {
+    }
+  }
+  return {
+    getConfig() {
+      return cached;
+    },
+    setConfig(config) {
+      cached = config;
+      sqlite.upsertSetting("insights_config", JSON.stringify(config));
+    }
+  };
+}
 function createSqliteBackedRuntime(options) {
   const sqlite = new SqliteClient(options.dbPath);
   const persistence = new SqlitePersistence(sqlite);
   const dailyCostReader = new SqliteDailyCostReader(sqlite);
+  const insightsConfigAccessor = options.insightsConfigAccessor ?? createSqliteInsightsConfigAccessor(sqlite);
   const runtime = createInMemoryRuntime({
     ...options.startedAtMs !== void 0 ? { startedAtMs: options.startedAtMs } : {},
     persistence,
-    dailyCostReader
+    dailyCostReader,
+    insightsConfigAccessor
   });
   const hydratedCount = hydrateFromSqlite(runtime, sqlite, options.bootstrapLimit, options.eventLimit);
   const syncIntervalMs = options.syncIntervalMs ?? 5e3;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-trace",
-  "version": "0.2.12",
+  "version": "0.3.0",
   "description": "Self-hosted observability for AI coding agents. One command, zero config.",
   "license": "Apache-2.0",
   "bin": {