Turn agent intent into physical parts: engineering review, measured geometry, calibrated pricing.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Compare one exact package projection with every lane in one evidence-bound supplier capability declaration. Returns explicit match, conflict, or unknown checks. Import evidence concerns the drawing associated with the package, not proof that its JSON was received or accepted. It never scores or selects a supplier and grants no contact, quote, purchase, or fabrication authority.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Compare one exact package projection with every lane in one evidence-bound supplier capability declaration. Returns explicit match, conflict, or unknown checks. Import evidence concerns the drawing associated with the package, not proof that its JSON was received or accepted. It never scores or selects a supplier and grants no contact, quote, purchase, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| import_observation | any | |
| package_projection* | object | |
| capability_declaration* | object |
{
"$id": "https://a2a2p.com/schema/supplier-fit",
"type": "object",
"title": "a2a2p supplier fit assessment input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"package_projection",
"capability_declaration"
],
"properties": {
"import_observation": {
"anyOf": [
{
"type": "null"
},
{
"type": "object"
}
]
},
"package_projection": {
"type": "object",
"required": [
"package_sha256",
"process",
"material",
"stock_thickness_mm",
"quantity",
"size_x_mm",
"size_y_mm",
"design_file_format",
"tolerance_class",
"surface_finish",
"ship_to_country"
],
"properties": {
"process": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{0,127}$"
}
]
},
"material": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{0,127}$"
}
]
},
"quantity": {
"anyOf": [
{
"type": "null"
},
{
"type": "integer",
"minimum": 1
}
]
},
"size_x_mm": {
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"exclusiveMinimum": 0
}
]
},
"size_y_mm": {
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"exclusiveMinimum": 0
}
]
},
"package_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"surface_finish": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{0,127}$"
}
]
},
"ship_to_country": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[A-Z]{2}$"
}
]
},
"tolerance_class": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{0,127}$"
}
]
},
"design_file_format": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{0,127}$"
}
]
},
"stock_thickness_mm": {
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"exclusiveMinimum": 0
}
]
}
},
"additionalProperties": false
},
"capability_declaration": {
"type": "object"
}
},
"description": "A deterministic comparison of caller-projected package facts with one evidence-bound supplier capability declaration. It does not select a supplier.",
"additionalProperties": false
}PRECONDITION — CALL ONLY after the requester supplied what the physical object must accomplish at intent.purpose (or requirement). If absent, ask the requester first; never infer purpose and do not invoke this tool yet. Build a synchronous, deterministic supplier request package from the requirement the caller already holds. The package follows the open a2a2p supplier profile and its versioned output schema at https://a2a2p.com/schema/supplier-package, preserves provenance, carries quote-stage screening, and names every quote-critical gap instead of inventing values. Every emitted package carries a reproducible SHA-256 artifact_identity over the exact package content, excluding the identity field itself. The digest proves content identity only; it does not prove supplier receipt, a quote, payment, fabrication, or physical correctness. The package also returns a deterministic quote_stage_eligibility receipt. Quote-stage eligibility lane flat_laser_cut_5052_h32: aluminum_5052_h32, laser_cutting, quantity 1-5, 10-300 mm by 10-300 mm, verified HTTPS DXF, raw finish, no secondary or regulated requirements, US delivery, and total budget up to USD 500. Classification sets no fee and grants no payment, supplier-contact, quote-acceptance, order, or fabrication authority. If no package can be built, MCP and REST share the a2a2p.supplier-package-rejection contract: a closed reason_code, exact vocabulary version, and deterministic next_action only where repair is sufficient. A purpose_required rejection includes an a2a2p.argument-repair operation that preserves the caller's existing arguments, requires the caller's own purpose statement, and forbids inference. An explicit specification.assembly with two or more parts returns decomposition_required and no package; one package represents one fabricated part. This is a stateless data transformation only: it stores no requirement, contacts no supplier or provider, requests no external quote, and creates no order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
Check an asynchronous provider-estimate job created by request_provider_estimate, including its queued or terminal execution substate. Terminal statuses: completed, degraded, refused. An unknown read returns reason_code=unknown_or_not_yet_visible. Retry with backoff only when the id came from an authoritative admitted response; never infer an id after a rejected admission.
| Argument | Type | Description |
|---|---|---|
| quote_job_id* | string | The quote_job_id returned by request_provider_estimate, e.g. QJ-XEQBYMHK. |
{
"type": "object",
"required": [
"quote_job_id"
],
"properties": {
"quote_job_id": {
"type": "string",
"description": "The quote_job_id returned by request_provider_estimate, e.g. QJ-XEQBYMHK."
}
}
}Check the status of a previously submitted physical-solution request. Returns a generated machine draft as soon as it exists, with a versioned delivery receipt that distinguishes pending_machine_draft, generation_failed, generation_expired, machine_draft, and operator_published. The receipt exposes privacy-minimized automatic-generation progress: observed attempt count, fixed maximum, current eligibility, and exact next automatic-attempt time, without model errors or request content. Professional engineering, supplier-quote, and physical-action claims remain false. generation_failed and generation_expired are terminal for that request id and permit only a caller-confirmed new request from caller-held input. For an immutable revision, it also returns its persisted deterministic readiness_progress comparison.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | The request_id returned by request_physical_solution, e.g. A2A2P-7K2M4X. |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"description": "The request_id returned by request_physical_solution, e.g. A2A2P-7K2M4X."
}
}
}Derive one proposal-only prismatic rectangular beam height from a caller-declared purpose, supported idealized load model, fixed width, explicit elastic modulus, and at least one requester acceptance criterion. The operation solves closed-form equations, rounds upward to the caller's manufacturing increment, and re-runs the canonical bounded evaluator. It performs no general optimization, material selection, network call, supplier contact, persistence, purchase, or fabrication and grants no engineering or physical authority.
| Argument | Type | Description |
|---|---|---|
| model* | any | |
| load_n* | number | |
| purpose* | string | |
| span_mm* | number | |
| section_width_mm* | number | |
| max_deflection_mm* | any | |
| elastic_modulus_gpa* | number | |
| allowable_stress_mpa* | any |
Evaluate 2 to 12 caller-declared rectangular beam widths through the canonical bounded height derivation, then return every proposal and the exact non-dominated frontier for minimizing section height and idealized prismatic material volume. Width order is normalized; duplicates fail closed. The operation never invents a width, assigns an aggregate score, selects a candidate, estimates material cost, verifies manufacturing or omitted failure modes, calls an external system, or grants engineering, purchase, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| model* | any | |
| load_n* | number | |
| purpose* | string | |
| span_mm* | number | |
| max_deflection_mm* | any | |
| elastic_modulus_gpa* | number | |
| allowable_stress_mpa* | any | |
| section_width_options_mm* | array |
Instant, synchronous pricing and lead time for a physical requirement — nothing is submitted or stored. Returns a deterministic parametric estimate (source="estimate", pricing_kind="model_estimate", clearly labeled, never presented as a quote). The protocol separately labels provider_estimate and provider_quote; public provider routing is not active. An explicit specification.assembly with two or more parts returns decomposition_required before file inspection or pricing; submit each fabricated part separately. Covers CNC machining, sheet metal, 3D printing, casting, injection molding, and extrusion. ATTACH AN STL in specification.design_files and a2a2p measures the mesh directly — true volume, surface area, bounding box — which replaces guesswork with measurement and returns manufacturability findings only geometry reveals. Otherwise supply intent.geometric_envelope (bounding box in mm), quantity, and material. Use this to answer "what will this cost and how long will it take?" inside a single session, before committing to a full resolution report.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
Create a genuinely millimetre-scaled derivative from an active temporary binary STL whose exporter is known to emit metre coordinates. The operation never guesses units from a filename or plausible size. It requires the exact source SHA-256, an exporter statement tied to a named system and revision, and a separate expected-envelope check. It preserves the source, stores the derivative under a new one-hour file_reference, and returns separate source and derivative hashes. Conversion only: no supplier selection, quote request, order, payment, fabrication, or external contact occurs.
| Argument | Type | Description |
|---|---|---|
| validation* | object | |
| source_units* | string | |
| target_units* | string | |
| source_sha256* | string | SHA-256 of the exact uploaded source STL bytes. |
| unit_evidence* | object | |
| file_reference* | object |
{
"type": "object",
"required": [
"file_reference",
"source_sha256",
"source_units",
"target_units",
"unit_evidence",
"validation"
],
"properties": {
"validation": {
"type": "object",
"required": [
"expected_bounding_box_mm",
"tolerance_mm"
],
"properties": {
"tolerance_mm": {
"type": "number",
"minimum": 0
},
"expected_bounding_box_mm": {
"type": "object",
"required": [
"x",
"y",
"z"
],
"properties": {
"x": {
"type": "number",
"exclusiveMinimum": 0
},
"y": {
"type": "number",
"exclusiveMinimum": 0
},
"z": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"source_units": {
"type": "string",
"const": "m"
},
"target_units": {
"type": "string",
"const": "mm"
},
"source_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of the exact uploaded source STL bytes."
},
"unit_evidence": {
"type": "object",
"required": [
"basis",
"source_system",
"source_revision",
"export_operation",
"statement"
],
"properties": {
"basis": {
"enum": [
"producer_declaration",
"exporter_contract",
"verified_export_run"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"source_system": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"source_revision": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"export_operation": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
},
"file_reference": {
"type": "object",
"required": [
"url",
"format",
"role"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https://(?:www\\.)?a2a2p\\.com/file/f-[a-z0-9]{8,16}$"
},
"role": {
"type": "string",
"const": "geometry"
},
"format": {
"type": "string",
"const": "stl"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Plan the evidence needed to transform a validated material source observation into a future material-property-evidence input. Deterministic and stateless: it compares exact property, material-state, orientation, temperature, and process context; binds source, target, and planner digests; and names conflicts plus missing method, uncertainty, freshness, and excerpt evidence. It never promotes the observation, creates simulation input, calls a model or solver, contacts a supplier/provider, or grants engineering, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| target* | object | |
| observation* | object |
{
"type": "object",
"required": [
"observation",
"target"
],
"properties": {
"target": {
"type": "object",
"required": [
"property",
"material_state",
"applicability"
],
"properties": {
"property": {
"type": "object",
"required": [
"quantity",
"value",
"unit"
],
"properties": {
"unit": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"value": {
"type": "number"
},
"quantity": {
"type": "string",
"pattern": "\\S",
"minLength": 1
}
},
"additionalProperties": false
},
"applicability": {
"type": "object",
"required": [
"temperature_c",
"orientation",
"manufacturing_process"
],
"properties": {
"orientation": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"temperature_c": {
"type": "number"
},
"manufacturing_process": {
"type": "string",
"pattern": "\\S",
"minLength": 1
}
},
"additionalProperties": false
},
"material_state": {
"type": "object",
"required": [
"name",
"grade",
"condition",
"product_form"
],
"properties": {
"name": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"grade": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"condition": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"product_form": {
"type": "string",
"pattern": "\\S",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"observation": {
"$id": "https://a2a2p.com/schema/material-source-observation",
"type": "object",
"title": "a2a2p material source observation",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$comment": "JSON Schema constrains the reusable envelope. Consumers must also run the semantic validator for digest/page binding, applicability consistency, verification support, and the non-authority boundary.",
"required": [
"contract",
"contract_version",
"state",
"license",
"observation_id",
"source",
"reported_claim",
"applicability",
"claim_limits",
"source_caveat",
"authority"
],
"properties": {
"state": {
"const": "source_observed"
},
"source": {
"type": "object",
"required": [
"publisher",
"document_id",
"title",
"landing_url",
"download_url",
"media_type",
"bytes",
"sha256",
"pdf_page",
"embedded_record",
"retrieval"
],
"properties": {
"bytes": {
"type": "integer",
"minimum": 1
},
"title": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"pdf_page": {
"type": "integer",
"minimum": 1
},
"publisher": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"retrieval": {
"type": "object",
"required": [
"retrieved_at",
"file_signature_verified",
"document_bytes_verified",
"observed_page_text_extracted",
"runtime_retrieval"
],
"properties": {
"retrieved_at": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"runtime_retrieval": {
"type": "boolean"
},
"document_bytes_verified": {
"type": "boolean"
},
"file_signature_verified": {
"type": "boolean"
},
"observed_page_text_extracted": {
"type": "boolean"
}
},
"additionalProperties": false
},
"media_type": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"document_id": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"landing_url": {
"type": "string",
"format": "uri",
"pattern": "\\S",
"minLength": 1
},
"download_url": {
"type": "string",
"format": "uri",
"pattern": "\\S",
"minLength": 1
},
"embedded_record": {
"type": "object",
"required": [
"system",
"record",
"printed_on",
"source_figure",
"heading"
],
"properties": {
"record": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"system": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"heading": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"printed_on": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"source_figure": {
"type": "string",
"pattern": "\\S",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"license": {
"const": "CC0-1.0"
},
"contract": {
"const": "a2a2p.material-source-observation"
},
"authority": {
"type": "object",
"required": [
"candidate_selection",
"engineering_validation",
"design_certification",
"safety_approval",
"supplier_contact",
"order",
"payment",
"fabrication"
],
"properties": {
"order": {
"const": false
},
"payment": {
"const": false
},
"fabrication": {
"const": false
},
"safety_approval": {
"const": false
},
"supplier_contact": {
"const": false
},
"candidate_selection": {
"const": false
},
"design_certification": {
"const": false
},
"engineering_validation": {
"const": false
}
},
"additionalProperties": false
},
"claim_limits": {
"type": "object",
"required": [
"source_document_identity_verified",
"reported_value_transcribed",
"source_claim_independently_reproduced",
"independent_physical_measurement",
"actual_material_identity_verified",
"temperature_applicability_established",
"design_allowable_claimed",
"engineering_validation",
"design_certification",
"physical_truth"
],
"properties": {
"physical_truth": {
"const": false
},
"design_certification": {
"const": false
},
"engineering_validation": {
"const": false
},
"design_allowable_claimed": {
"const": false
},
"reported_value_transcribed": {
"type": "boolean"
},
"independent_physical_measurement": {
"const": false
},
"actual_material_identity_verified": {
"const": false
},
"source_document_identity_verified": {
"type": "boolean"
},
"source_claim_independently_reproduced": {
"const": false
},
"temperature_applicability_established": {
"const": false
}
},
"additionalProperties": false
},
"applicability": {
"type": "object",
"required": [
"established",
"not_established",
"simulation_eligible",
"reason"
],
"properties": {
"reason": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"established": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"uniqueItems": true
},
"not_established": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"uniqueItems": true
},
"simulation_eligible": {
"const": false
}
},
"additionalProperties": false
},
"source_caveat": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"observation_id": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"reported_claim": {
"type": "object",
"required": [
"quantity",
"value",
"unit",
"source_notation",
"orientation",
"material_state",
"value_present_on_observed_page"
],
"properties": {
"unit": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"value": {
"type": "number"
},
"quantity": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"orientation": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"material_state": {
"type": "object",
"required": [
"common_name",
"condition",
"product_form",
"thickness_range",
"specifications",
"stated_basis"
],
"properties": {
"condition": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"common_name": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"product_form": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"stated_basis": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"specifications": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"uniqueItems": true
},
"thickness_range": {
"type": "object",
"required": [
"min",
"max",
"unit"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"unit": {
"type": "string",
"pattern": "\\S",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"source_notation": {
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"type": "string",
"pattern": "\\S",
"minLength": 1
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
"value_present_on_observed_page": {
"type": "boolean"
}
},
"additionalProperties": false
},
"contract_version": {
"const": "0.2.0-draft"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Compile one exact replay-verified rectangular-beam derivation into a prepared bounded simulation study. The caller must supply the original derivation input and receipt, its exact validation receipt, simulation-eligible source-bound material evidence matching the modulus, an objective, source freshness, and a physical validation plan. The compiler replays first, derives a stable candidate ID, repeats deterministic review, preserves requester criteria as hard gates, and publishes omitted failure modes. It never chooses material or objective, verifies physical truth, runs a solver, stores data, contacts a supplier, or grants physical authority.
| Argument | Type | Description |
|---|---|---|
| objectives* | array | |
| source_metadata* | object | |
| derivation_input* | object | |
| derivation_receipt* | object | |
| derivation_validation* | object | Exact output returned by validate_rectangular_beam_section_derivation for the same input and receipt. Runtime replay and full canonical comparison are authoritative. |
| physical_validation_plan* | array | |
Prepare a synchronous, deterministic, privacy-minimized engineering case for a compatible domain-intelligence system. Use it when intake_classification is capability_concept or assembly_or_system and mechanism selection or decomposition is required, or when a complete single-part intent has no specifications and review offers the design_brief continuation. The case preserves requester facts, deterministic evidence, screening state, unknowns, and a versioned candidate-output contract while removing design-file URLs, bytes, contact fields, and callback routes. This operation does not call deb8stack or any model, choose a mechanism, validate a proposal, store a request, contact a supplier, or grant quote, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
Compile one caller-selected domain-solutioning candidate into a prepared bounded beam simulation study after repeating deterministic engineering review. The requirement must explicitly state the supported load model, geometry, load, and elastic modulus; the caller must state the objective, source freshness, and physical validation plan. Optional material_property_evidence content-addresses an exact engineering datasheet or measurement with material state, applicability, method, and uncertainty; its value must match the requirement. Semantic placeholders such as unknown, unspecified, n/a, or tbd cannot make material state or applicability simulation-eligible. Computed-crystal evidence remains screening/reference-only because this scalar product model cannot preserve its tensor, orientation, grade, condition, or product-form boundary. Requester limits become hard constraints. It never verifies a source claim, selects a candidate, invents physics, runs a solver, stores data, contacts a supplier, or grants physical authority.
| Argument | Type | Description |
|---|---|---|
| objectives* | array | |
| requirement* | object | |
| candidate_id* | string | |
| source_metadata* | object | |
| simulation_handoff* | object | |
| physical_validation_plan |
Prepare a deterministic, side-effect-free simulation study for existing a2a2p domain-solutioning candidate IDs. It records exact quantities, units, closed-kind source snapshots with staleness intervals, hard constraints, solver/model/settings provenance, assumptions, validity domain, and a physical validation plan. It runs no solver, chooses no candidate, stores nothing, and grants no physical authority.
| Argument | Type | Description |
|---|---|---|
| source* | any | |
| objectives* | array | |
| experiments* | array | |
| candidate_ids* | array | |
| hard_constraints* | array |
{
"type": "object",
"required": [
"source",
"candidate_ids",
"objectives",
"hard_constraints",
"experiments"
],
"properties": {
"source": {
"oneOf": [
{
"$ref": "#/$defs/domainCandidateSource"
},
{
"$ref": "#/$defs/derivedBeamCandidateSource"
}
]
},
"objectives": {
"type": "array",
"items": {
"$ref": "#/$defs/objective"
},
"maxItems": 32,
"minItems": 1
},
"experiments": {
"type": "array",
"items": {
"$ref": "#/$defs/experiment"
},
"maxItems": 32,
"minItems": 1
},
"candidate_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 32,
"minItems": 1,
"uniqueItems": true
},
"hard_constraints": {
"type": "array",
"items": {
"$ref": "#/$defs/hardConstraint"
},
"maxItems": 64
}
},
"additionalProperties": false
}Submit one real, unaffiliated low-voltage outdoor sensor enclosure need to A2A2P's ten-submission qualification cohort. Complete outside submissions are stored privately; public evidence remains content-free. This contacts no supplier, collects no payment, places no order, performs no engineering validation, and grants no fabrication authority.
| Argument | Type | Description |
|---|---|---|
| need* | object | |
| buyer* | object | |
| scope* | object | |
| contact* | object | |
| evidence* | object | |
| authority* | object | |
| commercial* | object | |
| candidate_lane | any |
{
"$id": "https://a2a2p.com/schema/specification-exchange-demand-probe",
"type": "object",
"title": "A2A2P specification-to-manufacturing demand probe",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"buyer",
"need",
"scope",
"authority",
"commercial",
"contact",
"evidence"
],
"properties": {
"need": {
"type": "object",
"required": [
"business_purpose",
"current_need",
"current_approach",
"why_catalog_is_not_enough",
"catalog_selection_is_sufficient",
"component_state",
"components",
"operating_environment",
"quantity",
"needed_by",
"manufacturing_budget_usd",
"measurable_use_test"
],
"properties": {
"quantity": {
"type": "integer",
"minimum": 1
},
"needed_by": {
"type": "string",
"minLength": 3
},
"components": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"part_number"
]
},
{
"required": [
"dimensions"
]
}
],
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 3
},
"dimensions": {
"type": "string",
"minLength": 3
},
"part_number": {
"type": "string",
"minLength": 3
}
},
"additionalProperties": false
},
"minItems": 1
},
"current_need": {
"type": "boolean"
},
"component_state": {
"enum": [
"selected",
"prototyped",
"physically_possessed"
]
},
"business_purpose": {
"type": "string",
"minLength": 3
},
"current_approach": {
"type": "string",
"minLength": 3
},
"measurable_use_test": {
"type": "string",
"minLength": 3
},
"operating_environment": {
"type": "string",
"minLength": 3
},
"manufacturing_budget_usd": {
"type": "number",
"exclusiveMinimum": 0
},
"why_catalog_is_not_enough": {
"type": "string",
"minLength": 3
},
"catalog_selection_is_sufficient": {
"type": "boolean"
}
},
"additionalProperties": false
},
"buyer": {
"type": "object",
"required": [
"organization",
"role"
],
"properties": {
"role": {
"type": "string",
"minLength": 3
},
"organization": {
"type": "string",
"minLength": 3
}
},
"additionalProperties": false
},
"scope": {
"type": "object",
"required": [
"low_voltage",
"life_safety",
"medical",
"hazardous_location",
"surveillance_of_people",
"certification_required_before_use"
],
"properties": {
"medical": {
"type": "boolean"
},
"life_safety": {
"type": "boolean"
},
"low_voltage": {
"type": "boolean"
},
"hazardous_location": {
"type": "boolean"
},
"surveillance_of_people": {
"type": "boolean"
},
"certification_required_before_use": {
"type": "boolean"
}
},
"additionalProperties": false
},
"contact": {
"type": "object",
"required": [
"permission_for_this_submission",
"return_channel"
],
"properties": {
"return_channel": {
"type": "string",
"minLength": 3
},
"permission_for_this_submission": {
"type": "boolean"
}
},
"additionalProperties": false
},
"evidence": {
"type": "object",
"required": [
"unaffiliated_outside_submission"
],
"properties": {
"unaffiliated_outside_submission": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authority": {
"type": "object",
"required": [
"can_approve_specification",
"can_authorize_supplier_order",
"can_authorize_spending"
],
"properties": {
"can_authorize_spending": {
"type": "boolean"
},
"can_approve_specification": {
"type": "boolean"
},
"can_authorize_supplier_order": {
"type": "boolean"
}
},
"additionalProperties": false
},
"commercial": {
"type": "object",
"required": [
"accepts_5_percent_success_commission"
],
"properties": {
"accepts_5_percent_success_commission": {
"type": "boolean"
}
},
"additionalProperties": false
},
"candidate_lane": {
"enum": [
"low_voltage_outdoor_sensor_enclosure"
]
}
},
"description": "Submits one real low-voltage outdoor sensor enclosure need in the private ten-submission first-wedge qualification cohort. It contacts no supplier, charges nothing, places no order, and grants no authority.",
"additionalProperties": false
}Render the caller's requirement as a reviewable RFC 5322 supplier-email draft after rebuilding its canonical supplier package and repeating quote-stage screening. The plain-language draft offers optional Can quote / Need changes / Decline reply choices and asks for price basis, freight scope, and lead-time basis when quoting. Suppliers may still reply in normal prose. Only an allow verdict renders. The operation validates one explicit recipient and an accountable sender-domain envelope, but cannot verify SPF, DKIM, or DMARC and therefore returns sendable=false. An explicit specification.assembly with two or more parts returns decomposition_required before file inspection or rendering. It is a stateless artifact transformation only: it stores nothing, sends nothing, contacts no supplier or provider, and grants no quote, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string |
Submit a physical-world requirement (a part, product, device, or capability that must exist in the physical world). a2a2p resolves it and returns a RESOLUTION REPORT: a recommended path (best existing commercial solution vs. custom fabrication), pricing, tradeoffs, a delivery plan with contingencies and expedite options, and a business case when business context is provided. Response is asynchronous: you receive a request_id immediately with an instant spec_review. Poll check_request_status; as soon as an automated draft exists it is returned with an a2a2p.resolution-report-delivery receipt that distinguishes machine_draft from operator_published. If the finite attempt budget is exhausted, status returns generation_failed; if the bounded automatic retry window expires first, it returns generation_expired. Either terminal state permits only a new caller-confirmed request from caller-held input. Operator review and publication are not guaranteed or subject to a service-level promise. No state is professional engineering certification or a supplier quote. ENTRY MODES — arrive with what you have: • fully_specified: provide 'specification' (part_type, material, process, dimensions, tolerance_class, design_files). Go straight to resolution report. • intent_only: provide 'intent' (purpose, environment, functional_requirements, quantity, timeline, priority). a2a2p recommends 2-3 specification options with tradeoffs. • partial: provide what you know in either layer; a2a2p fills the gaps. Layer 1 (intent) describes the PROBLEM. Layer 2 (specification) describes the SOLUTION. At minimum, provide 'requirement' (legacy) or 'intent.purpose' (structured) — one line describing what you need. Use 'rejected_alternatives' to record options already ruled out.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
Submit a requirement to the durably queued provider-estimate workflow without holding the connection open. Returns a quote_job_id in milliseconds; scheduled settlement runs outside request waitUntil. Scheduled provider contact is not active in this release and cannot be enabled by an environment flag, so admitted jobs currently terminate as degraded with a deterministic model estimate. Additive processes with an STL design file only, for now. The requirement is screened before storage; any future provider activation must also screen the exact file bytes before contact. Every admission result is machine-readable. Rejections carry a stable closed-set reason_code, retry boundary, required input, and deterministic next_action; admitted responses carry the same versioned admission contract. An explicit specification.assembly with two or more parts is rejected before job creation or provider contact and must be decomposed first. Estimate only — never a quote, order, payment, or fabrication commitment. Poll with check_quote_job until a terminal status: completed (provider figure), degraded (deterministic model estimate with the provider's absence explained), or refused (screening).
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd |
Current file inspection governs geometry readiness: expired, unreadable, mismatched, unsuccessfully parsed or uninspected attachments prevent quote-ready status. Reattach the original file and review again. Instant, synchronous engineering review of a physical requirement — nothing is submitted. So the caller can continue in deb8, the answer may carry a continuation: the purpose and the details sent, held under its reference for 24 hours and then deleted, read only by deb8's server when the caller continues there. Purpose prose is preserved as intent but is not silently converted into loads, geometry, environments, interfaces, or acceptance criteria. The versioned engineering_evaluation receipt lists canonical paths and exact checks run, reports not_evaluated when none ran, and denies engineering-validation, certification, physical-truth, supplier-acceptance, and fabrication authority. Its finding-penalty score is not engineering soundness. Deterministic checks: material identification with handbook-typical properties (density, stiffness, yield, service temperature), explicit rectangular beam deflection, nominal bending stress, and nominal transverse shear with requester-defined acceptance criteria, material/process compatibility, tolerance-vs-process reality, quantity economics (e.g. tooling amortization), environment fit (UV, saltwater, food contact, temperature, medical), flexibility fit, post-processing validity, design-file format fit, and specification completeness. Every matched material reference identifies the current table as an uncited compilation and explicitly denies source verification, exact-state verification, design-allowable use, and simulation eligibility. A criterion that depends on that reference remains not_evaluated; its numerical comparison is reference_only, never a pass, failure, or blocker. Every supplied limit or strength basis is labeled requester_assertion, and every criterion verdict is explicitly conditional on declared inputs and the bounded model—not engineering validation or design certification. Returns findings ranked blocker/warning/info, two readiness scores, and a deterministic clarification_plan: compact next_fields, visible remaining_fields, optional CAD accelerators, an intent-only resolution handoff, next_call with the recommended exact MCP/REST continuation, and continuation_options for explicitly eligible operations: design_brief for complete intent without specifications, or budgetary_pricing and supplier_handoff for a complete specification. Examples are shapes, never invented defaults. For a decomposed design, send specification.assembly with parts and interfaces: a2a2p then checks galvanic pairing and interface fit across parts, which a single-part review cannot, and prices each part separately. Two or more explicitly declared parts always classify as assembly_or_system and can never become quote_ready as one part, regardless of purpose wording or top-level part fields. Undeclared interfaces are unchecked — nothing is inferred. CHECK intake_classification first. a2a2p reviews one manufacturable part at a time; a request naming a behaviour rather than an object ("a device that detects and removes debris") is classified capability_concept and redirected to decomposition, because no material or tolerance can be derived from it. The classification is advisory, never blocks, and defers to any supplied specification. READ resolution_readiness, not quote_readiness, while you are still answering questions. quote_readiness is supplier-facing and stays capped by material/process/dimensions/tolerance that a2a2p derives for you, so it cannot reach quote_ready from intent alone however much you supply. resolution_readiness measures only what the requester owns and reaches ready_to_resolve once you have supplied enough to derive a specification — which is not a supplier quote. completeness.awaiting_requester and completeness.derivable_by_resolution say which fields are whose. Accepts the same input as request_physical_solution (structured intent/specification or legacy flat fields). Forward-compatible fields remain accepted, but uninterpreted_fields names every supplied path in the declared review scope whose value did not influence deterministic engineering checks, uses bounded and privacy-safe RFC 6901 JSON Pointers, caps unqualified ready grades, and provides non-inferential repair guidance; never read HTTP success alone as proof that every field was understood. For intent_only, complete requester context leads to submit_for_specification_resolution; for a supplied specification, apply only facts you know, re-review until quote_ready, then submit if a durable resolution is useful. Error results preserve the human-readable error and also return one stable machine code: purpose_required when the physical purpose is absent, or screening_denied when intake screening refuses the request. Modern MCP responses carry the same object in structuredContent. Multi-part input is reviewed and classified here; decomposition_required belongs to downstream one-part pricing and supplier-package gates, not this advisory review.
Create a new, immutable revision of a prior request by applying only the fields you learned since the first submission. Use this after review_specification returns a clarification_plan: provide the original request_id plus the patch (for example intent.geometric_envelope or specification.material). The original is preserved; the revision receives a new request_id, a fresh spec_review, a revision_of link, and a deterministic readiness_progress comparison against its immediate predecessor. Provide idempotency_key when retrying the same patch so a network retry returns the same revision instead of creating another.
| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| request_id* | string | The prior request_id to revise. |
| constraints | string |
Execute and validate a prepared simulation study through a2a2p's bounded closed-form rectangular-beam adapter. The adapter accepts only explicit load, span, section width/height, elastic modulus, exact support conditions, and supported output quantities; missing, extra, mismatched, or unsupported settings fail the affected experiment closed. It returns provenance-bound predictions and the existing hard-constraint/Pareto validation in one stateless call. It is not FEA, physical measurement, engineering validation, candidate selection, supplier contact, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| study* | object |
{
"type": "object",
"required": [
"study"
],
"properties": {
"study": {
"type": "object"
}
},
"additionalProperties": false
}Translate one bounded, caller-supplied Materials Project elasticity API response projection into source-bound computed-crystal reference evidence. Optional retrieval metadata binds the raw upstream bytes separately and records that an allowlisted projection changed the representation. The adapter verifies response shape, one exact material ID, non-deprecated successful state, modulus bounds, Poisson consistency, source versions, and record license; derives an isotropic VRH Young's modulus deterministically; and preserves warnings. It performs no network call, does not verify Materials Project origin, and grants no engineering-product, simulation-input, supplier, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| response* | object | |
| retrieval* | any | |
| material_id* | string | |
| refresh_after* | string |
{
"$id": "https://a2a2p.com/schema/materials-project-elasticity",
"type": "object",
"title": "a2a2p Materials Project elasticity adapter",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"material_id",
"response",
"retrieval",
"refresh_after"
],
"properties": {
"response": {
"type": "object",
"required": [
"data",
"errors",
"meta"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"builder_meta",
"material_id",
"formula_pretty",
"deprecated",
"deprecation_reasons",
"last_updated",
"warnings",
"bulk_modulus",
"shear_modulus",
"universal_anisotropy",
"homogeneous_poisson",
"fitting_method",
"state"
],
"properties": {
"state": {
"const": "successful"
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"maxItems": 100
},
"deprecated": {
"const": false
},
"material_id": {
"type": "string",
"pattern": "^mp-[A-Za-z0-9]+$"
},
"builder_meta": {
"type": "object",
"required": [
"emmet_version",
"pymatgen_version",
"run_id",
"batch_id",
"database_version",
"build_date",
"license"
],
"properties": {
"run_id": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"license": {
"enum": [
"BY-C",
"BY-NC"
]
},
"batch_id": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"build_date": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"emmet_version": {
"type": "string",
"minLength": 1
},
"database_version": {
"type": "string",
"minLength": 1
},
"pymatgen_version": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"bulk_modulus": {
"type": "object",
"required": [
"voigt",
"reuss",
"vrh"
],
"properties": {
"vrh": {
"type": "number",
"exclusiveMinimum": 0
},
"reuss": {
"type": "number",
"exclusiveMinimum": 0
},
"voigt": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"last_updated": {
"type": "string",
"format": "date-time"
},
"shear_modulus": {
"type": "object",
"required": [
"voigt",
"reuss",
"vrh"
],
"properties": {
"vrh": {
"type": "number",
"exclusiveMinimum": 0
},
"reuss": {
"type": "number",
"exclusiveMinimum": 0
},
"voigt": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"fitting_method": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"formula_pretty": {
"type": "string",
"minLength": 1
},
"deprecation_reasons": {
"type": [
"array",
"null"
],
"maxItems": 0
},
"homogeneous_poisson": {
"type": "number",
"exclusiveMaximum": 0.5,
"exclusiveMinimum": -1
},
"universal_anisotropy": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 1,
"minItems": 1
},
"meta": {
"type": "object",
"required": [
"api_version",
"time_stamp",
"total_doc"
],
"properties": {
"total_doc": {
"const": 1
},
"time_stamp": {
"type": "string",
"format": "date-time"
},
"api_version": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"errors": {
"oneOf": [
{
"type": "null"
},
{
"type": "array",
"maxItems": 0
}
]
}
},
"additionalProperties": false
},
"retrieval": {
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"client_contract",
"source_url",
"raw_response_sha256",
"projection"
],
"properties": {
"projection": {
"type": "object",
"required": [
"document_fields",
"response_meta_fields",
"changes_indicated"
],
"properties": {
"document_fields": {
"const": [
"builder_meta",
"material_id",
"formula_pretty",
"deprecated",
"deprecation_reasons",
"last_updated",
"warnings",
"bulk_modulus",
"shear_modulus",
"universal_anisotropy",
"homogeneous_poisson",
"fitting_method",
"state"
]
},
"changes_indicated": {
"const": true
},
"response_meta_fields": {
"const": [
"api_version",
"time_stamp",
"total_doc"
]
}
},
"additionalProperties": false
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https://api\\.materialsproject\\.org/materials/elasticity/\\?"
},
"client_contract": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"raw_response_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
]
},
"material_id": {
"type": "string",
"pattern": "^mp-[A-Za-z0-9]+$"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"description": "Translate one bounded caller-supplied Materials Project elasticity response projection into computed-crystal reference evidence. Optional caller retrieval metadata binds the raw upstream digest separately. The public adapter performs no upstream network request.",
"additionalProperties": false
}Turn local manufacturing file bytes into the temporary HTTPS reference used by specification.design_files. This is a bounded intake operation, not a request, provider call, quote, order, payment, or fabrication action. Common RFC 4648 transport forms are normalized, then decoded bytes are recognized by signature, checked against the declared format, screened before storage, retained for one hour, and never included in telemetry. Supported roles include geometry (STL/STEP) and drawings (DXF/PDF). The 2 MiB MCP ceiling is transport-specific; use POST /api/upload with purpose=manufacturing_design_file for files up to 8 MiB. Pass the returned file_reference object unchanged in specification.design_files on the next call.
| Argument | Type | Description |
|---|---|---|
| format* | string | Declared manufacturing format. File bytes must match. |
| purpose* | string | Must be manufacturing_design_file; general chat attachments use a separate intake. |
| filename* | string | Original filename, used only for bounded inspection and the temporary record. |
| content_base64* | string | File bytes as RFC 4648 base64 or base64url; padding is optional, ASCII whitespace and a bounded data:*;base64, prefix are accepted. Do not pass a path or URL. Decoded maximum: 2097152 bytes. |
{
"type": "object",
"required": [
"purpose",
"filename",
"format",
"content_base64"
],
"properties": {
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string",
"description": "Declared manufacturing format. File bytes must match."
},
"purpose": {
"type": "string",
"const": "manufacturing_design_file",
"description": "Must be manufacturing_design_file; general chat attachments use a separate intake."
},
"filename": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Original filename, used only for bounded inspection and the temporary record."
},
"content_base64": {
"type": "string",
"maxLength": 2870046,
"description": "File bytes as RFC 4648 base64 or base64url; padding is optional, ASCII whitespace and a bounded data:*;base64, prefix are accepted. Do not pass a path or URL. Decoded maximum: 2097152 bytes."
}
},
"additionalProperties": false
}Re-run the exact Domain Solutioning case/result validation, then validate one caller-supplied Actualization Plan. Checks typed entity references, evidence references, decision cycles, source binding, and false authority. Success returns evidence linkage plus exact review_specification calls for unblocked fabricated parts, copied only from each caller-authored function and specification_patch. Rejection can append a tamper-evident correction entry to caller-held history. Stores, edits, and executes nothing; calls no model, provider, or supplier; grants no physical authority.
| Argument | Type | Description |
|---|---|---|
| case* | object | |
| plan* | object | A portable, non-authorizing projection of one validated domain-solutioning candidate into named physical-work entities. It is not a generic graph ontology. |
| result* | object | |
| correction_history | array |
{
"type": "object",
"required": [
"case",
"result",
"plan"
],
"properties": {
"case": {
"type": "object"
},
"plan": {
"$id": "https://a2a2p.com/schema/actualization-plan",
"type": "object",
"$defs": {
"source": {
"type": "object",
"required": [
"validation_contract",
"validation_contract_version",
"case_digest",
"candidate_result_digest",
"candidate_id"
],
"properties": {
"case_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"candidate_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"validation_contract": {
"const": "a2a2p.domain-solutioning-result-validation"
},
"candidate_result_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"validation_contract_version": {
"const": "0.5.0-draft"
}
},
"additionalProperties": false
},
"assembly": {
"type": "object",
"required": [
"id",
"purpose",
"member_ids",
"requires_decision_ids",
"evidence_ids"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"purpose": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"member_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"requires_decision_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"decision": {
"type": "object",
"required": [
"id",
"question",
"disposition",
"requires_decision_ids",
"evidence_ids",
"overturn_if"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"question": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"disposition": {
"enum": [
"proposed",
"blocked"
]
},
"overturn_if": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 20
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"requires_decision_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"evidence": {
"type": "object",
"required": [
"evidence_id",
"kind",
"claim",
"locator",
"source_digest"
],
"properties": {
"kind": {
"enum": [
"requester_fact",
"deterministic_calculation",
"cited_source",
"supplier_statement",
"simulation_result",
"physical_measurement",
"model_claim",
"human_judgment"
]
},
"claim": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"locator": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"evidence_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"source_digest": {
"type": [
"string",
"null"
],
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"interface": {
"type": "object",
"required": [
"id",
"participant_ids",
"requirement",
"verification_step_ids",
"evidence_ids"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"requirement": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"participant_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 20,
"minItems": 2,
"uniqueItems": true
},
"verification_step_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"fabricated_part": {
"type": "object",
"required": [
"id",
"function",
"specification_patch",
"requires_decision_ids",
"evidence_ids",
"unknowns"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"function": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"unknowns": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 20
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"specification_patch": {
"type": "object"
},
"requires_decision_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"bought_component": {
"type": "object",
"required": [
"id",
"function",
"specification",
"requires_decision_ids",
"evidence_ids",
"unknowns"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"function": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"unknowns": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 20
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"specification": {
"type": "object"
},
"requires_decision_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"supplier_handoff": {
"type": "object",
"required": [
"id",
"subject_ids",
"requires_verification_step_ids",
"state",
"evidence_ids"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"state": {
"const": "proposed"
},
"subject_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"requires_verification_step_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
},
"verification_step": {
"type": "object",
"required": [
"id",
"subject_ids",
"method",
"acceptance_criterion",
"requires_evidence_ids"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"method": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"subject_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
},
"acceptance_criterion": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"requires_evidence_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._:-]{0,127}$"
},
"maxItems": 100,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"title": "a2a2p Actualization Plan",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contract",
"contract_version",
"source",
"outcome",
"decisions",
"bought_components",
"fabricated_parts",
"assemblies",
"interfaces",
"verification_steps",
"supplier_handoffs",
"evidence",
"assumptions",
"unknowns",
"authority"
],
"properties": {
"source": {
"$ref": "#/$defs/source"
},
"outcome": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"contract": {
"const": "a2a2p.actualization-plan"
},
"evidence": {
"type": "array",
"items": {
"$ref": "#/$defs/evidence"
},
"maxItems": 200
},
"unknowns": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 100
},
"authority": {
"type": "object",
"required": [
"candidate_selection",
"requirement_mutation",
"engineering_validation",
"supplier_contact",
"provider_call",
"quote_request",
"order",
"payment",
"fabrication"
],
"properties": {
"order": {
"const": false
},
"payment": {
"const": false
},
"fabrication": {
"const": false
},
"provider_call": {
"const": false
},
"quote_request": {
"const": false
},
"supplier_contact": {
"const": false
},
"candidate_selection": {
"const": false
},
"requirement_mutation": {
"const": false
},
"engineering_validation": {
"const": false
}
},
"additionalProperties": false
},
"decisions": {
"type": "array",
"items": {
"$ref": "#/$defs/decision"
},
"maxItems": 100
},
"assemblies": {
"type": "array",
"items": {
"$ref": "#/$defs/assembly"
},
"maxItems": 100
},
"interfaces": {
"type": "array",
"items": {
"$ref": "#/$defs/interface"
},
"maxItems": 100
},
"assumptions": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 100
},
"contract_version": {
"const": "0.1.0-draft"
},
"fabricated_parts": {
"type": "array",
"items": {
"$ref": "#/$defs/fabricated_part"
},
"maxItems": 100
},
"bought_components": {
"type": "array",
"items": {
"$ref": "#/$defs/bought_component"
},
"maxItems": 100
},
"supplier_handoffs": {
"type": "array",
"items": {
"$ref": "#/$defs/supplier_handoff"
},
"maxItems": 100
},
"verification_steps": {
"type": "array",
"items": {
"$ref": "#/$defs/verification_step"
},
"maxItems": 100
}
},
"description": "A portable, non-authorizing projection of one validated domain-solutioning candidate into named physical-work entities. It is not a generic graph ontology.",
"x-a2a2p-boundary": {
"persistence": false,
"relation_model": "typed_foreign_keys_on_named_domain_entities",
"source_contract": "[email protected]",
"external_effects": false,
"generic_nodes_or_edges": false,
"evidence_vocabulary_owner": "a2a2p.domain-scaffold"
},
"additionalProperties": false,
"x-a2a2p-rejection-reasons": [
"authority_promotion",
"contract_mismatch",
"correction_history_invalid",
"dependency_cycle",
"duplicate_entity_id",
"evidence_kind_invalid",
"evidence_reference_missing",
"input_too_large",
"invalid_plan_shape",
"source_binding_mismatch",
"unknown_entity_reference",
"upstream_validation_failed"
]
},
"result": {
"type": "object"
},
"correction_history": {
"type": "array",
"items": {
"type": "object",
"required": [
"contract",
"contract_version",
"sequence",
"reason_code",
"field",
"action",
"rejected_plan_digest",
"previous_entry_digest",
"entry_digest"
],
"properties": {
"field": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"action": {
"type": "string",
"pattern": "\\S",
"maxLength": 2000,
"minLength": 1
},
"contract": {
"const": "a2a2p.actualization-plan-recovery"
},
"sequence": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"reason_code": {
"enum": [
"authority_promotion",
"contract_mismatch",
"correction_history_invalid",
"dependency_cycle",
"duplicate_entity_id",
"evidence_kind_invalid",
"evidence_reference_missing",
"input_too_large",
"invalid_plan_shape",
"source_binding_mismatch",
"unknown_entity_reference",
"upstream_validation_failed"
]
},
"entry_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"contract_version": {
"const": "0.1.0-draft"
},
"rejected_plan_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"previous_entry_digest": {
"type": [
"string",
"null"
],
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100
}
},
"additionalProperties": false
}Validate a candidate result returned under the a2a2p domain-solutioning contract. The exact output of prepare_domain_solutioning_case is a prerequisite; malformed or non-prepared cases return a versioned machine-readable recovery workflow without weakening case-shape or digest checks. The operation verifies the source-case digest and provenance shape, rejects authority promotion and intent or design-file mutation, re-screens every candidate at quote stage, and runs the deterministic engineering review only after screening allows it. A successful response content-addresses the exact candidate result and returns a copy-ready, non-automatic source binding for prepare_simulation_study; every objective, constraint, physical input, setting, and validation plan remains caller-supplied. It stores nothing, runs no solver, calls no model or supplier, applies no patch, and grants no provider, quote, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| case* | any | |
| result* | any |
{
"type": "object",
"$defs": {
"case": {
"type": "object",
"title": "a2a2p domain-solutioning interoperability contract",
"contract": "a2a2p.domain-solutioning",
"required": [
"contract",
"contract_version",
"case_digest",
"requirement",
"deterministic_evidence",
"safety",
"requested_work",
"expected_result",
"activation",
"provenance",
"authority",
"next"
],
"properties": {
"next": {
"type": "object"
},
"safety": {
"type": "object",
"required": [
"verdict",
"policy_version"
]
},
"contract": {
"const": "a2a2p.domain-solutioning"
},
"authority": {
"$ref": "#/$defs/authority"
},
"activation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"case_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"requirement": {
"type": "object"
},
"requested_work": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"expected_result": {
"type": "object"
},
"contract_version": {
"const": "0.3.0-draft"
},
"deterministic_evidence": {
"type": "object"
}
},
"description": "Case handoff and candidate-return schema. Intelligence proposes; deterministic evidence, safety, and external authority remain outside model control.",
"contract_version": "0.3.0-draft",
"additionalProperties": false
},
"result": {
"type": "object",
"required": [
"contract",
"contract_version",
"case_digest",
"framework",
"model_provenance",
"candidates",
"recommendation",
"dissent",
"authority"
],
"properties": {
"dissent": {
"type": "array",
"items": {
"type": "object",
"required": [
"candidate_id",
"concern"
],
"properties": {
"concern": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"candidate_id": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100
},
"contract": {
"const": "a2a2p.domain-solutioning"
},
"authority": {
"$ref": "#/$defs/authority"
},
"framework": {
"type": "object",
"required": [
"id",
"version"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": true
},
"candidates": {
"type": "array",
"items": {
"$ref": "#/$defs/candidate"
},
"maxItems": 5,
"minItems": 1
},
"case_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"recommendation": {
"type": "object",
"required": [
"candidate_id",
"because",
"overturn_if"
],
"properties": {
"because": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"overturn_if": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"candidate_id": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": true
},
"contract_version": {
"const": "0.3.0-draft"
},
"model_provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"provider",
"model",
"role"
],
"properties": {
"role": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"model": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"provider": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 32,
"minItems": 1
}
},
"additionalProperties": false
},
"authority": {
"type": "object",
"required": [
"requirement_fact_mutation",
"safety_override",
"engineering_validation",
"supplier_contact",
"provider_call",
"quote_request",
"order",
"payment",
"fabrication"
],
"properties": {
"order": {
"const": false
},
"payment": {
"const": false
},
"fabrication": {
"const": false
},
"provider_call": {
"const": false
},
"quote_request": {
"const": false
},
"safety_override": {
"const": false
},
"supplier_contact": {
"const": false
},
"engineering_validation": {
"const": false
},
"requirement_fact_mutation": {
"const": false
}
},
"additionalProperties": false
},
"candidate": {
"type": "object",
"required": [
"candidate_id",
"mechanism",
"functional_decomposition",
"specification_patch",
"assumptions",
"unknowns",
"tradeoffs",
"evidence_refs",
"validation_plan",
"rejected_alternatives"
],
"properties": {
"unknowns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"maxItems": 100
},
"mechanism": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"tradeoffs": {
"type": "array",
"items": {
"type": "object",
"required": [
"choice",
"benefit",
"cost"
],
"properties": {
"cost": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"choice": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"benefit": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100,
"minItems": 1
},
"assumptions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"maxItems": 100
},
"candidate_id": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_refs": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"path"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"path": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100,
"minItems": 1
},
"validation_plan": {
"type": "array",
"items": {
"type": "object",
"required": [
"test",
"criterion"
],
"properties": {
"test": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"criterion": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100,
"minItems": 1
},
"specification_patch": {
"type": "object",
"properties": {
"process": {
"not": {
"type": "null"
}
},
"material": {
"not": {
"type": "null"
}
},
"part_type": {
"not": {
"type": "null"
}
},
"dimensions": {
"not": {
"type": "null"
}
},
"surface_finish": {
"not": {
"type": "null"
}
},
"post_processing": {
"not": {
"type": "null"
}
},
"tolerance_class": {
"not": {
"type": "null"
}
}
},
"description": "Proposal-only patch to current canonical specification fields. design_files and intent are excluded because intelligence receives neither file bytes nor authority to alter requester facts.",
"minProperties": 1,
"additionalProperties": false
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"mechanism",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"mechanism": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100
},
"functional_decomposition": {
"type": "array",
"items": {
"type": "object",
"required": [
"function",
"part"
],
"properties": {
"part": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"function": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"additionalProperties": true
},
"maxItems": 100,
"minItems": 1
}
},
"additionalProperties": false
}
},
"title": "a2a2p domain-solutioning result validation input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"case",
"result"
],
"properties": {
"case": {
"$ref": "#/$defs/case"
},
"result": {
"$ref": "#/$defs/result"
}
},
"description": "An exact prepared case plus one candidate result. Validation is stateless and creates no physical authority.",
"additionalProperties": false
}Validate and content-bind one caller-supplied material-property evidence envelope before attaching it to a compatible preliminary simulation. The receipt separates shape/content identity from source truth, material identity, uncertainty verification, design allowable, engineering validation, and physical authority. Computed-crystal evidence remains valid reference data but ineligible for the scalar engineering-product beam path. The operation calls no model or solver, stores nothing, contacts nobody, and creates no physical evidence, order, payment, or fabrication authority.
| Argument | Type | Description |
|---|---|---|
| evidence* | object | Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable. |
{
"type": "object",
"required": [
"evidence"
],
"properties": {
"evidence": {
"type": "object",
"required": [
"property",
"material_state",
"applicability",
"basis",
"source"
],
"properties": {
"basis": {
"type": "object",
"required": [
"class",
"method",
"uncertainty"
],
"properties": {
"class": {
"enum": [
"engineering_datasheet",
"experimental_measurement",
"computed_crystal"
]
},
"method": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"uncertainty": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "not_reported"
}
}
},
"else": {
"properties": {
"value": {
"type": "number",
"minimum": 0
}
}
},
"then": {
"properties": {
"value": {
"type": "null"
}
}
}
}
],
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"enum": [
"relative_percent",
"not_reported"
]
},
"value": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"source": {
"type": "object",
"required": [
"kind",
"id",
"version",
"checked_at",
"refresh_after",
"excerpt"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"kind": {
"enum": [
"cited_reference",
"materials_database",
"plm_record"
]
},
"excerpt": {
"type": "string",
"maxLength": 20000,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"property": {
"type": "object",
"required": [
"quantity",
"value",
"unit"
],
"properties": {
"unit": {
"const": "GPa"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"quantity": {
"const": "elastic_modulus"
}
},
"additionalProperties": false
},
"applicability": {
"type": "object",
"required": [
"temperature_c",
"orientation",
"manufacturing_process"
],
"properties": {
"orientation": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"temperature_c": {
"type": [
"number",
"null"
],
"description": "Celsius applicability. null is accepted only for computed_crystal evidence and keeps the result reference-only."
},
"manufacturing_process": {
"type": "string",
"maxLength": 300,
"minLength": 1
}
},
"additionalProperties": false
},
"material_state": {
"type": "object",
"required": [
"name",
"grade",
"condition",
"product_form"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"grade": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"condition": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"product_form": {
"type": [
"string",
"null"
],
"maxLength": 300
}
},
"additionalProperties": false
}
},
"description": "Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable.",
"additionalProperties": false,
"x-a2a2p-simulation-eligibility-fields": [
"material_state.name",
"material_state.grade",
"material_state.condition",
"material_state.product_form",
"applicability.temperature_c",
"applicability.orientation",
"applicability.manufacturing_process"
],
"x-a2a2p-simulation-ineligible-normalized-values": [
"unknown",
"unspecified",
"not specified",
"not applicable",
"n/a",
"na",
"none",
"null",
"tbd",
"to be determined",
"pending"
]
}
},
"additionalProperties": false
}Recompute a bounded rectangular beam-section derivation from the exact declared input and reject any mutation of the candidate, digests, assumptions, claim limits, external-effects boundary, authority boundary, or carried screening receipt. Success proves deterministic replay and content identity only; it does not make the candidate simulation-eligible, physically true, supplier-ready, approved, purchased, or fabrication-authorized.
| Argument | Type | Description |
|---|---|---|
| input* | object | |
| receipt* | object |
{
"$id": "https://a2a2p.com/schema/beam-section-derivation-validation",
"type": "object",
"title": "a2a2p bounded beam-section derivation replay validation",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input",
"receipt"
],
"properties": {
"input": {
"$id": "https://a2a2p.com/schema/beam-section-derivation",
"type": "object",
"allOf": [
{
"anyOf": [
{
"required": [
"max_deflection_mm"
],
"properties": {
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"required": [
"allowable_stress_mpa"
],
"properties": {
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
]
}
],
"title": "a2a2p bounded rectangular beam-section derivation",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purpose",
"model",
"load_n",
"span_mm",
"section_width_mm",
"elastic_modulus_gpa",
"max_deflection_mm",
"allowable_stress_mpa",
"manufacturing_increment_mm"
],
"properties": {
"model": {
"enum": [
"cantilever_end_load",
"simply_supported_center_load"
]
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 12
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"section_width_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"manufacturing_increment_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"receipt": {
"type": "object",
"required": [
"contract",
"contract_version",
"state",
"purpose",
"binding",
"derivation",
"candidate",
"verification",
"assumptions",
"claim_limits",
"next",
"external_effects",
"authority"
],
"properties": {
"next": {
"type": "object"
},
"state": {
"const": "candidate_derived_and_conditionally_verified"
},
"binding": {
"type": "object"
},
"purpose": {
"type": "string"
},
"contract": {
"const": "a2a2p.rectangular-beam-section-derivation"
},
"authority": {
"type": "object"
},
"candidate": {
"type": "object"
},
"screening": {
"type": "object",
"required": [
"verdict",
"stage",
"policy_version",
"categories",
"flags",
"requires_human_review_before_external_action"
],
"properties": {
"flags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"stage": {
"const": "review"
},
"verdict": {
"enum": [
"allow",
"review"
]
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"policy_version": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"requires_human_review_before_external_action": {
"type": "boolean"
}
},
"additionalProperties": false
},
"derivation": {
"type": "object"
},
"assumptions": {
"type": "array"
},
"claim_limits": {
"type": "object"
},
"verification": {
"type": "object"
},
"contract_version": {
"const": "0.1.0-draft"
},
"external_effects": {
"type": "object"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Recompute a bounded finite rectangular-beam design space from the exact caller-held input and reject any mutation of an embedded derivation, Pareto disposition, digest, claim limit, external-effect boundary, authority boundary, or carried screening receipt. Success proves deterministic replay and content identity only. It never selects or promotes a candidate, estimates cost, calls an external system, or grants simulation, supplier, purchase, or fabrication eligibility.
| Argument | Type | Description |
|---|---|---|
| input* | object | |
| receipt* | object |
{
"$id": "https://a2a2p.com/schema/beam-section-design-space-validation",
"type": "object",
"title": "a2a2p bounded beam-section design-space replay validation",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input",
"receipt"
],
"properties": {
"input": {
"$id": "https://a2a2p.com/schema/beam-section-design-space",
"type": "object",
"allOf": [
{
"anyOf": [
{
"required": [
"max_deflection_mm"
],
"properties": {
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"required": [
"allowable_stress_mpa"
],
"properties": {
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
]
}
],
"title": "a2a2p bounded rectangular beam-section design space",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purpose",
"model",
"load_n",
"span_mm",
"section_width_options_mm",
"elastic_modulus_gpa",
"max_deflection_mm",
"allowable_stress_mpa",
"manufacturing_increment_mm"
],
"properties": {
"model": {
"enum": [
"cantilever_end_load",
"simply_supported_center_load"
]
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 12
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"section_width_options_mm": {
"type": "array",
"items": {
"type": "number",
"exclusiveMinimum": 0
},
"maxItems": 12,
"minItems": 2,
"description": "Finite caller-owned width set. Input order has no decision meaning and is normalized ascending before evaluation.",
"uniqueItems": true
},
"manufacturing_increment_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"receipt": {
"type": "object",
"required": [
"contract",
"contract_version",
"state",
"purpose",
"binding",
"declared_design_space",
"candidates",
"comparison",
"decision",
"claim_limits",
"external_effects",
"authority"
],
"properties": {
"state": {
"const": "finite_design_space_evaluated"
},
"binding": {
"type": "object"
},
"purpose": {
"type": "string"
},
"contract": {
"const": "a2a2p.rectangular-beam-section-design-space"
},
"decision": {
"type": "object"
},
"authority": {
"type": "object"
},
"screening": {
"type": "object",
"required": [
"verdict",
"stage",
"policy_version",
"categories",
"flags",
"requires_human_review_before_external_action"
],
"properties": {
"flags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"stage": {
"const": "review"
},
"verdict": {
"enum": [
"allow",
"review"
]
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"policy_version": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"requires_human_review_before_external_action": {
"type": "boolean"
}
},
"additionalProperties": false
},
"candidates": {
"type": "array",
"maxItems": 12,
"minItems": 2
},
"comparison": {
"type": "object"
},
"claim_limits": {
"type": "object"
},
"contract_version": {
"const": "0.1.0-draft"
},
"external_effects": {
"type": "object"
},
"declared_design_space": {
"type": "object"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Validate a prepared a2a2p simulation-study result. Masked timeout, non-convergence, boundary, unit, provenance, unsupported-model, and solver failures fail closed. Hard constraints gate eligibility; distinct objective values remain visible; Pareto dispositions are canonical and order-independent. It runs no solver, applies no candidate, stores nothing, and grants no physical authority.
| Argument | Type | Description |
|---|---|---|
| study* | object | |
| result* | object |
{
"type": "object",
"required": [
"study",
"result"
],
"properties": {
"study": {
"type": "object"
},
"result": {
"type": "object"
}
},
"additionalProperties": false
}| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| delivery | object | Optional caller-declared routing context carried into the returned package. a2a2p does not send it anywhere. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"examples": [
{
"intent": {
"purpose": "Hold an indoor sensor enclosure against a vertical rail without drilling."
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"delivery": {
"type": "object",
"required": [
"accountable_principal",
"principal_kind",
"reply_to"
],
"properties": {
"reply_to": {
"type": "string",
"maxLength": 500,
"description": "A reachable business email or HTTPS reply route."
},
"principal_kind": {
"enum": [
"organization",
"person"
],
"type": "string"
},
"registered_address": {
"type": "string",
"maxLength": 500,
"description": "Required for an organization principal; its verifiable registered address."
},
"accountable_principal": {
"type": "string",
"maxLength": 300,
"description": "A named person or legal entity accountable for the request."
}
},
"description": "Optional caller-declared routing context carried into the returned package. a2a2p does not send it anywhere.",
"additionalProperties": false
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
},
"description": "PRECONDITION: provide a requester-supplied non-whitespace purpose at intent.purpose or requirement before invoking. If purpose is absent, ask what the physical object must accomplish; do not infer it and do not call this tool yet."
}| manufacturing_increment_mm* | number |
{
"$id": "https://a2a2p.com/schema/beam-section-derivation",
"type": "object",
"allOf": [
{
"anyOf": [
{
"required": [
"max_deflection_mm"
],
"properties": {
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"required": [
"allowable_stress_mpa"
],
"properties": {
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
]
}
],
"title": "a2a2p bounded rectangular beam-section derivation",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purpose",
"model",
"load_n",
"span_mm",
"section_width_mm",
"elastic_modulus_gpa",
"max_deflection_mm",
"allowable_stress_mpa",
"manufacturing_increment_mm"
],
"properties": {
"model": {
"enum": [
"cantilever_end_load",
"simply_supported_center_load"
]
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 12
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"section_width_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"manufacturing_increment_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}| Finite caller-owned width set. Input order has no decision meaning and is normalized ascending before evaluation. |
| manufacturing_increment_mm* | number |
{
"$id": "https://a2a2p.com/schema/beam-section-design-space",
"type": "object",
"allOf": [
{
"anyOf": [
{
"required": [
"max_deflection_mm"
],
"properties": {
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"required": [
"allowable_stress_mpa"
],
"properties": {
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
]
}
],
"title": "a2a2p bounded rectangular beam-section design space",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purpose",
"model",
"load_n",
"span_mm",
"section_width_options_mm",
"elastic_modulus_gpa",
"max_deflection_mm",
"allowable_stress_mpa",
"manufacturing_increment_mm"
],
"properties": {
"model": {
"enum": [
"cantilever_end_load",
"simply_supported_center_load"
]
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 12
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"section_width_options_mm": {
"type": "array",
"items": {
"type": "number",
"exclusiveMinimum": 0
},
"maxItems": 12,
"minItems": 2,
"description": "Finite caller-owned width set. Input order has no decision meaning and is normalized ascending before evaluation.",
"uniqueItems": true
},
"manufacturing_increment_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| material_property_evidence* |
| object |
| Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable. |
{
"type": "object",
"required": [
"derivation_input",
"derivation_receipt",
"derivation_validation",
"source_metadata",
"objectives",
"material_property_evidence",
"physical_validation_plan"
],
"properties": {
"objectives": {
"type": "array",
"items": {
"type": "object",
"required": [
"objective_id",
"quantity",
"unit",
"direction",
"priority",
"proxy"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"proxy": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"is_proxy"
],
"properties": {
"is_proxy": {
"const": true
}
}
},
"else": {
"properties": {
"validity_domain": {
"type": "null"
},
"divergence_regime": {
"type": "null"
},
"target_requirement_id": {
"type": "null"
}
}
},
"then": {
"properties": {
"validity_domain": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"divergence_regime": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"target_requirement_id": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
}
}
],
"required": [
"is_proxy",
"target_requirement_id",
"validity_domain",
"divergence_regime"
],
"properties": {
"is_proxy": {
"type": "boolean"
},
"validity_domain": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"divergence_regime": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"target_requirement_id": {
"type": [
"string",
"null"
],
"maxLength": 500
}
},
"additionalProperties": false
},
"priority": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"quantity": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"direction": {
"enum": [
"minimize",
"maximize"
]
},
"objective_id": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 32,
"minItems": 1
},
"source_metadata": {
"type": "object",
"required": [
"id",
"version",
"staleness"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"staleness": {
"type": "object",
"required": [
"checked_at",
"refresh_after"
],
"properties": {
"checked_at": {
"type": "string",
"format": "date-time"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"derivation_input": {
"type": "object",
"allOf": [
{
"anyOf": [
{
"required": [
"max_deflection_mm"
],
"properties": {
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"required": [
"allowable_stress_mpa"
],
"properties": {
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
]
}
],
"required": [
"purpose",
"model",
"load_n",
"span_mm",
"section_width_mm",
"elastic_modulus_gpa",
"max_deflection_mm",
"allowable_stress_mpa",
"manufacturing_increment_mm"
],
"properties": {
"model": {
"enum": [
"cantilever_end_load",
"simply_supported_center_load"
]
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 12
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"section_width_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"manufacturing_increment_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"derivation_receipt": {
"type": "object",
"required": [
"contract",
"contract_version",
"state",
"purpose",
"binding",
"derivation",
"candidate",
"verification",
"assumptions",
"claim_limits",
"next",
"external_effects",
"authority"
],
"properties": {
"next": {
"type": "object"
},
"state": {
"const": "candidate_derived_and_conditionally_verified"
},
"binding": {
"type": "object"
},
"purpose": {
"type": "string"
},
"contract": {
"const": "a2a2p.rectangular-beam-section-derivation"
},
"authority": {
"type": "object"
},
"candidate": {
"type": "object"
},
"screening": {
"type": "object",
"required": [
"verdict",
"stage",
"policy_version",
"categories",
"flags",
"requires_human_review_before_external_action"
],
"properties": {
"flags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"stage": {
"const": "review"
},
"verdict": {
"enum": [
"allow",
"review"
]
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 100
},
"policy_version": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"requires_human_review_before_external_action": {
"type": "boolean"
}
},
"additionalProperties": false
},
"derivation": {
"type": "object"
},
"assumptions": {
"type": "array"
},
"claim_limits": {
"type": "object"
},
"verification": {
"type": "object"
},
"contract_version": {
"const": "0.1.0-draft"
},
"external_effects": {
"type": "object"
}
},
"additionalProperties": false
},
"derivation_validation": {
"type": "object",
"description": "Exact output returned by validate_rectangular_beam_section_derivation for the same input and receipt. Runtime replay and full canonical comparison are authoritative."
},
"physical_validation_plan": {
"type": "array",
"items": {
"type": "object",
"required": [
"test_id",
"measured_quantity",
"unit",
"acceptance_criterion",
"authority_required"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"test_id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"measured_quantity": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"authority_required": {
"const": true
},
"acceptance_criterion": {
"type": "string",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"material_property_evidence": {
"type": "object",
"required": [
"property",
"material_state",
"applicability",
"basis",
"source"
],
"properties": {
"basis": {
"type": "object",
"required": [
"class",
"method",
"uncertainty"
],
"properties": {
"class": {
"enum": [
"engineering_datasheet",
"experimental_measurement",
"computed_crystal"
]
},
"method": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"uncertainty": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "not_reported"
}
}
},
"else": {
"properties": {
"value": {
"type": "number",
"minimum": 0
}
}
},
"then": {
"properties": {
"value": {
"type": "null"
}
}
}
}
],
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"enum": [
"relative_percent",
"not_reported"
]
},
"value": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"source": {
"type": "object",
"required": [
"kind",
"id",
"version",
"checked_at",
"refresh_after",
"excerpt"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"kind": {
"enum": [
"cited_reference",
"materials_database",
"plm_record"
]
},
"excerpt": {
"type": "string",
"maxLength": 20000,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"property": {
"type": "object",
"required": [
"quantity",
"value",
"unit"
],
"properties": {
"unit": {
"const": "GPa"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"quantity": {
"const": "elastic_modulus"
}
},
"additionalProperties": false
},
"applicability": {
"type": "object",
"required": [
"temperature_c",
"orientation",
"manufacturing_process"
],
"properties": {
"orientation": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"temperature_c": {
"type": [
"number",
"null"
],
"description": "Celsius applicability. null is accepted only for computed_crystal evidence and keeps the result reference-only."
},
"manufacturing_process": {
"type": "string",
"maxLength": 300,
"minLength": 1
}
},
"additionalProperties": false
},
"material_state": {
"type": "object",
"required": [
"name",
"grade",
"condition",
"product_form"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"grade": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"condition": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"product_form": {
"type": [
"string",
"null"
],
"maxLength": 300
}
},
"additionalProperties": false
}
},
"description": "Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable.",
"additionalProperties": false,
"x-a2a2p-simulation-eligibility-fields": [
"material_state.name",
"material_state.grade",
"material_state.condition",
"material_state.product_form",
"applicability.temperature_c",
"applicability.orientation",
"applicability.manufacturing_process"
],
"x-a2a2p-simulation-ineligible-normalized-values": [
"unknown",
"unspecified",
"not specified",
"not applicable",
"n/a",
"na",
"none",
"null",
"tbd",
"to be determined",
"pending"
]
}
},
"description": "Replay-gated compiler from one bounded rectangular-beam derivation into one prepared simulation study. Material evidence, objective, source freshness, and physical validation remain caller-owned and mandatory.",
"additionalProperties": false
}| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| array |
| material_property_evidence | object | Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable. |
{
"type": "object",
"required": [
"simulation_handoff",
"candidate_id",
"requirement",
"source_metadata",
"objectives",
"physical_validation_plan"
],
"properties": {
"objectives": {
"type": "array",
"items": {
"type": "object",
"required": [
"objective_id",
"quantity",
"unit",
"direction",
"priority",
"proxy"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"proxy": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"is_proxy"
],
"properties": {
"is_proxy": {
"const": true
}
}
},
"else": {
"properties": {
"validity_domain": {
"type": "null"
},
"divergence_regime": {
"type": "null"
},
"target_requirement_id": {
"type": "null"
}
}
},
"then": {
"properties": {
"validity_domain": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"divergence_regime": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"target_requirement_id": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
}
}
],
"required": [
"is_proxy",
"target_requirement_id",
"validity_domain",
"divergence_regime"
],
"properties": {
"is_proxy": {
"type": "boolean"
},
"validity_domain": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"divergence_regime": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"target_requirement_id": {
"type": [
"string",
"null"
],
"maxLength": 500
}
},
"additionalProperties": false
},
"priority": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"quantity": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"direction": {
"enum": [
"minimize",
"maximize"
]
},
"objective_id": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 32,
"minItems": 1
},
"requirement": {
"type": "object"
},
"candidate_id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"source_metadata": {
"type": "object",
"required": [
"id",
"version",
"staleness"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"staleness": {
"type": "object",
"required": [
"checked_at",
"refresh_after"
],
"properties": {
"checked_at": {
"type": "string",
"format": "date-time"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"simulation_handoff": {
"type": "object"
},
"physical_validation_plan": {
"type": "array",
"items": {
"type": "object",
"required": [
"test_id",
"measured_quantity",
"unit",
"acceptance_criterion",
"authority_required"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"test_id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"measured_quantity": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"authority_required": {
"const": true
},
"acceptance_criterion": {
"type": "string",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"material_property_evidence": {
"type": "object",
"required": [
"property",
"material_state",
"applicability",
"basis",
"source"
],
"properties": {
"basis": {
"type": "object",
"required": [
"class",
"method",
"uncertainty"
],
"properties": {
"class": {
"enum": [
"engineering_datasheet",
"experimental_measurement",
"computed_crystal"
]
},
"method": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"uncertainty": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "not_reported"
}
}
},
"else": {
"properties": {
"value": {
"type": "number",
"minimum": 0
}
}
},
"then": {
"properties": {
"value": {
"type": "null"
}
}
}
}
],
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"enum": [
"relative_percent",
"not_reported"
]
},
"value": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"source": {
"type": "object",
"required": [
"kind",
"id",
"version",
"checked_at",
"refresh_after",
"excerpt"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"kind": {
"enum": [
"cited_reference",
"materials_database",
"plm_record"
]
},
"excerpt": {
"type": "string",
"maxLength": 20000,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"refresh_after": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"property": {
"type": "object",
"required": [
"quantity",
"value",
"unit"
],
"properties": {
"unit": {
"const": "GPa"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"quantity": {
"const": "elastic_modulus"
}
},
"additionalProperties": false
},
"applicability": {
"type": "object",
"required": [
"temperature_c",
"orientation",
"manufacturing_process"
],
"properties": {
"orientation": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"temperature_c": {
"type": [
"number",
"null"
],
"description": "Celsius applicability. null is accepted only for computed_crystal evidence and keeps the result reference-only."
},
"manufacturing_process": {
"type": "string",
"maxLength": 300,
"minLength": 1
}
},
"additionalProperties": false
},
"material_state": {
"type": "object",
"required": [
"name",
"grade",
"condition",
"product_form"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"grade": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"condition": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"product_form": {
"type": [
"string",
"null"
],
"maxLength": 300
}
},
"additionalProperties": false
}
},
"description": "Caller-supplied exact material-property source snapshot. Binding proves content identity and envelope validity only; it does not verify the source claim or create a design allowable.",
"additionalProperties": false,
"x-a2a2p-simulation-eligibility-fields": [
"material_state.name",
"material_state.grade",
"material_state.condition",
"material_state.product_form",
"applicability.temperature_c",
"applicability.orientation",
"applicability.manufacturing_process"
],
"x-a2a2p-simulation-ineligible-normalized-values": [
"unknown",
"unspecified",
"not specified",
"not applicable",
"n/a",
"na",
"none",
"null",
"tbd",
"to be determined",
"pending"
]
}
},
"additionalProperties": false
}| Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| email_binding* | object | Explicit envelope for a reviewable, non-sending RFC 5322 draft. No address is looked up or inferred. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [
"email_binding"
],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"email_binding": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"principal_kind"
],
"properties": {
"principal_kind": {
"const": "organization"
}
}
},
"then": {
"required": [
"principal_registered_address"
]
}
}
],
"required": [
"accountable_principal",
"principal_kind",
"principal_domain",
"from",
"reply_to",
"recipient",
"reply_to_is_monitored",
"reply_to_identifies_natural_person"
],
"properties": {
"from": {
"type": "string",
"maxLength": 254,
"minLength": 3
},
"reply_to": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "For an organization principal, this must be a recognized organizational role mailbox rather than a natural person's mailbox."
},
"recipient": {
"type": "string",
"maxLength": 254,
"minLength": 3
},
"principal_kind": {
"enum": [
"organization",
"person"
],
"type": "string"
},
"principal_domain": {
"type": "string",
"maxLength": 253,
"minLength": 4
},
"accountable_principal": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"reply_to_is_monitored": {
"const": true
},
"principal_registered_address": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Required when principal_kind is organization."
},
"reply_to_identifies_natural_person": {
"type": "boolean"
}
},
"description": "Explicit envelope for a reviewable, non-sending RFC 5322 draft. No address is looked up or inferred.",
"additionalProperties": false
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| number |
| Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| Argument | Type | Description |
|---|---|---|
| intent | object | Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions. |
| contact | string | Optional email or callback endpoint for quote delivery. |
| deadline | string | Required delivery date or timeframe. Maps to intent.timeline. |
| quantity | integer | Number of units needed. Maps to intent.quantity. |
| budget_usd | number | Approximate budget in USD. Maps to intent.budget_envelope. |
| constraints | string | Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"required": [],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}| Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements. |
| requirement | string | Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known. |
| callback_url | string | Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL. |
| revision_note | string | Optional short explanation of what changed. |
| specification | object | Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted. |
| idempotency_key | string | Optional stable retry key (1–128 characters). Reusing it with the same patch returns the prior revision; reuse with a different patch is rejected. |
| business_context | string | Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case. |
| rejected_alternatives | array | Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus. |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"intent": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"priority": {
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"type": "string",
"description": "What matters most when tradeoffs arise."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"environment": {
"type": "array",
"items": {
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
],
"type": "string"
},
"description": "Conditions the part must survive."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"enum": [
"per_unit",
"total"
],
"type": "string"
}
},
"description": "Budget if known."
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
},
"functional_requirements": {
"type": "object",
"properties": {
"max_load": {
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
],
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted."
},
"load_case": {
"type": "object",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"description": "Static point-load magnitude in Newtons.",
"exclusiveMinimum": 0
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"description": "Rectangular section width in millimetres.",
"exclusiveMinimum": 0
},
"height_mm": {
"type": "number",
"description": "Rectangular section depth in the bending direction, millimetres.",
"exclusiveMinimum": 0
}
}
},
"span_mm": {
"type": "number",
"description": "Beam span in millimetres.",
"exclusiveMinimum": 0
},
"max_deflection_mm": {
"type": "number",
"description": "Optional requester-supplied acceptance limit.",
"exclusiveMinimum": 0
},
"yield_strength_mpa": {
"type": "number",
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester.",
"exclusiveMinimum": 0
},
"elastic_modulus_gpa": {
"type": "number",
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled.",
"exclusiveMinimum": 0
},
"allowable_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied design allowable; never inferred from handbook yield.",
"exclusiveMinimum": 0
},
"minimum_factor_of_safety": {
"type": "number",
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa.",
"exclusiveMinimum": 0
},
"allowable_shear_stress_mpa": {
"type": "number",
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data.",
"exclusiveMinimum": 0
}
},
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"type": "string",
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
}
},
"description": "Structured physical constraints."
}
},
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units needed. Maps to intent.quantity."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"request_id": {
"type": "string",
"description": "The prior request_id to revise."
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"requirement": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"revision_note": {
"type": "string",
"description": "Optional short explanation of what changed."
},
"specification": {
"type": "object",
"properties": {
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
},
"cutting": {
"type": "object",
"properties": {
"tool_diameter_mm": {
"type": "number",
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF.",
"exclusiveMinimum": 0
},
"inside_corner_relief": {
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"type": "string",
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
},
"description": "Cutting-tool constraints for routed or milled profiles."
},
"process": {
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"type": "string",
"description": "Manufacturing process."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"part_type": {
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"type": "string",
"description": "Category of physical part."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"plus": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string"
},
"minus": {
"type": "number",
"minimum": 0
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
},
"relative_to": {
"enum": [
"measured_stock_thickness"
],
"type": "string"
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grain_direction": {
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"type": "string",
"description": "Face-grain direction relative to the declared X/Y dimensions."
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
}
},
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"enum": [
"geometry",
"drawing",
"reference"
],
"type": "string"
},
"format": {
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
],
"type": "string"
}
}
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"surface_finish": {
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"type": "string",
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
],
"type": "string"
},
"description": "Post-processing treatments."
},
"tolerance_class": {
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"type": "string",
"description": "Required precision: coarse, medium, fine, precision."
}
},
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted."
},
"idempotency_key": {
"type": "string",
"description": "Optional stable retry key (1–128 characters). Reusing it with the same patch returns the prior revision; reuse with a different patch is rejected."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"rejected_alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
},
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus."
}
}
}