@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/mcp/guide.js

@@ -0,0 +1,97 @@
+import { HOSTED_GUIDE_TEMPLATE } from '../generated/hosted-guide.js';
+export const GUIDE_TOPICS = [
+    'overview',
+    'workflow',
+    'commands',
+    'troubleshooting',
+    'hosted',
+];
+export const GUIDE_RESOURCE_URI = 'cms-edit://guide';
+export const ONBOARDING_PROMPTS = [
+    'cms_edit_verify',
+    'cms_edit_explore',
+    'cms_edit_edit_page',
+    'cms_edit_edit_article',
+    'cms_edit_index_sync',
+    'cms_edit_create_page',
+    'cms_edit_create_article',
+    'cms_edit_create_from_doc',
+    'cms_edit_create_article_from_doc',
+    'cms_edit_taxonomy',
+    'cms_edit_bulk_seo',
+    'cms_edit_bulk_find_replace',
+    'cms_edit_bulk_article_tags',
+    'cms_edit_import_authors',
+    'cms_edit_media',
+];
+export const GETTING_STARTED_INFO = {
+    resourceUri: GUIDE_RESOURCE_URI,
+    prompts: [...ONBOARDING_PROMPTS],
+    helpTool: 'cms_edit_help',
+};
+const DEFAULT_EXAMPLE_SLUGS = ['/', '/pricing'];
+const TOPIC_HEADINGS = {
+    workflow: '## Core workflow',
+    commands: '## Command reference (cms_edit args)',
+    troubleshooting: '## Troubleshooting',
+    hosted: '## Hosted connector rules',
+};
+export function loadHostedGuideTemplate() {
+    return HOSTED_GUIDE_TEMPLATE;
+}
+function buildSiteIntro(hosted) {
+    if (hosted) {
+        const siteName = hosted.displayName ?? hosted.projectKey;
+        return (`This deployment is configured for **${siteName}** (project key \`${hosted.projectKey}\`). ` +
+            'You are using the hosted Claude Integrations connector — no local config files or `--space` flag needed.');
+    }
+    return ("Connect via your site's hosted `/cms-edit` MCP URL (Claude Integrations + OAuth). " +
+        'Local stdio MCP is not supported. For terminal/IDE agents, run `cms-edit` CLI with `.contentful-cms.json`.');
+}
+function buildHostedRules(hosted) {
+    if (hosted) {
+        return ('- **Do not pass `--space`** — this deployment is already bound to one Contentful space.\n' +
+            '- You sign in with Contentful OAuth; edits appear under your name.\n' +
+            '- Redeploy the hosted server to pick up cms-edit updates; editors do not reconnect for tool changes.');
+    }
+    return ("- Connect Claude via your site's `/cms-edit` hosted MCP URL — do not use local `mcpServers` config.\n" +
+        '- For CLI/agents in a repo: `.contentful-cms.json` and `--space <name>` when multiple spaces are configured.\n' +
+        '- Install skills: `npx skills add @se-studio/skills`.');
+}
+export function buildGuideMarkdown(hosted) {
+    const exampleSlug = hosted?.exampleSlugs?.[1] ?? DEFAULT_EXAMPLE_SLUGS[1] ?? '/pricing';
+    return loadHostedGuideTemplate()
+        .replace('{{SITE_INTRO}}', buildSiteIntro(hosted))
+        .replace('{{HOSTED_RULES}}', buildHostedRules(hosted))
+        .replaceAll('{{EXAMPLE_SLUG}}', exampleSlug);
+}
+export function extractGuideTopic(markdown, topic) {
+    if (topic === 'overview') {
+        return markdown.trim();
+    }
+    const heading = TOPIC_HEADINGS[topic];
+    const start = markdown.indexOf(heading);
+    if (start === -1) {
+        return markdown.trim();
+    }
+    const afterHeading = markdown.slice(start);
+    const nextHeadingIndex = afterHeading.indexOf('\n## ', 1);
+    if (nextHeadingIndex === -1) {
+        return afterHeading.trim();
+    }
+    return afterHeading.slice(0, nextHeadingIndex).trim();
+}
+export function getGuideTopicMarkdown(topic, hosted) {
+    const markdown = buildGuideMarkdown(hosted);
+    return extractGuideTopic(markdown, topic);
+}
+export function parseGuideTopic(value) {
+    if (!value || value === 'overview') {
+        return 'overview';
+    }
+    if (GUIDE_TOPICS.includes(value)) {
+        return value;
+    }
+    throw new Error(`Unknown guide topic "${value}". Valid topics: ${GUIDE_TOPICS.join(', ')}`);
+}
+//# sourceMappingURL=guide.js.map

