@uptimizr/mcp 0.1.1 → 0.2.1

package/AGENTS.md

@@ -10,6 +10,9 @@ lets an agent query a consumer's **own** 3D analytics in natural language. Each
 documented collector read endpoint; the server is a thin wrapper that holds no business logic and
 performs `GET` requests only (ADR 0005, ADR 0017).
 
+It connects **only to the collector's HTTP query API** (never to the database directly), so the
+collector remains the single gateway that enforces auth, per-project scoping, and privacy.
+
 ## Run
 
 ```bash
@@ -29,13 +32,16 @@ UPTIMIZR_COLLECTOR_URL="https://collect.example.com" UPTIMIZR_API_KEY="utk_…"
   tools here. No data leaves the consumer's infrastructure (ADR 0003).
 - The server talks only to the configured collector with the consumer's `x-api-key`; never hardcode
   or log credentials.
-- Keep it a thin wrapper: a new tool = a new entry in the `readTools` registry mapping to a
-  documented query endpoint. Do not add aggregation/business logic — that lives in the collector.
+- Keep it a thin wrapper: a new tool = a new entry in the `readTools` catalog (defined in
+  `@uptimizr/agent-core`) mapping to a documented query endpoint. Do not add aggregation/business
+  logic — that lives in the collector.
 - Tool definitions are pure (`buildRequest`) and must stay unit-testable without a live collector.
 
 ## Programmatic API
 
-`readMcpConfig()`, `createCollectorClient(config)`, `createMcpServer(client)`, `readTools`.
+`readMcpConfig()`, `createMcpServer(client)`, and the shared building blocks re-exported from
+[`@uptimizr/agent-core`](https://www.npmjs.com/package/@uptimizr/agent-core):
+`createCollectorClient(config)` and `readTools`.
 
 ## More
 

package/README.md

@@ -10,6 +10,16 @@ The server is a thin wrapper: each tool maps one-to-one to a documented collecto
 performs `GET` requests only — there are **no ingestion, mutation, or raw per-session event
 tools**.
 
+## How it connects
+
+The server talks **only to your collector's HTTP query API** — it never opens the database
+(DuckDB/ClickHouse/Postgres) directly. The collector stays the single gateway to your data, so an
+agent gets exactly the auth, project-scoping, and privacy guarantees a dashboard user does:
+
+```text
+AI agent ──stdio──▶ @uptimizr/mcp ──HTTPS GET + x-api-key──▶ collector ──▶ store
+```
+
 ## Run
 
 ```bash
