forgebook 0.1.0 → 0.1.3

package/dist/src/vite/mcpProtocol.js

@@ -0,0 +1,181 @@
+/**
+ * The part of the Model Context Protocol a stdio server with a few tools needs, written here instead of taking the
+ * protocol's SDK: one JSON-RPC message in, its answer out. Pure apart from the tools it calls.
+ *
+ * @remarks
+ * Two eras of the protocol are served, as the specification's backward-compatibility rules describe: the current
+ * stateless one (`2026-07-28`: each request carries its version in `params._meta`, `server/discover` answers what the
+ * server offers) and the handshake one most clients still speak (`2025-11-25` and before: `initialize`, then
+ * requests). An `initialize` puts the session in the handshake era; a request carrying the version in `_meta` is
+ * answered statelessly. The tools never change while the server runs, so their list is cacheable and public.
+ *
+ * @module
+ */
+/** The protocol's current version, stateless. */
+export const MODERN_VERSION = "2026-07-28";
+/** The handshake versions answered: the latest first, which a client asking for another is offered. */
+export const HANDSHAKE_VERSIONS = ["2025-11-25", "2025-06-18", "2025-03-26"];
+/** Every version served, for `server/discover` and for the error a client with another one gets. */
+export const SUPPORTED_VERSIONS = [MODERN_VERSION, ...HANDSHAKE_VERSIONS];
+/** The `_meta` keys of the current era. */
+const META = {
+    version: "io.modelcontextprotocol/protocolVersion",
+    capabilities: "io.modelcontextprotocol/clientCapabilities",
+    serverInfo: "io.modelcontextprotocol/serverInfo"
+};
+/** JSON-RPC's and the protocol's error codes this server answers with. */
+const ERRORS = {
+    parse: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+    unsupportedVersion: -32022
+};
+/** How long a client may keep the tools' list, in ms: they never change while the server runs. */
+const TOOLS_TTL_MS = 300_000;
+/** A new session: no handshake yet. */
+export const NEW_SESSION = { handshakeVersion: undefined };
+/** Whether a value is a plain object. */
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** An error answer. */
+const failure = (id, code, message, data) => ({
+    jsonrpc: "2.0",
+    id,
+    error: data === undefined ? { code, message } : { code, message, data }
+});
+/** A result answer. */
+const success = (id, result) => ({
+    jsonrpc: "2.0",
+    id,
+    result
+});
+/** What the stateless era adds to every result: its type and who answered. */
+const modernResult = (server, result) => ({
+    resultType: "complete",
+    ...result,
+    // biome-ignore lint/style/useNamingConvention: the protocol names this field
+    _meta: { [META.serverInfo]: server.info }
+});
+/**
+ * Why a stateless request cannot be answered: its `_meta` lacks the version or the client's capabilities, or names a
+ * version not served.
+ *
+ * @returns the error answer, or none when the request is valid.
+ */
+const modernProblem = (id, meta) => {
+    const version = meta[META.version];
+    if (typeof version !== "string" || !isRecord(meta[META.capabilities]))
+        return failure(id, ERRORS.invalidParams, `A request needs ${META.version} and ${META.capabilities} in _meta`);
+    if (!SUPPORTED_VERSIONS.includes(version))
+        return failure(id, ERRORS.unsupportedVersion, "Unsupported protocol version", {
+            supported: SUPPORTED_VERSIONS,
+            requested: version
+        });
+    return undefined;
+};
+/** The tools' list as the protocol gives it. */
+const toolList = (server) => server.tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema
+}));
+/** A tool's answer as the protocol gives it: its JSON as text and as structured content. */
+const toolResult = async (tool, args) => {
+    const { structured, isError } = await tool.call(args);
+    return {
+        content: [{ type: "text", text: JSON.stringify(structured) }],
+        structuredContent: structured,
+        isError
+    };
+};
+/** Answers a request in either era: the methods both share. */
+const answerRequest = async (server, id, method, params, isModern) => {
+    const finish = (result) => success(id, isModern ? modernResult(server, result) : result);
+    if (method === "tools/list")
+        return finish(isModern
+            ? { tools: toolList(server), ttlMs: TOOLS_TTL_MS, cacheScope: "public" }
+            : { tools: toolList(server) });
+    if (method === "tools/call") {
+        const name = params["name"];
+        const tool = server.tools.find((each) => each.name === name);
+        if (tool === undefined)
+            return failure(id, ERRORS.invalidParams, `Unknown tool: ${String(name)}`);
+        const args = params["arguments"];
+        return finish(await toolResult(tool, isRecord(args) ? args : {}));
+    }
+    if (method === "server/discover" && isModern)
+        return finish({
+            supportedVersions: SUPPORTED_VERSIONS,
+            capabilities: { tools: {} },
+            ...(server.instructions === undefined ? {} : { instructions: server.instructions }),
+            ttlMs: TOOLS_TTL_MS,
+            cacheScope: "public"
+        });
+    return failure(id, ERRORS.methodNotFound, `Method not found: ${method}`);
+};
+/** Reads one line as a JSON-RPC message. */
+const readMessage = (line) => {
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return { kind: "invalid", reply: failure(null, ERRORS.parse, "Parse error") };
+    }
+    if (!isRecord(message) || message["jsonrpc"] !== "2.0" || typeof message["method"] !== "string") {
+        const id = isRecord(message) ? (message["id"] ?? null) : null;
+        return { kind: "invalid", reply: failure(id, ERRORS.invalidRequest, "Invalid request") };
+    }
+    // a notification (no id) is never answered: `notifications/initialized`, a cancellation
+    if (!("id" in message))
+        return { kind: "notification" };
+    const params = message["params"];
+    return {
+        kind: "request",
+        id: message["id"],
+        method: message["method"],
+        params: isRecord(params) ? params : {}
+    };
+};
+/** Answers `initialize`: the version asked for when it is served, the latest handshake one otherwise. */
+const initialized = (server, id, params) => {
+    const asked = params["protocolVersion"];
+    const version = HANDSHAKE_VERSIONS.find((each) => each === asked) ?? HANDSHAKE_VERSIONS[0];
+    const result = {
+        protocolVersion: version,
+        capabilities: { tools: {} },
+        serverInfo: server.info,
+        ...(server.instructions === undefined ? {} : { instructions: server.instructions })
+    };
+    return { reply: JSON.stringify(success(id, result)), session: { handshakeVersion: version } };
+};
+/**
+ * Answers one message the client sent: a line of JSON-RPC.
+ *
+ * @param line - the message, one line of JSON.
+ * @param session - what the session remembers.
+ * @param server - who the server is and its tools.
+ * @returns the answer to write (none for a notification) and the session after the message.
+ */
+export const answerMcpMessage = async (line, session, server) => {
+    const read = readMessage(line);
+    if (read.kind === "notification")
+        return { reply: undefined, session };
+    if (read.kind === "invalid")
+        return { reply: JSON.stringify(read.reply), session };
+    const { id, method, params } = read;
+    if (method === "initialize")
+        return initialized(server, id, params);
+    const answer = async () => {
+        if (method === "ping")
+            return success(id, {});
+        const meta = params["_meta"];
+        if (isRecord(meta) && META.version in meta)
+            return modernProblem(id, meta) ?? (await answerRequest(server, id, method, params, true));
+        if (session.handshakeVersion !== undefined)
+            return answerRequest(server, id, method, params, false);
+        return failure(id, ERRORS.invalidParams, `A request needs ${META.version} in _meta, or an initialize first`);
+    };
+    return { reply: JSON.stringify(await answer()), session };
+};
+//# sourceMappingURL=mcpProtocol.js.map

