unreal-engine-mcp-server 0.5.21 → 0.6.0-a

package/dist/tools/catalog/capabilities/records/manage-asset/asset-lifecycle.js

@@ -0,0 +1,60 @@
+import { aliasCanonical, aliasOf, arr, arrObj, bool, boundedLimit, boundedPagination, DESTRUCTIVE, DESTRUCTIVE_POLICY, ex, HIGH, LOW, MEDIUM, NON_IDEMPOTENT, num, READ, READ_POLICY, r, schema, str, WRITE, WRITE_POLICY } from './builder.js';
+const SOURCE_PATH = str('Source filesystem path for import.');
+const DEST_PATH = str('Destination /Game asset path.');
+const PAGINATED_OUTPUT = schema({
+    success: bool('Operation succeeded.'),
+    assets: arrObj('Matched assets on this page.'),
+    folders: arr('Subfolder paths.'),
+    totalCount: num('Total matched count before pagination.'),
+    count: num('Asset count on this page.'),
+    limit: num('Applied page size.'),
+    offset: num('Applied zero-based offset.'),
+    hasMore: bool('True when more results exist beyond the current page.'),
+    nextOffset: num('Next-page offset.'),
+    cursor: { type: ['string', 'null'], description: 'Opaque cursor for the current page, or null when the page was requested without one.' },
+    nextCursor: { type: ['string', 'null'], description: 'Opaque cursor for the next page, or null on the last page.' }
+}, ['success']);
+const OK_OUTPUT = schema({ success: bool('Operation succeeded.'), details: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Operation details.' } }, ['success']);
+export const ASSET_LIFECYCLE_RECORDS = [
+    r('list', 'asset', 'List assets under a /Game path with bounded pagination and opaque cursor continuation.', schema({
+        path: { type: 'string', default: '/Game', description: 'Canonical /Game path to list.' },
+        limit: boundedLimit(500, 50),
+        offset: num('Zero-based offset into the full result set.'),
+        pagination: boundedPagination(500, 50),
+        cursor: str('Opaque pagination cursor returned by a previous list response. Forward verbatim to resume.'),
+        recursive: bool('Recurse into subdirectories.'),
+        depth: num('Maximum recursion depth.'),
+        includeTags: bool('When true, include asset tags in the listing response.')
+    }, ['path']), PAGINATED_OUTPUT, READ, READ_POLICY, MEDIUM, { topics: ['list assets', 'browse folder', 'content browser', 'assets in folder', 'directory listing', 'folder contents'], dispatchAction: 'list', dispatchMode: 'action', examples: [ex('List first page', { path: '/Game' }, { success: true, assets: [], hasMore: false, nextCursor: null })] }),
+    r('import', 'asset', 'Import an asset from a filesystem source into the project content hierarchy.', schema({ sourcePath: SOURCE_PATH, destinationPath: DEST_PATH, overwrite: bool('Overwrite existing asset at destination.'), save: bool('Save package after import.') }, ['sourcePath', 'destinationPath']), OK_OUTPUT, WRITE, WRITE_POLICY, MEDIUM, { aliases: ['asset.import_asset'], topics: ['import fbx', 'import file', 'import mesh', 'import texture', 'import obj', 'import png', 'import wav', 'bring file into project'], examples: [ex('Import FBX', { sourcePath: '/tmp/mesh.fbx', destinationPath: '/Game/Imports/Mesh' }, { success: true })] }),
+    r('duplicate', 'asset', 'Duplicate an existing asset to a new path.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH, newName: str('New asset name.') }, ['sourcePath']), OK_OUTPUT, WRITE, WRITE_POLICY, MEDIUM, { topics: ['copy asset', 'clone asset'], normalization: aliasCanonical('duplicate_asset'),
+        examples: [ex('Duplicate a material', { sourcePath: '/Game/Materials/M_Base', destinationPath: '/Game/Materials', newName: 'M_Base_Variant' }, { success: true })] }),
+    r('duplicate_asset', 'asset', 'Long-form alias for duplicate.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH, newName: str('New asset name.') }, ['sourcePath']), OK_OUTPUT, WRITE, WRITE_POLICY, MEDIUM, { normalization: aliasOf('asset.duplicate'),
+        examples: [ex('Duplicate via the long-form alias', { sourcePath: '/Game/Materials/M_Base', destinationPath: '/Game/Materials', newName: 'M_Base_Variant' }, { success: true })] }),
+    r('rename', 'asset', 'Rename an existing asset in place.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH, newName: str('New asset name.') }, ['sourcePath']), OK_OUTPUT, NON_IDEMPOTENT, WRITE_POLICY, MEDIUM, { topics: ['rename asset'], normalization: aliasCanonical('rename_asset'),
+        examples: [ex('Rename a mesh in place', { sourcePath: '/Game/Meshes/SM_Crate', newName: 'SM_Crate_Large' }, { success: true })] }),
+    r('rename_asset', 'asset', 'Long-form alias for rename.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH, newName: str('New asset name.') }, ['sourcePath']), OK_OUTPUT, NON_IDEMPOTENT, WRITE_POLICY, MEDIUM, { normalization: aliasOf('asset.rename'),
+        examples: [ex('Rename via the long-form alias', { sourcePath: '/Game/Meshes/SM_Crate', newName: 'SM_Crate_Large' }, { success: true })] }),
+    r('move', 'asset', 'Move an asset to a new package path.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH }, ['sourcePath']), OK_OUTPUT, NON_IDEMPOTENT, WRITE_POLICY, MEDIUM, { topics: ['move asset', 'relocate asset'], normalization: aliasCanonical('move_asset'),
+        examples: [ex('Move a texture into a subfolder', { sourcePath: '/Game/Textures/T_Rock', destinationPath: '/Game/Textures/Terrain/T_Rock' }, { success: true })] }),
+    r('move_asset', 'asset', 'Long-form alias for move.', schema({ sourcePath: str('Source /Game asset path.'), destinationPath: DEST_PATH }, ['sourcePath']), OK_OUTPUT, NON_IDEMPOTENT, WRITE_POLICY, MEDIUM, { normalization: aliasOf('asset.move'),
+        examples: [ex('Move via the long-form alias', { sourcePath: '/Game/Textures/T_Rock', destinationPath: '/Game/Textures/Terrain/T_Rock' }, { success: true })] }),
+    r('delete', 'asset', 'Permanently delete one or more assets after explicit confirmation.', schema({ paths: arr('Asset paths to delete.'), path: str('Single asset path (alternative to paths).'), assetPath: str('Alias for path (accepted for compatibility).'), force: bool('Force deletion even when the asset is still referenced (bridge delete path).') }, []), OK_OUTPUT, DESTRUCTIVE, DESTRUCTIVE_POLICY, HIGH, { topics: ['delete asset', 'remove asset', 'destroy asset'], normalization: aliasCanonical('delete_asset/delete_assets'),
+        examples: [ex('Delete one asset', { paths: ['/Game/MCPTest/Disposable'] }, { success: true })] }),
+    r('delete_asset', 'asset', 'Long-form alias for delete.', schema({ paths: arr('Asset paths to delete.'), path: str('Single asset path.'), assetPath: str('Alias for path (accepted for compatibility).'), force: bool('Force deletion even when the asset is still referenced (bridge delete path).') }, []), OK_OUTPUT, DESTRUCTIVE, DESTRUCTIVE_POLICY, HIGH, { normalization: aliasOf('asset.delete'),
+        examples: [ex('Delete a single asset by path', { path: '/Game/MCPTest/Disposable' }, { success: true })] }),
+    r('delete_assets', 'asset', 'Plural-form alias for delete.', schema({ paths: arr('Asset paths to delete.'), path: str('Single asset path.'), assetPath: str('Alias for path (accepted for compatibility).'), force: bool('Force deletion even when the asset is still referenced (bridge delete path).') }, []), OK_OUTPUT, DESTRUCTIVE, DESTRUCTIVE_POLICY, HIGH, { normalization: aliasOf('asset.delete'),
+        examples: [ex('Delete several assets in one call', { paths: ['/Game/MCPTest/DisposableA', '/Game/MCPTest/DisposableB'] }, { success: true })] }),
+    r('create_folder', 'asset', 'Create a new content-browser folder under a /Game path.', schema({ path: str('Folder path (must start with /).') }, ['path']), OK_OUTPUT, WRITE, WRITE_POLICY, LOW, { examples: [ex('Create folder', { path: '/Game/NewFolder' }, { success: true })] }),
+    r('search_assets', 'asset', 'Find or search assets by text, class, or package path with bounded pagination.', schema({
+        searchText: str('Text to search for.'),
+        classNames: arr('Asset class names to filter.'),
+        packagePaths: arr('Package paths to search within.'),
+        recursivePaths: bool('Recurse into subdirectories.'),
+        recursiveClasses: bool('Recurse into child classes.'),
+        limit: boundedLimit(500, 50),
+        offset: num('Zero-based offset into the full result set.')
+    }, []), PAGINATED_OUTPUT, READ, READ_POLICY, MEDIUM, { aliases: ['asset.find_assets'], topics: ['find assets', 'search assets', 'assets by class', 'filter assets', 'query assets', 'assets of type'], dispatchAction: 'asset_query', dispatchMode: 'action',
+        examples: [ex('Search materials by name', { searchText: 'M_Rock', classNames: ['Material'], packagePaths: ['/Game/Materials'], recursivePaths: true, limit: 25 }, { success: true, assets: [{ name: 'M_Rock', path: '/Game/Materials/M_Rock.M_Rock', class: 'Material', packagePath: '/Game/Materials' }], folders: [], totalCount: 1, count: 1, limit: 25, offset: 0, hasMore: false, nextOffset: 1, cursor: null, nextCursor: null })] })
+];
+//# sourceMappingURL=asset-lifecycle.js.map