@@ -43,26 +53,63 @@ config:
 }
 ```
 
+For **GitHub Copilot CLI**, put the same entry in `~/.copilot/mcp-config.json` with
+`"type": "local"` and `"tools": ["*"]`, then restart the CLI so it loads the tools:
+
+```json
+{
+  "mcpServers": {
+    "uptimizr": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "@uptimizr/mcp"],
+      "env": {
+        "UPTIMIZR_COLLECTOR_URL": "http://localhost:4318",
+        "UPTIMIZR_API_KEY": "utk_…"
+      },
+      "tools": ["*"]
+    }
+  }
+}
+```
+
 ## Tools
 
-All tools accept an optional time range (`since` / `until`, epoch ms) and the filters the
-underlying endpoint supports (`scene`, `session`, `source`, `bins`, `cellSize`, `limit`, …).
-
-| Tool                   | Endpoint                            | Returns                                          |
-| ---------------------- | ----------------------------------- | ------------------------------------------------ |
-| `list_sessions`        | `/api/v1/sessions`                  | Recent sessions.                                 |
-| `pointer_heatmap`      | `/api/v1/heatmaps/pointer`          | 2D pointer heatmap bins.                         |
-| `world_heatmap`        | `/api/v1/heatmaps/world`            | 3D world-space pointer voxels.                   |
-| `camera_heatmap`       | `/api/v1/heatmaps/camera`           | View-direction (spherical) bins.                 |
-| `click_rays`           | `/api/v1/heatmaps/click-rays`       | View-gated click rays.                           |
-| `flow_links`           | `/api/v1/heatmaps/flow`             | Gaze→mesh flow links.                            |
-| `top_meshes`           | `/api/v1/meshes/top`                | Most-interacted meshes.                          |
-| `perf_summary`         | `/api/v1/perf`                      | FPS summary (avg/min/p50).                       |
-| `list_scenes`          | `/api/v1/scenes`                    | Active scenes.                                   |
-| `timeseries`           | `/api/v1/timeseries`                | Event-volume buckets over time.                  |
-| `event_counts`         | `/api/v1/event-counts`              | Per-event-type counts.                           |
-| `session_meta`         | `/api/v1/sessions/:id/meta`         | Coarse session descriptor (no raw event stream). |
-| `scene_representation` | `/api/v1/scenes/:id/representation` | Registered proxy geometry, if any.               |
+Most aggregate tools accept an optional time range (`since` / `until`, epoch ms) and the filters
+the underlying endpoint supports (`scene`, `session`, `source`, `bins`, `cellSize`, `interval`,
+`type`, `limit`, …). `session_meta` and `scene_representation` take their required IDs only.
+
+| Tool                   | Endpoint                            | Returns                                             |
+| ---------------------- | ----------------------------------- | --------------------------------------------------- |
+| `list_sessions`        | `/api/v1/sessions`                  | Recent sessions.                                    |
+| `pointer_heatmap`      | `/api/v1/heatmaps/pointer`          | 2D pointer heatmap bins.                            |
+| `world_heatmap`        | `/api/v1/heatmaps/world`            | 3D world-space pointer voxels.                      |
+| `camera_heatmap`       | `/api/v1/heatmaps/camera`           | View-direction (spherical) bins.                    |
+| `click_rays`           | `/api/v1/heatmaps/click-rays`       | View-gated click rays.                              |
+| `flow_links`           | `/api/v1/heatmaps/flow`             | Gaze→mesh flow links.                               |
+| `top_meshes`           | `/api/v1/meshes/top`                | Most-interacted meshes.                             |
+| `perf_summary`         | `/api/v1/perf`                      | FPS summary (avg/min/p50).                          |
+| `list_scenes`          | `/api/v1/scenes`                    | Active scenes.                                      |
+| `timeseries`           | `/api/v1/timeseries`                | Event-volume buckets over time.                     |
+| `event_counts`         | `/api/v1/event-counts`              | Per-event-type counts.                              |
+| `session_meta`         | `/api/v1/sessions/:id/meta`         | Coarse session descriptor (no raw event stream).    |
+| `scene_representation` | `/api/v1/scenes/:id/representation` | Registered proxy geometry, if any.                  |
+| `funnel`               | `/api/v1/funnel`                    | Ordered conversion funnel (`steps` JSON, ADR 0038). |
+| `aggregate_paths`      | `/api/v1/paths`                     | Crowd-level desire-line routes (ADR 0037).          |
+| `rendering_technology` | `/api/v1/rendering-technology`      | WebGPU/WebGL2 + shading-language mix (ADR 0046).    |
+| `xr_rotation`          | `/api/v1/xr/rotation`               | XR head-rotation rate (ADR 0048).                   |
+| `xr_sources`           | `/api/v1/xr/sources`                | XR input-source usage (ADR 0048).                   |
+| `xr_abandonment`       | `/api/v1/xr/abandonment`            | XR session abandonment (ADR 0048).                  |
+| `xr_locomotion`        | `/api/v1/xr/locomotion`             | XR locomotion & comfort (ADR 0048).                 |
+
+## Resources & prompts
+
+The server also exposes read-only **resources** for self-discovery — `uptimizr://capabilities`
+(a machine-readable descriptor of event types, the tool catalog, and parameter semantics) and
+`uptimizr://scenes` (live scene ids) — and curated **prompts** (`weekly_scene_health`,
+`attention_hotspots`, `xr_comfort_review`) that drive the tools above. A remote Streamable HTTP
+transport is a deferred, auth-gated follow-up (ADR 0050 §7). See the
+[MCP guide](https://uptimizr.com/docs/guides/mcp/) for details.
 
 ## Programmatic use
 
@@ -75,6 +122,13 @@ const server = createMcpServer(client);
 await server.connect(new StdioServerTransport());
 ```
 
+The package also exports `readTools`, `CollectorError`, `version`, and the related public types.
+The read-only tool catalog (`readTools`) and the `GET`-only collector client are defined in the
+framework-agnostic [`@uptimizr/agent-core`](../agent-core/README.md) package and re-exported here,
+so the agent tool surface is defined once and shared across the MCP server, the dashboard assistant,
+and the demo assistant (ADR 0050). Building a non-MCP agent? Depend on `@uptimizr/agent-core`
+directly — it also ships a headless provider-adapter interface and tool-calling loop.
+
 ## Develop
 
 ```bash

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createCollectorClient } from "./client.js";
+import { createCollectorClient } from "@uptimizr/agent-core";
 import { readMcpConfig } from "./config.js";
 import { createMcpServer } from "./server.js";
 /**

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,45 @@
+import { type EventType } from "@uptimizr/schema";
+/**
+ * One tool the server exposes, described for self-discovery: its name, a human
+ * title, what it returns, and the parameter names it accepts. Sourced directly
+ * from the shared `@uptimizr/agent-core` catalog so it can never drift from the
+ * tools actually registered (ADR 0050 §7).
+ */
+export interface CapabilityToolDescriptor {
+    name: string;
+    title: string;
+    description: string;
+    params: readonly string[];
+}
+/** A parameter name and what it means, shared across tools. */
+export interface CapabilityParamDescriptor {
+    name: string;
+    description: string;
+}
+/**
+ * Machine-readable capabilities/schema descriptor an agent can read (via the
+ * `uptimizr://capabilities` resource) to learn what it can ask before guessing.
+ * It is strictly a description of the **read-only** surface — event types, the
+ * tool catalog, and parameter semantics — and never itself queries any data.
+ */
+export interface CapabilitiesDescriptor {
+    /** Wire-format version of the event schema (`@uptimizr/schema`). */
+    schemaVersion: string;
+    /** The MCP surface is read-only: aggregate queries only, no raw events/PII. */
+    readOnly: true;
+    /** Canonical analytics event types (the single source of truth). */
+    eventTypes: readonly EventType[];
+    /** Glossary of every query parameter the tools accept. */
+    params: readonly CapabilityParamDescriptor[];
+    /** The read-only tool catalog (each entry is one aggregate query endpoint). */
+    tools: readonly CapabilityToolDescriptor[];
+    /** Human-oriented notes about scope and discovery. */
+    notes: readonly string[];
+}
+/**
+ * Build the capabilities descriptor from the live tool catalog and the event
+ * schema. Pure and synchronous — it introspects definitions only, never the
+ * collector, so it is safe to serve as a static resource.
+ */
+export declare function buildCapabilities(): CapabilitiesDescriptor;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG/E;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IACjC,0DAA0D;IAC1D,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC7C,+EAA+E;IAC/E,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC3C,sDAAsD;IACtD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AA0BD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,sBAAsB,CA6B1D"}