package/dist/src/vite/mcpProtocol.js.map

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

package/dist/src/vite/pages.d.ts

@@ -13,6 +13,11 @@ export declare const CONFIG_MODULE = "virtual:forgebook/config";
 export declare const PAGE_ENTRIES: Readonly<Record<PageFile, string>>;
 /** The file name, in the configuration's folder, of the project's own stories' source (never written to disk). */
 export declare const STORIES_SOURCE_FILE = ".forgebook-stories.ts";
+/**
+ * The file name, in the configuration's folder, of the module the dev server loads to answer tools and agents: the
+ * sources and the previews, as the frame gets them (never written to disk).
+ */
+export declare const AGENT_SOURCES_FILE = ".forgebook-agent.ts";
 /** The project's own stories' source id. */
 export declare const OWN_SOURCE_ID = "stories";
 /**
@@ -40,6 +45,13 @@ export declare const shellEntry: (config: ResolvedConfig) => string;
  * @param config - the configuration.
  */
 export declare const frameEntry: (config: ResolvedConfig) => string;
+/**
+ * The module the dev server loads to answer tools and agents: the sources and the previews the frame mounts, as
+ * values (`sources`, `previews`), loaded on the server with the same imports the pages use.
+ *
+ * @param config - the configuration.
+ */
+export declare const agentSourcesModule: (config: ResolvedConfig) => string;
 /**
  * The source of the project's own stories: one `?forgebook-files` import per glob, named after the catalogue.
  *

package/dist/src/vite/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/pages.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAEhE,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAG3D,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,4CAA4C;AAC5C,eAAO,MAAM,aAAa,YAAY,CAAC;AAUvC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,EAAE,QAAQ,cAAc,KAAG,MAgBpD,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,KAAG,MASrD,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAuBnD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAmBnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MAa/C,CAAC"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/pages.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAEhE,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAG3D,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,aAAa,YAAY,CAAC;AAUvC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,EAAE,QAAQ,cAAc,KAAG,MAgBpD,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,KAAG,MASrD,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAuBnD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAmBnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,MAS3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MAa/C,CAAC"}

package/dist/src/vite/pages.js

@@ -28,6 +28,11 @@ export const PAGE_ENTRIES = {
 };
 /** The file name, in the configuration's folder, of the project's own stories' source (never written to disk). */
 export const STORIES_SOURCE_FILE = ".forgebook-stories.ts";
