@plumix/core 0.1.0

package/dist/mcp/content-tools.js

@@ -0,0 +1,67 @@
+import * as v from "valibot";
+import { EntryReadError } from "../entries/errors.js";
+import { getEntry, listEntries } from "../entries/read-service.js";
+import { entryListInputSchema } from "../rpc/procedures/entry/schemas.js";
+import { idParam } from "../rpc/validation.js";
+import { McpToolError } from "./errors.js";
+// Curated read surface: the entries list shape minus the admin-shaped filters
+// (author / parent / taxonomy). Picked from the canonical schema so validation
+// and the advertised JSON Schema can't drift from it.
+const contentListInputSchema = v.pick(entryListInputSchema, [
+    "type",
+    "status",
+    "search",
+    "orderBy",
+    "order",
+    "limit",
+    "offset",
+]);
+const contentGetInputSchema = v.object({
+    type: v.pipe(v.string(), v.description("Entry type the id must belong to.")),
+    id: idParam,
+});
+function asMcpToolError(error) {
+    if (!(error instanceof EntryReadError))
+        throw error;
+    switch (error.data.code) {
+        case "not_found":
+            return McpToolError.notFound(error.message);
+        case "forbidden":
+            return McpToolError.forbidden(error.message);
+        case "reserved_type":
+            return McpToolError.badInput(error.message);
+    }
+}
+export const contentListTool = {
+    name: "content_list",
+    description: "List entries of a type, filtered by status/search and ordered/paginated. Results are clamped to what your token may read.",
+    inputSchema: contentListInputSchema,
+    async run(ctx, input) {
+        try {
+            return await listEntries(ctx, input);
+        }
+        catch (error) {
+            throw asMcpToolError(error);
+        }
+    },
+};
+export const contentGetTool = {
+    name: "content_get",
+    description: "Read a single entry in full by its type and id.",
+    inputSchema: contentGetInputSchema,
+    async run(ctx, input) {
+        try {
+            const entry = await getEntry(ctx, { id: input.id });
+            // Scope the lookup to the requested type — a mismatch stays hidden as
+            // not-found rather than leaking that an id exists under another type.
+            if (entry.type !== input.type) {
+                throw EntryReadError.notFound(input.id);
+            }
+            return entry;
+        }
+        catch (error) {
+            throw asMcpToolError(error);
+        }
+    },
+};
+//# sourceMappingURL=content-tools.js.map

package/dist/mcp/content-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tools.js","sourceRoot":"","sources":["../../src/mcp/content-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,8EAA8E;AAC9E,+EAA+E;AAC/E,sDAAsD;AACtD,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,EAAE;IAC1D,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAC5E,EAAE,EAAE,OAAO;CACZ,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;QAAE,MAAM,KAAK,CAAC;IACpD,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,eAAe;YAClB,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,2HAA2H;IAC7H,WAAW,EAAE,sBAAsB;IACnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK;QAClB,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,iDAAiD;IAC9D,WAAW,EAAE,qBAAqB;IAClC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK;QAClB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,sEAAsE;YACtE,sEAAsE;YACtE,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/mcp/dispatch.d.ts

@@ -0,0 +1,12 @@
+import type { AppContext } from "../context/app.js";
+/**
+ * Serve the first-party MCP endpoint. Mounted ahead of the `/_plumix/` CSRF
+ * gate and authenticated by bearer PAT (CSRF-immune). POST-only; the transport
+ * itself would turn a GET into an SSE stream, so the method check lives here.
+ *
+ * The MCP SDK and the valibot→JSON-Schema converter load via dynamic import so
+ * public/cold-start paths never evaluate them — only the lightweight tool
+ * registry stays in the main graph.
+ */
+export declare function handleMcpRequest(ctx: AppContext): Promise<Response>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/mcp/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/mcp/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBzE"}

package/dist/mcp/dispatch.js

