mcp + core: author_scene converts a whole three.js design into native, editable nodes

packages/core/src/agent-operations/add-object.ts

@@ -23,6 +23,7 @@ import {
   generateId,
   ItemNode,
   type SlabNode,
+  type WallFace,
 } from '../schema'
 import { achievedChanges } from './achieved'
 import { targetLevel } from './level-target'
@@ -616,11 +617,62 @@ export function scriptedFieldRefusal(node: AnyNode, data: Record<string, unknown
   return `${node.id} is built from a script, so ${fields.join(', ')} ${fields.length === 1 ? 'comes' : 'come'} from it: rebuild it with ${tool} with nodeId and params (get_source shows them); nothing was changed.`
 }
 
+/** What `get_source` reads: a scripted node, a room's floor script, or a wall face's script. */
+export type ScriptReadable = Pick<ScriptedNode, 'name' | 'source'> & {
+  id: string
+  type: ScriptedNode['type'] | 'zone' | 'wall'
+  /** The wall face whose script it is. */
+  face?: WallFace
+}
+
+/**
+ * The script `get_source` reads at `nodeId`: an authored object's, a room's floor script by its
+ * zone id, or a wall's face script (`face`, which a wall with one scripted face may leave out).
+ */
+export function readableScript(
+  nodes: Record<string, AnyNode>,
+  nodeId: string,
+  face?: WallFace,
+): ScriptReadable {
+  const node = nodes[nodeId]
+  if (node?.type === 'wall') {
+    const faces = (['a', 'b'] as const).filter((side) => node.finishScripts?.[side])
+    const read = face ?? (faces.length === 1 ? faces[0] : undefined)
+    if (!faces.length)
+      refuse('not_authored', `${node.name || nodeId} has no face script.`, { id: nodeId })
+    if (!read)
+      refuse(
+        'face_required',
+        `Both faces of ${node.name || nodeId} have a script: name the face, a or b.`,
+        {
+          id: nodeId,
+          faces,
+        },
+      )
+    const source = node.finishScripts?.[read]
+    if (!source)
+      refuse(
+        'not_authored',
+        `Face ${read} of ${node.name || nodeId} has no script; face ${faces[0]} has.`,
+        {
+          id: nodeId,
+          faces,
+        },
+      )
+    return { id: node.id, type: 'wall', name: node.name, source, face: read }
+  }
+  if (node?.type !== 'zone') return authoredObject(nodes, nodeId)
+  if (!node.floor?.script)
+    refuse('not_authored', `${node.name || nodeId} has no floor script.`, { id: nodeId })
+  return { id: node.id, type: 'zone', name: node.name, source: node.floor.script }
+}
+
 /** What `get_source` answers once the host has the module's text. */
-export function readSourceResult(node: ScriptedNode, code: string) {
+export function readSourceResult(node: ScriptReadable, code: string) {
   return {
     nodeId: node.id,
     type: node.type,
+    ...(node.face ? { face: node.face } : {}),
     name: node.name,
     language: node.source.language,
     code,