package/dist/capabilities.js

@@ -0,0 +1,59 @@
+import { EVENT_TYPES, SCHEMA_VERSION } from "@uptimizr/schema";
+import { readTools } from "@uptimizr/agent-core";
+/**
+ * Semantics for every parameter used across the tool catalog. Kept in one place
+ * so a param means the same thing everywhere; {@link buildCapabilities} only
+ * surfaces the entries a tool actually uses, and a unit test asserts coverage.
+ */
+const PARAM_SEMANTICS = {
+    since: "Start of the time range, epoch milliseconds (inclusive). Omit for all-time.",
+    until: "End of the time range, epoch milliseconds (exclusive). Omit for up-to-now.",
+    bins: "Grid resolution per axis for a binned heatmap (1–500).",
+    limit: "Maximum rows to return (1–1000).",
+    scene: "Restrict to one developer-assigned scene id (see the uptimizr://scenes resource).",
+    session: "Scope the aggregate to a single session id.",
+    cellSize: "Voxel edge length in world units for a spatial (world-space) aggregate.",
+    interval: "Time-series bucket width in seconds.",
+    type: "Restrict a time series to one event type (e.g. pointer_click).",
+    source: "Input source filter: mouse, touch, stylus, pen, xr-controller, hand, gaze, transient, other.",
+    cameraMode: "Camera navigation mode: 'viewer' (orbit) or 'first-person' (walkable).",
+    rapidTurn: "Rapid-turn threshold in radians (0..π); XR view turns above this flag discomfort.",
+    steps: "Funnel steps as a JSON-encoded array of ordered step predicates (ADR 0038).",
+    sessionId: "The exact session id to describe.",
+    sceneId: "The exact scene id to fetch.",
+};
+/**
+ * Build the capabilities descriptor from the live tool catalog and the event
+ * schema. Pure and synchronous — it introspects definitions only, never the
+ * collector, so it is safe to serve as a static resource.
+ */
+export function buildCapabilities() {
+    const tools = readTools.map((tool) => ({
+        name: tool.name,
+        title: tool.title,
+        description: tool.description,
+        params: Object.keys(tool.inputSchema),
+    }));
+    const usedParams = new Set();
+    for (const tool of tools)
+        for (const p of tool.params)
+            usedParams.add(p);
+    const params = [...usedParams]
+        .sort()
+        .map((name) => ({ name, description: PARAM_SEMANTICS[name] ?? "" }));
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        readOnly: true,
+        eventTypes: EVENT_TYPES,
+        params,
+        tools,
+        notes: [
+            "This MCP surface is strictly read-only: aggregate, privacy-preserving queries only. " +
+                "There are no ingestion, mutation, or raw per-session event tools (ADR 0003 / ADR 0017).",
+            "Enumerate the concrete scene ids for the `scene` parameter with the uptimizr://scenes " +
+                "resource or the list_scenes tool; enumerate sessions with the list_sessions tool.",
+            "All time ranges use epoch-millisecond `since`/`until`. Omit both for all-time.",
+        ],
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA0CjD;;;;GAIG;AACH,MAAM,eAAe,GAAqC;IACxD,KAAK,EAAE,6EAA6E;IACpF,KAAK,EAAE,4EAA4E;IACnF,IAAI,EAAE,wDAAwD;IAC9D,KAAK,EAAE,kCAAkC;IACzC,KAAK,EAAE,mFAAmF;IAC1F,OAAO,EAAE,6CAA6C;IACtD,QAAQ,EAAE,yEAAyE;IACnF,QAAQ,EAAE,sCAAsC;IAChD,IAAI,EAAE,gEAAgE;IACtE,MAAM,EACJ,8FAA8F;IAChG,UAAU,EAAE,wEAAwE;IACpF,SAAS,EAAE,mFAAmF;IAC9F,KAAK,EAAE,6EAA6E;IACpF,SAAS,EAAE,mCAAmC;IAC9C,OAAO,EAAE,8BAA8B;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAA+B,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;KACtC,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAgC,CAAC,GAAG,UAAU,CAAC;SACxD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAEvE,OAAO;QACL,aAAa,EAAE,cAAc;QAC7B,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,WAAW;QACvB,MAAM;QACN,KAAK;QACL,KAAK,EAAE;YACL,sFAAsF;gBACpF,yFAAyF;YAC3F,wFAAwF;gBACtF,mFAAmF;YACrF,gFAAgF;SACjF;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { readMcpConfig, type McpConfig } from "./config.js";
-export { createCollectorClient, CollectorError, type CollectorClient, type QueryParams, } from "./client.js";
-export { readTools, type ReadTool, type ReadToolRequest } from "./tools.js";
+export { createCollectorClient, CollectorError, readTools, type CollectorClient, type CollectorClientConfig, type QueryParams, type ReadTool, type ReadToolRequest, } from "@uptimizr/agent-core";
 export { createMcpServer } from "./server.js";
+export { buildCapabilities, type CapabilitiesDescriptor, type CapabilityToolDescriptor, type CapabilityParamDescriptor, } from "./capabilities.js";
+export { registerResources, CAPABILITIES_URI, SCENES_URI } from "./resources.js";
+export { registerPrompts } from "./prompts.js";
 export { version } from "./version.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export { readMcpConfig } from "./config.js";
-export { createCollectorClient, CollectorError, } from "./client.js";
-export { readTools } from "./tools.js";
+export { createCollectorClient, CollectorError, readTools, } from "@uptimizr/agent-core";
 export { createMcpServer } from "./server.js";
+export { buildCapabilities, } from "./capabilities.js";
+export { registerResources, CAPABILITIES_URI, SCENES_URI } from "./resources.js";
+export { registerPrompts } from "./prompts.js";
 export { version } from "./version.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAuC,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,SAAS,GAMV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register the curated prompt templates on the server. */
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiGvD"}

package/dist/prompts.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+/**
+ * Curated prompt templates for common 3D-analytics investigations (ADR 0050 §7).
+ * Each renders a single user message that steers the agent to call the existing
+ * read-only tools in a sensible order — no data is fetched here; the agent runs
+ * the tools. Templates are intentionally tool-agnostic about exact arguments so
+ * the agent can adapt (e.g. resolve the current epoch-ms range itself).
+ */
+const sceneArg = z
+    .string()
+    .optional()
+    .describe("Optional scene id to scope the analysis to (see the uptimizr://scenes resource).");
+const requiredSceneArg = z
+    .string()
+    .describe("The scene id to analyse (see the uptimizr://scenes resource).");
+const forScene = (scene) => scene ? `scene "${scene}"` : "the project (all scenes)";
+/** Register the curated prompt templates on the server. */
+export function registerPrompts(server) {
+    server.registerPrompt("weekly_scene_health", {
+        title: "Weekly scene health",
+        description: "A weekly health check for a scene (or the whole project): traffic, event mix, " +
+            "performance, and the most-interacted meshes.",
+        argsSchema: { scene: sceneArg },
+    }, ({ scene }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Give me a weekly health report for ${forScene(scene)} covering the last 7 days.\n\n` +
+                        "Use these read-only tools and summarise the findings:\n" +
+                        "- `event_counts` for the per-event-type mix" +
+                        (scene ? ` (scene="${scene}")` : "") +
+                        ".\n" +
+                        "- `timeseries` (interval ~86400s) to show the day-by-day event volume and average FPS trend.\n" +
+                        "- `perf_summary` for avg/min/p50 FPS.\n" +
+                        "- `top_meshes` for the most-interacted meshes.\n" +
+                        "- `list_sessions` for how many sessions were recorded.\n\n" +
+                        "Call out anything unusual (traffic spikes/drops, FPS regressions, error events) and " +
+                        "end with 2–3 concrete recommendations.",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("attention_hotspots", {
+        title: "Attention hot-spots for a scene",
+        description: "Find where visitors look and click in a scene: view-direction concentration, " +
+            "gaze→mesh flow, and the objects that draw the most interaction.",
+        argsSchema: { scene: requiredSceneArg },
+    }, ({ scene }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Where does attention concentrate in scene "${scene}"?\n\n` +
+                        'Use these read-only tools (all scoped with scene="' +
+                        scene +
+                        '") and synthesise the result:\n' +
+                        "- `camera_heatmap` for the view-direction distribution (what people look at).\n" +
+                        "- `flow_links` for how gaze flows into clicked meshes.\n" +
+                        "- `click_rays` for view-gated clicks per voxel/mesh.\n" +
+                        "- `top_meshes` for the most-interacted objects.\n\n" +
+                        "Describe the main hot-spots, any ignored/cold areas, and what that implies for the " +
+                        "scene's layout or call-to-action placement.",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("xr_comfort_review", {
+        title: "XR comfort & drop-off review",
+        description: "Review VR/AR comfort signals for a scene (or the whole project): rapid head rotation, " +
+            "locomotion style, session abandonment, and input-source mix.",
+        argsSchema: { scene: sceneArg },
+    }, ({ scene }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Review XR/immersive comfort and drop-off for ${forScene(scene)}.\n\n` +
+                        "Use these read-only tools" +
+                        (scene ? ` (scene="${scene}")` : "") +
+                        " and correlate the signals:\n" +
+                        "- `xr_rotation` for rapid head/view turns (a motion-sickness proxy).\n" +
+                        "- `xr_locomotion` for the fly/navigate/teleport mix and session span.\n" +
+                        "- `xr_abandonment` for short XR sessions that signal headset drop-off.\n" +
+                        "- `xr_sources` for the hand vs. controller vs. gaze input split.\n\n" +
+                        "Flag likely-uncomfortable patterns (heavy rapid rotation or continuous locomotion " +
+                        "paired with early exits) and suggest comfort mitigations.",
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,kFAAkF,CAAC,CAAC;AAEhG,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,QAAQ,CAAC,+DAA+D,CAAC,CAAC;AAE7E,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAU,EAAE,CACrD,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,gFAAgF;YAChF,8CAA8C;QAChD,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;KAChC,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,sCAAsC,QAAQ,CAAC,KAAK,CAAC,gCAAgC;wBACrF,yDAAyD;wBACzD,6CAA6C;wBAC7C,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpC,KAAK;wBACL,gGAAgG;wBAChG,yCAAyC;wBACzC,kDAAkD;wBAClD,4DAA4D;wBAC5D,sFAAsF;wBACtF,wCAAwC;iBAC3C;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,+EAA+E;YAC/E,iEAAiE;QACnE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;KACxC,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,8CAA8C,KAAK,QAAQ;wBAC3D,oDAAoD;wBACpD,KAAK;wBACL,iCAAiC;wBACjC,iFAAiF;wBACjF,0DAA0D;wBAC1D,wDAAwD;wBACxD,qDAAqD;wBACrD,qFAAqF;wBACrF,6CAA6C;iBAChD;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,mBAAmB,EACnB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,wFAAwF;YACxF,8DAA8D;QAChE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;KAChC,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,gDAAgD,QAAQ,CAAC,KAAK,CAAC,OAAO;wBACtE,2BAA2B;wBAC3B,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpC,+BAA+B;wBAC/B,wEAAwE;wBACxE,yEAAyE;wBACzE,0EAA0E;wBAC1E,sEAAsE;wBACtE,oFAAoF;wBACpF,2DAA2D;iBAC9D;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CollectorClient } from "@uptimizr/agent-core";
+/** URI of the static, machine-readable capabilities/schema descriptor. */
+export declare const CAPABILITIES_URI = "uptimizr://capabilities";
+/** URI of the live list of scenes with recent activity. */
+export declare const SCENES_URI = "uptimizr://scenes";
+/**
+ * Register read-only MCP resources so an agent can **self-discover** the surface
+ * (ADR 0050 §7):
+ *
+ * - `uptimizr://capabilities` — a static descriptor (event types, tool catalog,
+ *   parameter semantics) built from the shared catalog + `@uptimizr/schema`. No
+ *   collector call; it documents *what can be asked*.
+ * - `uptimizr://scenes` — the live set of scene ids with activity, fetched via
+ *   the read-only collector client, so the `scene` parameter can be filled in
+ *   with real values.
+ *
+ * Both are read-only; resources never mutate or expose raw per-session events.
+ */
+export declare function registerResources(server: McpServer, client: CollectorClient): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAC1D,2DAA2D;AAC3D,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuClF"}

package/dist/resources.js

@@ -0,0 +1,46 @@
+import { buildCapabilities } from "./capabilities.js";
+/** URI of the static, machine-readable capabilities/schema descriptor. */
+export const CAPABILITIES_URI = "uptimizr://capabilities";
+/** URI of the live list of scenes with recent activity. */
+export const SCENES_URI = "uptimizr://scenes";
+/**
+ * Register read-only MCP resources so an agent can **self-discover** the surface
+ * (ADR 0050 §7):
+ *
+ * - `uptimizr://capabilities` — a static descriptor (event types, tool catalog,
+ *   parameter semantics) built from the shared catalog + `@uptimizr/schema`. No
+ *   collector call; it documents *what can be asked*.
+ * - `uptimizr://scenes` — the live set of scene ids with activity, fetched via
+ *   the read-only collector client, so the `scene` parameter can be filled in
+ *   with real values.
+ *
+ * Both are read-only; resources never mutate or expose raw per-session events.
+ */
+export function registerResources(server, client) {
+    server.registerResource("capabilities", CAPABILITIES_URI, {
+        title: "Uptimizr capabilities",
+        description: "Machine-readable descriptor of the read-only analytics surface: event types, the tool " +
+            "catalog, and parameter semantics. Read this first to learn what you can ask.",
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(buildCapabilities(), null, 2),
+            },
+        ],
+    }));
+    server.registerResource("scenes", SCENES_URI, {
+        title: "Active scenes",
+        description: "Live list of developer-assigned scene ids with recent activity — the valid values for " +
+            "the `scene` parameter across the tools.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await client.get("api/v1/scenes", {});
+        return {
+            contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(data) }],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAC1D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAuB;IAC1E,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,gBAAgB,EAChB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,wFAAwF;YACxF,8EAA8E;QAChF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aACnD;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EACR,UAAU,EACV;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,wFAAwF;YACxF,yCAAyC;QAC3C,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;SACxF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -1,10 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { CollectorClient } from "./client.js";
+import { type CollectorClient } from "@uptimizr/agent-core";
 /**
  * Build the Uptimizr MCP server: a read-only `McpServer` whose tools each wrap
  * one collector query endpoint via the injected `CollectorClient`. The server
  * holds no business logic — it forwards validated arguments and returns the
- * collector's JSON (ADR 0005 / ADR 0017).
+ * collector's JSON (ADR 0005 / ADR 0017). Alongside the tools it exposes
+ * capability-discovery **resources** and curated analysis **prompts** so agents
+ * can self-orient (ADR 0050 §7).
  */
 export declare function createMcpServer(client: CollectorClient): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAyBlE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA+BlE"}

package/dist/server.js

@@ -1,14 +1,18 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { readTools } from "./tools.js";
+import { readTools } from "@uptimizr/agent-core";
+import { registerResources } from "./resources.js";
+import { registerPrompts } from "./prompts.js";
 import { version } from "./version.js";
 /**
  * Build the Uptimizr MCP server: a read-only `McpServer` whose tools each wrap
  * one collector query endpoint via the injected `CollectorClient`. The server
  * holds no business logic — it forwards validated arguments and returns the
- * collector's JSON (ADR 0005 / ADR 0017).
+ * collector's JSON (ADR 0005 / ADR 0017). Alongside the tools it exposes
+ * capability-discovery **resources** and curated analysis **prompts** so agents
+ * can self-orient (ADR 0050 §7).
  */
 export function createMcpServer(client) {
-    const server = new McpServer({ name: "uptimizr-mcp", version });
+    const server = new McpServer({ name: "uptimizr-mcp", version }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
     for (const tool of readTools) {
         server.registerTool(tool.name, {
             title: tool.title,
@@ -26,6 +30,8 @@ export function createMcpServer(client) {
             }
         });
     }
+    registerResources(server, client);
+    registerPrompts(server);
     return server;
 }
 //# 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;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;IAEhE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAA+B,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAwB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,EACjC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAC5D,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAA+B,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uptimizr/mcp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Read-only Model Context Protocol (MCP) server over an Uptimizr collector's query API — let an agent ask questions of your own 3D analytics, on your own infrastructure.",
   "keywords": [
     "uptimizr",
@@ -48,12 +48,14 @@
   "sideEffects": false,
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^4.1.5"
+    "zod": "^4.4.3",
+    "@uptimizr/agent-core": "0.2.1",
+    "@uptimizr/schema": "0.5.1"
   },
   "devDependencies": {
-    "@types/node": "^22.19.21",
-    "tsx": "^4.22.4",
-    "vitest": "^4.1.9"
+    "@types/node": "^26.1.0",
+    "tsx": "^4.23.0",
+    "vitest": "^4.1.10"
   },
   "engines": {
     "node": ">=22"

package/dist/client.d.ts

@@ -1,23 +0,0 @@
-import type { McpConfig } from "./config.js";
-/** A query-string parameter map. `undefined` values are omitted from the request. */
-export type QueryParams = Record<string, string | number | undefined>;
-/**
- * A minimal **read-only** HTTP client over the collector query API. It performs
- * `GET` requests only and holds no business logic — it is a thin transport that
- * mirrors the dashboard's `CollectorApi` so an agent reads the same aggregated
- * results a human would (ADR 0005 / ADR 0017).
- */
-export interface CollectorClient {
-    get(path: string, params?: QueryParams): Promise<unknown>;
-}
-/** Thrown when the collector responds with a non-2xx status. */
-export declare class CollectorError extends Error {
-    readonly status: number;
-    constructor(message: string, status: number);
-}
-/**
- * Build a read-only collector client bound to one `(collectorUrl, apiKey)` pair.
- * `fetchImpl` is injectable for testing; it defaults to the global `fetch`.
- */
-export declare function createCollectorClient(config: McpConfig, fetchImpl?: typeof fetch): CollectorClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,gEAAgE;AAChE,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;CAK1B;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,GAAE,OAAO,KAAa,GAC9B,eAAe,CAmBjB"}

package/dist/client.js

@@ -1,38 +0,0 @@
-/** Thrown when the collector responds with a non-2xx status. */
-export class CollectorError extends Error {
-    status;
-    constructor(message, status) {
-        super(message);
-        this.status = status;
-        this.name = "CollectorError";
-    }
-}
-function ensureTrailingSlash(url) {
-    return url.endsWith("/") ? url : `${url}/`;
-}
-/**
- * Build a read-only collector client bound to one `(collectorUrl, apiKey)` pair.
- * `fetchImpl` is injectable for testing; it defaults to the global `fetch`.
- */
-export function createCollectorClient(config, fetchImpl = fetch) {
-    const base = ensureTrailingSlash(config.collectorUrl);
-    return {
-        async get(path, params = {}) {
-            const url = new URL(path.replace(/^\//, ""), base);
-            for (const [key, value] of Object.entries(params)) {
-                if (value != null)
-                    url.searchParams.set(key, String(value));
-            }
-            const res = await fetchImpl(url, {
-                method: "GET",
-                headers: { "x-api-key": config.apiKey },
-            });
-            if (!res.ok) {
-                const body = await res.text().catch(() => "");
-                throw new CollectorError(body || res.statusText, res.status);
-            }
-            return res.json();
-        },
-    };
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAeA,gEAAgE;AAChE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAG5B;IAFX,YACE,OAAe,EACN,MAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,YAA0B,KAAK;IAE/B,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,SAAsB,EAAE;YAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,IAAI,IAAI;oBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;gBAC/B,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;aACxC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,cAAc,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools.d.ts

@@ -1,28 +0,0 @@
-import { z } from "zod";
-import type { QueryParams } from "./client.js";
-/** A resolved read request: the collector path and its query parameters. */
-export interface ReadToolRequest {
-    path: string;
-    params: QueryParams;
-}
-/**
- * A read-only tool definition. `inputSchema` is a Zod raw shape the MCP runtime
- * uses to validate arguments; `buildRequest` maps validated arguments to a
- * `GET` against the collector. Definitions are pure and unit-testable without a
- * live collector.
- */
-export interface ReadTool {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: z.ZodRawShape;
-    buildRequest: (args: Record<string, unknown>) => ReadToolRequest;
-}
-/**
- * The catalog of read-only tools. Each wraps one documented collector query
- * endpoint (docs/integration.md §Query). There are intentionally **no**
- * ingestion, mutation, or raw per-session event tools — the surface is
- * aggregate, read-only, and privacy-preserving (ADR 0003 / ADR 0017).
- */
-export declare const readTools: readonly ReadTool[];
-//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC;CAClE;AAiCD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EAsKxC,CAAC"}

package/dist/tools.js

@@ -1,203 +0,0 @@
-import { z } from "zod";
-const num = (v) => (typeof v === "number" ? v : undefined);
-const str = (v) => (typeof v === "string" ? v : undefined);
-// Shared, reusable input fields (all optional unless a tool needs otherwise).
-const since = z.number().int().optional().describe("Start of the time range, epoch milliseconds.");
-const until = z.number().int().optional().describe("End of the time range, epoch milliseconds.");
-const bins = z.number().int().positive().max(500).optional().describe("Grid resolution per axis.");
-const limit = z.number().int().positive().max(1000).optional().describe("Maximum rows to return.");
-const scene = z.string().optional().describe("Restrict to one developer-assigned scene id.");
-const session = z.string().optional().describe("Scope the aggregate to a single session id.");
-const cellSize = z.number().positive().max(1000).optional().describe("Voxel size in world units.");
-const interval = z
-    .number()
-    .int()
-    .positive()
-    .optional()
-    .describe("Time-series bucket width, seconds.");
-const eventType = z
-    .string()
-    .optional()
-    .describe("Restrict to a single event type, e.g. pointer_click.");
-const source = z
-    .enum(["mouse", "touch", "stylus", "pen", "xr-controller", "hand", "gaze", "transient", "other"])
-    .optional()
-    .describe("Restrict a pointer/world heatmap to one input source.");
-/** Build the common `{ since, until }` range params from validated args. */
-function range(args) {
-    return { since: num(args.since), until: num(args.until) };
-}
-/**
- * The catalog of read-only tools. Each wraps one documented collector query
- * endpoint (docs/integration.md §Query). There are intentionally **no**
- * ingestion, mutation, or raw per-session event tools — the surface is
- * aggregate, read-only, and privacy-preserving (ADR 0003 / ADR 0017).
- */
-export const readTools = [
-    {
-        name: "list_sessions",
-        title: "List recent sessions",
-        description: "Recent sessions with id, visitor, event count, and start/end times.",
-        inputSchema: { since, until, limit },
-        buildRequest: (args) => ({
-            path: "api/v1/sessions",
-            params: { ...range(args), limit: num(args.limit) },
-        }),
-    },
-    {
-        name: "pointer_heatmap",
-        title: "2D pointer heatmap",
-        description: "Binned 2D pointer-position heatmap (screen-normalized).",
-        inputSchema: { since, until, bins, scene, source, session },
-        buildRequest: (args) => ({
-            path: "api/v1/heatmaps/pointer",
-            params: {
-                ...range(args),
-                bins: num(args.bins),
-                scene: str(args.scene),
-                source: str(args.source),
-                session: str(args.session),
-            },
-        }),
-    },
-    {
-        name: "world_heatmap",
-        title: "3D world-space pointer heatmap",
-        description: "Voxelized world-space pointer heatmap.",
-        inputSchema: { since, until, cellSize, limit, scene, source },
-        buildRequest: (args) => ({
-            path: "api/v1/heatmaps/world",
-            params: {
-                ...range(args),
-                cellSize: num(args.cellSize),
-                limit: num(args.limit),
-                scene: str(args.scene),
-                source: str(args.source),
-            },
-        }),
-    },
-    {
-        name: "camera_heatmap",
-        title: "View-direction heatmap",
-        description: "Camera view-direction distribution as spherical bins.",
-        inputSchema: { since, until, bins, scene, session },
-        buildRequest: (args) => ({
-            path: "api/v1/heatmaps/camera",
-            params: {
-                ...range(args),
-                bins: num(args.bins),
-                scene: str(args.scene),
-                session: str(args.session),
-            },
-        }),
-    },
-    {
-        name: "click_rays",
-        title: "View-gated click rays",
-        description: "Clicks ASOF-joined to their nearest camera sample, per voxel and clicked mesh.",
-        inputSchema: { since, until, cellSize, limit, scene, source, session },
-        buildRequest: (args) => ({
-            path: "api/v1/heatmaps/click-rays",
-            params: {
-                ...range(args),
-                cellSize: num(args.cellSize),
-                limit: num(args.limit),
-                scene: str(args.scene),
-                source: str(args.source),
-                session: str(args.session),
-            },
-        }),
-    },
-    {
-        name: "flow_links",
-        title: "Gaze→mesh flow links",
-        description: "Aggregate links from camera-direction bins to clicked meshes.",
-        inputSchema: { since, until, bins, limit, scene, session },
-        buildRequest: (args) => ({
-            path: "api/v1/heatmaps/flow",
-            params: {
-                ...range(args),
-                bins: num(args.bins),
-                limit: num(args.limit),
-                scene: str(args.scene),
-                session: str(args.session),
-            },
-        }),
-    },
-    {
-        name: "top_meshes",
-        title: "Most-interacted meshes",
-        description: "Meshes ranked by interaction count.",
-        inputSchema: { since, until, limit, session },
-        buildRequest: (args) => ({
-            path: "api/v1/meshes/top",
-            params: { ...range(args), limit: num(args.limit), session: str(args.session) },
-        }),
-    },
-    {
-        name: "perf_summary",
-        title: "Rendering performance summary",
-        description: "Sample count and avg/min/p50 FPS over the range.",
-        inputSchema: { since, until, session },
-        buildRequest: (args) => ({
-            path: "api/v1/perf",
-            params: { ...range(args), session: str(args.session) },
-        }),
-    },
-    {
-        name: "list_scenes",
-        title: "List active scenes",
-        description: "Distinct developer-assigned scenes with activity.",
-        inputSchema: { since, until, limit },
-        buildRequest: (args) => ({
-            path: "api/v1/scenes",
-            params: { ...range(args), limit: num(args.limit) },
-        }),
-    },
-    {
-        name: "timeseries",
-        title: "Event-volume time series",
-        description: "Event-volume buckets over time, with average FPS per bucket.",
-        inputSchema: { since, until, interval, scene, type: eventType },
-        buildRequest: (args) => ({
-            path: "api/v1/timeseries",
-            params: {
-                ...range(args),
-                interval: num(args.interval),
-                scene: str(args.scene),
-                type: str(args.type),
-            },
-        }),
-    },
-    {
-        name: "event_counts",
-        title: "Per-event-type counts",
-        description: "Counts per event type over the range (scene-health panel).",
-        inputSchema: { since, until, scene },
-        buildRequest: (args) => ({
-            path: "api/v1/event-counts",
-            params: { ...range(args), scene: str(args.scene) },
-        }),
-    },
-    {
-        name: "session_meta",
-        title: "Session descriptor",
-        description: "Coarse descriptor for one session (device/scene/user). No raw event stream.",
-        inputSchema: { sessionId: z.string().min(1).describe("The session id to describe.") },
-        buildRequest: (args) => ({
-            path: `api/v1/sessions/${encodeURIComponent(str(args.sessionId) ?? "")}/meta`,
-            params: {},
-        }),
-    },
-    {
-        name: "scene_representation",
-        title: "Scene representation",
-        description: "Registered proxy geometry (bounds/meshes) for one scene, if any.",
-        inputSchema: { sceneId: z.string().min(1).describe("The scene id to fetch.") },
-        buildRequest: (args) => ({
-            path: `api/v1/scenes/${encodeURIComponent(str(args.sceneId) ?? "")}/representation`,
-            params: {},
-        }),
-    },
-];
-//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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