@@ -0,0 +1,30 @@
+import { authenticateBearer } from "../auth/bearer.js";
+import { methodNotAllowed, unauthorized } from "../runtime/http.js";
+import { buildMcpToolRegistry } from "./registry.js";
+/**
+ * Serve the first-party MCP endpoint. Mounted ahead of the `/_plumix/` CSRF
+ * gate and authenticated by bearer PAT (CSRF-immune). POST-only; the transport
+ * itself would turn a GET into an SSE stream, so the method check lives here.
+ *
+ * The MCP SDK and the valibot→JSON-Schema converter load via dynamic import so
+ * public/cold-start paths never evaluate them — only the lightweight tool
+ * registry stays in the main graph.
+ */
+export async function handleMcpRequest(ctx) {
+    if (ctx.request.method !== "POST")
+        return methodNotAllowed(["POST"]);
+    const authedCtx = await authenticateBearer(ctx);
+    if (!authedCtx)
+        return unauthorized();
+    const tools = buildMcpToolRegistry(authedCtx.plugins);
+    const { buildMcpServer } = await import("./server.js");
+    const { WebStandardStreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js");
+    const server = buildMcpServer(authedCtx, tools);
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableJsonResponse: true,
+    });
+    await server.connect(transport);
+    return transport.handleRequest(authedCtx.request);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/mcp/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/mcp/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAe;IACpD,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS;QAAE,OAAO,YAAY,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEtD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,EAAE,wCAAwC,EAAE,GAChD,MAAM,MAAM,CAAC,+DAA+D,CAAC,CAAC;IAEhF,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC;QAC7D,kBAAkB,EAAE,SAAS;QAC7B,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/mcp/errors.d.ts

@@ -0,0 +1,29 @@
+type McpToolErrorCode = "not_found" | "forbidden" | "bad_input";
+/**
+ * Domain error a tool's `run` throws to signal a caller-facing condition. The
+ * call-tool handler maps these to MCP error envelopes ({@link toToolErrorResult});
+ * anything else propagates as a protocol-level JSON-RPC error.
+ */
+export declare class McpToolError extends Error {
+    readonly code: McpToolErrorCode;
+    private constructor();
+    static notFound(message: string): McpToolError;
+    static forbidden(message: string): McpToolError;
+    static badInput(message: string): McpToolError;
+}
+interface McpToolErrorResult {
+    readonly isError: true;
+    readonly content: {
+        readonly type: "text";
+        readonly text: string;
+    }[];
+    readonly [key: string]: unknown;
+}
+/**
+ * Map a domain error to an MCP tool-result envelope (`isError: true`) so the
+ * client sees a clear, non-crashing failure. The code is prefixed so an agent
+ * can branch on it; the message carries the human-readable detail.
+ */
+export declare function toToolErrorResult(error: McpToolError): McpToolErrorResult;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhE;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAKrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,OAAO;IAKP,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAI9C,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAI/C,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CAG/C;AAID,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,kBAAkB,CAKzE"}

package/dist/mcp/errors.js

