@inferevents/mcp 0.5.3 → 1.0.2

package/dist/tools/get-project-summary.d.ts

@@ -1,43 +1,4 @@
 import type { ApiClient } from "../api-client.js";
 export declare const getProjectSummarySchema: {};
-interface KeyMetrics {
-    total_events_30d: number;
-    unique_users_30d: number;
-    daily_active_avg: number;
-    error_rate_pct: number;
-    events_trend_pct: number;
-    users_trend_pct: number;
-    health_score: number;
-    active_issues: number;
-}
-interface EventEntry {
-    event_name: string;
-    category: string | null;
-    count_30d: number;
-    unique_users_30d: number;
-    trend: "up" | "down" | "stable";
-}
-interface FunnelStep {
-    from_event: string;
-    to_event: string;
-    conversion_pct: number;
-    trend: "up" | "down" | "stable";
-}
-interface ThreadEntry {
-    id: string;
-    title: string;
-    severity: string;
-    day_count: number;
-    insight_count: number;
-    latest_annotation: string | null;
-}
-interface ProjectSections {
-    key_metrics?: KeyMetrics;
-    event_catalog?: EventEntry[];
-    funnel_health?: FunnelStep[];
-    active_threads?: ThreadEntry[];
-}
-export declare function formatProjectSummary(sections: ProjectSections): string;
 export declare function handleGetProjectSummary(client: ApiClient): Promise<string>;
-export {};
 //# sourceMappingURL=get-project-summary.d.ts.map

package/dist/tools/get-project-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-project-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-project-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,uBAAuB,IAAK,CAAC;AAI1C,UAAU,UAAU;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;CACjC;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,UAAU,eAAe;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA8EtE;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}
+{"version":3,"file":"get-project-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-project-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,eAAO,MAAM,uBAAuB,IAAK,CAAC;AAiE1C,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA8EhF"}

package/dist/tools/get-project-summary.js

@@ -1,94 +1,116 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
 export const getProjectSummarySchema = {};
