@sharpe-terminal/mcp-server 1.4.0 → 1.6.0

package/dist/contracts/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/contracts/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsCH,sGAAsG;AACtG,MAAM,CAAC,MAAM,QAAQ,GAAkB,IAAI,CAAC,KAAK,CAAC,o56YAAo56Y,CAAkB,CAAC"}

package/dist/endpoint-tools.d.ts

@@ -0,0 +1,107 @@
+/**
+ * The endpoint tools, built from the agent manifest (WP-U12, design L6-D1 §3.1): one tool per contract with an agent
+ * block, named, described, validated and routed by src/contracts through the synced manifest
+ * (./contracts/manifest.ts, scripts/contracts/sync-packages.ts). Nothing here names an endpoint's path or re-types a
+ * parameter; the Python server (packages/mcp-server-python/server.py) implements the same steps over the same
+ * document, and scripts/contracts/parity.ts proves the two answer alike.
+ *
+ * A call: check the arguments against the tool's input schema, fill its defaults, pick the route (v1 with a key, the
+ * free twin without one), and answer `{ data, pagination?, meta }`: `data` as the route served it, `meta` what the API
+ * said about its freshness and what the client cut to fit the context window.
+ *
+ * Three client rules remain, each declared below with the change that retires it: a default page for two tools
+ * (REQUEST_DEFAULTS), paging for four free twins that ignore limit/cursor (KEYLESS_PAGING), and the oi-snapshot
+ * reading per exchange the futures contract promises (LATEST_PER_EXCHANGE).
+ */
+import { type ApiCaller, type DataFreshness, type RawAnswer } from "./api-client.ts";
+import { type JsonSchema, type ManifestTool } from "./contracts/manifest.ts";
+export declare const ENDPOINT_TOOLS: readonly ManifestTool[];
+export declare function endpointTool(name: string): ManifestTool;
+/** The v1 route and the route a keyless call reads (the free twin, or v1 when there is none). */
+export declare function toolRoutes(tool: ManifestTool): {
+    apiPath: string;
+    fallbackPath: string;
+};
+/**
+ * Arguments a tool sends when the caller left them out, unless one of `unlessPresent` was given or an argument equals
+ * a value in `unlessEqual`. Retire into the contract's agent block (a declared agent default) at the next
+ * src/contracts change:
+ * - get_funding_rates: the unpaged book is ~13,000 rows (6 MB) of which MAX_ITEMS survive; one page comes with a
+ *   cursor (0.3 s instead of 1.8 s, 2026-09-26). A coin, history or an aggregate answers small, and an aggregate
+ *   refuses a page.
+ * - get_gem_finder: a keyed call pages at 100 as a keyless one does (KEYLESS_PAGING).
+ */
+export declare const REQUEST_DEFAULTS: Readonly<Record<string, {
+    set: Readonly<Record<string, string | number | boolean>>;
+    unlessPresent: readonly string[];
+    unlessEqual?: Readonly<Record<string, string>>;
+}>>;
+/**
+ * Free twins that ignore `limit`/`cursor` although v1 pages (their routes read only tab, type/symbol/venue/days,
+ * chart/coin/timeframe/exchanges, nothing): a keyless call with `limit` pages the rows the free body holds with v1's
+ * cursor, so a keyless agent reaches every row. `rows` is where the body holds them ("" = the body is the array);
+ * `answer` is "rows" when the page is the answer (v1's paged shape), "body" when the body keeps its other fields.
+ * Retire when the free routes read limit/cursor (L5) and their contracts declare `public.query`.
+ */
+export declare const KEYLESS_PAGING: Readonly<Record<string, {
+    rows: string;
+    answer: "rows" | "body";
+    cursor: "offset" | "snapshot";
+    snapshotField?: string;
+}>>;
+/**
+ * get_futures_data's contract promises "Without limit, oi-snapshot returns each exchange's latest reading", while both
+ * routes answer the whole ascending window (up to 5,000 raw rows): without `limit`, the client keeps each exchange's
+ * newest row, largest open interest first. Retire when the route serves the snapshot itself.
+ */
+export declare const LATEST_PER_EXCHANGE: Readonly<Record<string, {
+    when: Readonly<Record<string, string>>;
+    rows: string;
+}>>;
+export declare class ToolInputError extends Error {
+}
+type Scalar = string | number | boolean;
+/** Why a value breaks its property schema, or null. The Python server words each issue the same way. */
+export declare function propertyIssue(name: string, value: unknown, schema: JsonSchema): string | null;
+/**
+ * The wire arguments of a call, checked against the tool's input schema and completed with its defaults, in the
+ * schema's order. `null` stands for an argument left out. Throws ToolInputError naming every issue.
+ */
+export declare function prepareArguments(tool: ManifestTool, args: Record<string, unknown>): Record<string, Scalar>;
+/** The query string values: JSON numbers as JavaScript prints them, booleans as `true` / `false`. */
+export declare function queryOf(args: Record<string, Scalar>): Record<string, string>;
+export interface Page {
+    cursor: string | null;
+    has_more: boolean;
+    total: number | null;
+}
+/** Each exchange's newest row, largest open interest first. */
+export declare function latestRowPerExchange(rows: unknown[]): unknown[];
+export interface ToolResultMeta {
+    route: "v1" | "public";
+    dataset_id?: string;
+    as_of?: string | null;
+    stale_after?: string | null;
+    freshness_status?: DataFreshness["freshness_status"];
+    runtime_status?: DataFreshness["runtime_status"];
+    served_from?: string;
+    warnings: string[];
+    truncated?: true;
+    truncated_fields?: Record<string, {
+        total: number;
+        showing: number;
+        kept?: "latest";
+    }>;
+    truncation_message?: string;
+}
+export interface ToolResult {
+    data: unknown;
+    pagination?: Page;
+    meta: ToolResultMeta;
+}
+/** The answer of a route turned into the tool result (no I/O; the parity harness and the tests call it too). */
+export declare function toolResult(tool: ManifestTool, args: Record<string, Scalar>, answer: RawAnswer): ToolResult;
+/** Calls an endpoint tool: validated arguments, the route the key picks, the result. */
+export declare function callEndpointTool(tool: ManifestTool, args: Record<string, unknown>, callApi: ApiCaller): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=endpoint-tools.d.ts.map

