@signal4/s4 2.4.0 → 2.6.0

package/dist/http.js

@@ -0,0 +1,132 @@
+/** Signal4 MCP server — streamable-http entry point.
+ *
+ * Serves the MCP protocol over HTTP at /mcp. NO auth logic lives here beyond
+ * envelope checks: the client's API key (X-API-Key or Authorization: Bearer)
+ * is passed through to the backend on every call, and the backend natively
+ * validates it, enforces scopes/projects, rate-limits, and records usage.
+ *
+ * Run with:
+ *     node dist/http.js --host 127.0.0.1 --port 7998
+ *
+ * Env:
+ *     SIGNAL4_API_URL — backend base URL (default https://api.signal4.ca;
+ *                       PM2 sets http://localhost:7999)
+ */
+import { createHash } from "node:crypto";
+import { createServer } from "node:http";
+import { parseArgs } from "node:util";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { withApiKey } from "./client.js";
+import { buildServer, CachedManifest } from "./server_core.js";
+// ---------------------------------------------------------------------------
+// Per-key manifest cache
+//
+// The backend manifest endpoint scope-filters tools per key, so different
+// keys get different tool lists. Tool authorization = membership in that
+// key's manifest. Keyed by sha256 of the raw key; TTL bounds how long a
+// revoked/rescoped key keeps its old tool list.
+// ---------------------------------------------------------------------------
+const MANIFEST_TTL_MS = 15 * 60 * 1000;
+const MANIFEST_CACHE_MAX = 100;
+const manifestCache = new Map();
+function manifestFor(key) {
+    const hash = createHash("sha256").update(key).digest("hex");
+    let entry = manifestCache.get(hash);
+    if (!entry) {
+        entry = new CachedManifest({ ttlMs: MANIFEST_TTL_MS });
+        if (manifestCache.size >= MANIFEST_CACHE_MAX) {
+            // Evict the least-recently-used entry (Map preserves insertion order;
+            // we re-insert on every hit below, so the first key is the LRU).
+            const oldest = manifestCache.keys().next().value;
+            if (oldest !== undefined)
+                manifestCache.delete(oldest);
+        }
+    }
+    else {
+        manifestCache.delete(hash); // re-insert to mark as recently used
+    }
+    manifestCache.set(hash, entry);
+    return entry;
+}
+// ---------------------------------------------------------------------------
+// Key extraction — envelope only, validation belongs to the backend
+// ---------------------------------------------------------------------------
+function extractApiKey(req) {
+    const headerKey = req.headers["x-api-key"];
+    if (typeof headerKey === "string" && headerKey)
+        return headerKey.trim();
+    const auth = req.headers["authorization"];
+    if (typeof auth === "string" && auth.toLowerCase().startsWith("bearer ")) {
+        return auth.slice(7).trim();
+    }
+    return null;
+}
+function sendJson(res, status, body) {
+    res.writeHead(status, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(body));
+}
+// ---------------------------------------------------------------------------
+// Request handling — stateless: one server + transport per request
+// ---------------------------------------------------------------------------
+async function handleMcpRequest(req, res) {
+    const key = extractApiKey(req);
+    if (!key) {
+        sendJson(res, 401, {
+            detail: "Missing API key. Send it as 'X-API-Key: <key>' or 'Authorization: Bearer <key>'.",
+        });
+        return;
+    }
+    if (!key.startsWith("sk_")) {
+        sendJson(res, 401, { detail: "Invalid API key format. Signal4 keys start with 'sk_'." });
+        return;
+    }
+    const server = buildServer(manifestFor(key));
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // stateless mode
+    });
+    res.on("close", () => {
+        void transport.close();
+        void server.close();
+    });
+    // Everything the MCP handlers do — manifest fetch, tool handler backend
+    // calls — runs inside this key's context, so client.ts sends THIS key.
+    await withApiKey(key, async () => {
+        await server.connect(transport);
+        await transport.handleRequest(req, res);
+    });
+}
+// ---------------------------------------------------------------------------
+// HTTP server
+// ---------------------------------------------------------------------------
+const { values: args } = parseArgs({
+    options: {
+        host: { type: "string", default: "127.0.0.1" },
+        port: { type: "string", default: "7998" },
+    },
+});
+const httpServer = createServer((req, res) => {
+    const path = (req.url ?? "/").split("?")[0];
+    if (req.method === "GET" && path === "/health") {
+        sendJson(res, 200, { status: "ok", service: "signal4-mcp", transport: "http" });
+        return;
+    }
+    if (path === "/mcp") {
+        handleMcpRequest(req, res).catch((err) => {
+            console.error("MCP request failed:", err);
+            if (!res.headersSent) {
+                sendJson(res, 500, { detail: "Internal server error" });
+            }
+            else {
+                res.end();
+            }
+        });
+        return;
+    }
+    sendJson(res, 404, { detail: "Not found" });
+});
+const port = Number(args.port);
+httpServer.listen(port, args.host, () => {
+    console.log(`Signal4 MCP (streamable-http) listening on http://${args.host}:${port}/mcp ` +
+        `(backend: ${process.env.SIGNAL4_API_URL ?? "https://api.signal4.ca"})`);
+});
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 /** Signal4 MCP server — media intelligence tools for AI agents.
  *
- * Connects to the Signal4 REST API at api.signal4.ca.
+ * Stdio entry point. Connects to the Signal4 REST API at api.signal4.ca.
  * Tool definitions (names, descriptions, schemas) are fetched from the API
  * at startup — the npm package contains only handler logic, not metadata.
+ *
+ * For the streamable-http entry point, see http.ts.
  */
 export {};
 //# 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;;;;;GAKG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/index.js

