@mattral/agent-interface 1.2.0 → 1.2.1

package/dist/health-summary.d.ts

@@ -0,0 +1,30 @@
+import { type ErrorCategorySummary, type HealthScore, type Server } from "@mattral/core";
+import type { ReliabilityStore } from "@mattral/storage";
+export interface AgentHealthSummary {
+    reachable: boolean | null;
+    healthScore: HealthScore | null;
+    unresolvedAlertCount: number;
+    recentDriftCount: number;
+    recentHighSeverityDriftCount: number;
+    /** Classified breakdown of proxy-observed failures in the trailing window. Empty if there were none. */
+    errorSummary: ErrorCategorySummary[];
+}
+/**
+ * Computes reachability + a trailing-window tool health score for a
+ * server, the same shape of computation `@mattral/server`'s
+ * `/api/servers/:id/health` endpoint and the CLI's `report` command both
+ * do — but deliberately **read-only**: it never calls
+ * `store.recordHealthScore`.
+ *
+ * This is not the same kind of duplication `decisions/0006` and `0008`
+ * accept for lack of a better option — it's an intentional behavioral
+ * difference. `report` runs are human- or cron-initiated, at a bounded
+ * frequency; an agent deciding "should I use this tool" might query this
+ * before *every* tool call, automatically, at a frequency nothing else in
+ * this project produces. Persisting a snapshot on every such read would
+ * give the `health_scores` table (and the dashboard's history chart) a
+ * completely different write profile than intended — see
+ * `decisions/0011-agent-interface-design.md`.
+ */
+export declare function computeAgentHealthSummary(store: ReliabilityStore, server: Server, windowMs: number): AgentHealthSummary;
+//# sourceMappingURL=health-summary.d.ts.map

package/dist/health-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-summary.d.ts","sourceRoot":"","sources":["../src/health-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACvI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B,EAAE,MAAM,CAAC;IACrC,wGAAwG;IACxG,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAuBpB"}

package/dist/health-summary.js

@@ -0,0 +1,38 @@
+import { computeHealthScore, summarizeErrorCategories } from "@mattral/core";
+const HEALTH_CHECK_TOOL_NAME = "__health_check__";
+/**
+ * Computes reachability + a trailing-window tool health score for a
+ * server, the same shape of computation `@mattral/server`'s
+ * `/api/servers/:id/health` endpoint and the CLI's `report` command both
+ * do — but deliberately **read-only**: it never calls
+ * `store.recordHealthScore`.
+ *
+ * This is not the same kind of duplication `decisions/0006` and `0008`
+ * accept for lack of a better option — it's an intentional behavioral
+ * difference. `report` runs are human- or cron-initiated, at a bounded
+ * frequency; an agent deciding "should I use this tool" might query this
+ * before *every* tool call, automatically, at a frequency nothing else in
+ * this project produces. Persisting a snapshot on every such read would
+ * give the `health_scores` table (and the dashboard's history chart) a
+ * completely different write profile than intended — see
+ * `decisions/0011-agent-interface-design.md`.
+ */
+export function computeAgentHealthSummary(store, server, windowMs) {
+    const windowEnd = Date.now();
+    const windowStart = windowEnd - windowMs;
+    const mostRecentCheck = store.listExecutions({ serverId: server.id, toolName: HEALTH_CHECK_TOOL_NAME, limit: 1 })[0];
+    const reachable = mostRecentCheck ? mostRecentCheck.success : null;
+    const proxyExecutions = store
+        .listExecutions({ serverId: server.id, since: windowStart, until: windowEnd, limit: 10_000 })
+        .filter((e) => e.source === "proxy");
+    const driftEvents = store.listDriftEvents({ serverId: server.id, since: windowStart });
+    const healthScore = proxyExecutions.length > 0
+        ? computeHealthScore({ serverId: server.id, windowStart, windowEnd, executions: proxyExecutions, driftEvents })
+        : null;
+    const unresolvedAlertCount = store.listAlerts({ serverId: server.id, onlyUnresolved: true }).length;
+    const recentDriftCount = driftEvents.length;
+    const recentHighSeverityDriftCount = driftEvents.filter((e) => e.severity === "high").length;
+    const errorSummary = summarizeErrorCategories(proxyExecutions);
+    return { reachable, healthScore, unresolvedAlertCount, recentDriftCount, recentHighSeverityDriftCount, errorSummary };
+}
+//# sourceMappingURL=health-summary.js.map