package/dist/mcp/guide.js.map

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

package/dist/mcp/hosted-metadata.d.ts

@@ -0,0 +1,12 @@
+import type { HostedMcpInfo } from './guide.js';
+export declare function getHostedSiteLabel(hosted: HostedMcpInfo): string;
+/** MCP server name exposed to clients (e.g. Cowork tool groups). */
+export declare function getHostedMcpServerName(hosted?: HostedMcpInfo): string;
+/** Prefix tool/prompt descriptions so multi-connector clients can route by site name. */
+export declare function prefixHostedToolDescription(description: string, hosted?: HostedMcpInfo): string;
+export declare function buildHostedVersionPayload(versionInfo: {
+    name: string;
+    version: string;
+    package: string;
+}, hosted?: HostedMcpInfo): Record<string, string | boolean>;
+//# sourceMappingURL=hosted-metadata.d.ts.map

package/dist/mcp/hosted-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-metadata.d.ts","sourceRoot":"","sources":["../../src/mcp/hosted-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAKrE;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAK/F;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC/D,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAWlC"}

package/dist/mcp/hosted-metadata.js

@@ -0,0 +1,30 @@
+export function getHostedSiteLabel(hosted) {
+    return hosted.displayName ?? hosted.projectKey;
+}
+/** MCP server name exposed to clients (e.g. Cowork tool groups). */
+export function getHostedMcpServerName(hosted) {
+    if (!hosted?.projectKey) {
+        return 'cms-edit';
+    }
+    return `cms-edit-${hosted.projectKey}`;
+}
+/** Prefix tool/prompt descriptions so multi-connector clients can route by site name. */
+export function prefixHostedToolDescription(description, hosted) {
+    if (!hosted?.projectKey) {
+        return description;
+    }
+    return `[${getHostedSiteLabel(hosted)} cms-edit] ${description}`;
+}
+export function buildHostedVersionPayload(versionInfo, hosted) {
+    const payload = { ok: true, ...versionInfo };
+    if (!hosted?.projectKey) {
+        return payload;
+    }
+    payload['projectKey'] = hosted.projectKey;
+    payload['displayName'] = getHostedSiteLabel(hosted);
+    if (hosted.spaceId) {
+        payload['spaceId'] = hosted.spaceId;
+    }
+    return payload;
+}
+//# sourceMappingURL=hosted-metadata.js.map

package/dist/mcp/hosted-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-metadata.js","sourceRoot":"","sources":["../../src/mcp/hosted-metadata.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,OAAO,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC;AACjD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,MAAsB;IAC3D,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,YAAY,MAAM,CAAC,UAAU,EAAE,CAAC;AACzC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,2BAA2B,CAAC,WAAmB,EAAE,MAAsB;IACrF,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,cAAc,WAAW,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAA+D,EAC/D,MAAsB;IAEtB,MAAM,OAAO,GAAqC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAC/E,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;IAC1C,OAAO,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/mcp/http-handler.d.ts

@@ -0,0 +1,15 @@
+import type { CmsEditRuntimeContext } from '../runtime/context.js';
+import type { HostedMcpInfo } from './guide.js';
+export interface HostedMcpHandlerOptions {
+    /** Builds runtime context (config, user, session store) from the incoming request. */
+    resolveContext: (request: Request) => Promise<CmsEditRuntimeContext>;
+    /** Optional deployment info for guide/prompt interpolation. */
+    getMcpInfo?: () => HostedMcpInfo | undefined;
+    /** Path to generated editor-pack/ for cms-edit://customer/* resources. */
+    editorPackPath?: string;
+}
+/**
+ * Handles a Streamable HTTP MCP request in stateless mode (suitable for Vercel serverless).
+ */
+export declare function handleHostedMcpRequest(request: Request, options: HostedMcpHandlerOptions): Promise<Response>;
+//# sourceMappingURL=http-handler.d.ts.map

