@micropage-sh/mcp 0.1.0

package/dist/reference/prompts.js.map

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

package/dist/reference/resources.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/server";
+export declare function registerResources(server: McpServer): void;

package/dist/reference/resources.js

@@ -0,0 +1,41 @@
+import { McpServer, ResourceNotFoundError, ResourceTemplate } from "@modelcontextprotocol/server";
+import { EXAMPLES } from "../content/index.js";
+import { DOCS, EXAMPLE_NAMES, REFERENCE_CACHE_HINT, exampleSummary, exampleUri, unknownExampleMessage, } from "./topics.js";
+const EXAMPLE_MIME = "text/plain";
+export function registerResources(server) {
+    for (const doc of DOCS) {
+        server.registerResource(doc.name, doc.uri, {
+            title: doc.title,
+            description: doc.description,
+            mimeType: doc.mimeType,
+            cacheHint: REFERENCE_CACHE_HINT,
+        }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: doc.mimeType, text: doc.text() }] }));
+    }
+    server.registerResource("example", new ResourceTemplate("micropage://examples/{name}", {
+        list: () => ({
+            resources: EXAMPLE_NAMES.map((name) => ({
+                uri: exampleUri(name),
+                name: `example-${name}`,
+                title: `Example: ${name}`,
+                description: `${exampleSummary(name)}. A complete, valid .page example file to copy section layout and tag patterns from when writing markup.`,
+                mimeType: EXAMPLE_MIME,
+            })),
+        }),
+        complete: {
+            name: (value) => EXAMPLE_NAMES.filter((n) => n.startsWith(value)),
+        },
+    }), {
+        title: "Example .page file",
+        description: "A complete, valid .page file to copy patterns from. {name} is one of the names in micropage://examples (e.g. startup-landing, portfolio, components-pricing-and-forms).",
+        mimeType: EXAMPLE_MIME,
+        cacheHint: REFERENCE_CACHE_HINT,
+    }, async (uri, variables) => {
+        const raw = variables.name;
+        const name = Array.isArray(raw) ? raw[0] : raw;
+        const text = name === undefined ? undefined : EXAMPLES[name];
+        if (text === undefined)
+            throw new ResourceNotFoundError(uri.href, unknownExampleMessage(name ?? ""));
+        return { contents: [{ uri: uri.href, mimeType: EXAMPLE_MIME, text }] };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/reference/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/reference/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAElG,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,IAAI,EACJ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,gBAAgB,CACrB,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,GAAG,EACP;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,oBAAoB;SAChC,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,SAAS,EACT,IAAI,gBAAgB,CAAC,6BAA6B,EAAE;QAClD,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YACX,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,WAAW,IAAI,EAAE;gBACvB,KAAK,EAAE,YAAY,IAAI,EAAE;gBACzB,WAAW,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,0GAA0G;gBAC9I,QAAQ,EAAE,YAAY;aACvB,CAAC,CAAC;SACJ,CAAC;QACF,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;SAClE;KACF,CAAC,EACF;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,yKAAyK;QAC3K,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,oBAAoB;KAChC,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACrG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/reference/tool.d.ts

@@ -0,0 +1,21 @@
+import type { CallToolResult, McpServer } from "@modelcontextprotocol/server";
+import * as z from "zod";
+export declare const TOPICS: readonly ["grammar", "grammar_full", "posts_format", "agent_guide", "examples_index", "example"];
+export declare const GetMarkupReferenceInput: z.ZodObject<{
+    topic: z.ZodOptional<z.ZodEnum<{
+        grammar: "grammar";
+        grammar_full: "grammar_full";
+        posts_format: "posts_format";
+        agent_guide: "agent_guide";
+        examples_index: "examples_index";
+        example: "example";
+    }>>;
+    example: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type GetMarkupReferenceArgs = z.infer<typeof GetMarkupReferenceInput>;
+export declare function runGetMarkupReference(args: GetMarkupReferenceArgs): CallToolResult;
+/**
+ * The same text the micropage:// resources serve. It exists because many MCP
+ * hosts never read resources, and a model without the grammar invents tags.
+ */
+export declare function registerReferenceTool(server: McpServer): void;

package/dist/reference/tool.js

@@ -0,0 +1,50 @@
+import * as z from "zod";
+import { RO, hints } from "../annotations.js";
+import { EXAMPLES } from "../content/index.js";
+import { DOC_TOPICS, EXAMPLE_NAMES, docFor, unknownExampleMessage } from "./topics.js";
+export const TOPICS = [...DOC_TOPICS, "example"];
+export const GetMarkupReferenceInput = z
+    .object({
+    topic: z
+        .enum(TOPICS)
+        .optional()
+        .describe("What to return. grammar: the short .page grammar (start here). grammar_full: the complete reference. " +
+        "posts_format: post fields and lifecycle. agent_guide: editing rules. examples_index: example names. " +
+        "example: one example file (set `example`). Defaults to grammar, or to example when `example` is set."),
+    example: z
+        .string()
+        .optional()
+        .describe(`Example name, used with topic "example". One of: ${EXAMPLE_NAMES.join(", ")}.`),
+})
+    .strict();
+const text = (t, isError = false) => ({
+    content: [{ type: "text", text: t }],
+    ...(isError ? { isError: true } : {}),
+});
+export function runGetMarkupReference(args) {
+    const topic = args.topic ?? (args.example !== undefined ? "example" : "grammar");
+    if (topic !== "example")
+        return text(docFor(topic).text());
+    const name = args.example?.trim().replace(/\.page$/, "");
+    if (!name)
+        return text(`topic "example" needs \`example\`: one of ${EXAMPLE_NAMES.join(", ")}.`, true);
+    const body = EXAMPLES[name];
+    return body === undefined ? text(unknownExampleMessage(name), true) : text(body);
+}
+/**
+ * The same text the micropage:// resources serve. It exists because many MCP
+ * hosts never read resources, and a model without the grammar invents tags.
+ */
+export function registerReferenceTool(server) {
+    server.registerTool("get_markup_reference", {
+        title: "Get the .page markup reference",
+        description: `Return micropage reference text: the .page grammar, the full reference, the posts format, the agent editing guide, the example index, or one complete example file.
+
+Call this before writing or editing .page markup (and before drafting a post), unless you already have the grammar in context. The vocabulary is closed: tags that are not in the grammar are not rendered, so never guess. Start with topic "grammar"; use "examples_index" then "example" to copy a layout close to what the user wants.
+
+This mirrors the micropage://grammar, micropage://grammar/full, micropage://posts/format, micropage://agent-guide and micropage://examples/{name} resources, for hosts that do not read resources. Local and read-only: no network call, no account needed.`,
+        inputSchema: GetMarkupReferenceInput,
+        annotations: hints(RO, { openWorldHint: false }),
+    }, async (args) => runGetMarkupReference(args));
+}
+//# sourceMappingURL=tool.js.map

package/dist/reference/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/reference/tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,EAAE,SAAS,CAAU,CAAC;AAE1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,MAAM,CAAC;SACZ,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG;QACrG,sGAAsG;QACtG,sGAAsG,CACzG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;CAC7F,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,OAAO,GAAG,KAAK,EAAkB,EAAE,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACpC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,6CAA6C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvG,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE;;;;4PAIyO;QACtP,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;KACjD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/reference/topics.d.ts

@@ -0,0 +1,29 @@
+import type { CacheHint } from "@modelcontextprotocol/server";
+/** A day. The reference changes when the docs ship, not per request. */
+export declare const REFERENCE_TTL_MS = 86400000;
+export declare const REFERENCE_CACHE_HINT: Readonly<CacheHint>;
+export declare const EXAMPLE_NAMES: readonly string[];
+export declare const EXAMPLE_URI_PREFIX = "micropage://examples/";
+export declare const exampleUri: (name: string) => string;
+/** "Title: description" from an example's [site] block, for listings. */
+export declare function exampleSummary(name: string): string;
+export declare function examplesIndex(): string;
+/** Lists the valid names, so a wrong guess can be corrected in one step. */
+export declare function unknownExampleMessage(name: string): string;
+export declare const DOC_TOPICS: readonly ["grammar", "grammar_full", "posts_format", "agent_guide", "examples_index"];
+export type DocTopic = (typeof DOC_TOPICS)[number];
+export interface DocResource {
+    topic: DocTopic;
+    name: string;
+    uri: string;
+    title: string;
+    description: string;
+    mimeType: string;
+    text: () => string;
+}
+/**
+ * One table drives both the resources and get_markup_reference, so the tool
+ * can never serve something the resources don't (or vice versa).
+ */
+export declare const DOCS: readonly DocResource[];
+export declare function docFor(topic: DocTopic): DocResource;

package/dist/reference/topics.js

@@ -0,0 +1,91 @@
+import { AGENT_GUIDE, EXAMPLES, GRAMMAR, GRAMMAR_FULL, POSTS_FORMAT } from "../content/index.js";
+/** A day. The reference changes when the docs ship, not per request. */
+export const REFERENCE_TTL_MS = 86_400_000;
+export const REFERENCE_CACHE_HINT = Object.freeze({
+    ttlMs: REFERENCE_TTL_MS,
+    cacheScope: "public",
+});
+export const EXAMPLE_NAMES = Object.freeze(Object.keys(EXAMPLES).sort());
+export const EXAMPLE_URI_PREFIX = "micropage://examples/";
+export const exampleUri = (name) => `${EXAMPLE_URI_PREFIX}${name}`;
+/** "Title: description" from an example's [site] block, for listings. */
+export function exampleSummary(name) {
+    const body = EXAMPLES[name] ?? "";
+    const title = /^title:\s*(.+)$/m.exec(body)?.[1]?.trim();
+    const description = /^description:\s*(.+)$/m.exec(body)?.[1]?.trim();
+    return [title, description].filter(Boolean).join(": ") || name;
+}
+export function examplesIndex() {
+    return [
+        "# Micropage .page examples",
+        "",
+        "Complete, valid `.page` files. Copy their patterns rather than inventing markup. Read one with",
+        "`get_markup_reference` (topic `example`, example `<name>`) or the resource `micropage://examples/<name>`.",
+        "",
+        ...EXAMPLE_NAMES.map((name) => `- \`${name}\` — ${exampleSummary(name)}`),
+        "",
+    ].join("\n");
+}
+/** Lists the valid names, so a wrong guess can be corrected in one step. */
+export function unknownExampleMessage(name) {
+    return `Unknown example "${name}". Valid names: ${EXAMPLE_NAMES.join(", ")}.`;
+}
+export const DOC_TOPICS = ["grammar", "grammar_full", "posts_format", "agent_guide", "examples_index"];
+/**
+ * One table drives both the resources and get_markup_reference, so the tool
+ * can never serve something the resources don't (or vice versa).
+ */
+export const DOCS = Object.freeze([
+    {
+        topic: "grammar",
+        name: "grammar",
+        uri: "micropage://grammar",
+        title: "Micropage .page grammar",
+        description: "The short, canonical .page grammar (docs.micropage.sh/llms.txt): file shape, the closed set of section and element tags, and the rules for agents. Read before writing or editing markup.",
+        mimeType: "text/markdown",
+        text: () => GRAMMAR,
+    },
+    {
+        topic: "grammar_full",
+        name: "grammar-full",
+        uri: "micropage://grammar/full",
+        title: "Micropage .page grammar (full)",
+        description: "The complete .page reference (docs.micropage.sh/llms-full.txt): every site key, element, form option and modifier with examples. Use when the short grammar does not answer the question.",
+        mimeType: "text/markdown",
+        text: () => GRAMMAR_FULL,
+    },
+    {
+        topic: "posts_format",
+        name: "posts-format",
+        uri: "micropage://posts/format",
+        title: "Posts format",
+        description: "How a post is shaped (title, slug, description, visibility, hero, email list, subject, preview, Markdown body) and its lifecycle: draft, publish, live edits, unpublish, re-send on re-publish.",
+        mimeType: "text/markdown",
+        text: () => POSTS_FORMAT,
+    },
+    {
+        topic: "agent_guide",
+        name: "agent-guide",
+        uri: "micropage://agent-guide",
+        title: "Agent guide",
+        description: "How to edit a micropage project safely: project layout, the closed tag vocabulary in brief, and the editing rules (edit in place, no invented tags, no inline colors, no markdown fences).",
+        mimeType: "text/markdown",
+        text: () => AGENT_GUIDE,
+    },
+    {
+        topic: "examples_index",
+        name: "examples",
+        uri: "micropage://examples",
+        title: "Example index",
+        description: "The bundled example .page files by name with a one-line summary each (SaaS launch, portfolio, restaurant, conference, docs, blog, component references). Pick one to copy patterns from.",
+        mimeType: "text/markdown",
+        text: examplesIndex,
+    },
+]);
+export function docFor(topic) {
+    const doc = DOCS.find((d) => d.topic === topic);
+    if (!doc)
+        throw new Error(`no reference document for topic ${topic}`);
+    return doc;
+}
+//# sourceMappingURL=topics.js.map

package/dist/reference/topics.js.map

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

package/dist/reference.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer, McpServerOptions } from "@modelcontextprotocol/server";
+import type { ToolContext } from "./context.js";
+/**
+ * Cache hints for the list results the SDK builds itself. tools/list is left
+ * out on purpose: which tools exist depends on the user's env switches.
+ */
+export declare const LIST_CACHE_HINTS: NonNullable<McpServerOptions["cacheHints"]>;
+/** micropage:// resources, the four workflow prompts, and get_markup_reference. */
+export declare function registerReference(server: McpServer, _ctx: ToolContext): void;

package/dist/reference.js

@@ -0,0 +1,20 @@
+import { registerPrompts } from "./reference/prompts.js";
+import { registerResources } from "./reference/resources.js";
+import { registerReferenceTool } from "./reference/tool.js";
+import { REFERENCE_CACHE_HINT } from "./reference/topics.js";
+/**
+ * Cache hints for the list results the SDK builds itself. tools/list is left
+ * out on purpose: which tools exist depends on the user's env switches.
+ */
+export const LIST_CACHE_HINTS = {
+    "resources/list": REFERENCE_CACHE_HINT,
+    "resources/templates/list": REFERENCE_CACHE_HINT,
+    "prompts/list": REFERENCE_CACHE_HINT,
+};
+/** micropage:// resources, the four workflow prompts, and get_markup_reference. */
+export function registerReference(server, _ctx) {
+    registerResources(server);
+    registerPrompts(server);
+    registerReferenceTool(server);
+}
+//# sourceMappingURL=reference.js.map

package/dist/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,gBAAgB,EAAE,oBAAoB;IACtC,0BAA0B,EAAE,oBAAoB;IAChD,cAAc,EAAE,oBAAoB;CACrC,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,IAAiB;IACpE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,29 @@
+import { McpServer, type McpRequestContext, type McpServerFactory } from "@modelcontextprotocol/server";
+import type { AuthProvider } from "./client/auth-provider.js";
+import { type MicropageConfig } from "./client/config.js";
+import { type FetchLike } from "./client/http.js";
+import type { ServerDeps } from "./context.js";
+export declare const SERVER_NAME = "micropage";
+export interface CreateDepsOptions {
+    /** Replaces global fetch for every outbound call (tests). */
+    fetch?: FetchLike;
+    now?: () => number;
+}
+/**
+ * Picks where tokens come from: a deploy token when MICROPAGE_DEPLOY_TOKEN and
+ * MICROPAGE_DEPLOY_PROJECT are both set (only one set throws), else the CLI
+ * session file. The session provider is used even when the file does not
+ * exist yet, so a `micropage login` after the server started takes effect
+ * without a restart; until then every call fails with NOT_LOGGED_IN.
+ */
+export declare function createAuthProvider(env: NodeJS.ProcessEnv, config: MicropageConfig, options?: CreateDepsOptions): AuthProvider;
+/** Builds the process-wide deps from the environment. */
+export declare function createDeps(env?: NodeJS.ProcessEnv, options?: CreateDepsOptions): ServerDeps;
+/**
+ * Builds one server instance. Transport-agnostic and factory-shaped on
+ * purpose: serveStdio calls it once per connection (plus a discarded
+ * discovery probe) and a future HTTP entry would call it per request, so all
+ * long-lived state (token refresh, caches) lives in `deps`, never here.
+ */
+export declare function createServer(ctx: McpRequestContext, deps: ServerDeps): McpServer;
+export declare function createServerFactory(deps: ServerDeps): McpServerFactory;

package/dist/server.js

@@ -0,0 +1,75 @@
+import { CLIENT_CAPABILITIES_META_KEY, McpServer, } from "@modelcontextprotocol/server";
+import { loadConfig } from "./client/config.js";
+import { DeployTokenAuthProvider, readDeployTokenEnv } from "./client/deploy-token.js";
+import { Http } from "./client/http.js";
+import { SessionAuthProvider, sessionFilePath } from "./client/session-store.js";
+import { PlanGate } from "./client/tier.js";
+import { readEnvFlags } from "./guards.js";
+import { LIST_CACHE_HINTS, registerReference } from "./reference.js";
+import { registerAccountTools } from "./tools/account.js";
+import { registerBuildTools } from "./tools/builds.js";
+import { registerFileTools } from "./tools/files.js";
+import { registerFormTools } from "./tools/forms.js";
+import { registerPostTools } from "./tools/posts.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { VERSION } from "./version.js";
+export const SERVER_NAME = "micropage";
+/**
+ * Picks where tokens come from: a deploy token when MICROPAGE_DEPLOY_TOKEN and
+ * MICROPAGE_DEPLOY_PROJECT are both set (only one set throws), else the CLI
+ * session file. The session provider is used even when the file does not
+ * exist yet, so a `micropage login` after the server started takes effect
+ * without a restart; until then every call fails with NOT_LOGGED_IN.
+ */
+export function createAuthProvider(env, config, options = {}) {
+    const shared = {
+        config,
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+        ...(options.now ? { now: options.now } : {}),
+    };
+    const deploy = readDeployTokenEnv(env);
+    if (deploy)
+        return new DeployTokenAuthProvider({ ...shared, ...deploy });
+    return new SessionAuthProvider({ ...shared, path: sessionFilePath(env) });
+}
+/** Builds the process-wide deps from the environment. */
+export function createDeps(env = process.env, options = {}) {
+    const config = loadConfig(env);
+    const auth = createAuthProvider(env, config, options);
+    const http = new Http({ config, auth, ...(options.fetch ? { fetch: options.fetch } : {}) });
+    const tier = new PlanGate({ http, auth, ...(options.now ? { now: options.now } : {}) });
+    return { config, auth, http, tier, flags: readEnvFlags(env) };
+}
+/**
+ * Builds one server instance. Transport-agnostic and factory-shaped on
+ * purpose: serveStdio calls it once per connection (plus a discarded
+ * discovery probe) and a future HTTP entry would call it per request, so all
+ * long-lived state (token refresh, caches) lives in `deps`, never here.
+ */
+export function createServer(ctx, deps) {
+    const server = new McpServer({ name: SERVER_NAME, version: VERSION }, { cacheHints: LIST_CACHE_HINTS });
+    const toolCtx = {
+        ...deps,
+        era: ctx.era,
+        clientCapabilities: (handlerCtx) => {
+            if (ctx.era === "modern") {
+                const envelope = handlerCtx.mcpReq.envelope;
+                return envelope?.[CLIENT_CAPABILITIES_META_KEY];
+            }
+            // 2025-era connections declare capabilities once, at initialize.
+            return server.server.getClientCapabilities();
+        },
+    };
+    registerAccountTools(server, toolCtx);
+    registerProjectTools(server, toolCtx);
+    registerBuildTools(server, toolCtx);
+    registerFileTools(server, toolCtx);
+    registerFormTools(server, toolCtx);
+    registerPostTools(server, toolCtx);
+    registerReference(server, toolCtx);
+    return server;
+}
+export function createServerFactory(deps) {
+    return (ctx) => createServer(ctx, deps);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,SAAS,GAKV,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAwB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,IAAI,EAAkB,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AAQvC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAsB,EAAE,MAAuB,EAAE,UAA6B,EAAE;IACjH,MAAM,MAAM,GAAG;QACb,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,IAAI,uBAAuB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzE,OAAO,IAAI,mBAAmB,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,UAA6B,EAAE;IAC9F,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAsB,EAAE,IAAgB;IACnE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAExG,MAAM,OAAO,GAAgB;QAC3B,GAAG,IAAI;QACP,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,kBAAkB,EAAE,CAAC,UAAyB,EAAkC,EAAE;YAChF,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,QAA+C,CAAC;gBACnF,OAAO,QAAQ,EAAE,CAAC,4BAA4B,CAAmC,CAAC;YACpF,CAAC;YACD,iEAAiE;YACjE,OAAO,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC/C,CAAC;KACF,CAAC;IAEF,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/tools/account.d.ts

@@ -0,0 +1,34 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import * as z from "zod";
+import type { ToolContext } from "../context.js";
+export declare const WhoamiInput: z.ZodObject<{}, z.core.$strict>;
+export declare const WhoamiOutput: z.ZodObject<{
+    logged_in: z.ZodBoolean;
+    auth_mode: z.ZodEnum<{
+        session: "session";
+        deploy_token: "deploy_token";
+        none: "none";
+    }>;
+    user_id: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    plan_tier: z.ZodNullable<z.ZodEnum<{
+        free: "free";
+        pro: "pro";
+        pro_plus: "pro_plus";
+    }>>;
+    paid_plan: z.ZodNullable<z.ZodBoolean>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        status: z.ZodNullable<z.ZodString>;
+        plan_tier: z.ZodNullable<z.ZodString>;
+        provider: z.ZodNullable<z.ZodString>;
+        product_name: z.ZodNullable<z.ZodString>;
+        current_period_end: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    pinned_project_uuid: z.ZodNullable<z.ZodString>;
+    config_path: z.ZodNullable<z.ZodString>;
+    note: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WhoamiResult = z.infer<typeof WhoamiOutput>;
+export declare function runWhoami(ctx: ToolContext): Promise<WhoamiResult>;
+export declare function registerAccountTools(server: McpServer, ctx: ToolContext): void;

package/dist/tools/account.js

@@ -0,0 +1,128 @@
+import * as z from "zod";
+import { RO } from "../annotations.js";
+import { isMicropageError } from "../client/errors.js";
+import { eq, inList } from "../client/http.js";
+import { decodeJwtClaims } from "../client/jwt.js";
+import { LOGIN_HINT, SessionAuthProvider } from "../client/session-store.js";
+import { UPGRADE_MESSAGE, isPaidTier } from "../client/tier.js";
+import { assertDeployTokenAllows } from "../guards.js";
+import { structuredResult } from "./shared.js";
+export const WhoamiInput = z.object({}).strict();
+export const WhoamiOutput = z.object({
+    logged_in: z.boolean(),
+    auth_mode: z.enum(["session", "deploy_token", "none"]),
+    user_id: z.string().nullable(),
+    email: z.string().nullable(),
+    name: z.string().nullable(),
+    plan_tier: z.enum(["free", "pro", "pro_plus"]).nullable().describe("Null when it could not be read."),
+    paid_plan: z.boolean().nullable().describe("Every tool except whoami and get_markup_reference needs a paid plan."),
+    subscription: z
+        .object({
+        status: z.string().nullable(),
+        plan_tier: z.string().nullable(),
+        provider: z.string().nullable(),
+        product_name: z.string().nullable(),
+        current_period_end: z.string().nullable(),
+    })
+        .nullable(),
+    pinned_project_uuid: z.string().nullable().describe("Deploy-token mode only: the one project this server may touch."),
+    config_path: z.string().nullable().describe("The CLI session file in use (session mode)."),
+    note: z.string().nullable().describe("What to tell the user, when something needs their action."),
+});
+const AUTH_FAILURES = new Set(["NOT_LOGGED_IN", "SESSION_EXPIRED", "SESSION_UNREADABLE", "DEPLOY_TOKEN_INVALID"]);
+export async function runWhoami(ctx) {
+    assertDeployTokenAllows(ctx.auth, "whoami");
+    const configPath = ctx.auth instanceof SessionAuthProvider ? ctx.auth.path : null;
+    const base = {
+        logged_in: false,
+        auth_mode: ctx.auth.mode,
+        user_id: null,
+        email: null,
+        name: null,
+        plan_tier: null,
+        paid_plan: null,
+        subscription: null,
+        pinned_project_uuid: ctx.auth.pinnedProjectUuid ?? null,
+        config_path: configPath,
+        note: null,
+    };
+    let token;
+    try {
+        token = await ctx.auth.getAccessToken();
+    }
+    catch (err) {
+        if (isMicropageError(err) && AUTH_FAILURES.has(err.code)) {
+            return { ...base, note: err.message };
+        }
+        throw err;
+    }
+    const claims = decodeJwtClaims(token);
+    let user;
+    if (ctx.auth.mode === "deploy_token") {
+        // The minted deploy JWT has no auth session behind it, so read identity from its claims.
+        user = { ...(claims?.sub ? { id: claims.sub } : {}), email: claims?.email ?? null };
+    }
+    else {
+        try {
+            user = await ctx.http.request("GET", `${ctx.config.supabaseUrl}/auth/v1/user`);
+        }
+        catch (err) {
+            if (isMicropageError(err) && AUTH_FAILURES.has(err.code)) {
+                return { ...base, note: `The micropage login session is no longer valid. ${LOGIN_HINT}` };
+            }
+            throw err;
+        }
+    }
+    const userId = user.id ?? claims?.sub ?? null;
+    let tier = null;
+    try {
+        tier = await ctx.tier.getPlanTier();
+    }
+    catch {
+        // Reported as null; the gate in other tools will surface the real error.
+    }
+    let subscription = null;
+    if (userId) {
+        subscription = await ctx.http
+            .selectOne("subscriptions", {
+            select: "status,plan_tier,provider,product_name,current_period_end",
+            filters: { user_id: eq(userId), status: inList(["active", "trialing", "paused"]) },
+            order: "updated_at.desc",
+        })
+            .catch(() => null);
+    }
+    const meta = user.user_metadata ?? {};
+    const name = [meta.full_name, meta.user_name, meta.name].find((v) => typeof v === "string" && v !== "");
+    const paid = tier === null ? null : isPaidTier(tier);
+    return {
+        ...base,
+        logged_in: true,
+        user_id: userId,
+        email: user.email ?? null,
+        name: name ?? null,
+        plan_tier: tier,
+        paid_plan: ctx.auth.mode === "deploy_token" ? true : paid,
+        subscription,
+        note: paid === false && ctx.auth.mode !== "deploy_token" ? UPGRADE_MESSAGE : null,
+    };
+}
+export function registerAccountTools(server, ctx) {
+    server.registerTool("whoami", {
+        title: "Show the micropage account in use",
+        description: `Report which micropage account this server acts as: email, plan tier, subscription, and whether it runs on the user's \`micropage login\` session or on a project deploy token (and if so, which project it is pinned to).
+
+Call it first when a micropage tool fails with a login, session or plan error, or when the user asks which account is connected. It never fails for a missing login: it returns logged_in false and a note saying what the user must do (usually run \`micropage login\` in a terminal). It does not log in, log out, or change anything.
+
+Do not call it before every task; the other tools report login and plan problems themselves.`,
+        inputSchema: WhoamiInput,
+        outputSchema: WhoamiOutput,
+        annotations: RO,
+    }, async () => {
+        const result = await runWhoami(ctx);
+        const summary = result.logged_in
+            ? `Signed in as ${result.email ?? result.user_id ?? "(unknown)"} (${result.plan_tier ?? "plan unknown"}, ${result.auth_mode}).`
+            : `Not signed in. ${result.note ?? ""}`.trim();
+        return structuredResult(result, summary);
+    });
+}
+//# sourceMappingURL=account.js.map

package/dist/tools/account.js.map

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