package/dist/health-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-summary.js","sourceRoot":"","sources":["../src/health-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAA4D,MAAM,eAAe,CAAC;AAGvI,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAYlD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAuB,EACvB,MAAc,EACd,QAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEzC,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnE,MAAM,eAAe,GAAG,KAAK;SAC1B,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SAC5F,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAEvF,MAAM,WAAW,GACf,eAAe,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;QAC/G,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpG,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC;IAC5C,MAAM,4BAA4B,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAC7F,MAAM,YAAY,GAAG,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAE/D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,YAAY,EAAE,CAAC;AACxH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./health-summary.js";
+export * from "./tools.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./health-summary.js";
+export * from "./tools.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ReliabilityStore } from "@mattral/storage";
+export interface CreateAgentServerOptions {
+    name?: string;
+    version?: string;
+}
+/** Builds (but does not connect) an MCP server exposing mcp-reliable's own data. Connect it to whatever transport fits — stdio via `runAgentServerOnStdio` below, or an in-memory transport for tests. */
+export declare function createAgentServer(store: ReliabilityStore, options?: CreateAgentServerOptions): McpServer;
+/**
+ * Runs the agent-facing MCP interface over stdio until the client
+ * disconnects — the shape the CLI's `mcp` command needs. Kept here rather
+ * than duplicated in `packages/cli` so that package doesn't need a direct
+ * `@modelcontextprotocol/sdk` dependency of its own; see
+ * `decisions/0011-agent-interface-design.md`.
+ *
+ * `server.connect(transport)` resolves once the initial handshake
+ * completes, not when the session ends — awaiting only that (an earlier
+ * version of this function did exactly that) let the CLI's `finally {
+ * store.close() }` run immediately after connecting, before any tool call
+ * had a chance to execute. This waits for the underlying `Server`'s
+ * `onclose` callback (fired once, for any reason the connection ends,
+ * including an explicit `close()`) so the promise doesn't resolve until
+ * the client actually disconnects.
+ */
+export declare function runAgentServerOnStdio(store: ReliabilityStore): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0MAA0M;AAC1M,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE,wBAA6B,GAAG,SAAS,CAO5G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF"}

package/dist/server.js

