@fps-games/editor 0.2.0-beta.3 → 0.2.0-beta.4

package/dist/agent-bridge/capabilities/editor-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-state.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/editor-state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAGL,KAAK,gDAAgD,EACrD,KAAK,kCAAkC,EACxC,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAK/E,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAC/E,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5D,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,UAAU,EAAE,gDAAgD,CAAC,SAAS,CAAC,GACtE,iCAAiC,CASnC"}
+{"version":3,"file":"editor-state.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/editor-state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAIL,KAAK,gDAAgD,EACrD,KAAK,kCAAkC,EACxC,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAK/E,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAC/E,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5D,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,UAAU,EAAE,gDAAgD,CAAC,SAAS,CAAC,GACtE,iCAAiC,CASnC"}

package/dist/agent-bridge/capabilities/editor-state.js

@@ -1,11 +1,11 @@
-import { cloneAgentBridgeSelection, EMPTY_EDITOR_SELECTION, } from '../shared.js';
+import { cloneAgentBridgeSelection, getAgentBridgeSafeSceneHierarchy, getAgentBridgeSafeSceneSelection, } from '../shared.js';
 import { createAgentBridgeSceneObject, listAgentBridgeSceneObjects, } from './scene-objects.js';
 const AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT = 100;
 const AGENT_BRIDGE_SNAPSHOT_MAX_OBJECT_LIMIT = 500;
 export function createLocalEditorAgentBridgeStateSource(state, options, operations) {
     return {
         getSnapshot(input) {
-            return createAgentBridgeEditorSnapshot(state, options, input);
+            return createAgentBridgeEditorSnapshot(state, options, input, operations);
         },
         getState(input) {
             return createAgentBridgeEditorState(state, options, input.objectId, operations);
@@ -15,11 +15,12 @@ export function createLocalEditorAgentBridgeStateSource(state, options, operatio
 function createAgentBridgeEditorState(state, options, objectId, operations) {
     const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;
     const document = sessionState?.workingDocument ?? null;
+    const safeSelection = getAgentBridgeSafeSceneSelection(operations);
     const requestedObjectId = typeof objectId === 'string' && objectId.trim()
         ? objectId.trim()
-        : sessionState?.selection.activeId ?? undefined;
+        : safeSelection.activeId ?? undefined;
     const object = document && requestedObjectId
-        ? createAgentBridgeSceneObject(state, options, document, requestedObjectId, operations.getHierarchy())
+        ? createAgentBridgeSceneObject(state, options, document, requestedObjectId, getAgentBridgeSafeSceneHierarchy(operations))
         : null;
     return {
         mode: state.mode,
@@ -28,16 +29,17 @@ function createAgentBridgeEditorState(state, options, objectId, operations) {
         statusDetails: state.statusDetails,
         dirty: sessionState?.dirty,
         busy: state.busy,
-        selection: cloneAgentBridgeSelection(sessionState?.selection ?? EMPTY_EDITOR_SELECTION),
+        selection: cloneAgentBridgeSelection(safeSelection),
         object,
-        diagnostics: createAgentBridgeStateDiagnostics(state),
+        diagnostics: createAgentBridgeStateDiagnostics(state, operations),
     };
 }
-function createAgentBridgeEditorSnapshot(state, options, input) {
+function createAgentBridgeEditorSnapshot(state, options, input, operations) {
     const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;
     const document = sessionState?.workingDocument ?? null;
+    const safeSelection = getAgentBridgeSafeSceneSelection(operations);
     const objects = state.mode === 'editor' && document
-        ? listAgentBridgeSceneObjects(state, options, document, input.includeUnselectable === true)
+        ? listAgentBridgeSceneObjects(state, options, document, input.includeUnselectable === true, operations)
         : [];
     const snapshot = {
         mode: state.mode,
@@ -45,7 +47,7 @@ function createAgentBridgeEditorSnapshot(state, options, input) {
         dirty: sessionState?.dirty ?? false,
         status: state.status,
         statusTone: state.statusTone,
-        selection: cloneAgentBridgeSelection(sessionState?.selection ?? EMPTY_EDITOR_SELECTION),
+        selection: cloneAgentBridgeSelection(safeSelection),
         objectCount: objects.length,
     };
     if (input.includeObjects === true) {
@@ -53,14 +55,21 @@ function createAgentBridgeEditorSnapshot(state, options, input) {
     }
     return snapshot;
 }
-function createAgentBridgeStateDiagnostics(state) {
-    if (state.statusTone !== 'error' && state.statusTone !== 'warning')
-        return [];
-    return [{
-            severity: state.statusTone,
-            source: 'editor',
-            message: state.statusDetails || state.status,
-        }];
+function createAgentBridgeStateDiagnostics(state, operations) {
+    return operations.getStatusDiagnostics().map(diagnostic => ({
+        severity: diagnostic.severity,
+        source: diagnostic.source,
+        code: diagnostic.code,
+        message: diagnostic.message,
+        ...(diagnostic.rowId ? { objectId: diagnostic.rowId } : {}),
+        details: {
+            ...(diagnostic.scopeId ? { scopeId: diagnostic.scopeId } : {}),
+            ...(diagnostic.targetId ? { targetId: diagnostic.targetId } : {}),
+            ...(diagnostic.documentRevision != null ? { documentRevision: diagnostic.documentRevision } : {}),
+            ...(diagnostic.projectionRevision != null ? { projectionRevision: diagnostic.projectionRevision } : {}),
+            ...(diagnostic.details ?? {}),
+        },
+    }));
 }
 function normalizeAgentBridgeSnapshotObjectLimit(value) {
     if (value === undefined)

package/dist/agent-bridge/capabilities/editor-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-state.js","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/editor-state.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EditorAgentBridgeEditorSnapshot,\n  EditorAgentBridgeEditorSnapshotGetInput,\n  EditorAgentBridgeEditorState,\n} from '@fps-games/editor-protocol';\nimport type { LocalEditorAgentBridgeStateSource } from '../source-types.js';\nimport {\n  cloneAgentBridgeSelection,\n  EMPTY_EDITOR_SELECTION,\n  type LocalEditorAgentBridgeCapabilitySourceOperations,\n  type LocalEditorAgentBridgeHarnessState,\n} from '../shared.js';\nimport {\n  createAgentBridgeSceneObject,\n  listAgentBridgeSceneObjects,\n} from './scene-objects.js';\nimport type { LocalEditorHarnessOptions } from '../../local-editor-harness.js';\n\nconst AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT = 100;\nconst AGENT_BRIDGE_SNAPSHOT_MAX_OBJECT_LIMIT = 500;\n\nexport function createLocalEditorAgentBridgeStateSource<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): LocalEditorAgentBridgeStateSource {\n  return {\n    getSnapshot(input) {\n      return createAgentBridgeEditorSnapshot(state, options, input);\n    },\n    getState(input) {\n      return createAgentBridgeEditorState(state, options, input.objectId, operations);\n    },\n  };\n}\n\nfunction createAgentBridgeEditorState<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  objectId: string | undefined,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): EditorAgentBridgeEditorState {\n  const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;\n  const document = sessionState?.workingDocument ?? null;\n  const requestedObjectId = typeof objectId === 'string' && objectId.trim()\n    ? objectId.trim()\n    : sessionState?.selection.activeId ?? undefined;\n  const object = document && requestedObjectId\n    ? createAgentBridgeSceneObject(state, options, document, requestedObjectId, operations.getHierarchy())\n    : null;\n  return {\n    mode: state.mode,\n    status: state.status,\n    statusTone: state.statusTone,\n    statusDetails: state.statusDetails,\n    dirty: sessionState?.dirty,\n    busy: state.busy,\n    selection: cloneAgentBridgeSelection(sessionState?.selection ?? EMPTY_EDITOR_SELECTION),\n    object,\n    diagnostics: createAgentBridgeStateDiagnostics(state),\n  };\n}\n\nfunction createAgentBridgeEditorSnapshot<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  input: EditorAgentBridgeEditorSnapshotGetInput,\n): EditorAgentBridgeEditorSnapshot {\n  const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;\n  const document = sessionState?.workingDocument ?? null;\n  const objects = state.mode === 'editor' && document\n    ? listAgentBridgeSceneObjects(state, options, document, input.includeUnselectable === true)\n    : [];\n  const snapshot: EditorAgentBridgeEditorSnapshot = {\n    mode: state.mode,\n    busy: state.busy,\n    dirty: sessionState?.dirty ?? false,\n    status: state.status,\n    statusTone: state.statusTone,\n    selection: cloneAgentBridgeSelection(sessionState?.selection ?? EMPTY_EDITOR_SELECTION),\n    objectCount: objects.length,\n  };\n  if (input.includeObjects === true) {\n    snapshot.objects = objects.slice(0, normalizeAgentBridgeSnapshotObjectLimit(input.objectLimit));\n  }\n  return snapshot;\n}\n\nfunction createAgentBridgeStateDiagnostics<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n): EditorAgentBridgeEditorState['diagnostics'] {\n  if (state.statusTone !== 'error' && state.statusTone !== 'warning') return [];\n  return [{\n    severity: state.statusTone,\n    source: 'editor',\n    message: state.statusDetails || state.status,\n  }];\n}\n\nfunction normalizeAgentBridgeSnapshotObjectLimit(value: unknown): number {\n  if (value === undefined) return AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT;\n  if (typeof value !== 'number' || !Number.isFinite(value)) return AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT;\n  return Math.max(0, Math.min(AGENT_BRIDGE_SNAPSHOT_MAX_OBJECT_LIMIT, Math.floor(value)));\n}\n"]}
+{"version":3,"file":"editor-state.js","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/editor-state.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EditorAgentBridgeEditorSnapshot,\n  EditorAgentBridgeEditorSnapshotGetInput,\n  EditorAgentBridgeEditorState,\n} from '@fps-games/editor-protocol';\nimport type { LocalEditorAgentBridgeStateSource } from '../source-types.js';\nimport {\n  cloneAgentBridgeSelection,\n  getAgentBridgeSafeSceneHierarchy,\n  getAgentBridgeSafeSceneSelection,\n  type LocalEditorAgentBridgeCapabilitySourceOperations,\n  type LocalEditorAgentBridgeHarnessState,\n} from '../shared.js';\nimport {\n  createAgentBridgeSceneObject,\n  listAgentBridgeSceneObjects,\n} from './scene-objects.js';\nimport type { LocalEditorHarnessOptions } from '../../local-editor-harness.js';\n\nconst AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT = 100;\nconst AGENT_BRIDGE_SNAPSHOT_MAX_OBJECT_LIMIT = 500;\n\nexport function createLocalEditorAgentBridgeStateSource<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): LocalEditorAgentBridgeStateSource {\n  return {\n    getSnapshot(input) {\n      return createAgentBridgeEditorSnapshot(state, options, input, operations);\n    },\n    getState(input) {\n      return createAgentBridgeEditorState(state, options, input.objectId, operations);\n    },\n  };\n}\n\nfunction createAgentBridgeEditorState<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  objectId: string | undefined,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): EditorAgentBridgeEditorState {\n  const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;\n  const document = sessionState?.workingDocument ?? null;\n  const safeSelection = getAgentBridgeSafeSceneSelection(operations);\n  const requestedObjectId = typeof objectId === 'string' && objectId.trim()\n    ? objectId.trim()\n    : safeSelection.activeId ?? undefined;\n  const object = document && requestedObjectId\n    ? createAgentBridgeSceneObject(\n        state,\n        options,\n        document,\n        requestedObjectId,\n        getAgentBridgeSafeSceneHierarchy(operations),\n      )\n    : null;\n  return {\n    mode: state.mode,\n    status: state.status,\n    statusTone: state.statusTone,\n    statusDetails: state.statusDetails,\n    dirty: sessionState?.dirty,\n    busy: state.busy,\n    selection: cloneAgentBridgeSelection(safeSelection),\n    object,\n    diagnostics: createAgentBridgeStateDiagnostics(state, operations),\n  };\n}\n\nfunction createAgentBridgeEditorSnapshot<TDocument, TPatch, TAsset>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  input: EditorAgentBridgeEditorSnapshotGetInput,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): EditorAgentBridgeEditorSnapshot {\n  const sessionState = state.session?.getState({ cloneDocuments: false }) ?? null;\n  const document = sessionState?.workingDocument ?? null;\n  const safeSelection = getAgentBridgeSafeSceneSelection(operations);\n  const objects = state.mode === 'editor' && document\n    ? listAgentBridgeSceneObjects(state, options, document, input.includeUnselectable === true, operations)\n    : [];\n  const snapshot: EditorAgentBridgeEditorSnapshot = {\n    mode: state.mode,\n    busy: state.busy,\n    dirty: sessionState?.dirty ?? false,\n    status: state.status,\n    statusTone: state.statusTone,\n    selection: cloneAgentBridgeSelection(safeSelection),\n    objectCount: objects.length,\n  };\n  if (input.includeObjects === true) {\n    snapshot.objects = objects.slice(0, normalizeAgentBridgeSnapshotObjectLimit(input.objectLimit));\n  }\n  return snapshot;\n}\n\nfunction createAgentBridgeStateDiagnostics<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n  operations: LocalEditorAgentBridgeCapabilitySourceOperations<TDocument>,\n): EditorAgentBridgeEditorState['diagnostics'] {\n  return operations.getStatusDiagnostics().map(diagnostic => ({\n    severity: diagnostic.severity,\n    source: diagnostic.source,\n    code: diagnostic.code,\n    message: diagnostic.message,\n    ...(diagnostic.rowId ? { objectId: diagnostic.rowId } : {}),\n    details: {\n      ...(diagnostic.scopeId ? { scopeId: diagnostic.scopeId } : {}),\n      ...(diagnostic.targetId ? { targetId: diagnostic.targetId } : {}),\n      ...(diagnostic.documentRevision != null ? { documentRevision: diagnostic.documentRevision } : {}),\n      ...(diagnostic.projectionRevision != null ? { projectionRevision: diagnostic.projectionRevision } : {}),\n      ...(diagnostic.details ?? {}),\n    },\n  }));\n}\n\nfunction normalizeAgentBridgeSnapshotObjectLimit(value: unknown): number {\n  if (value === undefined) return AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT;\n  if (typeof value !== 'number' || !Number.isFinite(value)) return AGENT_BRIDGE_SNAPSHOT_DEFAULT_OBJECT_LIMIT;\n  return Math.max(0, Math.min(AGENT_BRIDGE_SNAPSHOT_MAX_OBJECT_LIMIT, Math.floor(value)));\n}\n"]}

package/dist/agent-bridge/capabilities/prefabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prefabs.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/prefabs.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAEL,KAAK,gDAAgD,EAErD,KAAK,kCAAkC,EACxC,MAAM,cAAc,CAAC;AAgBtB,wBAAgB,wCAAwC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAChF,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5D,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,QAAQ,EAAE,MAAM,IAAI,EACpB,UAAU,EAAE,gDAAgD,CAAC,SAAS,CAAC,GACtE,kCAAkC,CAiWpC"}
+{"version":3,"file":"prefabs.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/prefabs.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAEL,KAAK,gDAAgD,EAErD,KAAK,kCAAkC,EACxC,MAAM,cAAc,CAAC;AAgBtB,wBAAgB,wCAAwC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAChF,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5D,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,QAAQ,EAAE,MAAM,IAAI,EACpB,UAAU,EAAE,gDAAgD,CAAC,SAAS,CAAC,GACtE,kCAAkC,CAmYpC"}

package/dist/agent-bridge/capabilities/prefabs.js

@@ -104,7 +104,7 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (!details || !isRequestedPrefabStage(details.stage, input.assetId)) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_SCENE_GET, createPrefabStageUnavailableMessage(input.assetId), { code: 'prefab.stageNotOpen', details: { assetId: input.assetId } });
             }
-            return createPrefabSceneOutput(details);
+            return createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_SCENE_GET, details, operations);
         },
         selectNode(input) {
             const nodeId = normalizePrefabNodeId(input.nodeId);
@@ -112,7 +112,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (!details || !nodeId) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SELECT, nodeId ? 'Prefab stage is not open.' : 'Prefab node id is required.', { code: nodeId ? 'prefab.stageNotOpen' : 'prefab.invalidInput', details: { nodeId: input.nodeId } });
             }
