@inferevents/mcp 0.5.3 → 1.0.0

package/dist/tools/deprecated-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-tools.d.ts","sourceRoot":"","sources":["../../src/tools/deprecated-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAIjF,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAqE3D,CAAC"}

package/dist/tools/deprecated-tools.js

@@ -0,0 +1,78 @@
+import { buildDeprecationShim } from "./deprecated.js";
+const SUNSET_ON = "2026-06-17";
+/**
+ * The 6 retired web-analytics tools. Their old registrations in server.ts
+ * become handlers that emit the deprecation envelope from
+ * `buildDeprecationShim`. After 2026-06-17 these registrations should be
+ * deleted outright and callers will see "unknown tool" from the MCP SDK.
+ *
+ * Spec §7.1 retired list + §8.4 60-day shim window.
+ */
+export const RETIRED_TOOL_SHIMS = {
+    get_event_counts: {
+        description: "DEPRECATED — web-analytics tool. Returns a deprecation notice. " +
+            `Retires on ${SUNSET_ON}. Use list_spans + get_token_usage for LLM-obs equivalents.`,
+        handler: buildDeprecationShim({
+            toolName: "get_event_counts",
+            replacementTools: ["list_spans", "get_token_usage"],
+            sunsetOn: SUNSET_ON,
+            reason: "Infer pivoted from web-analytics events to LLM-obs spans; event-count aggregation has no direct LLM-obs analogue.",
+        }),
+    },
+    get_retention: {
+        description: `DEPRECATED — web-analytics tool. Retires on ${SUNSET_ON}. Cohort retention has no LLM-obs equivalent.`,
+        handler: buildDeprecationShim({
+            toolName: "get_retention",
+            replacementTools: [],
+            sunsetOn: SUNSET_ON,
+            reason: "Cohort-based retention doesn't map to LLM-obs data; sessions are short-lived, not repeated returns.",
+        }),
+    },
+    get_top_events: {
+        description: `DEPRECATED — retires on ${SUNSET_ON}. Use list_spans to inspect recent spans.`,
+        handler: buildDeprecationShim({
+            toolName: "get_top_events",
+            replacementTools: ["list_spans"],
+            sunsetOn: SUNSET_ON,
+            reason: "Event-count leaderboards don't apply to LLM-obs; a get_top_models tool is planned for v1.1.",
+        }),
+    },
+    get_user_journey: {
+        description: `DEPRECATED — retires on ${SUNSET_ON}. Use get_trace (for one trace) or list_spans (filtered by user_id).`,
+        handler: buildDeprecationShim({
+            toolName: "get_user_journey",
+            replacementTools: ["get_trace", "list_spans"],
+            sunsetOn: SUNSET_ON,
+            reason: "Per-user event journeys are replaced by per-trace span trees (get_trace) and user-filtered span lists (list_spans?user_id=...).",
+        }),
+    },
+    get_ontology: {
+        description: `DEPRECATED — retires on ${SUNSET_ON}. No LLM-obs equivalent.`,
+        handler: buildDeprecationShim({
+            toolName: "get_ontology",
+            replacementTools: [],
+            sunsetOn: SUNSET_ON,
+            reason: "Event ontology (activation/engagement/monetization classification) is a web-analytics concept and doesn't apply to LLM calls.",
+        }),
+    },
+    update_ontology: {
+        description: `DEPRECATED — retires on ${SUNSET_ON}. No LLM-obs equivalent.`,
+        handler: buildDeprecationShim({
+            toolName: "update_ontology",
+            replacementTools: [],
+            sunsetOn: SUNSET_ON,
+            reason: "Event ontology doesn't apply to LLM-obs data.",
+        }),
+    },
+    annotate_thread: {
+        description: `DEPRECATED — split into annotate_span + annotate_trace on 2026-04-18. Retires on ${SUNSET_ON}. ` +
+            `Use annotate_span(span_id, content) for single-call findings or annotate_trace(trace_id, content) for agent-turn diagnoses.`,
+        handler: buildDeprecationShim({
+            toolName: "annotate_thread",
+            replacementTools: ["annotate_span", "annotate_trace"],
+            sunsetOn: SUNSET_ON,
+            reason: "Thread-based annotation is replaced by two finer-grained tools: span-level (one LLM call) and trace-level (one agent turn).",
+        }),
+    },
+};
+//# sourceMappingURL=deprecated-tools.js.map

