{ "protocol": "ashfox.agent-command-port", "workbench": "/workbench/", "href": "/workbench/agent-manifest.json", "description": "Complete machine-readable operating guide for the ashfox AI-native low-poly workbench.", "setup": { "manifest": "Fetch this JSON with the direct HTTP request tool available in the agent environment, such as curl. Never navigate the controlled browser to the manifest.", "browser": "Open the workbench in an in-app browser. If unavailable, use a browser the agent can connect to and control. Reserve the browser for the workbench UI and page API.", "authority": "This manifest is the complete ashfox operating guide. Do not infer a second workflow from visible UI.", "ready": "After the page API is connected and the current project is inspected, ask exactly: \"What would you like to create?\" Do not mutate the project before the user answers." }, "pageApi": { "global": "ashfox", "inspectMethod": "inspect", "runMethod": "run", "presentMethod": "present", "inspect": { "current": "window.ashfox.inspect() returns the current revision, project identity, selection, typed scene and animation counts, complete command-name list, and first blocking finding.", "command": "window.ashfox.inspect({kind:\"command\",name:\"\"}) returns one canonical input schema.", "entities": "Use kind entity, texture, or clip with ids (maximum 10) to read exact current values.", "validation": "Use kind target for format validity, production readiness, error and warning counts, texture count, and the first readiness finding; use kind finding with a path for one exact finding." }, "run": { "call": "await window.ashfox.run({batchId:\"\",baseRevision:\"\",operations:[{name:\"\",payload:{}}]})", "atomicity": "Each batch contains 1-64 registered operations and commits atomically through the canonical reducer.", "idempotency": "Repeating the same batchId with identical content returns its completed result. Reusing it for different content is rejected.", "concurrency": "Only one batch runs at a time. Every success, rejection, timeout, cancellation, or exception returns a terminal result and restores connected status." }, "present": { "call": "window.ashfox.present({kind:\"animation\",clipId:\"\",playing:true,timeSeconds:0})", "purpose": "Select and play one existing animation clip in the rendered viewport without mutating the project document or revision.", "review": "Present every authored clip, observe at least one complete loop or playback, then pause it with playing false before final delivery." } }, "completionContract": { "defaultScope": { "model": "Required. Deliver coherent named geometry under a usable bone hierarchy; a project shell or proof cube is not a finished model.", "texture": "Required. Deliver at least one non-placeholder texture with every enabled visible face bound and UV mapped. Final inspect must show untexturedVisibleFaces 0 and texturedVisibleFaces equal enabledVisibleFaces.", "idleAnimation": "Required for every asset. Use animation..idle for Minecraft targets or Idle for glTF/GLB, with at least one transform channel and matching start and end poses. Add a changed intermediate pose only when motion is semantically valid; otherwise use identical hold keys. Final inspect must show idleClips and idleChannels at least 1. Present and review one complete loop.", "readiness": "Required machine gate. Final inspect kind target must report productionReady true, but this does not replace semantic and visual review." }, "highQuality": { "minimumCubeCount": 120, "countSource": "Use window.ashfox.inspect().data.counts.visibleCubes. This threshold is an eligibility floor, never a design target or proof of quality.", "meaningfulGeometry": "Every counted cube must contribute to silhouette, subject structure, articulation, construction, or readable surface detail. Hidden filler, accidental duplicates, and imperceptible splitting do not qualify." }, "subjectFidelity": { "general": "Before editing, derive a concise subject specification from the request and supplied references: defining silhouette, proportions, body or construction plan, articulation, and material regions. Treat it as binding; never substitute a familiar generic body or rig.", "bodyPlan": "Lock the primary body axis and stance, support points, head-to-body ratio, mass distribution, limb or appendage count and attachment, and joint directions before surface detail. Reject an upright human torso, human shoulder or pelvis layout, or human limb proportions unless the requested subject actually has them.", "eyes": "When visible eyes define the subject, use geometry only for form that materially changes the socket, lid, head, or silhouette. Use aligned texture regions for iris, pupil, markings, and restrained highlights. Do not default to protruding, floating, or emissive eye cubes." }, "reviewGates": { "form": "At the coarse stage, reject a body plan or silhouette that does not identify the requested subject before adding detail. Also reject missing defining parts, accidental asymmetry, floating pieces, avoidable interpenetration, and z-fighting. Do not trade recognition or reference fidelity for ornamental density.", "texture": "Reject placeholder color fills, unintended UV stretching or rotation, broken seams, inconsistent texel scale, and identity-defining details that disappear at the expected gameplay distance.", "rig": "Place pivots at plausible joints or mechanical axes. Verify hierarchy motion does not detach, shear, or move unrelated parts.", "idle": "Reject loop-end snapping, unintended root drift, constant-speed robotic motion where easing is expected, and secondary motion that contradicts weight or construction.", "final": "Compare the rendered result with subjectFidelity, then inspect target readiness, coverage counts, texture details, and the idle clip before claiming completion." } }, "authoringModel": { "project": "project.create replaces the active document. Existing projects may be edited with project.rename, project.target.set, and project.textureResolution.set; submit related project edits in one run batch. Project ID and createdAt are immutable after creation. A target change rewrites canonical format metadata and Minecraft resource bindings; changing an animation-free project to GeckoLib 5 provisions a required rest-pose clip, which does not replace the idle requirement in completionContract. Texture resolution accepts 16, 32, 64, 128, or 256 and resizes generate-mode textures atomically; preserve-mode textures keep authored dimensions.", "identity": "Project, scene-node, texture, clip, channel, trigger, and key IDs are unique stable strings. Names are human-readable and may change without changing IDs.", "coordinates": "Scene values use a right-handed Y-up coordinate system. Geometry and pivots use pixel units; rotations use degrees in XYZ order; animation time uses seconds.", "hierarchy": "Bones may parent bones, cubes, or locators. parentId null makes a root. scene.bones.create permits parent IDs declared anywhere in the same payload. Use scene.locators.create for particle and sound attachment points; Minecraft locators must be parented to an existing bone. Use scene.nodes.reparent for hierarchy changes and scene.nodes.delete for atomic cascading removal.", "cubes": "Cube bounds are absolute from/to coordinates and must not be reversed. In scene.cubes.create, omitted textureId reuses or creates a generate-mode base texture; explicit null keeps faces untextured. Use scene.cubes.geometry.update for existing bounds, inflate, mirror, box UV, UV offset, or uniform face UV changes; use scene.nodes.transform for position, rotation, scale, and pivot.", "textures": "Project texture resolution is the default and generated-atlas size; preserve textures retain authored dimensions. Texture omission or UV generation may provision and bind one deterministic generate texture. Finalize geometry, generate and inspect UVs, then author raster details; regenerating the atlas may require repainting UV-specific details. Use textures.create for explicit identity or preserve mode. textures.delete removes only unreferenced textures.", "animation": "Clips own transform channels and event triggers. Channels target stable node IDs and animate position, rotation, or scale with ordered keys. Particle and sound effects may reference locator node IDs. Use animation.tracks.delete with explicit channel or trigger kinds for precise removal without rebuilding the clip. Keep keys within clip duration and close loops explicitly when required.", "targets": { "bedrock": "Minecraft Bedrock geometry and animation JSON with external PNG textures.", "geckolib5": "GeckoLib 5 Java resources with geometry, animation, and external PNG textures.", "gltf": "glTF JSON with an external binary buffer and external PNG textures.", "glb": "One binary GLB with embedded buffers and texture images." } }, "commands": [ { "name": "project.create", "purpose": "Start one empty project with a canonical export target.", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "target": { "enum": [ "gltf", "glb", "bedrock", "geckolib5" ] }, "namespace": { "type": "string", "minLength": 1 }, "modelPath": { "type": "string", "minLength": 1 }, "textureResolution": { "enum": [ 16, 32, 64, 128, 256 ] }, "createdAt": { "type": "string", "minLength": 1 } }, "required": [ "id", "name", "target", "namespace", "modelPath", "textureResolution", "createdAt" ], "additionalProperties": false } }, { "name": "project.rename", "purpose": "Set the canonical project and export display name.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 } }, "required": [ "name" ], "additionalProperties": false } }, { "name": "project.target.set", "purpose": "Select one canonical target preset and its resource location.", "inputSchema": { "type": "object", "properties": { "target": { "enum": [ "gltf", "glb", "bedrock", "geckolib5" ] }, "namespace": { "type": "string", "minLength": 1 }, "modelPath": { "type": "string", "minLength": 1 } }, "required": [ "target", "namespace", "modelPath" ], "additionalProperties": false } }, { "name": "project.textureResolution.set", "purpose": "Set the square project texture canvas and resize generated raster textures atomically.", "inputSchema": { "type": "object", "properties": { "size": { "enum": [ 16, 32, 64, 128, 256 ] } }, "required": [ "size" ], "additionalProperties": false } }, { "name": "scene.bones.create", "purpose": "Create animation-ready bones; parentId may reference any bone in the same payload regardless of declaration order.", "inputSchema": { "type": "object", "properties": { "bones": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "parentId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] }, "transform": { "type": "object", "properties": { "position": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "rotation": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "scale": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "pivot": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "additionalProperties": false } }, "required": [ "id", "name", "parentId" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128 } }, "required": [ "bones" ], "additionalProperties": false } }, { "name": "scene.locators.create", "purpose": "Create attachment points for exported particle and sound events.", "inputSchema": { "type": "object", "properties": { "locators": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "parentId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] }, "transform": { "type": "object", "properties": { "position": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "rotation": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "scale": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "pivot": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "additionalProperties": false }, "ignoreInheritedScale": { "type": "boolean" } }, "required": [ "id", "name", "parentId" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128 } }, "required": [ "locators" ], "additionalProperties": false } }, { "name": "scene.nodes.transform", "purpose": "Set one or more local transform properties on scene nodes.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "transform": { "type": "object", "properties": { "position": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "rotation": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "scale": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "pivot": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "additionalProperties": false } }, "required": [ "nodeIds", "transform" ], "additionalProperties": false } }, { "name": "scene.nodes.visibility", "purpose": "Set viewport and export visibility for one or more scene nodes.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "visible": { "type": "boolean" } }, "required": [ "nodeIds", "visible" ], "additionalProperties": false } }, { "name": "scene.cubes.create", "purpose": "Create cube primitives; omitted textureId reuses a texture or creates one generate-mode base texture, while null stays untextured.", "inputSchema": { "type": "object", "properties": { "cubes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "parentId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] }, "bounds": { "type": "object", "properties": { "from": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "to": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "required": [ "from", "to" ], "additionalProperties": false }, "transform": { "type": "object", "properties": { "position": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "rotation": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "scale": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "pivot": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "additionalProperties": false }, "textureId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] }, "faceUv": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4 }, "inflate": { "type": "number" }, "mirror": { "type": "boolean" }, "boxUv": { "type": "boolean" }, "uvOffset": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 }, "shade": { "type": "boolean" } }, "required": [ "id", "name", "parentId", "bounds" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128 } }, "required": [ "cubes" ], "additionalProperties": false } }, { "name": "scene.cubes.geometry.update", "purpose": "Update existing cube bounds and box or face UV geometry.", "inputSchema": { "type": "object", "properties": { "updates": { "type": "array", "items": { "type": "object", "properties": { "nodeId": { "type": "string", "minLength": 1 }, "bounds": { "type": "object", "properties": { "from": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "to": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "required": [ "from", "to" ], "additionalProperties": false }, "inflate": { "type": "number" }, "mirror": { "type": "boolean" }, "boxUv": { "type": "boolean" }, "uvOffset": { "anyOf": [ { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 }, { "enum": [ null ] } ] }, "faceUv": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4 } }, "required": [ "nodeId" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128 } }, "required": [ "updates" ], "additionalProperties": false } }, { "name": "scene.nodes.rename", "purpose": "Rename one or more existing scene nodes by ID.", "inputSchema": { "type": "object", "properties": { "renames": { "type": "array", "items": { "type": "object", "properties": { "nodeId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 } }, "required": [ "nodeId", "name" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128 } }, "required": [ "renames" ], "additionalProperties": false } }, { "name": "scene.nodes.delete", "purpose": "Delete scene nodes, their descendants, and dependent animation references.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true } }, "required": [ "nodeIds" ], "additionalProperties": false } }, { "name": "scene.cubes.duplicate", "purpose": "Create stable-ID copies of existing cubes with optional offsets.", "inputSchema": { "type": "object", "properties": { "copies": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1 }, "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "offset": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "required": [ "sourceId", "id" ], "additionalProperties": false } } }, "required": [ "copies" ], "additionalProperties": false } }, { "name": "scene.cubes.mirror", "purpose": "Mirror cube geometry and transforms across a model axis.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "axis": { "enum": [ "x", "y", "z" ] } }, "required": [ "nodeIds", "axis" ], "additionalProperties": false } }, { "name": "scene.cubes.repeat", "purpose": "Create a deterministic linear series from one or more cubes.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "count": { "type": "number", "minimum": 1, "maximum": 64 }, "step": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "idPrefix": { "type": "string", "minLength": 1 } }, "required": [ "nodeIds", "count", "step", "idPrefix" ], "additionalProperties": false } }, { "name": "scene.nodes.align", "purpose": "Align node positions to a shared minimum, center, or maximum.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "axis": { "enum": [ "x", "y", "z" ] }, "mode": { "enum": [ "minimum", "center", "maximum" ] } }, "required": [ "nodeIds", "axis", "mode" ], "additionalProperties": false } }, { "name": "scene.nodes.pivot", "purpose": "Set a shared model-space pivot on one or more scene nodes.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "pivot": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "required": [ "nodeIds", "pivot" ], "additionalProperties": false } }, { "name": "scene.nodes.reparent", "purpose": "Move scene nodes under one bone or to the scene root.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "parentId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] } }, "required": [ "nodeIds", "parentId" ], "additionalProperties": false } }, { "name": "scene.cubes.uv.fit", "purpose": "Fit enabled cube faces inside the project texture bounds.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "padding": { "type": "number", "minimum": 0 } }, "required": [ "nodeIds", "padding" ], "additionalProperties": false } }, { "name": "scene.cubes.material", "purpose": "Assign one texture and deterministic shading settings to cube faces.", "inputSchema": { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "textureId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "enum": [ null ] } ] }, "shade": { "type": "boolean" }, "lightEmission": { "type": "number", "minimum": 0, "maximum": 15 } }, "required": [ "nodeIds", "textureId" ], "additionalProperties": false } }, { "name": "textures.create", "purpose": "Create one or more deterministic raster textures; omitted dimensions use the project texture resolution.", "inputSchema": { "type": "object", "properties": { "textures": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "width": { "type": "number", "minimum": 1, "maximum": 8192 }, "height": { "type": "number", "minimum": 1, "maximum": 8192 }, "atlasMode": { "enum": [ "generate", "preserve" ] }, "background": { "type": "string", "minLength": 4 } }, "required": [ "id", "name" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 } }, "required": [ "textures" ], "additionalProperties": false } }, { "name": "textures.preview.set", "purpose": "Set the deterministic viewport color for a texture asset.", "inputSchema": { "type": "object", "properties": { "textureId": { "type": "string", "minLength": 1 }, "color": { "type": "string", "minLength": 4 } }, "required": [ "textureId", "color" ], "additionalProperties": false } }, { "name": "textures.rename", "purpose": "Set the stable display name of one texture asset.", "inputSchema": { "type": "object", "properties": { "textureId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 } }, "required": [ "textureId", "name" ], "additionalProperties": false } }, { "name": "textures.raster.set", "purpose": "Build a deterministic pixel texture from colored rectangles.", "inputSchema": { "type": "object", "properties": { "textureId": { "type": "string", "minLength": 1 }, "background": { "type": "string", "minLength": 4 }, "atlasMode": { "enum": [ "generate", "preserve" ] }, "rectangles": { "type": "array", "items": { "type": "object", "properties": { "x": { "type": "number", "minimum": 0 }, "y": { "type": "number", "minimum": 0 }, "width": { "type": "number", "minimum": 1 }, "height": { "type": "number", "minimum": 1 }, "color": { "type": "string", "minLength": 4 } }, "required": [ "x", "y", "width", "height", "color" ], "additionalProperties": false }, "maxItems": 256 } }, "required": [ "textureId", "background", "rectangles" ], "additionalProperties": false } }, { "name": "textures.delete", "purpose": "Delete unreferenced textures without silently changing scene materials.", "inputSchema": { "type": "object", "properties": { "textureIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true } }, "required": [ "textureIds" ], "additionalProperties": false } }, { "name": "textures.uvAtlas.generate", "purpose": "Pack cube faces at one texel density and shade each UV island deterministically.", "inputSchema": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "object", "properties": { "scope": { "enum": [ "all" ] } }, "required": [ "scope" ], "additionalProperties": false }, { "type": "object", "properties": { "nodeIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true } }, "required": [ "nodeIds" ], "additionalProperties": false } ] }, "pixelsPerBlock": { "type": "number", "minimum": 1, "maximum": 256 }, "padding": { "type": "number", "minimum": 0, "maximum": 32 }, "maxResolution": { "type": "number", "minimum": 16, "maximum": 4096 }, "seed": { "type": "number" }, "intensity": { "type": "number", "minimum": 0, "maximum": 1 }, "edge": { "type": "number", "minimum": 0, "maximum": 1 }, "noise": { "type": "number", "minimum": 0, "maximum": 1 }, "lightDir": { "enum": [ "tl_br", "tr_bl", "top_bottom", "left_right" ] } }, "required": [ "target", "pixelsPerBlock", "padding", "maxResolution", "seed", "intensity", "edge", "noise", "lightDir" ], "additionalProperties": false } }, { "name": "animation.clip.upsert", "purpose": "Create an animation clip or update its timing and loop settings.", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "durationSeconds": { "type": "number", "minimum": 0.001 }, "fps": { "type": "number", "minimum": 1, "maximum": 240 }, "loop": { "enum": [ "once", "loop", "hold_on_last_frame" ] } }, "required": [ "id", "name", "durationSeconds", "fps", "loop" ], "additionalProperties": false } }, { "name": "animation.channels.upsert", "purpose": "Create or replace transform channels with ordered keyframes.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "channels": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "targetNodeId": { "type": "string", "minLength": 1 }, "property": { "enum": [ "position", "rotation", "scale" ] }, "keys": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "timeSeconds": { "type": "number", "minimum": 0 }, "value": { "type": "array", "items": { "anyOf": [ { "type": "number" }, { "type": "object", "properties": { "kind": { "enum": [ "molang" ] }, "source": { "type": "string", "minLength": 1 } }, "required": [ "kind", "source" ], "additionalProperties": false } ] }, "minItems": 3, "maxItems": 3 }, "interpolation": { "enum": [ "linear", "step", "catmullrom" ] } }, "required": [ "id", "timeSeconds", "value" ], "additionalProperties": false } } }, "required": [ "id", "targetNodeId", "property", "keys" ], "additionalProperties": false } } }, "required": [ "clipId", "channels" ], "additionalProperties": false } }, { "name": "animation.triggers.upsert", "purpose": "Create or replace sound, particle, and timeline event tracks.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "enum": [ "sound", "particle" ] }, "keys": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "timeSeconds": { "type": "number", "minimum": 0 }, "value": { "type": "object", "properties": { "effect": { "type": "string", "minLength": 1 }, "locatorId": { "type": "string", "minLength": 1 }, "preEffectScript": { "type": "object", "properties": { "kind": { "enum": [ "molang" ] }, "source": { "type": "string", "minLength": 1 } }, "required": [ "kind", "source" ], "additionalProperties": false }, "bindToActor": { "type": "boolean" } }, "required": [ "effect" ], "additionalProperties": false } }, "required": [ "id", "timeSeconds", "value" ], "additionalProperties": false } } }, "required": [ "id", "type", "keys" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "enum": [ "timeline" ] }, "keys": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "timeSeconds": { "type": "number", "minimum": 0 }, "value": { "type": "string", "minLength": 1 } }, "required": [ "id", "timeSeconds", "value" ], "additionalProperties": false } } }, "required": [ "id", "type", "keys" ], "additionalProperties": false } ] } } }, "required": [ "clipId", "triggers" ], "additionalProperties": false } }, { "name": "animation.tracks.delete", "purpose": "Delete selected transform channels or event tracks without rebuilding the clip.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "tracks": { "type": "array", "items": { "type": "object", "properties": { "kind": { "enum": [ "channel", "trigger" ] }, "id": { "type": "string", "minLength": 1 } }, "required": [ "kind", "id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 128, "uniqueItems": true } }, "required": [ "clipId", "tracks" ], "additionalProperties": false } }, { "name": "animation.channels.phase", "purpose": "Shift channel timing with optional clip-duration wrapping.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "offsetSeconds": { "type": "number" }, "wrap": { "type": "boolean" } }, "required": [ "clipId", "channelIds", "offsetSeconds", "wrap" ], "additionalProperties": false } }, { "name": "animation.channels.mirror", "purpose": "Mirror numeric position and rotation key values across one axis.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true }, "axis": { "enum": [ "x", "y", "z" ] } }, "required": [ "clipId", "channelIds", "axis" ], "additionalProperties": false } }, { "name": "animation.clip.closeLoop", "purpose": "Match selected channel end values to their start values.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 128, "uniqueItems": true } }, "required": [ "clipId", "channelIds" ], "additionalProperties": false } }, { "name": "animation.clip.delete", "purpose": "Delete one animation clip and its channels and triggers.", "inputSchema": { "type": "object", "properties": { "clipId": { "type": "string", "minLength": 1 } }, "required": [ "clipId" ], "additionalProperties": false } } ], "domBridge": { "purpose": "Fallback transport only when window.ashfox is unavailable. It validates and forwards the same inspect, run, or present request and owns no mutation logic.", "input": { "selector": "[data-agent-command-port-input]", "attribute": "data-agent-command-port-input", "event": "input" }, "result": { "selector": "meta[data-agent-command-port-result]", "attribute": "data-agent-command-port-result" }, "encoding": "json", "request": { "requestId": "unique string", "method": "inspect, run, or present", "payload": "method input" }, "response": { "requestId": "matching request ID", "result": "InspectResult, RunResult, or PresentResult" } }, "domActions": { "openProject": "[data-ashfox-action=\"project.open\"]", "openProjectInput": "[data-ashfox-action=\"project.open.input\"]", "saveProject": "[data-ashfox-action=\"project.save\"]", "openExport": "[data-ashfox-action=\"project.export.open\"]", "submitExport": "[data-ashfox-action=\"project.export.submit\"]", "openCapture": "[data-ashfox-action=\"project.capture.open\"]", "startCapture": "[data-ashfox-action=\"project.capture.start\"]", "cancelCapture": "[data-ashfox-action=\"project.capture.cancel\"]", "downloadArtifact": "[data-ashfox-action=\"artifact.download\"]" }, "domFields": { "format": "[role=\"radiogroup\"][aria-label=\"Format\"]", "namespace": "[aria-label=\"Project namespace\"]", "modelPath": "[aria-label=\"Project model path\"]" }, "domState": { "root": "[data-agent-command-port]", "statusAttribute": "data-agent-command-port", "revisionAttribute": "data-ashfox-revision", "artifact": { "action": "downloadArtifact", "nameAttribute": "data-ashfox-artifact-name", "contentTypeAttribute": "data-ashfox-artifact-content-type", "byteLengthAttribute": "data-ashfox-artifact-byte-length" }, "fileOperation": { "phaseAttribute": "data-ashfox-file-operation", "kindAttribute": "data-ashfox-file-kind", "operationIdAttribute": "data-ashfox-file-operation-id", "messageSelector": "[data-ashfox-file-message]", "terminalPhases": [ "idle", "succeeded", "cancelled", "failed" ] } }, "exportContract": { "precondition": "Before export, satisfy every completionContract.defaultScope item and the requested quality tier. Then inspect kind target and require productionReady true. valid or productionReady alone does not prove visual completion.", "select": "Use project.target.set through run before opening export. Public targets are geckolib5, bedrock, glb, and gltf.", "submit": "Activate openExport, set the exact format, namespace, and modelPath fields, then activate submitExport once. Wait for a terminal file-operation phase with the same operation ID.", "outputs": { "geckolib5": "Completed-asset ZIP containing geometry JSON, animation JSON with the reviewed idle, and every referenced PNG texture under canonical GeckoLib and texture paths.", "bedrock": "Completed-asset ZIP containing geometry JSON, animation JSON with the reviewed idle, and every referenced PNG texture.", "gltf": "Completed-asset ZIP containing one .gltf entrypoint with the reviewed idle, one external .bin buffer, and every referenced PNG texture.", "glb": "One completed-asset .glb containing the reviewed idle, model buffer, and all referenced texture images." }, "verify": "Require succeeded status, a non-empty artifact name, positive byte length, and the expected content type: model/gltf-binary for GLB or application/zip for the other public targets. Then activate downloadArtifact exactly once and verify the host-side file exists." }, "workflow": [ { "stage": "start", "instruction": "Call inspect. To start fresh, run project.create with a new project ID; do not operate the New Project UI. To open a user file, activate openProject and let the user choose it. A cancelled picker starts no operation." }, { "stage": "prove", "instruction": "Before bulk authoring, prove the pipeline with the first real model part: create its root and geometry, provision texture, generate UVs, and inspect. This checkpoint proves command and texture flow only; it is not completion or quality proof." }, { "stage": "author", "instruction": "Follow completionContract coarse-to-fine in checkpoint batches: locked body-plan silhouette and hierarchy, meaningful geometry and articulation, UV layout, raster texture details, then idle. Use command schemas in this manifest, inspect after each checkpoint, and correct subject fidelity before adding detail." }, { "stage": "review", "instruction": "Apply every completionContract.reviewGates and defaultScope item. For high quality, use its single countSource and reject filler geometry. Inspect target readiness; review the viewport, Activity receipt, and Undo. Present every clip through a complete motion, then pause it." }, { "stage": "produce", "instruction": "Set the final target with project.target.set, inspect it, apply completionContract review, then use saveProject and follow exportContract for export. For GIF use openCapture and startCapture. Wait for a terminal file phase with the same operation ID." }, { "stage": "deliver", "instruction": "Activate downloadArtifact only after a succeeded file operation, then transfer and verify the downloaded file according to delivery." } ], "recovery": { "staleRevision": "Inspect again and retry once with a new batchId and the returned revision.", "invalidPayload": "Use the command inputSchema in this manifest, correct the rejected path, and submit a new batchId.", "duplicateExecution": "Reuse a batchId only for an identical retry; otherwise generate a new unique ID.", "busy": "Wait for the current run to return a terminal result before submitting another batch.", "cancellationOrException": "Treat the returned failure as terminal. Inspect status and revision before deciding whether to retry." }, "delivery": { "requestedPath": "workspace-relative directory", "defaultDirectory": "artifacts/", "owner": "agent host", "steps": [ "Reject paths outside the active workspace.", "Activate the persistent artifact anchor, then transfer the download directly into the requested directory; never rely on auto-download and never copy its bytes through model context.", "Verify the file exists, then report only its actual workspace-relative path and format." ], "fallback": "If the host cannot download, write, or verify the file, report the last completed boundary exactly; never claim a workspace save." }, "rules": [ "Inspect before authoring and use the returned current revision.", "Omitted cube textureId enables the implicit base texture; explicit null is the only request for an untextured cube.", "Every delivery must satisfy completionContract; productionReady alone never proves visual or semantic completion.", "Set authored or emissive pixel art to atlasMode preserve. Only explicit generate modes enter UV generation.", "Commit each proven authoring phase atomically; never submit an entire unproven high-detail asset as one batch.", "All project mutations use run and the canonical reducer; the bridge contains no mutation logic.", "Use DOM actions only for listed file boundaries; accept completion only at a terminal phase with the same operation ID." ] }