-            const scene = createPrefabSceneOutput(details);
+            const scene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SELECT, details, operations);
+            if ('ok' in scene)
+                return scene;
             const node = scene.nodes.find(candidate => candidate.nodeId === nodeId) ?? null;
             if (!node) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SELECT, `Prefab node not found: ${nodeId}`, { code: 'prefab.nodeNotFound', details: { assetId: details.stage.assetId, nodeId } });
@@ -121,7 +123,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (changed)
                 renderUi();
             const nextDetails = operations.getPrefabStageDetails() ?? details;
-            const nextScene = createPrefabSceneOutput(nextDetails);
+            const nextScene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SELECT, nextDetails, operations);
+            if ('ok' in nextScene)
+                return nextScene;
             const selectedNode = nextScene.nodes.find(candidate => candidate.nodeId === nodeId) ?? node;
             return {
                 stage: nextScene.stage,
@@ -138,7 +142,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
                     ? 'Prefab stage is not open.'
                     : `Asset not found: ${assetId || '(empty)'}`, { code: !details ? 'prefab.stageNotOpen' : 'asset.notFound', details: { assetId } });
             }
-            const beforeScene = createPrefabSceneOutput(details);
+            const beforeScene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_CREATE_FROM_ASSET, details, operations);
+            if ('ok' in beforeScene)
+                return beforeScene;
             const parentNodeId = resolvePrefabMutationParentNodeId(input.parentNodeId, beforeScene);
             const action = {
                 actionId: 'asset.add-to-current-prefab',
@@ -163,7 +169,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (!details) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_CREATE_GROUP, 'Prefab stage is not open.', { code: 'prefab.stageNotOpen' });
             }
