@ebitex/content-mcp 0.1.0

package/dist/tools/register.js

@@ -0,0 +1,212 @@
+import { z } from 'zod';
+import { query } from '../client.js';
+import { routesFor, withId, WRITABLE_KINDS } from '../routes.js';
+import { SCOPE_AUTHORING, SCOPE_PUBLISH, SCOPE_READ, SCOPE_WRITE } from '../session.js';
+import { fail, guard, ok } from './result.js';
+const KIND = z.enum(WRITABLE_KINDS);
+export function registerTools(server, context) {
+    const { client, session, target } = context;
+    // Everything below is gated on a scope, and an absent tool is the point: an agent that cannot see
+    // a tool will not plan around it, where a tool that is present and always 403s costs it a turn
+    // and a re-plan (§4).
+    const canRead = session.has(SCOPE_READ);
+    const canAuthor = session.has(SCOPE_AUTHORING);
+    const canPublish = session.has(SCOPE_PUBLISH);
+    const canTransfer = session.has(SCOPE_WRITE);
+    if (canRead) {
+        server.registerTool('content_describe', {
+            title: 'Describe what can exist here',
+            description: 'What this environment can hold: every field type with its own settings JSON Schema, ' +
+                'and the Contracts and Templates that already exist. Call this first — it is where the ' +
+                'shape of everything you are about to write comes from, and it is answered live by the ' +
+                'server rather than from anything this tool knows.',
+            inputSchema: {
+                include: z
+                    .array(z.enum(['fieldTypes', 'contracts', 'templates']))
+                    .optional()
+                    .describe('Defaults to all three.'),
+            },
+            annotations: { readOnlyHint: true, openWorldHint: true },
+        }, async ({ include }) => guard(async () => {
+            const wanted = new Set(include ?? ['fieldTypes', 'contracts', 'templates']);
+            const [fieldTypes, contracts, templates] = await Promise.all([
+                wanted.has('fieldTypes') ? client.request('GET', '/field-types') : undefined,
+                wanted.has('contracts') ? client.request('GET', '/contracts') : undefined,
+                wanted.has('templates') ? client.request('GET', '/templates') : undefined,
+            ]);
+            return ok({ fieldTypes, contracts, templates });
+        }));
+        server.registerTool('content_find', {
+            title: 'Find entities',
+            description: 'Locate entities in this environment. With no kind, returns a paged inventory of ' +
+                'everything; with a kind, only that kind. Use it to check whether something already ' +
+                'exists before creating a duplicate.',
+            inputSchema: {
+                kind: z.string().optional().describe('contract, template, component, adapter, stream, audience, categoryGroup, category, folder, node'),
+                search: z.string().optional().describe('Free-text search. Components only.'),
+                externalId: z.string().optional().describe('Exact match. Components only.'),
+                limit: z.number().int().min(1).max(200).optional(),
+                cursor: z.string().optional().describe('From a previous call\'s nextCursor.'),
+            },
+            annotations: { readOnlyHint: true, openWorldHint: true },
+        }, async ({ kind, search, externalId, limit, cursor }) => guard(async () => {
+            // Two listings, one tool, because both answer "what is already here" and an agent asking
+            // that should not have to know which of them can filter. The components listing is the
+            // only one that takes a query at all; /items is a flat inventory across every kind.
+            if (search !== undefined || externalId !== undefined) {
+                if (kind !== undefined && kind !== 'component') {
+                    return fail('search and externalId filter components only; drop them, or pass kind: "component".');
+                }
+                return ok(await client.request('GET', `/components${query({ search, externalId })}`));
+            }
+            return ok(await client.request('GET', `/items${query({ kind, limit, cursor })}`));
+        }));
+        server.registerTool('content_get', {
+            title: 'Read one entity',
+            description: 'Read a single entity in full, by id. Not every kind supports this — folders, audiences, ' +
+                'sites and taxonomy are read by listing them with content_find instead, and this tool ' +
+                'will say so rather than guess at a route.',
+            inputSchema: { kind: KIND, id: z.string() },
+            annotations: { readOnlyHint: true, openWorldHint: true },
+        }, async ({ kind, id }) => guard(async () => {
+            const routes = routesFor(kind);
+            if (!routes.readOne) {
+                return fail(`${routes.label} has no single-entity read on this API. Use content_find` +
+                    (routes.list ? ` (kind: "${kind}")` : '') +
+                    ' instead.');
+            }
+            return ok(await client.request('GET', withId(routes.readOne, id)));
+        }));
+    }
+    if (canAuthor) {
+        server.registerTool('content_write', {
+            title: 'Create or update an entity',
+            description: 'Create (omit id) or update (supply id) one entity. The payload is whatever that kind\'s ' +
+                'API takes — run content_describe first to learn it. The server validates what you send ' +
+                'and refuses an invalid document naming the failing field, so a refusal tells you exactly ' +
+                'what to change; correct it and call again.',
+            inputSchema: {
+                kind: KIND,
+                id: z.string().optional().describe('Omit to create.'),
+                payload: z.record(z.string(), z.unknown()).describe('The request body, as this kind\'s API defines it.'),
+            },
+            annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+        }, async ({ kind, id, payload }) => guard(async () => {
+            const routes = routesFor(kind);
+            if (!id) {
+                if (!routes.create) {
+                    return fail(`${routes.label} cannot be created on its own; it is written by updating its owner.`);
+                }
+                return ok(await client.request('POST', routes.create, payload), session.contextLine());
+            }
+            if (!routes.update) {
+                return fail(`${routes.label} cannot be updated once created.`);
+            }
+            // PATCH for an Adapter, PUT for everything else. Read from the table rather than assumed
+            // uniform — see routes.ts's header for why that distinction is load-bearing.
+            return ok(await client.request(routes.update.method, withId(routes.update.path, id), payload), session.contextLine());
+        }));
+        server.registerTool('content_delete', {
+            title: 'Delete an entity',
+            description: 'Permanently delete one entity. Requires confirm: true. Content refuses to delete ' +
+                'anything still in use and will name what depends on it, so a refusal here is the ' +
+                'product protecting you rather than an error to work around.',
+            inputSchema: {
+                kind: KIND,
+                id: z.string(),
+                confirm: z.boolean().describe('Must be true. There is no undo.'),
+            },
+            annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+        }, async ({ kind, id, confirm }) => guard(async () => {
+            // Refused locally rather than sent. An unconfirmed delete is not a request the server
+            // should have to judge, and asking it would mean the confirmation could be satisfied by
+            // a retry that happened to succeed.
+            if (!confirm)
+                return fail('Not deleted. Pass confirm: true to delete this permanently.');
+            const routes = routesFor(kind);
+            if (!routes.remove)
+                return fail(`${routes.label} cannot be deleted through this API.`);
+            await client.request('DELETE', withId(routes.remove, id));
+            return ok(`Deleted ${routes.label} ${id}.`, session.contextLine());
+        }));
+    }
+    if (canPublish) {
+        server.registerTool('content_publish', {
+            title: 'Publish content',
+            description: 'Publishing is two calls, and deliberately so. Pass roots to get a plan: it resolves the ' +
+                'whole dependency closure and reports blockers — an unresolved reference, a workflow ' +
+                'state, a validation failure. Read the plan, then call again with items to publish them. ' +
+                'Both phases are jobs: poll the returned operationId with content_operation_status.',
+            inputSchema: {
+                roots: z
+                    .array(z.record(z.string(), z.unknown()))
+                    .optional()
+                    .describe('Plan phase: the entities to publish, each { kind, id }.'),
+                items: z
+                    .array(z.record(z.string(), z.unknown()))
+                    .optional()
+                    .describe('Execute phase: the plan items to publish, taken from the finished plan.'),
+                deliveryEnvironmentId: z.string().optional().describe('Required only when several delivery targets are mapped.'),
+            },
+            annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+        }, async ({ roots, items, deliveryEnvironmentId }) => guard(async () => {
+            if ((roots === undefined) === (items === undefined)) {
+                return fail('Pass exactly one of roots (to plan) or items (to publish).');
+            }
+            const path = roots ? '/publish-plan' : '/publish';
+            const body = roots ? { roots, deliveryEnvironmentId } : { items, deliveryEnvironmentId };
+            return ok(await client.request('POST', path, body), session.contextLine());
+        }));
+    }
+    if (canRead) {
+        server.registerTool('content_operation_status', {
+            title: 'Check a job',
+            description: 'Poll a publish plan or publish job by its operationId. A finished job carries its ' +
+                'result — for a plan, that result is the plan itself.',
+            inputSchema: { operationId: z.string() },
+            annotations: { readOnlyHint: true, openWorldHint: true },
+        }, async ({ operationId }) => guard(async () => ok(await client.request('GET', `/operations/${encodeURIComponent(operationId)}`))));
+    }
+    if (canTransfer) {
+        server.registerTool('content_transfer', {
+            title: 'Move a model between environments',
+            description: 'Export this environment (or a set of roots) as a bundle, and — when a target key is ' +
+                'configured — import it into that target atomically. This is the one operation bundles ' +
+                'are uniquely good at: forty per-entity writes are forty transactions, and one import is ' +
+                'one. The bundle is produced and consumed by the server; nothing here builds it.',
+            inputSchema: {
+                roots: z.array(z.record(z.string(), z.unknown())).optional(),
+                wholeEnvironment: z.boolean().optional(),
+                apply: z
+                    .boolean()
+                    .optional()
+                    .describe('Import into the target environment. Without it, the bundle is only returned.'),
+                identityMode: z.enum(['fresh', 'existing', 'externalId']).optional(),
+            },
+            annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+        }, async ({ roots, wholeEnvironment, apply, identityMode }) => guard(async () => {
+            const bundle = await client.request('POST', '/export', {
+                roots,
+                wholeEnvironment: wholeEnvironment ?? roots === undefined,
+            });
+            if (!apply)
+                return ok(bundle);
+            if (!target) {
+                return fail('No target environment is configured. Set EBITEX_CONTENT_TARGET_MANAGEMENT_KEY to a ' +
+                    'key bound to the environment this should import into.');
+            }
+            const mode = identityMode ?? 'externalId';
+            const plan = (await target.request('POST', '/import-plan', { bundle, identityMode: mode }));
+            // The plan's own items are echoed back as the selection. `items[]` selects what is
+            // written (spec #623), so sending the plan unchanged is "apply everything this plan
+            // describes" — and it is the plan, not this code, that decided what that is.
+            const result = await target.request('POST', '/import', {
+                bundle,
+                identityMode: mode,
+                items: (plan.items ?? []).map((item) => ({ kind: item.kind, id: item.id })),
+            });
+            return ok({ plan, result });
+        }));
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/tools/register.js.map

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

package/dist/tools/result.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The shape every tool returns, and the one place a refusal is turned into text.
+ *
+ * MCP's own result type has an `isError` flag and a content array; what matters here is what goes
+ * into the array. SPEC.md's Business Logic §3 is the rule: a validation failure is the agent's
+ * control loop, so it is relayed whole, with its field paths intact, and never summarized. That is
+ * implemented by `ContentApiError.message` already carrying the whole body, so this module simply
+ * does not get in its way.
+ */
+export type ToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+    [key: string]: unknown;
+};
+export declare function ok(value: unknown, context?: string): ToolResult;
+export declare function fail(text: string): ToolResult;
+/**
+ * Runs a tool body, turning any thrown error into a result rather than a transport-level failure.
+ *
+ * A thrown error reaches the agent as a protocol error rather than a tool result in some clients,
+ * which is a worse place for a message it is meant to act on — so everything lands in `isError`
+ * instead, where the text is unambiguously part of the conversation.
+ */
+export declare function guard(run: () => Promise<ToolResult>): Promise<ToolResult>;
+//# sourceMappingURL=result.d.ts.map

package/dist/tools/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAG/D;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE7C;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAO/E"}

package/dist/tools/result.js

@@ -0,0 +1,26 @@
+import { ContentApiError } from '../errors.js';
+export function ok(value, context) {
+    const body = typeof value === 'string' ? value : JSON.stringify(value ?? null, null, 2);
+    return { content: [{ type: 'text', text: context ? `${context}\n${body}` : body }] };
+}
+export function fail(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+/**
+ * Runs a tool body, turning any thrown error into a result rather than a transport-level failure.
+ *
+ * A thrown error reaches the agent as a protocol error rather than a tool result in some clients,
+ * which is a worse place for a message it is meant to act on — so everything lands in `isError`
+ * instead, where the text is unambiguously part of the conversation.
+ */
+export async function guard(run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        if (error instanceof ContentApiError)
+            return fail(error.message);
+        return fail(error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAkB9C,MAAM,UAAU,EAAE,CAAC,KAAc,EAAE,OAAgB;IACjD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACvF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAA8B;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAChE,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACrE,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@ebitex/content-mcp",
+  "version": "0.1.0",
+  "description": "An MCP server for ebitex Content: build and publish a content model from an AI agent.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "ebitex-content-mcp": "./dist/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "node scripts/bundleHelp.mjs",
+    "build": "npm run prebuild && tsc -p tsconfig.build.json",
+    "lint": "oxlint",
+    "pretest": "node scripts/bundleHelp.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "oxlint": "^1.71.0",
+    "typescript": "~6.0.2",
+    "vitest": "^4.1.10"
+  }
+}