-export function formatProjectSummary(sections) {
-    const chart = [];
-    // HEALTH
-    const km = sections.key_metrics;
-    if (km) {
-        const score = Math.max(0, Math.min(10, Math.round(km.health_score)));
-        const filled = "●".repeat(score);
-        const empty = "○".repeat(10 - score);
-        chart.push(`HEALTH: ${filled}${empty} ${score}/10  (${km.active_issues} active issue${km.active_issues === 1 ? "" : "s"})`);
-        chart.push("");
+function renderLlmObsSections(sections, lines) {
+    let rendered = false;
+    const dist = sections.model_distribution;
+    if (dist && Object.keys(dist).length > 0) {
+        lines.push("Model distribution (last 7d)");
+        const sorted = Object.entries(dist).sort((a, b) => b[1] - a[1]);
+        for (const [model, share] of sorted) {
+            lines.push(`  ${(share * 100).toFixed(1).padStart(5)}%  ${model}`);
+        }
+        lines.push("");
+        rendered = true;
     }
-    // KEY METRICS
-    if (km) {
-        chart.push("KEY METRICS (last 30 days)");
-        const trend = (pct) => pct > 0 ? `+${pct}%` : pct < 0 ? `${pct}%` : "flat";
-        chart.push(`  Total events:  ${km.total_events_30d.toLocaleString()}  (${trend(km.events_trend_pct)} vs prior 30d)`);
-        chart.push(`  Unique users:  ${km.unique_users_30d.toLocaleString()}  (${trend(km.users_trend_pct)})`);
-        chart.push(`  Daily active:  ~${km.daily_active_avg.toLocaleString()}`);
-        chart.push(`  Error rate:    ${km.error_rate_pct}%`);
-        chart.push("");
+    const spend = sections.weekly_spend_usd;
+    if (typeof spend === "number") {
+        lines.push(`Weekly spend: $${spend.toFixed(2)}`);
+        rendered = true;
     }
-    // EVENT CATALOG
-    const catalog = sections.event_catalog;
-    if (catalog && catalog.length > 0) {
-        chart.push(`EVENT CATALOG (${catalog.length} event${catalog.length === 1 ? "" : "s"} tracked)`);
-        // Group by category
-        const grouped = {};
-        for (const e of catalog) {
-            const cat = e.category ?? "uncategorized";
-            if (!grouped[cat])
-                grouped[cat] = [];
-            const arrow = e.trend === "up" ? "↑" : e.trend === "down" ? "↓" : "→";
-            grouped[cat].push(`${e.event_name} (${e.count_30d.toLocaleString()} ${arrow})`);
-        }
-        for (const [cat, events] of Object.entries(grouped)) {
-            chart.push(`  ${cat}: ${events.join(", ")}`);
+    const errorRate = sections.error_rate_7d;
+    if (typeof errorRate === "number") {
+        lines.push(`Error rate (7d): ${(errorRate * 100).toFixed(1)}%`);
+        rendered = true;
+    }
+    if (typeof spend === "number" || typeof errorRate === "number")
+        lines.push("");
+    const threads = sections.anomaly_threads;
+    if (threads && threads.length > 0) {
+        lines.push(`Active anomaly threads: ${threads.length}`);
+        for (const t of threads) {
+            lines.push(`  • ${t.title} — day ${t.day_count} (trace_id=${t.thread_id})`);
         }
-        chart.push("");
+        lines.push("");
+        rendered = true;
     }
-    // FUNNEL HEALTH
-    const funnel = sections.funnel_health;
-    if (funnel && funnel.length > 0) {
-        chart.push("FUNNEL HEALTH");
-        for (const step of funnel) {
-            const warn = step.trend === "down" ? " ⚠️" : "";
-            chart.push(`  ${step.from_event} → ${step.to_event}:  ${step.conversion_pct}% conversion${warn}`);
+    return rendered;
+}
+function renderLegacySections(sections, lines) {
+    const events = sections.event_catalog;
+    if (events && events.length > 0) {
+        lines.push("Event catalog (legacy)");
+        for (const e of events.slice(0, 10)) {
+            lines.push(`  ${e.count.toString().padStart(8)} ${e.name}`);
         }
-        chart.push("");
+        lines.push("");
     }
-    // ACTIVE THREADS
-    const threads = sections.active_threads;
-    if (threads && threads.length > 0) {
-        chart.push(`ACTIVE THREADS (${threads.length})`);
-        const severityDot = {
-            critical: "🔴",
-            notable: "🟡",
-            informational: "🔵",
-        };
-        for (const t of threads) {
-            const dot = severityDot[t.severity] ?? "⚪";
-            const dayLabel = t.day_count > 1 ? ` (${t.day_count} days)` : "";
-            chart.push(`  ${dot} ${t.title}${dayLabel}`);
-            if (t.latest_annotation) {
-                chart.push(`       ↳ ${t.latest_annotation}`);
-            }
+    const funnel = sections.funnel_performance;
+    if (funnel) {
+        lines.push("Funnel performance (legacy)");
+        for (const [stage, rate] of Object.entries(funnel)) {
+            lines.push(`  ${stage.padEnd(16)} ${(rate * 100).toFixed(1)}%`);
         }
-        chart.push("");
+        lines.push("");
     }
-    return chart.join("\n");
 }
 export async function handleGetProjectSummary(client) {
-    const data = await client.getProjectSummary();
-    if (data.message) {
-        return data.message;
+    const result = await client.getProjectSummary();
+    const warnings = [];
+    const caveats = [];
+    if (result.compiled_at === null || !result.sections || Object.keys(result.sections).length === 0) {
+        warnings.push("Project summary has not been compiled yet. The wiki-compiler cron runs hourly; wait a bit and try again.");
+        return toolResponseText(wrapResult({
+            primary: { rendered_text: "", compiled_at: null },
+            source: "project_summary",
+            warnings,
+            caveats,
+        }));
     }
-    if (!data.compiled_at) {
-        return "No project summary available yet. Summaries are compiled hourly after events start flowing.";
-    }
-    const body = formatProjectSummary(data.sections);
-    const output = [
-        "Present this project summary to the user exactly as-is:",
-        "",
-        "```",
-        body,
-        "```",
-        "",
-        `Last compiled: ${data.compiled_at}`,
+    const sections = result.sections;
+    const lines = [
+        `Project summary`,
+        `Compiled: ${result.compiled_at}`,
+        "─".repeat(60),
         "",
-        "Use get_insights for detailed alerts, or query specific events with get_event_counts.",
-    ].join("\n");
-    return output;
+    ];
+    const renderedLlmObs = renderLlmObsSections(sections, lines);
+    if (!renderedLlmObs) {
+        caveats.push("Summary is in the legacy web-analytics shape. Phase 5 wiki-compiler rewrite will populate LLM-obs sections (model_distribution, weekly_spend_usd, error_rate_7d, anomaly_threads).");
+    }
+    // Phase 5 wiki-compiler emits `spend_caveat` when any model lacks pricing.
+    // Shape: { partial, missing_pricing_models[], pricing_source_version, message }.
+    // Prefer the pre-formatted `message`; fall back to reconstructing from
+    // `missing_pricing_models[]`; defensive string-shape branch for any future
+    // renderer-to-compiler drift.
+    const spendCaveat = sections.spend_caveat;
+    if (spendCaveat !== undefined && spendCaveat !== null) {
+        if (typeof spendCaveat === "string" && spendCaveat.length > 0) {
+            caveats.push(spendCaveat);
+        }
+        else if (typeof spendCaveat === "object") {
+            const cast = spendCaveat;
+            if (typeof cast.message === "string" && cast.message.length > 0) {
+                caveats.push(cast.message);
+            }
+            else if (Array.isArray(cast.missing_pricing_models) && cast.missing_pricing_models.length > 0) {
+                const list = cast.missing_pricing_models.join(", ");
+                const suffix = cast.pricing_source_version
+                    ? ` (pricing table version ${cast.pricing_source_version})`
+                    : "";
+                caveats.push(`Weekly spend excludes models without pricing: ${list}. Update packages/shared/src/pricing.ts.${suffix}`);
+            }
+            // Empty-array with no message → silent no-op (noise suppression).
+        }
+    }
+    renderLegacySections(sections, lines);
+    return toolResponseText(wrapResult({
+        primary: {
+            rendered_text: lines.join("\n"),
+            compiled_at: result.compiled_at,
+        },
+        source: "project_summary",
+        warnings,
+        caveats,
+    }));
 }
 //# sourceMappingURL=get-project-summary.js.map

package/dist/tools/get-project-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-project-summary.js","sourceRoot":"","sources":["../../src/tools/get-project-summary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-project-summary.js","sourceRoot":"","sources":["../../src/tools/get-project-summary.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-span.d.ts

@@ -0,0 +1,6 @@
+import type { ApiClient } from "../api-client.js";
+export interface GetSpanParams {
+    span_id: string;
+}
+export declare function handleGetSpan(client: ApiClient, params: GetSpanParams): Promise<string>;
+//# sourceMappingURL=get-span.d.ts.map

package/dist/tools/get-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-span.d.ts","sourceRoot":"","sources":["../../src/tools/get-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CA2CjB"}

package/dist/tools/get-span.js

@@ -0,0 +1,30 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleGetSpan(client, params) {
+    const result = await client.getSpan(params.span_id);
+    const span = result.span;
+    const attributes = span.attributes ?? {};
+    const warnings = [];
+    const caveats = [];
+    const statusCode = span.status_code;
+    if (statusCode >= 400) {
+        const errorType = span.error_type;
+        warnings.push(`Span returned HTTP status ${statusCode}${errorType ? ` (${errorType})` : ""}.`);
+    }
+    if (attributes.stream_truncated === true) {
+        warnings.push("Stream was truncated mid-response — content and token counts are incomplete.");
+    }
+    const usageEstimated = attributes["gen_ai.usage.estimated"];
+    if (usageEstimated === true) {
+        warnings.push("Token counts are estimated (upstream did not emit authoritative usage). Treat as approximate.");
+    }
+    if (span.body_stored === false) {
+        caveats.push("Messages redacted at ingest (x-infer-redact: true). Metadata and token counts are still available.");
+    }
+    return toolResponseText(wrapResult({
+        primary: result,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-span.js.map

package/dist/tools/get-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-span.js","sourceRoot":"","sources":["../../src/tools/get-span.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMjE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,MAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA+B,CAAC;IACpD,MAAM,UAAU,GAAI,IAAI,CAAC,UAA6C,IAAI,EAAE,CAAC;IAE7E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAqB,CAAC;IAC9C,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,UAA2B,CAAC;QACnD,QAAQ,CAAC,IAAI,CACX,6BAA6B,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CACX,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAI,UAAsC,CAAC,wBAAwB,CAAC,CAAC;IACzF,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CACX,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CACV,oGAAoG,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,OAAO;QACf,QAAQ;QACR,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/get-token-usage.d.ts

@@ -0,0 +1,7 @@
+import type { ApiClient } from "../api-client.js";
+export interface GetTokenUsageParams {
+    dimension: "model" | "user" | "session" | "feature";
+    time_window: "1h" | "6h" | "24h" | "7d" | "30d";
+}
+export declare function handleGetTokenUsage(client: ApiClient, params: GetTokenUsageParams): Promise<string>;
+//# sourceMappingURL=get-token-usage.d.ts.map

package/dist/tools/get-token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-usage.d.ts","sourceRoot":"","sources":["../../src/tools/get-token-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;CACjD;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/tools/get-token-usage.js

@@ -0,0 +1,25 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleGetTokenUsage(client, params) {
+    const result = await client.getTokenUsage(params);
+    const warnings = [];
+    const caveats = [
+        "Token counts sum gen_ai_usage_input_tokens + gen_ai_usage_output_tokens per span.",
+        "Rows with NULL token counts contribute 0 to their group total.",
+    ];
+    if (result.groups.length === 0) {
+        warnings.push(`No token data for dimension=${params.dimension} over the last ${params.time_window}.`);
+    }
+    for (const g of result.groups) {
+        if (g.estimated_fraction > 0) {
+            const pct = Math.round(g.estimated_fraction * 100);
+            warnings.push(`${params.dimension}="${g.key}" — ${pct}% of spans have tiktoken-estimated token counts (upstream did not emit authoritative usage). Totals are approximate.`);
+        }
+    }
+    return toolResponseText(wrapResult({
+        primary: result,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-token-usage.js.map

package/dist/tools/get-token-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-usage.js","sourceRoot":"","sources":["../../src/tools/get-token-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOjE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,MAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa;QACxB,mFAAmF;QACnF,gEAAgE;KACjE,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,SAAS,kBAAkB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC;YACnD,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,OAAO,GAAG,sHAAsH,CAC9J,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,OAAO;QACf,QAAQ;QACR,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/get-trace.d.ts

@@ -0,0 +1,6 @@
+import type { ApiClient } from "../api-client.js";
+export interface GetTraceParams {
+    trace_id: string;
+}
+export declare function handleGetTrace(client: ApiClient, params: GetTraceParams): Promise<string>;
+//# sourceMappingURL=get-trace.d.ts.map

package/dist/tools/get-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trace.d.ts","sourceRoot":"","sources":["../../src/tools/get-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/tools/get-trace.js

@@ -0,0 +1,28 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleGetTrace(client, params) {
+    const trace = await client.getTrace(params.trace_id);
+    const warnings = [];
+    const caveats = [
+        "Token-estimated flag (gen_ai.usage.estimated) is NOT included in this projection. Call get_span(<span_id>) for full attributes.",
+    ];
+    const truncatedCount = trace.spans.filter((s) => s.stream_truncated).length;
+    if (truncatedCount > 0) {
+        warnings.push(`${truncatedCount} span(s) in this trace were stream-truncated — token counts and content may be incomplete.`);
+    }
+    const errorCount = trace.spans.filter((s) => s.status_code >= 400).length;
+    if (errorCount > 0) {
+        warnings.push(`${errorCount} span(s) in this trace returned HTTP >= 400 — call get_span for error details.`);
+    }
+    const rootCount = trace.spans.filter((s) => s.depth === 0).length;
+    if (rootCount > 1) {
+        warnings.push(`This trace has ${rootCount} unconnected roots — likely orphaned spans. ` +
+            `root_span_id reports only the first; inspect spans[] for the full set.`);
+    }
+    return toolResponseText(wrapResult({
+        primary: trace,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-trace.js.map

package/dist/tools/get-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trace.js","sourceRoot":"","sources":["../../src/tools/get-trace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMjE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,MAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa;QACxB,iIAAiI;KAClI,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;IAC5E,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,GAAG,cAAc,4FAA4F,CAC9G,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1E,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CACX,GAAG,UAAU,gFAAgF,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CACX,kBAAkB,SAAS,8CAA8C;YACvE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,OAAO;QACf,QAAQ;QACR,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/list-spans.d.ts

@@ -0,0 +1,15 @@
+import type { ApiClient } from "../api-client.js";
+export interface ListSpansParams {
+    model?: string;
+    user_id?: string;
+    session_id?: string;
+    time_window?: "1h" | "6h" | "24h" | "7d" | "30d";
+    tags?: string[];
+    min_duration_ms?: number;
+    status_min?: number;
+    status_max?: number;
+    cursor?: string;
+    limit?: number;
+}
+export declare function handleListSpans(client: ApiClient, params: ListSpansParams): Promise<string>;
+//# sourceMappingURL=list-spans.d.ts.map

package/dist/tools/list-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-spans.d.ts","sourceRoot":"","sources":["../../src/tools/list-spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/tools/list-spans.js

@@ -0,0 +1,19 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleListSpans(client, params) {
+    const response = await client.listSpans(params);
+    const warnings = [];
+    const caveats = [];
+    if (response.spans.length === 0) {
+        warnings.push("No spans matched these filters. Try widening the time_window or removing filters.");
+    }
+    if (response.next_cursor !== null) {
+        caveats.push(`More results available — pass cursor="${response.next_cursor}" to continue pagination.`);
+    }
+    return toolResponseText(wrapResult({
+        primary: response,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=list-spans.js.map

package/dist/tools/list-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-spans.js","sourceRoot":"","sources":["../../src/tools/list-spans.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAejE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,MAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CACX,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CACV,yCAAyC,QAAQ,CAAC,WAAW,2BAA2B,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO;QACf,QAAQ;QACR,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export declare const listSpansInputSchema: {
+    model: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+    time_window: z.ZodOptional<z.ZodEnum<["1h", "6h", "24h", "7d", "30d"]>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    min_duration_ms: z.ZodOptional<z.ZodNumber>;
+    status_min: z.ZodOptional<z.ZodNumber>;
+    status_max: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getTraceInputSchema: {
+    trace_id: z.ZodString;
+};
+export declare const getSpanInputSchema: {
+    span_id: z.ZodString;
+};
+export declare const getLatencyStatsInputSchema: {
+    dimension: z.ZodEnum<["model", "user", "session", "feature"]>;
+    time_window: z.ZodOptional<z.ZodEnum<["1h", "6h", "24h", "7d", "30d"]>>;
+};
+export declare const getTokenUsageInputSchema: {
+    dimension: z.ZodEnum<["model", "user", "session", "feature"]>;
+    time_window: z.ZodEnum<["1h", "6h", "24h", "7d", "30d"]>;
+};
+export declare const getCostStatsInputSchema: {
+    dimension: z.ZodEnum<["model", "user", "session", "feature"]>;
+    time_window: z.ZodEnum<["1h", "6h", "24h", "7d", "30d"]>;
+};
+export declare const getErrorSpansInputSchema: {
+    time_window: z.ZodOptional<z.ZodEnum<["1h", "6h", "24h", "7d", "30d"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+};
+export declare const annotateSpanInputSchema: {
+    span_id: z.ZodString;
+    content: z.ZodString;
+};
+export declare const annotateTraceInputSchema: {
+    trace_id: z.ZodString;
+    content: z.ZodString;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAqBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;CAE/B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;CAGtC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;CAGnC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;CAIpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;CASnC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAUpC,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+/**
+ * Shared Zod schemas for every new Phase 4 tool. One file so:
+ *   - Handlers and tests import the same shape.
+ *   - Code reviewers can audit §7.4 (no project_id) in a single place.
+ *   - Future tools add to this file before creating their handler.
+ *
+ * Each export is a bare-keys object (not a zod.object(...)) because the MCP
+ * SDK's `server.tool(name, description, schemaKeys, handler)` call wants the
+ * keys object directly, not a wrapped schema. Tests build `z.object(keys)`
+ * when they need to exercise parsing.
+ */
+const TIME_WINDOW = z
+    .enum(["1h", "6h", "24h", "7d", "30d"])
+    .describe("Time window for stat aggregation. 24h = rolling 24 hours back from now.");
+const DIMENSION = z
+    .enum(["model", "user", "session", "feature"])
+    .describe("Dimension to group by. `model` = gen_ai_request_model; `user` = user_id; " +
+    "`session` = session_id; `feature` = metadata->>'feature'.");
+const LIMIT = z
+    .number()
+    .int()
+    .min(1)
+    .max(200)
+    .describe("Max rows (default 50, hard cap 200).");
+export const listSpansInputSchema = {
+    model: z.string().optional().describe("Exact match on `gen_ai_request_model`."),
+    user_id: z.string().optional().describe("Exact match on span `user_id`."),
+    session_id: z.string().optional().describe("Exact match on span `session_id`."),
+    time_window: TIME_WINDOW.optional().describe("If present, restricts to spans whose `start_time` falls inside the window."),
+    tags: z.array(z.string()).optional().describe("Must contain ALL given tags."),
+    min_duration_ms: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Filter spans whose `duration_ms` is at least this many ms."),
+    status_min: z.number().int().optional().describe("Minimum HTTP status_code (inclusive)."),
+    status_max: z.number().int().optional().describe("Maximum HTTP status_code (inclusive)."),
+    cursor: z
+        .string()
+        .optional()
+        .describe("Opaque pagination cursor from a previous `list_spans` call."),
+    limit: LIMIT.optional(),
+};
+export const getTraceInputSchema = {
+    trace_id: z.string().min(1).describe("Trace ID returned by any gateway call (from the `x-infer-trace-id` response header)."),
+};
+export const getSpanInputSchema = {
+    span_id: z.string().min(1).describe("Span ID (from `x-infer-span-id`)."),
+};
+export const getLatencyStatsInputSchema = {
+    dimension: DIMENSION,
+    time_window: TIME_WINDOW.optional().describe("Default: `24h`."),
+};
+export const getTokenUsageInputSchema = {
+    dimension: DIMENSION,
+    time_window: TIME_WINDOW,
+};
+export const getCostStatsInputSchema = {
+    dimension: DIMENSION,
+    time_window: TIME_WINDOW,
+};
+export const getErrorSpansInputSchema = {
+    time_window: TIME_WINDOW.optional().describe("Default: `24h`."),
+    limit: LIMIT.optional(),
+    cursor: z.string().optional(),
+};
+export const annotateSpanInputSchema = {
+    span_id: z.string().min(1).describe("The span_id to attach the annotation to."),
+    content: z
+        .string()
+        .min(1)
+        .max(2000)
+        .describe("Your finding — what this span shows, root cause, context. Surfaces in `get_span` output going forward."),
+};
+export const annotateTraceInputSchema = {
+    trace_id: z.string().min(1).describe("The trace_id to annotate (applies to the whole trace, not a single span)."),
+    content: z
+        .string()
+        .min(1)
+        .max(2000)
+        .describe("Trace-level finding — conclusion about the multi-span agent turn. " +
+        "Use for root-cause writeups that don't belong to any single span."),
+};
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

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

package/dist/tools/switch-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"switch-project.d.ts","sourceRoot":"","sources":["../../src/tools/switch-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;CAK/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}
+{"version":3,"file":"switch-project.d.ts","sourceRoot":"","sources":["../../src/tools/switch-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;CAK/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,MAAM,CAAC,CAkFjB"}