blueprint-extractor-mcp 6.0.8 → 6.1.0

package/README.md

@@ -23,9 +23,10 @@ Blueprint Extractor MCP is a [Model Context Protocol](https://modelcontextprotoc
  AI Assistant         stdio           MCP Server         HTTP :30010        Unreal Editor
  ─────────────  ◄────────────►  ─────────────────  ◄──────────────────►  ─────────────────
   Claude Code                     Node.js process                         Remote Control API
-  Codex                           95 tools                                BlueprintExtractor
-  ...                             4 resource templates                    plugin
-                                  8 prompts
+  Codex                           106 tools                               BlueprintExtractor
+  ...                             38 resources                            plugin
+                                  4 resource templates
+                                  12 prompts
 ```
 
 **What the assistant can do through this server:**
@@ -69,7 +70,7 @@ Connects to the editor at `127.0.0.1:30010` by default.
 ```bash
 claude mcp add -s user -t stdio blueprint-extractor \
   -e UE_REMOTE_CONTROL_PORT=30010 \
-  -- npx -y blueprint-extractor-mcp@6.0.6
+  -- npx -y blueprint-extractor-mcp@6.1.0
 ```
 
 </td></tr>
@@ -78,7 +79,7 @@ claude mcp add -s user -t stdio blueprint-extractor \
 
 ```bash
 codex mcp add --env UE_REMOTE_CONTROL_PORT=30010 \
-  blueprint-extractor -- npx -y blueprint-extractor-mcp@6.0.6
+  blueprint-extractor -- npx -y blueprint-extractor-mcp@6.1.0
 ```
 
 </td></tr>
@@ -90,20 +91,25 @@ codex mcp add --env UE_REMOTE_CONTROL_PORT=30010 \
 
 ## Tool Surface
 
-Only **~13 core tools** are visible by default to keep the context window lean. Specialized families are loaded on demand via `activate_workflow_scope`.
-
-| Scope | Tools | What It Unlocks |
-|:------|------:|:----------------|
-| **Core** *(always on)* | ~13 | `extract_asset` `search_assets` `save_assets` `get_tool_help` `find_and_extract` |
-| `widget_authoring` | 25 | Widget tree ops, compile, CommonUI button styles, widget animations, visual captures |
-| `material_authoring` | 5 | `create_material` `modify_material` `material_graph_operation` + instances |
-| `blueprint_authoring` | 4 | Blueprint members, graphs, `trigger_live_coding` |
-| `schema_ai_authoring` | 11 | Structs, enums, Blackboards, Behavior Trees, State Trees |
-| `animation_authoring` | 7 | Anim sequences, montages, blend spaces, widget motion |
-| `data_tables` | 7 | Data assets, data tables, curves, Enhanced Input actions & mappings |
-| `import` | 3 | `import_assets` with texture/mesh options, job polling |
-| `automation_testing` | 7 | `run_automation_tests`, run inspection, project automation context, PIE lifecycle control |
-| `verification` | 9 | Widget captures, editor/runtime screenshots, motion checkpoint bundles, reference comparisons |
+Only the compact core surface is visible by default to keep the context window lean. Specialized families are loaded on demand via `activate_workflow_scope`.
+
+| Scope | What It Unlocks |
+|:------|:----------------|
+| **Core** *(always on)* | Search, extraction, list/save/help, editor-session binding, and project-control entry points such as `extract_asset`, `search_assets`, `save_assets`, `get_tool_help`, and `activate_workflow_scope` |
+| `widget_authoring` | Parent scope that loads `widget_authoring_structure`, `widget_authoring_visual`, and `widget_verification` together |
+| `widget_authoring_structure` | Widget tree structure, hierarchy edits, wrapping, moving, replacement, and batch operations |
+| `widget_authoring_visual` | Widget compile flows, CommonUI styles, widget animations, and widget preview capture |
+| `widget_verification` | Widget capture, checkpoint bundles, capture listing, cleanup, and reference comparison |
+| `material_authoring` | Material creation, `material_graph_operation`, compile, and material-instance edits |
+| `blueprint_authoring` | Blueprint creation, member edits, graph edits, and Live Coding trigger |
+| `schema_ai_authoring` | Structs, enums, Blackboards, Behavior Trees, and State Trees |
+| `animation_authoring` | Anim sequences, montages, blend spaces, and widget motion authoring |
+| `data_tables` | Data assets, data tables, curves, Input Actions, and Input Mapping Contexts |
+| `import` | Async asset import and import-job polling |
+| `automation_testing` | Host-side automation runs, coarse project automation context, and PIE lifecycle control |
+| `analysis` | Deterministic Blueprint review and low-noise project asset audits |
+| `project_intelligence` | Bounded editor context, project indexing, freshness status, and snippet-first context search |
+| `verification` | Editor/runtime screenshots, capture comparison, motion verification, and artifact inspection |
 
 ### Contract Design
 
@@ -133,7 +139,9 @@ See [../docs/CURRENT_STATUS.md](../docs/CURRENT_STATUS.md) for the current valid
 | `UE_BUILD_PLATFORM` | &mdash; | e.g. `Win64` |
 | `UE_BUILD_CONFIGURATION` | &mdash; | e.g. `Development` |
 
-`get_project_automation_context` surfaces the editor-derived `engineRoot`, `projectFilePath`, `editorTarget`, and `isPlayingInEditor` state that project-control and verification flows use for fallback or guard logic.
+`get_project_automation_context` surfaces the coarse editor-derived `engineRoot`, `projectFilePath`, `editorTarget`, and `isPlayingInEditor` state that project-control and verification flows use for fallback or guard logic.
+
+`get_editor_context` is the separate read-only editor-state snapshot for selection, open asset editors, active level, and PIE summary. It stays session-bound and intentionally does not open assets, change focus, or switch viewports.
 
 <br>
 
@@ -162,6 +170,10 @@ blueprint://test-runs/{run_id}/{artifact}  Automation test artifacts
 | `plan_widget_motion_verification` | Keyframe-bundle verification planning |
 | `wire_hud_widget_classes` | Class-default wiring for HUD assets |
 | `debug_widget_compile_errors` | Diagnosing and recovering from compile failures |
+| `understand_blueprint_project` | Building a project-understanding pass over indexed assets, docs, prompts, and resources |
+| `review_blueprint_asset` | Running a deterministic read-only Blueprint review flow |
+| `snapshot_editor_context` | Inspecting bounded editor state without changing editor focus |
+| `audit_blueprint_project` | Running a low-noise project asset audit |
 
 <br>
 

package/dist/active-editor-session.d.ts

@@ -1,4 +1,5 @@
 import type { ActiveEditorState, EditorInstanceSnapshot } from './editor-instance-types.js';
+import type { EditorContextSnapshot } from './tool-context.js';
 type ActiveEditorSessionOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
@@ -44,6 +45,7 @@ export declare class ActiveEditorSession {
     }): Promise<EditorInstanceSnapshot | undefined>;
     getBoundSnapshot(): EditorInstanceSnapshot | undefined;
     getWorkspaceProjectPath(): Promise<string | undefined>;
+    getEditorContext(): Promise<EditorContextSnapshot>;
     private ensureActiveEditor;
     private resolveCurrentEditorForConnection;
     private bindFromExplicitPins;

package/dist/active-editor-session.js

@@ -30,6 +30,12 @@ function buildActiveEditorDriftMessage(snapshot) {
         + `${snapshot.remoteControlHost}:${snapshot.remoteControlPort}. The session has been returned to an unbound state. `
         + 'Call list_running_editors and select_editor to continue.';
 }
+function toStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((entry) => typeof entry === 'string' && entry.length > 0);
+}
 export class ActiveEditorSession {
     cwd;
     env;
@@ -222,6 +228,48 @@ export class ActiveEditorSession {
         const resolution = await this.workspaceProjectPromise;
         return resolution.projectPath;
     }
+    async getEditorContext() {
+        const raw = await this.callSubsystem('GetEditorContext', {});
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.error === 'string' && parsed.error.length > 0) {
+            throw new Error(parsed.error);
+        }
+        const instanceId = typeof parsed.instanceId === 'string' ? parsed.instanceId : undefined;
+        const projectFilePath = typeof parsed.projectFilePath === 'string' ? parsed.projectFilePath : undefined;
+        if (!instanceId || !projectFilePath) {
+            throw new Error('GetEditorContext did not return instanceId and projectFilePath.');
+        }
+        const pieSummary = typeof parsed.pieSummary === 'object' && parsed.pieSummary !== null
+            ? parsed.pieSummary
+            : undefined;
+        return {
+            success: typeof parsed.success === 'boolean' ? parsed.success : true,
+            operation: typeof parsed.operation === 'string' ? parsed.operation : 'get_editor_context',
+            instanceId,
+            projectName: typeof parsed.projectName === 'string' ? parsed.projectName : undefined,
+            projectFilePath,
+            projectDir: typeof parsed.projectDir === 'string' ? parsed.projectDir : undefined,
+            engineRoot: typeof parsed.engineRoot === 'string' ? parsed.engineRoot : undefined,
+            editorTarget: typeof parsed.editorTarget === 'string' ? parsed.editorTarget : undefined,
+            remoteControlHost: typeof parsed.remoteControlHost === 'string' ? parsed.remoteControlHost : this.activeEditorSnapshot?.remoteControlHost ?? '127.0.0.1',
+            remoteControlPort: typeof parsed.remoteControlPort === 'number'
+                ? parsed.remoteControlPort
+                : this.activeEditorSnapshot?.remoteControlPort ?? 30010,
+            lastSeenAt: typeof parsed.lastSeenAt === 'string' ? parsed.lastSeenAt : undefined,
+            selectedAssetPaths: toStringArray(parsed.selectedAssetPaths),
+            selectedActorNames: toStringArray(parsed.selectedActorNames),
+            openAssetEditors: toStringArray(parsed.openAssetEditors),
+            activeLevel: typeof parsed.activeLevel === 'string' ? parsed.activeLevel : undefined,
+            pieSummary: pieSummary ? {
+                isPlayingInEditor: typeof pieSummary.isPlayingInEditor === 'boolean' ? pieSummary.isPlayingInEditor : undefined,
+                isSimulatingInEditor: typeof pieSummary.isSimulatingInEditor === 'boolean' ? pieSummary.isSimulatingInEditor : undefined,
+                worldName: typeof pieSummary.worldName === 'string' ? pieSummary.worldName : undefined,
+                worldPath: typeof pieSummary.worldPath === 'string' ? pieSummary.worldPath : undefined,
+            } : undefined,
+            partial: typeof parsed.partial === 'boolean' ? parsed.partial : undefined,
+            unsupportedSections: toStringArray(parsed.unsupportedSections),
+        };
+    }
     async ensureActiveEditor() {
         const validation = await this.validateActiveSelection();
         if (validation.healthy && this.activeEditorSnapshot) {

package/dist/catalogs/example-catalog.js

@@ -667,4 +667,48 @@ export const exampleCatalog = {
             },
         ],
     },
+    blueprint_review: {
+        summary: 'Run deterministic review first, then inspect the cited graph/variable evidence before planning any fix.',
+        recommended_flow: [
+            'review_blueprint',
+            'extract_blueprint',
+        ],
+        examples: [
+            {
+                title: 'review_gameplay_blueprint',
+                tool: 'review_blueprint',
+                arguments: {
+                    asset_path: '/Game/Blueprints/BP_PlayerCharacter',
+                },
+            },
+        ],
+    },
+    project_intelligence: {
+        summary: 'Warm the project index, search published context and asset metadata, snapshot bounded editor state when needed, then audit the relevant package scope.',
+        recommended_flow: [
+            'refresh_project_index',
+            'get_project_index_status',
+            'search_project_context',
+            'get_editor_context',
+            'audit_project_assets',
+        ],
+        examples: [
+            {
+                title: 'search_replication_context',
+                tool: 'search_project_context',
+                arguments: {
+                    query: 'replication authority review',
+                    page: 1,
+                    per_page: 5,
+                },
+            },
+            {
+                title: 'audit_ui_assets',
+                tool: 'audit_project_assets',
+                arguments: {
+                    package_path: '/Game/UI',
+                },
+            },
+        ],
+    },
 };

package/dist/helpers/next-step-hints.js

@@ -173,7 +173,7 @@ export const NEXT_STEP_HINTS_REGISTRY = new Map([
                 'Use get_tool_help for detailed usage of newly available tools.',
             ],
             on_error: [
-                'Check available scope names: widget_authoring, material_authoring, blueprint_authoring, schema_ai_authoring, animation_authoring, data_tables, import, automation_testing, verification.',
+                'Check available scope names: widget_authoring, material_authoring, blueprint_authoring, schema_ai_authoring, animation_authoring, data_tables, import, automation_testing, verification, analysis, project_intelligence.',
             ],
         }],
     ['find_and_extract', {

package/dist/helpers/tool-help.js

@@ -178,6 +178,18 @@ export function collectRelatedResources(toolName) {
         || toolName === 'relaunch_pie') {
         resources.add('blueprint://project-automation');
     }
+    if (toolName === 'review_blueprint' || toolName === 'audit_project_assets') {
+        resources.add('blueprint://analysis-workflows');
+    }
+    if (toolName === 'refresh_project_index'
+        || toolName === 'get_project_index_status'
+        || toolName === 'search_project_context'
+        || toolName === 'get_editor_context') {
+        resources.add('blueprint://project-intelligence-workflows');
+    }
+    if (toolName === 'get_editor_context') {
+        resources.add('blueprint://project-automation');
+    }
     if (toolName.includes('animation')
         || toolName.includes('motion')
         || toolName === 'compare_motion_capture_bundle') {

package/dist/project-controller.js

@@ -1,7 +1,7 @@
 import { execSync, spawn } from 'node:child_process';
 import { access, readdir, unlink } from 'node:fs/promises';
 import { constants as fsConstants } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { dirname, resolve, win32 as win32Path } from 'node:path';
 const DEFAULT_BUILD_TIMEOUT_MS = 30 * 60 * 1000;
 const DEFAULT_DISCONNECT_TIMEOUT_MS = 60 * 1000;
 const DEFAULT_RECONNECT_TIMEOUT_MS = 3 * 60 * 1000;
@@ -164,6 +164,9 @@ function fileName(path) {
     const lastSlash = normalized.lastIndexOf('/');
     return lastSlash >= 0 ? normalized.slice(lastSlash + 1) : normalized;
 }
+function normalizeFilesystemPathForCommand(path, platform) {
+    return platform === 'win32' ? win32Path.normalize(path) : path;
+}
 export function classifyChangedPaths(changedPaths, forceRebuild = false) {
     const reasons = new Set();
     if (forceRebuild) {
@@ -355,6 +358,7 @@ export class ProjectController {
             throw new Error('compile_project_code requires target or UE_PROJECT_TARGET/UE_EDITOR_TARGET');
         }
         const buildScript = await resolveBuildScript(engineRoot, this.platform);
+        const commandProjectPath = normalizeFilesystemPathForCommand(projectPath, this.platform);
         let uhtCacheFilesDeleted;
         if (request.clearUhtCache) {
             uhtCacheFilesDeleted = await clearUhtCacheFiles(dirname(projectPath));
@@ -363,7 +367,7 @@ export class ProjectController {
             target,
             platform,
             configuration,
-            `-Project=${projectPath}`,
+            `-Project=${commandProjectPath}`,
             '-WaitMutex',
             '-NoHotReloadFromIDE',
         ];

package/dist/prompts/prompt-catalog.js

@@ -282,6 +282,64 @@ export const promptCatalog = {
             'Return the minimal follow-up extract/modify/compile sequence needed to fix the compile state, then finish with capture_widget_preview or explicit partial verification if rendering is blocked.',
         ].join('\n'),
     },
+    understand_blueprint_project: {
+        title: 'Understand Blueprint Project',
+        description: 'Plan a project-understanding pass that uses the published project-intelligence tools and resources.',
+        args: {
+            package_path: z.string().default('/Game'),
+            question: z.string(),
+        },
+        buildPrompt: ({ package_path, question }) => [
+            `Understand the Blueprint Extractor project context rooted at ${package_path}.`,
+            `Question: ${question}.`,
+            'Start with refresh_project_index if the cache is missing or stale, then inspect get_project_index_status and search_project_context.',
+            'Prefer published docs, prompts, and resources before making assumptions from memory.',
+            'When the answer depends on one concrete asset, narrow into extract_asset, extract_blueprint, or extract_widget_blueprint instead of staying at search-summary level.',
+        ].join('\n'),
+    },
+    review_blueprint_asset: {
+        title: 'Review Blueprint Asset',
+        description: 'Plan a deterministic read-only Blueprint review pass.',
+        args: {
+            asset_path: z.string(),
+            review_goal: z.string().optional(),
+        },
+        buildPrompt: ({ asset_path, review_goal }) => [
+            `Review Blueprint asset ${asset_path}.`,
+            review_goal ? `Review goal: ${review_goal}.` : 'Focus on deterministic graph/data issues only.',
+            'Use review_blueprint first, then inspect the cited evidence with extract_blueprint when a finding needs deeper confirmation.',
+            'Keep the output findings-first and include only issues supported by extracted evidence.',
+            'Do not propose autofixes that are not backed by the current public tool surface.',
+        ].join('\n'),
+    },
+    snapshot_editor_context: {
+        title: 'Snapshot Editor Context',
+        description: 'Plan a bounded read-only editor-context inspection.',
+        args: {
+            intent: z.string(),
+        },
+        buildPrompt: ({ intent }) => [
+            `Snapshot the active editor context for: ${intent}.`,
+            'Use get_active_editor first when selection health is unclear, then call get_editor_context for bounded read-only state.',
+            'Treat the result as session-bound and partial when the editor is unbound, headless, or not rendering.',
+            'Do not suggest focus changes, asset opening, or viewport switching because get_editor_context is intentionally query-only.',
+        ].join('\n'),
+    },
+    audit_blueprint_project: {
+        title: 'Audit Blueprint Project',
+        description: 'Plan a low-noise project asset audit pass.',
+        args: {
+            package_path: z.string().default('/Game'),
+            class_filter: z.string().optional(),
+        },
+        buildPrompt: ({ package_path, class_filter }) => [
+            `Audit project assets under ${package_path}.`,
+            class_filter ? `Restrict the audit to class filter: ${class_filter}.` : 'Audit all asset classes in scope.',
+            'Use audit_project_assets for low-noise metadata checks, then use extract_asset or extract_blueprint only for follow-up on concrete findings.',
+            'Present results grouped by check family with counts first, then the actionable findings.',
+            'Keep unsupported checks out of scope instead of widening heuristics until they become noisy.',
+        ].join('\n'),
+    },
 };
 export function registerPromptCatalog(server) {
     for (const [name, prompt] of Object.entries(promptCatalog)) {

package/dist/register-server-tools.js

@@ -4,6 +4,7 @@ import { collectRelatedResources, collectToolExampleFamilies as collectToolExamp
 import { AnimMontageMutationOperationSchema, AnimationNotifySelectorSchema, AnimSequenceMutationOperationSchema, BehaviorTreeMutationOperationSchema, BehaviorTreeNodeSelectorSchema, BlackboardKeySchema, BlackboardMutationOperationSchema, BlendParameterSchema, BlendSpaceMutationOperationSchema, BlendSpaceSampleSchema, BlueprintGraphMutationOperationSchema, BlueprintMemberMutationOperationSchema, BuildConfigurationSchema, BuildPlatformSchema, CurveChannelSchema, CurveKeyDeleteSchema, CurveKeyUpsertSchema, CurveTableModeSchema, CurveTableRowSchema, CurveTypeSchema, DataTableRowSchema, ExtractAssetTypeSchema, EnhancedInputValueTypeSchema, FontImportItemSchema, ImportJobListSchema, ImportJobSchema, InputMappingSchema, JsonObjectSchema, MaterialConnectionSelectorFieldsSchema, MaterialFontParameterSchema, MaterialGraphOperationKindSchema, MaterialGraphOperationSchema, MaterialLayerStackSchema, MaterialNodePositionSchema, MaterialScalarParameterSchema, MaterialStaticSwitchParameterSchema, MaterialTextureParameterSchema, MaterialVectorParameterSchema, MeshImportOptionsSchema, StateTreeEditorNodeSelectorSchema, StateTreeMutationOperationSchema, StateTreeStateSelectorSchema, StateTreeTransitionSelectorSchema, StateTreeBindingsObjectSchema, TextureImportOptionsSchema, UserDefinedEnumEntrySchema, UserDefinedEnumMutationOperationSchema, UserDefinedStructFieldSchema, UserDefinedStructMutationOperationSchema, WidgetBlueprintMutationOperationSchema, WidgetNodeSchema, WidgetSelectorFieldsSchema, WindowFontApplicationSchema, } from './schemas/tool-inputs.js';
 import { applyWindowUiChangesResultSchema, AutomationRunListSchema, automationRunSchema, CaptureResultSchema, CascadeResultSchema, CleanupCapturesResultSchema, CompareCaptureResultSchema, CompareMotionCaptureBundleResultSchema, CreateModifyWidgetAnimationResultSchema, ExtractWidgetAnimationResultSchema, ListCapturesResultSchema, motionCaptureModeSchema, MotionCaptureBundleResultSchema, widgetAnimationCheckpointSchema, } from './schemas/tool-results.js';
 import { registerAnimationAuthoringTools } from './tools/animation-authoring.js';
+import { registerAnalysisTools } from './tools/analysis-tools.js';
 import { registerAutomationRunTools } from './tools/automation-runs.js';
 import { registerBlueprintAuthoringTools } from './tools/blueprint-authoring.js';
 import { registerCompositeTools } from './tools/composite-tools.js';
@@ -13,6 +14,7 @@ import { registerExtractionTools } from './tools/extraction.js';
 import { registerImportJobTools } from './tools/import-jobs.js';
 import { registerMaterialAuthoringTools } from './tools/material-authoring.js';
 import { registerMaterialInstanceTools } from './tools/material-instance.js';
+import { registerProjectIntelligenceTools } from './tools/project-intelligence.js';
 import { registerProjectControlTools } from './tools/project-control.js';
 import { registerSchemaAndAiAuthoringTools } from './tools/schema-and-ai-authoring.js';
 import { registerTablesAndCurvesTools } from './tools/tables-and-curves.js';
@@ -121,6 +123,10 @@ export function registerServerTools({ server, client, projectController, automat
         automationRunSchema,
         automationRunListSchema: AutomationRunListSchema,
     });
+    registerAnalysisTools({
+        server,
+        callSubsystemJson,
+    });
     registerProjectControlTools({
         server,
         client,
@@ -136,6 +142,10 @@ export function registerServerTools({ server, client, projectController, automat
         buildConfigurationSchema: BuildConfigurationSchema,
         editorPollIntervalMs,
     });
+    registerProjectIntelligenceTools({
+        server,
+        callSubsystemJson,
+    });
     registerWindowUiTools({
         server,
         client,

package/dist/resources/static-doc-resources.js

@@ -343,4 +343,37 @@ export function registerStaticDocResources(server) {
         '- When a scenario cannot export checkpoint artifacts yet, report partial verification explicitly instead of silently treating the automation run as sufficient proof.',
         '- Compile/save alone is never accepted as motion verification.',
     ]);
+    registerStaticTextResource(server, 'analysis-workflows', 'blueprint://analysis-workflows', 'Job-based entry paths for deterministic Blueprint review and asset-audit workflows.', [
+        'Blueprint Extractor Analysis Workflows',
+        '',
+        'Understand project:',
+        '- refresh_project_index -> get_project_index_status -> search_project_context',
+        '',
+        'Review asset:',
+        '- review_blueprint -> extract_blueprint',
+        '- review_blueprint returns deterministic findings only. Each finding includes severity, category, evidence, and next_steps.',
+        '',
+        'Audit project:',
+        '- audit_project_assets for low-noise asset metadata checks.',
+        '- Current check families: naming, package hygiene, and asset-family coverage.',
+        '',
+        'Guardrail:',
+        '- Findings-first output is intentional. Do not treat review_blueprint or audit_project_assets as autofix tools.',
+    ]);
+    registerStaticTextResource(server, 'project-intelligence-workflows', 'blueprint://project-intelligence-workflows', 'Job-based entry paths for indexing/searching published context and snapshotting bounded editor context.', [
+        'Blueprint Extractor Project Intelligence Workflows',
+        '',
+        'Project indexing:',
+        '- refresh_project_index caches asset metadata plus published docs, prompts, and resources.',
+        '- get_project_index_status reports freshness, size, and staleness.',
+        '- search_project_context returns snippet-first results with provenance and pagination.',
+        '',
+        'Snapshot editor context:',
+        '- get_editor_context is bounded, session-bound, and read-only.',
+        '- Returned sections are intentionally limited: selected_asset_paths, selected_actor_names, open_asset_editors, active_level, and pie_summary.',
+        '',
+        'Unsupported boundaries:',
+        '- get_editor_context does not open assets, change editor focus, or switch viewports.',
+        '- Search remains metadata-first in v1; code indexing is intentionally deferred.',
+    ]);
 }

package/dist/schemas/tool-inputs.d.ts

@@ -1346,14 +1346,14 @@ export declare const ImportJobSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    success: boolean;
+    operation: string;
     diagnostics: {
         code: string;
         message: string;
         severity: string;
         path?: string | undefined;
     }[];
-    success: boolean;
-    operation: string;
     items: {
         status: string;
         diagnostics: {
@@ -1396,14 +1396,14 @@ export declare const ImportJobSchema: z.ZodObject<{
     jobId?: string | undefined;
 }, {
     status: string;
+    success: boolean;
+    operation: string;
     diagnostics: {
         code: string;
         message: string;
         severity: string;
         path?: string | undefined;
     }[];
-    success: boolean;
-    operation: string;
     items: {
         status: string;
         diagnostics: {
@@ -1605,14 +1605,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         status: string;
+        success: boolean;
+        operation: string;
         diagnostics: {
             code: string;
             message: string;
             severity: string;
             path?: string | undefined;
         }[];
-        success: boolean;
-        operation: string;
         items: {
             status: string;
             diagnostics: {
@@ -1655,14 +1655,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
         jobId?: string | undefined;
     }, {
         status: string;
+        success: boolean;
+        operation: string;
         diagnostics: {
             code: string;
             message: string;
             severity: string;
             path?: string | undefined;
         }[];
-        success: boolean;
-        operation: string;
         items: {
             status: string;
             diagnostics: {
@@ -1711,14 +1711,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
     jobCount: number;
     jobs: {
         status: string;
+        success: boolean;
+        operation: string;
         diagnostics: {
             code: string;
             message: string;
             severity: string;
             path?: string | undefined;
         }[];
-        success: boolean;
-        operation: string;
         items: {
             status: string;
             diagnostics: {
@@ -1784,14 +1784,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
     jobCount: number;
     jobs: {
         status: string;
+        success: boolean;
+        operation: string;
         diagnostics: {
             code: string;
             message: string;
             severity: string;
             path?: string | undefined;
         }[];
-        success: boolean;
-        operation: string;
         items: {
             status: string;
             diagnostics: {
@@ -1872,16 +1872,16 @@ export declare const UserDefinedStructFieldSchema: z.ZodObject<{
     guid?: string | undefined;
     name?: string | undefined;
     defaultValue?: unknown;
+    metadata?: Record<string, unknown> | undefined;
     friendlyName?: string | undefined;
     pinType?: Record<string, unknown> | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }, {
     guid?: string | undefined;
     name?: string | undefined;
     defaultValue?: unknown;
+    metadata?: Record<string, unknown> | undefined;
     friendlyName?: string | undefined;
     pinType?: Record<string, unknown> | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }>;
 export declare const UserDefinedEnumEntrySchema: z.ZodObject<{
     name: z.ZodString;