-            const beforeScene = createPrefabSceneOutput(details);
+            const beforeScene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_CREATE_GROUP, details, operations);
+            if ('ok' in beforeScene)
+                return beforeScene;
             const parentNodeId = resolvePrefabMutationParentNodeId(input.parentNodeId, beforeScene);
             const action = {
                 actionId: 'prefab.node.createGroup',
@@ -186,7 +194,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (!details) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_CREATE_PRIMITIVE, 'Prefab stage is not open.', { code: 'prefab.stageNotOpen' });
             }
-            const beforeScene = createPrefabSceneOutput(details);
+            const beforeScene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_CREATE_PRIMITIVE, details, operations);
+            if ('ok' in beforeScene)
+                return beforeScene;
             const parentNodeId = resolvePrefabMutationParentNodeId(input.parentNodeId, beforeScene);
             const action = {
                 actionId: 'prefab.node.createPrimitive',
@@ -211,7 +221,9 @@ export function createLocalEditorAgentBridgePrefabSource(state, options, renderU
             if (!details || !nodeId) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SET_TRANSFORM, nodeId ? 'Prefab stage is not open.' : 'Prefab node id is required.', { code: nodeId ? 'prefab.stageNotOpen' : 'prefab.invalidInput', details: { nodeId: input.nodeId } });
             }