package/dist/endpoint-tools.d.ts.map

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

package/dist/endpoint-tools.js

@@ -0,0 +1,382 @@
+/**
+ * The endpoint tools, built from the agent manifest (WP-U12, design L6-D1 §3.1): one tool per contract with an agent
+ * block, named, described, validated and routed by src/contracts through the synced manifest
+ * (./contracts/manifest.ts, scripts/contracts/sync-packages.ts). Nothing here names an endpoint's path or re-types a
+ * parameter; the Python server (packages/mcp-server-python/server.py) implements the same steps over the same
+ * document, and scripts/contracts/parity.ts proves the two answer alike.
+ *
+ * A call: check the arguments against the tool's input schema, fill its defaults, pick the route (v1 with a key, the
+ * free twin without one), and answer `{ data, pagination?, meta }`: `data` as the route served it, `meta` what the API
+ * said about its freshness and what the client cut to fit the context window.
+ *
+ * Three client rules remain, each declared below with the change that retires it: a default page for two tools
+ * (REQUEST_DEFAULTS), paging for four free twins that ignore limit/cursor (KEYLESS_PAGING), and the oi-snapshot
+ * reading per exchange the futures contract promises (LATEST_PER_EXCHANGE).
+ */
+import { freshnessFromHeaders, freshnessFromMeta, headerPagination, } from "./api-client.js";
+import { MANIFEST, } from "./contracts/manifest.js";
+import { MAX_ITEMS, TRUNCATION_MESSAGE, capToContext, rowTimeMs, } from "./tool-runtime.js";
+export const ENDPOINT_TOOLS = MANIFEST.tools;
+const TOOLS_BY_NAME = new Map(ENDPOINT_TOOLS.map((tool) => [tool.name, tool]));
+export function endpointTool(name) {
+    const tool = TOOLS_BY_NAME.get(name);
+    if (tool === undefined)
+        throw new Error(`No endpoint tool ${name}`);
+    return tool;
+}
+/** The v1 route and the route a keyless call reads (the free twin, or v1 when there is none). */
+export function toolRoutes(tool) {
+    const apiPath = tool.routes.v1 ?? tool.routes.public;
+    if (apiPath === null)
+        throw new Error(`${tool.name} has no route`);
+    return { apiPath, fallbackPath: tool.routes.public ?? apiPath };
+}
+// ── Declared client rules (identical in server.py; pinned by scripts/contracts/parity.ts) ──
+/**
+ * Arguments a tool sends when the caller left them out, unless one of `unlessPresent` was given or an argument equals
+ * a value in `unlessEqual`. Retire into the contract's agent block (a declared agent default) at the next
+ * src/contracts change:
+ * - get_funding_rates: the unpaged book is ~13,000 rows (6 MB) of which MAX_ITEMS survive; one page comes with a
+ *   cursor (0.3 s instead of 1.8 s, 2026-09-26). A coin, history or an aggregate answers small, and an aggregate
+ *   refuses a page.
+ * - get_gem_finder: a keyed call pages at 100 as a keyless one does (KEYLESS_PAGING).
+ */
+export const REQUEST_DEFAULTS = {
+    get_funding_rates: {
+        set: { limit: MAX_ITEMS },
+        unlessPresent: ["limit", "cursor", "coin", "extremes", "stats", "summary"],
+        unlessEqual: { type: "history" },
+    },
+    get_gem_finder: { set: { limit: 100 }, unlessPresent: ["limit"] },
+};
+/**
+ * Free twins that ignore `limit`/`cursor` although v1 pages (their routes read only tab, type/symbol/venue/days,
+ * chart/coin/timeframe/exchanges, nothing): a keyless call with `limit` pages the rows the free body holds with v1's
+ * cursor, so a keyless agent reaches every row. `rows` is where the body holds them ("" = the body is the array);
+ * `answer` is "rows" when the page is the answer (v1's paged shape), "body" when the body keeps its other fields.
+ * Retire when the free routes read limit/cursor (L5) and their contracts declare `public.query`.
+ */
+export const KEYLESS_PAGING = {
+    get_global_overview: { rows: "rows", answer: "rows", cursor: "offset" },
+    get_rwa_perp_funding: { rows: "", answer: "rows", cursor: "offset" },
+    get_futures_data: { rows: "data", answer: "body", cursor: "offset" },
+    get_gem_finder: {
+        rows: "coins",
+        answer: "rows",
+        cursor: "snapshot",
+        snapshotField: "updatedAt",
+    },
+};
+/**
+ * get_futures_data's contract promises "Without limit, oi-snapshot returns each exchange's latest reading", while both
+ * routes answer the whole ascending window (up to 5,000 raw rows): without `limit`, the client keeps each exchange's
+ * newest row, largest open interest first. Retire when the route serves the snapshot itself.
+ */
+export const LATEST_PER_EXCHANGE = {
+    get_futures_data: { when: { chart: "oi-snapshot" }, rows: "data" },
+};
+// ── Arguments ──
+export class ToolInputError extends Error {
+}
+function propertiesOf(schema) {
+    const properties = schema.properties;
+    return properties && typeof properties === "object"
+        ? properties
+        : {};
+}
+function describeType(type) {
+    return type === "integer"
+        ? "an integer"
+        : type === "number"
+            ? "a number"
+            : type === "boolean"
+                ? "a boolean"
+                : "a string";
+}
+/** Why a value breaks its property schema, or null. The Python server words each issue the same way. */
+export function propertyIssue(name, value, schema) {
+    const type = schema.type;
+    const typeOk = type === "integer"
+        ? typeof value === "number" && Number.isInteger(value)
+        : type === "number"
+            ? typeof value === "number" && Number.isFinite(value)
+            : type === "boolean"
+                ? typeof value === "boolean"
+                : typeof value === "string";
+    if (!typeOk)
+        return `"${name}" must be ${describeType(type)}`;
+    if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        return `"${name}" must be one of: ${schema.enum.join(", ")}`;
+    }
+    if (typeof value === "number") {
+        if (typeof schema.minimum === "number" && value < schema.minimum) {
+            return `"${name}" must be >= ${schema.minimum}`;
+        }
+        if (typeof schema.maximum === "number" && value > schema.maximum) {
+            return `"${name}" must be <= ${schema.maximum}`;
+        }
+        if (typeof schema.exclusiveMinimum === "number" &&
+            value <= schema.exclusiveMinimum) {
+            return `"${name}" must be > ${schema.exclusiveMinimum}`;
+        }
+        if (typeof schema.exclusiveMaximum === "number" &&
+            value >= schema.exclusiveMaximum) {
+            return `"${name}" must be < ${schema.exclusiveMaximum}`;
+        }
+    }
+    if (typeof value === "string") {
+        const length = [...value].length;
+        if (typeof schema.minLength === "number" && length < schema.minLength) {
+            return `"${name}" must be at least ${schema.minLength} characters`;
+        }
+        if (typeof schema.maxLength === "number" && length > schema.maxLength) {
+            return `"${name}" must be at most ${schema.maxLength} characters`;
+        }
+    }
+    return null;
+}
+/**
+ * The wire arguments of a call, checked against the tool's input schema and completed with its defaults, in the
+ * schema's order. `null` stands for an argument left out. Throws ToolInputError naming every issue.
+ */
+export function prepareArguments(tool, args) {
+    const properties = propertiesOf(tool.input_schema);
+    const issues = [];
+    for (const name of Object.keys(args)) {
+        if (!(name in properties))
+            issues.push(`unknown argument "${name}"`);
+    }
+    const required = Array.isArray(tool.input_schema.required)
+        ? tool.input_schema.required
+        : [];
+    const out = {};
+    for (const [name, schema] of Object.entries(properties)) {
+        const given = args[name];
+        if (given === undefined || given === null) {
+            if (required.includes(name))
+                issues.push(`"${name}" is required`);
+            else if (schema.default !== undefined)
+                out[name] = schema.default;
+            continue;
+        }
+        const issue = propertyIssue(name, given, schema);
+        if (issue !== null)
+            issues.push(issue);
+        else
+            out[name] = given;
+    }
+    if (issues.length > 0) {
+        throw new ToolInputError(`Invalid arguments for ${tool.name}: ${issues.join("; ")}`);
+    }
+    const rule = REQUEST_DEFAULTS[tool.name];
+    if (rule !== undefined &&
+        !rule.unlessPresent.some((name) => name in args && args[name] != null) &&
+        !Object.entries(rule.unlessEqual ?? {}).some(([name, value]) => out[name] === value)) {
+        for (const [name, value] of Object.entries(rule.set))
+            out[name] = value;
+    }
+    return out;
+}
+/** The query string values: JSON numbers as JavaScript prints them, booleans as `true` / `false`. */
+export function queryOf(args) {
+    return Object.fromEntries(Object.entries(args).map(([name, value]) => [name, String(value)]));
+}
+// ── Paging a free body ──
+function encodeOffset(offset) {
+    return Buffer.from(String(offset)).toString("base64url");
+}
+function decodeOffset(cursor) {
+    const decoded = /^[A-Za-z0-9_-]+$/.test(cursor)
+        ? Buffer.from(cursor, "base64url").toString("utf8")
+        : "";
+    if (!/^\d+$/.test(decoded))
+        throw new Error("Invalid pagination cursor.");
+    return Number(decoded);
+}
+function encodeSnapshot(snapshot, offset) {
+    return Buffer.from(JSON.stringify({ version: 1, snapshot, offset })).toString("base64url");
+}
+function decodeSnapshot(cursor, snapshot) {
+    let payload;
+    try {
+        payload = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    }
+    catch {
+        throw new Error("Invalid pagination cursor.");
+    }
+    if (!payload ||
+        payload.version !== 1 ||
+        typeof payload.snapshot !== "string" ||
+        payload.snapshot === "" ||
+        typeof payload.offset !== "number" ||
+        !Number.isInteger(payload.offset) ||
+        payload.offset < 0) {
+        throw new Error("Invalid pagination cursor.");
+    }
+    if (payload.snapshot !== snapshot) {
+        throw new Error("The pagination cursor belongs to an expired snapshot. Restart without a cursor.");
+    }
+    return payload.offset;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function rowsAt(body, path) {
+    const value = path === "" ? body : isRecord(body) ? body[path] : undefined;
+    return Array.isArray(value) ? value : null;
+}
+function pageFreeBody(toolName, body, args) {
+    const rule = KEYLESS_PAGING[toolName];
+    if (rule === undefined || typeof args.limit !== "number")
+        return null;
+    const rows = rowsAt(body, rule.rows);
+    if (rows === null)
+        return null;
+    const cursor = typeof args.cursor === "string" ? args.cursor : null;
+    const snapshot = rule.cursor === "snapshot" && isRecord(body)
+        ? typeof body[rule.snapshotField ?? ""] === "string" &&
+            body[rule.snapshotField ?? ""] !== ""
+            ? body[rule.snapshotField ?? ""]
+            : "empty-snapshot"
+        : "";
+    const offset = cursor === null
+        ? 0
+        : rule.cursor === "snapshot"
+            ? decodeSnapshot(cursor, snapshot)
+            : decodeOffset(cursor);
+    const next = offset + args.limit;
+    const hasMore = next < rows.length;
+    const page = rows.slice(offset, next);
+    const pagination = {
+        cursor: hasMore
+            ? rule.cursor === "snapshot"
+                ? encodeSnapshot(snapshot, next)
+                : encodeOffset(next)
+            : null,
+        has_more: hasMore,
+        total: rows.length,
+    };
+    if (rule.answer === "rows" || rule.rows === "") {
+        return { data: page, pagination };
+    }
+    return { data: { ...body, [rule.rows]: page }, pagination };
+}
+/** Each exchange's newest row, largest open interest first. */
+export function latestRowPerExchange(rows) {
+    const latest = new Map();
+    for (const row of rows) {
+        const at = rowTimeMs(row);
+        if (!isRecord(row) || at == null)
+            continue;
+        const exchange = String(row.exchange ?? "");
+        const prev = latest.get(exchange);
+        if (!prev || at >= prev.at)
+            latest.set(exchange, { row, at });
+    }
+    const oiOf = (row) => {
+        const value = row.open_interest_value;
+        return typeof value === "number" && Number.isFinite(value)
+            ? value
+            : Number.NEGATIVE_INFINITY;
+    };
+    return [...latest.values()]
+        .map((entry) => entry.row)
+        .sort((a, b) => oiOf(b) - oiOf(a));
+}
+function reduceToLatest(toolName, data, args) {
+    const rule = LATEST_PER_EXCHANGE[toolName];
+    if (rule === undefined ||
+        "limit" in args ||
+        !Object.entries(rule.when).every(([name, value]) => args[name] === value)) {
+        return data;
+    }
+    const rows = rowsAt(data, rule.rows);
+    return rows === null || !isRecord(data)
+        ? data
+        : { ...data, [rule.rows]: latestRowPerExchange(rows) };
+}
+function isPage(value) {
+    return isRecord(value) && typeof value.has_more === "boolean";
+}
+/** The answer of a route turned into the tool result (no I/O; the parity harness and the tests call it too). */
+export function toolResult(tool, args, answer) {
+    const { route, body, headers } = answer;
+    let data;
+    let pagination;
+    let freshness;
+    if (route === "v1" && isRecord(body) && "data" in body) {
+        data = body.data;
+        if (isPage(body.pagination))
+            pagination = body.pagination;
+        freshness = freshnessFromMeta(body.meta) ?? freshnessFromHeaders(headers);
+    }
+    else {
+        data = body;
+        if (Array.isArray(body)) {
+            pagination = headerPagination(headers) ?? undefined;
+        }
+        freshness =
+            (isRecord(body) ? freshnessFromMeta(body.meta) : null) ??
+                freshnessFromHeaders(headers);
+    }
+    const warnings = [...(freshness?.warnings ?? [])];
+    if (route === "public" && pagination === undefined) {
+        const paged = pageFreeBody(tool.name, data, args);
+        if (paged !== null) {
+            data = paged.data;
+            pagination = paged.pagination;
+        }
+    }
+    if (route === "public" && tool.public_params !== null) {
+        const read = new Set([
+            ...tool.public_params,
+            ...(KEYLESS_PAGING[tool.name] ? ["limit", "cursor"] : []),
+        ]);
+        const ignored = Object.keys(args).filter((name) => !read.has(name));
+        if (ignored.length > 0) {
+            warnings.push(`The free route ignores ${ignored.join(", ")}; set an API key (the free tier works) for the v1 route, which reads them.`);
+        }
+    }
+    if (pagination === undefined)
+        data = reduceToLatest(tool.name, data, args);
+    const capped = capToContext(data);
+    const meta = { route, warnings };
+    if (freshness !== null) {
+        if (freshness.dataset_id !== undefined)
+            meta.dataset_id = freshness.dataset_id;
+        meta.as_of = freshness.as_of;
+        meta.stale_after = freshness.stale_after;
+        meta.freshness_status = freshness.freshness_status;
+        meta.runtime_status = freshness.runtime_status;
+        if (freshness.served_from !== undefined) {
+            meta.served_from = freshness.served_from;
+        }
+        if (freshness.truncated)
+            meta.truncated = true;
+    }
+    if (Object.keys(capped.fields).length > 0) {
+        meta.truncated = true;
+        meta.truncated_fields = capped.fields;
+        meta.truncation_message = TRUNCATION_MESSAGE;
+    }
+    return {
+        data: capped.data,
+        ...(pagination === undefined ? {} : { pagination }),
+        meta,
+    };
+}
+/** Calls an endpoint tool: validated arguments, the route the key picks, the result. */
+export async function callEndpointTool(tool, args, callApi) {
+    const prepared = prepareArguments(tool, args);
+    const { apiPath, fallbackPath } = toolRoutes(tool);
+    const query = queryOf(prepared);
+    const answer = callApi.raw
+        ? await callApi.raw(apiPath, fallbackPath, query)
+        : {
+            route: "v1",
+            body: await callApi(apiPath, fallbackPath, query),
+            headers: new Headers(),
+        };
+    return toolResult(tool, prepared, answer);
+}
+//# sourceMappingURL=endpoint-tools.js.map

package/dist/endpoint-tools.js.map

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

package/dist/server.d.ts

@@ -2,8 +2,16 @@
  * The Sharpe MCP server, independent of transport: the stdio entry point
  * (index.ts) and the hosted Streamable HTTP endpoint (/api/mcp on
  * www.sharpe.ai) both build their server here, so the two cannot drift.
+ *
+ * Endpoint tools are data (WP-U12): tools/list serves each one's name, title,
+ * description and input JSON Schema (and its output schema, when the manifest
+ * publishes them) exactly as the synced agent manifest renders them from
+ * src/contracts (endpoint-tools.ts), and the Python server serves the same
+ * document. The three composite tools format several
+ * endpoints into one report and keep their own schemas.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type CallToolResult, type Tool } from "@modelcontextprotocol/sdk/types.js";
 import type { ApiCaller } from "./api-client.ts";
 export interface SharpeMcpServerOptions {
     /** Performs the API calls: v1 with a key, the free routes without one. */
@@ -11,5 +19,17 @@ export interface SharpeMcpServerOptions {
     /** Reported as serverInfo.version. */
     version: string;
 }
+interface CompositeTool {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Tool["inputSchema"];
+    run: (callApi: ApiCaller, args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+/** The composite tools: several endpoints, one markdown report (U13 serves them as endpoints). */
+export declare const COMPOSITE_TOOLS: readonly CompositeTool[];
+/** tools/list: the endpoint tools as the manifest renders them, then the composites. */
+export declare function listTools(): Tool[];
 export declare function createSharpeMcpServer(options: SharpeMcpServerOptions): McpServer;
+export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwBjD,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,OAAO,EAAE,SAAS,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAqCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAmThF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,IAAI,EACV,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA0BjD,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,OAAO,EAAE,SAAS,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAkDD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,GAAG,EAAE,CACH,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9B;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAwCnD,CAAC;AAIF,wFAAwF;AACxF,wBAAgB,SAAS,IAAI,IAAI,EAAE,CAyBlC;AA0BD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,SAAS,CAqNX"}