@@ -0,0 +1,36 @@
+/**
+ * Domain error a tool's `run` throws to signal a caller-facing condition. The
+ * call-tool handler maps these to MCP error envelopes ({@link toToolErrorResult});
+ * anything else propagates as a protocol-level JSON-RPC error.
+ */
+export class McpToolError extends Error {
+    static {
+        McpToolError.prototype.name = "McpToolError";
+    }
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+    static notFound(message) {
+        return new McpToolError("not_found", message);
+    }
+    static forbidden(message) {
+        return new McpToolError("forbidden", message);
+    }
+    static badInput(message) {
+        return new McpToolError("bad_input", message);
+    }
+}
+/**
+ * Map a domain error to an MCP tool-result envelope (`isError: true`) so the
+ * client sees a clear, non-crashing failure. The code is prefixed so an agent
+ * can branch on it; the message carries the human-readable detail.
+ */
+export function toToolErrorResult(error) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: `${error.code}: ${error.message}` }],
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;QACE,YAAY,CAAC,SAAS,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/C,CAAC;IAEQ,IAAI,CAAmB;IAEhC,YAAoB,IAAsB,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC7B,OAAO,IAAI,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAe;QAC9B,OAAO,IAAI,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC7B,OAAO,IAAI,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAUD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export type { McpTool } from "./tool.js";
+export { McpToolError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,2 @@
+export { McpToolError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/registry.d.ts

@@ -0,0 +1,13 @@
+import type { PluginRegistry } from "../plugin/manifest.js";
+import type { McpTool } from "./tool.js";
+/**
+ * Tools core contributes unconditionally — the MCP analogue of `appRouter`.
+ * Plugins add their own through `registerMcpTool`; the two merge in
+ * {@link buildMcpToolRegistry}.
+ */
+export declare const coreMcpTools: readonly McpTool[];
+export declare const CORE_MCP_TOOL_NAMES: ReadonlySet<string>;
+/** Merge core tools with plugin-registered tools into a name-keyed map.
+ *  Collisions are already rejected at registration, so insertion is plain. */
+export declare function buildMcpToolRegistry(plugins: PluginRegistry): Map<string, McpTool>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/mcp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,OAAO,EAO1C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAEnD,CAAC;AAEF;8EAC8E;AAC9E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,GACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAKtB"}

package/dist/mcp/registry.js

@@ -0,0 +1,28 @@
+import { contentGetTool, contentListTool } from "./content-tools.js";
+import { schemaDescribeTool } from "./schema-describe.js";
+import { taxonomyListTool, termGetTool, termListTool } from "./term-tools.js";
+/**
+ * Tools core contributes unconditionally — the MCP analogue of `appRouter`.
+ * Plugins add their own through `registerMcpTool`; the two merge in
+ * {@link buildMcpToolRegistry}.
+ */
+export const coreMcpTools = [
+    schemaDescribeTool,
+    contentListTool,
+    contentGetTool,
+    termListTool,
+    termGetTool,
+    taxonomyListTool,
+];
+export const CORE_MCP_TOOL_NAMES = new Set(coreMcpTools.map((tool) => tool.name));
+/** Merge core tools with plugin-registered tools into a name-keyed map.
+ *  Collisions are already rejected at registration, so insertion is plain. */
+export function buildMcpToolRegistry(plugins) {
+    const tools = new Map();
+    for (const tool of coreMcpTools)
+        tools.set(tool.name, tool);
+    for (const { tool } of plugins.mcpTools.values())
+        tools.set(tool.name, tool);
+    return tools;
+}
+//# sourceMappingURL=registry.js.map

package/dist/mcp/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB;IAC9C,kBAAkB;IAClB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,WAAW;IACX,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAC7D,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CACtC,CAAC;AAEF;8EAC8E;AAC9E,MAAM,UAAU,oBAAoB,CAClC,OAAuB;IAEvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,YAAY;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5D,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp/schema-describe.d.ts

@@ -0,0 +1,13 @@
+import * as v from "valibot";
+import type { McpTool } from "./tool.js";
+declare const inputSchema: v.ObjectSchema<{
+    readonly type: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Entry type name to inspect; omit to list the whole model.">]>, undefined>;
+}, undefined>;
+/**
+ * The content-model introspection tool. With no argument it lists entry types
+ * and taxonomies; with a `type` it returns that type's statuses, supports, and
+ * taxonomies. Backed entirely by the in-memory manifest — no DB access.
+ */
+export declare const schemaDescribeTool: McpTool<typeof inputSchema>;
+export {};
+//# sourceMappingURL=schema-describe.d.ts.map

package/dist/mcp/schema-describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-describe.d.ts","sourceRoot":"","sources":["../../src/mcp/schema-describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,QAAA,MAAM,WAAW;;aASf,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,WAAW,CAsC1D,CAAC"}

package/dist/mcp/schema-describe.js

@@ -0,0 +1,49 @@
+import * as v from "valibot";
+import { ENTRY_STATUSES } from "../db/schema/entries.js";
+import { labelSourceText } from "../i18n/label.js";
+import { McpToolError } from "./errors.js";
+const inputSchema = v.object({
+    type: v.optional(v.pipe(v.string(), v.description("Entry type name to inspect; omit to list the whole model."))),
+});
+/**
+ * The content-model introspection tool. With no argument it lists entry types
+ * and taxonomies; with a `type` it returns that type's statuses, supports, and
+ * taxonomies. Backed entirely by the in-memory manifest — no DB access.
+ */
+export const schemaDescribeTool = {
+    name: "schema_describe",
+    description: "Describe the content model — entry types, statuses, supports, and taxonomies. Call with no argument to list everything, or with `type` to inspect one entry type.",
+    inputSchema,
+    run(ctx, input) {
+        const { entryTypes, termTaxonomies } = ctx.plugins;
+        if (input.type === undefined) {
+            return {
+                entryTypes: [...entryTypes.values()].map((entryType) => ({
+                    name: entryType.name,
+                    label: labelSourceText(entryType.label),
+                    isHierarchical: entryType.isHierarchical ?? false,
+                    supports: entryType.supports ?? [],
+                    taxonomies: entryType.termTaxonomies ?? [],
+                })),
+                taxonomies: [...termTaxonomies.values()].map((taxonomy) => ({
+                    name: taxonomy.name,
+                    label: labelSourceText(taxonomy.label),
+                    isHierarchical: taxonomy.isHierarchical ?? false,
+                })),
+            };
+        }
+        const entryType = entryTypes.get(input.type);
+        if (entryType === undefined) {
+            throw McpToolError.notFound(`unknown entry type: "${input.type}"`);
+        }
+        return {
+            name: entryType.name,
+            label: labelSourceText(entryType.label),
+            isHierarchical: entryType.isHierarchical ?? false,
+            statuses: [...ENTRY_STATUSES],
+            supports: entryType.supports ?? [],
+            taxonomies: entryType.termTaxonomies ?? [],
+        };
+    },
+};
+//# sourceMappingURL=schema-describe.js.map

package/dist/mcp/schema-describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-describe.js","sourceRoot":"","sources":["../../src/mcp/schema-describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,QAAQ,CACd,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,WAAW,CACX,2DAA2D,CAC5D,CACF,CACF;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mKAAmK;IACrK,WAAW;IACX,GAAG,CAAC,GAAG,EAAE,KAAK;QACZ,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QAEnD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;oBACvD,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC;oBACvC,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,KAAK;oBACjD,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,EAAE;oBAClC,UAAU,EAAE,SAAS,CAAC,cAAc,IAAI,EAAE;iBAC3C,CAAC,CAAC;gBACH,UAAU,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC1D,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACtC,cAAc,EAAE,QAAQ,CAAC,cAAc,IAAI,KAAK;iBACjD,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,YAAY,CAAC,QAAQ,CAAC,wBAAwB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC;YACvC,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,KAAK;YACjD,QAAQ,EAAE,CAAC,GAAG,cAAc,CAAC;YAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,EAAE;YAClC,UAAU,EAAE,SAAS,CAAC,cAAc,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/schema-projection.d.ts

@@ -0,0 +1,5 @@
+import type { McpTool } from "./tool.js";
+/** Project a tool's valibot input to the JSON Schema advertised in `tools/list`,
+ *  preferring a hand-written `jsonSchema` override when present. */
+export declare function toToolInputJsonSchema(tool: McpTool): Record<string, unknown>;
+//# sourceMappingURL=schema-projection.d.ts.map

package/dist/mcp/schema-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-projection.d.ts","sourceRoot":"","sources":["../../src/mcp/schema-projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;oEACoE;AACpE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK5E"}

package/dist/mcp/schema-projection.js

@@ -0,0 +1,11 @@
+import { toJsonSchema } from "@valibot/to-json-schema";
+/** Project a tool's valibot input to the JSON Schema advertised in `tools/list`,
+ *  preferring a hand-written `jsonSchema` override when present. */
+export function toToolInputJsonSchema(tool) {
+    if (tool.jsonSchema !== undefined)
+        return tool.jsonSchema;
+    return toJsonSchema(tool.inputSchema, {
+        errorMode: "ignore",
+    });
+}
+//# sourceMappingURL=schema-projection.js.map

package/dist/mcp/schema-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-projection.js","sourceRoot":"","sources":["../../src/mcp/schema-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvD;oEACoE;AACpE,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC;IAC1D,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,QAAQ;KACpB,CAA4B,CAAC;AAChC,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,7 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { AppContext } from "../context/app.js";
+import type { McpTool } from "./tool.js";
+/** Build a low-level MCP `Server` over a tool registry, closing over the
+ *  bearer-authed `ctx` that each tool's `run` receives. */
+export declare function buildMcpServer(ctx: AppContext, tools: ReadonlyMap<string, McpTool>): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AASnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC;2DAC2D;AAC3D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CA0CR"}

package/dist/mcp/server.js

@@ -0,0 +1,40 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import * as v from "valibot";
+import { McpToolError, toToolErrorResult } from "./errors.js";
+import { toToolInputJsonSchema } from "./schema-projection.js";
+const SERVER_INFO = { name: "plumix", version: "0.1.0" };
+/** Build a low-level MCP `Server` over a tool registry, closing over the
+ *  bearer-authed `ctx` that each tool's `run` receives. */
+export function buildMcpServer(ctx, tools) {
+    const server = new Server(SERVER_INFO, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [...tools.values()].map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: toToolInputJsonSchema(tool),
+            annotations: { readOnlyHint: true },
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = tools.get(request.params.name);
+        if (tool === undefined) {
+            throw new McpError(ErrorCode.MethodNotFound, `unknown tool: "${request.params.name}"`);
+        }
+        const parsed = v.safeParse(tool.inputSchema, request.params.arguments ?? {});
+        if (!parsed.success) {
+            throw new McpError(ErrorCode.InvalidParams, v.summarize(parsed.issues));
+        }
+        try {
+            const result = await tool.run(ctx, parsed.output);
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (error) {
+            if (error instanceof McpToolError)
+                return toToolErrorResult(error);
+            throw error;
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAI7B,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC;AAElE;2DAC2D;AAC3D,MAAM,UAAU,cAAc,CAC5B,GAAe,EACf,KAAmC;IAEnC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAExE,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,qBAAqB,CAAC,IAAI,CAAC;YACxC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;SACpC,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CACtB,qBAAqB,EACrB,KAAK,EAAE,OAAO,EAA2B,EAAE;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,kBAAkB,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CACzC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CACxB,IAAI,CAAC,WAAW,EAChB,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAC/B,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY;gBAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/term-tools.d.ts

@@ -0,0 +1,59 @@
+import * as v from "valibot";
+import type { McpTool } from "./tool.js";
+declare const termListInput: Omit<v.ObjectSchema<{
+    readonly taxonomy: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+    readonly parentId: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, number, undefined>]>, undefined>, undefined>;
+    readonly search: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 200, undefined>]>, 50>;
+    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 0>;
+}, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: Pick<{
+        readonly taxonomy: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+        readonly parentId: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, number, undefined>]>, undefined>, undefined>;
+        readonly search: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 200, undefined>]>, 50>;
+        readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 0>;
+    }, "search" | "taxonomy" | "limit" | "offset">;
+    readonly "~standard": v.StandardProps<{
+        search?: string | undefined;
+        taxonomy: string;
+        limit?: number | undefined;
+        offset?: number | undefined;
+    }, {
+        search?: string | undefined;
+        taxonomy: string;
+        limit: number;
+        offset: number;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+        search?: string | undefined;
+        taxonomy: string;
+        limit: number;
+        offset: number;
+    }, v.StringIssue | v.MinLengthIssue<string, 1> | v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number> | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 100> | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 200>>;
+    readonly "~types"?: {
+        readonly input: {
+            search?: string | undefined;
+            taxonomy: string;
+            limit?: number | undefined;
+            offset?: number | undefined;
+        };
+        readonly output: {
+            search?: string | undefined;
+            taxonomy: string;
+            limit: number;
+            offset: number;
+        };
+        readonly issue: v.StringIssue | v.MinLengthIssue<string, 1> | v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number> | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 100> | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 200>;
+    } | undefined;
+};
+declare const termGetInput: v.ObjectSchema<{
+    readonly taxonomy: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Taxonomy the id must belong to.">]>;
+    readonly id: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, number, undefined>]>;
+}, undefined>;
+declare const emptyInput: v.ObjectSchema<{}, undefined>;
+export declare const termListTool: McpTool<typeof termListInput>;
+export declare const termGetTool: McpTool<typeof termGetInput>;
+export declare const taxonomyListTool: McpTool<typeof emptyInput>;
+export {};
+//# sourceMappingURL=term-tools.d.ts.map

