Input schema (JSON)
{
"type": "object",
"$defs": {
"Vector3": {
"type": "array",
"maxItems": 3,
"minItems": 3,
"prefixItems": [
{
"type": "number"
},
{
"type": "number"
},
{
"type": "number"
}
]
},
"FlowRegion": {
"type": "object",
"properties": {
"kind": {
"enum": [
"external",
"internal",
"solid"
],
"type": "string",
"default": "external",
"description": "external: fluid outside bodies; internal: selected fluid volume; solid: material inside a selected closed component, with no fluid region."
},
"maximum_mm": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"minimum_mm": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"component_id": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
],
"description": "Existing native profile component ID for internal fluid or solid-only meshing; never infer an ID from a display name."
},
"boundary_names": {
"type": "object",
"propertyNames": {
"enum": [
"x_min",
"x_max",
"y_min",
"y_max",
"z_min",
"z_max"
]
},
"additionalProperties": {
"type": "string"
}
}
},
"additionalProperties": false
},
"OctreeFlow": {
"type": "object",
"properties": {
"up": {
"enum": [
"+x",
"-x",
"+y",
"-y",
"+z",
"-z"
],
"type": "string",
"default": "+y",
"description": "Up axis, different from the direction's axis."
},
"speed": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Free-stream speed in m/s; sizes the first layer from boundary_layer.y_plus."
},
"ground": {
"anyOf": [
{
"enum": [
"none",
"body_min"
],
"type": "string"
},
{
"type": "number"
}
],
"default": "none",
"description": "\"none\": free stream all round; \"body_min\": a moving-wall ground touching the lowest point of the body (vehicles); a number: the ground at that up-coordinate in metres."
},
"farfield": {
"enum": [
"inlet_outlet",
"freestream"
],
"type": "string",
"default": "inlet_outlet",
"description": "inlet_outlet: velocity inlet upstream, pressure outlet downstream, symmetry elsewhere. freestream: every outer face a far-field patch (free flight at any angle); a ground stays a moving wall."
},
"sideslip": {
"type": "number",
"default": 0,
"maximum": 45,
"minimum": -45,
"description": "Degrees, turning the stream towards the side axis."
},
"direction": {
"enum": [
"+x",
"-x",
"+y",
"-y",
"+z",
"-z"
],
"type": "string",
"default": "+x",
"description": "Free-stream direction."
},
"contact_plinth": {
"type": "boolean",
"default": false,
"description": "Tyres resting on the ground: cut them just above it and extrude a vertical plinth instead of the tangential wedge."
},
"angle_of_attack": {
"type": "number",
"default": 0,
"maximum": 45,
"minimum": -45,
"description": "Degrees, turning the stream from direction towards up. The domain stays aligned with the body axes; the wake follows the stream."
},
"kinematic_viscosity": {
"type": "number",
"default": 0.000015,
"description": "m^2/s, for y_plus sizing; air by default.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"OctreeWake": {
"type": "object",
"properties": {
"size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Near-wake cell size in metres; default twice the surface size. Leave out so the wake is sized for target_cells."
},
"parts": {
"type": "array",
"items": {
"$ref": "#/$defs/OctreePartWake"
},
"maxItems": 32,
"description": "Wakes behind named parts."
},
"length": {
"type": "number",
"default": 2,
"description": "Downstream extent in body lengths, along the stream.",
"exclusiveMinimum": 0
},
"levels": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1,
"description": "Nested levels, each twice as long with twice the cell size (2: a near and a far wake)."
},
"spread": {
"type": "number",
"default": 0,
"maximum": 1,
"minimum": 0,
"description": "Widening: each side moves out by spread per unit length (0.1: +10% of the length on every side at the end)."
},
"enabled": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"NamedSurface": {
"type": "object",
"required": [
"name",
"surface_artifact_id"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_][A-Za-z0-9_.-]{0,62}$",
"description": "The part's name in controls and the mesh's wall patch name."
},
"surface_artifact_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 1
}
},
"description": "A part of the wall, uploaded as its own STL in the surface's units, for per-part sizes, layers, wakes and patches.",
"additionalProperties": false
},
"OctreeDomain": {
"type": "object",
"properties": {
"top": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"side": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"bottom": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Below the body when there is no ground; default as top."
},
"maximum": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"upstream": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"downstream": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
}
},
"description": "Distances from the body in body lengths (unset ones as \"standard\"), or absolute corners in metres.",
"additionalProperties": false
},
"OctreeRegion": {
"type": "object",
"required": [
"size"
],
"properties": {
"end": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 96
},
{
"type": "null"
}
]
},
"size": {
"type": "number",
"description": "Largest cell inside, in metres.",
"exclusiveMinimum": 0
},
"shape": {
"enum": [
"box",
"cylinder",
"sphere",
"around"
],
"type": "string",
"default": "box"
},
"start": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"center": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"radius": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"x_axis": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"y_axis": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"lengths": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
],
"description": "Full box lengths along x_axis, y_axis and their cross product."
},
"maximum": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"distance": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "An around region's reach from its surfaces, in metres."
},
"surfaces": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.*?\\[\\]-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 64
},
{
"type": "null"
}
],
"description": "Named surfaces for an around region."
},
"inner_radius": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "An annulus round a hub, or a spherical shell."
}
},
"description": "Cells inside are no larger than size: a box (minimum and maximum, or center and lengths,\nrotated by x_axis and y_axis), a cylinder (start, end, radius), a sphere (center, radius),\nor around named surfaces (surfaces, distance).",
"additionalProperties": false
},
"OctreeVolume": {
"type": "object",
"properties": {
"wake": {
"$ref": "#/$defs/OctreeWake"
},
"domain": {
"anyOf": [
{
"enum": [
"compact",
"standard",
"large"
],
"type": "string"
},
{
"$ref": "#/$defs/OctreeDomain"
}
],
"default": "standard",
"description": "Wind-tunnel size around the body (compact 3/6/2/2, standard 5/10/4/4, large 8/16/6/6 body lengths upstream/downstream/side/top), or an explicit domain."
},
"growth": {
"enum": [
"slow",
"medium",
"fast"
],
"type": "string",
"default": "medium",
"description": "How quickly cells coarsen away from the body."
},
"regions": {
"type": "array",
"items": {
"$ref": "#/$defs/OctreeRegion"
},
"maxItems": 64
},
"max_size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Largest far-field cell in metres; default from the domain size."
},
"rotating_zones": {
"type": "array",
"items": {
"$ref": "#/$defs/OctreeRotatingZone"
},
"maxItems": 32
}
},
"additionalProperties": false
},
"Clarification": {
"type": "object",
"required": [
"question"
],
"properties": {
"answer": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
]
},
"question": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
"OctreeSurface": {
"type": "object",
"properties": {
"size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Wall edge length in metres (with adaptive sizing, the largest). Leave out to size the wall for target_cells; set it only when the user fixes a size."
},
"sizing": {
"enum": [
"adaptive",
"uniform"
],
"type": "string",
"default": "adaptive",
"description": "adaptive refines size for curvature, sharp edges, narrow gaps and thin walls down to min_size; uniform keeps one edge length."
},
"fidelity": {
"enum": [
"default",
"high"
],
"type": "string",
"default": "default",
"description": "high: the wall follows sharp edges and curvature closely (sharp edges restored, creases split, curvature angle 12 degrees unless given); creased walls warp far less, at some cost in the worst cells and about 30-60% more meshing time. Use when the user asks for an exact or high-fidelity wall."
},
"min_size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Smallest curvature-driven edge in metres; default size / 8."
},
"gap_cells": {
"type": "number",
"default": 3,
"maximum": 10,
"minimum": 1,
"description": "Edges across narrow gaps."
},
"close_gaps": {
"anyOf": [
{
"type": "number",
"maximum": 20,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Close fluid gaps narrower than this many first-layer heights. Changes the geometry: use only for an explicit simplification and disclose it."
},
"preparation": {
"enum": [
"auto",
"preserve",
"wrap"
],
"type": "string",
"default": "auto",
"description": "auto: feature-preserving remesh for clean solids, a voxel wrap for dirty CAD; preserve or wrap force one route."
},
"feature_angle": {
"type": "number",
"default": 50,
"maximum": 180,
"description": "Sharp-edge detection angle in degrees.",
"exclusiveMinimum": 0
},
"max_deviation": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Allowed wall-to-CAD p95 deviation in metres; default two surface sizes."
},
"curvature_angle": {
"anyOf": [
{
"type": "number",
"maximum": 90,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Most surface turning per adaptive edge, in degrees; leave out for the service's setting (18 by default)."
}
},
"additionalProperties": false
},
"OctreeControls": {
"type": "object",
"properties": {
"flow": {
"$ref": "#/$defs/OctreeFlow"
},
"volume": {
"$ref": "#/$defs/OctreeVolume"
},
"surface": {
"$ref": "#/$defs/OctreeSurface"
},
"surfaces": {
"type": "object",
"description": "Size and layer overrides per named surface or glob such as wheel_*.",
"maxProperties": 64,
"propertyNames": {
"maxLength": 64,
"minLength": 1
},
"patternProperties": {
"^[A-Za-z0-9_.*?\\[\\]-]+$": {
"$ref": "#/$defs/OctreeSurfaceOverride"
}
}
},
"exact_count": {
"type": "boolean",
"default": false,
"description": "When the user states a cell count, probe the topology to land within ±10%. Count rebuilds also need retry_policy=automatic; otherwise the first passing mesh is kept and its count reported."
},
"boundary_layer": {
"$ref": "#/$defs/OctreeBoundaryLayer"
}
},
"description": "Meshing intent: the mesher sizes everything left out for the request's target_cells.",
"additionalProperties": false
},
"OctreePartWake": {
"type": "object",
"required": [
"surfaces"
],
"properties": {
"size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Cell size in metres; default the body wake's."
},
"length": {
"type": "number",
"default": 0.5,
"description": "Downstream extent in body lengths.",
"exclusiveMinimum": 0
},
"spread": {
"type": "number",
"default": 0,
"maximum": 1,
"minimum": 0
},
"surfaces": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.*?\\[\\]-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 64,
"minItems": 1
}
},
"description": "A wake behind named parts (mirrors, wheels, a hub), along the stream.",
"additionalProperties": false
},
"DecisionContext": {
"type": "object",
"properties": {
"objective": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
]
},
"assumptions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"maxItems": 32
},
"clarifications": {
"type": "array",
"items": {
"$ref": "#/$defs/Clarification"
},
"maxItems": 16
}
},
"description": "User intent and declared assumptions, retained with the owned job request.",
"additionalProperties": false
},
"OpenFoamOptions": {
"type": "object",
"required": [
"domain_min",
"domain_max",
"minimum_spacing",
"maximum_spacing"
],
"properties": {
"workflow": {
"enum": [
"external",
"internal"
],
"type": "string",
"default": "external"
},
"domain_max": {
"$ref": "#/$defs/Vector3"
},
"domain_min": {
"$ref": "#/$defs/Vector3"
},
"input_unit": {
"anyOf": [
{
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Surface coordinate units; domain bounds and spacing are always in metres."
},
"retry_policy": {
"enum": [
"review",
"automatic"
],
"type": "string",
"default": "review",
"description": "Review stops before another full mesh attempt; automatic allows the explicitly authorized, bounded max_remesh_iterations budget, within the credential's retry allowance."
},
"n_prism_layers": {
"type": "integer",
"default": 3,
"maximum": 20,
"minimum": 0,
"description": "Requested layers; 0 disables layers. Achieved layers/coverage must be checked after meshing."
},
"maximum_spacing": {
"type": "number",
"exclusiveMinimum": 0
},
"minimum_spacing": {
"type": "number",
"exclusiveMinimum": 0
},
"max_remesh_iterations": {
"type": "integer",
"default": 3,
"maximum": 4,
"minimum": 1
},
"retry_authorization_reason": {
"anyOf": [
{
"type": "string",
"maxLength": 1000,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Explicit user or authorized-agent delegation for bounded automatic mesh retries; required for retry_policy=automatic."
}
},
"description": "engine=openfoam options. Sizing, refinement and quality fields: get_mesh_controls(engine=openfoam) or get_tool_schema. Unknown fields are rejected.",
"additionalProperties": true
},
"StructuredOptions": {
"type": "object",
"required": [
"flow_region"
],
"properties": {
"workflow": {
"anyOf": [
{
"enum": [
"external",
"internal",
"cht",
"solid"
],
"type": "string"
},
{
"type": "null"
}
]
},
"mesh_type": {
"enum": [
"stair_step",
"cut_cell"
],
"type": "string",
"default": "stair_step",
"description": "Ask about surface fidelity; stair_step is the disclosed default. Neither option extrudes prism layers."
},
"input_unit": {
"anyOf": [
{
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Derive from artifact metadata; required for uploads without declared units."
},
"flow_region": {
"$ref": "#/$defs/FlowRegion"
},
"retry_policy": {
"enum": [
"review",
"automatic"
],
"type": "string",
"default": "review",
"description": "Review stops before another full target-count attempt; automatic allows the explicitly authorized bounded max_target_iterations budget, within the credential's retry allowance."
},
"boundary_patches": {
"type": "array",
"items": {
"$ref": "#/$defs/StructuredBoundary"
},
"maxItems": 64
},
"internal_surfaces": {
"type": "array",
"items": {
"$ref": "#/$defs/StructuredInternalSurface"
},
"maxItems": 32
},
"adaptive_refinement": {
"type": "boolean",
"default": true,
"description": "Internal stair-step: retain fine cells near walls and in tight passages, coarsen the bulk with conformal 2:1 transitions."
},
"retry_authorization_reason": {
"anyOf": [
{
"type": "string",
"maxLength": 1000,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Explicit user or authorized-agent delegation for bounded automatic mesh retries; required for retry_policy=automatic."
}
},
"description": "engine=structured options. Sizing, refinement and quality fields: get_mesh_controls(engine=structured) or get_tool_schema. Unknown fields are rejected.",
"additionalProperties": true
},
"OctreePrismOptions": {
"type": "object",
"required": [],
"properties": {
"controls": {
"anyOf": [
{
"$ref": "#/$defs/OctreeControls"
},
{
"type": "null"
}
],
"description": "Meshing intent (flow, wake, layers, sizes) for an external mesh. The mesher resolves the domain, spacings and every other field left out from the geometry, with the settings the development meshes were validated with. Other fields given beside it override the resolved values: set them only for a value the user asked for."
},
"workflow": {
"enum": [
"external",
"internal",
"cht_step"
],
"type": "string",
"default": "external"
},
"input_unit": {
"anyOf": [
{
"enum": [
"mm",
"cm",
"m",
"in"
],
"type": "string"
},
{
"type": "null"
}
]
},
"retry_policy": {
"enum": [
"review",
"automatic"
],
"type": "string",
"default": "review",
"description": "Review stops before another full mesh or memory-escalation attempt and retains eligible out-of-tolerance results for a decision. Automatic allows only the explicitly authorized bounded retry budget, within the credential's retry allowance."
},
"named_surfaces": {
"type": "array",
"items": {
"$ref": "#/$defs/NamedSurface"
},
"maxItems": 64,
"description": "Parts of the wall, each an uploaded STL in the surface's units, named for controls.surfaces, wake parts and around regions; each also becomes a wall patch. A STEP's solids are named by the mesher, so leave this out for a STEP."
},
"max_remesh_iterations": {
"type": "integer",
"default": 2,
"maximum": 6,
"minimum": 1
},
"retry_authorization_reason": {
"anyOf": [
{
"type": "string",
"maxLength": 1000,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Explicit user or authorized-agent delegation for bounded automatic mesh retries; required for retry_policy=automatic."
}
},
"description": "GD Unstructured. Get exact sizing, units, layers and rotating-zone controls with get_mesh_controls or get_tool_schema. Unknown fields and quality-gate overrides are rejected.",
"additionalProperties": true
},
"OctreeRotatingZone": {
"type": "object",
"required": [
"name",
"center",
"axis",
"diameter",
"height"
],
"properties": {
"rpm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"axis": {
"$ref": "#/$defs/Vector3"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]+$",
"maxLength": 96,
"minLength": 1
},
"size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Cell size inside the zone in metres; default none."
},
"center": {
"$ref": "#/$defs/Vector3"
},
"height": {
"type": "number",
"description": "Full axial extent in metres.",
"exclusiveMinimum": 0
},
"diameter": {
"type": "number",
"exclusiveMinimum": 0
},
"angular_velocity": {
"type": "number",
"default": 0,
"description": "rad/s, when rpm is not given."
}
},
"description": "A cylindrical rotating (MRF) cell zone, written to the mesh.",
"additionalProperties": false
},
"StructuredBoundary": {
"type": "object",
"required": [
"name",
"kind"
],
"properties": {
"kind": {
"enum": [
"port",
"remaining_boundary"
],
"type": "string"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]{0,31}$"
},
"shape": {
"enum": [
"circle",
"rectangle"
],
"type": "string",
"default": "circle"
},
"normal": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"size_mm": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"center_mm": {
"anyOf": [
{
"$ref": "#/$defs/Vector3"
},
{
"type": "null"
}
]
},
"radius_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"OctreeBoundaryLayer": {
"type": "object",
"properties": {
"layers": {
"type": "integer",
"default": 5,
"maximum": 40,
"minimum": 0,
"description": "Prism layers; 0 for none (inviscid or wall-function walls)."
},
"y_plus": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Target first-cell y+; needs flow.speed. A requested y+ is not an achieved one."
},
"growth_rate": {
"type": "number",
"default": 1.2,
"maximum": 2,
"minimum": 1
},
"first_height": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "First layer height in metres. Give this or y_plus; with neither the stack is sized to meet the core cells."
},
"gap_compression": {
"type": "boolean",
"default": true,
"description": "In narrow passages shrink the stack to fit, keeping its layer count, instead of dropping layers."
}
},
"additionalProperties": false
},
"OctreeSurfaceLayers": {
"type": "object",
"required": [
"layers"
],
"properties": {
"layers": {
"type": "integer",
"maximum": 40,
"minimum": 0,
"description": "Most prism layers on these surfaces; 0 for none."
}
},
"additionalProperties": false
},
"OctreeSurfaceOverride": {
"type": "object",
"properties": {
"size": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Largest wall edge on these surfaces, in metres; refines the automatic size there, never coarsens it."
},
"boundary_layer": {
"anyOf": [
{
"$ref": "#/$defs/OctreeSurfaceLayers"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"StructuredInternalSurface": {
"type": "object",
"required": [
"name",
"axis",
"coordinate_mm",
"minimum_mm",
"maximum_mm"
],
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
],
"type": "string"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]{0,31}$"
},
"direction": {
"enum": [
-1,
1
],
"type": "integer",
"default": 1
},
"maximum_mm": {
"$ref": "#/$defs/Vector3"
},
"minimum_mm": {
"$ref": "#/$defs/Vector3"
},
"coordinate_mm": {
"type": "number"
}
},
"description": "Two-sided rectangular pressure-jump selection, never an exterior wall.",
"additionalProperties": false
}
},
"required": [
"surface_artifact_id",
"engine",
"idempotency_key"
],
"properties": {
"engine": {
"enum": [
"structured",
"openfoam",
"octree_prism"
],
"type": "string",
"description": "structured = Cartesian; octree_prism = native octree/polyhedral with prism layers; openfoam = legacy engine identifier. Prefer configured octree_prism for generic unstructured requests; preserve explicit methods. Choose delivered file formats separately with export_formats."
},
"openfoam": {
"anyOf": [
{
"$ref": "#/$defs/OpenFoamOptions"
},
{
"type": "null"
}
]
},
"notify_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048
},
{
"type": "null"
}
],
"description": "Optional public HTTPS URL that receives a signed notification when the job finishes, so you need not poll."
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"structured": {
"anyOf": [
{
"$ref": "#/$defs/StructuredOptions"
},
{
"type": "null"
}
]
},
"octree_prism": {
"anyOf": [
{
"$ref": "#/$defs/OctreePrismOptions"
},
{
"type": "null"
}
]
},
"target_cells": {
"type": "integer",
"default": 1000000,
"maximum": 50000000,
"minimum": 1000
},
"export_formats": {
"type": "array",
"items": {
"enum": [
"cgns",
"gd_cgns",
"fluent",
"openfoam"
],
"type": "string"
},
"default": [
"cgns"
],
"maxItems": 4,
"minItems": 1,
"description": "Delivered mesh formats, in preference order. Default cgns is Standard CGNS (NGON/NFACE) for ParaView. gd_cgns is GD CGNS for Fluxcore/Studio; fluent is a Fluent-format polyhedral .msh; openfoam is a polyMesh archive. Select formats independently of the meshing engine. The first format is the primary download. GD CGNS is also retained internally for simulation and viewing. Preserve an explicit user choice; do not ask for a format when none was specified."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Use a fresh unique key for each newly requested job, even with identical inputs or a matching completed job. Reuse unchanged only for retries/resuming that same intended job. Never replace it to retry an uncertain submission."
},
"reviewed_job_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"description": "Explicitly requested new attempt after reviewing this completed mesh job, including quality or resource failures. Use a fresh idempotency key; this records lineage and never restarts the prior execution."
},
"decision_context": {
"$ref": "#/$defs/DecisionContext"
},
"surface_artifact_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}