package/dist/tools/deprecated-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-tools.js","sourceRoot":"","sources":["../../src/tools/deprecated-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA4B,MAAM,iBAAiB,CAAC;AAEjF,MAAM,SAAS,GAAG,YAAY,CAAC;AAO/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,gBAAgB,EAAE;QAChB,WAAW,EACT,iEAAiE;YACjE,cAAc,SAAS,6DAA6D;QACtF,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,kBAAkB;YAC5B,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC;YACnD,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,mHAAmH;SAC5H,CAAC;KACH;IACD,aAAa,EAAE;QACb,WAAW,EACT,+CAA+C,SAAS,+CAA+C;QACzG,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,eAAe;YACzB,gBAAgB,EAAE,EAAE;YACpB,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,qGAAqG;SAC9G,CAAC;KACH;IACD,cAAc,EAAE;QACd,WAAW,EAAE,2BAA2B,SAAS,2CAA2C;QAC5F,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,gBAAgB;YAC1B,gBAAgB,EAAE,CAAC,YAAY,CAAC;YAChC,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,6FAA6F;SACtG,CAAC;KACH;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,2BAA2B,SAAS,sEAAsE;QACvH,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,kBAAkB;YAC5B,gBAAgB,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;YAC7C,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,iIAAiI;SAC1I,CAAC;KACH;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,2BAA2B,SAAS,0BAA0B;QAC3E,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,cAAc;YACxB,gBAAgB,EAAE,EAAE;YACpB,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,+HAA+H;SACxI,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EAAE,2BAA2B,SAAS,0BAA0B;QAC3E,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,iBAAiB;YAC3B,gBAAgB,EAAE,EAAE;YACpB,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,+CAA+C;SACxD,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,oFAAoF,SAAS,IAAI;YACjG,6HAA6H;QAC/H,OAAO,EAAE,oBAAoB,CAAC;YAC5B,QAAQ,EAAE,iBAAiB;YAC3B,gBAAgB,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;YACrD,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,6HAA6H;SACtI,CAAC;KACH;CACF,CAAC"}

package/dist/tools/deprecated.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Factory for deprecated-tool shims. Phase 4 retires 6 web-analytics tools
+ * and splits annotate_thread into annotate_span + annotate_trace. All 7
+ * old names become thin handlers that return a deterministic envelope
+ * explaining the deprecation and pointing at replacement tools.
+ *
+ * After `sunset_on`, the server.ts registration should remove these shims
+ * entirely and the tools become unregistered (MCP clients get "unknown tool"
+ * errors). Spec §8.4.
+ */
+export interface DeprecationShimInput {
+    toolName: string;
+    replacementTools: string[];
+    sunsetOn: string;
+    reason: string;
+}
+export interface ToolHandlerResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function buildDeprecationShim(input: DeprecationShimInput): () => Promise<ToolHandlerResponse>;
+//# sourceMappingURL=deprecated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.d.ts","sourceRoot":"","sources":["../../src/tools/deprecated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAsCpC"}

package/dist/tools/deprecated.js

