@contentful/mcp-server 1.4.0 → 1.5.0

package/build/tools/context/instructions.js

@@ -55,6 +55,9 @@ export const MCP_INSTRUCTIONS = `You are a helpful assistant integrated with Con
 - Use transform_image for AI-powered image operations
 - Always verify entry existence before attempting to modify it
 
+# Migration Strategies
+- Use the space_to_space migration workflow to help a user when they want to migrate content from one space to another. Start this workflow by calling the start_space_to_space_migration tool.
+- You do not need to fetch content types (ex. list_content_types tool) or entries (ex. search_entries tool) prior to starting the migration workflow. Once the user states they want to start the migration workflow, you simply need to call the start_space_to_space_migration tool.
 
 # Error Handling and Debugging
 

package/build/tools/context/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/tools/context/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mPA8GmN,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/tools/context/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mPAiHmN,CAAC"}

package/build/tools/jobs/register.js

@@ -0,0 +1,5 @@
+import { registerSpaceToSpaceMigrationTools } from './space-to-space-migration/register.js';
+export function registerJobs(server) {
+    registerSpaceToSpaceMigrationTools(server);
+}
+//# sourceMappingURL=register.js.map

package/build/tools/jobs/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/tools/jobs/register.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AAE5F,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,kCAAkC,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/build/tools/jobs/space-to-space-migration/exportSpace.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+import { createSuccessResponse, withErrorHandling, } from '../../../utils/response.js';
+import { BaseToolSchema } from '../../../utils/tools.js';
+import { getDefaultClientConfig } from '../../../config/contentful.js';
+import { EntryQuerySchema, AssetQuerySchema, } from '../../../types/querySchema.js';
+import path from 'path';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const contentfulExport = require('contentful-export');
+export const ExportSpaceToolParams = BaseToolSchema.extend({
+    exportDir: z
+        .string()
+        .optional()
+        .describe('Directory to save the exported space data (optional, defaults to current directory)'),
+    saveFile: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Save the exported space data to a file'),
+    contentFile: z
+        .string()
+        .optional()
+        .describe('Custom filename for the exported space data (optional)'),
+    includeDrafts: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include draft entries in the export'),
+    includeArchived: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include archived entries in the export'),
+    skipContentModel: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting content types'),
+    skipEditorInterfaces: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting editor interfaces'),
+    skipContent: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting entries and assets'),
+    skipRoles: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting roles and permissions'),
+    skipTags: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting tags'),
+    skipWebhooks: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip exporting webhooks'),
+    stripTags: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Untag assets and entries'),
+    contentOnly: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Only export assets and entries'),
+    queryEntries: EntryQuerySchema.optional().describe('Export only entries that match query parameters'),
+    queryAssets: AssetQuerySchema.optional().describe('Export only assets that match query parameters'),
+    downloadAssets: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Download actual asset files'),
+    maxAllowedLimit: z
+        .number()
+        .optional()
+        .default(1000)
+        .describe('Maximum number of items per request'),
+    deliveryToken: z
+        .string()
+        .optional()
+        .describe('CDA token to export only published content (excludes tags)'),
+    host: z.string().optional().describe('Management API host'),
+    hostDelivery: z.string().optional().describe('Delivery API host'),
+    proxy: z.string().optional().describe('HTTP/HTTPS proxy config'),
+    rawProxy: z
+        .boolean()
+        .optional()
+        .describe('Pass raw proxy config directly to Axios'),
+    headers: z
+        .record(z.string())
+        .optional()
+        .describe('Additional headers to include in requests'),
+    errorLogFile: z.string().optional().describe('Path to error log output file'),
+    useVerboseRenderer: z
+        .boolean()
+        .optional()
+        .describe('Line-by-line logging, useful for CI'),
+    config: z
+        .string()
+        .optional()
+        .describe('Path to a JSON config file with all options'),
+});
+async function tool(args) {
+    // Get management token from the same config used by other MCP tools
+    const clientConfig = getDefaultClientConfig();
+    const managementToken = clientConfig.accessToken;
+    if (!managementToken) {
+        throw new Error('Contentful management token is not configured');
+    }
+    // Consolidate args with defaults and additional required fields
+    const exportOptions = {
+        ...args,
+        managementToken,
+        environmentId: args.environmentId || 'master',
+        exportDir: args.exportDir || process.cwd(),
+        contentFile: args.contentFile || `contentful-export-${args.spaceId}.json`,
+    };
+    try {
+        const result = await contentfulExport(exportOptions);
+        const exportPath = path.join(exportOptions.exportDir, exportOptions.contentFile);
+        return createSuccessResponse('Space exported successfully', {
+            spaceId: args.spaceId,
+            environmentId: args.environmentId || 'master',
+            exportPath,
+            contentTypes: result.contentTypes?.length || 0,
+            entries: result.entries?.length || 0,
+            assets: result.assets?.length || 0,
+            locales: result.locales?.length || 0,
+            tags: result.tags?.length || 0,
+            webhooks: result.webhooks?.length || 0,
+            roles: result.roles?.length || 0,
+            editorInterfaces: result.editorInterfaces?.length || 0,
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to export space: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export const createExportSpaceTool = withErrorHandling(tool, 'Error exporting space');
+//# sourceMappingURL=exportSpace.js.map

package/build/tools/jobs/space-to-space-migration/exportSpace.js.map

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

package/build/tools/jobs/space-to-space-migration/importSpace.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { createSuccessResponse, withErrorHandling, } from '../../../utils/response.js';
+import { BaseToolSchema } from '../../../utils/tools.js';
+import { createRequire } from 'module';
+import { getDefaultClientConfig } from '../../../config/contentful.js';
+const require = createRequire(import.meta.url);
+const contentfulImport = require('contentful-import');
+export const ImportSpaceToolParams = BaseToolSchema.extend({
+    contentFile: z
+        .string()
+        .optional()
+        .describe('Path to JSON file containing the content to import'),
+    content: z
+        .record(z.any())
+        .optional()
+        .describe('JS object containing import content (must match expected structure)'),
+    contentModelOnly: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Import only content types'),
+    skipContentModel: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip importing content types and locales'),
+    skipLocales: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Skip importing locales'),
+    skipContentUpdates: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Do not update existing content'),
+    skipContentPublishing: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Create but do not publish content'),
+    uploadAssets: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Upload asset files (requires assetsDirectory)'),
+    skipAssetUpdates: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Do not update existing assets'),
+    assetsDirectory: z
+        .string()
+        .optional()
+        .describe('Path to directory containing exported asset files'),
+    timeout: z
+        .number()
+        .optional()
+        .default(3000)
+        .describe('Time between retries during asset processing (ms)'),
+    retryLimit: z
+        .number()
+        .optional()
+        .default(10)
+        .describe('Max retries for asset processing'),
+    host: z.string().optional().describe('Management API host'),
+    proxy: z
+        .string()
+        .optional()
+        .describe('HTTP/HTTPS proxy string (host:port or user:pass@host:port)'),
+    rawProxy: z
+        .boolean()
+        .optional()
+        .describe('Pass proxy config directly to Axios'),
+    rateLimit: z
+        .number()
+        .optional()
+        .default(7)
+        .describe('Max requests per second to the API'),
+    headers: z
+        .record(z.any())
+        .optional()
+        .describe('Additional headers to attach to requests'),
+    errorLogFile: z.string().optional().describe('Path to error log file'),
+    useVerboseRenderer: z
+        .boolean()
+        .optional()
+        .describe('Line-by-line progress output (good for CI)'),
+    config: z
+        .string()
+        .optional()
+        .describe('Path to config JSON file (merged with CLI args)'),
+});
+// Get management token from the same config used by other MCP tools
+const clientConfig = getDefaultClientConfig();
+const managementToken = clientConfig.accessToken;
+if (!managementToken) {
+    throw new Error('Contentful management token is not configured');
+}
+async function tool(args) {
+    // Consolidate args with defaults and additional required fields
+    const importOptions = {
+        ...args,
+        managementToken,
+        environmentId: args.environmentId || 'master',
+    };
+    try {
+        const result = await contentfulImport(importOptions);
+        return createSuccessResponse('Space imported successfully', {
+            spaceId: args.spaceId,
+            environmentId: args.environmentId || 'master',
+            contentTypes: result.contentTypes?.length || 0,
+            entries: result.entries?.length || 0,
+            assets: result.assets?.length || 0,
+            locales: result.locales?.length || 0,
+            tags: result.tags?.length || 0,
+            webhooks: result.webhooks?.length || 0,
+            roles: result.roles?.length || 0,
+            editorInterfaces: result.editorInterfaces?.length || 0,
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to import space: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export const createImportSpaceTool = withErrorHandling(tool, 'Error importing space');
+//# sourceMappingURL=importSpace.js.map

package/build/tools/jobs/space-to-space-migration/importSpace.js.map

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

package/build/tools/jobs/space-to-space-migration/instructions.js

@@ -0,0 +1,33 @@
+export const S2S_MIGRATION_INSTRUCTIONS = `
+You are a helpful assistant that can help with space to space migration.
+
+You will be given a list of tools that can be used to migrate a space to another space.
+
+## Workflow Management:
+The space to space migration workflow is managed by a single unified tool: **space_to_space_migration_handler**
+
+- To **start** the workflow: Call space_to_space_migration_handler with enableWorkflow=true
+- To **conclude** the workflow: Call space_to_space_migration_handler with enableWorkflow=false
+
+Once the workflow is started, you will need to call the tools in the following order:
+
+1. space_to_space_migration_handler with enableWorkflow=true (already confirmed by the user)
+2. IMPORTANT: After starting the workflow, you MUST ask the user for confirmation before proceeding to the next step. The enabled tools will not appear until the agent is reprompted by the user.
+3. space_to_space_param_collection (only call after user confirms they are ready to proceed)
+4. export_space 
+5. import_space
+6. space_to_space_migration_handler with enableWorkflow=false (to conclude the workflow)
+
+## Path Configuration Best Practices:
+- ALWAYS use consistent path formats throughout the workflow
+
+### Asset Handling Paths:
+- When downloadAssets=true, the export tool creates an assets directory structure like: exportDir/images.ctfassets.net/
+- The import tool expects assetsDirectory to point to the images.ctfassets.net directory, not the parent export directory
+
+Troubleshooting:
+- If the start_space_to_space_migration is not found, try to call it again on behalf of the user.
+- If space_to_space_param_collection or other tools are not found, ask the user to confirm they are ready to proceed, as the tools need to be enabled first.
+- If import fails with path errors, verify that exportDir and assetsDirectory paths are correctly aligned and accessible.
+`;
+//# sourceMappingURL=instructions.js.map

package/build/tools/jobs/space-to-space-migration/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../../src/tools/jobs/space-to-space-migration/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BzC,CAAC"}

package/build/tools/jobs/space-to-space-migration/migrationHandler.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { createSuccessResponse, withErrorHandling, } from '../../../utils/response.js';
+import { BaseToolSchema } from '../../../utils/tools.js';
+import { S2S_MIGRATION_INSTRUCTIONS } from './instructions.js';
+export const S2S_TEARDOWN_INSTRUCTIONS = `
+The space to space migration workflow has been concluded and all related tools have been disabled.
+
+The workflow is now complete. You can start a new migration workflow by calling space_to_space_migration_handler with enableWorkflow=true if needed.
+`;
+export const SpaceToSpaceMigrationHandlerToolParams = BaseToolSchema.extend({
+    enableWorkflow: z
+        .boolean()
+        .describe('Set to true to enable the workflow tools, false to disable them and conclude the workflow'),
+});
+export const makeSpaceToSpaceMigrationHandlerTool = (tools) => {
+    async function tool(args) {
+        const { enableWorkflow } = args;
+        if (enableWorkflow) {
+            // Enable all workflow tools
+            tools.forEach((tool) => {
+                if (tool) {
+                    tool.enable();
+                }
+            });
+            return createSuccessResponse('Space to space migration workflow started.', {
+                enableWorkflow,
+                instructions: S2S_MIGRATION_INSTRUCTIONS,
+            });
+        }
+        else {
+            // Disable all workflow tools (but not the handler itself)
+            tools.forEach((tool) => {
+                if (tool) {
+                    tool.disable();
+                }
+            });
+            return createSuccessResponse('Space to space migration workflow concluded.', {
+                enableWorkflow,
+                instructions: S2S_TEARDOWN_INSTRUCTIONS,
+            });
+        }
+    }
+    return withErrorHandling(tool, 'Error managing space to space migration workflow');
+};
+//# sourceMappingURL=migrationHandler.js.map

package/build/tools/jobs/space-to-space-migration/migrationHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrationHandler.js","sourceRoot":"","sources":["../../../../src/tools/jobs/space-to-space-migration/migrationHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;CAIxC,CAAC;AAEF,MAAM,CAAC,MAAM,sCAAsC,GAAG,cAAc,CAAC,MAAM,CAAC;IAC1E,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,CACP,2FAA2F,CAC5F;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAClD,KAAuB,EACvB,EAAE;IACF,KAAK,UAAU,IAAI,CAAC,IAAY;QAC9B,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAEhC,IAAI,cAAc,EAAE,CAAC;YACnB,4BAA4B;YAC5B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACrB,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,qBAAqB,CAC1B,4CAA4C,EAC5C;gBACE,cAAc;gBACd,YAAY,EAAE,0BAA0B;aACzC,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,0DAA0D;YAC1D,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACrB,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,qBAAqB,CAC1B,8CAA8C,EAC9C;gBACE,cAAc;gBACd,YAAY,EAAE,yBAAyB;aACxC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB,CACtB,IAAI,EACJ,kDAAkD,CACnD,CAAC;AACJ,CAAC,CAAC"}

package/build/tools/jobs/space-to-space-migration/mockClient.js

@@ -0,0 +1,156 @@
+import { vi } from 'vitest';
+/**
+ * Mock client for space-to-space migration tools
+ * Provides mocked contentful-export and contentful-import functions
+ */
+// Mock the contentful-export function
+export const mockContentfulExport = vi.fn();
+// Mock the contentful-import function
+export const mockContentfulImport = vi.fn();
+// Mock export result data
+export const mockExportResult = {
+    contentTypes: [
+        {
+            sys: { id: 'test-content-type', type: 'ContentType' },
+            name: 'Test Content Type',
+            fields: [],
+        },
+    ],
+    entries: [
+        {
+            sys: { id: 'test-entry', type: 'Entry' },
+            fields: { title: { 'en-US': 'Test Entry' } },
+        },
+    ],
+    assets: [
+        {
+            sys: { id: 'test-asset', type: 'Asset' },
+            fields: { title: { 'en-US': 'Test Asset' } },
+        },
+    ],
+    locales: [
+        {
+            sys: { id: 'en-US', type: 'Locale' },
+            code: 'en-US',
+            name: 'English (United States)',
+            default: true,
+        },
+    ],
+    tags: [
+        {
+            sys: { id: 'test-tag', type: 'Tag' },
+            name: 'Test Tag',
+        },
+    ],
+    webhooks: [],
+    roles: [],
+    editorInterfaces: [],
+};
+// Mock import result data
+export const mockImportResult = {
+    contentTypes: [
+        {
+            sys: { id: 'imported-content-type', type: 'ContentType' },
+            name: 'Imported Content Type',
+        },
+    ],
+    entries: [
+        {
+            sys: { id: 'imported-entry', type: 'Entry' },
+            fields: { title: { 'en-US': 'Imported Entry' } },
+        },
+    ],
+    assets: [
+        {
+            sys: { id: 'imported-asset', type: 'Asset' },
+            fields: { title: { 'en-US': 'Imported Asset' } },
+        },
+    ],
+    locales: [
+        {
+            sys: { id: 'en-US', type: 'Locale' },
+            code: 'en-US',
+            name: 'English (United States)',
+            default: true,
+        },
+    ],
+    tags: [],
+    webhooks: [],
+    roles: [],
+    editorInterfaces: [],
+};
+/**
+ * Standard test arguments for space-to-space migration operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+};
+/**
+ * Helper function to create import test args with defaults
+ */
+export const createImportTestArgs = (overrides = {}) => ({
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    contentModelOnly: false,
+    skipContentModel: false,
+    skipLocales: false,
+    skipContentUpdates: false,
+    skipContentPublishing: false,
+    uploadAssets: false,
+    skipAssetUpdates: false,
+    timeout: 3000,
+    retryLimit: 10,
+    rateLimit: 7,
+    ...overrides,
+});
+/**
+ * Helper function to create export test args with defaults
+ */
+export const createExportTestArgs = (overrides = {}) => ({
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    saveFile: true,
+    includeDrafts: false,
+    includeArchived: false,
+    skipContentModel: false,
+    skipEditorInterfaces: false,
+    skipContent: false,
+    skipRoles: false,
+    skipTags: false,
+    skipWebhooks: false,
+    stripTags: false,
+    contentOnly: false,
+    downloadAssets: false,
+    maxAllowedLimit: 1000,
+    rawProxy: false,
+    useVerboseRenderer: false,
+    ...overrides,
+});
+/**
+ * Mock parameter collection arguments
+ */
+export const mockParamCollectionArgs = {
+    ...mockArgs,
+    confirmation: false,
+    export: {
+        spaceId: 'source-space-id',
+        environmentId: 'master',
+        exportDir: '/test/export',
+        contentFile: 'export.json',
+    },
+    import: {
+        spaceId: 'target-space-id',
+        environmentId: 'master',
+        contentFile: '/test/export/export.json',
+    },
+};
+/**
+ * Mock migration handler arguments
+ */
+export const mockMigrationHandlerArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    enableWorkflow: true,
+};
+//# sourceMappingURL=mockClient.js.map

package/build/tools/jobs/space-to-space-migration/mockClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockClient.js","sourceRoot":"","sources":["../../../../src/tools/jobs/space-to-space-migration/mockClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE5C,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE5C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,YAAY,EAAE;QACZ;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE;YACrD,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,EAAE;SACX;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;YACxC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE;SAC7C;KACF;IACD,MAAM,EAAE;QACN;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;YACxC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE;SAC7C;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,IAAI;SACd;KACF;IACD,IAAI,EAAE;QACJ;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;YACpC,IAAI,EAAE,UAAU;SACjB;KACF;IACD,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,YAAY,EAAE;QACZ;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,IAAI,EAAE,aAAa,EAAE;YACzD,IAAI,EAAE,uBAAuB;SAC9B;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE;YAC5C,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE;SACjD;KACF;IACD,MAAM,EAAE;QACN;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE;YAC5C,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE;SACjD;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,IAAI;SACd;KACF;IACD,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,kBAAkB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,YAAqC,EAAE,EACvC,EAAE,CAAC,CAAC;IACJ,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,WAAW,EAAE,KAAK;IAClB,kBAAkB,EAAE,KAAK;IACzB,qBAAqB,EAAE,KAAK;IAC5B,YAAY,EAAE,KAAK;IACnB,gBAAgB,EAAE,KAAK;IACvB,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,CAAC;IACZ,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,YAAqC,EAAE,EACvC,EAAE,CAAC,CAAC;IACJ,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,kBAAkB;IACjC,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,oBAAoB,EAAE,KAAK;IAC3B,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE,KAAK;IACf,kBAAkB,EAAE,KAAK;IACzB,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,QAAQ;IACX,YAAY,EAAE,KAAK;IACnB,MAAM,EAAE;QACN,OAAO,EAAE,iBAAiB;QAC1B,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,cAAc;QACzB,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE;QACN,OAAO,EAAE,iBAAiB;QAC1B,aAAa,EAAE,QAAQ;QACvB,WAAW,EAAE,0BAA0B;KACxC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,kBAAkB;IACjC,cAAc,EAAE,IAAI;CACrB,CAAC"}

package/build/tools/jobs/space-to-space-migration/paramCollection.js

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+import { createSuccessResponse, withErrorHandling, } from '../../../utils/response.js';
+import { BaseToolSchema } from '../../../utils/tools.js';
+import { EntryQuerySchema, AssetQuerySchema, } from '../../../types/querySchema.js';
+export const ParamCollectionToolParams = BaseToolSchema.extend({
+    confirmation: z
+        .boolean()
+        .optional()
+        .describe('User confirmation that they are ready to proceed with the workflow'),
+    export: z
+        .object({
+        spaceId: z
+            .string()
+            .optional()
+            .describe('ID of the space with source data'),
+        environmentId: z
+            .string()
+            .optional()
+            .describe('ID of the environment in the source space'),
+        deliveryToken: z
+            .string()
+            .optional()
+            .describe('CDA token to export only published content (excludes tags)'),
+        exportDir: z.string().optional().describe('Path to export JSON output'),
+        saveFile: z
+            .boolean()
+            .optional()
+            .describe('Save the export as a JSON file'),
+        contentFile: z.string().optional().describe('Filename for exported data'),
+        includeDrafts: z
+            .boolean()
+            .optional()
+            .describe('Include drafts in exported entries'),
+        includeArchived: z
+            .boolean()
+            .optional()
+            .describe('Include archived entries'),
+        skipContentModel: z
+            .boolean()
+            .optional()
+            .describe('Skip exporting content models'),
+        skipEditorInterfaces: z
+            .boolean()
+            .optional()
+            .describe('Skip exporting editor interfaces'),
+        skipContent: z
+            .boolean()
+            .optional()
+            .describe('Skip exporting entries and assets'),
+        skipRoles: z
+            .boolean()
+            .optional()
+            .describe('Skip exporting roles and permissions'),
+        skipTags: z.boolean().optional().describe('Skip exporting tags'),
+        skipWebhooks: z.boolean().optional().describe('Skip exporting webhooks'),
+        stripTags: z
+            .boolean()
+            .optional()
+            .describe('Remove tags from entries and assets'),
+        contentOnly: z
+            .boolean()
+            .optional()
+            .describe('Export only entries and assets'),
+        queryEntries: EntryQuerySchema.optional().describe('Export only entries that match query parameters'),
+        queryAssets: AssetQuerySchema.optional().describe('Export only assets that match query parameters'),
+        downloadAssets: z
+            .boolean()
+            .optional()
+            .describe('Download asset files to disk'),
+        host: z.string().optional().describe('Management API host'),
+        hostDelivery: z.string().optional().describe('Delivery API host'),
+        proxy: z.string().optional().describe('HTTP/HTTPS proxy config'),
+        rawProxy: z
+            .boolean()
+            .optional()
+            .describe('Pass raw proxy config directly to Axios'),
+        maxAllowedLimit: z.number().optional().describe('Page size for requests'),
+        headers: z
+            .record(z.any())
+            .optional()
+            .describe('Additional headers to include in requests'),
+        errorLogFile: z
+            .string()
+            .optional()
+            .describe('Path to error log output file'),
+        useVerboseRenderer: z
+            .boolean()
+            .optional()
+            .describe('Line-by-line logging, useful for CI'),
+        config: z
+            .string()
+            .optional()
+            .describe('Path to a JSON config file with all options'),
+    })
+        .optional(),
+    import: z
+        .object({
+        spaceId: z.string().optional().describe('ID of the space to import into'),
+        environmentId: z
+            .string()
+            .optional()
+            .describe('Target environment in destination space'),
+        contentFile: z
+            .string()
+            .optional()
+            .describe('Path to JSON file containing the content to import'),
+        content: z
+            .record(z.any())
+            .optional()
+            .describe('JS object containing import content (must match expected structure)'),
+        contentModelOnly: z
+            .boolean()
+            .optional()
+            .describe('Import only content types'),
+        skipContentModel: z
+            .boolean()
+            .optional()
+            .describe('Skip importing content types and locales'),
+        skipLocales: z.boolean().optional().describe('Skip importing locales'),
+        skipContentUpdates: z
+            .boolean()
+            .optional()
+            .describe('Do not update existing content'),
+        skipContentPublishing: z
+            .boolean()
+            .optional()
+            .describe('Create but do not publish content'),
+        uploadAssets: z
+            .boolean()
+            .optional()
+            .describe('Upload asset files (requires assetsDirectory)'),
+        skipAssetUpdates: z
+            .boolean()
+            .optional()
+            .describe('Do not update existing assets'),
+        assetsDirectory: z
+            .string()
+            .optional()
+            .describe('Path to directory containing exported asset files'),
+        timeout: z
+            .number()
+            .optional()
+            .describe('Time between retries during asset processing (ms)'),
+        retryLimit: z
+            .number()
+            .optional()
+            .describe('Max retries for asset processing'),
+        host: z.string().optional().describe('Management API host'),
+        proxy: z
+            .string()
+            .optional()
+            .describe('HTTP/HTTPS proxy string (host:port or user:pass@host:port)'),
+        rawProxy: z
+            .boolean()
+            .optional()
+            .describe('Pass proxy config directly to Axios'),
+        rateLimit: z
+            .number()
+            .optional()
+            .describe('Max requests per second to the API'),
+        headers: z
+            .record(z.any())
+            .optional()
+            .describe('Additional headers to attach to requests'),
+        errorLogFile: z.string().optional().describe('Path to error log file'),
+        useVerboseRenderer: z
+            .boolean()
+            .optional()
+            .describe('Line-by-line progress output (good for CI)'),
+        config: z
+            .string()
+            .optional()
+            .describe('Path to config JSON file (merged with CLI args)'),
+    })
+        .optional(),
+});
+const paramCollectionConfig = {
+    export: {
+        requiredParams: `
+spaceId                 // [string] [required] - ID of the space with source data
+    `,
+        optionalParams: `
+environmentId           // [string] [default: 'master'] - ID of the environment in the source space
+deliveryToken           // [string] - CDA token to export only published content (excludes tags)
+
+exportDir               // [string] [default: process.cwd()] - Path to export JSON output
+saveFile                // [boolean] [default: true] - Save the export as a JSON file
+contentFile             // [string] - Filename for exported data
+
+includeDrafts           // [boolean] [default: false] - Include drafts in exported entries
+includeArchived         // [boolean] [default: false] - Include archived entries
+skipContentModel        // [boolean] [default: false] - Skip exporting content models
+skipEditorInterfaces    // [boolean] [default: false] - Skip exporting editor interfaces
+skipContent             // [boolean] [default: false] - Skip exporting entries and assets
+skipRoles               // [boolean] [default: false] - Skip exporting roles and permissions
+skipTags                // [boolean] [default: false] - Skip exporting tags
+skipWebhooks            // [boolean] [default: false] - Skip exporting webhooks
+stripTags               // [boolean] [default: false] - Remove tags from entries and assets
+contentOnly             // [boolean] [default: false] - Export only entries and assets
+
+queryEntries            // [array] - Export only entries that match query parameters
+queryAssets             // [array] - Export only assets that match query parameters
+downloadAssets          // [boolean] - Download asset files to disk
+
+host                    // [string] [default: 'api.contentful.com'] - Management API host
+hostDelivery            // [string] [default: 'cdn.contentful.com'] - Delivery API host
+proxy                   // [string] - HTTP/HTTPS proxy config
+rawProxy                // [boolean] - Pass raw proxy config directly to Axios
+maxAllowedLimit         // [number] [default: 1000] - Page size for requests
+headers                 // [object] - Additional headers to include in requests
+
+errorLogFile            // [string] - Path to error log output file
+useVerboseRenderer      // [boolean] [default: false] - Line-by-line logging, useful for CI
+config                  // [string] - Path to a JSON config file with all options
+    `,
+    },
+    import: {
+        requiredParams: `
+spaceId                 // [string] [required] - ID of the space to import into
+managementToken         // [string] [required] - Contentful Management API token
+    `,
+        optionalParams: `
+environmentId           // [string] [default: 'master'] - Target environment in destination space
+contentFile             // [string] - Path to JSON file containing the content to import
+content                 // [object] - JS object containing import content (must match expected structure)
+
+contentModelOnly        // [boolean] [default: false] - Import only content types
+skipContentModel        // [boolean] [default: false] - Skip importing content types and locales
+skipLocales             // [boolean] [default: false] - Skip importing locales
+skipContentUpdates      // [boolean] [default: false] - Do not update existing content
+skipContentPublishing   // [boolean] [default: false] - Create but do not publish content
+
+uploadAssets            // [boolean] [default: false] - Upload asset files (requires assetsDirectory)
+skipAssetUpdates        // [boolean] [default: false] - Do not update existing assets
+assetsDirectory         // [string] - Path to directory containing exported asset files
+timeout                 // [number] [default: 3000] - Time between retries during asset processing (ms)
+retryLimit              // [number] [default: 10] - Max retries for asset processing
+
+host                    // [string] [default: 'api.contentful.com'] - Management API host
+proxy                   // [string] - HTTP/HTTPS proxy string (host:port or user:pass@host:port)
+rawProxy                // [boolean] - Pass proxy config directly to Axios
+rateLimit               // [number] [default: 7] - Max requests per second to the API
+headers                 // [object] - Additional headers to attach to requests
+
+errorLogFile            // [string] - Path to error log file
+useVerboseRenderer      // [boolean] [default: false] - Line-by-line progress output (good for CI)
+config                  // [string] - Path to config JSON file (merged with CLI args)
+    `,
+    },
+};
+async function tool(args) {
+    // Extract export and import parameters, filtering out undefined values
+    const exportParams = args.export
+        ? Object.fromEntries(Object.entries(args.export).filter(([, value]) => value !== undefined))
+        : {};
+    const importParams = args.import
+        ? Object.fromEntries(Object.entries(args.import).filter(([, value]) => value !== undefined))
+        : {};
+    const params = {
+        export: Object.keys(exportParams).length > 0 ? exportParams : undefined,
+        import: Object.keys(importParams).length > 0 ? importParams : undefined,
+    };
+    // If user has confirmed, return ready-to-proceed response
+    if (args.confirmation === true) {
+        return createSuccessResponse('User ready to proceed with workflow', {
+            message: 'User has confirmed they are ready to proceed with the space-to-space migration workflow.',
+            workflowParams: params,
+            nextStep: 'Proceed with the migration workflow using the collected parameters.',
+        });
+    }
+    // Otherwise, return parameter collection response
+    return createSuccessResponse('Param collection tool', {
+        instructions: `
+    Help the user collect the correct parameters for the space to space migration workflow.
+    Call this tool repeatedly until the user feels they are ready to start the workflow.
+
+    Help them understand the required and optional parameters for the export and import tools.
+    Help them understand the instructions for the export and import tools.
+    Help them understand the available params for the export and import tools, ensure you list at all the optional params not just the required ones.
+
+    Continue to build the parameters passed into this tool until the user passes a confirmation that they are ready to start the workflow.
+    `,
+        availableParams: paramCollectionConfig,
+        currentParams: params,
+    });
+}
+export const createParamCollectionTool = withErrorHandling(tool, 'Error creating param collection tool');
+//# sourceMappingURL=paramCollection.js.map

package/build/tools/jobs/space-to-space-migration/paramCollection.js.map

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

package/build/tools/jobs/space-to-space-migration/register.js

@@ -0,0 +1,23 @@
+import { createExportSpaceTool, ExportSpaceToolParams } from './exportSpace.js';
+import { ParamCollectionToolParams, createParamCollectionTool, } from './paramCollection.js';
+import { ImportSpaceToolParams, createImportSpaceTool } from './importSpace.js';
+import { SpaceToSpaceMigrationHandlerToolParams, makeSpaceToSpaceMigrationHandlerTool, } from './migrationHandler.js';
+export function registerSpaceToSpaceMigrationTools(server) {
+    // Param collection tool
+    const paramCollectionTool = server.tool('space_to_space_param_collection', 'Collect parameters for the space to space migration workflow. This tool should ALWAYS start with confirmation false, until the user confirms they are ready to proceed with the workflow. Do not assume they use wants to proceed with the workflow until they explicitly say so.', ParamCollectionToolParams.shape, createParamCollectionTool);
+    // Export space tool
+    const exportSpaceTool = server.tool('export_space', 'Export a space to a file', ExportSpaceToolParams.shape, createExportSpaceTool);
+    // Import space tool
+    const importSpaceTool = server.tool('import_space', 'Import a space from a file. Step 4 of the space to space migration workflow.', ImportSpaceToolParams.shape, createImportSpaceTool);
+    // Create the unified migration handler tool
+    server.tool('space_to_space_migration_handler', 'Enable or disable the space to space migration workflow tools. Set enableWorkflow=true to start, false to conclude the workflow.', SpaceToSpaceMigrationHandlerToolParams.shape, makeSpaceToSpaceMigrationHandlerTool([
+        paramCollectionTool,
+        exportSpaceTool,
+        importSpaceTool,
+    ]));
+    // Disable all workflow tools by default (only the handler remains enabled)
+    paramCollectionTool.disable();
+    importSpaceTool.disable();
+    exportSpaceTool.disable();
+}
+//# sourceMappingURL=register.js.map

package/build/tools/jobs/space-to-space-migration/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/tools/jobs/space-to-space-migration/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,sCAAsC,EACtC,oCAAoC,GACrC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,kCAAkC,CAAC,MAAiB;IAClE,wBAAwB;IACxB,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CACrC,iCAAiC,EACjC,mRAAmR,EACnR,yBAAyB,CAAC,KAAK,EAC/B,yBAAyB,CAC1B,CAAC;IAEF,oBAAoB;IACpB,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,CAAC,KAAK,EAC3B,qBAAqB,CACtB,CAAC;IAEF,oBAAoB;IACpB,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,cAAc,EACd,8EAA8E,EAC9E,qBAAqB,CAAC,KAAK,EAC3B,qBAAqB,CACtB,CAAC;IAEF,4CAA4C;IAC5C,MAAM,CAAC,IAAI,CACT,kCAAkC,EAClC,kIAAkI,EAClI,sCAAsC,CAAC,KAAK,EAC5C,oCAAoC,CAAC;QACnC,mBAAmB;QACnB,eAAe;QACf,eAAe;KAChB,CAAC,CACH,CAAC;IAEF,2EAA2E;IAC3E,mBAAmB,CAAC,OAAO,EAAE,CAAC;IAC9B,eAAe,CAAC,OAAO,EAAE,CAAC;IAC1B,eAAe,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/build/tools/register.js

@@ -7,6 +7,7 @@ import { registerSpaceTools } from './spaces/register.js';
 import { registerTagsTools } from './tags/register.js';
 import { registerAiActionsTools } from './ai-actions/register.js';
 import { registerLocaleTools } from './locales/register.js';
+import { registerJobs } from './jobs/register.js';
 import { registerOrgTools } from './orgs/register.js';
 export function registerAllTools(server) {
     registerContextTools(server);
@@ -18,6 +19,7 @@ export function registerAllTools(server) {
     registerTagsTools(server);
     registerAiActionsTools(server);
     registerLocaleTools(server);
+    registerJobs(server);
     registerOrgTools(server);
 }
 //# sourceMappingURL=register.js.map

package/build/tools/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/build/types/querySchema.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/**
+ * Shared query schema for entries - used by searchEntries, exportSpace, etc.
+ */
+export const EntryQuerySchema = z.object({
+    content_type: z.string().optional().describe('Filter by content type'),
+    include: z
+        .number()
+        .optional()
+        .describe('Include this many levels of linked entries'),
+    select: z
+        .string()
+        .optional()
+        .describe('Comma-separated list of fields to return'),
+    links_to_entry: z
+        .string()
+        .optional()
+        .describe('Find entries that link to the specified entry ID'),
+    limit: z.number().optional().describe('Maximum number of entries to return'),
+    skip: z.number().optional().describe('Skip this many entries'),
+    order: z.string().optional().describe('Order entries by this field'),
+});
+/**
+ * Shared query schema for assets - used by listAssets, exportSpace, etc.
+ */
+export const AssetQuerySchema = z.object({
+    mimetype_group: z.string().optional().describe('Filter by MIME type group'),
+    select: z
+        .string()
+        .optional()
+        .describe('Comma-separated list of fields to return'),
+    limit: z.number().optional().describe('Maximum number of assets to return'),
+    skip: z.number().optional().describe('Skip this many assets'),
+    order: z.string().optional().describe('Order assets by this field'),
+});
+//# sourceMappingURL=querySchema.js.map

package/build/types/querySchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"querySchema.js","sourceRoot":"","sources":["../../src/types/querySchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACtE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IACvD,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3E,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACpE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-server",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/contentful/contentful-mcp-server"
@@ -35,7 +35,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.0",
+    "contentful-export": "^7.21.78",
     "contentful-management": "^11.54.3",
+    "contentful-import": "^9.4.111",
     "dotenv": "^16.4.7",
     "fast-xml-parser": "^5.2.5",
     "get-it": "^8.6.10",
@@ -50,7 +52,8 @@
     "@modelcontextprotocol/inspector": "0.16.2",
     "@nx/js": "^21.3.6",
     "@types/node": "^22.16.5",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/eslint-plugin": "^8.42.0",
+    "eslint": "^9.35.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.1.4",
     "husky": "^9.1.7",