+/**
+ * The file name, in the configuration's folder, of the module the dev server loads to answer tools and agents: the
+ * sources and the previews, as the frame gets them (never written to disk).
+ */
+export const AGENT_SOURCES_FILE = ".forgebook-agent.ts";
 /** The project's own stories' source id. */
 export const OWN_SOURCE_ID = "stories";
 /**
@@ -153,6 +158,22 @@ export const frameEntry = (config) => {
         ""
     ].join("\n");
 };
+/**
+ * The module the dev server loads to answer tools and agents: the sources and the previews the frame mounts, as
+ * values (`sources`, `previews`), loaded on the server with the same imports the pages use.
+ *
+ * @param config - the configuration.
+ */
+export const agentSourcesModule = (config) => {
+    const sources = sourcesCode(config);
+    return [
+        ...sources.imports,
+        ...config.previews.map((file, index) => `import * as preview${index} from ${JSON.stringify(file)};`),
+        `export const sources = ${sources.list};`,
+        `export const previews = [${config.previews.map((_file, index) => `preview${index}`).join(", ")}];`,
+        ""
+    ].join("\n");
+};
 /**
  * The source of the project's own stories: one `?forgebook-files` import per glob, named after the catalogue.
  *

package/dist/src/vite/pages.js.map

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

package/dist/src/vite/storyFilesModule.js

@@ -4,7 +4,7 @@
  *
  * @remarks
  * One module per pattern, instead of an import per file: in development the browser fetched every index module one by
- * one, a few hundred requests per frame (D-438). The keys are the files' paths relative to the declaring module
+ * one, a few hundred requests per frame. The keys are the files' paths relative to the declaring module
  * (`../src/x.stories.tsx`), the same keys `storyFileKeys` gives the tests that read the files from the disk.
  *
  * @module

package/dist/src/vite/typeScriptPieces.js

@@ -1,6 +1,6 @@
 /**
  * Code of the TypeScript family (TypeScript, TSX, JavaScript, JSX) split into the pieces a reader tells apart, from
- * the TypeScript compiler's syntactic classifications, for `highlightCode.ts` to colour (D-690).
+ * the TypeScript compiler's syntactic classifications, for `highlightCode.ts` to colour.
  *
  * @remarks
  * highlight.js has no JSX grammar: it reads JSX as HTML, so an attribute holding a function or a `>` ends the tag
@@ -11,7 +11,7 @@
  * keywords, literals (a regular expression among the strings), comments, JSX and the names declared by a class, an
  * interface, an enum, a namespace or a type parameter apart; a name they leave as a plain identifier is placed from
  * the block's syntax tree: a type where a type is written, a function where it is called or declared, a property
- * where it is read or declared (D-691). The rest (operators, punctuation, plain names, JSX text) stays plain.
+ * where it is read or declared. The rest (operators, punctuation, plain names, JSX text) stays plain.
  *
  * The pieces are slices of the code, in order, covering it whole: the caller escapes each one, so a coloured piece
  * never splits an HTML entity.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgebook",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "See every component in every theme, contrast, language and width: CSF stories, one frame per story, and a props table from the components' types.",
   "keywords": [
     "react",
@@ -13,7 +13,7 @@
   "author": "Jason Scoppetta",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Ensiria/forgebook.git",
+    "url": "git+https://github.com/ensiria/forgebook.git",
     "directory": "packages/forgebook"
   },
   "type": "module",
@@ -37,6 +37,10 @@
       "types": "./dist/src/vite/config.d.ts",
       "default": "./dist/src/vite/config.js"
     },
+    "./agent": {
+      "types": "./dist/src/vite/agent.types.d.ts",
+      "default": "./dist/src/vite/agent.types.js"
+    },
     "./story-tree": {
       "types": "./dist/src/storyTree.d.ts",
       "default": "./dist/src/storyTree.js"
@@ -157,7 +161,7 @@
     "lightningcss": "1.33.0",
     "marked": "18.1.0",
     "typescript-6": "npm:typescript@6.0.3",
-    "@forgebook/story-format": "0.1.0"
+    "@forgebook/story-format": "0.1.2"
   },
   "peerDependencies": {
     "@testing-library/dom": "^10.4.0",