package/dist/mcp/term-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"term-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/term-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKjB,CAAC;AAEH,QAAA,MAAM,YAAY;;;aAMhB,CAAC;AAEH,QAAA,MAAM,UAAU,+BAAe,CAAC;AAahC,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,OAAO,aAAa,CAYtD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,OAAO,YAAY,CAiBpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,OAAO,UAAU,CAavD,CAAC"}

package/dist/mcp/term-tools.js

@@ -0,0 +1,77 @@
+import * as v from "valibot";
+import { labelSourceText } from "../i18n/label.js";
+import { termListInputSchema } from "../rpc/procedures/term/schemas.js";
+import { idParam } from "../rpc/validation.js";
+import { TermReadError } from "../terms/errors.js";
+import { getTerm, listTerms } from "../terms/read-service.js";
+import { McpToolError } from "./errors.js";
+// Curated read surface: taxonomy + search + pagination, picked from the
+// canonical schema so validation and the advertised JSON Schema can't drift.
+const termListInput = v.pick(termListInputSchema, [
+    "taxonomy",
+    "search",
+    "limit",
+    "offset",
+]);
+const termGetInput = v.object({
+    taxonomy: v.pipe(v.string(), v.description("Taxonomy the id must belong to.")),
+    id: idParam,
+});
+const emptyInput = v.object({});
+function asMcpToolError(error) {
+    if (!(error instanceof TermReadError))
+        throw error;
+    switch (error.data.code) {
+        case "taxonomy_not_found":
+        case "term_not_found":
+            return McpToolError.notFound(error.message);
+        case "forbidden":
+            return McpToolError.forbidden(error.message);
+    }
+}
+export const termListTool = {
+    name: "term_list",
+    description: "List terms (categories/tags) in a taxonomy, optionally filtered by search and paginated.",
+    inputSchema: termListInput,
+    async run(ctx, input) {
+        try {
+            return await listTerms(ctx, input);
+        }
+        catch (error) {
+            throw asMcpToolError(error);
+        }
+    },
+};
+export const termGetTool = {
+    name: "term_get",
+    description: "Read a single term in full by its taxonomy and id.",
+    inputSchema: termGetInput,
+    async run(ctx, input) {
+        try {
+            const term = await getTerm(ctx, { id: input.id });
+            // Scope the lookup to the requested taxonomy — a mismatch stays hidden
+            // as not-found rather than leaking that an id exists elsewhere.
+            if (term.taxonomy !== input.taxonomy) {
+                throw TermReadError.termNotFound(input.id);
+            }
+            return term;
+        }
+        catch (error) {
+            throw asMcpToolError(error);
+        }
+    },
+};
+export const taxonomyListTool = {
+    name: "taxonomy_list",
+    description: "List the taxonomies in the content model — name, label, whether hierarchical, and the entry types they apply to.",
+    inputSchema: emptyInput,
+    run(ctx) {
+        return [...ctx.plugins.termTaxonomies.values()].map((taxonomy) => ({
+            name: taxonomy.name,
+            label: labelSourceText(taxonomy.label),
+            isHierarchical: taxonomy.isHierarchical ?? false,
+            entryTypes: taxonomy.entryTypes ?? [],
+        }));
+    },
+};
+//# sourceMappingURL=term-tools.js.map

package/dist/mcp/term-tools.js.map

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

package/dist/mcp/tool.d.ts

@@ -0,0 +1,20 @@
+import type { GenericSchema, InferOutput } from "valibot";
+import type { AppContext } from "../context/app.js";
+/**
+ * One MCP tool: a name, a description, a valibot input schema authored once
+ * (projected to JSON Schema for `tools/list`, validated on `tools/call`), and
+ * a `run` that delegates to a service. Mirrors how `PluginRpcRouter` describes
+ * an RPC surface — the registry is the seam, `run` is the adapter.
+ */
+export interface McpTool<TSchema extends GenericSchema = GenericSchema> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: TSchema;
+    /**
+     * Hand-written JSON Schema override for inputs the valibot converter can't
+     * render faithfully. When set, it replaces the projected schema verbatim.
+     */
+    readonly jsonSchema?: Record<string, unknown>;
+    run(ctx: AppContext, input: InferOutput<TSchema>): unknown;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/mcp/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/mcp/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D"}

package/dist/mcp/tool.js

@@ -0,0 +1 @@
+//# sourceMappingURL=tool.js.map

package/dist/mcp/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/mcp/tool.ts"],"names":[],"mappings":""}