@silverpoint/mcp 0.0.0-stage → 0.8.0

package/dist/http.d.ts

@@ -0,0 +1,7 @@
+import { S as ServerOptions } from './server-BXBjhMwX.js';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+
+declare const BODY_LIMIT: number;
+declare function handler(request: Request, options?: ServerOptions): Promise<Response>;
+
+export { BODY_LIMIT, handler };

package/dist/http.js

@@ -0,0 +1,71 @@
+import { LIMITS, createServer } from './chunk-NUDC553W.js';
+import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+
+var BODY_LIMIT = LIMITS.body;
+var CORS = {
+  "access-control-allow-origin": "*",
+  "access-control-allow-methods": "POST, OPTIONS",
+  "access-control-allow-headers": "content-type, accept, mcp-protocol-version, mcp-session-id, last-event-id",
+  "access-control-expose-headers": "mcp-session-id, mcp-protocol-version",
+  "access-control-max-age": "86400"
+};
+function withCors(response) {
+  const headers = new Headers(response.headers);
+  for (const [name, value] of Object.entries(CORS)) headers.set(name, value);
+  return new Response(response.body, { status: response.status, statusText: response.statusText, headers });
+}
+function rpcError(status, code, message, extra = {}) {
+  return new Response(JSON.stringify({ jsonrpc: "2.0", error: { code, message }, id: null }), {
+    status,
+    headers: { "content-type": "application/json", ...CORS, ...extra }
+  });
+}
+async function boundedText(request) {
+  if (!request.body) return "";
+  const reader = request.body.getReader();
+  const chunks = [];
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.byteLength;
+    if (size > BODY_LIMIT) {
+      await reader.cancel();
+      return void 0;
+    }
+    chunks.push(value);
+  }
+  const bytes = new Uint8Array(size);
+  let offset = 0;
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return new TextDecoder().decode(bytes);
+}
+var TOO_LARGE = `The request body exceeds ${BODY_LIMIT} bytes.`;
+async function handler(request, options = {}) {
+  if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: CORS });
+  if (request.method !== "POST") return rpcError(405, -32e3, "Method not allowed: this server is stateless, POST only.", { allow: "POST, OPTIONS" });
+  const length = Number(request.headers.get("content-length") ?? Number.NaN);
+  if (length > BODY_LIMIT) return rpcError(413, -32e3, TOO_LARGE);
+  const text = await boundedText(request);
+  if (text === void 0) return rpcError(413, -32e3, TOO_LARGE);
+  let parsedBody;
+  try {
+    parsedBody = JSON.parse(text);
+  } catch {
+    return rpcError(400, -32700, "Parse error: the body is not JSON.");
+  }
+  const server = createServer(options);
+  const transport = new WebStandardStreamableHTTPServerTransport({ sessionIdGenerator: void 0, enableJsonResponse: true });
+  try {
+    await server.connect(transport);
+    const forwarded = new Request(request.url, { method: "POST", headers: request.headers });
+    return withCors(await transport.handleRequest(forwarded, { parsedBody }));
+  } finally {
+    await server.close();
+  }
+}
+
+export { BODY_LIMIT, handler };

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { A as AgentCatalog } from './server-BXBjhMwX.js';
+export { a as AdapterFramework, B as Binding, C as ChartEntry, b as ComponentEntry, D as DataField, c as DataShape, d as DataSpec, e as Diagnostic, F as Family, f as Framework, G as Ground, I as Imports, g as Intent, N as Names, P as PropEntry, R as RecommendRule, h as ReflexCatalog, i as ReflexProp, S as ServerOptions, j as createServer } from './server-BXBjhMwX.js';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+
+declare const AGENT_CATALOG: AgentCatalog;
+
+export { AGENT_CATALOG, AgentCatalog };

package/dist/index.js

@@ -0,0 +1 @@
+export { AGENT_CATALOG, createServer } from './chunk-NUDC553W.js';

package/dist/server-BXBjhMwX.d.ts

