Agentic Fabrication Network (AFN)

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['offer_id', 'shipping_option_id'], 'properties': {'zip': {'type': 'string'}, 'city': {'type': 'string'}, 'name': {'type': 'string', 'description': 'Recipient full name (only if the user provided it)'}, 'email': {'type': 'string', 'format': 'email', 'description': 'Buyer email (only if the user provided it)'}, 'phone': {'type': 'string'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter US state'}, 'street1': {'type': 'string', 'description': 'Street address (only if the user provided it)'}, 'street2': {'type': 'string'}, 'offer_id': {'type': 'string'}, 'return_url': {'type': 'string', 'format': 'uri', 'description': "Exact URL of the page the user is on right now, IF the client application knows it (a web app embedding this tool passes its own page URL). The post-payment page shows a 'Return to <site>' button pointing here. Omit when unknown — never invent one."}, 'billing_zip': {'type': 'string'}, 'coupon_code': {'type': 'string', 'description': 'Coupon code, only if the user provided one (early-adopter codes from the AFN team). Case-insensitive. The discount appears on the payment page; a 100%-off code makes the total $0 with no card required. Never invent or guess a code.'}, 'billing_city': {'type': 'string'}, 'billing_name': {'type': 'string', 'description': "Billing address, only when the buyer answered the billing question (e.g. said it differs from shipping, or a checkout UI's 'same as shipping' checkbox — then send the shipping values verbatim). Never ask for it; omit and the payment page handles billing."}, 'billing_state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter US state'}, 'billing_street1': {'type': 'string'}, 'billing_street2': {'type': 'string'}, 'shipping_option_id': {'type': 'string', 'description': "One of the offer's shipping option ids"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_id'], 'properties': {'quote_id': {'type': 'string', 'description': 'Quote id from the still-quoting response'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cut': {'type': 'string', 'description': 'Decal cut style — pass the user\'s words verbatim ("triangle", "die cut", "circle"). Known: contour|square|oval|kiss_cut; anything else gets closest-match offers with a substitution note. Omit to compare the main options'}, 'size': {'type': 'string', 'description': 'Print size — pass the user\'s words verbatim ("letter", "24x36", "half letter"). Cards are 3.5x2; flyers 8.5x5.5|8.5x11|11x17; posters 12x18 through 36x48. Unknown sizes get closest-match offers'}, 'bends': {'type': 'array', 'items': {'type': 'object', 'required': ['line', 'angle_deg', 'direction'], 'properties': {'id': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'line': {'type': 'object', 'required': ['p1', 'p2'], 'properties': {'p1': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'p2': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}}, 'additionalProperties': False}, 'source': {'enum': ['detected', 'user'], 'type': 'string'}, 'face_id': {'type': 'integer'}, 'angle_deg': {'type': 'number', 'exclusiveMaximum': 180, 'exclusiveMinimum': 0}, 'direction': {'enum': ['up', 'down'], 'type': 'string'}, 'radius_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Sheet-metal bend lines, each as TWO POINTS in the part\'s own mm frame (flat DXF parts use z=0: a bend from (0,12.7) to (76.2,12.7) is p1 [0,12.7,0], p2 [76.2,12.7,0]). angle_deg is the target bend angle (90 = a right-angle flange), direction "up"/"down" is the fold direction relative to the flat pattern, radius_mm the requested inside radius (omit it — the shop resolves to its tooling and reports what it used). Pass these when the user articulates WHERE the bends go; a bare "it has 2 bends" is bend_count, not this.'}, 'color': {'type': 'string', 'description': 'ONLY a color the user actually asked for — NEVER pick one for them. fdm_print: Filament color for fdm_print (e.g. black, red); resin_print: Resin color for resin_print (e.g. gray, white, black); powder_print: Powder part color: raw gray/white, or a dye ("black", "dark blue") — vendor-resolved; elastomer_print: Elastomer part color — VCJ parts ship raw; asks resolve with an honest substitution note; cnc: Colour for cnc: with finish anodized it is the anodize colour, otherwise the stock\'s own colour (black Delrin, clear acrylic). Colour WORDS only; each maker resolves the shade and says what it landed on; laser_cut: Colour of the flat stock for laser_cut (black, clear, natural…). Colour WORDS only; each maker quotes the materials it stocks in that colour and drops the ones that cannot be it; print: Print color ask ("full color", "black and white"). Vendors that only price full color note the substitution; apparel: Garment color for apparel ("black", "heather gray") — vendor-resolved'}, 'paper': {'type': 'string', 'description': 'Paper stock — free-form ("matte", "glossy", "recycled", "14pt"). Resolved to the closest stock the vendor runs'}, 'sides': {'type': 'string', 'description': 'single|double sided printing (defaults: cards double, flyers/posters single)'}, 'units': {'type': 'string', 'description': 'sheetmetal: DXF drawing units: "mm" (default) or "in". STEP files carry their own units; laser_cut: DXF drawing units: "mm" (default) or "in"'}, 'finish': {'type': 'string', 'description': 'cnc: CNC surface finish: standard|anodized|polished|bead_blasted (default standard); sheetmetal: as_cut (default) | deburred | anodized | powder_coat — anodized is aluminum-only; powder coat protects mild steel for outdoor use'}, 'inserts': {'type': 'array', 'items': {'type': 'object', 'required': ['insert', 'thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'insert': {'enum': ['nut', 'flush_nut', 'standoff', 'blind_standoff', 'stud'], 'type': 'string'}, 'points': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'length_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200, 'description': 'PEM-style hardware inserts pressed into holes of a sheet-metal part — one record per hole. `insert` is the species (nut | flush_nut | standoff | blind_standoff | stud) and `thread` its size ("M4", "1/4-20"); both are required. When known, add length_mm (standoff/stud post length), the hole\'s center (located_at_mm, part\'s own mm frame), its axis, the drilled diameter, and `points` — the signed unit vector the insert\'s functional side faces (flip = negate). Pass these when the user asks for press-in nuts/standoffs/studs; vendors with a hardware service price them.'}, 'process': {'enum': ['fdm_print', 'resin_print', 'powder_print', 'metal_print', 'elastomer_print', 'cnc', 'sheetmetal', 'laser_cut', 'decal', 'print', 'apparel'], 'type': 'string', 'description': "What to fabricate. If the user just drops a file and asks for a price, OMIT this — UFP detects the file type (artwork, mesh — STL/OBJ/PLY/3MF/AMF, BREP — STEP/IGES, DXF) and routes it to every process that can make it; the response's routing.also_possible lists processes UFP can't quote yet"}, 'product': {'type': 'string', 'description': 'print: Print product kind: business_cards|flyers|posters. Omit to quote every kind the artwork fits; apparel: apparel: t_shirt|hoodie|long_sleeve|tank_top (free-form — "tee", "crewneck" resolve to the closest product)'}, 'shore_a': {'type': 'number', 'description': 'Numeric Shore A durometer ask (10-95, e.g. 40). Resolved to the NEAREST stocked durometer with a substitution note — never a silent swap', 'exclusiveMinimum': 0}, 'tapping': {'type': 'array', 'items': {'type': 'object', 'required': ['thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200, 'description': 'Tapped (threaded) holes for a sheet-metal part — one record per hole the user wants threads cut into. `thread` is the callout in the user\'s words ("M6", "M4 x 0.7", "1/4-20") and is all that\'s required; when known, add the hole\'s center in the part\'s own mm frame (located_at_mm), its unit axis, the pre-tap drilled diameter, and depth_mm so the shop taps the right hole. Pass these when the user asks for threaded/tapped holes; vendors with a tapping service price them.'}, 'vendors': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 16, 'description': 'Only these specific vendors/makers ("just quote Slant 3D") — an INCLUDE list of vendor names as they appear on offers. Friendly names accepted ("A3D", "slant 3d"); unmatched names are reported, never an error. Usually OMIT: pass it only when the user explicitly names the vendors they want'}, 'callouts': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'value', 'unit'], 'properties': {'name': {'type': 'string'}, 'unit': {'enum': ['mm', 'in'], 'type': 'string'}, 'value': {'type': 'number'}, 'critical': {'type': 'boolean'}, 'tolerance_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Dimensions you read off the user\'s drawing that matter ("hole_diameter 6.5mm ±0.1"). The tightest tolerance prunes vendors that cannot hold it.'}, 'deadline': {'type': 'string', 'description': 'Latest acceptable delivery date, ISO YYYY-MM-DD'}, 'file_url': {'type': 'string', 'format': 'uri', 'description': 'Public URL of the design file — only when the design lives at a URL'}, 'material': {'type': 'string', 'description': 'ONLY a material the user actually asked for — NEVER guess or default one (a silent "pla" on a bare file drop prunes every maker that does not stock it; OMIT instead and each process quotes across its stocked materials so every maker can bid). fdm_print: pla|petg|asa (free-form — "abs", "polycarbonate" asks resolve to the closest stocked filament with a substitution note); resin_print: standard|tough|high_temp|high_detail resin (free-form asks resolve to the closest supported resin); powder_print: Powder-bed nylon: nylon_12|nylon_12_smooth|nylon_11|nylon_12_gf|nylon_12_esd|nylon_12_white|nylon_pa2200|nylon_12_sls|tpu (free-form — "PA12", "glass filled" resolve to the closest stocked powder); elastomer_print: Jetted elastomer: tepu_30a|tepu_50a (free-form — "TPU", "soft rubber" resolve to the closest stocked durometer); cnc: aluminum_6061|aluminum_7075|stainless_304|titanium|brass|acetal|delrin|abs|nylon_pa6|peek|acrylic (free-form asks resolve to the closest supported stock); sheetmetal: mild_steel|aluminum_5052|stainless_304 (free-form — "steel", "5052", "stainless" resolve; unknown asks get closest-match offers). Omit to compare the defaults; laser_cut: acrylic|plywood|mdf|delrin|uhmw|hdpe|g10|carbon_fiber|mild_steel|aluminum_5052|stainless_304 (free-form — "plexiglass", "birch" resolve; unknown asks get closest-match offers); decal: vinyl|holographic|transparent|glitter (free-form — "chrome" etc. gets closest matches)'}, 'width_in': {'type': 'number', 'description': 'Decal width in inches (default 3)', 'exclusiveMinimum': 0}, 'food_safe': {'type': 'boolean', 'description': 'Must be vendor-certified food safe'}, 'height_in': {'type': 'number', 'description': 'Decal height in inches (default 3)', 'exclusiveMinimum': 0}, 'high_temp': {'type': 'boolean', 'description': 'Must tolerate sustained heat (vendor heat-resistance claim)'}, 'placement': {'type': 'string', 'description': 'Print placement for apparel: front (default) | back | front_back'}, 'processes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Only quote these fabrication processes — a constraint that narrows the auto-routing fan. Friendly terms accepted ("sheet metal", "3d printing", "cnc", "laser"); unmappable terms are reported, never an error. Usually OMIT: auto-routing quotes every process that can make the file. Pass it only when the user explicitly limits the process'}, 'share_key': {'type': 'string', 'description': "Share key for a LOCKED part — the k=… value from the owner's share link (…/part/UFP-…?k=KEY). Required with part_number when the part is locked; omit otherwise"}, 'bend_count': {'type': 'number', 'description': 'Number of bends in the design (bend lines must be in the file). Prices CNC bending; omit for flat parts', 'exclusiveMinimum': 0}, 'quantities': {'type': 'array', 'items': {'type': 'integer', 'exclusiveMinimum': 0}, 'maxItems': 5, 'description': "Quantities the user actually wants — pass [1] or [2] if that's the ask. Vendors with a higher minimum quote AT their minimum and the offer notes it (requested_quantity). Default: 25 for decals, 1 for prints; a part_number reorder defaults to the quantity last purchased"}, 'ships_from': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Only vendors that ship from these countries/regions ("only US vendors", "keep it domestic") — an INCLUDE list. Friendly terms accepted ("US", "Europe", "Germany", "China", "UK"); unmappable terms are reported, never an error. Vendors whose origin is unknown or whose network is worldwide (origin not guaranteed) are excluded, each with a note saying why. Usually OMIT: pass it only when the user explicitly limits where vendors ship from'}, 'design_file': {'anyOf': [{'type': 'object', 'required': ['file_id', 'download_url'], 'properties': {'file_id': {'type': 'string'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string'}, 'download_url': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'string'}], 'description': 'The design file itself (user-attached or generated image/STL). ChatGPT supplies the file reference automatically when the user attached a file — just bind the attachment here. Other clients may pass a data: URL (base64) or a public https URL string. Preferred over file_url.'}, 'metal_alloy': {'type': 'string', 'description': 'Metal AM alloy: stainless_316l|stainless_17_4ph|titanium_ti64|aluminum_alsi10mg|inconel_718|cobalt_chrome|tool_steel_h13|copper (free-form asks like "Ti-6Al-4V" resolve to the closest stocked powder)'}, 'part_number': {'type': 'string', 'description': 'UFP part number from a previous paid order (UFP-… or part_…). Reorders: replaces design_file/file_url entirely; any other fields provided override the stored spec'}, 'ship_to_zip': {'type': 'string', 'pattern': '^\\d{5}(-\\d{4})?$', 'description': 'Destination US ZIP code, exactly as the user stated it. OMIT if the user has not given one — NEVER guess or invent a ZIP. Without it, prices come back all-in with shipping to an assumed central-US destination, flagged on routing.ship_to'}, 'submersible': {'type': 'boolean', 'description': 'Must survive submersion in water'}, 'metal_finish': {'type': 'string', 'description': 'Metal AM post-processing: as_printed|bead_blast|machined_critical|polished|heat_treated (as_printed keeps support witness marks)'}, 'requirements': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 20, 'description': 'Verbatim context terms from the user — materials, finishes, certifications, tolerances ("UV resistant", "anodized: red", "iso 13485", "tolerance: 0.1mm"). UFP applies what it can and reports what it could not; unresolvable terms are logged for vendor sourcing. Do not interrogate the user to fill this — pass what they said.'}, 'thickness_in': {'type': 'number', 'description': "sheetmetal: Sheet thickness in inches (e.g. 0.063 = 14 ga aluminum). Quoted at the nearest stocked thickness; omit for ~16 ga default; laser_cut: Nominal thickness in inches; quoted at the vendor's nearest stocked thickness. Omit for the material's common stock", 'exclusiveMinimum': 0}, 'outdoor_rated': {'type': 'boolean', 'description': 'Must survive outdoor exposure'}, 'powder_finish': {'type': 'string', 'description': 'Powder post-processing: as_printed (raw powder surface) | vapor_polished | polished'}, 'max_budget_usd': {'type': 'number', 'description': 'Hard budget cap in USD, all-in', 'exclusiveMinimum': 0}, 'attachment_urls': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'maxItems': 10, 'description': 'Additional files for the SAME part — the PDF drawing next to the STEP, spec sheets, BOMs. Pass everything the user gave you; UFP works out which file is the part and which are supporting documents.'}, 'elastomer_finish': {'type': 'string', 'description': 'Elastomer post-processing: as_printed (VCJ parts ship raw — the whole lane today)'}, 'metal_technology': {'type': 'string', 'description': 'Metal AM process: laser_powder_bed (SLM/DMLS/LPBF)|binder_jet|ebm. Omit to let the vendor pick its default for the alloy'}, 'min_vendor_stars': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Only vendors whose displayed review rating is at least this many stars (1-5). Vendors with no reviews yet are excluded — the filter demands demonstrated quality'}, 'powder_technology': {'type': 'string', 'description': 'Powder process: mjf (HP Multi Jet Fusion) | sls (laser sintering). Omit to let the vendor pick its default lane for the material'}, 'min_vendor_reviews': {'type': 'integer', 'description': 'Only vendors with at least this many verified-purchase reviews', 'exclusiveMinimum': 0}, 'proven_spec_orders': {'type': 'integer', 'description': 'Only vendors with at least N completed orders for this exact process+material — "a vendor that prints PC reliably"', 'exclusiveMinimum': 0}, 'elastomer_technology': {'type': 'string', 'description': 'Elastomer process: vapor_cure_jetting (VCJ). Omit to let the vendor pick its default lane for the material'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'process': {'type': 'string', 'description': 'A UFP process to scope to ("fdm_print", "resin_print", "cnc", "sheetmetal", "laser_cut") — lists the materials that process makes'}, 'material': {'type': 'string', 'description': 'A material the user named or you are weighing ("PLA", "6061 aluminum", "stainless") — free-form; a family ask like "stainless" returns the whole family'}, 'question': {'type': 'string', 'description': "The user's raw question — mined for intent (stronger/tougher, heat/hot, outdoor/UV) so the right ladder is surfaced"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'process': {'type': 'string', 'description': 'Advisory scope ("sheetmetal") — v1 returns the whole catalog either way; filter what you relay'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['shop'], 'properties': {'shop': {'type': 'string', 'minLength': 1, 'description': 'The shop as the user or the offer cards name it ("SendCutSend", "sendcutsend")'}, 'material': {'type': 'string', 'description': 'Advisory: narrow the relayed list to one material ("mild steel", "5052")'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'stars'], 'properties': {'stars': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Overall rating the user confirmed, 1-5'}, 'claims': {'type': 'object', 'properties': {'delivery_claim': {'enum': ['not_delivered', 'late', 'on_time'], 'type': 'string', 'description': 'The user\'s delivery claim ("never showed up" -> not_delivered)'}, 'received_material': {'type': 'string', 'maxLength': 80, 'description': 'Material the user says actually ARRIVED, when they complain it differs from the order ("they sent aluminum")'}, 'received_quantity': {'type': 'integer', 'description': 'Count the user says actually arrived, when it differs from the order', 'exclusiveMinimum': 0}}, 'description': "CHECKABLE claims from the user's feedback — the network stamps each against its own records (the ordered spec, polled tracking + delivery events) and attaches evidence chips to the review. Only pass what the user actually asserted.", 'additionalProperties': False}, 'facets': {'type': 'object', 'properties': {'quality': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Build/print/cut quality'}, 'accuracy': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'How well the item matched the ordered spec/design'}, 'timeliness': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Delivery speed vs the quoted ETA'}}, 'description': 'Score only the facets the user actually spoke to', 'additionalProperties': False}, 'comment': {'type': 'string', 'maxLength': 2000, 'description': "Short factual summary of the user's feedback, in their spirit — optional"}, 'order_id': {'type': 'string', 'description': 'The UFP order being reviewed (ord_…) — see list_orders'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_id'], 'properties': {'quote_id': {'type': 'string', 'description': 'Quote id the board is watching'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_id'], 'properties': {'bends': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['line', 'angle_deg', 'direction'], 'properties': {'id': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'line': {'type': 'object', 'required': ['p1', 'p2'], 'properties': {'p1': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'p2': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}}, 'additionalProperties': False}, 'source': {'enum': ['detected', 'user'], 'type': 'string'}, 'face_id': {'type': 'integer'}, 'angle_deg': {'type': 'number', 'exclusiveMaximum': 180, 'exclusiveMinimum': 0}, 'direction': {'enum': ['up', 'down'], 'type': 'string'}, 'radius_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50}], 'description': 'Sheet-metal bend lines, each as TWO POINTS in the part\'s own mm frame (flat DXF parts use z=0: a bend from (0,12.7) to (76.2,12.7) is p1 [0,12.7,0], p2 [76.2,12.7,0]). angle_deg is the target bend angle (90 = a right-angle flange), direction "up"/"down" is the fold direction relative to the flat pattern, radius_mm the requested inside radius (omit it — the shop resolves to its tooling and reports what it used). Pass these when the user articulates WHERE the bends go; a bare "it has 2 bends" is bend_count, not this.'}, {'type': 'null'}], 'description': "New bend records for this part — a spec change: sheet lanes requote with exactly these bends (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: each bend is two points in the part's own mm frame (flat DXF parts use z=0) plus angle_deg, direction up|down, and an optional requested radius_mm. Pass null to REMOVE every articulated bend"}, 'clear': {'type': 'array', 'items': {'enum': ['deadline', 'budget', 'outdoor_rated', 'submersible', 'high_temp', 'food_safe', 'reliability', 'requirements', 'processes', 'ships_from', 'vendors'], 'type': 'string'}, 'minItems': 1, 'description': 'REMOVE constraints entirely ("drop the deadline", "forget the budget", "no more food-safe requirement"): list the constraints to clear and each is removed from the quote — the one deliberate widening besides undo. Clearing a deadline or budget answers instantly from held offers (near-misses convert back); clearing an attribute/reliability/requirements demand re-prices honestly. Same effect as ["any"] on the three filter args, extended to every constraint'}, 'color': {'type': ['string', 'null'], 'description': "New color for this part (spec change — lanes requote). Colour WORDS only ('black', 'green', 'clear'); the network resolves them to each maker's stocked shades, dyes, filaments or coatings — a family word ('blue') brings back EVERY stocked shade of it, and the quote's color_shades_available lists them — never pass a material or a shade you invented. Pass null to REMOVE a previously asked color — back to vendor defaults"}, 'scale': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0.01}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0.01}, 'z': {'type': 'number', 'maximum': 100, 'minimum': 0.01}}, 'description': 'Rescale the DESIGN ITSELF before re-quoting: per-axis stretch factors over the file\'s current geometry ("make it 2x bigger" = {"x":2,"y":2,"z":2}). Mesh designs are genuinely converted — the child quote prices a rescaled file; STEP/IGES designs keep their original file with the dimensions riding as callouts (pass those too). {1,1,1} is a no-op', 'additionalProperties': False}, 'finish': {'type': ['string', 'null'], 'description': 'New surface finish ("powder coat", "anodized", "bead blasted") — a spec change: finish-capable lanes (sheet metal, CNC, metal print) requote WITH it; 3D-print lanes have no coating step, so they ignore the finish but keep the COLOR. A colored finish ask ("black powder coat") should set BOTH finish and color, so every lane lands on the buyer\'s color. Pass null to REMOVE a previously asked finish'}, 'inserts': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['insert', 'thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'insert': {'enum': ['nut', 'flush_nut', 'standoff', 'blind_standoff', 'stud'], 'type': 'string'}, 'points': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'length_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200}], 'description': 'PEM-style hardware inserts pressed into holes of a sheet-metal part — one record per hole. `insert` is the species (nut | flush_nut | standoff | blind_standoff | stud) and `thread` its size ("M4", "1/4-20"); both are required. When known, add length_mm (standoff/stud post length), the hole\'s center (located_at_mm, part\'s own mm frame), its axis, the drilled diameter, and `points` — the signed unit vector the insert\'s functional side faces (flip = negate). Pass these when the user asks for press-in nuts/standoffs/studs; vendors with a hardware service price them.'}, {'type': 'null'}], 'description': 'New hardware-insert records for this part — a spec change: sheet lanes requote with exactly these inserts (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: species (nut|flush_nut|standoff|blind_standoff|stud) and thread required, hole geometry optional. Pass null to REMOVE every insert'}, 'sort_by': {'enum': ['recommended', 'price', 'unit_price', 'total_price', 'arrival', 'rating'], 'type': 'string', 'description': '"Organize by": re-order the quote\'s offer cards ("sort by cheapest" → "price"; "soonest arrival first" → "arrival"; "best rated" → "rating"; "total_price" = part + cheapest shipping; "recommended" restores the default price+speed rank). PURE PRESENTATION — answers instantly on the same quote, never re-prices or drops offers, and the ordering sticks across re-reads, streaming, and later refines until changed'}, 'tapping': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200}], 'description': 'Tapped (threaded) holes for a sheet-metal part — one record per hole the user wants threads cut into. `thread` is the callout in the user\'s words ("M6", "M4 x 0.7", "1/4-20") and is all that\'s required; when known, add the hole\'s center in the part\'s own mm frame (located_at_mm), its unit axis, the pre-tap drilled diameter, and depth_mm so the shop taps the right hole. Pass these when the user asks for threaded/tapped holes; vendors with a tapping service price them.'}, {'type': 'null'}], 'description': 'New tapped-hole records for this part — a spec change: sheet lanes requote with exactly these taps (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: thread callout ("M6", "1/4-20") required, hole geometry optional. Pass null to REMOVE every tap'}, 'vendors': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 16, 'description': 'Only these specific vendors/makers ("only show A3D Manufacturing", "just Slant 3D and Fictiv") — an INCLUDE list of vendor names as they appear on offers. A CONSTRAINT like processes: other vendors\' offers drop instantly (nothing re-prices), further refines inherit the filter, and ["any"] clears it to show every vendor again. Friendly names accepted ("A3D", "slant 3d"); unmatched names are reported, never an error. This is THE way to answer "show me everything vendor X offers" — the filtered quote lists that vendor\'s complete lineup'}, 'callouts': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'value', 'unit'], 'properties': {'name': {'type': 'string'}, 'unit': {'enum': ['mm', 'in'], 'type': 'string'}, 'value': {'type': 'number'}, 'critical': {'type': 'boolean'}, 'tolerance_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Dimensions you read off the user\'s drawing that matter ("hole_diameter 6.5mm ±0.1"). The tightest tolerance prunes vendors that cannot hold it.'}, 'deadline': {'type': 'string', 'description': 'Latest acceptable delivery date, ISO YYYY-MM-DD'}, 'material': {'type': ['string', 'null'], 'description': 'New material for this part ("I need it in PLA" → "pla"). A spec change: lanes requote with this material through warm vendor sessions; an explicit material here replaces the quote\'s material fan-out. Free-form — unstocked asks resolve to the closest stocked material with a substitution note. Do NOT pass material changes as requirements terms. Pass null to REMOVE a previously asked material ("forget the aluminum ask") — the ask comes off the record and the process-default material fan returns'}, 'quote_id': {'type': 'string'}, 'scenario': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'Comparison lane label. A labeled refine sits SIDE BY SIDE with the quote\'s other offers instead of replacing them: refines with the same label replace that scenario, different labels coexist (max 4 per quote), and a refine WITHOUT a scenario resets the baseline and supersedes every lane. "How does X compare to Y?" = one labeled refine per scenario (e.g. scenario "carbon steel" + material "carbon steel", then scenario "aluminum" + material "aluminum"). Keep labels short and human, like "carbon steel"'}, 'food_safe': {'type': 'boolean'}, 'high_temp': {'type': 'boolean'}, 'processes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Narrow this quote to specific fabrication processes ("no, I meant in sheet metal" → ["sheet metal"]). A CONSTRAINT, not a new quote: excluded lanes drop while warm vendor sessions survive, and further refines inherit the filter. Friendly terms accepted ("sheet metal", "3d printing", "cnc", "laser"); pass ["any"] to clear the filter and show every process again. When comparison scenarios are open and the user narrows the process, re-refine EVERY active scenario label with this same arg so all columns prune together'}, 'quantities': {'anyOf': [{'type': 'array', 'items': {'type': 'integer', 'exclusiveMinimum': 0}, 'maxItems': 5}, {'type': 'null'}], 'description': 'New quantities the user wants (spec change — lanes requote at the new quantity). Same rules as on get_fabrication_quote: pass the real ask, never inflate it. Pass null to REMOVE a previously asked quantity — the quote returns to single-part pricing'}, 'ships_from': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Only vendors that ship from these countries/regions ("only US vendors", "just European shops", "keep it domestic") — an INCLUDE list naming where the user DOES want vendors from. A CONSTRAINT like processes: non-matching vendors drop instantly (nothing re-prices), further refines inherit the filter, and ["any"] clears it to show vendors everywhere again. Friendly terms accepted ("US", "Europe", "Germany", "China", "UK"). Vendors whose origin is unknown or whose network is worldwide (a specific origin cannot be guaranteed) are excluded, each with an honest note. For "nothing from X" asks, pass the regions the user does want instead'}, 'sort_label': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Short human wording for a sort_order, displayed on the board ("most green first") — required with sort_order, since only you know what your order means'}, 'sort_order': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200, 'minItems': 1, 'description': 'EXPLICIT card order for asks only you can judge ("sort the most green to the top"): look at the offers\' preview images, decide the order yourself, and pass the offer ids first-on-top. Offers you leave out (including ones that stream in later) land below the listed ones in the default rank. Pass sort_label with it'}, 'ship_to_zip': {'type': 'string', 'pattern': '^\\d{5}(-\\d{4})?$', 'description': 'Destination US ZIP code, exactly as the user stated it — use this when the user provides their ZIP after a quote priced to the assumed central-US destination (routing.ship_to); the refined prices become theirs. NEVER guess or invent a ZIP'}, 'submersible': {'type': 'boolean'}, 'color_shades': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 48, 'minLength': 1}, 'maxItems': 64}, {'type': 'null'}], 'description': 'Narrow the board to these color SHADES exactly as the quote lists them (color_shades_available / "Colors on this board") — instant, nothing re-prices, the same quote id comes back with only those shades; pass null to show every shade again. Never invent a shade name.'}, 'requirements': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 20, 'description': 'Verbatim context terms from the user — materials, finishes, certifications, tolerances ("UV resistant", "anodized: red", "iso 13485", "tolerance: 0.1mm"). UFP applies what it can and reports what it could not; unresolvable terms are logged for vendor sourcing. Do not interrogate the user to fill this — pass what they said.'}, 'thickness_in': {'anyOf': [{'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': 'New sheet thickness in INCHES ("make it in 1/8" → 0.125) — a spec change: sheet lanes requote at the nearest stocked gauge, flagging the substitution when the match isn\'t close. Pass null to REMOVE a previously asked thickness — back to the material\'s default gauge'}, 'outdoor_rated': {'type': 'boolean'}, 'max_budget_usd': {'type': 'number', 'exclusiveMinimum': 0}, 'sort_direction': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Flip a sort_by ordering: "desc" reverses the key\'s natural direction ("most expensive first" = sort_by "price" + "desc"). Only meaningful with sort_by'}, 'undo_last_step': {'type': 'boolean', 'description': 'GO BACK EXACTLY ONE STEP ("undo that", "go back", "put it back how it was"): the network restores the previous quote\'s stored spec and constraints EXACTLY — never reconstructed from conversation — and re-prices where needed. Send it ALONE (no other args besides quote_id); combining it with changes is rejected. The quote\'s steps[] names what each undo would take back — steps[0] is the newest. Undo resets the baseline like any unlabeled refine, so open comparison scenarios close. Undoing the original quote is rejected with honest wording — relay it'}, 'min_vendor_stars': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Only vendors whose displayed review rating is at least this many stars (1-5); vendors with no reviews yet are excluded'}, 'min_vendor_reviews': {'type': 'integer', 'description': 'Only vendors with at least this many verified-purchase reviews', 'exclusiveMinimum': 0}, 'proven_spec_orders': {'type': 'integer', 'description': 'Only vendors with at least N completed orders for this exact process+material — "a vendor that prints PC reliably"', 'exclusiveMinimum': 0}, 'remove_requirements': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 20, 'minItems': 1, 'description': 'Take back INDIVIDUAL requirements terms ("drop the anodized ask, keep the rest"): each listed term is removed from the quote\'s requirements by normalized match, the others stay. Unknown terms are ignored, never an error. Re-stating the requirements list can never drop a term (terms merge as a union) — this is the removal channel'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_id'], 'properties': {'bends': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['line', 'angle_deg', 'direction'], 'properties': {'id': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'line': {'type': 'object', 'required': ['p1', 'p2'], 'properties': {'p1': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'p2': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}}, 'additionalProperties': False}, 'source': {'enum': ['detected', 'user'], 'type': 'string'}, 'face_id': {'type': 'integer'}, 'angle_deg': {'type': 'number', 'exclusiveMaximum': 180, 'exclusiveMinimum': 0}, 'direction': {'enum': ['up', 'down'], 'type': 'string'}, 'radius_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50}], 'description': 'Sheet-metal bend lines, each as TWO POINTS in the part\'s own mm frame (flat DXF parts use z=0: a bend from (0,12.7) to (76.2,12.7) is p1 [0,12.7,0], p2 [76.2,12.7,0]). angle_deg is the target bend angle (90 = a right-angle flange), direction "up"/"down" is the fold direction relative to the flat pattern, radius_mm the requested inside radius (omit it — the shop resolves to its tooling and reports what it used). Pass these when the user articulates WHERE the bends go; a bare "it has 2 bends" is bend_count, not this.'}, {'type': 'null'}], 'description': "New bend records for this part — a spec change: sheet lanes requote with exactly these bends (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: each bend is two points in the part's own mm frame (flat DXF parts use z=0) plus angle_deg, direction up|down, and an optional requested radius_mm. Pass null to REMOVE every articulated bend"}, 'clear': {'type': 'array', 'items': {'enum': ['deadline', 'budget', 'outdoor_rated', 'submersible', 'high_temp', 'food_safe', 'reliability', 'requirements', 'processes', 'ships_from', 'vendors'], 'type': 'string'}, 'minItems': 1, 'description': 'REMOVE constraints entirely ("drop the deadline", "forget the budget", "no more food-safe requirement"): list the constraints to clear and each is removed from the quote — the one deliberate widening besides undo. Clearing a deadline or budget answers instantly from held offers (near-misses convert back); clearing an attribute/reliability/requirements demand re-prices honestly. Same effect as ["any"] on the three filter args, extended to every constraint'}, 'color': {'type': ['string', 'null'], 'description': "New color for this part (spec change — lanes requote). Colour WORDS only ('black', 'green', 'clear'); the network resolves them to each maker's stocked shades, dyes, filaments or coatings — a family word ('blue') brings back EVERY stocked shade of it, and the quote's color_shades_available lists them — never pass a material or a shade you invented. Pass null to REMOVE a previously asked color — back to vendor defaults"}, 'scale': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0.01}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0.01}, 'z': {'type': 'number', 'maximum': 100, 'minimum': 0.01}}, 'description': 'Rescale the DESIGN ITSELF before re-quoting: per-axis stretch factors over the file\'s current geometry ("make it 2x bigger" = {"x":2,"y":2,"z":2}). Mesh designs are genuinely converted — the child quote prices a rescaled file; STEP/IGES designs keep their original file with the dimensions riding as callouts (pass those too). {1,1,1} is a no-op', 'additionalProperties': False}, 'finish': {'type': ['string', 'null'], 'description': 'New surface finish ("powder coat", "anodized", "bead blasted") — a spec change: finish-capable lanes (sheet metal, CNC, metal print) requote WITH it; 3D-print lanes have no coating step, so they ignore the finish but keep the COLOR. A colored finish ask ("black powder coat") should set BOTH finish and color, so every lane lands on the buyer\'s color. Pass null to REMOVE a previously asked finish'}, 'inserts': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['insert', 'thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'insert': {'enum': ['nut', 'flush_nut', 'standoff', 'blind_standoff', 'stud'], 'type': 'string'}, 'points': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'length_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200}], 'description': 'PEM-style hardware inserts pressed into holes of a sheet-metal part — one record per hole. `insert` is the species (nut | flush_nut | standoff | blind_standoff | stud) and `thread` its size ("M4", "1/4-20"); both are required. When known, add length_mm (standoff/stud post length), the hole\'s center (located_at_mm, part\'s own mm frame), its axis, the drilled diameter, and `points` — the signed unit vector the insert\'s functional side faces (flip = negate). Pass these when the user asks for press-in nuts/standoffs/studs; vendors with a hardware service price them.'}, {'type': 'null'}], 'description': 'New hardware-insert records for this part — a spec change: sheet lanes requote with exactly these inserts (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: species (nut|flush_nut|standoff|blind_standoff|stud) and thread required, hole geometry optional. Pass null to REMOVE every insert'}, 'sort_by': {'enum': ['recommended', 'price', 'unit_price', 'total_price', 'arrival', 'rating'], 'type': 'string', 'description': '"Organize by": re-order the quote\'s offer cards ("sort by cheapest" → "price"; "soonest arrival first" → "arrival"; "best rated" → "rating"; "total_price" = part + cheapest shipping; "recommended" restores the default price+speed rank). PURE PRESENTATION — answers instantly on the same quote, never re-prices or drops offers, and the ordering sticks across re-reads, streaming, and later refines until changed'}, 'tapping': {'anyOf': [{'anyOf': [{'not': {}}, {'type': 'array', 'items': {'type': 'object', 'required': ['thread'], 'properties': {'axis': {'type': 'array', 'items': [{'type': 'number'}, {'type': 'number'}, {'type': 'number'}], 'maxItems': 3, 'minItems': 3}, 'hole': {'type': 'integer', 'minimum': 1}, 'thread': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'face_id': {'type': 'integer'}, 'depth_mm': {'type': 'number', 'exclusiveMinimum': 0}, 'located_at_mm': {'type': 'object', 'required': ['x', 'y', 'z'], 'properties': {'x': {'type': 'number'}, 'y': {'type': 'number'}, 'z': {'type': 'number'}}, 'additionalProperties': False}, 'drilled_diameter_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 200}], 'description': 'Tapped (threaded) holes for a sheet-metal part — one record per hole the user wants threads cut into. `thread` is the callout in the user\'s words ("M6", "M4 x 0.7", "1/4-20") and is all that\'s required; when known, add the hole\'s center in the part\'s own mm frame (located_at_mm), its unit axis, the pre-tap drilled diameter, and depth_mm so the shop taps the right hole. Pass these when the user asks for threaded/tapped holes; vendors with a tapping service price them.'}, {'type': 'null'}], 'description': 'New tapped-hole records for this part — a spec change: sheet lanes requote with exactly these taps (the list REPLACES the previous one, never patches it). Same shape as on get_fabrication_quote: thread callout ("M6", "1/4-20") required, hole geometry optional. Pass null to REMOVE every tap'}, 'vendors': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 16, 'description': 'Only these specific vendors/makers ("only show A3D Manufacturing", "just Slant 3D and Fictiv") — an INCLUDE list of vendor names as they appear on offers. A CONSTRAINT like processes: other vendors\' offers drop instantly (nothing re-prices), further refines inherit the filter, and ["any"] clears it to show every vendor again. Friendly names accepted ("A3D", "slant 3d"); unmatched names are reported, never an error. This is THE way to answer "show me everything vendor X offers" — the filtered quote lists that vendor\'s complete lineup'}, 'callouts': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'value', 'unit'], 'properties': {'name': {'type': 'string'}, 'unit': {'enum': ['mm', 'in'], 'type': 'string'}, 'value': {'type': 'number'}, 'critical': {'type': 'boolean'}, 'tolerance_mm': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Dimensions you read off the user\'s drawing that matter ("hole_diameter 6.5mm ±0.1"). The tightest tolerance prunes vendors that cannot hold it.'}, 'deadline': {'type': 'string', 'description': 'Latest acceptable delivery date, ISO YYYY-MM-DD'}, 'material': {'type': ['string', 'null'], 'description': 'New material for this part ("I need it in PLA" → "pla"). A spec change: lanes requote with this material through warm vendor sessions; an explicit material here replaces the quote\'s material fan-out. Free-form — unstocked asks resolve to the closest stocked material with a substitution note. Do NOT pass material changes as requirements terms. Pass null to REMOVE a previously asked material ("forget the aluminum ask") — the ask comes off the record and the process-default material fan returns'}, 'quote_id': {'type': 'string'}, 'scenario': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'Comparison lane label. A labeled refine sits SIDE BY SIDE with the quote\'s other offers instead of replacing them: refines with the same label replace that scenario, different labels coexist (max 4 per quote), and a refine WITHOUT a scenario resets the baseline and supersedes every lane. "How does X compare to Y?" = one labeled refine per scenario (e.g. scenario "carbon steel" + material "carbon steel", then scenario "aluminum" + material "aluminum"). Keep labels short and human, like "carbon steel"'}, 'food_safe': {'type': 'boolean'}, 'high_temp': {'type': 'boolean'}, 'processes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Narrow this quote to specific fabrication processes ("no, I meant in sheet metal" → ["sheet metal"]). A CONSTRAINT, not a new quote: excluded lanes drop while warm vendor sessions survive, and further refines inherit the filter. Friendly terms accepted ("sheet metal", "3d printing", "cnc", "laser"); pass ["any"] to clear the filter and show every process again. When comparison scenarios are open and the user narrows the process, re-refine EVERY active scenario label with this same arg so all columns prune together'}, 'quantities': {'anyOf': [{'type': 'array', 'items': {'type': 'integer', 'exclusiveMinimum': 0}, 'maxItems': 5}, {'type': 'null'}], 'description': 'New quantities the user wants (spec change — lanes requote at the new quantity). Same rules as on get_fabrication_quote: pass the real ask, never inflate it. Pass null to REMOVE a previously asked quantity — the quote returns to single-part pricing'}, 'ships_from': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 8, 'description': 'Only vendors that ship from these countries/regions ("only US vendors", "just European shops", "keep it domestic") — an INCLUDE list naming where the user DOES want vendors from. A CONSTRAINT like processes: non-matching vendors drop instantly (nothing re-prices), further refines inherit the filter, and ["any"] clears it to show vendors everywhere again. Friendly terms accepted ("US", "Europe", "Germany", "China", "UK"). Vendors whose origin is unknown or whose network is worldwide (a specific origin cannot be guaranteed) are excluded, each with an honest note. For "nothing from X" asks, pass the regions the user does want instead'}, 'sort_label': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Short human wording for a sort_order, displayed on the board ("most green first") — required with sort_order, since only you know what your order means'}, 'sort_order': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200, 'minItems': 1, 'description': 'EXPLICIT card order for asks only you can judge ("sort the most green to the top"): look at the offers\' preview images, decide the order yourself, and pass the offer ids first-on-top. Offers you leave out (including ones that stream in later) land below the listed ones in the default rank. Pass sort_label with it'}, 'ship_to_zip': {'type': 'string', 'pattern': '^\\d{5}(-\\d{4})?$', 'description': 'Destination US ZIP code, exactly as the user stated it — use this when the user provides their ZIP after a quote priced to the assumed central-US destination (routing.ship_to); the refined prices become theirs. NEVER guess or invent a ZIP'}, 'submersible': {'type': 'boolean'}, 'color_shades': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 48, 'minLength': 1}, 'maxItems': 64}, {'type': 'null'}], 'description': 'Narrow the board to these color SHADES exactly as the quote lists them (color_shades_available / "Colors on this board") — instant, nothing re-prices, the same quote id comes back with only those shades; pass null to show every shade again. Never invent a shade name.'}, 'requirements': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 20, 'description': 'Verbatim context terms from the user — materials, finishes, certifications, tolerances ("UV resistant", "anodized: red", "iso 13485", "tolerance: 0.1mm"). UFP applies what it can and reports what it could not; unresolvable terms are logged for vendor sourcing. Do not interrogate the user to fill this — pass what they said.'}, 'thickness_in': {'anyOf': [{'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': 'New sheet thickness in INCHES ("make it in 1/8" → 0.125) — a spec change: sheet lanes requote at the nearest stocked gauge, flagging the substitution when the match isn\'t close. Pass null to REMOVE a previously asked thickness — back to the material\'s default gauge'}, 'outdoor_rated': {'type': 'boolean'}, 'max_budget_usd': {'type': 'number', 'exclusiveMinimum': 0}, 'sort_direction': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Flip a sort_by ordering: "desc" reverses the key\'s natural direction ("most expensive first" = sort_by "price" + "desc"). Only meaningful with sort_by'}, 'undo_last_step': {'type': 'boolean', 'description': 'GO BACK EXACTLY ONE STEP ("undo that", "go back", "put it back how it was"): the network restores the previous quote\'s stored spec and constraints EXACTLY — never reconstructed from conversation — and re-prices where needed. Send it ALONE (no other args besides quote_id); combining it with changes is rejected. The quote\'s steps[] names what each undo would take back — steps[0] is the newest. Undo resets the baseline like any unlabeled refine, so open comparison scenarios close. Undoing the original quote is rejected with honest wording — relay it'}, 'min_vendor_stars': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Only vendors whose displayed review rating is at least this many stars (1-5); vendors with no reviews yet are excluded'}, 'min_vendor_reviews': {'type': 'integer', 'description': 'Only vendors with at least this many verified-purchase reviews', 'exclusiveMinimum': 0}, 'proven_spec_orders': {'type': 'integer', 'description': 'Only vendors with at least N completed orders for this exact process+material — "a vendor that prints PC reliably"', 'exclusiveMinimum': 0}, 'remove_requirements': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 20, 'minItems': 1, 'description': 'Take back INDIVIDUAL requirements terms ("drop the anodized ask, keep the rest"): each listed term is removed from the quote\'s requirements by normalized match, the others stay. Unknown terms are ignored, never an error. Re-stating the requirements list can never drop a term (terms merge as a union) — this is the removal channel'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'message'], 'properties': {'message': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': "The user's answer, in their words — it is relayed to the maker"}, 'order_id': {'type': 'string', 'description': 'The UFP order the maker asked about (ord_…)'}}, 'additionalProperties': False}