@y2-intel/mcp 0.1.0

package/dist/stream.js

@@ -0,0 +1,74 @@
+function parseJsonPayload(payload) {
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        return undefined;
+    }
+}
+function textFromObject(value) {
+    if (typeof value === "string")
+        return value;
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    if (typeof record.text === "string")
+        return record.text;
+    if (typeof record.textDelta === "string")
+        return record.textDelta;
+    if (typeof record.delta === "string")
+        return record.delta;
+    if (Array.isArray(record.choices)) {
+        return record.choices
+            .map((choice) => {
+            if (!choice || typeof choice !== "object")
+                return "";
+            const choiceRecord = choice;
+            if (typeof choiceRecord.text === "string")
+                return choiceRecord.text;
+            if (choiceRecord.delta && typeof choiceRecord.delta === "object") {
+                const delta = choiceRecord.delta;
+                return typeof delta.content === "string" ? delta.content : "";
+            }
+            return "";
+        })
+            .join("");
+    }
+    if (Array.isArray(record.content)) {
+        return record.content
+            .map((part) => {
+            if (!part || typeof part !== "object")
+                return "";
+            const partRecord = part;
+            return typeof partRecord.text === "string" ? partRecord.text : "";
+        })
+            .join("");
+    }
+    return undefined;
+}
+function textFromPayload(payload) {
+    if (!payload || payload === "[DONE]")
+        return undefined;
+    const aiSdkDataStream = payload.match(/^(\d+):(.*)$/s);
+    if (aiSdkDataStream) {
+        const [, code, encoded] = aiSdkDataStream;
+        if (code !== "0")
+            return undefined;
+        return textFromObject(parseJsonPayload(encoded));
+    }
+    return textFromObject(parseJsonPayload(payload));
+}
+export function extractAssistantTextFromStream(raw) {
+    const chunks = [];
+    for (const originalLine of raw.split(/\r?\n/)) {
+        const line = originalLine.trim();
+        if (!line || line.startsWith("event:"))
+            continue;
+        const payload = line.startsWith("data:") ? line.slice("data:".length).trim() : line;
+        const text = textFromPayload(payload);
+        if (text)
+            chunks.push(text);
+    }
+    return chunks.join("").trim();
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,16 @@
+import type { Y2McpConfig } from "./config.js";
+export declare function limitText(text: string, maxChars: number): string;
+export declare function formatJson(value: unknown, config: Y2McpConfig): string;
+export declare function textResult(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResult(error: unknown, config: Y2McpConfig): {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/text.js

@@ -0,0 +1,21 @@
+import { formatToolError } from "./errors.js";
+export function limitText(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}\n\n[truncated ${text.length - maxChars} characters]`;
+}
+export function formatJson(value, config) {
+    return limitText(JSON.stringify(value, null, 2), config.maxResponseChars);
+}
+export function textResult(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+export function errorResult(error, config) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: formatToolError(error, config) }],
+    };
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB;IACvD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,kBAAkB,IAAI,CAAC,MAAM,GAAG,QAAQ,cAAc,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,MAAmB;IAC7D,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAmB;IAC9D,OAAO;QACN,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;KAC1E,CAAC;AACH,CAAC"}

package/dist/tools/ask-agent.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Y2McpConfig } from "../config.js";
+import type { Y2Client } from "../y2-client.js";
+export declare function registerAgentTools(server: McpServer, client: Y2Client, config: Y2McpConfig): void;

package/dist/tools/ask-agent.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { errorResult, textResult } from "../text.js";
+const askAgentInput = {
+    message: z.string().min(1).max(20_000).describe("Message to send to Agent Y2."),
+    threadId: z.string().min(1).max(256).optional().describe("Existing Y2 chat thread ID."),
+    source: z.string().min(1).max(128).optional().describe("Optional integration source label."),
+    externalUserId: z.string().min(1).max(256).optional(),
+    externalThreadId: z.string().min(1).max(256).optional(),
+};
+export function registerAgentTools(server, client, config) {
+    server.tool("y2_ask_agent", "Ask Agent Y2. Requires agent:y2. Agent Y2 may use Y2 account tools and mutate resources within the API key's plan and scopes.", askAgentInput, async (input) => {
+        try {
+            const response = await client.askAgent(input);
+            return textResult([
+                response.text || "Agent Y2 returned an empty response.",
+                "",
+                `Thread ID: ${response.threadId ?? "not returned"}`,
+                `Status: ${response.status}`,
+            ].join("\n"));
+        }
+        catch (error) {
+            return errorResult(error, config);
+        }
+    });
+}
+//# sourceMappingURL=ask-agent.js.map

package/dist/tools/ask-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-agent.js","sourceRoot":"","sources":["../../src/tools/ask-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGrD,MAAM,aAAa,GAAG;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACrD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAgB,EAAE,MAAmB;IAC1F,MAAM,CAAC,IAAI,CACV,cAAc,EACd,+HAA+H,EAC/H,aAAa,EACb,KAAK,EAAE,KAAK,EAAE,EAAE;QACf,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,UAAU,CAChB;gBACC,QAAQ,CAAC,IAAI,IAAI,sCAAsC;gBACvD,EAAE;gBACF,cAAc,QAAQ,CAAC,QAAQ,IAAI,cAAc,EAAE;gBACnD,WAAW,QAAQ,CAAC,MAAM,EAAE;aAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/news.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Y2McpConfig } from "../config.js";
+import type { Y2Client } from "../y2-client.js";
+export declare function registerNewsTools(server: McpServer, client: Y2Client, config: Y2McpConfig): void;

package/dist/tools/news.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { errorResult, formatJson, textResult } from "../text.js";
+const newsInput = {
+    topics: z
+        .array(z.string().min(1).max(64))
+        .max(12)
+        .optional()
+        .describe("Optional list of Y2 news topics."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .describe("Maximum news items to return. Y2 API caps this at 200."),
+};
+export function registerNewsTools(server, client, config) {
+    server.tool("y2_list_news", "List bounded Y2 News Terminal items. Requires news:read.", newsInput, async ({ topics, limit }) => {
+        try {
+            const data = await client.requestJson("/api/v1/news", {
+                query: {
+                    limit: String(limit),
+                    ...(topics?.length ? { topics: topics.join(",") } : {}),
+                },
+            });
+            return textResult(formatJson(data, config));
+        }
+        catch (error) {
+            return errorResult(error, config);
+        }
+    });
+}
+//# sourceMappingURL=news.js.map

package/dist/tools/news.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"news.js","sourceRoot":"","sources":["../../src/tools/news.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGjE,MAAM,SAAS,GAAG;IACjB,MAAM,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAChC,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;IAC9C,KAAK,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wDAAwD,CAAC;CACpE,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAgB,EAAE,MAAmB;IACzF,MAAM,CAAC,IAAI,CACV,cAAc,EACd,0DAA0D,EAC1D,SAAS,EACT,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,cAAc,EAAE;gBACrD,KAAK,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;oBACpB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD;aACD,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/openapi.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Y2McpConfig } from "../config.js";
+import type { Y2Client } from "../y2-client.js";
+export declare function candidateOpenApiPaths(input: string): string[];
+export declare function registerOpenApiTools(server: McpServer, client: Y2Client, config: Y2McpConfig): void;

package/dist/tools/openapi.js

@@ -0,0 +1,67 @@
+import { parse } from "yaml";
+import { z } from "zod";
+import { errorResult, formatJson, textResult } from "../text.js";
+const operationInput = {
+    operationId: z.string().min(1).max(128).optional(),
+    path: z.string().min(1).max(512).optional(),
+    method: z.enum(["get", "post", "put", "patch", "delete"]).optional(),
+};
+function asRecord(value) {
+    return value && typeof value === "object" ? value : {};
+}
+function findByOperationId(openApi, operationId) {
+    const paths = asRecord(asRecord(openApi).paths);
+    for (const [path, pathItem] of Object.entries(paths)) {
+        for (const [method, operation] of Object.entries(asRecord(pathItem))) {
+            if (asRecord(operation).operationId === operationId) {
+                return { path, method, operation };
+            }
+        }
+    }
+    return undefined;
+}
+export function candidateOpenApiPaths(input) {
+    const pathname = (() => {
+        try {
+            return new URL(input).pathname;
+        }
+        catch {
+            return input.startsWith("/") ? input : `/${input}`;
+        }
+    })();
+    const candidates = [pathname];
+    if (pathname.startsWith("/api/v1/")) {
+        candidates.push(pathname.slice("/api/v1".length));
+    }
+    return [...new Set(candidates)];
+}
+function findByPath(openApi, path, method) {
+    const paths = asRecord(asRecord(openApi).paths);
+    for (const candidatePath of candidateOpenApiPaths(path)) {
+        const operation = asRecord(paths[candidatePath])[method];
+        if (operation)
+            return { path: candidatePath, method, operation };
+    }
+    return undefined;
+}
+export function registerOpenApiTools(server, client, config) {
+    server.tool("y2_get_openapi_operation", "Return one Y2 OpenAPI operation by operationId or path plus method. Does not require Y2_API_KEY.", operationInput, async ({ operationId, path, method }) => {
+        try {
+            if (!operationId && (!path || !method)) {
+                throw new Error("Provide operationId or both path and method.");
+            }
+            const spec = parse(await client.fetchDocsText("/api/openapi.yaml"));
+            const operation = operationId
+                ? findByOperationId(spec, operationId)
+                : findByPath(spec, path ?? "", method ?? "");
+            if (!operation) {
+                throw new Error("OpenAPI operation not found.");
+            }
+            return textResult(formatJson(operation, config));
+        }
+        catch (error) {
+            return errorResult(error, config);
+        }
+    });
+}
+//# sourceMappingURL=openapi.js.map

package/dist/tools/openapi.js.map

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

package/dist/tools/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;

package/dist/tools/prompts.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+export function registerPrompts(server) {
+    server.prompt("integrate-y2-api", { task: z.string().optional() }, ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Integrate the Y2 API into this codebase.",
+                        "Read y2://docs/index, y2://quickstart, and y2://openapi first.",
+                        "Keep Y2_API_KEY server-side or in local MCP environment only.",
+                        "Choose the narrowest scopes needed and handle 401, 402, 403, 429, and 5xx.",
+                        task ? `Task: ${task}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("ask-y2-brief", { topic: z.string().min(1).max(256) }, ({ topic }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Ask Agent Y2 for a concise intelligence brief about: ${topic}`,
+                },
+            },
+        ],
+    }));
+    server.prompt("debug-y2-api-call", { statusCode: z.string().optional(), endpoint: z.string().optional() }, ({ statusCode, endpoint }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Debug this Y2 API integration before guessing.",
+                        "Check endpoint, method, scopes, API key placement, status code, rate-limit headers, and response body.",
+                        endpoint ? `Endpoint: ${endpoint}` : "",
+                        statusCode ? `Status code: ${statusCode}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/tools/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAChD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACjF,QAAQ,EAAE;YACT;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACL,0CAA0C;wBAC1C,gEAAgE;wBAChE,+DAA+D;wBAC/D,4EAA4E;wBAC5E,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;qBAC3B;yBACC,MAAM,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,IAAI,CAAC;iBACZ;aACD;SACD;KACD,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACpF,QAAQ,EAAE;YACT;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wDAAwD,KAAK,EAAE;iBACrE;aACD;SACD;KACD,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,MAAM,CACZ,mBAAmB,EACnB,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EACtE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE;YACT;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACL,gDAAgD;wBAChD,wGAAwG;wBACxG,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;wBACvC,UAAU,CAAC,CAAC,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;qBAC9C;yBACC,MAAM,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,IAAI,CAAC;iBACZ;aACD;SACD;KACD,CAAC,CACF,CAAC;AACH,CAAC"}

package/dist/tools/reports.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Y2McpConfig } from "../config.js";
+import type { Y2Client } from "../y2-client.js";
+export declare function registerReportTools(server: McpServer, client: Y2Client, config: Y2McpConfig): void;

package/dist/tools/reports.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { errorResult, formatJson, textResult } from "../text.js";
+const listReportsInput = {
+    profileId: z.string().min(1).max(256).optional(),
+    limit: z.number().int().min(1).max(5).default(5),
+};
+const getReportInput = {
+    reportId: z.string().min(1).max(256),
+};
+export function registerReportTools(server, client, config) {
+    server.tool("y2_list_reports", "List recent Y2 reports. Requires reports:read.", listReportsInput, async ({ profileId, limit }) => {
+        try {
+            const data = await client.requestJson("/api/v1/reports", {
+                query: {
+                    limit: String(limit),
+                    ...(profileId ? { profileId } : {}),
+                },
+            });
+            return textResult(formatJson(data, config));
+        }
+        catch (error) {
+            return errorResult(error, config);
+        }
+    });
+    server.tool("y2_get_report", "Get one Y2 report by ID. Requires reports:read.", getReportInput, async ({ reportId }) => {
+        try {
+            const data = await client.requestJson(`/api/v1/reports/${encodeURIComponent(reportId)}`);
+            return textResult(formatJson(data, config));
+        }
+        catch (error) {
+            return errorResult(error, config);
+        }
+    });
+}
+//# sourceMappingURL=reports.js.map

package/dist/tools/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../src/tools/reports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGjE,MAAM,gBAAgB,GAAG;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,cAAc,GAAG;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACpC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAgB,EAAE,MAAmB;IAC3F,MAAM,CAAC,IAAI,CACV,iBAAiB,EACjB,gDAAgD,EAChD,gBAAgB,EAChB,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,iBAAiB,EAAE;gBACxD,KAAK,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;oBACpB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnC;aACD,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC,CACD,CAAC;IAEF,MAAM,CAAC,IAAI,CACV,eAAe,EACf,iDAAiD,EACjD,cAAc,EACd,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,mBAAmB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzF,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/y2-client.d.ts

@@ -0,0 +1,32 @@
+import type { Y2McpConfig } from "./config.js";
+type Query = Record<string, string | undefined>;
+type RequestOptions = {
+    method?: string;
+    query?: Query;
+    body?: unknown;
+    auth?: boolean;
+};
+export type AskAgentInput = {
+    message: string;
+    threadId?: string;
+    source?: string;
+    externalUserId?: string;
+    externalThreadId?: string;
+};
+export type AskAgentResponse = {
+    text: string;
+    threadId: string | null;
+    status: number;
+};
+export declare class Y2Client {
+    #private;
+    constructor(config: Y2McpConfig);
+    fetchDocsText(path: string): Promise<string>;
+    requestJson(path: string, options?: RequestOptions): Promise<unknown>;
+    askAgent(input: AskAgentInput): Promise<AskAgentResponse>;
+    request(path: string, options?: RequestOptions): Promise<Response>;
+    fetch(url: URL, init: RequestInit): Promise<Response>;
+    readOkText(response: Response): Promise<string>;
+    throwIfNotOk(response: Response): Promise<void>;
+}
+export {};

package/dist/y2-client.js

@@ -0,0 +1,144 @@
+import { requireApiKey } from "./config.js";
+import { Y2ApiError } from "./errors.js";
+import { extractAssistantTextFromStream } from "./stream.js";
+function appendQuery(url, query) {
+    if (!query)
+        return;
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined)
+            url.searchParams.set(key, value);
+    }
+}
+function buildUrl(baseUrl, path, query) {
+    const url = new URL(path, `${baseUrl}/`);
+    appendQuery(url, query);
+    return url;
+}
+async function responseText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "";
+    }
+}
+function errorMessageFromBody(body) {
+    if (!body)
+        return { message: "Request failed." };
+    try {
+        const json = JSON.parse(body);
+        const message = typeof json.message === "string"
+            ? json.message
+            : typeof json.error === "string"
+                ? json.error
+                : typeof json.error?.message === "string"
+                    ? json.error.message
+                    : body;
+        const code = typeof json.code === "string"
+            ? json.code
+            : typeof json.error?.code === "string"
+                ? json.error.code
+                : undefined;
+        return { message, code };
+    }
+    catch {
+        return { message: body };
+    }
+}
+export class Y2Client {
+    #config;
+    constructor(config) {
+        this.#config = config;
+    }
+    async fetchDocsText(path) {
+        const response = await this.fetch(buildUrl(this.#config.docsBaseUrl, path), {
+            method: "GET",
+        });
+        return await this.readOkText(response);
+    }
+    async requestJson(path, options = {}) {
+        const response = await this.request(path, options);
+        const text = await responseText(response);
+        if (!text)
+            return null;
+        return JSON.parse(text);
+    }
+    async askAgent(input) {
+        const body = {
+            messages: [
+                {
+                    role: "user",
+                    parts: [{ type: "text", text: input.message }],
+                },
+            ],
+            ...(input.threadId ? { threadId: input.threadId } : {}),
+            ...(input.source || input.externalUserId || input.externalThreadId
+                ? {
+                    metadata: {
+                        ...(input.source ? { source: input.source } : {}),
+                        ...(input.externalUserId ? { externalUserId: input.externalUserId } : {}),
+                        ...(input.externalThreadId ? { externalThreadId: input.externalThreadId } : {}),
+                    },
+                }
+                : {}),
+        };
+        const response = await this.request("/api/v1/agent-y2/chat/stream", {
+            method: "POST",
+            body,
+        });
+        const raw = await responseText(response);
+        return {
+            text: extractAssistantTextFromStream(raw),
+            threadId: response.headers.get("x-thread-id"),
+            status: response.status,
+        };
+    }
+    async request(path, options = {}) {
+        const headers = new Headers();
+        headers.set("Accept", "application/json, text/event-stream, text/plain");
+        if (options.auth !== false) {
+            headers.set("Authorization", `Bearer ${requireApiKey(this.#config)}`);
+        }
+        if (options.body !== undefined)
+            headers.set("Content-Type", "application/json");
+        const response = await this.fetch(buildUrl(this.#config.apiBaseUrl, path, options.query), {
+            method: options.method ?? (options.body === undefined ? "GET" : "POST"),
+            headers,
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+        });
+        await this.throwIfNotOk(response);
+        return response;
+    }
+    async fetch(url, init) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.#config.timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`Y2 request timed out after ${this.#config.timeoutMs}ms.`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async readOkText(response) {
+        await this.throwIfNotOk(response);
+        return await responseText(response);
+    }
+    async throwIfNotOk(response) {
+        if (response.ok)
+            return;
+        const body = await responseText(response);
+        const { message, code } = errorMessageFromBody(body);
+        throw new Y2ApiError(message, {
+            status: response.status,
+            code,
+            retryAfter: response.headers.get("retry-after") ?? undefined,
+        });
+    }
+}
+//# sourceMappingURL=y2-client.js.map

package/dist/y2-client.js.map

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

package/examples/claude-code.md

@@ -0,0 +1,22 @@
+# Claude Code
+
+Install the Y2 MCP server as a local stdio server:
+
+```sh
+export Y2_API_KEY=y2_...
+
+claude mcp add --env Y2_API_KEY=$Y2_API_KEY --transport stdio y2 \
+  -- npx -y @y2-intel/mcp
+```
+
+Use a dedicated Y2 API key for Claude Code. Add only the scopes needed by the
+tools you expect to use:
+
+- `reports:read` for report tools
+- `news:read` for News Terminal tools
+
+Agent Y2 is disabled by default. To expose `y2_ask_agent`, use a key with
+`agent:y2` and add `--env Y2_MCP_ENABLE_AGENT=1` to the `claude mcp add`
+command.
+
+Do not paste `Y2_API_KEY` into prompts.

package/examples/claude-desktop.json

@@ -0,0 +1,12 @@
+{
+	"mcpServers": {
+		"y2": {
+			"command": "npx",
+			"args": ["-y", "@y2-intel/mcp"],
+			"env": {
+				"Y2_API_KEY": "y2_...",
+				"Y2_MCP_ENABLE_AGENT": "0"
+			}
+		}
+	}
+}