package/dist/mcp/http-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.d.ts","sourceRoot":"","sources":["../../src/mcp/http-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC,sFAAsF;IACtF,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrE,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAC7C,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,QAAQ,CAAC,CA2BnB"}

package/dist/mcp/http-handler.js

@@ -0,0 +1,38 @@
+import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+import { runCmsEditArgs } from '../cli/runner.js';
+import { runWithCmsEditContext } from '../runtime/context.js';
+import { sessionLogVerbose } from '../session/log.js';
+import { createMcpServer } from './server.js';
+async function defaultRunCmsEdit(args) {
+    const { exitCode, output } = await runCmsEditArgs(args);
+    return exitCode !== 0 ? `${output}\n(exit code ${exitCode})` : output;
+}
+/**
+ * Handles a Streamable HTTP MCP request in stateless mode (suitable for Vercel serverless).
+ */
+export async function handleHostedMcpRequest(request, options) {
+    const context = await options.resolveContext(request);
+    return runWithCmsEditContext(context, async () => {
+        const runCmsEdit = async (args) => {
+            sessionLogVerbose('hosted mcp cms_edit', {
+                args,
+                userId: context.user?.userId,
+                store: context.sessionStore?.constructor.name ?? 'FileSessionStore',
+            });
+            process.env['CMS_EDIT_JSON'] = '1';
+            return defaultRunCmsEdit(args);
+        };
+        const server = createMcpServer({
+            runCmsEdit,
+            hosted: options.getMcpInfo?.(),
+            editorPackPath: options.editorPackPath,
+        });
+        const transport = new WebStandardStreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true,
+        });
+        await server.connect(transport);
+        return transport.handleRequest(request);
+    });
+}
+//# sourceMappingURL=http-handler.js.map

package/dist/mcp/http-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.js","sourceRoot":"","sources":["../../src/mcp/http-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAW9C,KAAK,UAAU,iBAAiB,CAAC,IAAc;IAC7C,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,gBAAgB,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,OAAgC;IAEhC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAEtD,OAAO,qBAAqB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,UAAU,GAAG,KAAK,EAAE,IAAc,EAAE,EAAE;YAC1C,iBAAiB,CAAC,qBAAqB,EAAE;gBACvC,IAAI;gBACJ,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM;gBAC5B,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,kBAAkB;aACpE,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC;YACnC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,eAAe,CAAC;YAC7B,UAAU;YACV,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC;YAC7D,kBAAkB,EAAE,SAAS;YAC7B,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/prompts/onboarding.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HostedMcpInfo } from '../guide.js';
+export declare function registerOnboardingPrompts(server: McpServer, hosted?: HostedMcpInfo): void;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/mcp/prompts/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwBjD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CA+ezF"}

package/dist/mcp/prompts/onboarding.js