@@ -0,0 +1,42 @@
+/**
+ * Factory for deprecated-tool shims. Phase 4 retires 6 web-analytics tools
+ * and splits annotate_thread into annotate_span + annotate_trace. All 7
+ * old names become thin handlers that return a deterministic envelope
+ * explaining the deprecation and pointing at replacement tools.
+ *
+ * After `sunset_on`, the server.ts registration should remove these shims
+ * entirely and the tools become unregistered (MCP clients get "unknown tool"
+ * errors). Spec §8.4.
+ */
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+export function buildDeprecationShim(input) {
+    if (!ISO_DATE_RE.test(input.sunsetOn)) {
+        throw new Error(`buildDeprecationShim: sunset_on must be YYYY-MM-DD (got "${input.sunsetOn}")`);
+    }
+    const parsed = new Date(`${input.sunsetOn}T00:00:00Z`);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== input.sunsetOn) {
+        throw new Error(`buildDeprecationShim: sunset_on must be a real calendar date (got "${input.sunsetOn}")`);
+    }
+    const replacementHint = input.replacementTools.length > 0
+        ? `Use ${input.replacementTools.map((t) => `\`${t}\``).join(" or ")} instead.`
+        : "This tool has no direct replacement in the LLM-observability surface.";
+    const trimmedReason = input.reason?.trim() ?? "";
+    const messageLines = [
+        `\`${input.toolName}\` is deprecated and will be removed after ${input.sunsetOn}.`,
+        replacementHint,
+        trimmedReason ? `Reason: ${trimmedReason}` : "",
+    ].filter(Boolean);
+    const payload = {
+        deprecated: true,
+        tool_name: input.toolName,
+        sunset_on: input.sunsetOn,
+        replacement_tools: input.replacementTools,
+        reason: input.reason,
+        message: messageLines.join(" "),
+    };
+    return async () => ({
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        isError: true,
+    });
+}
+//# sourceMappingURL=deprecated.js.map

package/dist/tools/deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.js","sourceRoot":"","sources":["../../src/tools/deprecated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAE1C,MAAM,UAAU,oBAAoB,CAClC,KAA2B;IAE3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,4DAA4D,KAAK,CAAC,QAAQ,IAAI,CAC/E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,YAAY,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CACb,sEAAsE,KAAK,CAAC,QAAQ,IAAI,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GACnB,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC/B,CAAC,CAAC,OAAO,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;QAC9E,CAAC,CAAC,uEAAuE,CAAC;IAE9E,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG;QACnB,KAAK,KAAK,CAAC,QAAQ,8CAA8C,KAAK,CAAC,QAAQ,GAAG;QAClF,eAAe;QACf,aAAa,CAAC,CAAC,CAAC,WAAW,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;KAChD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,MAAM,OAAO,GAAG;QACd,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,iBAAiB,EAAE,KAAK,CAAC,gBAAgB;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;KAChC,CAAC;IAEF,OAAO,KAAK,IAAkC,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-cost-stats.d.ts

@@ -0,0 +1,18 @@
+import type { ApiClient } from "../api-client.js";
+export interface GetCostStatsParams {
+    dimension: "model" | "user" | "session" | "feature";
+    time_window: "1h" | "6h" | "24h" | "7d" | "30d";
+}
+/**
+ * Compute query-time cost per dimension group by joining raw token totals
+ * against @inferevents/shared PRICING_TABLE.
+ *
+ * Contract — silent-zero defense:
+ *   - Unknown (provider, model) pair → cost_usd=null on that per-model breakdown
+ *     AND null-propagates to the group total AND emits a named warning. NEVER
+ *     silently zero-cost an unknown model.
+ *   - Ollama short-circuits to $0 (free by design). That is legitimate zero,
+ *     NOT missing pricing. No warning is emitted for ollama models.
+ */
+export declare function handleGetCostStats(client: ApiClient, params: GetCostStatsParams): Promise<string>;
+//# sourceMappingURL=get-cost-stats.d.ts.map

package/dist/tools/get-cost-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cost-stats.d.ts","sourceRoot":"","sources":["../../src/tools/get-cost-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;CACjD;AA6BD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAsFjB"}

package/dist/tools/get-cost-stats.js