@@ -1,160 +1,23 @@
 /** Signal4 MCP server — media intelligence tools for AI agents.
  *
- * Connects to the Signal4 REST API at api.signal4.ca.
+ * Stdio entry point. Connects to the Signal4 REST API at api.signal4.ca.
  * Tool definitions (names, descriptions, schemas) are fetched from the API
  * at startup — the npm package contains only handler logic, not metadata.
+ *
+ * For the streamable-http entry point, see http.ts.
  */
-import { createRequire } from "node:module";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { applyConfig } from "./config.js";
-import * as client from "./client.js";
-import { HANDLERS } from "./handlers/registry.js";
+import { buildServer, CachedManifest } from "./server_core.js";
 applyConfig();
-// ---------------------------------------------------------------------------
-// Manifest cache — fetched once per session from the API
-// ---------------------------------------------------------------------------
-let _manifest = null;
-let _authError = null;
-let _lastFailedAt = 0;
-const RETRY_COOLDOWN_MS = 60_000;
-async function fetchManifest() {
-    if (_manifest)
-        return _manifest;
-    if (!process.env.SIGNAL4_API_KEY) {
-        _authError =
-            "SIGNAL4_API_KEY environment variable is not set. " +
-                "Get your API key from Signal4 and set it in your MCP server config.";
-        throw new Error(_authError);
-    }
-    // Don't hammer the API with a key that keeps failing
-    if (_authError && Date.now() - _lastFailedAt < RETRY_COOLDOWN_MS) {
-        throw new Error(_authError);
-    }
-    try {
-        _manifest = await client.getManifest();
-        _authError = null;
-        return _manifest;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (/HTTP 40[13]/.test(msg)) {
-            _authError = msg;
-            _lastFailedAt = Date.now();
-        }
-        throw err;
-    }
-}
-const AUTH_DIAGNOSTIC_TOOL = "signal4_connection_status";
-function diagnosticToolList() {
-    const reason = _authError ?? "Unknown authentication error";
-    return {
-        tools: [
-            {
-                name: AUTH_DIAGNOSTIC_TOOL,
-                description: `⚠ Signal4 connection failed: ${reason}. ` +
-                    "No tools are available until the API key is fixed. " +
-                    "Check the SIGNAL4_API_KEY in your MCP server config.",
-                inputSchema: { type: "object", properties: {} },
-            },
-        ],
-    };
-}
-function diagnosticToolResponse() {
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Signal4 connection error: ${_authError}\n\n` +
-                    "To fix this:\n" +
-                    "1. Get a valid API key from Signal4\n" +
-                    "2. Update SIGNAL4_API_KEY in your MCP server config\n" +
-                    "3. Restart the MCP server",
-            },
-        ],
-        isError: true,
-    };
-}
-// ---------------------------------------------------------------------------
-// Server setup
-// ---------------------------------------------------------------------------
-const FALLBACK_INSTRUCTIONS = "Signal4 media intelligence platform. Authenticating...";
-const { version: PKG_VERSION } = createRequire(import.meta.url)("../package.json");
-const server = new McpServer({ name: "Signal4", version: PKG_VERSION }, { instructions: FALLBACK_INSTRUCTIONS });
-// Register tool capabilities and custom handlers on the underlying Server
-// BEFORE any .tool() call — we own the tool protocol directly so we can
-// serve raw JSON Schema from the manifest without zod conversion.
-server.server.registerCapabilities({ tools: { listChanged: true } });
-server.server.setRequestHandler(ListToolsRequestSchema, async () => {
-    try {
-        const m = await fetchManifest();
-        return {
-            tools: m.tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                inputSchema: t.inputSchema,
-            })),
-        };
-    }
-    catch {
-        return diagnosticToolList();
-    }
-});
-server.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    try {
-        const { name, arguments: args } = request.params;
-        if (name === AUTH_DIAGNOSTIC_TOOL) {
-            return diagnosticToolResponse();
-        }
-        // Verify the tool is in the manifest (scope enforcement)
-        const m = await fetchManifest();
-        const authorized = m.tools.some((t) => t.name === name);
-        if (!authorized) {
-            return {
-                content: [{ type: "text", text: `Tool "${name}" is not available.` }],
-                isError: true,
-            };
-        }
-        const handler = HANDLERS[name];
-        if (!handler) {
-            return {
-                content: [{ type: "text", text: `Tool "${name}" is not implemented.` }],
-                isError: true,
-            };
-        }
-        return await handler(args ?? {});
-    }
-    catch (err) {
-        const raw = err instanceof Error ? err.message : String(err);
-        let msg = raw;
-        if (/HTTP 40[13]/.test(raw)) {
-            msg = "API key is invalid or expired. Check the SIGNAL4_API_KEY in your MCP server config.";
-        }
-        else if (/HTTP 404/.test(raw)) {
-            msg = "The requested resource was not found. Check that the ID came from a previous search or listing result.";
-        }
-        else if (/HTTP 422/.test(raw)) {
-            msg = raw + " Check the tool description for valid parameter types and formats.";
-        }
-        else if (raw.includes("expand_query must be called before")) {
-            msg = "Analysis pipeline error — try workflow='simple_rag' or simplify your query.";
-        }
-        else if (raw.includes("Input should be less than or equal to")) {
-            msg = raw + " Check the tool description for valid parameter ranges.";
-        }
-        else if (/fetch failed|ECONNREFUSED|ETIMEDOUT/.test(raw)) {
-            msg = "Could not reach the Signal4 API. The service may be temporarily unavailable — try again in a moment.";
-        }
-        return {
-            content: [{ type: "text", text: `Error: ${msg}` }],
-            isError: true,
-        };
-    }
+// Single global manifest cache keyed by the env key, cached for the session.
+const manifest = new CachedManifest({
+    missingKeyMessage: () => process.env.SIGNAL4_API_KEY
+        ? null
+        : "SIGNAL4_API_KEY environment variable is not set. " +
+            "Get your API key from Signal4 and set it in your MCP server config.",
 });
-// ---------------------------------------------------------------------------
-// Start
-// ---------------------------------------------------------------------------
+const server = buildServer(manifest);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
@@ -162,7 +25,7 @@ async function main() {
     // If this fails (bad key, network), the ListTools handler will retry
     // on the next tools/list request.
     try {
-        await fetchManifest();
+        await manifest.fetch();
         server.server.sendToolListChanged();
     }
     catch {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,WAAW,EAAE,CAAC;AAEd,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;IAClC,iBAAiB,EAAE,GAAG,EAAE,CACtB,OAAO,CAAC,GAAG,CAAC,eAAe;QACzB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,mDAAmD;YACnD,qEAAqE;CAC5E,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAErC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,mEAAmE;IACnE,qEAAqE;IACrE,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/provenance.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Window/provenance footers (MCP vocabulary) + speaker empty-state help.
+ *
+ * format.ts's windowFooter speaks CLI ("--days N"); MCP tools take `days` /
+ * `start_date` parameters, so evidence-bearing tools append this variant
+ * instead. Every tool that searches a window must SAY what window it searched:
+ * thin results inside a default window are indistinguishable from a thin
+ * corpus otherwise.
+ */
+/** The concrete calendar window a days-based endpoint actually covered. */
+export declare function windowFromDays(days: number): {
+    startDate: string;
+    endDate: string;
+};
+/**
+ * One-line footer stating the date range a tool actually searched, in MCP
+ * parameter vocabulary (`days` / `start_date`), matching the style of
+ * format.ts's windowFooter.
+ */
+export declare function mcpWindowFooter(opts: {
+    startDate?: string;
+    endDate?: string;
+    days?: number;
+    /** True when the caller supplied no window and the tool's default applied. */
+    defaultWindow?: boolean;
+    fullHistory?: boolean;
+    /** Max days the endpoint accepts, for the widen hint (default 365). */
+    maxDays?: number;
+    /** True for endpoints that only take `days` (no start_date parameter). */
+    daysOnly?: boolean;
+}): string;
+/** For endpoints with no time filter at all (e.g. entity_claims). */
+export declare function allTimeFooter(): string;
+/**
+ * When a speaker-filtered search returns nothing, distinguish "the speaker
+ * doesn't exist in the corpus" from "the speaker said nothing matching".
+ * Returns a note to prepend, or undefined when the name resolves cleanly
+ * (i.e. the emptiness is about the topic/window, not the name).
+ */
+export declare function speakerEmptyStateNote(name: string): Promise<string | undefined>;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAUT;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgBrF"}

package/dist/provenance.js

@@ -0,0 +1,65 @@
+/**
+ * Window/provenance footers (MCP vocabulary) + speaker empty-state help.
+ *
+ * format.ts's windowFooter speaks CLI ("--days N"); MCP tools take `days` /
+ * `start_date` parameters, so evidence-bearing tools append this variant
+ * instead. Every tool that searches a window must SAY what window it searched:
+ * thin results inside a default window are indistinguishable from a thin
+ * corpus otherwise.
+ */
+import * as client from "./client.js";
+/** The concrete calendar window a days-based endpoint actually covered. */
+export function windowFromDays(days) {
+    return {
+        startDate: new Date(Date.now() - days * 86400000).toISOString().slice(0, 10),
+        endDate: new Date().toISOString().slice(0, 10),
+    };
+}
+/**
+ * One-line footer stating the date range a tool actually searched, in MCP
+ * parameter vocabulary (`days` / `start_date`), matching the style of
+ * format.ts's windowFooter.
+ */
+export function mcpWindowFooter(opts) {
+    if (opts.fullHistory)
+        return "\n_Searched the full corpus history._";
+    let { startDate, endDate } = opts;
+    if (!startDate && opts.days != null)
+        ({ startDate, endDate } = windowFromDays(opts.days));
+    const daysStr = opts.days != null ? ` (${opts.days} days)` : "";
+    const span = startDate ? `${startDate} → ${endDate ?? "today"}${daysStr}` : `last ${opts.days ?? 30} days`;
+    const hint = opts.defaultWindow ? ` (default ${opts.days ?? 30}d window)` : "";
+    const max = opts.maxDays ?? 365;
+    const widen = opts.daysOnly ? `widen with days (≤${max})` : `widen with days (≤${max}) or start_date YYYY-MM-DD`;
+    return `\n_Searched ${span}${hint} — older content may exist; ${widen}._`;
+}
+/** For endpoints with no time filter at all (e.g. entity_claims). */
+export function allTimeFooter() {
+    return "\n_Searched the full claim history — this tool has no time window._";
+}
+/**
+ * When a speaker-filtered search returns nothing, distinguish "the speaker
+ * doesn't exist in the corpus" from "the speaker said nothing matching".
+ * Returns a note to prepend, or undefined when the name resolves cleanly
+ * (i.e. the emptiness is about the topic/window, not the name).
+ */
+export async function speakerEmptyStateNote(name) {
+    let matches;
+    try {
+        matches = await client.searchSpeakers(name, 3);
+    }
+    catch {
+        return undefined; // lookup failure must never mask the real empty state
+    }
+    const names = matches
+        .map((m) => m.name ?? m.primary_name)
+        .filter((n) => !!n);
+    if (!names.length) {
+        return `No speaker matching "${name}" found in the corpus. Check the spelling or use find_speakers to browse.`;
+    }
+    const exact = names.some((n) => n.toLowerCase() === name.trim().toLowerCase());
+    if (exact)
+        return undefined;
+    return `No speaker matching "${name}" found in the corpus. Closest names: ${names.join(", ")}. Did you mean one of these? (Pass the canonical spelling as speaker.)`;
+}
+//# sourceMappingURL=provenance.js.map

package/dist/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5E,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAW/B;IACC,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,uCAAuC,CAAC;IACrE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;QAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,MAAM,OAAO,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,IAAI,EAAE,OAAO,CAAC;IAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC,CAAC,qBAAqB,GAAG,4BAA4B,CAAC;IACjH,OAAO,eAAe,IAAI,GAAG,IAAI,+BAA+B,KAAK,IAAI,CAAC;AAC5E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa;IAC3B,OAAO,qEAAqE,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,sDAAsD;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,OAAO;SAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,wBAAwB,IAAI,2EAA2E,CAAC;IACjH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,wBAAwB,IAAI,yCAAyC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wEAAwE,CAAC;AACvK,CAAC"}

package/dist/server_core.d.ts

@@ -0,0 +1,40 @@
+/** Shared MCP server wiring — used by both the stdio entry (index.ts) and the
+ * streamable-http entry (http.ts).
+ *
+ * Tool definitions (names, descriptions, schemas) come from the API's manifest
+ * endpoint, which scope-filters tools per key. Tool authorization is therefore
+ * simply membership in the caller's manifest. The manifest cache strategy
+ * differs per transport (single global for stdio, per-key for HTTP), so the
+ * server is parameterized on a ManifestProvider.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ManifestResponse } from "./client.js";
+export declare const RETRY_COOLDOWN_MS = 60000;
+export interface ManifestProvider {
+    /** Fetch (or return cached) manifest for the current caller. */
+    fetch(): Promise<ManifestResponse>;
+    /** Last auth error for the current caller, if any. */
+    authError(): string | null;
+}
+/**
+ * Manifest cache with the 60s auth-failure cooldown. One instance per key
+ * context: index.ts holds a single global one (env key, cached forever, as
+ * before); http.ts holds one per key hash with a TTL.
+ */
+export declare class CachedManifest implements ManifestProvider {
+    private readonly opts;
+    private manifest;
+    private fetchedAt;
+    private _authError;
+    private lastFailedAt;
+    constructor(opts?: {
+        /** Cache TTL in ms; Infinity = cache for process lifetime. */
+        ttlMs?: number;
+        /** Return an error message if no key is available (stdio env check). */
+        missingKeyMessage?: () => string | null;
+    });
+    authError(): string | null;
+    fetch(): Promise<ManifestResponse>;
+}
+export declare function buildServer(provider: ManifestProvider): McpServer;
+//# sourceMappingURL=server_core.d.ts.map

package/dist/server_core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_core.d.ts","sourceRoot":"","sources":["../src/server_core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,sDAAsD;IACtD,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IAOnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAK;gBAGN,IAAI,GAAE;QACrB,8DAA8D;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wEAAwE;QACxE,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;KACpC;IAGR,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;CA6BzC;AAkDD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CA6EjE"}