@agentistics/mcp 2.100.0 → 2.101.0

package/dist/agentistics-mcp.js

@@ -43,6 +43,12 @@ var HARNESS_SORT = {
   opencode: 6
 };
 var HARNESS_ORDER = Object.keys(HARNESS_SORT).sort((a, b) => HARNESS_SORT[a] - HARNESS_SORT[b]);
+function canonicalProjectPath(path) {
+  if (!path)
+    return path;
+  const m = /^(.*?)\/{1,2}(?:\.?claude\/worktrees|\.worktrees)\//.exec(path);
+  return m && m[1] ? m[1] : path;
+}
 var BASE_MODEL_PRICING = {
   "claude-fable-5": { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
   "claude-mythos-5": { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
@@ -216,6 +222,114 @@ function redactSecrets(text) {
   out = out.replace(BEARER, (whole, prefix, value) => guarded(whole, prefix, value));
   return out;
 }
+// ../core/src/projection-surfaces.ts
+var PROJECTION_SURFACES_ENV = "AGENTISTICS_PROJECTIONS_SURFACES";
+var PROJECTION_SURFACE_IDS = ["mcp", "vscode", "tui", "web"];
+var LEGACY_SURFACES_VALUES = ["legacy", "none"];
+function projectionSurfaces(env = process.env) {
+  const names = (env[PROJECTION_SURFACES_ENV] ?? "").split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  if (names.length === 0 || names.includes("all"))
+    return [...PROJECTION_SURFACE_IDS];
+  if (names.some((n) => LEGACY_SURFACES_VALUES.includes(n)))
+    return [];
+  return PROJECTION_SURFACE_IDS.filter((id) => names.includes(id));
+}
+function projectionSurfaceOn(surface, env = process.env) {
+  return projectionSurfaces(env).includes(surface);
+}
+// ../core/src/projection-client.ts
+class ProjectionUnavailable extends Error {
+  status;
+  code;
+  constructor(status, code) {
+    super(`projections unavailable (${status} ${code})`);
+    this.status = status;
+    this.code = code;
+  }
+}
+var MAX_PAGES = 200;
+function metricsSearchParams(params) {
+  const p = new URLSearchParams;
+  for (const [k, v] of Object.entries(params)) {
+    if (typeof v === "string")
+      p.append(k, v);
+    else
+      for (const one of v)
+        p.append(k, one);
+  }
+  return p;
+}
+async function allMetricGroups(q, params) {
+  const groups = [];
+  let cursor = null;
+  let basis;
+  for (let i = 0;i < MAX_PAGES; i++) {
+    const p = metricsSearchParams({ ...params, limit: "1000" });
+    if (cursor)
+      p.set("cursor", cursor);
+    const a = await q(p);
+    if (!a.ok)
+      throw new ProjectionUnavailable(a.status, a.error);
+    groups.push(...a.body.groups);
+    basis = a.body.basis;
+    cursor = a.body.page.nextCursor;
+    if (!cursor)
+      return { groups, basis };
+  }
+  throw new Error(`metrics query did not finish in ${MAX_PAGES} pages`);
+}
+var tok = (t) => ({
+  input: t?.input ?? 0,
+  output: t?.output ?? 0,
+  cacheRead: t?.cacheRead ?? 0,
+  cacheWrite: t?.cacheWrite ?? 0,
+  total: t?.total ?? 0
+});
+function harnessScope(harness) {
+  return harness && harness !== "all" ? { harness } : {};
+}
+async function projectedRollup(q, dim, harness) {
+  const by = (extra) => [...dim ? [dim] : [], ...extra].join(",");
+  const base = harnessScope(harness);
+  const [all, main, days] = await Promise.all([
+    allMetricGroups(q, { ...base, ...dim ? { groupBy: by([]) } : {}, metrics: "sessions,messages,tokens,cost" }),
+    allMetricGroups(q, { ...base, ...dim ? { groupBy: by([]) } : {}, subagent: "false", metrics: "tokens,cost" }),
+    allMetricGroups(q, { ...base, groupBy: by(["day"]), metrics: "sessions" })
+  ]);
+  const keyOf = (g) => dim ? g.key[dim] ?? null : null;
+  const out = new Map;
+  const row = (k) => {
+    let r = out.get(k);
+    if (!r) {
+      r = { key: k, sessions: 0, personTurns: null, main: tok(undefined), mainCost: 0, allTokens: 0, allCost: 0, costPartial: false, lastActive: null };
+      out.set(k, r);
+    }
+    return r;
+  };
+  for (const g of all.groups) {
+    const r = row(keyOf(g));
+    r.sessions = g.metrics.sessions?.count ?? 0;
+    r.personTurns = g.metrics.messages ? g.metrics.messages.value : null;
+    r.allTokens = g.metrics.tokens?.total ?? 0;
+    r.allCost = g.metrics.cost?.usd ?? 0;
+    r.costPartial ||= g.metrics.cost?.partial ?? false;
+  }
+  for (const g of main.groups) {
+    const r = row(keyOf(g));
+    r.main = tok(g.metrics.tokens);
+    r.mainCost = g.metrics.cost?.usd ?? 0;
+    r.costPartial ||= g.metrics.cost?.partial ?? false;
+  }
+  for (const g of days.groups) {
+    const d = g.key.day;
+    if (!d)
+      continue;
+    const r = row(keyOf(g));
+    if (!r.lastActive || d > r.lastActive)
+      r.lastActive = d;
+  }
+  return out;
+}
 // ../core/src/plan-catalog.ts
 var CLAUDE_PRICING = "https://claude.com/pricing";
 var COPILOT_PRICING = "https://github.com/features/copilot/plans";
@@ -490,6 +604,7 @@ var EVENT_TYPES = [
   "tool.approved",
   "tool.denied",
   "tool.progress",
+  "tool.executed",
   "mcp.requested",
   "mcp.completed",
   "browser.session.started",
@@ -504,6 +619,7 @@ var EVENT_TYPES = [
   "browser.tab.closed",
   "context.compacted",
   "context.window.observed",
+  "context.recalled",
   "policy.requested",
   "policy.approved",
   "policy.denied",
@@ -800,12 +916,12 @@ var AGENT_TOOL_POLICY = {
     routes: ["POST /api/session-notify"],
     reason: "a per-session on/off switch for delivery; reversible, and the session state is untouched"
   },
-  agentistics_summary: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics" },
-  agentistics_harnesses: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics per harness" },
-  agentistics_projects: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics per project" },
+  agentistics_summary: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics" },
+  agentistics_harnesses: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per harness" },
+  agentistics_projects: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per project" },
   agentistics_sessions: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads session metadata (first_prompt is untrusted text, §4.8)" },
-  agentistics_costs: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed costs" },
-  agentistics_repos: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics per repository" },
+  agentistics_costs: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed costs" },
+  agentistics_repos: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per repository" },
   agentistics_component_catalog: { ...DATA, risk: "R", routes: [], reason: "returns a static list; calls nothing" },
   agentistics_get_layouts: { ...PREFS, risk: "R", routes: ["GET /api/preferences"], reason: "reads the saved layouts" },
   agentistics_create_layout: { ...PREFS, risk: "W", routes: ["GET /api/preferences", "PUT /api/preferences"], reason: "adds a layout; removed by delete_layout" },
@@ -845,7 +961,9 @@ function sessionTokens2(s) {
     input_tokens: input,
     output_tokens: output,
     cache_read_input_tokens: cacheRead,
-    cache_creation_input_tokens: cacheWrite
+    cache_creation_input_tokens: cacheWrite,
+    cache_creation_1h_input_tokens: s.cache_creation_1h_input_tokens,
+    cache_creation_5m_input_tokens: s.cache_creation_5m_input_tokens
   }) ?? calcCost({
     inputTokens: input,
     outputTokens: output,
@@ -1120,6 +1238,325 @@ function taskCommentRequest(args) {
   };
 }
 
+// legacy-analytics.ts
+function legacySummary(data, harness) {
+  const unified = !harness || harness === "all";
+  const sc = data.statsCache ?? {};
+  const totals = statsCacheTotals(sc);
+  const allSessions = filterSessions(data.sessions ?? [], harness);
+  let totalCostUSD = 0;
+  let totalInput = 0, totalOutput = 0, totalCacheRead = 0, totalCacheWrite = 0;
+  const modelTokens = {};
+  const projectSessions = {};
+  const activeDates = new Set;
+  for (const s of allSessions) {
+    const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
+    totalInput += input;
+    totalOutput += output;
+    totalCacheRead += cacheRead;
+    totalCacheWrite += cacheWrite;
+    totalCostUSD += cost;
+    if (s.model)
+      modelTokens[s.model] = (modelTokens[s.model] ?? 0) + input + output;
+    if (s.project_path) {
+      const root = canonicalProjectPath(s.project_path);
+      projectSessions[root] = (projectSessions[root] ?? 0) + 1;
+    }
+    if (s.start_time)
+      activeDates.add(String(s.start_time).slice(0, 10));
+  }
+  const claudeFallback = unified || harness === "claude";
+  const topModel = Object.entries(modelTokens).sort(([, a], [, b]) => b - a)[0]?.[0] ?? (claudeFallback ? totals.topModel ?? "—" : "—");
+  const topProject = Object.entries(projectSessions).sort(([, a], [, b]) => b - a)[0]?.[0] ?? "—";
+  return {
+    harness: unified ? "all" : harness,
+    totalInputTokens: totalInput || (claudeFallback ? totals.input : 0),
+    totalOutputTokens: totalOutput || (claudeFallback ? totals.output : 0),
+    totalCacheReadTokens: totalCacheRead || (claudeFallback ? totals.cacheRead : 0),
+    totalCacheWriteTokens: totalCacheWrite || (claudeFallback ? totals.cacheWrite : 0),
+    estimatedCostUSD: Math.round((totalCostUSD || (claudeFallback ? totals.cost : 0)) * 100) / 100,
+    totalSessions: allSessions.length,
+    topModel,
+    topProject,
+    activeDays: activeDates.size || (claudeFallback ? sc.activeDays ?? 0 : 0),
+    currentStreak: claudeFallback ? sc.currentStreak ?? 0 : null
+  };
+}
+function legacyHarnesses(data) {
+  const present = data.harnesses ?? ["claude"];
+  const sessions = data.sessions ?? [];
+  const rows = present.map((h) => {
+    const hs = sessions.filter((s) => sessionHarness(s) === h);
+    let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, cost = 0, messages = 0, lastActive = "";
+    for (const s of hs) {
+      const t = sessionTokens2(s);
+      input += t.input;
+      output += t.output;
+      cacheRead += t.cacheRead;
+      cacheWrite += t.cacheWrite;
+      cost += t.cost;
+      messages += sessionMessages(s);
+      if (s.start_time && String(s.start_time) > lastActive)
+        lastActive = String(s.start_time);
+    }
+    return {
+      harness: h,
+      sessions: hs.length,
+      messages,
+      inputTokens: input,
+      outputTokens: output,
+      cacheReadTokens: cacheRead,
+      cacheWriteTokens: cacheWrite,
+      totalTokens: input + output + cacheRead + cacheWrite,
+      estimatedCostUSD: Math.round(cost * 100) / 100,
+      lastActive: lastActive || null
+    };
+  }).sort((a, b) => b.totalTokens - a.totalTokens);
+  return rows;
+}
+function legacyProjects(data, harness) {
+  const allSessions = filterSessions(data.sessions ?? [], harness);
+  const byPath = {};
+  for (const s of allSessions) {
+    const key = canonicalProjectPath(s.project_path);
+    if (!key)
+      continue;
+    if (!byPath[key])
+      byPath[key] = { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
+    const agg = byPath[key];
+    const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
+    agg.sessions += 1;
+    agg.inputTokens += input;
+    agg.outputTokens += output;
+    agg.cacheRead += cacheRead;
+    agg.cacheWrite += cacheWrite;
+    agg.costUSD += cost;
+    agg.messages += sessionMessages(s);
+    if (!agg.lastActive || (s.start_time ?? "") > agg.lastActive)
+      agg.lastActive = s.start_time ?? "";
+    for (const lang of s.languages ?? [])
+      if (!agg.languages.includes(lang))
+        agg.languages.push(lang);
+  }
+  const roots = new Map;
+  for (const p of data.projects ?? []) {
+    const path = canonicalProjectPath(p.path ?? "");
+    const r = roots.get(path) ?? { name: p.name, path, sessions: [] };
+    if (p.path === path)
+      r.name = p.name;
+    r.sessions.push(...p.sessions ?? []);
+    roots.set(path, r);
+  }
+  const projects = [...roots.values()];
+  const summary = projects.filter((p) => !harness || harness === "all" || byPath[p.path]).map((p) => {
+    const agg = byPath[p.path] ?? { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
+    return {
+      name: p.name,
+      path: p.path,
+      sessions: !harness || harness === "all" ? (p.sessions ?? []).length : agg.sessions,
+      messages: agg.messages,
+      inputTokens: agg.inputTokens,
+      outputTokens: agg.outputTokens,
+      totalTokens: agg.inputTokens + agg.outputTokens,
+      estimatedCostUSD: Math.round(agg.costUSD * 1e4) / 1e4,
+      lastActive: agg.lastActive || null,
+      languages: agg.languages
+    };
+  }).sort((a, b) => b.totalTokens - a.totalTokens);
+  return summary;
+}
+function legacyCosts(data, harness) {
+  if (!harness || harness === "all" || harness === "claude") {
+    const usage = data.statsCache?.modelUsage ?? {};
+    const breakdown = Object.entries(usage).map(([model, u]) => ({
+      model,
+      inputTokens: u.inputTokens ?? 0,
+      outputTokens: u.outputTokens ?? 0,
+      cacheReadTokens: u.cacheReadTokens ?? 0,
+      cacheWriteTokens: u.cacheWriteTokens ?? 0,
+      totalTokens: u.totalTokens ?? 0,
+      estimatedCostUSD: u.costUSD ?? 0
+    })).sort((a, b) => b.totalTokens - a.totalTokens);
+    return breakdown;
+  }
+  const byModel = {};
+  for (const s of filterSessions(data.sessions ?? [], harness)) {
+    const model = s.model || "unknown";
+    if (!byModel[model])
+      byModel[model] = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, estimatedCostUSD: 0 };
+    const agg = byModel[model];
+    const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
+    agg.inputTokens += input;
+    agg.outputTokens += output;
+    agg.cacheReadTokens += cacheRead;
+    agg.cacheWriteTokens += cacheWrite;
+    agg.estimatedCostUSD += cost;
+  }
+  const breakdown = Object.entries(byModel).map(([model, u]) => ({
+    model,
+    inputTokens: u.inputTokens,
+    outputTokens: u.outputTokens,
+    cacheReadTokens: u.cacheReadTokens,
+    cacheWriteTokens: u.cacheWriteTokens,
+    totalTokens: u.inputTokens + u.outputTokens + u.cacheReadTokens + u.cacheWriteTokens,
+    estimatedCostUSD: Math.round(u.estimatedCostUSD * 1e4) / 1e4
+  })).sort((a, b) => b.totalTokens - a.totalTokens);
+  return breakdown;
+}
+function legacyRepos(data, harness) {
+  const allSessions = filterSessions(data.sessions ?? [], harness);
+  const byRemote = {};
+  for (const s of allSessions) {
+    const key = s.git_remote || "";
+    if (!byRemote[key])
+      byRemote[key] = { sessions: 0, messages: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, lastActive: "" };
+    const agg = byRemote[key];
+    const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
+    agg.sessions += 1;
+    agg.messages += sessionMessages(s);
+    agg.inputTokens += input;
+    agg.outputTokens += output;
+    agg.cacheRead += cacheRead;
+    agg.cacheWrite += cacheWrite;
+    agg.costUSD += cost;
+    if (s.start_time && String(s.start_time) > agg.lastActive)
+      agg.lastActive = String(s.start_time);
+  }
+  const rows = Object.entries(byRemote).map(([remote, agg]) => ({
+    repo: remote || "unlinked",
+    remote: remote || null,
+    sessions: agg.sessions,
+    messages: agg.messages,
+    inputTokens: agg.inputTokens,
+    outputTokens: agg.outputTokens,
+    totalTokens: agg.inputTokens + agg.outputTokens + agg.cacheRead + agg.cacheWrite,
+    estimatedCostUSD: Math.round(agg.costUSD * 1e4) / 1e4,
+    lastActive: agg.lastActive || null
+  })).sort((a, b) => b.totalTokens - a.totalTokens);
+  return rows;
+}
+
+// projected-analytics.ts
+var round = (n, places) => Math.round(n * 10 ** places) / 10 ** places;
+function spend(r, places) {
+  return {
+    inputTokens: r.main.input,
+    outputTokens: r.main.output,
+    cacheReadTokens: r.main.cacheRead,
+    cacheWriteTokens: r.main.cacheWrite,
+    totalTokens: r.main.input + r.main.output + r.main.cacheRead + r.main.cacheWrite,
+    estimatedCostUSD: round(r.mainCost, places),
+    costPartial: r.costPartial,
+    subagentTokens: Math.max(0, r.allTokens - r.main.total),
+    subagentCostUSD: round(Math.max(0, r.allCost - r.mainCost), places)
+  };
+}
+async function projectedHarnesses(q) {
+  const rows = [...(await projectedRollup(q, "harness")).values()].map((r) => ({
+    harness: r.key,
+    sessions: r.sessions,
+    personTurns: r.personTurns,
+    messages: r.personTurns,
+    ...spend(r, 2),
+    lastActive: r.lastActive,
+    source: "projections"
+  }));
+  return rows.sort((a, b) => b.totalTokens - a.totalTokens);
+}
+async function projectedProjects(q, harness) {
+  const rows = [...(await projectedRollup(q, "project", harness)).values()].filter((r) => r.key).map((r) => {
+    const s = spend(r, 4);
+    return {
+      name: r.key.split(/[\\/]/).filter(Boolean).pop() ?? r.key,
+      path: r.key,
+      sessions: r.sessions,
+      personTurns: r.personTurns,
+      messages: r.personTurns,
+      inputTokens: s.inputTokens,
+      outputTokens: s.outputTokens,
+      totalTokens: s.inputTokens + s.outputTokens,
+      estimatedCostUSD: s.estimatedCostUSD,
+      costPartial: s.costPartial,
+      subagentTokens: s.subagentTokens,
+      subagentCostUSD: s.subagentCostUSD,
+      lastActive: r.lastActive,
+      languages: null,
+      source: "projections"
+    };
+  });
+  return rows.sort((a, b) => b.totalTokens - a.totalTokens);
+}
+async function projectedRepos(q, harness) {
+  const rows = [...(await projectedRollup(q, "repo", harness)).values()].map((r) => ({
+    repo: r.key || "unlinked",
+    remote: r.key || null,
+    sessions: r.sessions,
+    personTurns: r.personTurns,
+    messages: r.personTurns,
+    ...spend(r, 4),
+    lastActive: r.lastActive,
+    source: "projections"
+  }));
+  return rows.sort((a, b) => b.totalTokens - a.totalTokens);
+}
+async function projectedCosts(q, harness) {
+  const rows = [...(await projectedRollup(q, "model", harness)).values()].map((r) => {
+    const { costPartial, subagentTokens, subagentCostUSD, ...s } = spend(r, 4);
+    return { model: r.key ?? "unknown", ...s, costPartial, subagentTokens, subagentCostUSD, source: "projections" };
+  });
+  return rows.sort((a, b) => b.totalTokens - a.totalTokens);
+}
+function streakOf(days, today) {
+  const set = new Set(days);
+  const prev = (d) => new Date(Date.parse(`${d}T00:00:00Z`) - 86400000).toISOString().slice(0, 10);
+  let d = set.has(today) ? today : prev(today);
+  let n = 0;
+  while (set.has(d)) {
+    n++;
+    d = prev(d);
+  }
+  return n;
+}
+async function projectedSummary(q, harness, now = () => new Date) {
+  const unified = !harness || harness === "all";
+  const base = harnessScope(harness);
+  const [totals, models, projects, days] = await Promise.all([
+    projectedRollup(q, null, harness),
+    allMetricGroups(q, { ...base, groupBy: "model", subagent: "false", metrics: "tokens" }),
+    allMetricGroups(q, { ...base, groupBy: "project", metrics: "sessions" }),
+    allMetricGroups(q, { ...base, groupBy: "day", metrics: "sessions" })
+  ]);
+  const t = totals.get(null) ?? null;
+  const top = (gs, dim, n) => gs.filter((g) => g.key[dim]).sort((a, b) => n(b) - n(a))[0]?.key[dim] ?? "—";
+  const activeDays = days.groups.map((g) => g.key.day).filter((d) => !!d);
+  const s = t ? spend(t, 2) : null;
+  return {
+    harness: unified ? "all" : harness,
+    totalInputTokens: s?.inputTokens ?? 0,
+    totalOutputTokens: s?.outputTokens ?? 0,
+    totalCacheReadTokens: s?.cacheReadTokens ?? 0,
+    totalCacheWriteTokens: s?.cacheWriteTokens ?? 0,
+    estimatedCostUSD: s?.estimatedCostUSD ?? 0,
+    costPartial: s?.costPartial ?? false,
+    subagentTokens: s?.subagentTokens ?? 0,
+    subagentCostUSD: s?.subagentCostUSD ?? 0,
+    totalSessions: t?.sessions ?? 0,
+    topModel: top(models.groups, "model", (g) => (g.metrics.tokens?.input ?? 0) + (g.metrics.tokens?.output ?? 0)),
+    topProject: top(projects.groups, "project", (g) => g.metrics.sessions?.count ?? 0),
+    activeDays: activeDays.length,
+    currentStreak: streakOf(activeDays, now().toISOString().slice(0, 10)),
+    freshness: days.basis?.freshness ?? null,
+    source: "projections"
+  };
+}
+var PROJECTED_TOOLS = {
+  agentistics_summary: projectedSummary,
+  agentistics_harnesses: (q) => projectedHarnesses(q),
+  agentistics_projects: projectedProjects,
+  agentistics_costs: projectedCosts,
+  agentistics_repos: projectedRepos
+};
+
 // agentistics-mcp.ts
 var API = process.env.AGENTISTICS_API ?? "http://localhost:47291";
 var HARNESS_PARAM = harnessParam();
@@ -1159,6 +1596,30 @@ async function apiGet(path) {
     throw new Error(`agentistics API ${path} → HTTP ${res.status}`);
   return res.json();
 }
+var LEGACY_TOOLS = {
+  agentistics_summary: legacySummary,
+  agentistics_harnesses: (data) => legacyHarnesses(data),
+  agentistics_projects: legacyProjects,
+  agentistics_costs: legacyCosts,
+  agentistics_repos: legacyRepos
+};
+async function analytics(tool, harness, from) {
+  if (projectionSurfaceOn("mcp")) {
+    const query = async (params) => {
+      const res = await from.metrics(params);
+      const body = await res.json().catch(() => ({}));
+      return res.ok ? { ok: true, body } : { ok: false, status: res.status, error: String(body?.error ?? res.status) };
+    };
+    try {
+      return await PROJECTED_TOOLS[tool](query, harness);
+    } catch (err) {
+      if (!(err instanceof ProjectionUnavailable))
+        throw err;
+    }
+  }
+  return LEGACY_TOOLS[tool](await from.legacy(), harness);
+}
+var text = (value) => ({ content: [{ type: "text", text: JSON.stringify(value, null, 2) }] });
 async function getPrefs() {
   return apiGet("/api/preferences");
 }
@@ -1538,12 +1999,12 @@ var TOOLS = [
   },
   {
     name: "agentistics_harnesses",
-    description: "Compare the tracked AI coding harnesses side by side. Lists every harness present in the data with its sessions, messages, token usage, estimated cost, and last-active date. Use this to answer 'which harness do I use most / costs most' questions.",
+    description: "Compare the tracked AI coding harnesses side by side. Lists every harness present in the data with its sessions, messages, token usage, estimated cost, and last-active date. Use this to answer 'which harness do I use most / costs most' questions. Rows tagged source \"projections\" (read from the journal) carry personTurns (the person's turns); there `messages` is a deprecated alias of personTurns, and subagent spend is reported apart (subagentTokens, subagentCostUSD).",
     inputSchema: { type: "object", properties: {}, required: [] }
   },
   {
     name: "agentistics_projects",
-    description: "List projects with session counts, message counts, token usage, estimated cost, and last active date. Optionally scope to a single harness.",
+    description: 'List projects with session counts, message counts, token usage, estimated cost, and last active date. Optionally scope to a single harness. Rows tagged source "projections" (read from the journal) carry personTurns (the person\'s turns); there `messages` is a deprecated alias of personTurns, and subagent spend is reported apart (subagentTokens, subagentCostUSD).',
     inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
   },
   {
@@ -1720,7 +2181,7 @@ var TOOLS = [
   },
   {
     name: "agentistics_repos",
-    description: "List repositories, grouped by normalized git remote (independent of local path or which machine produced the session), with session/message/token/cost totals and last-active date. Sessions with no linked repository are grouped under 'unlinked'. Optionally scope to a single harness.",
+    description: "List repositories, grouped by normalized git remote (independent of local path or which machine produced the session), with session/message/token/cost totals and last-active date. Sessions with no linked repository are grouped under 'unlinked'. Optionally scope to a single harness. Rows tagged source \"projections\" (read from the journal) carry personTurns (the person's turns); there `messages` is a deprecated alias of personTurns, and subagent spend is reported apart (subagentTokens, subagentCostUSD).",
     inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
   },
   {
@@ -1961,128 +2422,23 @@ async function callTool(req) {
       }
       case "agentistics_summary": {
         const harness = args?.harness;
-        const unified = !harness || harness === "all";
-        const data = await apiGet("/api/data");
-        const sc = data.statsCache ?? {};
-        const totals = statsCacheTotals(sc);
-        const allSessions = filterSessions(data.sessions ?? [], harness);
-        let totalCostUSD = 0;
-        let totalInput = 0, totalOutput = 0, totalCacheRead = 0, totalCacheWrite = 0;
-        const modelTokens = {};
-        const projectSessions = {};
-        const activeDates = new Set;
-        for (const s of allSessions) {
-          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
-          totalInput += input;
-          totalOutput += output;
-          totalCacheRead += cacheRead;
-          totalCacheWrite += cacheWrite;
-          totalCostUSD += cost;
-          if (s.model)
-            modelTokens[s.model] = (modelTokens[s.model] ?? 0) + input + output;
-          if (s.project_path)
-            projectSessions[s.project_path] = (projectSessions[s.project_path] ?? 0) + 1;
-          if (s.start_time)
-            activeDates.add(String(s.start_time).slice(0, 10));
-        }
-        const claudeFallback = unified || harness === "claude";
-        const topModel = Object.entries(modelTokens).sort(([, a], [, b]) => b - a)[0]?.[0] ?? (claudeFallback ? totals.topModel ?? "—" : "—");
-        const topProject = Object.entries(projectSessions).sort(([, a], [, b]) => b - a)[0]?.[0] ?? "—";
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify({
-              harness: unified ? "all" : harness,
-              totalInputTokens: totalInput || (claudeFallback ? totals.input : 0),
-              totalOutputTokens: totalOutput || (claudeFallback ? totals.output : 0),
-              totalCacheReadTokens: totalCacheRead || (claudeFallback ? totals.cacheRead : 0),
-              totalCacheWriteTokens: totalCacheWrite || (claudeFallback ? totals.cacheWrite : 0),
-              estimatedCostUSD: Math.round((totalCostUSD || (claudeFallback ? totals.cost : 0)) * 100) / 100,
-              totalSessions: allSessions.length,
-              topModel,
-              topProject,
-              activeDays: activeDates.size || (claudeFallback ? sc.activeDays ?? 0 : 0),
-              currentStreak: claudeFallback ? sc.currentStreak ?? 0 : null
-            }, null, 2)
-          }]
-        };
+        return text(await analytics("agentistics_summary", harness, {
+          legacy: () => apiGet("/api/data"),
+          metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
+        }));
       }
       case "agentistics_harnesses": {
-        const data = await apiGet("/api/data");
-        const present = data.harnesses ?? ["claude"];
-        const sessions = data.sessions ?? [];
-        const rows = present.map((h) => {
-          const hs = sessions.filter((s) => sessionHarness(s) === h);
-          let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, cost = 0, messages = 0, lastActive = "";
-          for (const s of hs) {
-            const t = sessionTokens2(s);
-            input += t.input;
-            output += t.output;
-            cacheRead += t.cacheRead;
-            cacheWrite += t.cacheWrite;
-            cost += t.cost;
-            messages += sessionMessages(s);
-            if (s.start_time && String(s.start_time) > lastActive)
-              lastActive = String(s.start_time);
-          }
-          return {
-            harness: h,
-            sessions: hs.length,
-            messages,
-            inputTokens: input,
-            outputTokens: output,
-            cacheReadTokens: cacheRead,
-            cacheWriteTokens: cacheWrite,
-            totalTokens: input + output + cacheRead + cacheWrite,
-            estimatedCostUSD: Math.round(cost * 100) / 100,
-            lastActive: lastActive || null
-          };
-        }).sort((a, b) => b.totalTokens - a.totalTokens);
-        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+        return text(await analytics("agentistics_harnesses", undefined, {
+          legacy: () => apiGet("/api/data"),
+          metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
+        }));
       }
       case "agentistics_projects": {
         const harness = args?.harness;
-        const data = await apiGet("/api/data");
-        const allSessions = filterSessions(data.sessions ?? [], harness);
-        const byPath = {};
-        for (const s of allSessions) {
-          const key = s.project_path;
-          if (!key)
-            continue;
-          if (!byPath[key])
-            byPath[key] = { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
-          const agg = byPath[key];
-          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
-          agg.sessions += 1;
-          agg.inputTokens += input;
-          agg.outputTokens += output;
-          agg.cacheRead += cacheRead;
-          agg.cacheWrite += cacheWrite;
-          agg.costUSD += cost;
-          agg.messages += sessionMessages(s);
-          if (!agg.lastActive || (s.start_time ?? "") > agg.lastActive)
-            agg.lastActive = s.start_time ?? "";
-          for (const lang of s.languages ?? [])
-            if (!agg.languages.includes(lang))
-              agg.languages.push(lang);
-        }
-        const projects = data.projects ?? [];
-        const summary = projects.filter((p) => !harness || harness === "all" || byPath[p.path]).map((p) => {
-          const agg = byPath[p.path] ?? { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
-          return {
-            name: p.name,
-            path: p.path,
-            sessions: !harness || harness === "all" ? (p.sessions ?? []).length : agg.sessions,
-            messages: agg.messages,
-            inputTokens: agg.inputTokens,
-            outputTokens: agg.outputTokens,
-            totalTokens: agg.inputTokens + agg.outputTokens,
-            estimatedCostUSD: Math.round(agg.costUSD * 1e4) / 1e4,
-            lastActive: agg.lastActive || null,
-            languages: agg.languages
-          };
-        }).sort((a, b) => b.totalTokens - a.totalTokens);
-        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+        return text(await analytics("agentistics_projects", harness, {
+          legacy: () => apiGet("/api/data"),
+          metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
+        }));
       }
       case "agentistics_sessions": {
         const limit = Math.min(args?.limit ?? 20, 50);
@@ -2110,43 +2466,10 @@ async function callTool(req) {
       }
       case "agentistics_costs": {
         const harness = args?.harness;
-        const data = await apiGet("/api/data");
-        if (!harness || harness === "all" || harness === "claude") {
-          const usage = data.statsCache?.modelUsage ?? {};
-          const breakdown = Object.entries(usage).map(([model, u]) => ({
-            model,
-            inputTokens: u.inputTokens ?? 0,
-            outputTokens: u.outputTokens ?? 0,
-            cacheReadTokens: u.cacheReadTokens ?? 0,
-            cacheWriteTokens: u.cacheWriteTokens ?? 0,
-            totalTokens: u.totalTokens ?? 0,
-            estimatedCostUSD: u.costUSD ?? 0
-          })).sort((a, b) => b.totalTokens - a.totalTokens);
-          return { content: [{ type: "text", text: JSON.stringify(breakdown, null, 2) }] };
-        }
-        const byModel = {};
-        for (const s of filterSessions(data.sessions ?? [], harness)) {
-          const model = s.model || "unknown";
-          if (!byModel[model])
-            byModel[model] = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, estimatedCostUSD: 0 };
-          const agg = byModel[model];
-          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
-          agg.inputTokens += input;
-          agg.outputTokens += output;
-          agg.cacheReadTokens += cacheRead;
-          agg.cacheWriteTokens += cacheWrite;
-          agg.estimatedCostUSD += cost;
-        }
-        const breakdown = Object.entries(byModel).map(([model, u]) => ({
-          model,
-          inputTokens: u.inputTokens,
-          outputTokens: u.outputTokens,
-          cacheReadTokens: u.cacheReadTokens,
-          cacheWriteTokens: u.cacheWriteTokens,
-          totalTokens: u.inputTokens + u.outputTokens + u.cacheReadTokens + u.cacheWriteTokens,
-          estimatedCostUSD: Math.round(u.estimatedCostUSD * 1e4) / 1e4
-        })).sort((a, b) => b.totalTokens - a.totalTokens);
-        return { content: [{ type: "text", text: JSON.stringify(breakdown, null, 2) }] };
+        return text(await analytics("agentistics_costs", harness, {
+          legacy: () => apiGet("/api/data"),
+          metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
+        }));
       }
       case "agentistics_component_catalog": {
         const category = args?.category;
@@ -2382,37 +2705,10 @@ async function callTool(req) {
       }
       case "agentistics_repos": {
         const harness = args?.harness;
-        const data = await apiGet("/api/data");
-        const allSessions = filterSessions(data.sessions ?? [], harness);
-        const byRemote = {};
-        for (const s of allSessions) {
-          const key = s.git_remote || "";
-          if (!byRemote[key])
-            byRemote[key] = { sessions: 0, messages: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, lastActive: "" };
-          const agg = byRemote[key];
-          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens2(s);
-          agg.sessions += 1;
-          agg.messages += sessionMessages(s);
-          agg.inputTokens += input;
-          agg.outputTokens += output;
-          agg.cacheRead += cacheRead;
-          agg.cacheWrite += cacheWrite;
-          agg.costUSD += cost;
-          if (s.start_time && String(s.start_time) > agg.lastActive)
-            agg.lastActive = String(s.start_time);
-        }
-        const rows = Object.entries(byRemote).map(([remote, agg]) => ({
-          repo: remote || "unlinked",
-          remote: remote || null,
-          sessions: agg.sessions,
-          messages: agg.messages,
-          inputTokens: agg.inputTokens,
-          outputTokens: agg.outputTokens,
-          totalTokens: agg.inputTokens + agg.outputTokens + agg.cacheRead + agg.cacheWrite,
-          estimatedCostUSD: Math.round(agg.costUSD * 1e4) / 1e4,
-          lastActive: agg.lastActive || null
-        })).sort((a, b) => b.totalTokens - a.totalTokens);
-        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+        return text(await analytics("agentistics_repos", harness, {
+          legacy: () => apiGet("/api/data"),
+          metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
+        }));
       }
       case "agentistics_team_status": {
         const prefs = await getPrefs();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentistics/mcp",
-  "version": "2.100.0",
+  "version": "2.101.0",
   "description": "Agentistics MCP server — Claude Code analytics for Claude Desktop and Claude Code",
   "type": "module",
   "main": "./dist/agentistics-mcp.js",