@@ -0,0 +1,88 @@
+import { computeCostUsd } from "@inferevents/shared";
+import { wrapResult, toolResponseText } from "../tool-result.js";
+/**
+ * Compute query-time cost per dimension group by joining raw token totals
+ * against @inferevents/shared PRICING_TABLE.
+ *
+ * Contract — silent-zero defense:
+ *   - Unknown (provider, model) pair → cost_usd=null on that per-model breakdown
+ *     AND null-propagates to the group total AND emits a named warning. NEVER
+ *     silently zero-cost an unknown model.
+ *   - Ollama short-circuits to $0 (free by design). That is legitimate zero,
+ *     NOT missing pricing. No warning is emitted for ollama models.
+ */
+export async function handleGetCostStats(client, params) {
+    const result = await client.getCostStats(params);
+    const rows = result.rows;
+    const warnings = [];
+    const caveats = [
+        `Costs computed at query time from @inferevents/shared PRICING_TABLE (version ${result.pricing_source_version}). The spans.cost_usd column is not populated at ingest.`,
+        `Zero-cost entries for provider="ollama" are legitimate (Ollama is free by design), not a missing-pricing warning.`,
+    ];
+    const missingModels = new Set();
+    const byKey = new Map();
+    for (const r of rows) {
+        const key = r.dimension_key;
+        let group = byKey.get(key);
+        if (!group) {
+            group = { key, count: 0, input_tokens: 0, output_tokens: 0, cost_usd: 0, per_model_breakdown: [] };
+            byKey.set(key, group);
+        }
+        group.count += r.count;
+        group.input_tokens += r.input_tokens;
+        group.output_tokens += r.output_tokens;
+        const cost = computeCostUsd(r.provider, r.model, r.input_tokens, r.output_tokens);
+        if (cost === null) {
+            // Missing from PRICING_TABLE. Ollama short-circuits to 0 inside computeCostUsd,
+            // so null here strictly means "unknown (provider, model)".
+            missingModels.add(`${r.provider}:${r.model}`);
+            group.cost_usd = null; // null propagates up — never silently zero.
+        }
+        else if (group.cost_usd !== null) {
+            group.cost_usd += cost;
+        }
+        group.per_model_breakdown.push({
+            provider: r.provider,
+            model: r.model,
+            count: r.count,
+            input_tokens: r.input_tokens,
+            output_tokens: r.output_tokens,
+            cost_usd: cost,
+        });
+    }
+    for (const missing of missingModels) {
+        warnings.push(`Model "${missing}" not in pricing table — cost computation skipped. Update @inferevents/shared PRICING_TABLE to include this model's input/output rates.`);
+    }
+    for (const group of byKey.values()) {
+        if (group.cost_usd === null && params.dimension !== "model") {
+            const affected = group.per_model_breakdown.filter((b) => b.cost_usd === null).map((b) => b.model);
+            warnings.push(`${params.dimension}="${group.key}" has partial cost (cannot sum to total) because these models lack pricing: ${affected.join(", ")}.`);
+        }
+    }
+    if (byKey.size === 0) {
+        warnings.push(`No cost data for dimension=${params.dimension} over the last ${params.time_window}.`);
+    }
+    // Sort: higher cost first. Null-cost groups sink to the end so missing-pricing
+    // entries don't fake-top the ranking and mislead the agent.
+    const groups = Array.from(byKey.values()).sort((a, b) => {
+        if (a.cost_usd === null && b.cost_usd === null)
+            return 0;
+        if (a.cost_usd === null)
+            return 1;
+        if (b.cost_usd === null)
+            return -1;
+        return b.cost_usd - a.cost_usd;
+    });
+    return toolResponseText(wrapResult({
+        primary: {
+            dimension: result.dimension,
+            time_window: result.time_window,
+            groups,
+            pricing_source_version: result.pricing_source_version,
+        },
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-cost-stats.js.map

package/dist/tools/get-cost-stats.js.map

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

package/dist/tools/get-error-spans.d.ts

@@ -0,0 +1,8 @@
+import type { ApiClient } from "../api-client.js";
+export interface GetErrorSpansParams {
+    time_window?: "1h" | "6h" | "24h" | "7d" | "30d";
+    limit?: number;
+    cursor?: string;
+}
+export declare function handleGetErrorSpans(client: ApiClient, params: GetErrorSpansParams): Promise<string>;
+//# sourceMappingURL=get-error-spans.d.ts.map

package/dist/tools/get-error-spans.d.ts.map

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

package/dist/tools/get-error-spans.js

@@ -0,0 +1,25 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleGetErrorSpans(client, params) {
+    const result = await client.getErrorSpans(params);
+    const warnings = [];
+    const caveats = [
+        "Includes status_code >= 400 AND stream_truncated = true rows (truncated streams are effective failures even at HTTP 200).",
+    ];
+    const retryStormCount = result.spans.filter((s) => s.attempt_count > 1).length;
+    if (retryStormCount > 0) {
+        warnings.push(`${retryStormCount} failure(s) were retried (attempt_count > 1). Check upstream stability or client retry configuration.`);
+    }
+    if (result.spans.length === 0) {
+        warnings.push(`No errors in the last ${params.time_window ?? "24h"} — either things are stable or no traffic reached the gateway.`);
+    }
+    if (result.next_cursor !== null) {
+        caveats.push(`More results available — call get_error_spans again with cursor="${result.next_cursor}".`);
+    }
+    return toolResponseText(wrapResult({
+        primary: result,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-error-spans.js.map

package/dist/tools/get-error-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-spans.js","sourceRoot":"","sources":["../../src/tools/get-error-spans.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQjE,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,2HAA2H;KAC5H,CAAC;IAEF,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CACX,GAAG,eAAe,uGAAuG,CAC1H,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX,yBAAyB,MAAM,CAAC,WAAW,IAAI,KAAK,gEAAgE,CACrH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,oEAAoE,MAAM,CAAC,WAAW,IAAI,CAC3F,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-insights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-insights.d.ts","sourceRoot":"","sources":["../../src/tools/get-insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,iBAAiB;;CAK7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,CAiIjB"}
+{"version":3,"file":"get-insights.d.ts","sourceRoot":"","sources":["../../src/tools/get-insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,eAAO,MAAM,iBAAiB;;CAK7B,CAAC;AAiDF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,CA2EjB"}

package/dist/tools/get-insights.js

@@ -1,127 +1,92 @@
 import { z } from "zod";
+import { wrapResult, toolResponseText } from "../tool-result.js";
 export const getInsightsSchema = {
     severity: z
         .enum(["critical", "notable", "informational"])
         .optional()
         .describe("Filter by severity level. Omit to get all unacknowledged insights."),
 };
+function isLlmObsShape(ev) {
+    return typeof ev.provider === "string" || typeof ev.model === "string";
+}
+function renderEvidence(ev) {
+    if (isLlmObsShape(ev)) {
+        const parts = [];
+        if (ev.provider)
+            parts.push(`provider=${ev.provider}`);
+        if (ev.model)
+            parts.push(`model=${ev.model}`);
+        if (ev.feature)
+            parts.push(`feature=${ev.feature}`);
+        for (const [k, v] of Object.entries(ev)) {
+            if (["provider", "model", "feature"].includes(k))
+                continue;
+            parts.push(`${k}=${typeof v === "number" ? v.toLocaleString() : v}`);
+        }
+        return parts.join(", ");
+    }
+    return Object.entries(ev)
+        .slice(0, 6)
+        .map(([k, v]) => `${k}=${typeof v === "number" ? v.toLocaleString() : v}`)
+        .join(", ");
+}
 export async function handleGetInsights(client, params) {
-    const result = await client.getInsights({
-        severity: params.severity,
-    });
+    const result = await client.getInsights({ severity: params.severity });
+    const warnings = [];
+    const caveats = [];
     if (result.count === 0) {
-        return "No new insights. Everything looks normal, or there isn't enough data yet (insights activate after first events are received).";
+        warnings.push("No new insights. Everything looks normal, or there isn't enough data yet (insights activate after first spans arrive).");
+        return toolResponseText(wrapResult({
+            primary: { insights: [], count: 0, rendered_text: "" },
+            source: "insights",
+            warnings,
+            caveats,
+        }));
     }
-    const severityIcon = {
-        critical: "!!",
-        notable: "!",
-        informational: "i",
-    };
-    const confidenceLabel = {
-        low: "directional, limited data",
-        medium: "moderate confidence",
-        high: "high confidence",
-    };
-    // Split into code actions and strategy actions
-    const codeActions = result.insights.filter((i) => i.action_type === "code");
-    const strategyActions = result.insights.filter((i) => i.action_type === "strategy");
-    const unclassified = result.insights.filter((i) => !i.action_type);
-    const chart = [
-        `${result.count} items need your attention`,
-        `${"─".repeat(50)}`,
+    const severityIcon = { critical: "!!", notable: "!", informational: "i" };
+    const lines = [
+        `${result.count} insight(s) — detected anomalies + notable patterns`,
+        "─".repeat(60),
     ];
-    if (codeActions.length > 0) {
-        chart.push("");
-        chart.push("CODE ACTIONS (investigate / fix)");
-        chart.push("");
-        for (const insight of codeActions) {
-            const icon = severityIcon[insight.severity] ?? "?";
-            const conf = insight.confidence !== "high" ? ` (${confidenceLabel[insight.confidence] ?? ""})` : "";
-            chart.push(`[${icon}] ${insight.summary}${conf}`);
-            const thread = insight.thread;
-            if (thread && thread.day_count > 1) {
-                chart.push(`    Day ${thread.day_count} — ongoing since ${thread.first_detected_at.split("T")[0]}`);
-            }
-            if (thread?.latest_annotation) {
-                chart.push(`    Note: ${thread.latest_annotation}`);
-            }
-            if (insight.suggested_action) {
-                chart.push(`    Action: ${insight.suggested_action}`);
-            }
-            if (insight.correlation_hint) {
-                chart.push(`    Git hint: ${insight.correlation_hint}`);
-            }
-            if (insight.related_events.length > 0) {
-                chart.push(`    Events: ${insight.related_events.join(", ")}`);
+    const insights = result.insights;
+    for (const ins of insights) {
+        const icon = severityIcon[ins.severity] ?? "?";
+        lines.push(`[${icon}] ${ins.summary}`);
+        const evLine = renderEvidence(ins.evidence);
+        if (evLine)
+            lines.push(`    ${evLine}`);
+        if (ins.thread) {
+            if (ins.thread.day_count > 1) {
+                lines.push(`    Day ${ins.thread.day_count} — ongoing since ${ins.thread.first_detected_at.slice(0, 10)}`);
             }
-            if (thread) {
-                chart.push(`    → annotate_thread("${thread.thread_id}", "<your finding>")`);
+            if (ins.thread.latest_annotation) {
+                lines.push(`    Note: ${ins.thread.latest_annotation}`);
             }
-            chart.push("");
+            const annotateCall = isLlmObsShape(ins.evidence)
+                ? `    → annotate_trace("${ins.thread.thread_id}", "<your finding>")`
+                : `    → annotate_span("<span_id>", "<your finding>")`;
+            lines.push(annotateCall);
         }
+        if (ins.suggested_action)
+            lines.push(`    Action: ${ins.suggested_action}`);
+        if (ins.correlation_hint)
+            lines.push(`    Git hint: ${ins.correlation_hint}`);
+        lines.push("");
     }
-    if (strategyActions.length > 0) {
-        chart.push("");
-        chart.push("STRATEGY (your call)");
-        chart.push("");
-        for (const insight of strategyActions) {
-            const icon = severityIcon[insight.severity] ?? "?";
-            const conf = insight.confidence !== "high" ? ` (${confidenceLabel[insight.confidence] ?? ""})` : "";
-            chart.push(`[${icon}] ${insight.summary}${conf}`);
-            const thread = insight.thread;
-            if (thread && thread.day_count > 1) {
-                chart.push(`    Day ${thread.day_count} — ongoing since ${thread.first_detected_at.split("T")[0]}`);
-            }
-            if (thread?.latest_annotation) {
-                chart.push(`    Note: ${thread.latest_annotation}`);
-            }
-            if (thread) {
-                chart.push(`    Thread: ${thread.thread_id}`);
-            }
-            if (insight.suggested_action) {
-                chart.push(`    Action: ${insight.suggested_action}`);
-            }
-            chart.push("");
-        }
-    }
-    if (unclassified.length > 0) {
-        chart.push("");
-        chart.push("OTHER");
-        chart.push("");
-        for (const insight of unclassified) {
-            const icon = severityIcon[insight.severity] ?? "?";
-            chart.push(`[${icon}] ${insight.severity.toUpperCase()}: ${insight.summary}`);
-            const evidence = insight.evidence;
-            const evidenceStr = Object.entries(evidence)
-                .slice(0, 4)
-                .map(([k, v]) => `${k}=${typeof v === "number" ? v.toLocaleString() : v}`)
-                .join(", ");
-            if (evidenceStr) {
-                chart.push(`    ${evidenceStr}`);
-            }
-            chart.push("");
-        }
+    caveats.push("Insights are auto-detected hourly. annotate_trace / annotate_span the findings — they surface in future briefings and in get_project_summary.");
+    const legacyCount = insights.filter((i) => !isLlmObsShape(i.evidence)).length;
+    if (legacyCount > 0) {
+        caveats.push(`${legacyCount} insight(s) still use the legacy event-based schema. Phase 5 cron rewrite will migrate these to LLM-obs shape.`);
     }
-    // Collect thread IDs for the annotation prompt
-    const threadIds = result.insights
-        .map((i) => i.thread?.thread_id)
-        .filter((id) => !!id);
-    const hasThreads = threadIds.length > 0;
-    const output = [
-        // Directive at the TOP — agent reads this first
-        ...(hasThreads
-            ? [
-                "REQUIRED WORKFLOW: For each insight below, (1) investigate using the Git hint and related events, (2) present findings to the user, (3) call annotate_thread(thread_id, content) with what you found. Step 3 is not optional — it makes future sessions smarter. Skip only if the thread already has an annotation that covers your finding.",
-                "",
-            ]
-            : [
-                "Present this briefing to the user exactly as-is. For CODE ACTIONS, use the Git hint to run `git log` and find related commits before presenting. Add the likely cause to each item.",
-                "",
-            ]),
-        "```",
-        ...chart,
-        "```",
-    ].join("\n");
-    return output;
+    return toolResponseText(wrapResult({
+        primary: {
+            insights,
+            count: result.count,
+            rendered_text: lines.join("\n"),
+        },
+        source: "insights",
+        warnings,
+        caveats,
+    }));
 }
 //# sourceMappingURL=get-insights.js.map

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

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

package/dist/tools/get-latency-stats.d.ts

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

package/dist/tools/get-latency-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-latency-stats.d.ts","sourceRoot":"","sources":["../../src/tools/get-latency-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;CAClD;AAID,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkCjB"}

package/dist/tools/get-latency-stats.js

@@ -0,0 +1,28 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+const MIN_SAMPLE = 10;
+export async function handleGetLatencyStats(client, params) {
+    const result = await client.getLatencyStats({
+        dimension: params.dimension,
+        time_window: params.time_window ?? "24h",
+    });
+    const warnings = [];
+    const caveats = [
+        `Percentiles use PostgreSQL PERCENTILE_CONT(p) WITHIN GROUP over duration_ms.`,
+        `Only successful spans (status_code < 400) are included — error spans skew tails unfairly.`,
+    ];
+    if (result.groups.length === 0) {
+        warnings.push(`No data for dimension=${params.dimension} over the last ${params.time_window ?? "24h"}.`);
+    }
+    for (const g of result.groups) {
+        if (g.count < MIN_SAMPLE) {
+            warnings.push(`Small sample: ${params.dimension}="${g.key}" has n=${g.count} (< ${MIN_SAMPLE}). Percentiles are directional only.`);
+        }
+    }
+    return toolResponseText(wrapResult({
+        primary: result,
+        source: "spans",
+        warnings,
+        caveats,
+    }));
+}
+//# sourceMappingURL=get-latency-stats.js.map

package/dist/tools/get-latency-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-latency-stats.js","sourceRoot":"","sources":["../../src/tools/get-latency-stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOjE,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAiB,EACjB,MAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;KACzC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa;QACxB,8EAA8E;QAC9E,2FAA2F;KAC5F,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CACX,yBAAyB,MAAM,CAAC,SAAS,kBAAkB,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,CAC1F,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,KAAK,GAAG,UAAU,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CACX,iBAAiB,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,KAAK,OAAO,UAAU,sCAAsC,CACrH,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"}