@inferevents/mcp 0.5.3 → 1.0.2

package/dist/server.js

@@ -1,20 +1,27 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-// Skills are separate (@inferevents/skills). MCP server = tools only.
 import { ApiClient, ApiError } from "./api-client.js";
 import { loadConfig } from "./config.js";
-import { getEventCountsSchema, handleGetEventCounts, } from "./tools/get-event-counts.js";
-import { getRetentionSchema, handleGetRetention, } from "./tools/get-retention.js";
-import { getUserJourneySchema, handleGetUserJourney, } from "./tools/get-user-journey.js";
-import { getTopEventsSchema, handleGetTopEvents, } from "./tools/get-top-events.js";
-import { getInsightsSchema, handleGetInsights, } from "./tools/get-insights.js";
-import { getOntologySchema, handleGetOntology, } from "./tools/get-ontology.js";
-import { updateOntologySchema, handleUpdateOntology, } from "./tools/update-ontology.js";
-import { annotateThreadSchema, handleAnnotateThread, } from "./tools/annotate-thread.js";
-import { switchProjectSchema, handleSwitchProject, } from "./tools/switch-project.js";
-import { createProjectSchema, handleCreateProject, } from "./tools/create-project.js";
-import { getProjectSummarySchema, handleGetProjectSummary, } from "./tools/get-project-summary.js";
+// Active tool schemas
+import { listSpansInputSchema, getTraceInputSchema, getSpanInputSchema, getLatencyStatsInputSchema, getTokenUsageInputSchema, getCostStatsInputSchema, getErrorSpansInputSchema, annotateSpanInputSchema, annotateTraceInputSchema, } from "./tools/schemas.js";
+// Active tool handlers
+import { handleListSpans } from "./tools/list-spans.js";
+import { handleGetTrace } from "./tools/get-trace.js";
+import { handleGetSpan } from "./tools/get-span.js";
+import { handleGetLatencyStats } from "./tools/get-latency-stats.js";
+import { handleGetTokenUsage } from "./tools/get-token-usage.js";
+import { handleGetCostStats } from "./tools/get-cost-stats.js";
+import { handleGetErrorSpans } from "./tools/get-error-spans.js";
+import { handleAnnotateSpan } from "./tools/annotate-span.js";
+import { handleAnnotateTrace } from "./tools/annotate-trace.js";
+// Adapted tools (kept)
+import { getInsightsSchema, handleGetInsights } from "./tools/get-insights.js";
+import { getProjectSummarySchema, handleGetProjectSummary } from "./tools/get-project-summary.js";
+// Config helpers (kept)
+import { createProjectSchema, handleCreateProject } from "./tools/create-project.js";
+import { switchProjectSchema, handleSwitchProject } from "./tools/switch-project.js";
+// Deprecation shims (7)
+import { RETIRED_TOOL_SHIMS } from "./tools/deprecated-tools.js";
 export function createServer(config) {
-    // Re-reads config from disk on each call so switch_project takes effect immediately
     async function getClient() {
         try {
             const freshConfig = await loadConfig();
@@ -25,188 +32,85 @@ export function createServer(config) {
         }
     }
     const server = new McpServer({
-        name: "infer-analytics",
-        version: "0.1.0",
+        name: "infer-llm-obs",
+        version: "1.0.0",
     });
-    // Skills are now in a separate package (@inferevents/skills)
-    // installed via: npx skills add infer-events/skills
-    // The MCP server only provides tools, not skill resources.
-    // --- Tools ---
-    server.tool("get_event_counts", "Count events over a time range, optionally grouped by a property. " +
-        "Use this for questions like 'how many signups this week', " +
-        "'page views by country last 30 days', or 'purchase count trend'.", getEventCountsSchema, async (params) => {
-        try {
-            const text = await handleGetEventCounts(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get_retention", "Cohort-based retention analysis. Shows what percentage of users who performed " +
-        "a start event came back to perform a return event. " +
-        "Use for questions like 'what is our week-over-week retention', " +
-        "'do users come back after signing up', or 'retention by monthly cohort'.", getRetentionSchema, async (params) => {
-        try {
-            const text = await handleGetRetention(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get_user_journey", "Get the ordered sequence of events for a specific user. " +
-        "Use for questions like 'what did user X do', 'show me this user's activity', " +
-        "or 'trace a user's path through the app'. " +
-        "To find user IDs: first call get_event_counts with group_by='anonymous_id' " +
-        "to list anonymous user IDs, then pass one to this tool as user_id.", getUserJourneySchema, async (params) => {
-        try {
-            const text = await handleGetUserJourney(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get_top_events", "List the most frequent events in a time range with counts and unique users. " +
-        "Use for questions like 'what events are being tracked', 'what are users doing', " +
-        "'show me all event types', or 'what's the most common action'.", getTopEventsSchema, async (params) => {
-        try {
-            const text = await handleGetTopEvents(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get_insights", "Get automatically detected anomalies and notable patterns. " +
-        "Call get_project_summary first for full context, then call this for specific alerts. " +
-        "Returns pre-computed insights like volume drops, error spikes, milestones, " +
-        "and new events with thread context. Insights are auto-detected hourly — no query needed.", getInsightsSchema, async (params) => {
-        try {
-            const text = await handleGetInsights(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get_ontology", "View the event ontology — how events are classified into product categories " +
-        "(activation, engagement, monetization, referral, noise) and funnel stages. " +
-        "Use this to understand what events mean in the context of the product. " +
-        "If empty, suggest classifying events with update_ontology.", getOntologySchema, async (params) => {
-        try {
-            const text = await handleGetOntology(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("update_ontology", "Classify events into product categories and funnel stages. " +
-        "Use 'proposed' status when suggesting to the developer for confirmation, " +
-        "'confirmed' when the developer has agreed. " +
-        "Categories: activation (first value moment), engagement (ongoing usage), " +
-        "monetization (revenue), referral (invites/shares), noise (high volume, low signal). " +
-        "SDK-declared categories are automatically confirmed.", updateOntologySchema, async (params) => {
-        try {
-            const text = await handleUpdateOntology(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("annotate_thread", "REQUIRED after investigating any insight from get_insights. " +
-        "Records your finding (root cause, contributing factors, resolution) into the thread. " +
-        "This is what makes Infer compound — your annotation appears in every future session's " +
-        "briefing and project summary. The thread_id and exact call are shown in get_insights output. " +
-        "Skip only if the thread already has an annotation covering your finding.", annotateThreadSchema, async (params) => {
-        try {
-            const text = await handleAnnotateThread(await getClient(), params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("switch_project", "Switch between Infer projects or list all configured projects. " +
-        "Use when the user says 'switch to project X' or 'list my projects' or " +
-        "wants to query data from a different project.", switchProjectSchema, async (params) => {
-        try {
-            const text = await handleSwitchProject(params);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
-    server.tool("create_project", "Create a new Infer project from the CLI. " +
-        "Use when the user wants to add analytics to a new codebase. " +
-        "Requires an active session from prior signup.", createProjectSchema, async (params) => {
-        try {
-            const freshConfig = await loadConfig().catch(() => config);
-            const text = await handleCreateProject(params, freshConfig.endpoint);
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
+    // ─── Span inspection (3 tools) ───────────────────────────────────────────
+    server.tool("list_spans", "List LLM calls (spans) captured by the Infer gateway. Filter by model, user, session, " +
+        "tags, time window, duration, or HTTP status. Returns a paginated list with a cursor " +
+        "for continuation. Use this to explore recent activity or find spans matching a specific filter.", listSpansInputSchema, async (params) => wrapMcp(async () => handleListSpans(await getClient(), params)));
+    server.tool("get_trace", "Return all spans sharing a trace_id as a hierarchical tree (walks parent_span_id edges). " +
+        "Use this when an agent made multiple LLM calls in one turn and you want to see the whole turn — " +
+        "e.g., a multi-iteration agent that called a tool, saw the result, and called the model again.", getTraceInputSchema, async (params) => wrapMcp(async () => handleGetTrace(await getClient(), params)));
+    server.tool("get_span", "Return full detail for a single span — messages, tool calls, attributes, annotations. " +
+        "Use this after list_spans or get_trace to drill into a specific call.", getSpanInputSchema, async (params) => wrapMcp(async () => handleGetSpan(await getClient(), params)));
+    // ─── Aggregations (4 tools) ──────────────────────────────────────────────
+    server.tool("get_latency_stats", "p50/p95/p99 latency by dimension (model, user, session, or feature) over a time window. " +
+        "Groups with fewer than 10 samples are surfaced as warnings. Use this to diagnose slowness or " +
+        "compare models.", getLatencyStatsInputSchema, async (params) => wrapMcp(async () => handleGetLatencyStats(await getClient(), params)));
+    server.tool("get_token_usage", "Sum input/output tokens by dimension (model, user, session, feature) over a time window. " +
+        "Warns when any rows used tiktoken-estimated counts rather than upstream-authoritative counts.", getTokenUsageInputSchema, async (params) => wrapMcp(async () => handleGetTokenUsage(await getClient(), params)));
+    server.tool("get_cost_stats", "Compute cost (USD) by dimension at query time from the @inferevents/shared pricing table. " +
+        "Models missing from the pricing table surface as warnings with their (provider, model) name; their " +
+        "cost is reported as null rather than silently zero. Ollama models return $0 legitimately.", getCostStatsInputSchema, async (params) => wrapMcp(async () => handleGetCostStats(await getClient(), params)));
+    server.tool("get_error_spans", "List recent failures (status_code >= 400 OR stream_truncated) with aggregated error_type counts. " +
+        "Warns on retry storms (attempt_count > 1). Use this to diagnose an error spike.", getErrorSpansInputSchema, async (params) => wrapMcp(async () => handleGetErrorSpans(await getClient(), params)));
+    // ─── Annotations (2 tools) ───────────────────────────────────────────────
+    server.tool("annotate_span", "Attach a finding to a specific span. Use after diagnosing a single LLM call — e.g., " +
+        "'root cause: prompt was 3x longer than baseline'. The annotation surfaces in future get_span calls.", annotateSpanInputSchema, async (params) => wrapMcp(async () => handleAnnotateSpan(await getClient(), params)));
+    server.tool("annotate_trace", "Attach a finding to a whole trace (multi-span agent turn). Use after diagnosing a multi-iteration " +
+        "turn — e.g., 'upstream timeout triggered 3 retries, last attempt succeeded'. Surfaces in future " +
+        "get_trace calls and in the insight-threads briefing.", annotateTraceInputSchema, async (params) => wrapMcp(async () => handleAnnotateTrace(await getClient(), params)));
+    // ─── Insights + summary (2 adapted tools) ────────────────────────────────
+    server.tool("get_insights", "Auto-detected anomalies and notable patterns — latency regressions, error-rate spikes, " +
+        "token-consumption outliers, new models, new error types. Call get_project_summary first for full " +
+        "context, then this for specific alerts. Each insight includes a correlation_hint for git-log lookups.", getInsightsSchema, async (params) => wrapMcp(async () => handleGetInsights(await getClient(), params)));
+    server.tool("get_project_summary", "Project-level overview — model distribution, weekly spend, error rate, active anomaly threads. " +
+        "Compiled hourly. Call this first when starting an investigation.", getProjectSummarySchema, async () => wrapMcp(async () => handleGetProjectSummary(await getClient())));
+    // ─── Config helpers (2 tools) ────────────────────────────────────────────
+    server.tool("switch_project", "Switch between Infer projects or list available ones. Operates on the local config file, " +
+        "not the server.", switchProjectSchema, async (params) => wrapMcp(async () => handleSwitchProject(params)));
+    server.tool("create_project", "Create a new Infer project from the CLI. Requires an active auth session from `npx @inferevents/skills run infer-setup`.", createProjectSchema, async (params) => wrapMcp(async () => {
+        const freshConfig = await loadConfig().catch(() => config);
+        return handleCreateProject(params, freshConfig.endpoint);
+    }));
+    // ─── Deprecation shims (7 — retire on 2026-06-17) ────────────────────────
+    for (const [toolName, entry] of Object.entries(RETIRED_TOOL_SHIMS)) {
+        server.tool(toolName, entry.description, {}, async () => {
+            const out = await entry.handler();
             return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
+                content: out.content.map((c) => ({ type: "text", text: c.text })),
+                isError: out.isError,
             };
-        }
-    });
-    server.tool("get_project_summary", "Get a compiled overview of the project — health score, key metrics, event catalog, " +
-        "funnel performance, and active insight threads. This is the analytics wiki — " +
-        "always up to date, compiled hourly. " +
-        "Call this first for full context, then get_insights for specific alerts.", getProjectSummarySchema, async () => {
-        try {
-            const text = await handleGetProjectSummary(await getClient());
-            return { content: [{ type: "text", text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: formatError(error) }],
-                isError: true,
-            };
-        }
-    });
+        });
+    }
     return server;
 }
+/**
+ * Wrap an async tool handler so a thrown error becomes a structured
+ * `{ content, isError: true }` MCP response rather than a transport
+ * fault. All active tools return a `string` (JSON-in-text) from their
+ * handler; we forward that as `content[0].text`.
+ */
+async function wrapMcp(run) {
+    try {
+        const text = await run();
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: formatError(error) }],
+            isError: true,
+        };
+    }
+}
 function formatError(error) {
     if (error instanceof ApiError) {
-        return `API Error: ${error.message}`;
+        return JSON.stringify({ error: "api_error", status_code: error.statusCode, message: error.message }, null, 2);
     }
     if (error instanceof Error) {
-        return `Error: ${error.message}`;
+        return JSON.stringify({ error: "internal_error", message: error.message }, null, 2);
     }
-    return `Unknown error occurred`;
+    return JSON.stringify({ error: "unknown_error" }, null, 2);
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,oFAAoF;IACpF,KAAK,UAAU,SAAS;QACtB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,UAAU,EAAE,CAAC;YACvC,OAAO,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,6DAA6D;IAC7D,oDAAoD;IACpD,2DAA2D;IAE3D,gBAAgB;IAEhB,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,oEAAoE;QAClE,4DAA4D;QAC5D,kEAAkE,EACpE,oBAAoB,EACpB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,gFAAgF;QAC9E,qDAAqD;QACrD,iEAAiE;QACjE,0EAA0E,EAC5E,kBAAkB,EAClB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,0DAA0D;QACxD,+EAA+E;QAC/E,4CAA4C;QAC5C,6EAA6E;QAC7E,oEAAoE,EACtE,oBAAoB,EACpB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,8EAA8E;QAC5E,kFAAkF;QAClF,gEAAgE,EAClE,kBAAkB,EAClB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,6DAA6D;QAC3D,uFAAuF;QACvF,6EAA6E;QAC7E,0FAA0F,EAC5F,iBAAiB,EACjB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,8EAA8E;QAC5E,6EAA6E;QAC7E,yEAAyE;QACzE,4DAA4D,EAC9D,iBAAiB,EACjB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,6DAA6D;QAC3D,2EAA2E;QAC3E,6CAA6C;QAC7C,2EAA2E;QAC3E,sFAAsF;QACtF,sDAAsD,EACxD,oBAAoB,EACpB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAoD,CAAC,CAAC;YACjH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,8DAA8D;QAC5D,uFAAuF;QACvF,wFAAwF;QACxF,+FAA+F;QAC/F,0EAA0E,EAC5E,oBAAoB,EACpB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;YACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,iEAAiE;QAC/D,wEAAwE;QACxE,+CAA+C,EACjD,mBAAmB,EACnB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,2CAA2C;QACzC,8DAA8D;QAC9D,+CAA+C,EACjD,mBAAmB,EACnB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,qFAAqF;QACnF,+EAA+E;QAC/E,sCAAsC;QACtC,0EAA0E,EAC5E,uBAAuB,EACvB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tool-result.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared result envelope for every active MCP tool. Spec §7.2.
+ *
+ * Rules:
+ * - `primary` is the tool-specific payload — each tool defines its own type.
+ * - `warnings[]` flag data-quality concerns the agent should surface (small
+ *   sample sizes, estimated tokens, missing pricing entries, truncated streams).
+ * - `caveats[]` note methodology (p95 computed on N=…; 7-day baseline, etc).
+ * - `as_of` is the wall-clock of this query — stable anchor for agent recall.
+ * - `source` tells the agent where the data came from so it can reason about
+ *   freshness and trustworthiness.
+ */
+export type ToolResultSource = "spans" | "insights" | "annotations" | "project_summary" | "config" | "pricing_table";
+export interface ToolResult<T> {
+    primary: T;
+    warnings: string[];
+    caveats: string[];
+    as_of: string;
+    source: ToolResultSource;
+}
+export declare function wrapResult<T>(input: {
+    primary: T;
+    source: ToolResultSource;
+    warnings?: string[];
+    caveats?: string[];
+    asOf?: string;
+}): ToolResult<T>;
+/**
+ * Serialize a result envelope as a single JSON-in-text MCP response body.
+ * The MCP SDK's `content[].text` is the user-visible channel; embedding
+ * JSON lets the agent parse structured fields deterministically.
+ */
+export declare function toolResponseText<T>(envelope: ToolResult<T>): string;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../src/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,QAAQ,GACR,eAAe,CAAC;AAEpB,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,CAAC,CAAC,CAAC,CAQhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAEnE"}

package/dist/tool-result.js

@@ -0,0 +1,30 @@
+/**
+ * Shared result envelope for every active MCP tool. Spec §7.2.
+ *
+ * Rules:
+ * - `primary` is the tool-specific payload — each tool defines its own type.
+ * - `warnings[]` flag data-quality concerns the agent should surface (small
+ *   sample sizes, estimated tokens, missing pricing entries, truncated streams).
+ * - `caveats[]` note methodology (p95 computed on N=…; 7-day baseline, etc).
+ * - `as_of` is the wall-clock of this query — stable anchor for agent recall.
+ * - `source` tells the agent where the data came from so it can reason about
+ *   freshness and trustworthiness.
+ */
+export function wrapResult(input) {
+    return {
+        primary: input.primary,
+        warnings: input.warnings ? [...input.warnings] : [],
+        caveats: input.caveats ? [...input.caveats] : [],
+        as_of: input.asOf ?? new Date().toISOString(),
+        source: input.source,
+    };
+}
+/**
+ * Serialize a result envelope as a single JSON-in-text MCP response body.
+ * The MCP SDK's `content[].text` is the user-visible channel; embedding
+ * JSON lets the agent parse structured fields deterministically.
+ */
+export function toolResponseText(envelope) {
+    return JSON.stringify(envelope, null, 2);
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../src/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,UAAU,UAAU,CAAI,KAM7B;IACC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACnD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;QAChD,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAI,QAAuB;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-span.d.ts","sourceRoot":"","sources":["../../src/tools/annotate-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/tools/annotate-span.js

@@ -0,0 +1,16 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleAnnotateSpan(client, params) {
+    const result = await client.annotateSpan(params);
+    return toolResponseText(wrapResult({
+        primary: {
+            annotation_id: result.annotation_id,
+            span_id: params.span_id,
+            content: params.content,
+        },
+        source: "annotations",
+        caveats: [
+            `Annotation is scoped to the authenticated project. Future calls to get_span("${params.span_id}") will surface it.`,
+        ],
+    }));
+}
+//# sourceMappingURL=annotate-span.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-span.js","sourceRoot":"","sources":["../../src/tools/annotate-span.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOjE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,MAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;QACD,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,gFAAgF,MAAM,CAAC,OAAO,qBAAqB;SACpH;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-trace.d.ts","sourceRoot":"","sources":["../../src/tools/annotate-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/tools/annotate-trace.js

@@ -0,0 +1,16 @@
+import { wrapResult, toolResponseText } from "../tool-result.js";
+export async function handleAnnotateTrace(client, params) {
+    const result = await client.annotateTrace(params);
+    return toolResponseText(wrapResult({
+        primary: {
+            annotation_id: result.annotation_id,
+            trace_id: params.trace_id,
+            content: params.content,
+        },
+        source: "annotations",
+        caveats: [
+            "Trace-level annotation — applies to the whole multi-span turn, not a single span.",
+        ],
+    }));
+}
+//# sourceMappingURL=annotate-trace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-trace.js","sourceRoot":"","sources":["../../src/tools/annotate-trace.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;IAClD,OAAO,gBAAgB,CACrB,UAAU,CAAC;QACT,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;QACD,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,mFAAmF;SACpF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../src/tools/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;CAQ/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAoDjB"}
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../src/tools/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;CAQ/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA0FjB"}

package/dist/tools/create-project.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { addProject, readConfigFile, getSession } from "../config.js";
+import { wrapResult, toolResponseText } from "../tool-result.js";
 export const createProjectSchema = {
     project_name: z
         .string()
@@ -17,7 +18,14 @@ export async function handleCreateProject(params, endpoint) {
         session = await getSession();
     }
     if (!session) {
-        return "No session found. Sign up at https://infer.events/signup first, then run /infer-setup.";
+        return toolResponseText(wrapResult({
+            primary: {
+                status: "error",
+                error: "no_session",
+                message: "No session found. Sign up at https://infer.events/signup first, then run /infer-setup.",
+            },
+            source: "config",
+        }));
     }
     const baseUrl = config.endpoint ?? endpoint;
     // Call the API to create the project
@@ -28,13 +36,21 @@ export async function handleCreateProject(params, endpoint) {
     });
     if (!response.ok) {
         const body = await response.json().catch(() => ({}));
-        return `Failed to create project: ${body.error ?? response.statusText}`;
+        return toolResponseText(wrapResult({
+            primary: {
+                status: "error",
+                error: "create_failed",
+                status_code: response.status,
+                message: `Failed to create project: ${body.error ?? response.statusText}`,
+            },
+            source: "config",
+        }));
     }
     const result = await response.json();
     // Save to config
     const slug = params.project_name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
     await addProject(slug, result.read_key, result.project_id, result.write_key, true);
-    const lines = [
+    const setupInstructions = [
         `Project "${result.project_name}" created and set as active.`,
         "",
         `Project ID:  ${result.project_id}`,
@@ -43,9 +59,25 @@ export async function handleCreateProject(params, endpoint) {
         "",
         `Saved to ~/.infer/config.json as "${slug}" (now active).`,
         "",
-        "Next: Install the SDK in your project with npm install @inferevents/sdk",
-        `Then init with: init({ projectId: "${result.write_key}" })`,
-    ];
-    return lines.join("\n");
+        "Next: route your LLM traffic through the Infer gateway using the write key " +
+            "(pk_write_*) as your provider's API key. The read key (pk_read_*) is for MCP access.",
+    ].join("\n");
+    return toolResponseText(wrapResult({
+        primary: {
+            status: "created",
+            project_id: result.project_id,
+            project_name: result.project_name,
+            project_slug: slug,
+            read_key: result.read_key,
+            write_key: result.write_key,
+            endpoint: result.endpoint,
+            active: true,
+            setup_instructions_text: setupInstructions,
+        },
+        source: "config",
+        caveats: [
+            "Save the read_key (pk_read_*) for MCP access and the write_key (pk_write_*) for gateway BYOK calls. These are shown ONCE.",
+        ],
+    }));
 }
 //# sourceMappingURL=create-project.js.map

package/dist/tools/create-project.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../src/tools/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sGAAsG,CAAC;CACpH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAkD,EAClD,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IAEtC,+DAA+D;IAC/D,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,wFAAwF,CAAC;IAClG,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAE5C,qCAAqC;IACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,yBAAyB,EAAE;QAChE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KACrE,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAA4B,CAAC;QAChF,OAAO,6BAA6B,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAMjC,CAAC;IAEF,iBAAiB;IACjB,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC3E,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEnF,MAAM,KAAK,GAAG;QACZ,YAAY,MAAM,CAAC,YAAY,8BAA8B;QAC7D,EAAE;QACF,gBAAgB,MAAM,CAAC,UAAU,EAAE;QACnC,gBAAgB,MAAM,CAAC,SAAS,EAAE;QAClC,gBAAgB,MAAM,CAAC,QAAQ,EAAE;QACjC,EAAE;QACF,qCAAqC,IAAI,iBAAiB;QAC1D,EAAE;QACF,yEAAyE;QACzE,sCAAsC,MAAM,CAAC,SAAS,MAAM;KAC7D,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../src/tools/create-project.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+import { type ToolHandlerResponse } from "./deprecated.js";
+interface RetiredEntry {
+    description: string;
+    handler: () => Promise<ToolHandlerResponse>;
+}
+/**
+ * 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 declare const RETIRED_TOOL_SHIMS: Record<string, RetiredEntry>;
+export {};
+//# sourceMappingURL=deprecated-tools.d.ts.map