-            const beforeScene = createPrefabSceneOutput(details);
+            const beforeScene = createSafePrefabSceneOutput(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SET_TRANSFORM, details, operations);
+            if ('ok' in beforeScene)
+                return beforeScene;
             const node = beforeScene.nodes.find(candidate => candidate.nodeId === nodeId) ?? null;
             if (!node) {
                 return createLocalEditorAgentBridgeFailure(EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_NODE_SET_TRANSFORM, `Prefab node not found: ${nodeId}`, { code: 'prefab.nodeNotFound', details: { assetId: details.stage.assetId, nodeId } });
@@ -381,12 +393,42 @@ function isRequestedPrefabStage(stage, assetId) {
     const normalized = normalizeAgentBridgeString(assetId);
     return !normalized || stage.assetId === normalized || stage.browserAssetId === normalized;
 }
-function createPrefabSceneOutput(details) {
-    const nodes = listPrefabSceneNodes(details.structureItems);
+function createSafePrefabSceneOutput(capabilityId, details, operations) {
+    const projection = operations.getHierarchyProjection();
+    const expectedScopeId = `prefab-stage:${details.stage.assetId}`;
+    if (!projection
+        || projection.scopeKind !== 'prefab-stage'
+        || projection.scopeId !== expectedScopeId) {
+        return createLocalEditorAgentBridgeFailure(capabilityId, 'Prefab Hierarchy projection is unavailable or does not match the active Prefab Stage.', {
+            code: 'prefab.hierarchyProjectionUnavailable',
+            details: {
+                assetId: details.stage.assetId,
+                expectedScopeId,
+                actualScopeId: projection?.scopeId,
+                actualScopeKind: projection?.scopeKind,
+            },
+        });
+    }
+    const safeNodeIds = new Set(projection.targets.map(target => target.targetId));
+    for (const node of projection.nodes) {
+        if (node.sourceKind !== 'root')
+            continue;
+        const rootNodeId = normalizePrefabNodeId(node.id);
+        if (rootNodeId)
+            safeNodeIds.add(rootNodeId);
+    }
+    return createPrefabSceneOutput(details, safeNodeIds);
+}
+function createPrefabSceneOutput(details, safeNodeIds) {
+    const nodes = listPrefabSceneNodes(details.structureItems)
+        .filter(node => safeNodeIds.has(node.nodeId));
     const rootNodeId = nodes.find(node => node.kind === 'root')?.nodeId
         ?? nodes.find(node => !node.parentNodeId)?.nodeId
         ?? PREFAB_ROOT_NODE_ID;
-    const selectedNodeId = getSelectedPrefabNodeId(details.stage.selectedItemId);
+    const rawSelectedNodeId = getSelectedPrefabNodeId(details.stage.selectedItemId);
+    const selectedNodeId = rawSelectedNodeId && safeNodeIds.has(rawSelectedNodeId)
+        ? rawSelectedNodeId
+        : null;
     return {
         stage: details.stage,
         rootNodeId,
@@ -531,7 +573,9 @@ function runNodeIdMutation(input) {
             details: { nodeId: input.nodeId, parentNodeId: input.parentNodeId },
         });
     }
-    const beforeScene = createPrefabSceneOutput(details);
+    const beforeScene = createSafePrefabSceneOutput(input.capabilityId, details, input.operations);
+    if ('ok' in beforeScene)
+        return beforeScene;
     const node = beforeScene.nodes.find(candidate => candidate.nodeId === nodeId) ?? null;
     if (!node) {
         return createLocalEditorAgentBridgeFailure(input.capabilityId, `Prefab node not found: ${nodeId}`, { code: 'prefab.nodeNotFound', details: { assetId: details.stage.assetId, nodeId } });
@@ -618,7 +662,9 @@ function runPrefabNodeMutation(input) {
     if (!afterDetails) {
         return createLocalEditorAgentBridgeFailure(input.capabilityId, 'Prefab mutation completed, but Prefab stage is no longer open.', { code: 'prefab.stageClosed' });
     }
-    const afterScene = createPrefabSceneOutput(afterDetails);
+    const afterScene = createSafePrefabSceneOutput(input.capabilityId, afterDetails, input.operations);
+    if ('ok' in afterScene)
+        return afterScene;
     const beforeNodeIds = new Set(input.beforeScene.nodes.map(node => node.nodeId));
     const afterNodeIds = new Set(afterScene.nodes.map(node => node.nodeId));
     const createdNodeId = afterScene.nodes.find(node => !beforeNodeIds.has(node.nodeId))?.nodeId;
@@ -654,7 +700,9 @@ function resolvePrefabAssetForInspection(capabilityId, state, options, operation
             result: createLocalEditorAgentBridgeFailure(capabilityId, 'Prefab stage is not open.', { code: 'prefab.stageNotOpen' }),
         };
     }
-    const scene = createPrefabSceneOutput(details);
+    const scene = createSafePrefabSceneOutput(capabilityId, details, operations);
+    if ('ok' in scene)
+        return { ok: false, result: scene };
     const nodeId = normalizePrefabNodeId(input.nodeId) || scene.selectedNodeId || '';
     const node = nodeId ? scene.nodes.find(candidate => candidate.nodeId === nodeId) ?? null : null;
     const assetId = normalizeAgentBridgeString(input.assetId)