@@ -0,0 +1,37 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAgentTools } from "./tools.js";
+/** Builds (but does not connect) an MCP server exposing mcp-reliable's own data. Connect it to whatever transport fits — stdio via `runAgentServerOnStdio` below, or an in-memory transport for tests. */
+export function createAgentServer(store, options = {}) {
+    const server = new McpServer({
+        name: options.name ?? "mcp-reliable",
+        version: options.version ?? "1.0.0"
+    });
+    registerAgentTools(server, store);
+    return server;
+}
+/**
+ * Runs the agent-facing MCP interface over stdio until the client
+ * disconnects — the shape the CLI's `mcp` command needs. Kept here rather
+ * than duplicated in `packages/cli` so that package doesn't need a direct
+ * `@modelcontextprotocol/sdk` dependency of its own; see
+ * `decisions/0011-agent-interface-design.md`.
+ *
+ * `server.connect(transport)` resolves once the initial handshake
+ * completes, not when the session ends — awaiting only that (an earlier
+ * version of this function did exactly that) let the CLI's `finally {
+ * store.close() }` run immediately after connecting, before any tool call
+ * had a chance to execute. This waits for the underlying `Server`'s
+ * `onclose` callback (fired once, for any reason the connection ends,
+ * including an explicit `close()`) so the promise doesn't resolve until
+ * the client actually disconnects.
+ */
+export async function runAgentServerOnStdio(store) {
+    const server = createAgentServer(store);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    await new Promise((resolve) => {
+        server.server.onclose = resolve;
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOhD,0MAA0M;AAC1M,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,UAAoC,EAAE;IAC/F,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,cAAc;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;KACpC,CAAC,CAAC;IACH,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAuB;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ReliabilityStore } from "@mattral/storage";
+/** Registers every mcp-reliable agent-facing tool on `server`, reading from `store`. Kept as a plain function (not a class) so it can be called once per MCP session by the CLI's `mcp` command, or reused directly by tests via InMemoryTransport. */
+export declare function registerAgentTools(server: McpServer, store: ReliabilityStore): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAazD,uPAAuP;AACvP,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAqHnF"}

package/dist/tools.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { buildRecommendation } from "@mattral/core";
+import { computeAgentHealthSummary } from "./health-summary.js";
+const DEFAULT_WINDOW_MS = 3_600_000; // 1h, matching `monitor --window`'s default
+function textResult(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value) }] };
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/** Registers every mcp-reliable agent-facing tool on `server`, reading from `store`. Kept as a plain function (not a class) so it can be called once per MCP session by the CLI's `mcp` command, or reused directly by tests via InMemoryTransport. */
+export function registerAgentTools(server, store) {
+    server.registerTool("list_servers", {
+        description: "List every MCP server mcp-reliable is currently tracking, with its id, name, tags, and transport type. Use the returned id with the other tools.",
+        inputSchema: {}
+    }, async () => {
+        const servers = store.listServers().map((s) => ({
+            id: s.id,
+            name: s.name,
+            tags: s.tags,
+            transportType: s.transport.type
+        }));
+        return textResult({ servers });
+    });
+    server.registerTool("get_server_health", {
+        description: "Get the current reachability and tool health score for one server. Reachability reflects the most recent health check; healthScore (0-100, null if no traffic yet) reflects real tool calls observed via `mcp-reliable proxy` over the trailing window. Also includes errorSummary: a classified breakdown of recent failures (e.g. rate-limit, auth, timeout) by likely cause, sorted by frequency, to help decide whether an issue is worth working around before falling back to another tool.",
+        inputSchema: {
+            serverId: z.string().describe("A server id from list_servers"),
+            windowMs: z.number().int().positive().optional().describe("Trailing window in milliseconds (default 1h)")
+        }
+    }, async ({ serverId, windowMs }) => {
+        const server = store.getServer(serverId);
+        if (!server)
+            return errorResult(`No server registered with id "${serverId}".`);
+        const summary = computeAgentHealthSummary(store, server, windowMs ?? DEFAULT_WINDOW_MS);
+        return textResult({ serverId, ...summary });
+    });
+    server.registerTool("list_drift_events", {
+        description: "List detected schema, output-shape, or statistical (e.g. latency distribution) changes for one server — a tool's contract or behavior changing out from under callers.",
+        inputSchema: {
+            serverId: z.string().describe("A server id from list_servers"),
+            sinceMs: z.number().int().nonnegative().optional().describe("Only events at/after this epoch-ms timestamp"),
+            limit: z.number().int().positive().max(500).optional()
+        }
+    }, async ({ serverId, sinceMs, limit }) => {
+        if (!store.getServer(serverId))
+            return errorResult(`No server registered with id "${serverId}".`);
+        const driftEvents = store.listDriftEvents({ serverId, since: sinceMs, limit });
+        return textResult({ serverId, driftEvents });
+    });
+    server.registerTool("list_alerts", {
+        description: "List reliability alerts (unreachable, health-degradation, drift) recorded for one server.",
+        inputSchema: {
+            serverId: z.string().describe("A server id from list_servers"),
+            onlyUnresolved: z.boolean().optional().describe("If true, only currently-open alerts")
+        }
+    }, async ({ serverId, onlyUnresolved }) => {
+        if (!store.getServer(serverId))
+            return errorResult(`No server registered with id "${serverId}".`);
+        const alerts = store.listAlerts({ serverId, onlyUnresolved });
+        return textResult({ serverId, alerts });
+    });
+    server.registerTool("get_recommendation", {
+        description: "Get a should-I-use-this-right-now verdict (avoid/caution/healthy/unknown) for one server, synthesized from its current reachability, tool health score, and recent drift.",
+        inputSchema: {
+            serverId: z.string().describe("A server id from list_servers"),
+            windowMs: z.number().int().positive().optional().describe("Trailing window in milliseconds (default 1h)")
+        }
+    }, async ({ serverId, windowMs }) => {
+        const server = store.getServer(serverId);
+        if (!server)
+            return errorResult(`No server registered with id "${serverId}".`);
+        const summary = computeAgentHealthSummary(store, server, windowMs ?? DEFAULT_WINDOW_MS);
+        const recommendation = buildRecommendation({
+            reachable: summary.reachable,
+            healthScore: summary.healthScore?.score ?? null,
+            recentHighSeverityDrift: summary.recentHighSeverityDriftCount > 0
+        });
+        return textResult({ serverId, ...recommendation });
+    });
+    server.registerTool("list_recommendations", {
+        description: "Get a should-I-use-this-right-now verdict for every tracked server in one call — the fastest way for an agent to decide which of several available MCP servers to route a task to.",
+        inputSchema: {
+            windowMs: z.number().int().positive().optional().describe("Trailing window in milliseconds (default 1h)")
+        }
+    }, async ({ windowMs }) => {
+        const servers = store.listServers();
+        const recommendations = servers.map((server) => {
+            const summary = computeAgentHealthSummary(store, server, windowMs ?? DEFAULT_WINDOW_MS);
+            const recommendation = buildRecommendation({
+                reachable: summary.reachable,
+                healthScore: summary.healthScore?.score ?? null,
+                recentHighSeverityDrift: summary.recentHighSeverityDriftCount > 0
+            });
+            return { serverId: server.id, serverName: server.name, ...recommendation };
+        });
+        return textResult({ recommendations });
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mattral/agent-interface",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Agent-facing MCP interface exposing mcp-reliable's own health, drift, and recommendation data as MCP tools",
   "type": "module",
   "license": "MIT",
@@ -40,11 +40,12 @@
   },
   "scripts": {
     "build": "tsc -b",
-    "clean": "rimraf dist *.tsbuildinfo"
+    "clean": "rimraf dist *.tsbuildinfo",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@mattral/core": "^1.0.0",
-    "@mattral/storage": "^1.0.0",
+    "@mattral/core": "^1.2.1",
+    "@mattral/storage": "^1.2.1",
     "@modelcontextprotocol/sdk": "^1.32.2",
     "zod": "^4.6.7"
   },