@@ -0,0 +1,398 @@
+import { z } from 'zod';
+import { prefixHostedToolDescription } from '../hosted-metadata.js';
+const TASKS_PREAMBLE = 'Start by reading customer playbooks: cms_edit ["customer", "tasks-index"]; ' +
+    'cms_edit ["customer", "capabilities"]; cms_edit ["customer", "checklist"].\n\n';
+const PREVIEW_AFTER_SAVE = 'After save: cms_edit ["preview", "urls", "<slug>"] (or use session entry id). ' +
+    'Give the user **both** links: (1) **Live preview (publish here)** — Contentful in-app preview with the green Publish button; ' +
+    '(2) **Preview (staging site)** — full-page staging URL (with bypass params when configured). ' +
+    'Also offer **production** (published only). See task-preview-verify and task-publish-handoff.\n';
+function hostedNote(hosted) {
+    if (!hosted) {
+        return 'Local MCP: use --space when multiple spaces are configured.';
+    }
+    const siteName = hosted.displayName ?? hosted.projectKey;
+    return (`Hosted deployment for ${siteName}. Do NOT pass --space in cms_edit args — ` +
+        'this connector is already bound to one Contentful space.');
+}
+export function registerOnboardingPrompts(server, hosted) {
+    const note = hostedNote(hosted);
+    const desc = (text) => prefixHostedToolDescription(text, hosted);
+    server.prompt('cms_edit_verify', desc('Verify cms-edit connectivity: check version and run health checks.'), async () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n` +
+                        'Verify cms-edit is working:\n' +
+                        '1. Call cms_edit_version\n' +
+                        '2. Call cms_edit with args ["health"]\n' +
+                        '3. cms_edit ["customer", "tasks-index"] and ["customer", "capabilities"] — confirm onboarding resources load\n' +
+                        '4. Summarize version, health, and available task count for the user',
+                },
+            },
+        ],
+    }));
+    server.prompt('cms_edit_explore', desc('Explore site content: list pages, open a page, and show the content tree.'), {
+        slug: z
+            .string()
+            .optional()
+            .describe('Page slug to open (default: / for homepage — CMS slug index on SE Studio sites; /index is equivalent)'),
+    }, async ({ slug }) => {
+        const targetSlug = slug ?? '/';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            'Homepage note: SE Studio sites store the homepage as CMS slug `index`. ' +
+                            '`--page-slug /` and `--page-slug /index` are equivalent.\n\n' +
+                            'Explore this Contentful site:\n' +
+                            '1. cms_edit ["list", "--type", "page"] — list pages\n' +
+                            `2. cms_edit ["open", "--page-slug", "${targetSlug}"] — load the page\n` +
+                            '3. cms_edit ["snapshot"] — show @ref tree\n' +
+                            '4. Summarize what you found',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_edit_page', desc('Edit a page: open, inspect, change fields, diff, then save as draft.'), {
+        slug: z.string().describe('Page slug to edit, e.g. /pricing'),
+        instructions: z.string().optional().describe('Optional edit instructions from the user'),
+    }, async ({ slug, instructions }) => {
+        const editLine = instructions
+            ? `User wants: ${instructions}\n`
+            : 'Ask the user what to change if not specified.\n';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            `${editLine}` +
+                            `Edit page "${slug}":\n` +
+                            `1. cms_edit ["open", "--page-slug", "${slug}"]\n` +
+                            '2. cms_edit ["snapshot"] — find @refs\n' +
+                            '3. cms_edit ["read", "@cN", "field"] — inspect fields\n' +
+                            '4. cms_edit ["set", ...] or ["rtf", ..., "--content", "..."] — make changes\n' +
+                            '5. cms_edit ["diff"] — review ALL changes\n' +
+                            '6. cms_edit ["save"] — write drafts (does NOT publish)\n' +
+                            'Always show diff before saving.',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_index_sync', desc('Build or refresh the local content index (assets, media, templates, taxonomy).'), async () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n` +
+                        'Sync the local cms-edit index:\n' +
+                        '1. cms_edit ["index", "sync"] — rebuild assets, media, templates, articleType, tagType, tag\n' +
+                        '2. cms_edit ["index", "status"] — show counts and freshness\n' +
+                        '3. Explain what was indexed and when to re-run sync (imports, stale >24h)',
+                },
+            },
+        ],
+    }));
+    server.prompt('cms_edit_edit_article', desc('Edit an article: open, inspect, change fields, diff, then save as draft.'), {
+        slug: z.string().describe('Article slug to edit, e.g. /resources/blog/my-post'),
+        instructions: z.string().optional().describe('Optional edit instructions from the user'),
+    }, async ({ slug, instructions }) => {
+        const editLine = instructions
+            ? `User wants: ${instructions}\n`
+            : 'Ask the user what to change if not specified.\n';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            `${editLine}` +
+                            `Edit article "${slug}":\n` +
+                            '1. cms_edit ["customer", "index"]; then routing, defaults, articles playbooks as needed\n' +
+                            `2. cms_edit ["open", "--article-slug", "${slug}"]\n` +
+                            '3. cms_edit ["snapshot"] — find @refs\n' +
+                            '4. cms_edit ["read", "@cN", "field"] — inspect fields\n' +
+                            '5. cms_edit ["set", ...] or ["rtf", ..., "--content", "..."] — make changes\n' +
+                            '6. cms_edit ["diff"] — review ALL changes\n' +
+                            '7. cms_edit ["save"] — write drafts (does NOT publish)\n' +
+                            'Always show diff before saving. Remind user to publish in Contentful when ready.',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_create_page', desc('Create a new page: list templates, create page, open and edit.'), {
+        slug: z.string().describe('Page slug, e.g. /about-us'),
+        title: z.string().describe('Page title'),
+    }, async ({ slug, title }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n` +
+                        `Create page "${title}" at slug "${slug}":\n` +
+                        '1. cms_edit ["index", "sync"] if index may be stale (optional but helps template lookup)\n' +
+                        '2. cms_edit ["list", "--type", "template"] — pick a template ID\n' +
+                        `3. cms_edit ["create", "page", "--slug", "${slug}", "--title", "${title}", "--template-id", "<id>"]\n` +
+                        '4. cms_edit ["snapshot"] — review structure\n' +
+                        '5. Edit fields with set/rtf as needed, then diff and save\n' +
+                        `6. ${PREVIEW_AFTER_SAVE}`,
+                },
+            },
+        ],
+    }));
+    server.prompt('cms_edit_create_article', desc('Create a new article: pick article type, apply featured image rules, dry-run, then save as draft.'), {
+        title: z.string().describe('Article title'),
+        slug: z.string().describe('Article slug, e.g. /resources/blog/my-post'),
+        articleType: z
+            .string()
+            .describe('Article type name or slug (required — every article needs an articleType)'),
+        instructions: z.string().optional().describe('Optional content instructions from the user'),
+    }, async ({ title, slug, articleType, instructions }) => {
+        const extra = instructions ? `User content notes: ${instructions}\n` : '';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            `Create article "${title}" at slug "${slug}" (article type: ${articleType}).\n` +
+                            `${extra}\n` +
+                            '1. cms_edit ["customer", "index"]; then overview, routing, defaults, articles, components-index\n' +
+                            '2. cms_edit ["index", "sync"] if catalog may be stale\n' +
+                            '3. cms_edit ["list", "--type", "articleType"] — confirm article type slug/name\n' +
+                            '4. Ask if the user has a custom featured image; if not, apply defaults.md rules (articleType → site default)\n' +
+                            '5. Build create-from-json payload (type article, articleTypeSlug or articleTypeId, components from articles playbook)\n' +
+                            '6. cms_edit ["create", "from-json", "--json", "<compact-json>", "--dry-run", "--strict"] (or --json-base64 for large payloads)\n' +
+                            '7. On approval, create and save draft\n' +
+                            `8. ${PREVIEW_AFTER_SAVE}` +
+                            '9. Remind user: publish in Contentful UI when ready (cms-edit never publishes)',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_taxonomy', desc('Set up taxonomy: import tag types, article types, and tags idempotently.'), {
+        taxonomyJson: z
+            .string()
+            .optional()
+            .describe('Inline taxonomy batch JSON (if omitted, ask user or use create --if-not-exists)'),
+    }, async ({ taxonomyJson }) => {
+        const importStep = taxonomyJson
+            ? `2. cms_edit ["create", "taxonomy-from-json", "--json", ${JSON.stringify(taxonomyJson)}, "--if-not-exists"]\n`
+            : '2. Use cms_edit ["create", "tag-type", ..., "--if-not-exists"] — or taxonomy-from-json with --json\n';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            'Set up taxonomy entries:\n' +
+                            '1. cms_edit ["index", "sync"] — refresh tagType/articleType/tag catalog\n' +
+                            importStep +
+                            '3. cms_edit ["list", "--type", "tagType"] and ["list", "--type", "tag"] to verify\n' +
+                            '4. Summarize created vs existing IDs',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_create_from_doc', desc('Create a new page from a freeform document (e.g. Google Doc): infer structure, confirm, dry-run, create.'), {
+        slug: z.string().describe('Page slug, e.g. /solutions/hepatology'),
+        title: z.string().optional().describe('Page title if known'),
+        docSummary: z
+            .string()
+            .optional()
+            .describe('Document content or summary from Google Drive MCP'),
+    }, async ({ slug, title, docSummary }) => {
+        const docLine = docSummary
+            ? `Document content:\n${docSummary}\n`
+            : 'Fetch the document via Google Drive MCP if the user provided a link.\n';
+        const titleLine = title ? `Title: ${title}\n` : '';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            `Create page at slug "${slug}" from a freeform document.\n` +
+                            `${titleLine}${docLine}\n` +
+                            `${TASKS_PREAMBLE}` +
+                            '1. cms_edit ["customer", "task-create-from-document"]; overview, routing, pages (if present), components-index\n' +
+                            '2. Infer page structure: map sections to component types using components-index\n' +
+                            '3. Propose a plain-English page plan (slug, title, template, components) — ask user to confirm\n' +
+                            '4. Build create-from-json payload; run cms_edit ["create", "from-json", "--json", "<compact-json>", "--dry-run", "--strict"]\n' +
+                            '5. On approval, create and save draft\n' +
+                            `6. ${PREVIEW_AFTER_SAVE}` +
+                            '7. Remind user to publish in Contentful UI when satisfied',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_create_article_from_doc', desc('Create a new article from a freeform document: infer structure, confirm article type, dry-run, create.'), {
+        slug: z.string().describe('Article slug, e.g. /resources/publications/my-study'),
+        articleType: z.string().describe('Article type name or slug (required)'),
+        title: z.string().optional().describe('Article title if known'),
+        docSummary: z
+            .string()
+            .optional()
+            .describe('Document content or summary from Google Drive MCP'),
+    }, async ({ slug, articleType, title, docSummary }) => {
+        const docLine = docSummary
+            ? `Document content:\n${docSummary}\n`
+            : 'Fetch the document via Google Drive MCP if the user provided a link.\n';
+        const titleLine = title ? `Title: ${title}\n` : '';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n` +
+                            `Create article at slug "${slug}" (article type: ${articleType}) from a freeform document.\n` +
+                            `${titleLine}${docLine}\n` +
+                            '1. cms_edit ["customer", "index"]; then overview, routing, defaults, articles, components-index\n' +
+                            '2. cms_edit ["index", "sync"] — refresh articleType catalog\n' +
+                            '3. cms_edit ["list", "--type", "articleType"] — resolve article type\n' +
+                            '4. Infer article structure from document; map body to article components (see articles playbook)\n' +
+                            '5. Ask about custom featured image; otherwise apply defaults.md inheritance rules\n' +
+                            '6. Propose plain-English plan — ask user to confirm\n' +
+                            '7. Build article create-from-json; run --dry-run --strict\n' +
+                            '8. On approval, create and save draft\n' +
+                            `9. ${PREVIEW_AFTER_SAVE}` +
+                            '10. Remind user to publish in Contentful UI when satisfied',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_bulk_seo', desc('Update SEO meta descriptions: read task playbook, inventory pages, update description field.'), {
+        instructions: z
+            .string()
+            .optional()
+            .describe('Optional scope, e.g. all pages or specific slugs'),
+    }, async ({ instructions }) => {
+        const scope = instructions ? `Scope: ${instructions}\n` : '';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n${TASKS_PREAMBLE}${scope}` +
+                            'Update SEO meta descriptions:\n' +
+                            '1. cms_edit ["customer", "task-seo-descriptions"]\n' +
+                            '2. cms_edit ["list", "--type", "page"] or list target slugs from user\n' +
+                            '3. Per page/article: open → set @p0 description "…" → diff → save\n' +
+                            '4. Or batch set when entry IDs are known\n' +
+                            'Field name is **description** (not seoDescription). Show diff before every save.',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_bulk_find_replace', desc('Bulk find-replace in rich text across pages or articles.'), {
+        find: z.string().describe('Text to find'),
+        replace: z.string().describe('Replacement text'),
+        instructions: z.string().optional().describe('Optional scope or entry list'),
+    }, async ({ find, replace, instructions }) => {
+        const scope = instructions ? `Scope: ${instructions}\n` : '';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${note}\n\n${TASKS_PREAMBLE}${scope}` +
+                            `Bulk find-replace: "${find}" → "${replace}"\n` +
+                            '1. cms_edit ["customer", "task-bulk-find-replace"]\n' +
+                            '2. cms_edit ["search", "<find>"] or list --type page|article — propose affected count; wait for user approval\n' +
+                            '3. cms_edit ["bulk-rtf-replace", "--find", "…", "--replace-plain", "…", "--dry-run"] — confirm match count\n' +
+                            '4. cms_edit ["bulk-rtf-replace", "--find", "…", "--replace-plain", "…"] — or per-entry open/rtf/diff/save for small sets\n' +
+                            '5. Summarize entries updated',
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt('cms_edit_bulk_article_tags', desc('Update tags on one or more articles.'), {
+        instructions: z
+            .string()
+            .describe('Article slugs and tag slugs to apply, or description of changes'),
+    }, async ({ instructions }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n${TASKS_PREAMBLE}User request: ${instructions}\n` +
+                        'Update article tags:\n' +
+                        '1. cms_edit ["customer", "task-article-tags"]\n' +
+                        '2. cms_edit ["index", "sync"] — refresh tag catalog\n' +
+                        '3. Batch: cms_edit ["article-tags-from-json", "--json", "<tags-json>", "--dry-run"] → user confirms → apply\n' +
+                        '4. Or per article: open --article-slug → set @p0 tags id1,id2 --links (or --append) → diff → save\n' +
+                        '5. Confirm tag list with user before saving',
+                },
+            },
+        ],
+    }));
+    server.prompt('cms_edit_import_authors', desc('Create person/author entries from a list or spreadsheet.'), {
+        instructions: z
+            .string()
+            .describe('Author rows (name, slug, jobTitle, bio) or sheet description'),
+    }, async ({ instructions }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n${TASKS_PREAMBLE}Author data:\n${instructions}\n` +
+                        'Create authors (person entries):\n' +
+                        '1. cms_edit ["customer", "task-authors-import"]\n' +
+                        '2. cms_edit ["customer", "routing"] — people URL base if configured\n' +
+                        '3. Batch: cms_edit ["create", "person-from-json", "--json", "<authors-json>", "--dry-run"] → user confirms → --if-not-exists\n' +
+                        '4. Or single: create person --slug … --name … --job-title … --bio-markdown …\n' +
+                        '5. Link to articles with set @p0 authors <ids> --links if requested',
+                },
+            },
+        ],
+    }));
+    server.prompt('cms_edit_media', desc('Prepare Drive packs via media pipeline, or reuse/upload assets (no pipeline API key).'), {
+        description: z.string().describe('What is needed: Drive folder pack, filename, or subject'),
+    }, async ({ description }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${note}\n\n${TASKS_PREAMBLE}Media need: ${description}\n` +
+                        'Media workflow:\n' +
+                        '1. cms_edit ["customer", "task-media-pipeline-prepare"] and/or task-media-reuse-and-upload\n' +
+                        '2. Oversized Drive packs: cms_edit_media action=prepare with driveFolderUrl\n' +
+                        '   (host holds service credentials — never ask for MEDIA_PIPELINE_API_KEY)\n' +
+                        '3. cms_edit_media action=wait or status with jobId until succeeded|partial|failed\n' +
+                        '4. cms_edit_media action=catalog — use previewUrl for naming/alt; readyUrl for CMS masters\n' +
+                        '5. cms_edit_media action=import with optional overrides (title/alt/fileName); dryRun first if unsure\n' +
+                        '6. Small one-off files: cms_edit_request_staged_upload → curl → asset upload --staged\n' +
+                        '7. Link asset IDs from import map to the target entry field',
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=onboarding.js.map