package/dist/tools/catalog/capabilities/records/manage-asset/asset-lifecycle.js.map

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

package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.d.ts

@@ -0,0 +1,3 @@
+import type { RecordSpec } from './builder.js';
+export declare const ASSET_QUERY_RECORDS: readonly RecordSpec[];
+//# sourceMappingURL=asset-query.d.ts.map

package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-query.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/manage-asset/asset-query.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA6C/C,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EA0FpD,CAAC"}

package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.js

@@ -0,0 +1,61 @@
+import { arr, arrObj, bool, divergence, ex, LOW, MEDIUM, num, READ, READ_POLICY, r, schema, str, WRITE, WRITE_POLICY } from './builder.js';
+const ASSET_PATH = str('Canonical /Game asset path.');
+const OK = schema({ success: bool('Operation succeeded.'), details: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Operation details.' } }, ['success']);
+const GRAPH_OK = schema({
+    success: bool('Operation succeeded.'),
+    graph: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Adjacency map of asset path -> array of dependency paths.' },
+    nodeCount: num('Number of distinct assets visited.'),
+    maxDepth: num('Traversal depth actually used after clamping.'),
+    truncated: bool('True when the walk hit the depth or node ceiling and the graph is partial.'),
+}, ['success']);
+const ANALYZE_GRAPH_OK = schema({
+    success: bool('Operation succeeded.'),
+    assetPath: ASSET_PATH,
+    assetClass: str('Concrete UClass name of the analyzed asset.'),
+    graphType: str('Graph kind analyzed: Material, Blueprint, or None.'),
+    nodeCount: num('Material expression nodes in the graph.'),
+    parameterCount: num('Material parameter expressions in the graph.'),
+    textureSampleCount: num('Texture sample expressions in the graph.'),
+    parameters: arr('Material parameter names.'),
+    isMaterialInstance: bool('True when the asset is a material instance.'),
+    isTwoSided: bool('True when the material renders two-sided.'),
+    isMasked: bool('True when the material uses masked blending.'),
+    blendMode: str('Material blend mode enum name.'),
+    shadingModel: str('First matching shading model name.'),
+    blueprintType: str('Blueprint kind: Class, Interface, MacroLibrary, or FunctionLibrary.'),
+    totalNodes: num('Total nodes across every Blueprint graph.'),
+    graphCount: num('Number of graphs in the Blueprint.'),
+    graphs: arrObj('Per-graph breakdown (name, nodeCount).'),
+    message: str('Explanation when the asset type carries no graph.'),
+}, ['success']);
+export const ASSET_QUERY_RECORDS = [
+    r('get_dependencies', 'asset', 'Retrieve the dependency graph for an asset.', schema({ assetPath: ASSET_PATH, recursive: bool('Recurse into dependencies.'), maxDepth: num('Maximum traversal depth.') }, ['assetPath']), OK, READ, READ_POLICY, MEDIUM, { dispatchMode: 'tool',
+        examples: [ex('Resolve a material\'s dependencies three levels deep', { assetPath: '/Game/Materials/M_Base', recursive: true, maxDepth: 3 }, { success: true })] }),
+    r('get_source_control_state', 'asset', 'Retrieve source-control state for an asset.', schema({ assetPath: ASSET_PATH, recursive: bool('Recurse into dependencies.') }, ['assetPath']), OK, READ, READ_POLICY, LOW, { dispatchAction: 'asset_query', dispatchMode: 'action',
+        normalization: divergence('Transport divergence: TS routes get_source_control_state through the asset_query bridge action, not manage_asset.'),
+        examples: [ex('Check whether a mesh is checked out', { assetPath: '/Game/Meshes/SM_Crate' }, { success: true })] }),
+    r('analyze_graph', 'asset', 'Analyze the node graph inside a material or Blueprint asset.', schema({ assetPath: ASSET_PATH, maxDepth: num('Maximum traversal depth (clamped to 8).') }, ['assetPath']), ANALYZE_GRAPH_OK, READ, READ_POLICY, MEDIUM, { dispatchAction: 'get_asset_graph', dispatchMode: 'action',
+        normalization: divergence('Transport divergence: TS routes analyze_graph to the get_asset_graph bridge action. analyze_graph and get_asset_graph are distinct capabilities sharing a graph-analysis domain.'),
+        examples: [ex('Inspect a material\'s expression graph', { assetPath: '/Game/Materials/M_Base', maxDepth: 2 }, { success: true, graphType: 'Material', nodeCount: 4, parameterCount: 2, blendMode: 'BLEND_Opaque' })] }),
+    r('get_asset_graph', 'asset', 'Retrieve the asset reference graph directly via the get_asset_graph bridge action.', schema({ assetPath: ASSET_PATH, maxDepth: num('Maximum traversal depth (clamped to 8).') }, ['assetPath']), GRAPH_OK, READ, READ_POLICY, MEDIUM, { dispatchMode: 'tool',
+        normalization: divergence('Direct bridge dispatch via get_asset_graph subAction. Distinct from analyze_graph which routes here as a transport alias.'),
+        examples: [ex('Read the reference graph through the direct bridge route', { assetPath: '/Game/Materials/M_Base', maxDepth: 2 }, { success: true })] }),
+    r('create_thumbnail', 'asset', 'Generate a thumbnail for an asset.', schema({ assetPath: ASSET_PATH, width: num('Thumbnail width.'), height: num('Thumbnail height.') }, ['assetPath']), OK, WRITE, WRITE_POLICY, LOW, { dispatchAction: 'generate_thumbnail', dispatchMode: 'tool',
+        normalization: divergence('Transport divergence: TS dispatches create_thumbnail with subAction generate_thumbnail.'),
+        examples: [ex('Render a 256x256 thumbnail', { assetPath: '/Game/Meshes/SM_Crate', width: 256, height: 256 }, { success: true })] }),
+    r('set_tags', 'asset', 'Set tags on an asset.', schema({ assetPath: ASSET_PATH, tags: arr('Tags to set.') }, ['assetPath', 'tags']), OK, WRITE, WRITE_POLICY, LOW, { dispatchAction: 'set_tags', dispatchMode: 'action',
+        examples: [ex('Tag an asset for review', { assetPath: '/Game/Meshes/SM_Crate', tags: ['Reviewed', 'Prop'] }, { success: true })] }),
+    r('get_metadata', 'asset', 'Retrieve metadata and tags for an asset.', schema({ assetPath: ASSET_PATH }, ['assetPath']), schema({ success: bool('Operation succeeded.'), assetPath: ASSET_PATH, tags: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Asset Registry tags (key-value).' }, metadata: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Custom package metadata (key-value).' } }, ['success']), READ, READ_POLICY, LOW, { dispatchMode: 'tool',
+        examples: [ex('Read metadata for a mesh', { assetPath: '/Game/Meshes/SM_Crate' }, { success: true, assetPath: '/Game/Meshes/SM_Crate', metadata: { Author: 'ArtTeam' } })] }),
+    r('set_metadata', 'asset', 'Set metadata key-value pairs on an asset.', schema({ assetPath: ASSET_PATH, metadata: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Metadata key-value pairs.' } }, ['assetPath', 'metadata']), OK, WRITE, WRITE_POLICY, LOW, { dispatchAction: 'set_metadata', dispatchMode: 'action',
+        examples: [ex('Record authoring provenance', { assetPath: '/Game/Meshes/SM_Crate', metadata: { Author: 'ArtTeam', Revision: '3' } }, { success: true })] }),
+    r('validate', 'asset', 'Validate an asset for errors.', schema({ assetPath: ASSET_PATH }, ['assetPath']), OK, READ, READ_POLICY, MEDIUM, { dispatchMode: 'tool',
+        examples: [ex('Validate a material before submit', { assetPath: '/Game/Materials/M_Base' }, { success: true })] }),
+    r('fixup_redirectors', 'asset', 'Fix up redirector assets in a directory.', schema({ directoryPath: str('Directory path to fix up.'), path: str('Alternative directory path.') }, [], ['directoryPath', 'path']), OK, WRITE, WRITE_POLICY, MEDIUM, { dispatchAction: 'fixup_redirectors', dispatchMode: 'action',
+        examples: [ex('Clean up redirectors left by a move', { directoryPath: '/Game/Meshes' }, { success: true })] }),
+    r('find_by_tag', 'asset', 'Find assets by tag with bounded pagination.', schema({ tag: str('Tag name to search for.'), value: str('Optional tag value.') }, ['tag']), OK, READ, READ_POLICY, LOW, { dispatchAction: 'asset_query', dispatchMode: 'action',
+        examples: [ex('Find every asset tagged Reviewed', { tag: 'Reviewed' }, { success: true })] }),
+    r('generate_report', 'asset', 'Generate an asset report for a directory.', schema({ directory: str('Directory to report on.'), reportType: str('Report type.'), outputPath: str('Output file path.') }, []), OK, READ, READ_POLICY, MEDIUM, { dispatchMode: 'tool',
+        examples: [ex('Report on the Meshes directory', { directory: '/Game/Meshes', reportType: 'summary', outputPath: '/Game/Reports/Meshes' }, { success: true })] })
+];
+//# sourceMappingURL=asset-query.js.map

package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.js.map

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

package/dist/tools/catalog/capabilities/records/manage-asset/builder.d.ts

@@ -0,0 +1,57 @@
+import type { CapabilityAvailability, CapabilityBehaviorSource, CapabilityCost, CapabilityExample, CapabilityNormalization, CapabilityPolicy, Draft202012ObjectSchema, JsonObject } from '../../model.js';
+export declare function schema(properties: JsonObject, required?: readonly string[], requiredOneOf?: readonly string[]): Draft202012ObjectSchema;
+export declare const str: (desc: string) => JsonObject;
+export declare const num: (desc: string) => JsonObject;
+export declare const bool: (desc: string) => JsonObject;
+export declare const arr: (desc: string) => JsonObject;
+export declare const arrObj: (desc: string) => JsonObject;
+export declare const refObj: (desc: string) => JsonObject;
+export declare const boundedLimit: (maxPageSize: number, defaultPageSize: number) => JsonObject;
+export declare const boundedPagination: (maxPageSize: number, defaultPageSize: number) => JsonObject;
+export declare const READ: CapabilityBehaviorSource;
+export declare const WRITE: CapabilityBehaviorSource;
+export declare const DESTRUCTIVE: CapabilityBehaviorSource;
+export declare const NON_IDEMPOTENT: CapabilityBehaviorSource;
+export declare const READ_POLICY: CapabilityPolicy;
+export declare const WRITE_POLICY: CapabilityPolicy;
+export declare const DESTRUCTIVE_POLICY: CapabilityPolicy;
+export declare const LOW: CapabilityCost;
+export declare const MEDIUM: CapabilityCost;
+export declare const HIGH: CapabilityCost;
+export declare const RETAIN: CapabilityNormalization;
+export declare function aliasCanonical(aliasAction: string): CapabilityNormalization;
+export declare function aliasOf(canonicalId: string): CapabilityNormalization;
+export declare function divergence(rationale: string): CapabilityNormalization;
+export declare function ex(title: string, input: JsonObject, output: JsonObject): CapabilityExample;
+export type Family = 'asset' | 'material' | 'texture' | 'struct' | 'datatable' | 'enum';
+export type DispatchMode = 'tool' | 'action' | 'local';
+export type NonEmptyExamples = readonly [CapabilityExample, ...CapabilityExample[]];
+export interface RecordSpec {
+    readonly action: string;
+    readonly family: Family;
+    readonly summary: string;
+    readonly input: Draft202012ObjectSchema;
+    readonly output: Draft202012ObjectSchema;
+    readonly behavior: CapabilityBehaviorSource;
+    readonly policy: CapabilityPolicy;
+    readonly cost: CapabilityCost;
+    readonly aliases: readonly string[];
+    readonly topics: readonly string[];
+    readonly dispatchAction: string;
+    readonly dispatchMode: DispatchMode;
+    readonly normalization: CapabilityNormalization;
+    readonly examples: NonEmptyExamples;
+    readonly availability: CapabilityAvailability;
+}
+export interface SpecOptions {
+    readonly aliases?: readonly string[];
+    readonly topics?: readonly string[];
+    readonly dispatchAction?: string;
+    readonly dispatchMode?: DispatchMode;
+    readonly normalization?: CapabilityNormalization;
+    readonly examples: NonEmptyExamples;
+    readonly requiredPlugins?: readonly string[];
+}
+export declare function r(action: string, family: Family, summary: string, input: Draft202012ObjectSchema, output: Draft202012ObjectSchema, behavior: CapabilityBehaviorSource, policy: CapabilityPolicy, cost: CapabilityCost, options: SpecOptions): RecordSpec;
+export declare function toSource(spec: RecordSpec): Record<string, unknown>;
+//# sourceMappingURL=builder.d.ts.map

package/dist/tools/catalog/capabilities/records/manage-asset/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/manage-asset/builder.ts"],"names":[],"mappings":"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"}

package/dist/tools/catalog/capabilities/records/manage-asset/builder.js

@@ -0,0 +1,111 @@
+import { DRAFT_2020_12_SCHEMA_URI } from '../../constants.js';
+import { CapabilityIdSchema } from '../../identifiers.js';
+import { getParentToolMetadata } from '../parent-metadata.js';
+export function schema(properties, required = [], requiredOneOf) {
+    return {
+        $schema: DRAFT_2020_12_SCHEMA_URI,
+        type: 'object',
+        properties,
+        required,
+        ...(requiredOneOf === undefined ? {} : { requiredOneOf: [...requiredOneOf] }),
+        additionalProperties: false,
+    };
+}
+export const str = (desc) => ({ type: 'string', description: desc });
+export const num = (desc) => ({ type: 'number', description: desc });
+export const bool = (desc) => ({ type: 'boolean', description: desc });
+export const arr = (desc) => ({ type: 'array', items: { type: 'string' }, description: desc });
+export const arrObj = (desc) => ({ type: 'array', items: { type: 'object', 'x-unreal-reflection-boundary': true }, description: desc });
+export const refObj = (desc) => ({ type: 'object', 'x-unreal-reflection-boundary': true, description: desc });
+export const boundedLimit = (maxPageSize, defaultPageSize) => ({
+    type: 'number', minimum: 1, maximum: maxPageSize, default: defaultPageSize,
+    description: `Page size (1-${maxPageSize}, default ${defaultPageSize}).`
+});
+export const boundedPagination = (maxPageSize, defaultPageSize) => ({
+    type: 'object',
+    properties: {
+        limit: boundedLimit(maxPageSize, defaultPageSize),
+        offset: { type: 'number', minimum: 0, description: 'Zero-based offset into the full result set.' }
+    },
+    additionalProperties: false,
+    description: 'Nested pagination envelope. Top-level limit/offset take precedence when both are supplied.'
+});
+export const READ = { effect: 'read', idempotency: 'idempotent', longRunning: false, safeToRetry: true, supportsPreview: false, supportsUndo: false };
+export const WRITE = { effect: 'write', idempotency: 'idempotent', longRunning: false, safeToRetry: true, supportsPreview: true, supportsUndo: true };
+export const DESTRUCTIVE = { effect: 'destructive', idempotency: 'idempotent', longRunning: true, safeToRetry: false, supportsPreview: true, supportsUndo: false };
+export const NON_IDEMPOTENT = { effect: 'write', idempotency: 'non-idempotent', longRunning: false, safeToRetry: false, supportsPreview: true, supportsUndo: true };
+export const READ_POLICY = { requiredScope: 'read', consent: 'none', dataAccess: 'project-read' };
+export const WRITE_POLICY = { requiredScope: 'write', consent: 'explicit', dataAccess: 'project-write' };
+export const DESTRUCTIVE_POLICY = { requiredScope: 'destructive', consent: 'elevated', dataAccess: 'project-write' };
+export const LOW = { latency: 'instant', resources: 'low' };
+export const MEDIUM = { latency: 'interactive', resources: 'medium' };
+export const HIGH = { latency: 'long-running', resources: 'high' };
+const DEFAULT_AVAILABILITY = {
+    unreal: { min: { major: 5, minor: 0, patch: 0, channel: 'stable' }, max: { major: 5, minor: 8, patch: 0, channel: 'preview', preview: 1 } },
+    requiredPlugins: ['EditorScriptingUtilities'],
+    editorStates: ['edit']
+};
+export const RETAIN = {
+    class: 'C_SAME_VERB_DIFFERENT_TARGET', disposition: 'retain',
+    rationale: 'Distinct manage_asset capability with unique schema, target, and policy.'
+};
+export function aliasCanonical(aliasAction) {
+    return { class: 'B_ALIAS', disposition: 'canonical', rationale: `Short-form canonical; ${aliasAction} is an alias.` };
+}
+export function aliasOf(canonicalId) {
+    return {
+        class: 'B_ALIAS',
+        disposition: 'alias',
+        rationale: `Long-form alias of ${canonicalId}.`,
+        aliasOf: CapabilityIdSchema.parse(canonicalId),
+    };
+}
+export function divergence(rationale) {
+    return { class: 'C_SAME_VERB_DIFFERENT_TARGET', disposition: 'retain', rationale };
+}
+export function ex(title, input, output) {
+    return { title, input, output };
+}
+const FAMILY_NAMES = { asset: 'lifecycle', material: 'authoring', texture: 'procedural', struct: 'struct-authoring', datatable: 'datatable', enum: 'enum' };
+export function r(action, family, summary, input, output, behavior, policy, cost, options) {
+    const plugins = options.requiredPlugins
+        ? [...new Set([...DEFAULT_AVAILABILITY.requiredPlugins, ...options.requiredPlugins])]
+        : DEFAULT_AVAILABILITY.requiredPlugins;
+    return {
+        action, family, summary, input, output, behavior, policy, cost,
+        aliases: options.aliases ?? [],
+        topics: options.topics ?? [],
+        dispatchAction: options.dispatchAction ?? action,
+        dispatchMode: options.dispatchMode ?? 'tool',
+        normalization: options.normalization ?? RETAIN,
+        examples: options.examples,
+        availability: { ...DEFAULT_AVAILABILITY, requiredPlugins: plugins }
+    };
+}
+export function toSource(spec) {
+    const id = `${spec.family}.${spec.action}`;
+    return {
+        id,
+        aliases: spec.aliases,
+        legacyIds: [{ tool: 'manage_asset', action: spec.action }],
+        discovery: {
+            domain: spec.family,
+            family: FAMILY_NAMES[spec.family],
+            topics: [spec.action, ...spec.topics],
+            summary: spec.summary,
+            whenToUse: [`Use when: ${spec.summary}`],
+            whenNotToUse: ['Do not use when a different manage_asset action is more specific.']
+        },
+        schemas: { input: spec.input, output: spec.output },
+        examples: spec.examples,
+        availability: spec.availability,
+        behavior: spec.behavior,
+        policy: spec.policy,
+        cost: spec.cost,
+        routing: { parentTool: 'manage_asset', dispatchAction: spec.dispatchAction, dispatchMode: spec.dispatchMode },
+        normalization: spec.normalization,
+        deprecation: { status: 'active' },
+        parent: getParentToolMetadata('manage_asset')
+    };
+}
+//# sourceMappingURL=builder.js.map

package/dist/tools/catalog/capabilities/records/manage-asset/builder.js.map

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

package/dist/tools/catalog/capabilities/records/manage-asset/content-sources.d.ts

@@ -0,0 +1,3 @@
+import type { RecordSpec } from './builder.js';
+export declare const CONTENT_SOURCE_RECORDS: readonly RecordSpec[];
+//# sourceMappingURL=content-sources.d.ts.map

package/dist/tools/catalog/capabilities/records/manage-asset/content-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-sources.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/manage-asset/content-sources.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAwB/C,eAAO,MAAM,sBAAsB,EAAE,SAAS,UAAU,EAoOvD,CAAC"}

package/dist/tools/catalog/capabilities/records/manage-asset/content-sources.js

@@ -0,0 +1,171 @@
+import { arr, arrObj, bool, boundedLimit, ex, HIGH, LOW, MEDIUM, num, READ, READ_POLICY, r, RETAIN, schema, str, WRITE_POLICY } from './builder.js';
+const POST_MIGRATION = {
+    ...RETAIN,
+    provenance: 'post-migration',
+    rationale: 'Authored after the gateway migration; no pre-gateway occurrence to audit.',
+};
+const MIGRATE_BEHAVIOR = {
+    effect: 'write', idempotency: 'idempotent', longRunning: true,
+    safeToRetry: true, supportsPreview: true, supportsUndo: false
+};
+const SOURCE_ROOTS = 'engineTemplates | engineFeaturePacks | engineContent | enginePlugins | megascansLibrary | fabLibrary | projectContent | projectPlugins';
+const SOURCE_ROOT_PARAM = str(`Content source root token. One of: ${SOURCE_ROOTS}. A filesystem path is never accepted here — the token is resolved plugin-side, so no directory outside these roots is reachable. megascansLibrary probes both the shell Documents folder and the profile Documents folder (OneDrive redirects the first) and honours MCP_MEGASCANS_LIBRARY_DIR; fabLibrary reads the Fab plugin's own UFabSettings.CacheDirectoryPath and honours MCP_FAB_LIBRARY_DIR. The Fab plugin owns its own sign-in and downloading — these roots only read what it already placed on disk.`);
+export const CONTENT_SOURCE_RECORDS = [
+    r('list_content_sources', 'asset', 'Enumerate reusable content already installed on this machine: engine templates (vehicle, first person, ...), engine and plugin content, and Quixel Bridge / Fab packs already downloaded by those plugins. Call this before authoring assets from scratch — a production-grade vehicle, track kit or Megascans surface is usually already on disk. Feed a returned sourceRoot + sourceId straight into asset.migrate_assets. Results are paginated (default 50): an unfiltered sweep finds several hundred sources because every engine plugin that ships content counts, so narrow with sourceRoot or filter rather than paging through all of them.', schema({
+        sourceRoot: str(`Restrict the listing to one root. One of: ${SOURCE_ROOTS}. Omit to list every root.`),
+        filter: str('Case-sensitive substring matched against the source id and, for plugins, the category.'),
+        includePackageCounts: bool('Include packageCount per source. Costs a recursive file scan per returned entry, so leave off for a broad sweep and turn on once the candidate list is short.'),
+        limit: boundedLimit(500, 50),
+        offset: num('Zero-based offset into the full result set.')
+    }, []), schema({
+        success: bool('Operation succeeded.'),
+        sources: arrObj('Discovered sources. Each entry carries sourceRoot, sourceId, kind (template | featurePack | megascansPack | plugin | contentFolder), hasContentFolder, migratable, and packageCount when requested.'),
+        sourceCount: num('Sources on this page.'),
+        totalCount: num('Total matched sources before pagination.'),
+        limit: num('Applied page size.'),
+        offset: num('Applied zero-based offset.'),
+        hasMore: bool('True when more sources exist beyond this page.'),
+        nextOffset: num('Offset for the next page, or -1 on the last page.'),
+        rootDirectories: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Absolute directory each root token resolved to, so an operator can confirm where the Bridge library was found.' },
+        missingRoots: arr('Root tokens whose directory does not exist on this machine.')
+    }, ['success']), READ, READ_POLICY, MEDIUM, { dispatchAction: 'list_content_sources', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [
+            ex('Find the installed vehicle template', { sourceRoot: 'engineTemplates', filter: 'Vehicle' }, { success: true, sourceCount: 1 }),
+            ex('List downloaded Quixel/Fab packs with counts', { sourceRoot: 'megascansLibrary', includePackageCounts: true }, { success: true })
+        ] }),
+    r('list_fab_downloads', 'asset', 'Report what the Fab plugin has already downloaded to this machine, with the cache directory it used. Pair with list_content_sources(sourceRoot="fabLibrary") and asset.migrate_assets to bring a downloaded pack into the project. This reads local state only: Fab\'s catalog is not on disk — the plugin\'s browser is an authenticated web view that fetches listings and short-lived signed download URLs — so browsing and purchasing stay in the editor\'s Fab tab, and this reports what that leaves behind.', schema({}, []), schema({
+        success: bool('Operation succeeded.'),
+        downloads: arrObj('Cached Fab downloads. Each entry carries assetId and cachedFile.'),
+        downloadCount: num('Number of cached downloads.'),
+        cacheDirectory: str('Directory the Fab plugin caches downloads in.'),
+        cacheDirectoryExists: bool('False when nothing has been downloaded yet.'),
+        fabModuleAvailable: bool('True when the plugin was built against the Fab module and read the cache through its own API rather than scanning the directory.'),
+        note: str('Guidance on what to do next given the current state.')
+    }, ['success']), READ, READ_POLICY, LOW, { dispatchAction: 'list_fab_downloads', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Check for downloaded Fab content', {}, { success: true, downloadCount: 0 })] }),
+    r('list_fab_library', 'asset', 'List your Fab "My Library" entries that the Fab plugin has synced into the editor\'s data storage (TEDS). This is the searchable inventory of what your Fab account owns — distinct from list_fab_downloads, which only reports packs already downloaded to disk. Each row carries the listing AssetId, so a row can be handed straight to add_fab_asset_to_project instead of being a name you have to search for again. Being signed in is not sufficient: the library is readable only after `Fab.TEDS.MyFolderIntegration <batchSize>` runs via control_editor.console_command, and `Fab.Login` is needed only when the Fab tab shows you signed out (it opens Epic\'s account portal; no credential ever passes through this tool). A synced library is mostly engine versions and plugins carrying Source "uem", so filter for "fab" to see actual content. Columns are resolved by path, and the data storage is reached through the modular-features registry, so this never links the Fab module and keeps working when Fab changes its schema.', schema({
+        columnTypes: arr('Column struct paths to read, for example "/Script/Fab.FabObjectNameColumn". Defaults to the name column plus "/Script/Fab.FabObjectColumn", which carries AssetId, ListingType, Seller and Source. Selecting a column is also the row filter, so naming one Fab does not write for every row will hide rows. Override this when a Fab update renames or adds columns; unresolved paths are reported rather than failing the call.'),
+        filter: str('Case-sensitive substring matched against each serialized row. Use "fab" to drop the legacy "uem" engine and plugin entries that otherwise fill the row limit.'),
+        limit: { type: 'number', default: 200, minimum: 1, maximum: 1000, description: 'Maximum rows to return, clamped plugin-side.' }
+    }, []), schema({
+        success: bool('Operation succeeded.'),
+        entries: arrObj('Library rows. Each entry maps column struct name to that column\'s properties, read by reflection. FabObjectColumn.AssetId is the listing id add_fab_asset_to_project takes.'),
+        entryCount: num('Rows returned.'),
+        unresolvedColumnTypes: arr('Requested column paths that do not exist in this build — usually a Fab schema change.'),
+        note: str('Guidance on refreshing or paging the sync.')
+    }, ['success']), READ, READ_POLICY, MEDIUM, { dispatchAction: 'list_fab_library', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('List the synced Fab library, skipping legacy engine entries', { limit: 50, filter: 'fab' }, { success: true, entryCount: 0 })] }),
+    r('download_fab_asset', 'asset', 'Download a Fab asset through the Fab plugin\'s own downloader (FFabDownloadRequest), so the transfer uses its HTTP/BuildPatchServices path rather than a parallel implementation that would miss its retry handling. IMPORTANT: the signed downloadUrl is NOT minted here — Fab issues it from its authenticated web session and no C++ entry point initiates that, so supply a URL obtained from the Fab tab\'s own flow. Once the pack lands, asset.migrate_assets with sourceRoot "fabLibrary" places it into /Game. Acquires content against the signed-in account, so it is an explicit-consent write.', schema({
+        assetId: str('Fab asset id, used as the cache key.'),
+        downloadUrl: str('Signed https download URL issued by Fab. Short-lived: a stale URL fails with DOWNLOAD_FAILED.'),
+        destinationDirectory: str('Where the pack lands. Defaults to the Fab library cache directory, which list_fab_downloads and the fabLibrary source root both read.'),
+        downloadType: { type: 'string', default: 'http', description: 'Transfer mode: "http" or "buildpatch". BuildPatchServices is for Marketplace-era packs; pointing it at a plain URL stalls rather than failing, so it must be opted into.' }
+    }, ['assetId', 'downloadUrl']), schema({
+        success: bool('True when the transfer completed.'),
+        downloadSucceeded: bool('Downloader-reported success.'),
+        servedFromCache: bool('True when the pack was already cached and no transfer occurred.'),
+        completedBytes: num('Bytes transferred.'),
+        totalBytes: num('Expected total bytes.'),
+        destinationDirectory: str('Directory the pack landed in.'),
+        downloadedFiles: arr('Files the downloader reported writing.'),
+        note: str('How to place the downloaded pack into /Game.')
+    }, ['success']), MIGRATE_BEHAVIOR, WRITE_POLICY, HIGH, { dispatchAction: 'download_fab_asset', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Download a pack from a signed URL', { assetId: 'abc123', downloadUrl: 'https://example.invalid/signed' }, { success: false })] }),
+    r('get_fab_listing_details', 'asset', 'Describe one Fab listing — description, tags, seller, preview image and the asset formats it ships — so a caller can choose between search hits rather than guess from a title. Requires the Fab tab open and signed in. canAddToProject answers what search cannot: whether add_fab_asset_to_project can import this listing, true for unreal-engine, gltf, glb and fbx alike; hasUnrealBuild is narrower and covers only the packaged case. The preview comes back as imageBase64, promoted into a real MCP image block rather than a URL, and is omitted rather than truncated past the reply cap. When a field cannot be read the response names the keys it did see, so a Fab schema change reports itself.', schema({ listingId: str('Fab listing uid. Restricted to [A-Za-z0-9_-], 64 characters max.') }, ['listingId']), schema({
+        success: bool('Listing was described.'),
+        listingId: str('Listing that was described.'),
+        title: str('Listing title.'),
+        listingType: str('Content kind, e.g. 3d-model or material.'),
+        description: str('Listing prose, truncated to 4000 characters.'),
+        seller: str('Publisher name.'),
+        tags: arr('Listing tags.'),
+        imageBase64: str('Preview image bytes, base64. Promoted to an MCP image content block.'),
+        mimeType: str('Preview image MIME type.'),
+        hasImage: bool('False when no preview could be inlined.'),
+        imageOmitted: str('Present when the preview was skipped for exceeding the reply cap.'),
+        descriptionKeys: arr('Listing keys observed when no description field matched.'),
+        thumbnailShape: arr('Thumbnail keys observed when no image URL matched.'),
+        assetFormats: arr('Asset format codes this listing ships, e.g. unreal-engine, fbx, gltf.'),
+        hasUnrealBuild: bool('True when the listing ships a packaged unreal-engine build, which Fab imports through its pack workflow.'),
+        canAddToProject: bool('True when add_fab_asset_to_project can actually import this listing. unreal-engine, gltf, glb and fbx are importable through the pack and Interchange workflows. Quixel/Megascans listings are the exception: Fab will not serve their download until the listing is claimed, and the claim is CSRF-protected with no token exposed to the page, so this reports false and addBlockedReason says so. Check this rather than hasUnrealBuild before adding.'),
+        addBlockedReason: str('Present when canAddToProject is false: why this listing cannot be imported.')
+    }, ['success']), READ, READ_POLICY, MEDIUM, { dispatchAction: 'get_fab_listing_details', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Describe a listing before adding it', { listingId: 'ac2818b3-7d35-4cf5-a1af-cbf8ff5c61c1' }, { success: true, hasImage: true })] }),
+    r('search_fab_listings', 'asset', 'Search the whole public Fab catalog through the signed-in Fab tab and get listing ids you can pass straight to add_fab_asset_to_project. Requires that tab open and signed in. A hit is a candidate, not a promise: no channel filter is applied, because pinning one hid the Quixel/Megascans library entirely. Whether a listing can be imported is resolved at add time, which reports NO_IMPORTABLE_FORMAT only when the listing ships none of unreal-engine, gltf, glb or fbx; call get_fab_listing_details first if you want canAddToProject up front. Results carry ids and labels only; no thumbnail, download URL or account field leaves the page.', schema({
+        query: str('Free-text search. At most 128 characters, and no quotes, backslashes or control characters.'),
+        freeOnly: { type: 'boolean', default: false, description: 'Restrict to free listings.' },
+        limit: { type: 'number', minimum: 1, maximum: 50, default: 12, description: 'Maximum listings to return (1-50).' }
+    }, []), schema({
+        success: bool('Search completed.'),
+        listings: arrObj('Matched listings: listingId, title, listingType, isFree (derived from price), rawIsFree (the listing flag, which disagrees), tags, and unresolvedPriceShape when price could not be read.'),
+        listingCount: num('Listings returned.'),
+        query: str('Query that was run.'),
+        note: str('How to use a returned listingId, and what listingType does and does not guarantee.')
+    }, ['success']), READ, READ_POLICY, MEDIUM, { dispatchAction: 'search_fab_listings', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Find free Unreal rocks on Fab', { query: 'rock', freeOnly: true, limit: 5 }, { success: true, listingCount: 0 })] }),
+    r('add_fab_asset_to_project', 'asset', 'Add one Fab listing to this project through the signed-in Fab tab, which must be open. Claims the listing first: Fab answers 404 for a download the account does not own, so this posts add-to-library exactly as the Fab UI does when you press Add to Project — a real change to your Fab library, free to claim and harmless to repeat on a listing you already own. Then it picks the format the Fab importer accepts (unreal-engine, else gltf/glb/fbx) and hands over the download. Supply only a listing id; the signed URL, EOS token and session cookie stay inside the page and reach no response or log. Fab chooses the destination, so this reports importedRoot — use asset.migrate_assets to relocate. Success is decided by the asset registry, not by Fab: IMPORT_TIMED_OUT when nothing appears.', schema({
+        listingId: str('Fab listing uid, as it appears in a fab.com/listings/<uid> URL. Restricted to [A-Za-z0-9_-], 64 characters max, because it is used to build an API path.')
+    }, ['listingId']), schema({
+        success: bool('True only when assets actually appeared in the registry.'),
+        listingId: str('Listing that was requested.'),
+        accepted: bool('True when Fab accepted the workflow. Not the same as content existing.'),
+        assetCount: num('New assets the registry gained during the import.'),
+        importedRoot: str('Where the pack landed, chosen by Fab (typically /Game/<PackName>).'),
+        engineExactMatch: bool('False when no listing version declared the running engine and the first version was used instead.'),
+        versionName: str('Listing version selected for this engine.'),
+        sampleAssetPaths: arr('Up to ten imported asset paths, as registry evidence.'),
+        note: str('How to relocate the imported tree.')
+    }, ['success']), MIGRATE_BEHAVIOR, WRITE_POLICY, HIGH, { dispatchAction: 'add_fab_asset_to_project', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Add a Fab listing to the project', { listingId: 'ac2818b3-7d35-4cf5-a1af-cbf8ff5c61c1' }, { success: false })] }),
+    r('list_megascans_library', 'asset', 'List the Quixel Bridge / Megascans library index on this machine. Unlike Fab — whose catalog exists only inside an authenticated web view — Bridge writes a plain uassetsData.json next to the downloaded packs, so the inventory is an ordinary local read. Pair with import_megascans_asset to bring an entry into the project.', schema({ filter: str('Case-sensitive substring matched against each serialized index entry.') }, []), schema({
+        success: bool('Operation succeeded.'),
+        assets: arrObj('Indexed library entries, verbatim from uassetsData.json.'),
+        assetCount: num('Entries returned.'),
+        libraryDirectory: str('Resolved Megascans library directory.'),
+        indexPath: str('Path of the uassetsData.json index.'),
+        indexExists: bool('False when Bridge has never written an index here.'),
+        importAvailable: bool('True when this build links the MegascansPlugin module, so import_megascans_asset can run.')
+    }, ['success']), READ, READ_POLICY, LOW, { dispatchAction: 'list_megascans_library', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('List the downloaded Megascans library', {}, { success: true, assetCount: 0 })] }),
+    r('import_megascans_asset', 'asset', 'Import a downloaded Megascans pack through the Bridge plugin\'s own importer, headlessly — no Bridge window, no drag, no sign-in. Calls FAssetsImportController::DataReceived, the exported entry point the Bridge desktop app drives over its local TCP socket, so quality tiers, master materials and the MSPresets setup all apply exactly as they would from the UI. This imports content ALREADY on disk: downloading remains the Bridge app\'s job, since no download or catalog-search API is exported. Assets land under /Game/Megascans.', schema({
+        payload: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'A complete Bridge export envelope: { exportPayload: [ { assetId, assetType, exportMode, exportType, folderName, name, assetPaths[] } ] }. Use this to pass through exactly what Bridge would have sent.' },
+        assetPaths: arr('Absolute paths of the downloaded pack files. Used with folderName to synthesize a single-entry envelope when payload is omitted.'),
+        folderName: str('Destination folder name under /Game/Megascans. Required when synthesizing from assetPaths.'),
+        assetType: { type: 'string', default: '3d', description: 'Bridge asset type: 3d, 3dplant, atlas or surface.' },
+        exportMode: { type: 'string', default: 'normal', description: 'Bridge export mode: normal, normal_drag or progressive.' },
+        assetId: str('Megascans asset id. Defaults to folderName.'),
+        name: str('Display name. Defaults to folderName.')
+    }, []), schema({
+        success: bool('Operation succeeded.'),
+        entryCount: num('Export-payload entries dispatched to the importer.'),
+        note: str('Where the imported content lands.')
+    }, ['success']), MIGRATE_BEHAVIOR, WRITE_POLICY, HIGH, { dispatchAction: 'import_megascans_asset', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [ex('Import a downloaded surface pack', { folderName: 'Rock_Cliff_ud4kcfxda', assetType: 'surface', assetPaths: ['C:/Users/me/Documents/Megascans Library/Downloaded/UAssets/Rock_Cliff_ud4kcfxda'] }, { success: true, entryCount: 1 })] }),
+    r('migrate_assets', 'asset', 'Copy a content tree from an allowlisted source root into this project and scan it into the asset registry. This is how a Quixel Bridge / Fab pack or an engine template (its Blueprints, meshes, materials and maps) becomes usable content in the current project. IMPORTANT: package files store their references as absolute /Game/... paths and a copy cannot rewrite them, so the default destinationPath of "/Game" — which reproduces the source layout exactly — is the only setting that guarantees the migrated assets still resolve each other. Any other destinationPath relocates the tree and comes back with referenceIntegrity "at-risk". Run with dryRun first to see the file count and the package paths that will appear.', schema({
+        sourceRoot: SOURCE_ROOT_PARAM,
+        sourceId: str('Relative id under sourceRoot, exactly as returned by list_content_sources (for example "TP_VehicleAdvBP"). Must be relative: no "..", no leading "/", no drive prefix. Omit to migrate the root itself.'),
+        subPath: str('Optional folder under the source content directory, to migrate one subtree instead of the whole pack.'),
+        destinationPath: { type: 'string', default: '/Game', description: 'Root the copied tree lands under. Leave at "/Game" to preserve the source layout and keep internal references valid; any deeper path relocates the tree and flags referenceIntegrity as "at-risk".' },
+        overwrite: bool('Overwrite packages that already exist at the destination. Default false, which skips them and reports skippedCount.'),
+        dryRun: bool('Report what would be copied without writing anything. Returns the same counts and packagePaths sample.'),
+        maxPackages: { type: 'number', default: 4000, description: 'Refuse the migration when the source holds more files than this, so a mistyped source cannot copy tens of gigabytes. Narrow with subPath or raise deliberately.' }
+    }, ['sourceRoot']), schema({
+        success: bool('True when every file copied. False with code PARTIAL_FAILURE when some did not.'),
+        sourceDirectory: str('Absolute directory the packages were read from.'),
+        destinationPath: str('Destination /Game root.'),
+        copiedCount: num('Files copied (or that would be copied under dryRun).'),
+        skippedCount: num('Files already present at the destination and left alone because overwrite was false.'),
+        failedCount: num('Files that could not be copied.'),
+        totalFiles: num('Package files discovered in the source.'),
+        dryRun: bool('True when nothing was written.'),
+        referenceIntegrity: str('"preserved" when the source layout was reproduced under /Game, "at-risk" when destinationPath relocated it.'),
+        packagePaths: arr('Up to 40 destination package paths, for verifying the migration landed where expected.'),
+        failedFiles: arr('Up to 20 source-relative paths that failed to copy.'),
+        warnings: arr('Advisory messages, including the reference-integrity warning for a relocated destination.')
+    }, ['success']), MIGRATE_BEHAVIOR, WRITE_POLICY, HIGH, { dispatchAction: 'migrate_assets', dispatchMode: 'action', normalization: POST_MIGRATION,
+        examples: [
+            ex('Preview migrating the advanced vehicle template', { sourceRoot: 'engineTemplates', sourceId: 'TP_VehicleAdvBP', dryRun: true }, { success: true, referenceIntegrity: 'preserved' }),
+            ex('Migrate a downloaded Megascans pack', { sourceRoot: 'megascansLibrary', sourceId: 'Rock_Cliff_ud4kcfxda' }, { success: true })
+        ] })
+];
+//# sourceMappingURL=content-sources.js.map