@meertrack/mcp 1.0.0

package/dist/client.js

@@ -0,0 +1,178 @@
+import { VERSION } from "./version.js";
+export const DEFAULT_BASE_URL = "https://api.meertrack.com/v1";
+/** Resolve the upstream base URL, honoring `MEERTRACK_API_BASE_URL` for staging/local. */
+export function resolveBaseUrl(override) {
+    const raw = override ?? process.env["MEERTRACK_API_BASE_URL"] ?? DEFAULT_BASE_URL;
+    return raw.replace(/\/+$/, "");
+}
+/**
+ * Typed error thrown for every non-2xx upstream response. `code` reflects the
+ * upstream error envelope's `error.code` when present, else a generic fallback
+ * (`http_<status>`, `transport_error`, `invalid_response`).
+ */
+export class MeertrackApiError extends Error {
+    status;
+    code;
+    rateLimitReset;
+    constructor(params) {
+        super(params.message);
+        this.name = "MeertrackApiError";
+        this.status = params.status;
+        this.code = params.code;
+        if (params.rateLimitReset !== undefined) {
+            this.rateLimitReset = params.rateLimitReset;
+        }
+    }
+}
+/**
+ * Thin typed wrapper over `api.meertrack.com/v1`. Each method is a 1:1 shadow
+ * of its endpoint. No retry/backoff in v1 — a 429 throws with the reset
+ * epoch and the caller (the MCP tool layer) decides what to tell the agent.
+ */
+export class MeertrackClient {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    userAgent;
+    onUpstreamResponse;
+    constructor(opts) {
+        this.baseUrl = resolveBaseUrl(opts.baseUrl);
+        this.apiKey = opts.apiKey;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.userAgent = opts.userAgent ?? `meertrack-mcp/${VERSION}`;
+        if (opts.onUpstreamResponse) {
+            this.onUpstreamResponse = opts.onUpstreamResponse;
+        }
+    }
+    me() {
+        return this.request("GET", "/me");
+    }
+    listCompetitors(params = {}) {
+        const query = new URLSearchParams();
+        if (params.active !== undefined)
+            query.set("active", params.active ? "true" : "false");
+        if (params.ids && params.ids.length > 0)
+            query.set("id", params.ids.join(","));
+        if (params.expand)
+            query.set("expand", params.expand);
+        return this.request("GET", "/competitors", query);
+    }
+    getCompetitor(id) {
+        return this.request("GET", `/competitors/${encodeURIComponent(id)}`);
+    }
+    listActivity(params = {}) {
+        const query = new URLSearchParams();
+        if (params.competitor_ids && params.competitor_ids.length > 0)
+            query.set("competitor_id", params.competitor_ids.join(","));
+        if (params.sections && params.sections.length > 0)
+            query.set("section", params.sections.join(","));
+        if (params.change_types && params.change_types.length > 0)
+            query.set("change_type", params.change_types.join(","));
+        if (params.from)
+            query.set("from", params.from);
+        if (params.to)
+            query.set("to", params.to);
+        if (params.limit !== undefined)
+            query.set("limit", String(params.limit));
+        if (params.cursor)
+            query.set("cursor", params.cursor);
+        return this.request("GET", "/activity", query);
+    }
+    getActivityItem(rowUuid) {
+        return this.request("GET", `/activity/${encodeURIComponent(rowUuid)}`);
+    }
+    listDigests(params = {}) {
+        const query = new URLSearchParams();
+        if (params.competitor_id && params.competitor_id.length > 0)
+            query.set("competitor_id", params.competitor_id.join(","));
+        if (params.from)
+            query.set("from", params.from);
+        if (params.to)
+            query.set("to", params.to);
+        if (params.limit !== undefined)
+            query.set("limit", String(params.limit));
+        if (params.cursor)
+            query.set("cursor", params.cursor);
+        return this.request("GET", "/digests", query);
+    }
+    listLatestDigests() {
+        return this.request("GET", "/digests/latest");
+    }
+    getDigest(id) {
+        return this.request("GET", `/digests/${encodeURIComponent(id)}`);
+    }
+    async request(method, path, query) {
+        const qs = query && query.toString().length > 0 ? `?${query.toString()}` : "";
+        const url = `${this.baseUrl}${path}${qs}`;
+        let response;
+        try {
+            response = await this.fetchImpl(url, {
+                method,
+                headers: {
+                    authorization: `Bearer ${this.apiKey}`,
+                    accept: "application/json",
+                    "user-agent": this.userAgent,
+                },
+            });
+        }
+        catch (cause) {
+            throw new MeertrackApiError({
+                status: 0,
+                code: "transport_error",
+                message: cause instanceof Error
+                    ? `Network error calling Meertrack: ${cause.message}`
+                    : "Network error calling Meertrack",
+            });
+        }
+        if (this.onUpstreamResponse) {
+            this.onUpstreamResponse({
+                status: response.status,
+                requestId: response.headers.get("x-request-id"),
+            });
+        }
+        if (!response.ok) {
+            throw await toApiError(response);
+        }
+        try {
+            return (await response.json());
+        }
+        catch (cause) {
+            throw new MeertrackApiError({
+                status: response.status,
+                code: "invalid_response",
+                message: cause instanceof Error
+                    ? `Malformed JSON from Meertrack: ${cause.message}`
+                    : "Malformed JSON from Meertrack",
+            });
+        }
+    }
+}
+/** Parse an upstream non-2xx into a `MeertrackApiError`. Exported for tests. */
+export async function toApiError(response) {
+    const resetHeader = response.headers.get("x-ratelimit-reset");
+    const rateLimitReset = resetHeader && Number.isFinite(Number(resetHeader)) ? Number(resetHeader) : undefined;
+    let code = `http_${response.status}`;
+    let message = response.statusText || `Upstream HTTP ${response.status}`;
+    try {
+        const body = (await response.json());
+        if (body && typeof body === "object" && body.error) {
+            if (typeof body.error.code === "string" && body.error.code.length > 0) {
+                code = body.error.code;
+            }
+            if (typeof body.error.message === "string" && body.error.message.length > 0) {
+                message = body.error.message;
+            }
+        }
+    }
+    catch {
+        // Upstream returned non-JSON (e.g. a Fly platform error page); keep the
+        // HTTP-derived fallback code/message. Never propagate the parse error.
+    }
+    return new MeertrackApiError({
+        status: response.status,
+        code,
+        message,
+        ...(rateLimitReset !== undefined ? { rateLimitReset } : {}),
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Maps upstream `MeertrackApiError`s into MCP tool-call results per spec
+ * §server/tools (isError semantics): upstream REST failures are **tool
+ * execution errors**, not protocol errors — the LLM needs to read them and
+ * self-correct. They go back as `{ content: [{ type: "text", text }], isError: true }`.
+ *
+ * Malformed MCP requests (unknown tool, invalid params) are handled by the
+ * SDK as JSON-RPC protocol errors (-32601 / -32602) — those never hit this
+ * module.
+ *
+ * Never attach `structuredContent` on `isError: true`: when a tool declares
+ * an `outputSchema`, the spec requires `structuredContent` to conform, and
+ * error envelopes (e.g. `{ rate_limit_reset }`) don't conform to e.g.
+ * `ActivityListResponse`.
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Narrowed `CallToolResult` for the error branch. `isError: true` per spec,
+ * text-only `content`, and no `structuredContent` (the outputSchema doesn't
+ * cover error shapes).
+ */
+export type ToolErrorResult = CallToolResult & {
+    isError: true;
+};
+/** Map any error thrown inside a tool handler to an MCP tool-error result. */
+export declare function toToolError(err: unknown): ToolErrorResult;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjE,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAUzD"}

package/dist/errors.js

@@ -0,0 +1,68 @@
+/**
+ * Maps upstream `MeertrackApiError`s into MCP tool-call results per spec
+ * §server/tools (isError semantics): upstream REST failures are **tool
+ * execution errors**, not protocol errors — the LLM needs to read them and
+ * self-correct. They go back as `{ content: [{ type: "text", text }], isError: true }`.
+ *
+ * Malformed MCP requests (unknown tool, invalid params) are handled by the
+ * SDK as JSON-RPC protocol errors (-32601 / -32602) — those never hit this
+ * module.
+ *
+ * Never attach `structuredContent` on `isError: true`: when a tool declares
+ * an `outputSchema`, the spec requires `structuredContent` to conform, and
+ * error envelopes (e.g. `{ rate_limit_reset }`) don't conform to e.g.
+ * `ActivityListResponse`.
+ */
+import { MeertrackApiError } from "./client.js";
+import { redactApiKeys } from "./auth.js";
+/** Map any error thrown inside a tool handler to an MCP tool-error result. */
+export function toToolError(err) {
+    if (err instanceof MeertrackApiError) {
+        return formatApiError(err);
+    }
+    // Defensive: a tool handler threw something that wasn't a MeertrackApiError.
+    // Don't leak stack traces to the agent — keep the message short and
+    // redacted, then return a safe-to-retry-ish generic error.
+    const message = err instanceof Error ? err.message : typeof err === "string" ? err : "Unknown error";
+    return errorResult(`Unexpected error: ${redactApiKeys(message)}`);
+}
+function formatApiError(err) {
+    const upstream = redactApiKeys(err.message);
+    if (err.status === 401) {
+        return errorResult("Invalid or revoked Meertrack API key. Mint a new one at Settings → API Keys.");
+    }
+    if (err.status === 403) {
+        // `competitor_inactive` / `forbidden_competitor` messages from upstream
+        // are already actionable ("Competitor \"x\" is deactivated. Reactivate…"),
+        // so surface them verbatim.
+        return errorResult(upstream);
+    }
+    if (err.status === 404) {
+        return errorResult("No such row in this workspace.");
+    }
+    if (err.status === 429) {
+        // Per the OpenAPI contract: trust X-RateLimit-Reset, ignore Remaining.
+        // Emit the reset in both human-readable ISO and raw epoch so the agent
+        // can parse either form.
+        const reset = err.rateLimitReset;
+        if (typeof reset === "number" && Number.isFinite(reset)) {
+            const iso = new Date(reset * 1000).toISOString();
+            return errorResult(`${upstream} Retry after ${iso} (reset=${reset}). Trust X-RateLimit-Reset; do not retry sooner.`);
+        }
+        return errorResult(`${upstream} Rate limit hit but no reset timestamp was provided; back off and retry after a minute.`);
+    }
+    if (err.status >= 500 || err.status === 0) {
+        // 0 = transport error (DNS / TCP / TLS). Same surface as 5xx for the agent.
+        return errorResult("Upstream error; safe to retry.");
+    }
+    // 400 / 422 / other 4xx — not specifically mapped. Pass the upstream
+    // message through so the agent sees what it got wrong.
+    return errorResult(`${upstream} (code=${err.code})`);
+}
+function errorResult(text) {
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAS1C,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;QACrC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,6EAA6E;IAC7E,oEAAoE;IACpE,2DAA2D;IAC3D,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC;IACvF,OAAO,WAAW,CAAC,qBAAqB,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,cAAc,CAAC,GAAsB;IAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,WAAW,CAChB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,wEAAwE;QACxE,2EAA2E;QAC3E,4BAA4B;QAC5B,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,uEAAuE;QACvE,uEAAuE;QACvE,yBAAyB;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,OAAO,WAAW,CAChB,GAAG,QAAQ,gBAAgB,GAAG,WAAW,KAAK,kDAAkD,CACjG,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAChB,GAAG,QAAQ,yFAAyF,CACrG,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,4EAA4E;QAC5E,OAAO,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACvD,CAAC;IAED,qEAAqE;IACrE,uDAAuD;IACvD,OAAO,WAAW,CAAC,GAAG,QAAQ,UAAU,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Entry point. Routes to stdio or HTTP based on argv/env:
+ *
+ *   meertrack-mcp              → stdio (default)
+ *   meertrack-mcp --http       → HTTP (Streamable)
+ *   PORT=8080 meertrack-mcp    → HTTP
+ *
+ * stdio mode resolves `MEERTRACK_API_KEY` once at startup.
+ * HTTP mode resolves bearers per request from the `Authorization` header.
+ */
+export {};
+//# 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":";AACA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Entry point. Routes to stdio or HTTP based on argv/env:
+ *
+ *   meertrack-mcp              → stdio (default)
+ *   meertrack-mcp --http       → HTTP (Streamable)
+ *   PORT=8080 meertrack-mcp    → HTTP
+ *
+ * stdio mode resolves `MEERTRACK_API_KEY` once at startup.
+ * HTTP mode resolves bearers per request from the `Authorization` header.
+ */
+import { resolveEnvApiKey } from "./auth.js";
+import { runStdio } from "./transports/stdio.js";
+import { createHttpApp, PRM_PATH, defaultProtectedResourceMetadataUrl, } from "./transports/http.js";
+const DEFAULT_ALLOWED_ORIGINS = [
+    "https://claude.ai",
+    "https://claude.com",
+    "https://cursor.sh",
+];
+async function main() {
+    const useHttp = process.argv.includes("--http") || process.env["PORT"] !== undefined;
+    if (useHttp) {
+        await startHttp();
+    }
+    else {
+        await startStdio();
+    }
+}
+async function startStdio() {
+    // Fail fast with a clear message if the env var is missing or malformed.
+    let apiKey;
+    try {
+        apiKey = resolveEnvApiKey();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[meertrack-mcp] ${message}\n`);
+        process.exit(1);
+    }
+    await runStdio({ apiKey });
+}
+async function startHttp() {
+    // Dynamic import so tests that load `./transports/http` never require
+    // `@hono/node-server` to be present.
+    const { serve } = await import("@hono/node-server");
+    const port = Number(process.env["PORT"] ?? "3000");
+    const allowedOrigins = parseAllowedOrigins(process.env["MEERTRACK_MCP_ALLOWED_ORIGINS"] ?? DEFAULT_ALLOWED_ORIGINS.join(","));
+    // Fly.io sets `FLY_APP_NAME`; on that platform the instance must bind to
+    // 0.0.0.0 so the proxy can route traffic in. Local development binds to
+    // 127.0.0.1 per MCP spec §transports (DNS rebinding protection).
+    const onFly = Boolean(process.env["FLY_APP_NAME"]);
+    const hostname = onFly ? "0.0.0.0" : "127.0.0.1";
+    const prmUrl = process.env["MEERTRACK_MCP_PRM_URL"] ??
+        defaultProtectedResourceMetadataUrl(process.env["MEERTRACK_MCP_PUBLIC_HOST"] ?? `${hostname}:${port}`, onFly ? "https" : "http");
+    const baseUrl = process.env["MEERTRACK_API_BASE_URL"];
+    const app = createHttpApp({
+        allowedOrigins,
+        protectedResourceMetadataUrl: prmUrl,
+        ...(baseUrl !== undefined ? { baseUrl } : {}),
+    });
+    serve({ fetch: app.fetch, port, hostname }, (info) => {
+        process.stderr.write(`[meertrack-mcp] http listening on http://${info.address}:${info.port} (PRM: ${prmUrl}, origins: ${allowedOrigins.length})\n`);
+        process.stderr.write(`[meertrack-mcp] routes: POST /mcp, GET ${PRM_PATH}, GET /health\n`);
+    });
+}
+function parseAllowedOrigins(value) {
+    return value
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[meertrack-mcp] fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Single-line JSON logger to stderr.
+ *
+ * Both transports use stderr for diagnostics:
+ *   - stdio: stdout is the protocol channel — anything else corrupts framing.
+ *   - http : stderr keeps logs out of HTTP responses and lines them up with
+ *            `fly logs` (Fly captures both streams; stderr is the convention).
+ *
+ * Every line is redacted with `redactApiKeys` before write — bearers must
+ * never reach disk. Keep the schema additive: consumers parse line-by-line
+ * and tolerate extra fields, so adding new keys is non-breaking.
+ */
+/** Fields the caller fills in on every log line. */
+export interface LogInput {
+    /** Logical event name — `http_request`, `stdio_start`, `tool_error`, … */
+    event: string;
+    /** Optional caller-supplied timestamp; otherwise we set it. */
+    ts?: string;
+    /** HTTP status code, when applicable. */
+    status?: number;
+    /** Wall-clock duration in milliseconds. */
+    duration_ms?: number;
+    /** JSON-RPC method extracted from the request body, if any. */
+    mcp_method?: string;
+    /** Tool name when `mcp_method === "tools/call"`. */
+    tool?: string;
+    /** `MCP-Protocol-Version` header from the request. */
+    mcp_protocol_version?: string;
+    /** Inbound `User-Agent` header. */
+    client_user_agent?: string;
+    /** Upstream `X-Request-Id`, captured from the Meertrack client when available. */
+    meertrack_request_id?: string;
+    /** Free-form message for human readers (still redacted). */
+    message?: string;
+    /** Anything else worth tagging — kept open-ended on purpose. */
+    [extra: string]: unknown;
+}
+export type LogSink = (line: string) => void;
+/** Default sink: stderr, newline-terminated. */
+export declare const defaultSink: LogSink;
+export declare class Logger {
+    private readonly sink;
+    constructor(sink?: LogSink);
+    log(record: LogInput): void;
+}
+/** Process-wide default. Tests can construct their own with a custom sink. */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7C,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,OAEzB,CAAC;AAEF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEnB,IAAI,GAAE,OAAqB;IAIvC,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;CAmB5B;AAED,8EAA8E;AAC9E,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -0,0 +1,46 @@
+/**
+ * Single-line JSON logger to stderr.
+ *
+ * Both transports use stderr for diagnostics:
+ *   - stdio: stdout is the protocol channel — anything else corrupts framing.
+ *   - http : stderr keeps logs out of HTTP responses and lines them up with
+ *            `fly logs` (Fly captures both streams; stderr is the convention).
+ *
+ * Every line is redacted with `redactApiKeys` before write — bearers must
+ * never reach disk. Keep the schema additive: consumers parse line-by-line
+ * and tolerate extra fields, so adding new keys is non-breaking.
+ */
+import { redactApiKeys } from "./auth.js";
+/** Default sink: stderr, newline-terminated. */
+export const defaultSink = (line) => {
+    process.stderr.write(line + "\n");
+};
+export class Logger {
+    sink;
+    constructor(sink = defaultSink) {
+        this.sink = sink;
+    }
+    log(record) {
+        const full = {
+            ...record,
+            ts: record.ts ?? new Date().toISOString(),
+        };
+        let serialized;
+        try {
+            serialized = JSON.stringify(full);
+        }
+        catch {
+            // Fall back to a minimal record so a single un-serializable value can't
+            // silence logging entirely.
+            serialized = JSON.stringify({
+                ts: full.ts,
+                event: full.event,
+                message: "log_serialization_failed",
+            });
+        }
+        this.sink(redactApiKeys(serialized));
+    }
+}
+/** Process-wide default. Tests can construct their own with a custom sink. */
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA8B1C,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAY,CAAC,IAAI,EAAE,EAAE;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,OAAO,MAAM;IACA,IAAI,CAAU;IAE/B,YAAY,OAAgB,WAAW;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,MAAgB;QAClB,MAAM,IAAI,GAAa;YACrB,GAAG,MAAM;YACT,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC1C,CAAC;QACF,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,4BAA4B;YAC5B,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,0BAA0B;aACpC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/prompts/competitor_deep_dive.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const COMPETITOR_DEEP_DIVE_NAME = "competitor_deep_dive";
+export declare const COMPETITOR_DEEP_DIVE_DESCRIPTION = "Full profile and recent-activity brief for one competitor. Resolves the competitor by name, pulls the full profile, and summarizes the last 30 days of detected changes.";
+export declare function registerCompetitorDeepDive(server: McpServer): void;
+//# sourceMappingURL=competitor_deep_dive.d.ts.map

package/dist/prompts/competitor_deep_dive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"competitor_deep_dive.d.ts","sourceRoot":"","sources":["../../src/prompts/competitor_deep_dive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,eAAO,MAAM,gCAAgC,6KAC+H,CAAC;AAS7K,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyClE"}

package/dist/prompts/competitor_deep_dive.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export const COMPETITOR_DEEP_DIVE_NAME = "competitor_deep_dive";
+export const COMPETITOR_DEEP_DIVE_DESCRIPTION = "Full profile and recent-activity brief for one competitor. Resolves the competitor by name, pulls the full profile, and summarizes the last 30 days of detected changes.";
+const argsSchema = {
+    competitor_name: z
+        .string()
+        .min(1)
+        .describe("Competitor display name or a distinctive substring. Case-insensitive."),
+};
+export function registerCompetitorDeepDive(server) {
+    server.registerPrompt(COMPETITOR_DEEP_DIVE_NAME, {
+        title: "Competitor deep dive",
+        description: COMPETITOR_DEEP_DIVE_DESCRIPTION,
+        argsSchema,
+    }, (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Produce a structured deep-dive brief on the competitor "${args.competitor_name}" using the Meertrack MCP server.`,
+                        "",
+                        "Step 1 — Resolve the competitor id:",
+                        "- Call `list_competitors` (no filters, default `expand=full`).",
+                        `- Find the row whose \`name\` matches "${args.competitor_name}" (case-insensitive; substring match is acceptable). If no row matches, stop and tell the user — do not guess.`,
+                        "- If several rows match, list them and ask the user to disambiguate.",
+                        "",
+                        "Step 2 — Fetch the full profile:",
+                        "- Call `get_competitor` with the resolved `id`. This returns the profile plus the most recent items from each tracked section (blog posts, pricing, job listings, messaging, logos, metrics, LinkedIn, YouTube, events, press, case studies).",
+                        "",
+                        "Step 3 — Fetch recent activity:",
+                        "- Call `list_activities` with `competitor_ids=[<id>]` and `from=<today minus 30 days, ISO 8601>`. Default `limit=50` is fine; page once if `pagination.has_more` is true.",
+                        "",
+                        "Step 4 — Synthesize the brief with these sections:",
+                        "- `## Profile` — website, category, social handles from `get_competitor`.",
+                        "- `## What's new (last 30 days)` — grouped by section; emphasize `change_type=added`.",
+                        "- `## Current positioning` — draw from `messaging`, `metrics-claimed`, and `pricing` items in the profile.",
+                        "- `## Hiring signals` — from `job-listings` if present.",
+                        "",
+                        "Rules: cite concrete items (URLs, posted dates, prices). Do not invent details not present in the tool responses. If a section has no items, say 'No data' rather than padding.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=competitor_deep_dive.js.map

package/dist/prompts/competitor_deep_dive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"competitor_deep_dive.js","sourceRoot":"","sources":["../../src/prompts/competitor_deep_dive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,gCAAgC,GAC3C,0KAA0K,CAAC;AAE7K,MAAM,UAAU,GAAG;IACjB,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uEAAuE,CAAC;CAC5E,CAAC;AAEX,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,cAAc,CACnB,yBAAyB,EACzB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gCAAgC;QAC7C,UAAU;KACX,EACD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,2DAA2D,IAAI,CAAC,eAAe,mCAAmC;wBAClH,EAAE;wBACF,qCAAqC;wBACrC,gEAAgE;wBAChE,0CAA0C,IAAI,CAAC,eAAe,gHAAgH;wBAC9K,sEAAsE;wBACtE,EAAE;wBACF,kCAAkC;wBAClC,+OAA+O;wBAC/O,EAAE;wBACF,iCAAiC;wBACjC,2KAA2K;wBAC3K,EAAE;wBACF,oDAAoD;wBACpD,2EAA2E;wBAC3E,uFAAuF;wBACvF,4GAA4G;wBAC5G,yDAAyD;wBACzD,EAAE;wBACF,iLAAiL;qBAClL,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WEEKLY_RECAP_NAME } from "./weekly_recap.js";
+import { COMPETITOR_DEEP_DIVE_NAME } from "./competitor_deep_dive.js";
+import { WHATS_NEW_NAME } from "./whats_new.js";
+/**
+ * Register all 3 prompts on `server`. Prompts surface as slash-commands in
+ * MCP-aware clients (Claude Desktop, Cursor, …) and chain the 8 tools into
+ * complete workflows without requiring the user to specify the orchestration.
+ */
+export declare function registerAllPrompts(server: McpServer): void;
+export declare const PROMPT_NAMES: readonly ["weekly_recap", "competitor_deep_dive", "whats_new"];
+export { WEEKLY_RECAP_NAME, COMPETITOR_DEEP_DIVE_NAME, WHATS_NEW_NAME };
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAuB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAEL,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAoB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAI1D;AAED,eAAO,MAAM,YAAY,gEAIf,CAAC;AAEX,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,20 @@
+import { registerWeeklyRecap, WEEKLY_RECAP_NAME } from "./weekly_recap.js";
+import { registerCompetitorDeepDive, COMPETITOR_DEEP_DIVE_NAME, } from "./competitor_deep_dive.js";
+import { registerWhatsNew, WHATS_NEW_NAME } from "./whats_new.js";
+/**
+ * Register all 3 prompts on `server`. Prompts surface as slash-commands in
+ * MCP-aware clients (Claude Desktop, Cursor, …) and chain the 8 tools into
+ * complete workflows without requiring the user to specify the orchestration.
+ */
+export function registerAllPrompts(server) {
+    registerWeeklyRecap(server);
+    registerCompetitorDeepDive(server);
+    registerWhatsNew(server);
+}
+export const PROMPT_NAMES = [
+    WEEKLY_RECAP_NAME,
+    COMPETITOR_DEEP_DIVE_NAME,
+    WHATS_NEW_NAME,
+];
+export { WEEKLY_RECAP_NAME, COMPETITOR_DEEP_DIVE_NAME, WHATS_NEW_NAME };
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,iBAAiB;IACjB,yBAAyB;IACzB,cAAc;CACN,CAAC;AAEX,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAC"}

package/dist/prompts/weekly_recap.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const WEEKLY_RECAP_NAME = "weekly_recap";
+export declare const WEEKLY_RECAP_DESCRIPTION = "One-shot 'what happened across my tracked competitors this week'. Fetches the latest digests and produces a per-competitor recap plus a cross-competitor highlights list.";
+export declare function registerWeeklyRecap(server: McpServer): void;
+//# sourceMappingURL=weekly_recap.d.ts.map

package/dist/prompts/weekly_recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly_recap.d.ts","sourceRoot":"","sources":["../../src/prompts/weekly_recap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,eAAO,MAAM,wBAAwB,8KACwI,CAAC;AAE9K,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4B3D"}