@@ -0,0 +1,221 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+/**
+ * The agent catalog (feature-005, Data Model §2.28..§2.30): the public API described for agents,
+ * generated by `tools/agent-catalog` from the published types, never typed by hand (REQ-530).
+ */
+type Framework = 'react' | 'vue' | 'angular' | 'reflex';
+/** The three frameworks with a component layer of their own (no Reflex binding: it wraps React). */
+type AdapterFramework = Exclude<Framework, 'reflex'>;
+type Names = Readonly<Record<Framework, string>>;
+type Imports = Readonly<Record<Framework, string>>;
+/** What a chart's rows hold (API delta §3). */
+type DataShape = 'series' | 'categories' | 'parts' | 'matrix' | 'hierarchy' | 'links' | 'points' | 'distribution' | 'intervals' | 'events' | 'single' | 'field';
+/** What the reader is asked to see (API delta §3). */
+type Intent = 'trend' | 'compare' | 'rank' | 'part-to-whole' | 'distribution' | 'correlation' | 'flow' | 'hierarchy' | 'change' | 'uncertainty' | 'progress' | 'schedule' | 'kpi' | 'network';
+/**
+ * The chart families, the slugs of the nine the official site and `reflex-silverpoint-react`
+ * already show (Data Model §2.29, fixed at T-227).
+ */
+type Family = 'lines' | 'bars' | 'areas' | 'points-grids' | 'flows' | 'radial' | 'distributions-comparisons' | 'hierarchies-dimensions' | 'fields-networks';
+interface PropEntry {
+    /** camelCase, as the types. */
+    readonly name: string;
+    /** snake_case, from the Reflex catalog; absent when Reflex lacks it. */
+    readonly reflex?: string;
+    readonly type: string;
+    readonly optional: boolean;
+    /** From API Spec §5.1, the core's own fallback literal, or the JSDoc. */
+    readonly default?: string;
+    readonly doc: string;
+}
+interface DataField {
+    /** What the field means to the chart: `x`, `value`, `source`… */
+    readonly role: string;
+    /** The accessor prop that names the field (`xKey`, `keys`…). */
+    readonly prop: string;
+    /** `array` for a field holding a list (a sparkline's points, a heatmap row's values). */
+    readonly type: 'string' | 'number' | 'date' | 'array';
+    readonly required: boolean;
+}
+interface DataSpec {
+    readonly shape: DataShape;
+    readonly fields: readonly DataField[];
+}
+interface ChartEntry {
+    readonly slug: string;
+    readonly names: Names;
+    readonly imports: Imports;
+    readonly family: Family;
+    readonly summary: string;
+    readonly data: DataSpec;
+    readonly intents: readonly Intent[];
+    /** Own props only; the shared ones are in `common.chart`. */
+    readonly props: readonly PropEntry[];
+    /** The export holding the demo rows; absent when the chart draws from its props alone. */
+    readonly demo?: string;
+    /** The demo's accessor props, which name its non-default fields. */
+    readonly demoKeys?: Readonly<Record<string, unknown>>;
+    /** The demo's first rows: the shape of the data, by example, read through `demoKeys`. */
+    readonly demoSample?: readonly unknown[];
+    /** `rootId` + `onRootChange` (REQ-439). */
+    readonly drillable?: boolean;
+    /** Present when the Reflex catalog wraps another silverpoint version (REQ-556). */
+    readonly stale?: string;
+}
+/** How a component's value or open state is bound, per framework. */
+interface Binding {
+    readonly value?: Readonly<Record<AdapterFramework, string>>;
+    readonly open?: Readonly<Record<AdapterFramework, string>>;
+}
+interface ComponentEntry {
+    readonly slug: string;
+    readonly names: Names;
+    readonly imports: Imports;
+    readonly family: 'ui' | 'composed' | 'overlay';
+    readonly group: string;
+    readonly summary: string;
+    readonly props: readonly PropEntry[];
+    readonly binding?: Binding;
+    /** Event names per framework: React handler props, Vue emits, Angular outputs. */
+    readonly events: Readonly<Record<AdapterFramework, readonly string[]>>;
+    /** Named content per framework: React node props, Vue slots, Angular templates and projections. */
+    readonly slots: Readonly<Record<AdapterFramework, readonly string[]>>;
+    /** Declared states (Data Model §5). */
+    readonly states: readonly string[];
+    /**
+     * The first state's demo props (`UI_DEMOS`, `id` left out): own props plus `value` for a bound
+     * value, `content` for the text it holds and `trigger` for an overlay's trigger text.
+     */
+    readonly demo: Readonly<Record<string, unknown>>;
+    readonly stale?: string;
+}
+interface Diagnostic {
+    readonly code: string;
+    readonly severity: 'warn' | 'error';
+    readonly req: string;
+    readonly what: string;
+    readonly todo: string;
+}
+interface Ground {
+    readonly name: string;
+    readonly substrates: readonly string[];
+    readonly summary: string;
+}
+/** One row of the recommender's table (Data Model §2.31, DD-046). */
+interface RecommendRule {
+    readonly shape: DataShape;
+    readonly intent: Intent;
+    readonly charts: readonly {
+        readonly slug: string;
+        readonly score: number;
+        readonly reason: string;
+    }[];
+    readonly adjust?: readonly {
+        readonly when: 'rows>' | 'rows<' | 'values>';
+        readonly n: number;
+        readonly slug: string;
+        readonly delta: number;
+        readonly reason: string;
+    }[];
+}
+interface AgentCatalog {
+    readonly schema: 1;
+    /** The library version described (REQ-534). */
+    readonly version: string;
+    readonly reflex: {
+        readonly version: string;
+        readonly wraps: string;
+        readonly stale: boolean;
+    };
+    readonly frameworks: readonly Framework[];
+    readonly families: readonly {
+        readonly slug: Family;
+        readonly title: string;
+    }[];
+    readonly common: {
+        readonly chart: readonly PropEntry[];
+        readonly ui: readonly PropEntry[];
+    };
+    readonly charts: readonly ChartEntry[];
+    readonly components: readonly ComponentEntry[];
+    readonly dashboard: {
+        readonly props: readonly PropEntry[];
+        readonly layout: readonly PropEntry[];
+        readonly cell: readonly PropEntry[];
+        readonly names: Names;
+        readonly imports: Imports;
+    };
+    readonly grounds: readonly Ground[];
+    readonly palettes: {
+        readonly fields: readonly PropEntry[];
+        readonly presets: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    };
+    readonly timeline: {
+        readonly props: readonly PropEntry[];
+        readonly names: Names;
+        readonly imports: Imports;
+        readonly peer: string;
+    };
+    readonly diagnostics: readonly Diagnostic[];
+    /** The recommender's table (DD-046): `recommend_chart` reads it, never a model. */
+    readonly recommend: readonly RecommendRule[];
+    readonly stylesheets: {
+        readonly always: readonly string[];
+        readonly ui: readonly string[];
+        readonly timeline: readonly string[];
+    };
+}
+/** `reflex-catalog.json`, exported by `reflex-silverpoint-react` (Data Model §2.30, DD-049). */
+interface ReflexCatalog {
+    readonly schema: 1;
+    readonly package: 'reflex-silverpoint-react';
+    /** The wheel's version. */
+    readonly version: string;
+    /** `SILVERPOINT_VERSION`: the silverpoint version that release wraps. */
+    readonly wraps: string;
+    /** How the file was produced, when not by the package's own export (the interim pin of T-231). */
+    readonly derived?: string;
+    /** The props every chart and every component share, with their Python names. */
+    readonly common?: {
+        readonly chart: readonly ReflexProp[];
+        readonly ui: readonly ReflexProp[];
+    };
+    readonly charts: readonly {
+        readonly slug: string;
+        readonly builder: string;
+        readonly cls: string;
+        readonly family: string;
+        readonly summary?: string;
+        readonly props: readonly ReflexProp[];
+    }[];
+    readonly components: readonly {
+        readonly slug: string;
+        readonly builder: string;
+        readonly cls: string;
+        readonly props: readonly ReflexProp[];
+        readonly positional: readonly string[];
+        readonly deprecated: Readonly<Record<string, string>>;
+    }[];
+    readonly helpers: readonly string[];
+}
+interface ReflexProp {
+    readonly name: string;
+    readonly js: string;
+    readonly type: string;
+}
+
+/**
+ * `createServer` (API delta §1, REQ-538): an `McpServer` holding every tool, resource and prompt of
+ * the agent catalog. Each tool is a pure function of its input and the catalog (Art. 4); every
+ * result carries the catalog's version (REQ-550); a `ToolError` becomes a tool error the client
+ * reads as data (REQ-549).
+ */
+
+interface ServerOptions {
+    /** The catalog to serve; the one this package ships by default. */
+    readonly catalog?: AgentCatalog;
+}
+declare function createServer(options?: ServerOptions): McpServer;
+
+export { type AgentCatalog as A, type Binding as B, type ChartEntry as C, type DataField as D, type Family as F, type Ground as G, type Imports as I, type Names as N, type PropEntry as P, type RecommendRule as R, type ServerOptions as S, type AdapterFramework as a, type ComponentEntry as b, type DataShape as c, type DataSpec as d, type Diagnostic as e, type Framework as f, type Intent as g, type ReflexCatalog as h, type ReflexProp as i, createServer as j };

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@silverpoint/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.8.0",
+  "description": "An MCP server for silverpoint: the agent catalog as tools and resources, a chart recommender, code generation, prop validation and the canonical render.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "silverpoint-mcp": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "@silverpoint/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./http": {
+      "@silverpoint/source": "./src/http.ts",
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.js",
+      "default": "./dist/http.js"
+    },
+    "./agent-catalog.json": "./agent-catalog.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "agent-catalog.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ecrespo/silverpoint.git",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
+    "@silverpoint/core": "0.8.0",
+    "@silverpoint/grounds": "0.8.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }