{
  "components": {
    "schemas": {
      "AddConceptOptionRequest": {
        "properties": {
          "criteriaScores": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Criteriascores",
            "type": "object"
          },
          "evidenceBackedCriteria": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Evidencebackedcriteria",
            "type": "array"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "criteriaScores"
        ],
        "title": "AddConceptOptionRequest",
        "type": "object"
      },
      "AnalysedRef": {
        "properties": {
          "current": {
            "title": "Current",
            "type": "boolean"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "key",
          "revision",
          "ref",
          "current"
        ],
        "title": "AnalysedRef",
        "type": "object"
      },
      "AppliedPatchView": {
        "properties": {
          "nextStep": {
            "title": "Nextstep",
            "type": "string"
          },
          "rerun": {
            "items": {
              "type": "string"
            },
            "title": "Rerun",
            "type": "array"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          },
          "versionId": {
            "title": "Versionid",
            "type": "string"
          }
        },
        "required": [
          "runId",
          "versionId",
          "nextStep"
        ],
        "title": "AppliedPatchView",
        "type": "object"
      },
      "ApprovalDecision": {
        "description": "Body for ``POST /api/v1/assistant/proposals/{change_id}/decide``.",
        "properties": {
          "change_id": {
            "description": "UUID of the proposal to decide on",
            "format": "uuid",
            "title": "Change Id",
            "type": "string"
          },
          "decision": {
            "$ref": "#/components/schemas/ApprovalDecisionType",
            "description": "Approve or reject"
          },
          "reason": {
            "description": "Human-written justification for the decision",
            "minLength": 1,
            "title": "Reason",
            "type": "string"
          },
          "reviewer": {
            "description": "Identifier of the human reviewer",
            "minLength": 1,
            "title": "Reviewer",
            "type": "string"
          }
        },
        "required": [
          "change_id",
          "decision",
          "reason",
          "reviewer"
        ],
        "title": "ApprovalDecision",
        "type": "object"
      },
      "ApprovalDecisionType": {
        "description": "The two possible human verdicts on a change proposal.",
        "enum": [
          "approve",
          "reject"
        ],
        "title": "ApprovalDecisionType",
        "type": "string"
      },
      "ApprovalItem": {
        "description": "One normalized approval, whatever it is about.",
        "properties": {
          "allowed_decisions": {
            "items": {
              "enum": [
                "approve",
                "reject",
                "retry",
                "rework"
              ],
              "type": "string"
            },
            "title": "Allowed Decisions",
            "type": "array"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "deadline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Deadline"
          },
          "decidable": {
            "default": false,
            "title": "Decidable",
            "type": "boolean"
          },
          "decision": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DecisionRecord"
              },
              {
                "type": "null"
              }
            ]
          },
          "detail": {
            "additionalProperties": true,
            "title": "Detail",
            "type": "object"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/GateFinding"
            },
            "title": "Findings",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "kind": {
            "enum": [
              "gate",
              "flow_proposal",
              "flow_version",
              "flow_patch",
              "tool_call",
              "human_authority",
              "design_change",
              "design_loop",
              "sketch",
              "drawing"
            ],
            "title": "Kind",
            "type": "string"
          },
          "not_decidable_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Not Decidable Reason"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "reason_held": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason Held"
          },
          "reason_required_for": {
            "items": {
              "type": "string"
            },
            "title": "Reason Required For",
            "type": "array"
          },
          "requested_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requested By"
          },
          "rework_targets": {
            "items": {
              "type": "string"
            },
            "title": "Rework Targets",
            "type": "array"
          },
          "route": {
            "anyOf": [
              {
                "enum": [
                  "dashboard",
                  "elicitation"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Route"
          },
          "status": {
            "enum": [
              "pending",
              "approved",
              "rejected",
              "expired",
              "canceled",
              "retried",
              "reworked"
            ],
            "title": "Status",
            "type": "string"
          },
          "summary": {
            "default": "",
            "title": "Summary",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "kind",
          "status",
          "title"
        ],
        "title": "ApprovalItem",
        "type": "object"
      },
      "ApprovalListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ApprovalItem"
            },
            "title": "Items",
            "type": "array"
          },
          "unscoped_count": {
            "default": 0,
            "title": "Unscoped Count",
            "type": "integer"
          }
        },
        "required": [
          "items"
        ],
        "title": "ApprovalListResponse",
        "type": "object"
      },
      "ApprovalRequest": {
        "description": "Body for ``POST /v1/runs/{id}/approval``.",
        "properties": {
          "decision": {
            "enum": [
              "approve",
              "reject",
              "retry",
              "rework"
            ],
            "title": "Decision",
            "type": "string"
          },
          "reason": {
            "default": "",
            "maxLength": 2000,
            "title": "Reason",
            "type": "string"
          },
          "to_phase": {
            "default": "",
            "maxLength": 200,
            "title": "To Phase",
            "type": "string"
          }
        },
        "required": [
          "decision"
        ],
        "title": "ApprovalRequest",
        "type": "object"
      },
      "ApproveDesignLoopRequest": {
        "properties": {
          "approvedBy": {
            "title": "Approvedby",
            "type": "string"
          }
        },
        "required": [
          "approvedBy"
        ],
        "title": "ApproveDesignLoopRequest",
        "type": "object"
      },
      "ApproveSketchRequest": {
        "description": "Human sign-off on a design_sketch work product (follow-up to MET-740/747).",
        "properties": {
          "approved_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Identifier of the human approving this sketch.",
            "title": "Approved By"
          }
        },
        "title": "ApproveSketchRequest",
        "type": "object"
      },
      "ApproveSketchResponse": {
        "description": "Result of approving a design_sketch \u2014 the gate's new state.",
        "properties": {
          "approved": {
            "title": "Approved",
            "type": "boolean"
          },
          "approved_at": {
            "title": "Approved At",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "approved",
          "approved_at"
        ],
        "title": "ApproveSketchResponse",
        "type": "object"
      },
      "ApproveTechnicalDrawingRequest": {
        "description": "Human sign-off on a technical_drawing work product (FORGE-293).",
        "properties": {
          "approved_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Identifier of the human approving this drawing.",
            "title": "Approved By"
          }
        },
        "title": "ApproveTechnicalDrawingRequest",
        "type": "object"
      },
      "ApproveTechnicalDrawingResponse": {
        "description": "Result of approving a technical_drawing \u2014 the gate's new state.",
        "properties": {
          "approved": {
            "title": "Approved",
            "type": "boolean"
          },
          "approved_at": {
            "title": "Approved At",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "approved",
          "approved_at"
        ],
        "title": "ApproveTechnicalDrawingResponse",
        "type": "object"
      },
      "AssemblyJoint": {
        "description": "One mate/joint between two committed parts (FORGE-271).\n\nSame shape as ``AssemblyDescription['joints'][n]`` (``types/twin.ts``) /\nthe export panel's own ``JointRow`` -- a joint authored here and one\nauthored via the URDF/SDF/USD export form are structurally identical.",
        "properties": {
          "anchor": {
            "default": [
              0.0,
              0.0,
              0.0
            ],
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Anchor",
            "type": "array"
          },
          "axis": {
            "default": [
              0.0,
              0.0,
              1.0
            ],
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Axis",
            "type": "array"
          },
          "base": {
            "minLength": 1,
            "title": "Base",
            "type": "string"
          },
          "follower": {
            "minLength": 1,
            "title": "Follower",
            "type": "string"
          },
          "limits": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "number"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limits"
          },
          "name": {
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "name",
          "type",
          "base",
          "follower"
        ],
        "title": "AssemblyJoint",
        "type": "object"
      },
      "AssemblyPart": {
        "description": "One primitive component of an assembly.",
        "properties": {
          "chamfer": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "If set, bevel every edge of the part by this distance (mm), applied before holes. Must be smaller than half the part's thinnest dimension. Use fillet OR chamfer.",
            "title": "Chamfer"
          },
          "fillet": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "If set, round every edge of the part by this radius (mm), applied before holes. Must be smaller than half the part's thinnest dimension or the fillet fails.",
            "title": "Fillet"
          },
          "holes": {
            "description": "Mounting/fastener holes drilled into the part.",
            "items": {
              "$ref": "#/components/schemas/Hole"
            },
            "title": "Holes",
            "type": "array"
          },
          "kind": {
            "description": "Primitive kind.",
            "enum": [
              "box",
              "cylinder",
              "cone",
              "sphere"
            ],
            "title": "Kind",
            "type": "string"
          },
          "name": {
            "description": "Human name of the part (STEP PRODUCT).",
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "parameters": {
            "additionalProperties": {
              "type": "number"
            },
            "description": "Dimensions in mm (box: width/length/height; \u2026).",
            "title": "Parameters",
            "type": "object"
          },
          "position": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional [x, y, z] placement in mm.",
            "title": "Position"
          }
        },
        "required": [
          "name",
          "kind"
        ],
        "title": "AssemblyPart",
        "type": "object"
      },
      "AssemblyResponse": {
        "properties": {
          "content_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Hash"
          },
          "minio_object_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Minio Object Key"
          },
          "model_url": {
            "title": "Model Url",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "part_count": {
            "title": "Part Count",
            "type": "integer"
          }
        },
        "required": [
          "node_id",
          "model_url",
          "part_count"
        ],
        "title": "AssemblyResponse",
        "type": "object"
      },
      "AssistantRequest": {
        "description": "Body for ``POST /api/v1/assistant/request``.\n\nEvery request must belong to a project. An IDE assistant submits a\nrequest to invoke an agent on a specific design work_product.",
        "properties": {
          "action": {
            "description": "Agent action to perform (e.g. 'validate_stress', 'run_drc')",
            "minLength": 1,
            "title": "Action",
            "type": "string"
          },
          "parameters": {
            "additionalProperties": true,
            "description": "Action-specific parameters",
            "title": "Parameters",
            "type": "object"
          },
          "project_id": {
            "description": "Project this request belongs to",
            "minLength": 1,
            "title": "Project Id",
            "type": "string"
          },
          "prompt": {
            "default": "",
            "description": "Free-text prompt or description for generative actions (e.g. generate_cad)",
            "title": "Prompt",
            "type": "string"
          },
          "session_id": {
            "description": "Session ID for grouping related requests",
            "format": "uuid",
            "title": "Session Id",
            "type": "string"
          },
          "target_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "UUID of the target work_product (optional for generative actions)",
            "title": "Target Id"
          }
        },
        "required": [
          "action",
          "project_id"
        ],
        "title": "AssistantRequest",
        "type": "object"
      },
      "AssistantResponse": {
        "description": "Response returned by ``POST /api/v1/assistant/request``.",
        "properties": {
          "errors": {
            "description": "Error messages, if any",
            "items": {
              "type": "string"
            },
            "title": "Errors",
            "type": "array"
          },
          "request_id": {
            "description": "Unique request identifier",
            "format": "uuid",
            "title": "Request Id",
            "type": "string"
          },
          "result": {
            "additionalProperties": true,
            "description": "Action result payload",
            "title": "Result",
            "type": "object"
          },
          "status": {
            "description": "Request status (accepted, completed, failed)",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "AssistantResponse",
        "type": "object"
      },
      "AttemptPromotionRequest": {
        "properties": {
          "comment": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment"
          },
          "k": {
            "default": 1.0,
            "title": "K",
            "type": "number"
          },
          "level": {
            "title": "Level",
            "type": "string"
          },
          "projectId": {
            "title": "Projectid",
            "type": "string"
          },
          "reject": {
            "default": false,
            "title": "Reject",
            "type": "boolean"
          },
          "requiredClaimIds": {
            "items": {
              "type": "string"
            },
            "title": "Requiredclaimids",
            "type": "array"
          }
        },
        "required": [
          "projectId",
          "level",
          "requiredClaimIds"
        ],
        "title": "AttemptPromotionRequest",
        "type": "object"
      },
      "AttemptPromotionResponse": {
        "properties": {
          "blockedReason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Blockedreason"
          },
          "comment": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment"
          },
          "decidedBy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decidedby"
          },
          "gateId": {
            "title": "Gateid",
            "type": "string"
          },
          "level": {
            "title": "Level",
            "type": "string"
          },
          "promoted": {
            "title": "Promoted",
            "type": "boolean"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/RequiredClaimResultView"
            },
            "title": "Results",
            "type": "array"
          }
        },
        "required": [
          "gateId",
          "level",
          "promoted",
          "blockedReason",
          "decidedBy",
          "comment",
          "results"
        ],
        "title": "AttemptPromotionResponse",
        "type": "object"
      },
      "BaselineDetail": {
        "properties": {
          "approved_by": {
            "items": {
              "type": "string"
            },
            "title": "Approved By",
            "type": "array"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "gate_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate Id"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "item_count": {
            "title": "Item Count",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/BaselineItemRefResponse"
            },
            "title": "Items",
            "type": "array"
          },
          "member_count": {
            "title": "Member Count",
            "type": "integer"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/BaselineMemberResponse"
            },
            "title": "Members",
            "type": "array"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "source": {
            "default": "manual",
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "created_at",
          "approved_by",
          "item_count",
          "member_count"
        ],
        "title": "BaselineDetail",
        "type": "object"
      },
      "BaselineDiffResponse": {
        "properties": {
          "a": {
            "$ref": "#/components/schemas/BaselineSummary"
          },
          "b": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BaselineSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "b_is_current": {
            "default": false,
            "title": "B Is Current",
            "type": "boolean"
          },
          "counts": {
            "additionalProperties": {
              "type": "integer"
            },
            "title": "Counts",
            "type": "object"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/BaselineItemDiffResponse"
            },
            "title": "Items",
            "type": "array"
          }
        },
        "required": [
          "a",
          "items",
          "counts"
        ],
        "title": "BaselineDiffResponse",
        "type": "object"
      },
      "BaselineItemDiffResponse": {
        "properties": {
          "from_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Ref"
          },
          "from_revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Revision"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "to_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "To Ref"
          },
          "to_revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "To Revision"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "status"
        ],
        "title": "BaselineItemDiffResponse",
        "type": "object"
      },
      "BaselineItemRefResponse": {
        "properties": {
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "default": "",
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "key",
          "item_type",
          "revision",
          "ref",
          "node_id"
        ],
        "title": "BaselineItemRefResponse",
        "type": "object"
      },
      "BaselineListResponse": {
        "properties": {
          "baselines": {
            "items": {
              "$ref": "#/components/schemas/BaselineSummary"
            },
            "title": "Baselines",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "baselines",
          "total"
        ],
        "title": "BaselineListResponse",
        "type": "object"
      },
      "BaselineMemberResponse": {
        "properties": {
          "entity_id": {
            "title": "Entity Id",
            "type": "string"
          },
          "entity_kind": {
            "title": "Entity Kind",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "entity_kind",
          "entity_id",
          "revision"
        ],
        "title": "BaselineMemberResponse",
        "type": "object"
      },
      "BaselineSummary": {
        "properties": {
          "approved_by": {
            "items": {
              "type": "string"
            },
            "title": "Approved By",
            "type": "array"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "gate_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate Id"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "item_count": {
            "title": "Item Count",
            "type": "integer"
          },
          "member_count": {
            "title": "Member Count",
            "type": "integer"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "source": {
            "default": "manual",
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "created_at",
          "approved_by",
          "item_count",
          "member_count"
        ],
        "title": "BaselineSummary",
        "type": "object"
      },
      "Body_import_work_product_v1_twin_import_post": {
        "properties": {
          "description": {
            "default": "",
            "description": "Work product description",
            "title": "Description",
            "type": "string"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Domain (mechanical, electronics)",
            "title": "Domain"
          },
          "file": {
            "contentMediaType": "application/octet-stream",
            "description": "Design file to import",
            "title": "File",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to link to",
            "title": "Project Id"
          },
          "wp_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Work product type",
            "title": "Wp Type"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_import_work_product_v1_twin_import_post",
        "type": "object"
      },
      "Body_upload_and_convert_v1_convert_post": {
        "properties": {
          "file": {
            "contentMediaType": "application/octet-stream",
            "description": "STEP or IGES CAD file",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_and_convert_v1_convert_post",
        "type": "object"
      },
      "BomComponentResponse": {
        "description": "One BOM line item, in the dashboard's camelCase shape.",
        "properties": {
          "cadModelUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cadmodelurl"
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "datasheetUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Datasheeturl"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "designator": {
            "title": "Designator",
            "type": "string"
          },
          "footprint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Footprint"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "imageUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Imageurl"
          },
          "manufacturer": {
            "title": "Manufacturer",
            "type": "string"
          },
          "partNumber": {
            "title": "Partnumber",
            "type": "string"
          },
          "priceCurrency": {
            "title": "Pricecurrency",
            "type": "string"
          },
          "projectId": {
            "title": "Projectid",
            "type": "string"
          },
          "purchaseUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Purchaseurl"
          },
          "quantity": {
            "title": "Quantity",
            "type": "integer"
          },
          "status": {
            "enum": [
              "available",
              "low_stock",
              "out_of_stock",
              "alternate_needed"
            ],
            "title": "Status",
            "type": "string"
          },
          "unitPrice": {
            "title": "Unitprice",
            "type": "number"
          }
        },
        "required": [
          "id",
          "designator",
          "partNumber",
          "description",
          "manufacturer",
          "quantity",
          "unitPrice",
          "priceCurrency",
          "status",
          "category",
          "projectId"
        ],
        "title": "BomComponentResponse",
        "type": "object"
      },
      "BomListResponse": {
        "properties": {
          "components": {
            "items": {
              "$ref": "#/components/schemas/BomComponentResponse"
            },
            "title": "Components",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "components",
          "total"
        ],
        "title": "BomListResponse",
        "type": "object"
      },
      "BooleanCutRequest": {
        "description": "Real boolean CSG operation between two committed CAD work products (MET-612).",
        "properties": {
          "cutter_node_id": {
            "minLength": 1,
            "title": "Cutter Node Id",
            "type": "string"
          },
          "operation": {
            "default": "subtract",
            "enum": [
              "subtract",
              "union",
              "intersect"
            ],
            "title": "Operation",
            "type": "string"
          },
          "result_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Name"
          },
          "target_node_id": {
            "minLength": 1,
            "title": "Target Node Id",
            "type": "string"
          }
        },
        "required": [
          "target_node_id",
          "cutter_node_id"
        ],
        "title": "BooleanCutRequest",
        "type": "object"
      },
      "BooleanCutResponse": {
        "description": "The newly-committed result node of a boolean-cut operation.",
        "properties": {
          "node": {
            "$ref": "#/components/schemas/TwinNodeResponse"
          },
          "operation": {
            "title": "Operation",
            "type": "string"
          },
          "result_area_mm2": {
            "title": "Result Area Mm2",
            "type": "number"
          },
          "result_volume_mm3": {
            "title": "Result Volume Mm3",
            "type": "number"
          }
        },
        "required": [
          "node",
          "operation",
          "result_volume_mm3",
          "result_area_mm2"
        ],
        "title": "BooleanCutResponse",
        "type": "object"
      },
      "BringupChecklistListEntry": {
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "statement": {
            "title": "Statement",
            "type": "string"
          },
          "steps": {
            "items": {
              "$ref": "#/components/schemas/BringupStep"
            },
            "title": "Steps",
            "type": "array"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "node_id",
          "created_at",
          "title",
          "statement",
          "steps"
        ],
        "title": "BringupChecklistListEntry",
        "type": "object"
      },
      "BringupChecklistListResponse": {
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/BringupChecklistListEntry"
            },
            "title": "Entries",
            "type": "array"
          }
        },
        "required": [
          "entries"
        ],
        "title": "BringupChecklistListResponse",
        "type": "object"
      },
      "BringupStep": {
        "properties": {
          "base": {
            "title": "Base",
            "type": "string"
          },
          "follower": {
            "title": "Follower",
            "type": "string"
          },
          "instruction": {
            "title": "Instruction",
            "type": "string"
          },
          "joint_name": {
            "title": "Joint Name",
            "type": "string"
          },
          "joint_type": {
            "title": "Joint Type",
            "type": "string"
          },
          "step_number": {
            "title": "Step Number",
            "type": "integer"
          }
        },
        "required": [
          "step_number",
          "joint_name",
          "joint_type",
          "base",
          "follower",
          "instruction"
        ],
        "title": "BringupStep",
        "type": "object"
      },
      "CallerBody": {
        "description": "Who is proposing: the client and, if known, its model.",
        "properties": {
          "client": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Model"
          }
        },
        "title": "CallerBody",
        "type": "object"
      },
      "CallerOperation": {
        "description": "One tailoring operation from the caller's model (FORGE-481).",
        "properties": {
          "op": {
            "title": "Op",
            "type": "string"
          },
          "phase": {
            "title": "Phase",
            "type": "string"
          },
          "rationale": {
            "default": "",
            "title": "Rationale",
            "type": "string"
          },
          "value": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Value"
          }
        },
        "required": [
          "op",
          "phase"
        ],
        "title": "CallerOperation",
        "type": "object"
      },
      "CancelRequest": {
        "properties": {
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          }
        },
        "title": "CancelRequest",
        "type": "object"
      },
      "Candidate": {
        "properties": {
          "manufacturer": {
            "title": "Manufacturer",
            "type": "string"
          },
          "mpn": {
            "title": "Mpn",
            "type": "string"
          },
          "specs": {
            "additionalProperties": {
              "type": "number"
            },
            "default": {},
            "title": "Specs",
            "type": "object"
          }
        },
        "required": [
          "mpn",
          "manufacturer"
        ],
        "title": "Candidate",
        "type": "object"
      },
      "CapabilityView": {
        "description": "Per-phase tool coverage and the gap register for one flow.",
        "properties": {
          "flowId": {
            "title": "Flowid",
            "type": "string"
          },
          "profile": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile"
          },
          "report": {
            "additionalProperties": true,
            "title": "Report",
            "type": "object"
          },
          "versionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Versionid"
          }
        },
        "required": [
          "flowId",
          "report"
        ],
        "title": "CapabilityView",
        "type": "object"
      },
      "ChangeStatus": {
        "description": "Lifecycle states for a design-change proposal.",
        "enum": [
          "pending",
          "approved",
          "rejected",
          "applied",
          "expired"
        ],
        "title": "ChangeStatus",
        "type": "string"
      },
      "ChannelListResponse": {
        "description": "List of all channels.",
        "properties": {
          "channels": {
            "items": {
              "$ref": "#/components/schemas/ChannelResponse"
            },
            "title": "Channels",
            "type": "array"
          }
        },
        "required": [
          "channels"
        ],
        "title": "ChannelListResponse",
        "type": "object"
      },
      "ChannelResponse": {
        "description": "Single channel.",
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scope_kind": {
            "title": "Scope Kind",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "scope_kind",
          "created_at"
        ],
        "title": "ChannelResponse",
        "type": "object"
      },
      "ChecklistResponse": {
        "description": "Response for checklist generation.",
        "properties": {
          "coverage_percent": {
            "title": "Coverage Percent",
            "type": "number"
          },
          "evidenced_items": {
            "title": "Evidenced Items",
            "type": "integer"
          },
          "items": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Items",
            "type": "array"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          },
          "target_markets": {
            "items": {
              "type": "string"
            },
            "title": "Target Markets",
            "type": "array"
          },
          "total_items": {
            "title": "Total Items",
            "type": "integer"
          }
        },
        "required": [
          "project_id",
          "target_markets",
          "total_items",
          "evidenced_items",
          "coverage_percent",
          "items"
        ],
        "title": "ChecklistResponse",
        "type": "object"
      },
      "ClaimRequest": {
        "properties": {
          "client": {
            "default": "",
            "title": "Client",
            "type": "string"
          }
        },
        "title": "ClaimRequest",
        "type": "object"
      },
      "CompileRequest": {
        "description": "Compile a description into a spec WITHOUT building it (dry run).",
        "properties": {
          "description": {
            "description": "Plain-English description.",
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "LLM model override.",
            "title": "Model"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Override the assembly name.",
            "title": "Name"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "LLM provider override.",
            "title": "Provider"
          }
        },
        "required": [
          "description"
        ],
        "title": "CompileRequest",
        "type": "object"
      },
      "CompileResponse": {
        "description": "The compiled spec plus any geometric-feasibility warnings (not built).",
        "properties": {
          "buildable": {
            "description": "True when the spec would build without geometry errors.",
            "title": "Buildable",
            "type": "boolean"
          },
          "errors": {
            "description": "Geometric-feasibility problems (e.g. oversize fillet); empty if buildable.",
            "items": {
              "type": "string"
            },
            "title": "Errors",
            "type": "array"
          },
          "spec": {
            "$ref": "#/components/schemas/CreateAssemblyRequest-Output",
            "description": "The compiled declarative spec."
          }
        },
        "required": [
          "spec",
          "buildable"
        ],
        "title": "CompileResponse",
        "type": "object"
      },
      "CompletenessView": {
        "description": "Dashboard-facing camelCase over the reused ``CompletenessResult``\n(left untouched -- its own field names stay snake_case internally).",
        "properties": {
          "covered": {
            "items": {
              "type": "string"
            },
            "title": "Covered",
            "type": "array"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "title": "Missing",
            "type": "array"
          },
          "productType": {
            "title": "Producttype",
            "type": "string"
          }
        },
        "required": [
          "productType"
        ],
        "title": "CompletenessView",
        "type": "object"
      },
      "ComponentHealth": {
        "description": "Health snapshot for one downstream dependency.",
        "properties": {
          "latency_ms": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Latency Ms"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/DependencyStatus"
          }
        },
        "required": [
          "name",
          "status"
        ],
        "title": "ComponentHealth",
        "type": "object"
      },
      "ConfidenceTier": {
        "description": "Provenance tier for a memory record.\n\nAligned with MET-462 property-extraction tiers so the same vocabulary\nflows from L1 extraction through to L3 reasoning:\n\n* ``VERBATIM`` \u2014 copied directly from a structured event field (1.0)\n* ``LLM_INFERRED`` \u2014 produced by an LLM synthesis step (0.6-0.8)\n* ``DERIVED`` \u2014 computed from other records (0.4-0.6)",
        "enum": [
          "verbatim",
          "llm_inferred",
          "derived"
        ],
        "title": "ConfidenceTier",
        "type": "string"
      },
      "ConflictPairView": {
        "properties": {
          "aId": {
            "title": "Aid",
            "type": "string"
          },
          "aName": {
            "title": "Aname",
            "type": "string"
          },
          "bId": {
            "title": "Bid",
            "type": "string"
          },
          "bName": {
            "title": "Bname",
            "type": "string"
          },
          "detail": {
            "title": "Detail",
            "type": "string"
          }
        },
        "required": [
          "aId",
          "aName",
          "bId",
          "bName",
          "detail"
        ],
        "title": "ConflictPairView",
        "type": "object"
      },
      "ConsolidationMode": {
        "description": "How the orchestrator behaves on a given pass.",
        "enum": [
          "background",
          "on_demand",
          "proactive",
          "janitor"
        ],
        "title": "ConsolidationMode",
        "type": "string"
      },
      "ConsolidationTheme": {
        "description": "Semantic buckets for experience consolidation.",
        "enum": [
          "mechanical_validation",
          "power_analysis",
          "circuit_design_rule",
          "component_selection",
          "firmware_build",
          "simulation",
          "compliance_check",
          "misc"
        ],
        "title": "ConsolidationTheme",
        "type": "string"
      },
      "ConsolidationTriggerRequest": {
        "description": "Request body for ``POST /v1/memory/consolidate``.",
        "properties": {
          "fetchLimit": {
            "anyOf": [
              {
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fetchlimit"
          },
          "minImportance": {
            "anyOf": [
              {
                "maximum": 1.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Minimportance"
          },
          "mode": {
            "$ref": "#/components/schemas/ConsolidationMode",
            "default": "on_demand",
            "description": "Consolidation mode. Defaults to on_demand since the REST endpoint is a manual trigger; the Temporal worker handles background."
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          },
          "theme": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConsolidationTheme"
              },
              {
                "type": "null"
              }
            ]
          },
          "until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until"
          }
        },
        "title": "ConsolidationTriggerRequest",
        "type": "object"
      },
      "ConsolidationTriggerResponse": {
        "description": "Wire shape of a single consolidation pass result.",
        "properties": {
          "acceptedCount": {
            "title": "Acceptedcount",
            "type": "integer"
          },
          "fetchedCount": {
            "title": "Fetchedcount",
            "type": "integer"
          },
          "groupCount": {
            "title": "Groupcount",
            "type": "integer"
          },
          "mode": {
            "$ref": "#/components/schemas/ConsolidationMode"
          },
          "newlyFailedCount": {
            "title": "Newlyfailedcount",
            "type": "integer"
          },
          "rejectedCount": {
            "title": "Rejectedcount",
            "type": "integer"
          },
          "rejectedReasons": {
            "items": {
              "type": "string"
            },
            "title": "Rejectedreasons",
            "type": "array"
          },
          "revalidatedCount": {
            "title": "Revalidatedcount",
            "type": "integer"
          },
          "synthesizedCount": {
            "title": "Synthesizedcount",
            "type": "integer"
          }
        },
        "required": [
          "mode",
          "fetchedCount",
          "groupCount",
          "synthesizedCount",
          "acceptedCount",
          "rejectedCount",
          "revalidatedCount",
          "newlyFailedCount"
        ],
        "title": "ConsolidationTriggerResponse",
        "type": "object"
      },
      "ConstraintSuggestion": {
        "properties": {
          "parameter": {
            "title": "Parameter",
            "type": "string"
          },
          "unit": {
            "default": "mm",
            "title": "Unit",
            "type": "string"
          },
          "value": {
            "title": "Value",
            "type": "number"
          }
        },
        "required": [
          "parameter",
          "value"
        ],
        "title": "ConstraintSuggestion",
        "type": "object"
      },
      "ConversionResult": {
        "description": "Response payload for a completed conversion.",
        "properties": {
          "cached": {
            "description": "True if result was served from cache.",
            "title": "Cached",
            "type": "boolean"
          },
          "glb_url": {
            "description": "URL to download the GLB file.",
            "title": "Glb Url",
            "type": "string"
          },
          "hash": {
            "description": "SHA-256 content hash of the source file.",
            "title": "Hash",
            "type": "string"
          },
          "metadata": {
            "additionalProperties": true,
            "description": "Part tree, stats, materials.",
            "title": "Metadata",
            "type": "object"
          }
        },
        "required": [
          "hash",
          "glb_url",
          "metadata",
          "cached"
        ],
        "title": "ConversionResult",
        "type": "object"
      },
      "CoverageResponse": {
        "description": "Response for coverage queries.",
        "properties": {
          "coverage_percent": {
            "title": "Coverage Percent",
            "type": "number"
          },
          "evidenced_items": {
            "title": "Evidenced Items",
            "type": "integer"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          },
          "total_items": {
            "title": "Total Items",
            "type": "integer"
          }
        },
        "required": [
          "project_id",
          "total_items",
          "evidenced_items",
          "coverage_percent"
        ],
        "title": "CoverageResponse",
        "type": "object"
      },
      "CreateAssemblyRequest-Input": {
        "description": "Author a multi-part assembly deterministically (no LLM) and commit it.",
        "properties": {
          "name": {
            "description": "Assembly name.",
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "parts": {
            "description": "Parts to author + assemble.",
            "items": {
              "$ref": "#/components/schemas/AssemblyPart"
            },
            "minItems": 1,
            "title": "Parts",
            "type": "array"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to scope the cad_model to.",
            "title": "Project Id"
          }
        },
        "required": [
          "name",
          "parts"
        ],
        "title": "CreateAssemblyRequest",
        "type": "object"
      },
      "CreateAssemblyRequest-Output": {
        "description": "Author a multi-part assembly deterministically (no LLM) and commit it.",
        "properties": {
          "name": {
            "description": "Assembly name.",
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "parts": {
            "description": "Parts to author + assemble.",
            "items": {
              "$ref": "#/components/schemas/AssemblyPart"
            },
            "minItems": 1,
            "title": "Parts",
            "type": "array"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to scope the cad_model to.",
            "title": "Project Id"
          }
        },
        "required": [
          "name",
          "parts"
        ],
        "title": "CreateAssemblyRequest",
        "type": "object"
      },
      "CreateBringupChecklistRequest": {
        "properties": {
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id"
        ],
        "title": "CreateBringupChecklistRequest",
        "type": "object"
      },
      "CreateBringupChecklistResponse": {
        "properties": {
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "statement": {
            "title": "Statement",
            "type": "string"
          },
          "steps": {
            "items": {
              "$ref": "#/components/schemas/BringupStep"
            },
            "title": "Steps",
            "type": "array"
          }
        },
        "required": [
          "node_id",
          "statement",
          "steps"
        ],
        "title": "CreateBringupChecklistResponse",
        "type": "object"
      },
      "CreateConstraintRequest": {
        "properties": {
          "expectedEvidence": {
            "default": "",
            "title": "Expectedevidence",
            "type": "string"
          },
          "limit": {
            "title": "Limit",
            "type": "number"
          },
          "message": {
            "default": "",
            "title": "Message",
            "type": "string"
          },
          "metric": {
            "title": "Metric",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "operator": {
            "default": "<=",
            "title": "Operator",
            "type": "string"
          },
          "projectId": {
            "title": "Projectid",
            "type": "string"
          },
          "severity": {
            "default": "error",
            "title": "Severity",
            "type": "string"
          },
          "targetNodeType": {
            "default": "",
            "title": "Targetnodetype",
            "type": "string"
          },
          "unit": {
            "default": "",
            "title": "Unit",
            "type": "string"
          },
          "verificationMethod": {
            "default": "",
            "title": "Verificationmethod",
            "type": "string"
          }
        },
        "required": [
          "projectId",
          "name",
          "metric",
          "limit"
        ],
        "title": "CreateConstraintRequest",
        "type": "object"
      },
      "CreateConstraintResponse": {
        "properties": {
          "constraintId": {
            "title": "Constraintid",
            "type": "string"
          },
          "setWorkProductId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Setworkproductid"
          }
        },
        "required": [
          "constraintId",
          "setWorkProductId"
        ],
        "title": "CreateConstraintResponse",
        "type": "object"
      },
      "CreateFirmwareScaffoldRequest": {
        "properties": {
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id"
        ],
        "title": "CreateFirmwareScaffoldRequest",
        "type": "object"
      },
      "CreateFirmwareScaffoldResponse": {
        "properties": {
          "firmware_source_node_id": {
            "title": "Firmware Source Node Id",
            "type": "string"
          },
          "joints": {
            "items": {
              "$ref": "#/components/schemas/FirmwareJointEntry"
            },
            "title": "Joints",
            "type": "array"
          },
          "pinmap_node_id": {
            "title": "Pinmap Node Id",
            "type": "string"
          }
        },
        "required": [
          "pinmap_node_id",
          "firmware_source_node_id",
          "joints"
        ],
        "title": "CreateFirmwareScaffoldResponse",
        "type": "object"
      },
      "CreateLoadCaseRequest": {
        "description": "Body for ``POST /v1/simulation/load-cases``.",
        "properties": {
          "fixedNodeSet": {
            "minLength": 1,
            "title": "Fixednodeset",
            "type": "string"
          },
          "loadForceN": {
            "items": {
              "type": "number"
            },
            "maxItems": 3,
            "minItems": 3,
            "title": "Loadforcen",
            "type": "array"
          },
          "loadNodeSet": {
            "minLength": 1,
            "title": "Loadnodeset",
            "type": "string"
          },
          "material": {
            "additionalProperties": true,
            "minProperties": 1,
            "title": "Material",
            "type": "object"
          },
          "name": {
            "maxLength": 200,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "projectId": {
            "minLength": 1,
            "title": "Projectid",
            "type": "string"
          },
          "sourceOfLoads": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceofloads"
          },
          "sourcePartNodeIds": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcepartnodeids"
          }
        },
        "required": [
          "name",
          "projectId",
          "material",
          "fixedNodeSet",
          "loadNodeSet",
          "loadForceN"
        ],
        "title": "CreateLoadCaseRequest",
        "type": "object"
      },
      "CreateProjectRequest": {
        "description": "Body for ``POST /v1/projects``.",
        "properties": {
          "description": {
            "default": "",
            "description": "Project description",
            "maxLength": 2000,
            "title": "Description",
            "type": "string"
          },
          "name": {
            "description": "Project name",
            "maxLength": 200,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "status": {
            "default": "draft",
            "description": "Initial project status",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "CreateProjectRequest",
        "type": "object"
      },
      "CreateProposalRequest": {
        "description": "Body for ``POST /api/v1/assistant/proposals`` (MET-630).\n\nLets a human create a design-change proposal directly from the\ndashboard (e.g. a parameter-panel \"Regenerate\" button) \u2014 previously\nproposals could only be created by an agent calling the\n``twin.propose_change`` MCP tool.",
        "properties": {
          "agent_code": {
            "default": "human",
            "description": "Code identifying who/what is proposing the change",
            "minLength": 1,
            "title": "Agent Code",
            "type": "string"
          },
          "description": {
            "description": "What the change does",
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "diff": {
            "additionalProperties": true,
            "description": "Structured diff (e.g. {'action': 'regenerate_geometry'})",
            "title": "Diff",
            "type": "object"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "session_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          },
          "work_products_affected": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "title": "Work Products Affected",
            "type": "array"
          }
        },
        "required": [
          "description"
        ],
        "title": "CreateProposalRequest",
        "type": "object"
      },
      "CreateReleaseRequest": {
        "properties": {
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "title": "CreateReleaseRequest",
        "type": "object"
      },
      "CreateRunRequest": {
        "description": "Body for ``POST /v1/runs``.",
        "properties": {
          "request": {
            "additionalProperties": true,
            "description": "Opaque run input (goal, spec, config) handed to the harness.",
            "title": "Request",
            "type": "object"
          },
          "start": {
            "default": true,
            "description": "Transition queued -> running immediately after creation.",
            "title": "Start",
            "type": "boolean"
          }
        },
        "title": "CreateRunRequest",
        "type": "object"
      },
      "CreateThreadRequest": {
        "description": "Body for ``POST /api/v1/chat/threads``.",
        "properties": {
          "initial_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "If provided, a first message is created automatically",
            "title": "Initial Message"
          },
          "scope_entity_id": {
            "description": "ID of the scoped entity",
            "title": "Scope Entity Id",
            "type": "string"
          },
          "scope_kind": {
            "description": "Scope type (session, approval, bom-entry, ...)",
            "title": "Scope Kind",
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional thread title",
            "title": "Title"
          }
        },
        "required": [
          "scope_kind",
          "scope_entity_id"
        ],
        "title": "CreateThreadRequest",
        "type": "object"
      },
      "CurrentItemRow": {
        "properties": {
          "author": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author"
          },
          "change_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Change Reason"
          },
          "drafts": {
            "items": {
              "$ref": "#/components/schemas/RevisionStateResponse"
            },
            "title": "Drafts",
            "type": "array"
          },
          "evidence_count": {
            "title": "Evidence Count",
            "type": "integer"
          },
          "evidence_state": {
            "title": "Evidence State",
            "type": "string"
          },
          "gate_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate Id"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Node Id"
          },
          "ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ref"
          },
          "revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revision"
          },
          "revision_count": {
            "title": "Revision Count",
            "type": "integer"
          },
          "revision_status": {
            "title": "Revision Status",
            "type": "string"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "validation_status": {
            "title": "Validation Status",
            "type": "string"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "revision_status",
          "validation_status",
          "revision_count",
          "evidence_state",
          "evidence_count"
        ],
        "title": "CurrentItemRow",
        "type": "object"
      },
      "CurrentViewResponse": {
        "properties": {
          "counts": {
            "additionalProperties": true,
            "title": "Counts",
            "type": "object"
          },
          "groups": {
            "items": {
              "$ref": "#/components/schemas/ItemGroup"
            },
            "title": "Groups",
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/CurrentItemRow"
            },
            "title": "Items",
            "type": "array"
          },
          "latest_baseline": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BaselineSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "other": {
            "items": {
              "$ref": "#/components/schemas/OtherRow"
            },
            "title": "Other",
            "type": "array"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "readiness": {
            "title": "Readiness",
            "type": "integer"
          },
          "records": {
            "items": {
              "$ref": "#/components/schemas/RecordRowResponse"
            },
            "title": "Records",
            "type": "array"
          }
        },
        "required": [
          "items",
          "groups",
          "records",
          "other",
          "counts",
          "readiness"
        ],
        "title": "CurrentViewResponse",
        "type": "object"
      },
      "DecisionRecord": {
        "description": "Who decided, and through what (FORGE-507).",
        "properties": {
          "agent": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Agent"
          },
          "approver": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approver"
          },
          "approver_verified": {
            "default": false,
            "title": "Approver Verified",
            "type": "boolean"
          },
          "decided_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decided At"
          },
          "decision": {
            "title": "Decision",
            "type": "string"
          },
          "on_behalf_of": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "On Behalf Of"
          },
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          },
          "surface": {
            "default": "unknown",
            "enum": [
              "dashboard",
              "cli",
              "agent",
              "chat",
              "unknown"
            ],
            "title": "Surface",
            "type": "string"
          }
        },
        "required": [
          "decision"
        ],
        "title": "DecisionRecord",
        "type": "object"
      },
      "DecisionRequest": {
        "additionalProperties": true,
        "description": "Body for ``POST /v1/approvals/{id}/decision``.\n\n``reviewer`` and ``approved_by`` are accepted (older clients send them) and\nignored: the deciding human is the authenticated principal.",
        "properties": {
          "decision": {
            "enum": [
              "approve",
              "reject",
              "retry",
              "rework"
            ],
            "title": "Decision",
            "type": "string"
          },
          "reason": {
            "default": "",
            "maxLength": 2000,
            "title": "Reason",
            "type": "string"
          },
          "to_phase": {
            "default": "",
            "maxLength": 200,
            "title": "To Phase",
            "type": "string"
          }
        },
        "required": [
          "decision"
        ],
        "title": "DecisionRequest",
        "type": "object"
      },
      "DeltaTransform": {
        "description": "Delta of a dragged group: translation (mm), or \u2014 additively, MET-611 \u2014\na single-axis rotation or scale. Exactly one kind is populated per request,\nmatching whichever gizmo mode produced it on the client.",
        "properties": {
          "dx": {
            "default": 0.0,
            "title": "Dx",
            "type": "number"
          },
          "dy": {
            "default": 0.0,
            "title": "Dy",
            "type": "number"
          },
          "dz": {
            "default": 0.0,
            "title": "Dz",
            "type": "number"
          },
          "rotation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RotationDelta"
              },
              {
                "type": "null"
              }
            ]
          },
          "scale": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ScaleDelta"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "DeltaTransform",
        "type": "object"
      },
      "DependencyStatus": {
        "description": "Health status for a single component or the overall system.",
        "enum": [
          "healthy",
          "degraded",
          "unhealthy"
        ],
        "title": "DependencyStatus",
        "type": "string"
      },
      "DerivedPrdResponse": {
        "properties": {
          "markdown": {
            "title": "Markdown",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "prose_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prose Ref"
          },
          "refs": {
            "items": {
              "type": "string"
            },
            "title": "Refs",
            "type": "array"
          },
          "requirement_count": {
            "default": 0,
            "title": "Requirement Count",
            "type": "integer"
          },
          "requirement_refs": {
            "items": {
              "type": "string"
            },
            "title": "Requirement Refs",
            "type": "array"
          },
          "sources": {
            "items": {
              "$ref": "#/components/schemas/PrdSource"
            },
            "title": "Sources",
            "type": "array"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "markdown"
        ],
        "title": "DerivedPrdResponse",
        "type": "object"
      },
      "DesignChangeProposal": {
        "description": "A proposed design change awaiting human review.\n\nCreated by agents when they want to modify the Digital Twin.\nMust be approved before the change is applied.",
        "properties": {
          "agent_code": {
            "description": "Code of the agent proposing the change",
            "minLength": 1,
            "title": "Agent Code",
            "type": "string"
          },
          "change_id": {
            "description": "Unique proposal identifier",
            "format": "uuid",
            "title": "Change Id",
            "type": "string"
          },
          "created_at": {
            "description": "When the proposal was created",
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "decided_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the proposal was approved or rejected",
            "title": "Decided At"
          },
          "decision_agent": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For an agent decision, the agent that took it (FORGE-510)",
            "title": "Decision Agent"
          },
          "decision_on_behalf_of": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For an agent decision, the human it acted for (FORGE-507)",
            "title": "Decision On Behalf Of"
          },
          "decision_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reviewer's reason for the decision",
            "title": "Decision Reason"
          },
          "decision_surface": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "dashboard, cli or agent: where the decision was made (FORGE-507)",
            "title": "Decision Surface"
          },
          "description": {
            "description": "Human-readable description of what the change does",
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "diff": {
            "additionalProperties": true,
            "description": "Structured diff of the proposed changes",
            "title": "Diff",
            "type": "object"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project this proposal belongs to (for dashboard scoping, MET-518)",
            "title": "Project Id"
          },
          "requires_approval": {
            "default": true,
            "description": "Whether this change requires explicit human approval",
            "title": "Requires Approval",
            "type": "boolean"
          },
          "reviewer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who approved or rejected the proposal",
            "title": "Reviewer"
          },
          "reviewer_verified": {
            "default": false,
            "description": "Whether the reviewer identity was verified (FORGE-507)",
            "title": "Reviewer Verified",
            "type": "boolean"
          },
          "session_id": {
            "description": "Session under which this proposal was created",
            "format": "uuid",
            "title": "Session Id",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/ChangeStatus",
            "default": "pending",
            "description": "Current lifecycle status of the proposal"
          },
          "work_products_affected": {
            "description": "UUIDs of Digital Twin work_products affected by this change",
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "title": "Work Products Affected",
            "type": "array"
          }
        },
        "required": [
          "agent_code",
          "description"
        ],
        "title": "DesignChangeProposal",
        "type": "object"
      },
      "DesignFlowListResponse": {
        "properties": {
          "defaultFlowId": {
            "title": "Defaultflowid",
            "type": "string"
          },
          "flows": {
            "items": {
              "$ref": "#/components/schemas/DesignFlowView"
            },
            "title": "Flows",
            "type": "array"
          }
        },
        "required": [
          "flows",
          "defaultFlowId"
        ],
        "title": "DesignFlowListResponse",
        "type": "object"
      },
      "DesignFlowView": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "graph": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Graph"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "isDefault": {
            "default": false,
            "title": "Isdefault",
            "type": "boolean"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "phases": {
            "items": {
              "$ref": "#/components/schemas/PhaseView"
            },
            "title": "Phases",
            "type": "array"
          },
          "valid": {
            "default": true,
            "title": "Valid",
            "type": "boolean"
          },
          "version": {
            "title": "Version",
            "type": "string"
          },
          "violations": {
            "items": {
              "type": "string"
            },
            "title": "Violations",
            "type": "array"
          }
        },
        "required": [
          "id",
          "name",
          "label",
          "description",
          "version"
        ],
        "title": "DesignFlowView",
        "type": "object"
      },
      "EditFlowRequest": {
        "description": "A whole edited flow, plus the template it descends from.\n\nThe editor sends the full flow rather than a patch. A patch would need the\nclient and server to agree on how to apply it, and a disagreement there is\na flow that is not what the person on the canvas was looking at when they\npressed save.",
        "properties": {
          "baseTemplateId": {
            "title": "Basetemplateid",
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "phases": {
            "items": {
              "$ref": "#/components/schemas/EditPhase"
            },
            "title": "Phases",
            "type": "array"
          }
        },
        "required": [
          "baseTemplateId",
          "phases"
        ],
        "title": "EditFlowRequest",
        "type": "object"
      },
      "EditGate": {
        "properties": {
          "autoApprove": {
            "default": false,
            "title": "Autoapprove",
            "type": "boolean"
          },
          "criteria": {
            "items": {
              "type": "string"
            },
            "title": "Criteria",
            "type": "array"
          },
          "enforceConstraints": {
            "default": false,
            "title": "Enforceconstraints",
            "type": "boolean"
          },
          "gateId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gateid"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "EditGate",
        "type": "object"
      },
      "EditPhase": {
        "properties": {
          "condition": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Condition"
          },
          "dependsOn": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dependson"
          },
          "disciplines": {
            "items": {
              "type": "string"
            },
            "title": "Disciplines",
            "type": "array"
          },
          "enforceDeliverables": {
            "default": true,
            "title": "Enforcedeliverables",
            "type": "boolean"
          },
          "expectedArtifacts": {
            "items": {
              "type": "string"
            },
            "title": "Expectedartifacts",
            "type": "array"
          },
          "gate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EditGate"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Model"
          },
          "objective": {
            "title": "Objective",
            "type": "string"
          },
          "outcome": {
            "default": "",
            "title": "Outcome",
            "type": "string"
          },
          "requiredDeliverables": {
            "items": {
              "type": "string"
            },
            "title": "Requireddeliverables",
            "type": "array"
          },
          "slots": {
            "items": {
              "$ref": "#/components/schemas/EditSlot"
            },
            "title": "Slots",
            "type": "array"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "objective"
        ],
        "title": "EditPhase",
        "type": "object"
      },
      "EditSlot": {
        "properties": {
          "derived": {
            "default": false,
            "title": "Derived",
            "type": "boolean"
          },
          "itemKey": {
            "default": "",
            "title": "Itemkey",
            "type": "string"
          },
          "itemType": {
            "title": "Itemtype",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "itemType",
          "name"
        ],
        "title": "EditSlot",
        "type": "object"
      },
      "EmittedJoint": {
        "description": "What was actually written for one joint, post type-resolution\n(FORGE-240) -- e.g. a revolute joint with caller-supplied limits is\nemitted as a real bounded ``revolute`` type, not the unlimited\n``continuous``/``PhysicsRevoluteJoint``-without-limits a caller might\notherwise assume from the input alone. Lets the reporting agent state\nwhat the file actually contains instead of guessing or fabricating.",
        "properties": {
          "limits": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EmittedJointLimits"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "name",
          "type"
        ],
        "title": "EmittedJoint",
        "type": "object"
      },
      "EmittedJointLimits": {
        "properties": {
          "effort": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Effort"
          },
          "lower": {
            "title": "Lower",
            "type": "number"
          },
          "upper": {
            "title": "Upper",
            "type": "number"
          },
          "velocity": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Velocity"
          }
        },
        "required": [
          "lower",
          "upper"
        ],
        "title": "EmittedJointLimits",
        "type": "object"
      },
      "EvidenceResponse": {
        "description": "Response for evidence operations.",
        "properties": {
          "checklist_item_id": {
            "title": "Checklist Item Id",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "evidence_type": {
            "title": "Evidence Type",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "uploaded_at": {
            "title": "Uploaded At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "checklist_item_id",
          "evidence_type",
          "status",
          "title",
          "description",
          "uploaded_at"
        ],
        "title": "EvidenceResponse",
        "type": "object"
      },
      "EvidenceSummary": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "limit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limit"
          },
          "margin": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Margin"
          },
          "method": {
            "title": "Method",
            "type": "string"
          },
          "staleness": {
            "title": "Staleness",
            "type": "string"
          },
          "tier": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tier"
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Value"
          }
        },
        "required": [
          "id",
          "method",
          "staleness"
        ],
        "title": "EvidenceSummary",
        "type": "object"
      },
      "EvidenceType": {
        "description": "Types of compliance evidence work_products.",
        "enum": [
          "TEST_REPORT",
          "DECLARATION",
          "CERTIFICATE",
          "TECHNICAL_FILE",
          "RISK_ASSESSMENT"
        ],
        "title": "EvidenceType",
        "type": "string"
      },
      "ExportFile": {
        "description": "A generated file, fetched via ``GET /v1/cad-export/download/{export_id}/{filename}``.",
        "properties": {
          "download_url": {
            "title": "Download Url",
            "type": "string"
          },
          "filename": {
            "title": "Filename",
            "type": "string"
          }
        },
        "required": [
          "filename",
          "download_url"
        ],
        "title": "ExportFile",
        "type": "object"
      },
      "FallbackInfo": {
        "description": "The most recent time a harness role ran on something other than its primary.",
        "properties": {
          "at": {
            "title": "At",
            "type": "string"
          },
          "error": {
            "title": "Error",
            "type": "string"
          },
          "fallback": {
            "title": "Fallback",
            "type": "string"
          },
          "fallback_model": {
            "title": "Fallback Model",
            "type": "string"
          },
          "primary": {
            "title": "Primary",
            "type": "string"
          },
          "primary_model": {
            "title": "Primary Model",
            "type": "string"
          },
          "reason": {
            "title": "Reason",
            "type": "string"
          },
          "role": {
            "title": "Role",
            "type": "string"
          }
        },
        "required": [
          "role",
          "primary",
          "primary_model",
          "fallback",
          "fallback_model",
          "error",
          "reason",
          "at"
        ],
        "title": "FallbackInfo",
        "type": "object"
      },
      "FeatureDiffResponse": {
        "properties": {
          "added": {
            "additionalProperties": true,
            "title": "Added",
            "type": "object"
          },
          "changed": {
            "additionalProperties": {
              "$ref": "#/components/schemas/FieldDelta"
            },
            "title": "Changed",
            "type": "object"
          },
          "currentWorkProductId": {
            "title": "Currentworkproductid",
            "type": "string"
          },
          "previousWorkProductId": {
            "title": "Previousworkproductid",
            "type": "string"
          },
          "removed": {
            "additionalProperties": true,
            "title": "Removed",
            "type": "object"
          }
        },
        "required": [
          "currentWorkProductId",
          "previousWorkProductId",
          "changed",
          "added",
          "removed"
        ],
        "title": "FeatureDiffResponse",
        "type": "object"
      },
      "FieldDelta": {
        "description": "Change for a single metadata field.",
        "properties": {
          "from_value": {
            "title": "From Value"
          },
          "to_value": {
            "title": "To Value"
          }
        },
        "required": [
          "from_value",
          "to_value"
        ],
        "title": "FieldDelta",
        "type": "object"
      },
      "FileLinkCreateRequest": {
        "description": "Request body for creating a file link.",
        "properties": {
          "source_path": {
            "description": "Absolute path to the source file",
            "title": "Source Path",
            "type": "string"
          },
          "tool": {
            "default": "",
            "description": "Tool identifier (kicad, freecad, cadquery)",
            "title": "Tool",
            "type": "string"
          },
          "watch": {
            "default": true,
            "description": "Enable file watching",
            "title": "Watch",
            "type": "boolean"
          }
        },
        "required": [
          "source_path"
        ],
        "title": "FileLinkCreateRequest",
        "type": "object"
      },
      "FileLinkResponse": {
        "description": "API response for a file link.",
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "last_synced_at": {
            "title": "Last Synced At",
            "type": "string"
          },
          "source_hash": {
            "title": "Source Hash",
            "type": "string"
          },
          "source_path": {
            "title": "Source Path",
            "type": "string"
          },
          "sync_status": {
            "title": "Sync Status",
            "type": "string"
          },
          "tool": {
            "title": "Tool",
            "type": "string"
          },
          "watch": {
            "title": "Watch",
            "type": "boolean"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "source_path",
          "tool",
          "watch",
          "sync_status",
          "source_hash",
          "last_synced_at",
          "created_at"
        ],
        "title": "FileLinkResponse",
        "type": "object"
      },
      "FirmwareJointEntry": {
        "properties": {
          "can_id": {
            "title": "Can Id",
            "type": "integer"
          },
          "joint_name": {
            "title": "Joint Name",
            "type": "string"
          },
          "joint_type": {
            "title": "Joint Type",
            "type": "string"
          },
          "limits": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "number"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limits"
          }
        },
        "required": [
          "joint_name",
          "joint_type",
          "can_id"
        ],
        "title": "FirmwareJointEntry",
        "type": "object"
      },
      "FixRequirementResponse": {
        "properties": {
          "conclusions": {
            "items": {
              "type": "string"
            },
            "title": "Conclusions",
            "type": "array"
          },
          "proposedText": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Proposedtext"
          },
          "rationale": {
            "title": "Rationale",
            "type": "string"
          }
        },
        "required": [
          "proposedText",
          "rationale",
          "conclusions"
        ],
        "title": "FixRequirementResponse",
        "type": "object"
      },
      "FlowChangeView": {
        "properties": {
          "basis": {
            "default": "",
            "title": "Basis",
            "type": "string"
          },
          "op": {
            "title": "Op",
            "type": "string"
          },
          "phase": {
            "title": "Phase",
            "type": "string"
          },
          "rationale": {
            "title": "Rationale",
            "type": "string"
          },
          "value": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Value"
          }
        },
        "required": [
          "op",
          "phase",
          "rationale"
        ],
        "title": "FlowChangeView",
        "type": "object"
      },
      "FlowNeedsInputView": {
        "description": "The proposal could not be made without guessing, so it asks instead.\n\nCarries no flow and no ``approvalId``: nothing was generated, stored or\nheld. Answer the questions and resubmit the same request with them.",
        "properties": {
          "intent": {
            "title": "Intent",
            "type": "string"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "title": "Notes",
            "type": "array"
          },
          "questions": {
            "items": {
              "$ref": "#/components/schemas/QuestionView"
            },
            "title": "Questions",
            "type": "array"
          },
          "status": {
            "const": "needs_input",
            "default": "needs_input",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "intent",
          "questions",
          "message"
        ],
        "title": "FlowNeedsInputView",
        "type": "object"
      },
      "FlowPhaseState": {
        "description": "One phase, as the live run view draws it.",
        "properties": {
          "artifacts": {
            "items": {
              "type": "string"
            },
            "title": "Artifacts",
            "type": "array"
          },
          "disciplines": {
            "items": {
              "type": "string"
            },
            "title": "Disciplines",
            "type": "array"
          },
          "gate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "summary": {
            "default": "",
            "title": "Summary",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "usage": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Usage"
          }
        },
        "required": [
          "id",
          "title",
          "status"
        ],
        "title": "FlowPhaseState",
        "type": "object"
      },
      "FlowProposalView": {
        "description": "A tailored flow, awaiting a human.\n\n``approvalId`` is the held write. Nothing starts from a proposal: a run\nis created from the *approved* flow, and until somebody answers that\napproval there is nothing to run.",
        "properties": {
          "approvalId": {
            "title": "Approvalid",
            "type": "string"
          },
          "assumptions": {
            "items": {
              "type": "string"
            },
            "title": "Assumptions",
            "type": "array"
          },
          "baseTemplateId": {
            "title": "Basetemplateid",
            "type": "string"
          },
          "baseVersion": {
            "title": "Baseversion",
            "type": "string"
          },
          "capabilities": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capabilities"
          },
          "changes": {
            "items": {
              "$ref": "#/components/schemas/FlowChangeView"
            },
            "title": "Changes",
            "type": "array"
          },
          "flow": {
            "$ref": "#/components/schemas/DesignFlowView"
          },
          "generatedBy": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GeneratedByView"
              },
              {
                "type": "null"
              }
            ]
          },
          "intent": {
            "title": "Intent",
            "type": "string"
          },
          "intentModel": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Intentmodel"
          },
          "openQuestions": {
            "items": {
              "$ref": "#/components/schemas/QuestionView"
            },
            "title": "Openquestions",
            "type": "array"
          },
          "proposedBy": {
            "anyOf": [
              {
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Proposedby"
          },
          "requirementsPending": {
            "default": false,
            "title": "Requirementspending",
            "type": "boolean"
          },
          "status": {
            "const": "proposed",
            "default": "proposed",
            "title": "Status",
            "type": "string"
          },
          "valid": {
            "title": "Valid",
            "type": "boolean"
          },
          "versionId": {
            "title": "Versionid",
            "type": "string"
          },
          "violations": {
            "items": {
              "type": "string"
            },
            "title": "Violations",
            "type": "array"
          }
        },
        "required": [
          "approvalId",
          "versionId",
          "baseTemplateId",
          "baseVersion",
          "intent",
          "flow",
          "valid"
        ],
        "title": "FlowProposalView",
        "type": "object"
      },
      "FlowRunState": {
        "description": "Live state of a design-flow run (FORGE-396).\n\nRead from the workflow itself rather than a cache of it. A projection that\ncan be stale is a live view that is sometimes wrong, and nothing on the\npage would say which.",
        "properties": {
          "attempt": {
            "default": 1,
            "title": "Attempt",
            "type": "integer"
          },
          "awaitingGate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Awaitinggate"
          },
          "currentPhase": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Currentphase"
          },
          "detail": {
            "default": "",
            "title": "Detail",
            "type": "string"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "events": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Events",
            "type": "array"
          },
          "flow": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flow"
          },
          "flowContentHash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flowcontenthash"
          },
          "flowVersion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flowversion"
          },
          "flowVersionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flowversionid"
          },
          "gateFindings": {
            "items": {
              "type": "string"
            },
            "title": "Gatefindings",
            "type": "array"
          },
          "gateReady": {
            "default": true,
            "title": "Gateready",
            "type": "boolean"
          },
          "live": {
            "default": true,
            "title": "Live",
            "type": "boolean"
          },
          "maxReworkCycles": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxreworkcycles"
          },
          "phases": {
            "items": {
              "$ref": "#/components/schemas/FlowPhaseState"
            },
            "title": "Phases",
            "type": "array"
          },
          "retriesLeft": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retriesleft"
          },
          "reworkCycles": {
            "default": 0,
            "title": "Reworkcycles",
            "type": "integer"
          },
          "reworksLeft": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reworksleft"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "usage": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Usage"
          }
        },
        "required": [
          "runId",
          "status"
        ],
        "title": "FlowRunState",
        "type": "object"
      },
      "FlowVersionView": {
        "properties": {
          "approvalId": {
            "title": "Approvalid",
            "type": "string"
          },
          "baseTemplateId": {
            "title": "Basetemplateid",
            "type": "string"
          },
          "baseVersion": {
            "title": "Baseversion",
            "type": "string"
          },
          "changes": {
            "items": {
              "type": "string"
            },
            "title": "Changes",
            "type": "array"
          },
          "context": {
            "default": "",
            "title": "Context",
            "type": "string"
          },
          "flow": {
            "$ref": "#/components/schemas/DesignFlowView"
          },
          "origin": {
            "title": "Origin",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "valid": {
            "title": "Valid",
            "type": "boolean"
          },
          "versionId": {
            "title": "Versionid",
            "type": "string"
          },
          "violations": {
            "items": {
              "type": "string"
            },
            "title": "Violations",
            "type": "array"
          }
        },
        "required": [
          "versionId",
          "approvalId",
          "baseTemplateId",
          "baseVersion",
          "status",
          "origin",
          "flow",
          "valid"
        ],
        "title": "FlowVersionView",
        "type": "object"
      },
      "FromTextRequest": {
        "description": "Compile a plain-English description into an assembly, then build it.",
        "properties": {
          "description": {
            "description": "Plain-English description of the part/assembly.",
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "LLM model override for translation.",
            "title": "Model"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Override the assembly name (else the model chooses one).",
            "title": "Name"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to scope the cad_model to.",
            "title": "Project Id"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "LLM provider override for translation.",
            "title": "Provider"
          }
        },
        "required": [
          "description"
        ],
        "title": "FromTextRequest",
        "type": "object"
      },
      "FromTextResponse": {
        "description": "The built assembly plus the spec the model generated (for review).",
        "properties": {
          "content_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Hash"
          },
          "minio_object_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Minio Object Key"
          },
          "model_url": {
            "title": "Model Url",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "part_count": {
            "title": "Part Count",
            "type": "integer"
          },
          "spec": {
            "$ref": "#/components/schemas/CreateAssemblyRequest-Output",
            "description": "The declarative spec compiled from the description."
          }
        },
        "required": [
          "node_id",
          "model_url",
          "part_count",
          "spec"
        ],
        "title": "FromTextResponse",
        "type": "object"
      },
      "GateFinding": {
        "description": "One thing a gate found, classified so a UI need not parse prose.",
        "properties": {
          "kind": {
            "enum": [
              "missing_deliverable",
              "ungrounded",
              "constraint_violation",
              "analysis",
              "geometry",
              "other"
            ],
            "title": "Kind",
            "type": "string"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "severity": {
            "default": "error",
            "enum": [
              "error",
              "warning",
              "info"
            ],
            "title": "Severity",
            "type": "string"
          }
        },
        "required": [
          "kind",
          "message"
        ],
        "title": "GateFinding",
        "type": "object"
      },
      "GateOpenedRequest": {
        "properties": {
          "gate": {
            "minLength": 1,
            "title": "Gate",
            "type": "string"
          },
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          }
        },
        "required": [
          "gate"
        ],
        "title": "GateOpenedRequest",
        "type": "object"
      },
      "GateView": {
        "properties": {
          "autoApprove": {
            "default": false,
            "title": "Autoapprove",
            "type": "boolean"
          },
          "criteria": {
            "items": {
              "type": "string"
            },
            "title": "Criteria",
            "type": "array"
          },
          "enforceConstraints": {
            "default": false,
            "title": "Enforceconstraints",
            "type": "boolean"
          },
          "gateId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gateid"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "GateView",
        "type": "object"
      },
      "GenerateFeatureRequest": {
        "properties": {
          "adapter": {
            "default": "freecad",
            "title": "Adapter",
            "type": "string"
          },
          "commit": {
            "default": true,
            "title": "Commit",
            "type": "boolean"
          },
          "feature": {
            "additionalProperties": true,
            "title": "Feature",
            "type": "object"
          },
          "material": {
            "default": "aluminum_6061",
            "title": "Material",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "workProductId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workproductid"
          }
        },
        "required": [
          "name",
          "feature"
        ],
        "title": "GenerateFeatureRequest",
        "type": "object"
      },
      "GenerateTestPlanRequest": {
        "properties": {
          "project_id": {
            "title": "Project Id",
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "title": "GenerateTestPlanRequest",
        "type": "object"
      },
      "GenerateTestPlanResponse": {
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/TestPlanEntry"
            },
            "title": "Entries",
            "type": "array"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "entries"
        ],
        "title": "GenerateTestPlanResponse",
        "type": "object"
      },
      "GeneratedByView": {
        "description": "The provider and model that actually produced a proposal (FORGE-468).",
        "properties": {
          "fellBackFrom": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fellbackfrom"
          },
          "model": {
            "title": "Model",
            "type": "string"
          },
          "provider": {
            "title": "Provider",
            "type": "string"
          }
        },
        "required": [
          "provider",
          "model"
        ],
        "title": "GeneratedByView",
        "type": "object"
      },
      "GeometryDiffResponse": {
        "description": "Real volume/area/bounding-box delta vs. a SUPERSEDES predecessor\n(FORGE-301) -- distinct from ``RevisionDiff`` above, which diffs one\nnode's own metadata revisions and never sees geometry changes.",
        "properties": {
          "area_delta_mm2": {
            "title": "Area Delta Mm2",
            "type": "number"
          },
          "current_area_mm2": {
            "title": "Current Area Mm2",
            "type": "number"
          },
          "current_bounding_box": {
            "additionalProperties": true,
            "title": "Current Bounding Box",
            "type": "object"
          },
          "current_volume_mm3": {
            "title": "Current Volume Mm3",
            "type": "number"
          },
          "current_work_product_id": {
            "title": "Current Work Product Id",
            "type": "string"
          },
          "previous_area_mm2": {
            "title": "Previous Area Mm2",
            "type": "number"
          },
          "previous_bounding_box": {
            "additionalProperties": true,
            "title": "Previous Bounding Box",
            "type": "object"
          },
          "previous_volume_mm3": {
            "title": "Previous Volume Mm3",
            "type": "number"
          },
          "previous_work_product_id": {
            "title": "Previous Work Product Id",
            "type": "string"
          },
          "volume_delta_mm3": {
            "title": "Volume Delta Mm3",
            "type": "number"
          }
        },
        "required": [
          "current_work_product_id",
          "previous_work_product_id",
          "current_volume_mm3",
          "previous_volume_mm3",
          "volume_delta_mm3",
          "current_area_mm2",
          "previous_area_mm2",
          "area_delta_mm2",
          "current_bounding_box",
          "previous_bounding_box"
        ],
        "title": "GeometryDiffResponse",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "HarnessEstimateResponse": {
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/HarnessJointEntry"
            },
            "title": "Joints",
            "type": "array"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "joints"
        ],
        "title": "HarnessEstimateResponse",
        "type": "object"
      },
      "HarnessJointEntry": {
        "properties": {
          "base": {
            "title": "Base",
            "type": "string"
          },
          "cable_length_estimate_mm": {
            "title": "Cable Length Estimate Mm",
            "type": "number"
          },
          "follower": {
            "title": "Follower",
            "type": "string"
          },
          "joint_name": {
            "title": "Joint Name",
            "type": "string"
          },
          "joint_type": {
            "title": "Joint Type",
            "type": "string"
          },
          "segment_length_mm": {
            "title": "Segment Length Mm",
            "type": "number"
          },
          "step_number": {
            "title": "Step Number",
            "type": "integer"
          }
        },
        "required": [
          "step_number",
          "joint_name",
          "joint_type",
          "base",
          "follower",
          "segment_length_mm",
          "cable_length_estimate_mm"
        ],
        "title": "HarnessJointEntry",
        "type": "object"
      },
      "HealthResponse": {
        "description": "Top-level response from ``GET /health``.",
        "properties": {
          "auth_mode": {
            "default": "off",
            "title": "Auth Mode",
            "type": "string"
          },
          "components": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ComponentHealth"
            },
            "title": "Components",
            "type": "array"
          },
          "status": {
            "$ref": "#/components/schemas/DependencyStatus"
          },
          "timestamp": {
            "format": "date-time",
            "title": "Timestamp",
            "type": "string"
          },
          "uptime_seconds": {
            "title": "Uptime Seconds",
            "type": "number"
          },
          "version": {
            "default": "0.1.0",
            "title": "Version",
            "type": "string"
          }
        },
        "required": [
          "status",
          "uptime_seconds",
          "timestamp"
        ],
        "title": "HealthResponse",
        "type": "object"
      },
      "HierarchicalBomLineResponse": {
        "description": "One derived EBOM line, in the dashboard's camelCase shape.",
        "properties": {
          "componentId": {
            "title": "Componentid",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "hierarchyNodeId": {
            "title": "Hierarchynodeid",
            "type": "string"
          },
          "manufacturer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manufacturer"
          },
          "partNumber": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Partnumber"
          },
          "path": {
            "items": {
              "type": "string"
            },
            "title": "Path",
            "type": "array"
          },
          "quantity": {
            "title": "Quantity",
            "type": "number"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "unitCost": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unitcost"
          }
        },
        "required": [
          "hierarchyNodeId",
          "path",
          "quantity",
          "source",
          "componentId",
          "description"
        ],
        "title": "HierarchicalBomLineResponse",
        "type": "object"
      },
      "HierarchicalBomResponse": {
        "properties": {
          "lines": {
            "items": {
              "$ref": "#/components/schemas/HierarchicalBomLineResponse"
            },
            "title": "Lines",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "lines",
          "total"
        ],
        "title": "HierarchicalBomResponse",
        "type": "object"
      },
      "HierarchyNodeResponse": {
        "description": "One HierarchyNode, in the dashboard's camelCase shape.",
        "properties": {
          "cost": {
            "title": "Cost",
            "type": "number"
          },
          "costBudget": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Costbudget"
          },
          "costBudgetDiscipline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Costbudgetdiscipline"
          },
          "costBudgetOwner": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Costbudgetowner"
          },
          "costOverBudget": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Costoverbudget"
          },
          "dissipationW": {
            "title": "Dissipationw",
            "type": "number"
          },
          "drawAverageW": {
            "title": "Drawaveragew",
            "type": "number"
          },
          "drawPeakW": {
            "title": "Drawpeakw",
            "type": "number"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "instanceOfBomItemId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Instanceofbomitemid"
          },
          "interfaces": {
            "items": {
              "$ref": "#/components/schemas/InterfaceSummary"
            },
            "title": "Interfaces",
            "type": "array"
          },
          "kind": {
            "title": "Kind",
            "type": "string"
          },
          "massBudgetDiscipline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Massbudgetdiscipline"
          },
          "massBudgetKg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Massbudgetkg"
          },
          "massBudgetOwner": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Massbudgetowner"
          },
          "massKg": {
            "title": "Masskg",
            "type": "number"
          },
          "massOverBudget": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Massoverbudget"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "outputW": {
            "title": "Outputw",
            "type": "number"
          },
          "parentId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentid"
          },
          "placement": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Placement"
          },
          "quantity": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quantity"
          },
          "realizedByWorkProductId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Realizedbyworkproductid"
          }
        },
        "required": [
          "id",
          "name",
          "kind",
          "massKg",
          "cost",
          "drawPeakW",
          "drawAverageW",
          "outputW",
          "dissipationW"
        ],
        "title": "HierarchyNodeResponse",
        "type": "object"
      },
      "HierarchyTreeResponse": {
        "properties": {
          "malformedBudgets": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/MalformedBudgetResponse"
            },
            "title": "Malformedbudgets",
            "type": "array"
          },
          "nodes": {
            "items": {
              "$ref": "#/components/schemas/HierarchyNodeResponse"
            },
            "title": "Nodes",
            "type": "array"
          }
        },
        "required": [
          "nodes"
        ],
        "title": "HierarchyTreeResponse",
        "type": "object"
      },
      "HoldToolCallRequest": {
        "description": "Park a tool call from another process in this ledger (FORGE-406).",
        "properties": {
          "arguments": {
            "additionalProperties": true,
            "title": "Arguments",
            "type": "object"
          },
          "caller": {
            "default": "untrusted",
            "title": "Caller",
            "type": "string"
          },
          "client": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client"
          },
          "project": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project"
          },
          "reason": {
            "title": "Reason",
            "type": "string"
          },
          "route": {
            "default": "dashboard",
            "enum": [
              "dashboard",
              "elicitation"
            ],
            "title": "Route",
            "type": "string"
          },
          "session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          },
          "source": {
            "default": "mcp",
            "title": "Source",
            "type": "string"
          },
          "timeout_seconds": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "maximum": 3600.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timeout Seconds"
          },
          "tool": {
            "title": "Tool",
            "type": "string"
          }
        },
        "required": [
          "tool",
          "reason"
        ],
        "title": "HoldToolCallRequest",
        "type": "object"
      },
      "Hole": {
        "description": "A mounting/fastener hole drilled into a part (local part frame, mm).",
        "properties": {
          "depth": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Depth from the top face (mm); through-hole if omitted.",
            "title": "Depth"
          },
          "diameter": {
            "description": "Hole diameter (mm).",
            "exclusiveMinimum": 0.0,
            "title": "Diameter",
            "type": "number"
          },
          "x": {
            "description": "Hole centre X in the part's local frame (mm).",
            "title": "X",
            "type": "number"
          },
          "y": {
            "description": "Hole centre Y in the part's local frame (mm).",
            "title": "Y",
            "type": "number"
          }
        },
        "required": [
          "x",
          "y",
          "diameter"
        ],
        "title": "Hole",
        "type": "object"
      },
      "ImportWorkProductResponse": {
        "description": "Response from a successful work product import.",
        "properties": {
          "content_hash": {
            "description": "SHA-256 of file content",
            "title": "Content Hash",
            "type": "string"
          },
          "created_at": {
            "description": "ISO-8601 creation timestamp",
            "title": "Created At",
            "type": "string"
          },
          "domain": {
            "description": "Domain (mechanical, electronics, etc.)",
            "title": "Domain",
            "type": "string"
          },
          "file_path": {
            "description": "Stored file path",
            "title": "File Path",
            "type": "string"
          },
          "format": {
            "description": "File format (step, kicad_sch, etc.)",
            "title": "Format",
            "type": "string"
          },
          "id": {
            "description": "WorkProduct UUID",
            "title": "Id",
            "type": "string"
          },
          "metadata": {
            "additionalProperties": true,
            "description": "Extracted metadata",
            "title": "Metadata",
            "type": "object"
          },
          "name": {
            "description": "WorkProduct name",
            "title": "Name",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Linked project ID",
            "title": "Project Id"
          },
          "wp_type": {
            "description": "WorkProduct type",
            "title": "Wp Type",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "domain",
          "wp_type",
          "file_path",
          "content_hash",
          "format",
          "created_at"
        ],
        "title": "ImportWorkProductResponse",
        "type": "object"
      },
      "IngestDocumentRequest": {
        "description": "Request body for L1 document ingestion via ``KnowledgeService`` (MET-336).",
        "properties": {
          "content": {
            "minLength": 1,
            "title": "Content",
            "type": "string"
          },
          "knowledgeType": {
            "$ref": "#/components/schemas/KnowledgeType"
          },
          "metadata": {
            "additionalProperties": true,
            "title": "Metadata",
            "type": "object"
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "sourcePath": {
            "minLength": 1,
            "title": "Sourcepath",
            "type": "string"
          },
          "sourceWorkProductId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceworkproductid"
          }
        },
        "required": [
          "content",
          "sourcePath",
          "knowledgeType"
        ],
        "title": "IngestDocumentRequest",
        "type": "object"
      },
      "IngestDocumentResponse": {
        "description": "L1 ingest result \u2014 mirrors ``IngestResult`` (MET-336).",
        "properties": {
          "chunksIndexed": {
            "title": "Chunksindexed",
            "type": "integer"
          },
          "entryIds": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "title": "Entryids",
            "type": "array"
          },
          "sourcePath": {
            "title": "Sourcepath",
            "type": "string"
          }
        },
        "required": [
          "entryIds",
          "chunksIndexed",
          "sourcePath"
        ],
        "title": "IngestDocumentResponse",
        "type": "object"
      },
      "IngestRequest": {
        "description": "Request body for manual knowledge ingestion.",
        "properties": {
          "content": {
            "minLength": 1,
            "title": "Content",
            "type": "string"
          },
          "knowledgeType": {
            "$ref": "#/components/schemas/KnowledgeType"
          },
          "metadata": {
            "additionalProperties": true,
            "title": "Metadata",
            "type": "object"
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "sourcePath": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcepath"
          },
          "sourceWorkProductId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceworkproductid"
          }
        },
        "required": [
          "content",
          "knowledgeType"
        ],
        "title": "IngestRequest",
        "type": "object"
      },
      "IngestResponse": {
        "description": "Response from the knowledge ingest endpoint.",
        "properties": {
          "embedded": {
            "title": "Embedded",
            "type": "boolean"
          },
          "entryId": {
            "format": "uuid",
            "title": "Entryid",
            "type": "string"
          }
        },
        "required": [
          "entryId",
          "embedded"
        ],
        "title": "IngestResponse",
        "type": "object"
      },
      "InlineDecisionRequest": {
        "description": "Body for ``POST /v1/approvals/{id}/inline-decision`` (FORGE-582).\n\nA person answered a gate in the MCP client's own prompt. The sidecar that\nasked records it here. ``approver`` is who the sidecar's authenticated\nMCP session says answered; it is recorded as verified only when this\nrequest itself is authenticated, the same rule a held tool call's inline\nanswer follows (FORGE-473).",
        "properties": {
          "approver": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approver"
          },
          "approver_verified": {
            "default": false,
            "title": "Approver Verified",
            "type": "boolean"
          },
          "decision": {
            "enum": [
              "approve",
              "reject",
              "retry",
              "rework"
            ],
            "title": "Decision",
            "type": "string"
          },
          "reason": {
            "default": "",
            "maxLength": 2000,
            "title": "Reason",
            "type": "string"
          },
          "to_phase": {
            "default": "",
            "maxLength": 200,
            "title": "To Phase",
            "type": "string"
          }
        },
        "required": [
          "decision"
        ],
        "title": "InlineDecisionRequest",
        "type": "object"
      },
      "InsightKind": {
        "description": "What kind of statement the insight is.",
        "enum": [
          "pattern",
          "principle",
          "failure_mode",
          "observation"
        ],
        "title": "InsightKind",
        "type": "string"
      },
      "InsightListResponse": {
        "description": "Response body for ``GET /v1/memory/insights``.",
        "properties": {
          "includeStale": {
            "title": "Includestale",
            "type": "boolean"
          },
          "insights": {
            "items": {
              "$ref": "#/components/schemas/InsightResponse"
            },
            "title": "Insights",
            "type": "array"
          },
          "theme": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConsolidationTheme"
              },
              {
                "type": "null"
              }
            ]
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "insights",
          "total",
          "includeStale"
        ],
        "title": "InsightListResponse",
        "type": "object"
      },
      "InsightResponse": {
        "description": "Wire shape of a single consolidated insight.",
        "properties": {
          "confidence": {
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Confidence",
            "type": "number"
          },
          "confidenceTier": {
            "$ref": "#/components/schemas/ConfidenceTier"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/InsightKind"
          },
          "narrative": {
            "title": "Narrative",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/InsightStatus"
          },
          "supportingExperienceIds": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "title": "Supportingexperienceids",
            "type": "array"
          },
          "synthesizedAt": {
            "format": "date-time",
            "title": "Synthesizedat",
            "type": "string"
          },
          "theme": {
            "$ref": "#/components/schemas/ConsolidationTheme"
          }
        },
        "required": [
          "id",
          "theme",
          "kind",
          "narrative",
          "confidence",
          "confidenceTier",
          "status",
          "supportingExperienceIds",
          "synthesizedAt"
        ],
        "title": "InsightResponse",
        "type": "object"
      },
      "InsightStatus": {
        "description": "Lifecycle state of a stored insight (MET-455).\n\n* ``ACTIVE`` \u2014 trusted; surfaced to agents normally.\n* ``STALE_WARN`` \u2014 confidence has decayed (or re-validation failed);\n  flagged for review. Still readable, but consumers should treat it\n  with caution / prefer fresher insights.",
        "enum": [
          "active",
          "stale_warn"
        ],
        "title": "InsightStatus",
        "type": "string"
      },
      "IntentModelView": {
        "description": "The structured intent (see ``orchestrator.design_flow.intent``).",
        "properties": {
          "intent": {
            "additionalProperties": true,
            "title": "Intent",
            "type": "object"
          },
          "missingInputs": {
            "items": {
              "$ref": "#/components/schemas/QuestionView"
            },
            "title": "Missinginputs",
            "type": "array"
          }
        },
        "required": [
          "intent"
        ],
        "title": "IntentModelView",
        "type": "object"
      },
      "InterfaceQuantitySummary": {
        "properties": {
          "limit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limit"
          },
          "metric": {
            "title": "Metric",
            "type": "string"
          },
          "op": {
            "default": "<=",
            "title": "Op",
            "type": "string"
          },
          "unit": {
            "title": "Unit",
            "type": "string"
          }
        },
        "required": [
          "metric",
          "unit"
        ],
        "title": "InterfaceQuantitySummary",
        "type": "object"
      },
      "InterfaceSummary": {
        "description": "One interface touching a hierarchy node, dashboard-facing summary\n(not the full predicted/measured detail -- see the SYSTEM_ARCHITECTURE\nwork product itself for that).",
        "properties": {
          "description": {
            "default": "",
            "title": "Description",
            "type": "string"
          },
          "interfaceType": {
            "default": "",
            "title": "Interfacetype",
            "type": "string"
          },
          "otherComponent": {
            "title": "Othercomponent",
            "type": "string"
          },
          "quantities": {
            "items": {
              "$ref": "#/components/schemas/InterfaceQuantitySummary"
            },
            "title": "Quantities",
            "type": "array"
          }
        },
        "required": [
          "otherComponent"
        ],
        "title": "InterfaceSummary",
        "type": "object"
      },
      "InterferenceCheckResponse": {
        "description": "Real boolean-intersection result between two named parts (FORGE-272)\n-- a pairwise clearance/interference check, not an ISO 286 fit\nclassification (which this capability deliberately does not attempt;\nsee ``api_gateway.twin.interference_check``'s module docstring).",
        "properties": {
          "interference_area_mm2": {
            "title": "Interference Area Mm2",
            "type": "number"
          },
          "interference_volume_mm3": {
            "title": "Interference Volume Mm3",
            "type": "number"
          },
          "interferes": {
            "title": "Interferes",
            "type": "boolean"
          },
          "work_product_id_a": {
            "title": "Work Product Id A",
            "type": "string"
          },
          "work_product_id_b": {
            "title": "Work Product Id B",
            "type": "string"
          }
        },
        "required": [
          "work_product_id_a",
          "work_product_id_b",
          "interferes",
          "interference_volume_mm3",
          "interference_area_mm2"
        ],
        "title": "InterferenceCheckResponse",
        "type": "object"
      },
      "ItemCurrentResponse": {
        "properties": {
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "revision",
          "node_id",
          "ref"
        ],
        "title": "ItemCurrentResponse",
        "type": "object"
      },
      "ItemDiffResponse": {
        "properties": {
          "a": {
            "additionalProperties": true,
            "title": "A",
            "type": "object"
          },
          "a_ref": {
            "title": "A Ref",
            "type": "string"
          },
          "b": {
            "additionalProperties": true,
            "title": "B",
            "type": "object"
          },
          "b_ref": {
            "title": "B Ref",
            "type": "string"
          },
          "dependents": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Dependents",
            "type": "array"
          },
          "fields": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Fields",
            "type": "array"
          },
          "geometry": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Geometry"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "parameters": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Parameters",
            "type": "array"
          },
          "requirements": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Requirements",
            "type": "array"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "title": "Warnings",
            "type": "array"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "a",
          "b",
          "a_ref",
          "b_ref"
        ],
        "title": "ItemDiffResponse",
        "type": "object"
      },
      "ItemGroup": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "keys": {
            "items": {
              "type": "string"
            },
            "title": "Keys",
            "type": "array"
          }
        },
        "required": [
          "item_type",
          "count",
          "keys"
        ],
        "title": "ItemGroup",
        "type": "object"
      },
      "ItemHistoryResponse": {
        "properties": {
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ItemCurrentResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "item": {
            "$ref": "#/components/schemas/ItemResponse"
          },
          "lessons": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ItemLessonResponse"
            },
            "title": "Lessons",
            "type": "array"
          },
          "revisions": {
            "items": {
              "$ref": "#/components/schemas/ItemRevisionResponse"
            },
            "title": "Revisions",
            "type": "array"
          }
        },
        "required": [
          "item",
          "revisions"
        ],
        "title": "ItemHistoryResponse",
        "type": "object"
      },
      "ItemLessonResponse": {
        "description": "A rejected revision, kept as \"already tried, failed because\" (FORGE-530).",
        "properties": {
          "lesson": {
            "title": "Lesson",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          }
        },
        "required": [
          "ref",
          "node_id",
          "lesson"
        ],
        "title": "ItemLessonResponse",
        "type": "object"
      },
      "ItemListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ItemResponse"
            },
            "title": "Items",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "title": "ItemListResponse",
        "type": "object"
      },
      "ItemResponse": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "draft_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Draft Node Id"
          },
          "draft_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Draft Ref"
          },
          "draft_revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Draft Revision"
          },
          "head_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Head Node Id"
          },
          "head_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Head Ref"
          },
          "head_revision": {
            "title": "Head Revision",
            "type": "integer"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "head_revision",
          "created_at",
          "updated_at"
        ],
        "title": "ItemResponse",
        "type": "object"
      },
      "ItemRevisionResponse": {
        "properties": {
          "adopted": {
            "title": "Adopted",
            "type": "boolean"
          },
          "author": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author"
          },
          "baselines": {
            "items": {
              "type": "string"
            },
            "title": "Baselines",
            "type": "array"
          },
          "change_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Change Reason"
          },
          "change_set": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Change Set"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "gate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate"
          },
          "is_head": {
            "title": "Is Head",
            "type": "boolean"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "phase": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Phase"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "status": {
            "default": "committed",
            "title": "Status",
            "type": "string"
          },
          "status_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status Reason"
          }
        },
        "required": [
          "revision",
          "node_id",
          "is_head",
          "adopted"
        ],
        "title": "ItemRevisionResponse",
        "type": "object"
      },
      "IterateRequest": {
        "description": "Request body for POST /v1/twin/nodes/{id}/iterate.",
        "properties": {
          "change_description": {
            "title": "Change Description",
            "type": "string"
          },
          "metadata_updates": {
            "additionalProperties": true,
            "default": {},
            "title": "Metadata Updates",
            "type": "object"
          }
        },
        "required": [
          "change_description"
        ],
        "title": "IterateRequest",
        "type": "object"
      },
      "JointLoadRequest": {
        "description": "A posed serial chain, base-to-tip: ``links[i]`` is the link driven\nby (immediately outboard of) ``joints[i]``.",
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/JointPositionInput"
            },
            "title": "Joints",
            "type": "array"
          },
          "links": {
            "items": {
              "$ref": "#/components/schemas/LinkLoadInput"
            },
            "title": "Links",
            "type": "array"
          },
          "payload_mass_kg": {
            "default": 0.0,
            "title": "Payload Mass Kg",
            "type": "number"
          },
          "payload_position_world_mm": {
            "anyOf": [
              {
                "maxItems": 3,
                "minItems": 3,
                "prefixItems": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "number"
                  }
                ],
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payload Position World Mm"
          }
        },
        "required": [
          "links",
          "joints"
        ],
        "title": "JointLoadRequest",
        "type": "object"
      },
      "JointLoadResponse": {
        "properties": {
          "loads": {
            "items": {
              "$ref": "#/components/schemas/JointLoadResult"
            },
            "title": "Loads",
            "type": "array"
          },
          "worst_joint": {
            "$ref": "#/components/schemas/JointLoadResult"
          }
        },
        "required": [
          "loads",
          "worst_joint"
        ],
        "title": "JointLoadResponse",
        "type": "object"
      },
      "JointLoadResult": {
        "properties": {
          "joint_name": {
            "title": "Joint Name",
            "type": "string"
          },
          "reaction_force_n": {
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Reaction Force N",
            "type": "array"
          },
          "reaction_moment_n_mm": {
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Reaction Moment N Mm",
            "type": "array"
          },
          "supported_mass_kg": {
            "title": "Supported Mass Kg",
            "type": "number"
          }
        },
        "required": [
          "joint_name",
          "supported_mass_kg",
          "reaction_force_n",
          "reaction_moment_n_mm"
        ],
        "title": "JointLoadResult",
        "type": "object"
      },
      "JointPositionInput": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "position_world_mm": {
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Position World Mm",
            "type": "array"
          }
        },
        "required": [
          "name",
          "position_world_mm"
        ],
        "title": "JointPositionInput",
        "type": "object"
      },
      "JointSpec": {
        "description": "One joint between two parts \u2014 the same shape FreeCAD's\n``add_assembly_joint``/``list_joints`` already produce, so a caller can\npass through what MET-721 reads from a live session, or supply a saved\njoint list manually.",
        "properties": {
          "anchor": {
            "description": "Anchor point (mm).",
            "items": {
              "type": "number"
            },
            "maxItems": 3,
            "minItems": 3,
            "title": "Anchor",
            "type": "array"
          },
          "axis": {
            "items": {
              "type": "number"
            },
            "maxItems": 3,
            "minItems": 3,
            "title": "Axis",
            "type": "array"
          },
          "base": {
            "description": "Link name of the base part.",
            "title": "Base",
            "type": "string"
          },
          "follower": {
            "description": "Link name of the follower part.",
            "title": "Follower",
            "type": "string"
          },
          "limits": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "number"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Required for 'slider' joints \u2014 {lower, upper, effort?, velocity?}.",
            "title": "Limits"
          },
          "name": {
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "type": {
            "enum": [
              "fixed",
              "slider",
              "revolute",
              "cylindrical",
              "ball"
            ],
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "name",
          "type",
          "base",
          "follower",
          "axis",
          "anchor"
        ],
        "title": "JointSpec",
        "type": "object"
      },
      "KnowledgeEntryResponse": {
        "description": "API response model for a single knowledge entry.",
        "properties": {
          "chunkIndex": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chunkindex"
          },
          "content": {
            "title": "Content",
            "type": "string"
          },
          "createdAt": {
            "format": "date-time",
            "title": "Createdat",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "title": "Id",
            "type": "string"
          },
          "knowledgeType": {
            "$ref": "#/components/schemas/KnowledgeType"
          },
          "metadata": {
            "additionalProperties": true,
            "title": "Metadata",
            "type": "object"
          },
          "sourcePath": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcepath"
          },
          "sourceWorkProductId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceworkproductid"
          },
          "totalChunks": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Totalchunks"
          }
        },
        "required": [
          "id",
          "content",
          "knowledgeType",
          "metadata",
          "createdAt"
        ],
        "title": "KnowledgeEntryResponse",
        "type": "object"
      },
      "KnowledgeHitResponse": {
        "description": "Wire shape of a single knowledge-base hit.\n\nUsed by ``POST /v1/memory/search`` (design rationale) and\n``GET /v1/memory/components/{name}`` (component context). Fields\nmirror ``digital_twin.knowledge.service.SearchHit``.",
        "properties": {
          "chunkIndex": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chunkindex"
          },
          "content": {
            "title": "Content",
            "type": "string"
          },
          "heading": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Heading"
          },
          "knowledgeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Knowledgetype"
          },
          "similarityScore": {
            "title": "Similarityscore",
            "type": "number"
          },
          "sourcePath": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcepath"
          },
          "sourceWorkProductId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceworkproductid"
          },
          "totalChunks": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Totalchunks"
          }
        },
        "required": [
          "content",
          "similarityScore"
        ],
        "title": "KnowledgeHitResponse",
        "type": "object"
      },
      "KnowledgeType": {
        "description": "Categories of knowledge stored in the knowledge layer.",
        "enum": [
          "design_decision",
          "component",
          "failure",
          "constraint",
          "session"
        ],
        "title": "KnowledgeType",
        "type": "string"
      },
      "LinkEvidenceRequest": {
        "description": "Request body for linking evidence to a checklist item.",
        "properties": {
          "checklist_item_id": {
            "description": "Checklist item ID to link to",
            "title": "Checklist Item Id",
            "type": "string"
          },
          "description": {
            "default": "",
            "description": "Evidence description",
            "title": "Description",
            "type": "string"
          },
          "evidence_type": {
            "$ref": "#/components/schemas/EvidenceType",
            "description": "Type of evidence"
          },
          "title": {
            "description": "Evidence title",
            "title": "Title",
            "type": "string"
          },
          "work_product_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "WorkProduct UUID",
            "title": "Work Product Id"
          }
        },
        "required": [
          "checklist_item_id",
          "evidence_type",
          "title"
        ],
        "title": "LinkEvidenceRequest",
        "type": "object"
      },
      "LinkLoadInput": {
        "properties": {
          "com_world_mm": {
            "maxItems": 3,
            "minItems": 3,
            "prefixItems": [
              {
                "type": "number"
              },
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ],
            "title": "Com World Mm",
            "type": "array"
          },
          "mass_kg": {
            "title": "Mass Kg",
            "type": "number"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name",
          "com_world_mm",
          "mass_kg"
        ],
        "title": "LinkLoadInput",
        "type": "object"
      },
      "LoadCaseListResponse": {
        "properties": {
          "loadCases": {
            "items": {
              "$ref": "#/components/schemas/LoadCaseResponse"
            },
            "title": "Loadcases",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "loadCases",
          "total"
        ],
        "title": "LoadCaseListResponse",
        "type": "object"
      },
      "LoadCaseResponse": {
        "description": "One load case, in the dashboard's camelCase shape.",
        "properties": {
          "createdAt": {
            "title": "Createdat",
            "type": "string"
          },
          "fixedNodeSet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fixednodeset"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "loadForceN": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loadforcen"
          },
          "loadNodeSet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loadnodeset"
          },
          "material": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "projectId": {
            "title": "Projectid",
            "type": "string"
          },
          "sourceOfLoads": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceofloads"
          },
          "updatedAt": {
            "title": "Updatedat",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "projectId",
          "createdAt",
          "updatedAt"
        ],
        "title": "LoadCaseResponse",
        "type": "object"
      },
      "MalformedBudgetResponse": {
        "description": "A budget this response had to ignore, and why (FORGE-414).\n\nPreviously these were a server-side warning only, so the tab rendered no\nbudget row and the reader concluded nobody had set one. Six of the ten\nbudgets in the live twin were in that state. Naming them here costs one\nfield and turns \"there is no budget\" into \"your budget is unusable, here\nis what it needs\".",
        "properties": {
          "detail": {
            "title": "Detail",
            "type": "string"
          },
          "entityId": {
            "title": "Entityid",
            "type": "string"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "title": "Missing",
            "type": "array"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "entityId",
          "missing",
          "detail"
        ],
        "title": "MalformedBudgetResponse",
        "type": "object"
      },
      "ManufactureReleaseResponse": {
        "properties": {
          "content_base64": {
            "title": "Content Base64",
            "type": "string"
          },
          "file_size_bytes": {
            "title": "File Size Bytes",
            "type": "integer"
          },
          "filename": {
            "title": "Filename",
            "type": "string"
          },
          "format": {
            "title": "Format",
            "type": "string"
          },
          "process": {
            "title": "Process",
            "type": "string"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "process",
          "format",
          "filename",
          "file_size_bytes",
          "content_base64"
        ],
        "title": "ManufactureReleaseResponse",
        "type": "object"
      },
      "ManufacturingContextBody": {
        "description": "What the project can actually be made with (FORGE-463).",
        "properties": {
          "machines": {
            "items": {
              "type": "string"
            },
            "title": "Machines",
            "type": "array"
          },
          "processes": {
            "items": {
              "type": "string"
            },
            "title": "Processes",
            "type": "array"
          },
          "productionQuantity": {
            "anyOf": [
              {
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Productionquantity"
          },
          "route": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManufacturingRoute"
              },
              {
                "type": "null"
              }
            ]
          },
          "stockMaterials": {
            "items": {
              "type": "string"
            },
            "title": "Stockmaterials",
            "type": "array"
          }
        },
        "title": "ManufacturingContextBody",
        "type": "object"
      },
      "ManufacturingRoute": {
        "enum": [
          "in_house",
          "vendor",
          "undecided"
        ],
        "title": "ManufacturingRoute",
        "type": "string"
      },
      "MaturityGateSummary": {
        "properties": {
          "blockedReason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Blockedreason"
          },
          "comment": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment"
          },
          "createdAt": {
            "title": "Createdat",
            "type": "string"
          },
          "decidedBy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decidedby"
          },
          "gateId": {
            "title": "Gateid",
            "type": "string"
          },
          "level": {
            "title": "Level",
            "type": "string"
          },
          "promoted": {
            "title": "Promoted",
            "type": "boolean"
          }
        },
        "required": [
          "gateId",
          "level",
          "promoted",
          "blockedReason",
          "decidedBy",
          "comment",
          "createdAt"
        ],
        "title": "MaturityGateSummary",
        "type": "object"
      },
      "MemoryHitResponse": {
        "description": "Wire shape of a single hit in the response payload.",
        "properties": {
          "agentCode": {
            "title": "Agentcode",
            "type": "string"
          },
          "confidence": {
            "$ref": "#/components/schemas/ConfidenceTier"
          },
          "durationSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Durationseconds"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "experienceId": {
            "format": "uuid",
            "title": "Experienceid",
            "type": "string"
          },
          "importance": {
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Importance",
            "type": "number"
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "rank": {
            "minimum": 0.0,
            "title": "Rank",
            "type": "integer"
          },
          "resultSummary": {
            "title": "Resultsummary",
            "type": "string"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          },
          "similarity": {
            "maximum": 1.0,
            "minimum": -1.0,
            "title": "Similarity",
            "type": "number"
          },
          "stepId": {
            "title": "Stepid",
            "type": "string"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          },
          "taskType": {
            "title": "Tasktype",
            "type": "string"
          },
          "timestamp": {
            "format": "date-time",
            "title": "Timestamp",
            "type": "string"
          }
        },
        "required": [
          "experienceId",
          "similarity",
          "rank",
          "agentCode",
          "taskType",
          "runId",
          "stepId",
          "success",
          "resultSummary",
          "importance",
          "confidence",
          "timestamp"
        ],
        "title": "MemoryHitResponse",
        "type": "object"
      },
      "MemoryRetrieveRequest": {
        "description": "Request body for ``POST /v1/memory/retrieve``.",
        "properties": {
          "agentCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional filter to a specific agent.",
            "title": "Agentcode"
          },
          "goal": {
            "description": "Natural-language description of the task.",
            "minLength": 1,
            "title": "Goal",
            "type": "string"
          },
          "limit": {
            "default": 5,
            "description": "Maximum number of experiences to return.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "minSimilarity": {
            "anyOf": [
              {
                "maximum": 1.0,
                "minimum": -1.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional retrieval-confidence floor: drop hits whose cosine similarity is below this value. None = no floor.",
            "title": "Minsimilarity"
          },
          "onlySuccess": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True = success-only, False = failures-only, None = no filter.",
            "title": "Onlysuccess"
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional project scope.",
            "title": "Projectid"
          }
        },
        "required": [
          "goal"
        ],
        "title": "MemoryRetrieveRequest",
        "type": "object"
      },
      "MemoryRetrieveResponse": {
        "description": "Response body for ``POST /v1/memory/retrieve``.",
        "properties": {
          "hits": {
            "items": {
              "$ref": "#/components/schemas/MemoryHitResponse"
            },
            "title": "Hits",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "totalFound": {
            "title": "Totalfound",
            "type": "integer"
          }
        },
        "required": [
          "hits",
          "query",
          "totalFound"
        ],
        "title": "MemoryRetrieveResponse",
        "type": "object"
      },
      "MemorySearchRequest": {
        "description": "Request body for ``POST /v1/memory/search`` (design-rationale search).",
        "properties": {
          "limit": {
            "default": 5,
            "description": "Maximum number of hits to return.",
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "projectId": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional project scope.",
            "title": "Projectid"
          },
          "query": {
            "description": "Natural-language query against design-decision knowledge.",
            "minLength": 1,
            "title": "Query",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "title": "MemorySearchRequest",
        "type": "object"
      },
      "MemorySearchResponse": {
        "description": "Response body for ``POST /v1/memory/search`` and the components GET.",
        "properties": {
          "hits": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeHitResponse"
            },
            "title": "Hits",
            "type": "array"
          },
          "query": {
            "title": "Query",
            "type": "string"
          },
          "totalFound": {
            "title": "Totalfound",
            "type": "integer"
          }
        },
        "required": [
          "hits",
          "query",
          "totalFound"
        ],
        "title": "MemorySearchResponse",
        "type": "object"
      },
      "MessageResponse": {
        "description": "Single message inside a thread response.",
        "properties": {
          "actor_id": {
            "title": "Actor Id",
            "type": "string"
          },
          "actor_kind": {
            "title": "Actor Kind",
            "type": "string"
          },
          "content": {
            "title": "Content",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "graph_ref_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Graph Ref Label"
          },
          "graph_ref_node": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Graph Ref Node"
          },
          "graph_ref_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Graph Ref Type"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "thread_id": {
            "title": "Thread Id",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "thread_id",
          "actor_id",
          "actor_kind",
          "content",
          "status",
          "created_at",
          "updated_at"
        ],
        "title": "MessageResponse",
        "type": "object"
      },
      "MigrationApplyRequest": {
        "properties": {
          "approve": {
            "default": false,
            "description": "Must be true: applying the plan writes to the twin.",
            "title": "Approve",
            "type": "boolean"
          },
          "plan": {
            "$ref": "#/components/schemas/MigrationPlan-Input",
            "description": "The plan exactly as the dry run returned it."
          },
          "reason": {
            "default": "",
            "description": "Why this plan is approved (kept in the log).",
            "title": "Reason",
            "type": "string"
          }
        },
        "required": [
          "plan"
        ],
        "title": "MigrationApplyRequest",
        "type": "object"
      },
      "MigrationApplyResponse": {
        "properties": {
          "approved_by": {
            "title": "Approved By",
            "type": "string"
          },
          "approver_verified": {
            "title": "Approver Verified",
            "type": "boolean"
          },
          "result": {
            "$ref": "#/components/schemas/MigrationResult"
          }
        },
        "required": [
          "result",
          "approved_by",
          "approver_verified"
        ],
        "title": "MigrationApplyResponse",
        "type": "object"
      },
      "MigrationPlan-Input": {
        "description": "A dry-run result. Pass it back unchanged to :meth:`ItemMigration.apply`.",
        "properties": {
          "counts_after": {
            "additionalProperties": true,
            "title": "Counts After",
            "type": "object"
          },
          "counts_before": {
            "additionalProperties": true,
            "title": "Counts Before",
            "type": "object"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/ProposedItem"
            },
            "title": "Items",
            "type": "array"
          },
          "low_confidence": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Low Confidence",
            "type": "array"
          },
          "plan_hash": {
            "default": "",
            "title": "Plan Hash",
            "type": "string"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          },
          "records": {
            "items": {
              "$ref": "#/components/schemas/RecordAction"
            },
            "title": "Records",
            "type": "array"
          },
          "skipped": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Skipped",
            "type": "array"
          },
          "twin_fingerprint": {
            "title": "Twin Fingerprint",
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "twin_fingerprint",
          "created_at"
        ],
        "title": "MigrationPlan",
        "type": "object"
      },
      "MigrationPlan-Output": {
        "description": "A dry-run result. Pass it back unchanged to :meth:`ItemMigration.apply`.",
        "properties": {
          "counts_after": {
            "additionalProperties": true,
            "title": "Counts After",
            "type": "object"
          },
          "counts_before": {
            "additionalProperties": true,
            "title": "Counts Before",
            "type": "object"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/ProposedItem"
            },
            "title": "Items",
            "type": "array"
          },
          "low_confidence": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Low Confidence",
            "type": "array"
          },
          "plan_hash": {
            "default": "",
            "title": "Plan Hash",
            "type": "string"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          },
          "records": {
            "items": {
              "$ref": "#/components/schemas/RecordAction"
            },
            "title": "Records",
            "type": "array"
          },
          "skipped": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Skipped",
            "type": "array"
          },
          "twin_fingerprint": {
            "title": "Twin Fingerprint",
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "twin_fingerprint",
          "created_at"
        ],
        "title": "MigrationPlan",
        "type": "object"
      },
      "MigrationPlanResponse": {
        "properties": {
          "empty": {
            "title": "Empty",
            "type": "boolean"
          },
          "plan": {
            "$ref": "#/components/schemas/MigrationPlan-Output"
          },
          "report": {
            "title": "Report",
            "type": "string"
          }
        },
        "required": [
          "plan",
          "report",
          "empty"
        ],
        "title": "MigrationPlanResponse",
        "type": "object"
      },
      "MigrationResult": {
        "description": "What :meth:`ItemMigration.apply` did.",
        "properties": {
          "applied": {
            "title": "Applied",
            "type": "boolean"
          },
          "by_type": {
            "additionalProperties": {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            "title": "By Type",
            "type": "object"
          },
          "failures": {
            "items": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "title": "Failures",
            "type": "array"
          },
          "items_created": {
            "default": 0,
            "title": "Items Created",
            "type": "integer"
          },
          "items_extended": {
            "default": 0,
            "title": "Items Extended",
            "type": "integer"
          },
          "plan_hash": {
            "title": "Plan Hash",
            "type": "string"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          },
          "records_pinned": {
            "default": 0,
            "title": "Records Pinned",
            "type": "integer"
          },
          "records_stale": {
            "default": 0,
            "title": "Records Stale",
            "type": "integer"
          },
          "revisions_linked": {
            "default": 0,
            "title": "Revisions Linked",
            "type": "integer"
          },
          "run_summaries_marked": {
            "default": 0,
            "title": "Run Summaries Marked",
            "type": "integer"
          }
        },
        "required": [
          "project_id",
          "plan_hash",
          "applied"
        ],
        "title": "MigrationResult",
        "type": "object"
      },
      "ModelInfo": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "title": "ModelInfo",
        "type": "object"
      },
      "ModelsResponse": {
        "properties": {
          "models": {
            "items": {
              "$ref": "#/components/schemas/ModelInfo"
            },
            "title": "Models",
            "type": "array"
          },
          "provider": {
            "title": "Provider",
            "type": "string"
          },
          "source": {
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "provider",
          "source"
        ],
        "title": "ModelsResponse",
        "type": "object"
      },
      "NamedFace": {
        "description": "One geometric face of a generated mesh (FORGE-277).\n\nMirrors ``freecad.list_named_faces``'/``generate_mesh``'s ``faces``\ntable (FORGE-239) in the dashboard's camelCase shape -- real\ncoordinates for a face, not just its opaque gmsh-assigned name.",
        "properties": {
          "areaMm2": {
            "title": "Areamm2",
            "type": "number"
          },
          "bboxMm": {
            "additionalProperties": {
              "items": {
                "type": "number"
              },
              "type": "array"
            },
            "title": "Bboxmm",
            "type": "object"
          },
          "centroidMm": {
            "items": {
              "type": "number"
            },
            "title": "Centroidmm",
            "type": "array"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "normal": {
            "items": {
              "type": "number"
            },
            "title": "Normal",
            "type": "array"
          }
        },
        "required": [
          "name",
          "centroidMm",
          "normal",
          "areaMm2",
          "bboxMm"
        ],
        "title": "NamedFace",
        "type": "object"
      },
      "NamedFacesRequest": {
        "description": "Body for ``POST /v1/simulation/named-faces``.",
        "properties": {
          "meshFile": {
            "minLength": 1,
            "title": "Meshfile",
            "type": "string"
          }
        },
        "required": [
          "meshFile"
        ],
        "title": "NamedFacesRequest",
        "type": "object"
      },
      "NamedFacesResponse": {
        "properties": {
          "faces": {
            "items": {
              "$ref": "#/components/schemas/NamedFace"
            },
            "title": "Faces",
            "type": "array"
          },
          "meshFile": {
            "title": "Meshfile",
            "type": "string"
          }
        },
        "required": [
          "meshFile",
          "faces"
        ],
        "title": "NamedFacesResponse",
        "type": "object"
      },
      "OkResponse": {
        "properties": {
          "method": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Method"
          },
          "ok": {
            "default": true,
            "title": "Ok",
            "type": "boolean"
          },
          "provider": {
            "title": "Provider",
            "type": "string"
          }
        },
        "required": [
          "provider"
        ],
        "title": "OkResponse",
        "type": "object"
      },
      "OpenTaskRequest": {
        "properties": {
          "attempt": {
            "default": 1,
            "title": "Attempt",
            "type": "integer"
          },
          "brief": {
            "additionalProperties": true,
            "title": "Brief",
            "type": "object"
          },
          "phaseId": {
            "title": "Phaseid",
            "type": "string"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          }
        },
        "required": [
          "runId",
          "phaseId"
        ],
        "title": "OpenTaskRequest",
        "type": "object"
      },
      "OtherRow": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "validation_status": {
            "title": "Validation Status",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "name",
          "type",
          "validation_status"
        ],
        "title": "OtherRow",
        "type": "object"
      },
      "OverhangCheckRequest": {
        "properties": {
          "build_axis": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Build Axis"
          },
          "mesh_file": {
            "title": "Mesh File",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "threshold_deg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Threshold Deg"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "mesh_file"
        ],
        "title": "OverhangCheckRequest",
        "type": "object"
      },
      "OverhangCheckResponse": {
        "properties": {
          "build_axis": {
            "items": {
              "type": "number"
            },
            "title": "Build Axis",
            "type": "array"
          },
          "dfm_pass": {
            "title": "Dfm Pass",
            "type": "boolean"
          },
          "evidence_node_id": {
            "title": "Evidence Node Id",
            "type": "string"
          },
          "faces": {
            "items": {
              "$ref": "#/components/schemas/OverhangFace"
            },
            "title": "Faces",
            "type": "array"
          },
          "flagged_count": {
            "title": "Flagged Count",
            "type": "integer"
          },
          "threshold_deg": {
            "title": "Threshold Deg",
            "type": "number"
          },
          "total_faces": {
            "title": "Total Faces",
            "type": "integer"
          }
        },
        "required": [
          "faces",
          "flagged_count",
          "total_faces",
          "threshold_deg",
          "build_axis",
          "dfm_pass",
          "evidence_node_id"
        ],
        "title": "OverhangCheckResponse",
        "type": "object"
      },
      "OverhangFace": {
        "properties": {
          "area_mm2": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Area Mm2"
          },
          "flagged": {
            "title": "Flagged",
            "type": "boolean"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "normal": {
            "items": {
              "type": "number"
            },
            "title": "Normal",
            "type": "array"
          },
          "tilt_from_vertical_deg": {
            "title": "Tilt From Vertical Deg",
            "type": "number"
          }
        },
        "required": [
          "normal",
          "tilt_from_vertical_deg",
          "flagged"
        ],
        "title": "OverhangFace",
        "type": "object"
      },
      "PartRef": {
        "description": "One part of an assembly, referencing a Twin STEP work product.",
        "properties": {
          "color_rgba": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "maxItems": 4,
                "minItems": 4,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "[r, g, b, a], each 0-1. Attaches a <material><color> to this link's visual geometry in the exported URDF (SDF/USD requests ignore it \u2014 not yet wired to those formats). Authored design color, not a renderer-invented palette.",
            "title": "Color Rgba"
          },
          "density_kg_m3": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Density Kg M3"
          },
          "link_name": {
            "minLength": 1,
            "title": "Link Name",
            "type": "string"
          },
          "material": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material"
          },
          "node_id": {
            "description": "Twin work-product node id (STEP file).",
            "minLength": 1,
            "title": "Node Id",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "link_name"
        ],
        "title": "PartRef",
        "type": "object"
      },
      "PatchView": {
        "properties": {
          "added": {
            "items": {
              "type": "string"
            },
            "title": "Added",
            "type": "array"
          },
          "approvalId": {
            "title": "Approvalid",
            "type": "string"
          },
          "changes": {
            "items": {
              "type": "string"
            },
            "title": "Changes",
            "type": "array"
          },
          "nextStep": {
            "title": "Nextstep",
            "type": "string"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "title": "Notes",
            "type": "array"
          },
          "preserved": {
            "items": {
              "type": "string"
            },
            "title": "Preserved",
            "type": "array"
          },
          "removed": {
            "items": {
              "type": "string"
            },
            "title": "Removed",
            "type": "array"
          },
          "rerun": {
            "items": {
              "type": "string"
            },
            "title": "Rerun",
            "type": "array"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          },
          "versionId": {
            "title": "Versionid",
            "type": "string"
          }
        },
        "required": [
          "runId",
          "approvalId",
          "versionId",
          "nextStep"
        ],
        "title": "PatchView",
        "type": "object"
      },
      "PhaseView": {
        "properties": {
          "condition": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Condition"
          },
          "dependsOn": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dependson"
          },
          "disciplines": {
            "items": {
              "type": "string"
            },
            "title": "Disciplines",
            "type": "array"
          },
          "enforceDeliverables": {
            "default": true,
            "title": "Enforcedeliverables",
            "type": "boolean"
          },
          "expectedArtifacts": {
            "items": {
              "type": "string"
            },
            "title": "Expectedartifacts",
            "type": "array"
          },
          "gate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GateView"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Model"
          },
          "objective": {
            "title": "Objective",
            "type": "string"
          },
          "outcome": {
            "default": "",
            "title": "Outcome",
            "type": "string"
          },
          "requiredDeliverables": {
            "items": {
              "type": "string"
            },
            "title": "Requireddeliverables",
            "type": "array"
          },
          "slots": {
            "items": {
              "$ref": "#/components/schemas/SlotView"
            },
            "title": "Slots",
            "type": "array"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "objective"
        ],
        "title": "PhaseView",
        "type": "object"
      },
      "PrdSource": {
        "properties": {
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "requirement_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirement Count"
          }
        },
        "required": [
          "ref",
          "item_type",
          "node_id"
        ],
        "title": "PrdSource",
        "type": "object"
      },
      "ProjectListResponse": {
        "description": "List of projects.",
        "properties": {
          "projects": {
            "items": {
              "$ref": "#/components/schemas/ProjectResponse"
            },
            "title": "Projects",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "projects",
          "total"
        ],
        "title": "ProjectListResponse",
        "type": "object"
      },
      "ProjectResponse": {
        "description": "Dashboard-friendly representation of a hardware project.",
        "properties": {
          "agent_count": {
            "default": 0,
            "title": "Agent Count",
            "type": "integer"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "last_updated": {
            "title": "Last Updated",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "work_products": {
            "items": {
              "$ref": "#/components/schemas/ProjectWorkProductResponse"
            },
            "title": "Work Products",
            "type": "array"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "status",
          "last_updated",
          "created_at"
        ],
        "title": "ProjectResponse",
        "type": "object"
      },
      "ProjectWorkProductResponse": {
        "description": "A single work product within a project.",
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          },
          "updated_at": {
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "status",
          "updated_at"
        ],
        "title": "ProjectWorkProductResponse",
        "type": "object"
      },
      "PromotionHistoryResponse": {
        "properties": {
          "gates": {
            "items": {
              "$ref": "#/components/schemas/MaturityGateSummary"
            },
            "title": "Gates",
            "type": "array"
          }
        },
        "required": [
          "gates"
        ],
        "title": "PromotionHistoryResponse",
        "type": "object"
      },
      "ProposalListResponse": {
        "description": "Paginated list of design-change proposals.",
        "properties": {
          "proposals": {
            "items": {
              "$ref": "#/components/schemas/DesignChangeProposal"
            },
            "title": "Proposals",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "proposals",
          "total"
        ],
        "title": "ProposalListResponse",
        "type": "object"
      },
      "ProposeFlowRequest": {
        "properties": {
          "budget": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget"
          },
          "caller": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CallerBody"
              },
              {
                "type": "null"
              }
            ]
          },
          "intent": {
            "title": "Intent",
            "type": "string"
          },
          "loadsAndUse": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loadsanduse"
          },
          "manufacturingContext": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManufacturingContextBody"
              },
              {
                "type": "null"
              }
            ]
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Model"
          },
          "operations": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/CallerOperation"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Operations"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Provider"
          },
          "requirements": {
            "items": {
              "type": "string"
            },
            "title": "Requirements",
            "type": "array"
          },
          "targetMaturity": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TargetMaturity"
              },
              {
                "type": "null"
              }
            ]
          },
          "template": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Template"
          }
        },
        "required": [
          "intent"
        ],
        "title": "ProposeFlowRequest",
        "type": "object"
      },
      "ProposePatchRequest": {
        "description": "A change to a running flow, written against the flow it was read from.",
        "properties": {
          "expectedContentHash": {
            "title": "Expectedcontenthash",
            "type": "string"
          },
          "invalidate": {
            "items": {
              "type": "string"
            },
            "title": "Invalidate",
            "type": "array"
          },
          "operations": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Operations",
            "type": "array"
          },
          "reason": {
            "title": "Reason",
            "type": "string"
          }
        },
        "required": [
          "expectedContentHash",
          "reason"
        ],
        "title": "ProposePatchRequest",
        "type": "object"
      },
      "ProposedItem": {
        "description": "An item the migration creates, or an existing item it extends.",
        "properties": {
          "confidence": {
            "default": "high",
            "title": "Confidence",
            "type": "string"
          },
          "existing_item": {
            "default": false,
            "title": "Existing Item",
            "type": "boolean"
          },
          "head_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Head Node Id"
          },
          "head_revision": {
            "default": 0,
            "title": "Head Revision",
            "type": "integer"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "review_reasons": {
            "items": {
              "type": "string"
            },
            "title": "Review Reasons",
            "type": "array"
          },
          "revisions": {
            "items": {
              "$ref": "#/components/schemas/ProposedRevision"
            },
            "title": "Revisions",
            "type": "array"
          },
          "rule": {
            "title": "Rule",
            "type": "string"
          },
          "rules": {
            "items": {
              "type": "string"
            },
            "title": "Rules",
            "type": "array"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "rule"
        ],
        "title": "ProposedItem",
        "type": "object"
      },
      "ProposedRevision": {
        "description": "One node as a revision of a proposed item.",
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "evidence": {
            "title": "Evidence",
            "type": "string"
          },
          "existing": {
            "default": false,
            "title": "Existing",
            "type": "boolean"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "rule": {
            "title": "Rule",
            "type": "string"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "status_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status Reason"
          }
        },
        "required": [
          "node_id",
          "name",
          "revision",
          "status",
          "rule",
          "evidence"
        ],
        "title": "ProposedRevision",
        "type": "object"
      },
      "ProviderInfo": {
        "properties": {
          "base_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Base Url"
          },
          "configured": {
            "title": "Configured",
            "type": "boolean"
          },
          "family": {
            "title": "Family",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          }
        },
        "required": [
          "id",
          "family",
          "configured"
        ],
        "title": "ProviderInfo",
        "type": "object"
      },
      "ProvidersResponse": {
        "properties": {
          "active_model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Active Model"
          },
          "active_provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Active Provider"
          },
          "fallback_count": {
            "default": 0,
            "title": "Fallback Count",
            "type": "integer"
          },
          "last_fallback": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FallbackInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "providers": {
            "items": {
              "$ref": "#/components/schemas/ProviderInfo"
            },
            "title": "Providers",
            "type": "array"
          }
        },
        "title": "ProvidersResponse",
        "type": "object"
      },
      "QuestionView": {
        "properties": {
          "answerType": {
            "title": "Answertype",
            "type": "string"
          },
          "field": {
            "default": "",
            "title": "Field",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "options": {
            "items": {
              "type": "string"
            },
            "title": "Options",
            "type": "array"
          },
          "question": {
            "title": "Question",
            "type": "string"
          },
          "required": {
            "default": true,
            "title": "Required",
            "type": "boolean"
          },
          "source": {
            "default": "metaforge",
            "title": "Source",
            "type": "string"
          },
          "why": {
            "title": "Why",
            "type": "string"
          }
        },
        "required": [
          "id",
          "question",
          "why",
          "answerType"
        ],
        "title": "QuestionView",
        "type": "object"
      },
      "RealizeHierarchyNodeRequest": {
        "properties": {
          "bomItemId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bomitemid"
          },
          "workProductId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workproductid"
          }
        },
        "title": "RealizeHierarchyNodeRequest",
        "type": "object"
      },
      "RealizeHierarchyNodeResponse": {
        "properties": {
          "instanceOfBomItemId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Instanceofbomitemid"
          },
          "nodeId": {
            "title": "Nodeid",
            "type": "string"
          },
          "realizedByWorkProductId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Realizedbyworkproductid"
          }
        },
        "required": [
          "nodeId"
        ],
        "title": "RealizeHierarchyNodeResponse",
        "type": "object"
      },
      "RecordAction": {
        "description": "One record update: a run-summary flag or a revision pin.",
        "properties": {
          "action": {
            "title": "Action",
            "type": "string"
          },
          "item_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Item Ref"
          },
          "item_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Item Type"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "pinned_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pinned Node Id"
          },
          "reason": {
            "title": "Reason",
            "type": "string"
          },
          "record_type": {
            "title": "Record Type",
            "type": "string"
          },
          "staleness": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Staleness"
          }
        },
        "required": [
          "node_id",
          "name",
          "record_type",
          "action",
          "reason"
        ],
        "title": "RecordAction",
        "type": "object"
      },
      "RecordPinResponse": {
        "description": "One item revision a record depends on (FORGE-527).",
        "properties": {
          "itemKey": {
            "title": "Itemkey",
            "type": "string"
          },
          "itemRef": {
            "title": "Itemref",
            "type": "string"
          },
          "itemType": {
            "default": "",
            "title": "Itemtype",
            "type": "string"
          },
          "nodeId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nodeid"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "itemKey",
          "revision",
          "itemRef"
        ],
        "title": "RecordPinResponse",
        "type": "object"
      },
      "RecordRowResponse": {
        "properties": {
          "analysed": {
            "items": {
              "$ref": "#/components/schemas/AnalysedRef"
            },
            "title": "Analysed",
            "type": "array"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "out_of_date": {
            "default": false,
            "title": "Out Of Date",
            "type": "boolean"
          },
          "record_type": {
            "title": "Record Type",
            "type": "string"
          },
          "staleness": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Staleness"
          }
        },
        "required": [
          "node_id",
          "record_type",
          "name"
        ],
        "title": "RecordRowResponse",
        "type": "object"
      },
      "RecordStalenessResponse": {
        "description": "Whether a record is still valid evidence (FORGE-527, spec section 20).",
        "properties": {
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "staleFor": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stalefor"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "supersededBy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Supersededby"
          }
        },
        "required": [
          "status"
        ],
        "title": "RecordStalenessResponse",
        "type": "object"
      },
      "ReleaseDiff": {
        "properties": {
          "bom_delta": {
            "title": "Bom Delta",
            "type": "integer"
          },
          "compared_to": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Compared To"
          },
          "decision_delta": {
            "title": "Decision Delta",
            "type": "integer"
          },
          "evidence_delta": {
            "title": "Evidence Delta",
            "type": "integer"
          },
          "hierarchy_delta": {
            "title": "Hierarchy Delta",
            "type": "integer"
          }
        },
        "required": [
          "compared_to",
          "hierarchy_delta",
          "bom_delta",
          "evidence_delta",
          "decision_delta"
        ],
        "title": "ReleaseDiff",
        "type": "object"
      },
      "ReleasePackageListResponse": {
        "properties": {
          "releases": {
            "items": {
              "$ref": "#/components/schemas/ReleasePackageResponse"
            },
            "title": "Releases",
            "type": "array"
          }
        },
        "required": [
          "releases"
        ],
        "title": "ReleasePackageListResponse",
        "type": "object"
      },
      "ReleasePackageResponse": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "diff_from_previous": {
            "$ref": "#/components/schemas/ReleaseDiff"
          },
          "gate_status": {
            "title": "Gate Status",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "snapshot": {
            "$ref": "#/components/schemas/ReleaseSnapshot"
          },
          "statement": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Statement"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "node_id",
          "snapshot",
          "diff_from_previous",
          "gate_status"
        ],
        "title": "ReleasePackageResponse",
        "type": "object"
      },
      "ReleaseSnapshot": {
        "properties": {
          "bom_item_ids": {
            "items": {
              "type": "string"
            },
            "title": "Bom Item Ids",
            "type": "array"
          },
          "decision_ids": {
            "items": {
              "type": "string"
            },
            "title": "Decision Ids",
            "type": "array"
          },
          "drawing_ids": {
            "items": {
              "type": "string"
            },
            "title": "Drawing Ids",
            "type": "array"
          },
          "evidence_ids": {
            "items": {
              "type": "string"
            },
            "title": "Evidence Ids",
            "type": "array"
          },
          "hierarchy_node_ids": {
            "items": {
              "type": "string"
            },
            "title": "Hierarchy Node Ids",
            "type": "array"
          }
        },
        "required": [
          "hierarchy_node_ids",
          "bom_item_ids",
          "evidence_ids",
          "decision_ids",
          "drawing_ids"
        ],
        "title": "ReleaseSnapshot",
        "type": "object"
      },
      "RepeatabilityContribution": {
        "properties": {
          "actuator": {
            "title": "Actuator",
            "type": "string"
          },
          "contribution_mm": {
            "title": "Contribution Mm",
            "type": "number"
          },
          "jacobian_mm_per_rad": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Jacobian Mm Per Rad"
          },
          "joint_name": {
            "title": "Joint Name",
            "type": "string"
          },
          "resolution_rad": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolution Rad"
          },
          "source": {
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "joint_name",
          "actuator",
          "source",
          "contribution_mm"
        ],
        "title": "RepeatabilityContribution",
        "type": "object"
      },
      "RepeatabilityEstimateResponse": {
        "properties": {
          "contributions": {
            "items": {
              "$ref": "#/components/schemas/RepeatabilityContribution"
            },
            "title": "Contributions",
            "type": "array"
          },
          "passes": {
            "title": "Passes",
            "type": "boolean"
          },
          "requirement_mm": {
            "title": "Requirement Mm",
            "type": "number"
          },
          "target_part": {
            "title": "Target Part",
            "type": "string"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "title": "Warnings",
            "type": "array"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          },
          "worst_case_repeatability_mm": {
            "title": "Worst Case Repeatability Mm",
            "type": "number"
          }
        },
        "required": [
          "work_product_id",
          "target_part",
          "requirement_mm",
          "worst_case_repeatability_mm",
          "passes",
          "contributions",
          "warnings"
        ],
        "title": "RepeatabilityEstimateResponse",
        "type": "object"
      },
      "RequiredClaimResultView": {
        "properties": {
          "decision": {
            "title": "Decision",
            "type": "string"
          },
          "detail": {
            "title": "Detail",
            "type": "string"
          },
          "requirementId": {
            "title": "Requirementid",
            "type": "string"
          },
          "requirementName": {
            "title": "Requirementname",
            "type": "string"
          },
          "waiverId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Waiverid"
          }
        },
        "required": [
          "requirementId",
          "requirementName",
          "decision",
          "detail",
          "waiverId"
        ],
        "title": "RequiredClaimResultView",
        "type": "object"
      },
      "RequiredSpec": {
        "properties": {
          "op": {
            "title": "Op",
            "type": "string"
          },
          "value": {
            "title": "Value",
            "type": "number"
          }
        },
        "required": [
          "op",
          "value"
        ],
        "title": "RequiredSpec",
        "type": "object"
      },
      "RequirementMatrixResponse": {
        "properties": {
          "revisionRefs": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Revisionrefs",
            "type": "array"
          },
          "rows": {
            "items": {
              "$ref": "#/components/schemas/RequirementMatrixRow"
            },
            "title": "Rows",
            "type": "array"
          }
        },
        "required": [
          "rows"
        ],
        "title": "RequirementMatrixResponse",
        "type": "object"
      },
      "RequirementMatrixRow": {
        "properties": {
          "artefactIds": {
            "items": {
              "type": "string"
            },
            "title": "Artefactids",
            "type": "array"
          },
          "detail": {
            "title": "Detail",
            "type": "string"
          },
          "evidence": {
            "items": {
              "$ref": "#/components/schemas/EvidenceSummary"
            },
            "title": "Evidence",
            "type": "array"
          },
          "expectedEvidence": {
            "default": "",
            "title": "Expectedevidence",
            "type": "string"
          },
          "limitText": {
            "title": "Limittext",
            "type": "string"
          },
          "requirementId": {
            "title": "Requirementid",
            "type": "string"
          },
          "requirementName": {
            "title": "Requirementname",
            "type": "string"
          },
          "revisionRef": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revisionref"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "verificationMethod": {
            "default": "",
            "title": "Verificationmethod",
            "type": "string"
          }
        },
        "required": [
          "requirementId",
          "requirementName",
          "limitText",
          "status",
          "detail"
        ],
        "title": "RequirementMatrixRow",
        "type": "object"
      },
      "RequirementRecordView": {
        "description": "One requirement's identity + quality diagnostics, dashboard-facing\ncamelCase over the reused, already-shipped ``RequirementQualityRecord``\n(left untouched -- its own field names stay snake_case internally).",
        "properties": {
          "atomicity": {
            "title": "Atomicity",
            "type": "string"
          },
          "clarity": {
            "title": "Clarity",
            "type": "string"
          },
          "conflicts": {
            "items": {
              "type": "string"
            },
            "title": "Conflicts",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "quantified": {
            "title": "Quantified",
            "type": "string"
          },
          "severity": {
            "title": "Severity",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          },
          "traceability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Traceability"
          },
          "verificationReady": {
            "title": "Verificationready",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "text",
          "severity",
          "clarity",
          "atomicity",
          "quantified",
          "traceability",
          "verificationReady"
        ],
        "title": "RequirementRecordView",
        "type": "object"
      },
      "RequirementSetQualityReport": {
        "properties": {
          "completeness": {
            "$ref": "#/components/schemas/CompletenessView"
          },
          "conflicts": {
            "items": {
              "$ref": "#/components/schemas/ConflictPairView"
            },
            "title": "Conflicts",
            "type": "array"
          },
          "requirements": {
            "items": {
              "$ref": "#/components/schemas/RequirementRecordView"
            },
            "title": "Requirements",
            "type": "array"
          }
        },
        "required": [
          "completeness"
        ],
        "title": "RequirementSetQualityReport",
        "type": "object"
      },
      "ResolveHoldRequest": {
        "description": "Close a hold nobody is waiting for any more (FORGE-466).",
        "properties": {
          "approver": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approver"
          },
          "approver_verified": {
            "default": false,
            "title": "Approver Verified",
            "type": "boolean"
          },
          "outcome": {
            "enum": [
              "timed_out",
              "canceled",
              "approved",
              "rejected"
            ],
            "title": "Outcome",
            "type": "string"
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          }
        },
        "required": [
          "outcome"
        ],
        "title": "ResolveHoldRequest",
        "type": "object"
      },
      "RevisionDiff": {
        "description": "Metadata diff between two revisions.",
        "properties": {
          "added": {
            "additionalProperties": true,
            "title": "Added",
            "type": "object"
          },
          "changed": {
            "additionalProperties": {
              "$ref": "#/components/schemas/FieldDelta"
            },
            "title": "Changed",
            "type": "object"
          },
          "removed": {
            "additionalProperties": true,
            "title": "Removed",
            "type": "object"
          },
          "revision_a": {
            "title": "Revision A",
            "type": "integer"
          },
          "revision_b": {
            "title": "Revision B",
            "type": "integer"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "revision_a",
          "revision_b",
          "changed",
          "added",
          "removed"
        ],
        "title": "RevisionDiff",
        "type": "object"
      },
      "RevisionIndexEntry": {
        "properties": {
          "current": {
            "title": "Current",
            "type": "boolean"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "revision_count": {
            "title": "Revision Count",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "via": {
            "title": "Via",
            "type": "string"
          }
        },
        "required": [
          "key",
          "item_type",
          "revision",
          "ref",
          "status",
          "current",
          "revision_count",
          "via"
        ],
        "title": "RevisionIndexEntry",
        "type": "object"
      },
      "RevisionIndexResponse": {
        "properties": {
          "nodes": {
            "additionalProperties": {
              "$ref": "#/components/schemas/RevisionIndexEntry"
            },
            "title": "Nodes",
            "type": "object"
          },
          "project_id": {
            "title": "Project Id",
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "nodes"
        ],
        "title": "RevisionIndexResponse",
        "type": "object"
      },
      "RevisionStateResponse": {
        "properties": {
          "adopted": {
            "default": false,
            "title": "Adopted",
            "type": "boolean"
          },
          "author": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author"
          },
          "change_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Change Reason"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "gate_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gate Id"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "revision",
          "node_id",
          "status"
        ],
        "title": "RevisionStateResponse",
        "type": "object"
      },
      "Ros2LaunchRequest": {
        "properties": {
          "default_urdf_path": {
            "description": "Default 'urdf_path' launch argument \u2014 e.g. a just-exported URDF's download_url.",
            "minLength": 1,
            "title": "Default Urdf Path",
            "type": "string"
          },
          "include_joint_state_publisher_gui": {
            "default": true,
            "title": "Include Joint State Publisher Gui",
            "type": "boolean"
          },
          "include_rviz": {
            "default": true,
            "title": "Include Rviz",
            "type": "boolean"
          },
          "robot_name": {
            "minLength": 1,
            "title": "Robot Name",
            "type": "string"
          }
        },
        "required": [
          "robot_name",
          "default_urdf_path"
        ],
        "title": "Ros2LaunchRequest",
        "type": "object"
      },
      "Ros2LaunchResponse": {
        "properties": {
          "default_urdf_path": {
            "title": "Default Urdf Path",
            "type": "string"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "robot_name": {
            "title": "Robot Name",
            "type": "string"
          }
        },
        "required": [
          "output_file",
          "robot_name",
          "default_urdf_path"
        ],
        "title": "Ros2LaunchResponse",
        "type": "object"
      },
      "RotationDelta": {
        "description": "Single-axis rotation delta of a dragged group (MET-611).",
        "properties": {
          "angle_deg": {
            "title": "Angle Deg",
            "type": "number"
          },
          "axis": {
            "enum": [
              "x",
              "y",
              "z"
            ],
            "title": "Axis",
            "type": "string"
          }
        },
        "required": [
          "axis",
          "angle_deg"
        ],
        "title": "RotationDelta",
        "type": "object"
      },
      "RouteInfo": {
        "properties": {
          "configured": {
            "default": true,
            "title": "Configured",
            "type": "boolean"
          },
          "model": {
            "title": "Model",
            "type": "string"
          },
          "provider": {
            "title": "Provider",
            "type": "string"
          }
        },
        "required": [
          "provider",
          "model"
        ],
        "title": "RouteInfo",
        "type": "object"
      },
      "RoutingResponse": {
        "description": "The effective per-role routing and what roles without a route fall back to.",
        "properties": {
          "default_model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default Model"
          },
          "default_provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default Provider"
          },
          "effective_for_project": {
            "anyOf": [
              {
                "additionalProperties": {
                  "$ref": "#/components/schemas/RouteInfo"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Effective For Project"
          },
          "problems": {
            "items": {
              "type": "string"
            },
            "title": "Problems",
            "type": "array"
          },
          "projects": {
            "additionalProperties": {
              "additionalProperties": {
                "$ref": "#/components/schemas/RouteInfo"
              },
              "type": "object"
            },
            "title": "Projects",
            "type": "object"
          },
          "roles": {
            "additionalProperties": {
              "$ref": "#/components/schemas/RouteInfo"
            },
            "title": "Roles",
            "type": "object"
          }
        },
        "title": "RoutingResponse",
        "type": "object"
      },
      "RunChangesResponse": {
        "properties": {
          "baselines": {
            "items": {
              "$ref": "#/components/schemas/BaselineSummary"
            },
            "title": "Baselines",
            "type": "array"
          },
          "revisions": {
            "items": {
              "$ref": "#/components/schemas/RunRevisionRow"
            },
            "title": "Revisions",
            "type": "array"
          },
          "run_id": {
            "title": "Run Id",
            "type": "string"
          }
        },
        "required": [
          "run_id",
          "revisions",
          "baselines"
        ],
        "title": "RunChangesResponse",
        "type": "object"
      },
      "RunLifecycleResponse": {
        "description": "Where a design run stands, as separate answers per phase, plus a verdict.\n\n``lifecycle`` holds the per-phase execution, eligibility, validity and\nobjective status, the capability gaps, the requirement statuses and the\ncompletion verdict (``COMPLETED_VERIFIED`` only when every mandatory\nrequirement passes with current evidence). ``limits`` lists anything that\ncould not be read; an empty list means nothing was skipped.",
        "properties": {
          "lifecycle": {
            "additionalProperties": true,
            "title": "Lifecycle",
            "type": "object"
          },
          "limits": {
            "items": {
              "type": "string"
            },
            "title": "Limits",
            "type": "array"
          },
          "live": {
            "title": "Live",
            "type": "boolean"
          },
          "nextStep": {
            "default": "",
            "title": "Nextstep",
            "type": "string"
          },
          "runId": {
            "title": "Runid",
            "type": "string"
          }
        },
        "required": [
          "runId",
          "live"
        ],
        "title": "RunLifecycleResponse",
        "type": "object"
      },
      "RunListResponse": {
        "description": "Body for ``GET /v1/runs``.",
        "properties": {
          "runs": {
            "items": {
              "$ref": "#/components/schemas/RunResponse"
            },
            "title": "Runs",
            "type": "array"
          },
          "unscoped_count": {
            "default": 0,
            "title": "Unscoped Count",
            "type": "integer"
          }
        },
        "required": [
          "runs"
        ],
        "title": "RunListResponse",
        "type": "object"
      },
      "RunResponse": {
        "description": "Serialized run state.",
        "properties": {
          "approval_deadline": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approval Deadline"
          },
          "approval_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approval Reason"
          },
          "approved_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approved By"
          },
          "approver_verified": {
            "default": false,
            "title": "Approver Verified",
            "type": "boolean"
          },
          "created_at": {
            "title": "Created At",
            "type": "number"
          },
          "engine": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Engine"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "flow_content_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flow Content Hash"
          },
          "flow_version_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Flow Version Id"
          },
          "history": {
            "items": {
              "type": "string"
            },
            "title": "History",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "request": {
            "additionalProperties": true,
            "title": "Request",
            "type": "object"
          },
          "result": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "updated_at": {
            "title": "Updated At",
            "type": "number"
          },
          "usage": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Usage"
          }
        },
        "required": [
          "id",
          "status",
          "request",
          "created_at",
          "updated_at",
          "history"
        ],
        "title": "RunResponse",
        "type": "object"
      },
      "RunRevisionRow": {
        "properties": {
          "baselined_by_gate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Baselined By Gate"
          },
          "change_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Change Reason"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "is_current": {
            "title": "Is Current",
            "type": "boolean"
          },
          "item_type": {
            "title": "Item Type",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "ref": {
            "title": "Ref",
            "type": "string"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "key",
          "item_type",
          "name",
          "revision",
          "ref",
          "node_id",
          "status",
          "is_current"
        ],
        "title": "RunRevisionRow",
        "type": "object"
      },
      "RunStatusResponse": {
        "description": "Response from ``GET /api/v1/assistant/request/{run_id}``.",
        "properties": {
          "completed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ISO timestamp when the run completed",
            "title": "Completed At"
          },
          "run_id": {
            "description": "Workflow run identifier",
            "title": "Run Id",
            "type": "string"
          },
          "status": {
            "description": "Run status: pending, running, completed, failed",
            "title": "Status",
            "type": "string"
          },
          "steps": {
            "additionalProperties": true,
            "description": "Per-step status and results",
            "title": "Steps",
            "type": "object"
          }
        },
        "required": [
          "run_id",
          "status"
        ],
        "title": "RunStatusResponse",
        "type": "object"
      },
      "ScaleDelta": {
        "description": "Single-axis scale delta of a dragged group (MET-611).",
        "properties": {
          "axis": {
            "enum": [
              "x",
              "y",
              "z"
            ],
            "title": "Axis",
            "type": "string"
          },
          "factor": {
            "title": "Factor",
            "type": "number"
          }
        },
        "required": [
          "axis",
          "factor"
        ],
        "title": "ScaleDelta",
        "type": "object"
      },
      "SdfAssemblyExportRequest": {
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/JointSpec"
            },
            "title": "Joints",
            "type": "array"
          },
          "mesh_format": {
            "default": "stl",
            "enum": [
              "stl",
              "obj"
            ],
            "title": "Mesh Format",
            "type": "string"
          },
          "model_name": {
            "default": "model",
            "title": "Model Name",
            "type": "string"
          },
          "parts": {
            "items": {
              "$ref": "#/components/schemas/PartRef"
            },
            "minItems": 1,
            "title": "Parts",
            "type": "array"
          },
          "persist": {
            "default": true,
            "description": "Commit this export as a robot_description Twin work product (default on). Set false to keep the pre-MET-740 throwaway-only behavior.",
            "title": "Persist",
            "type": "boolean"
          },
          "persist_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Work-product display name (default: '<robot_name> robot description').",
            "title": "Persist Name"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to link the persisted work product to.",
            "title": "Project Id"
          },
          "static": {
            "default": false,
            "title": "Static",
            "type": "boolean"
          },
          "update_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "An existing robot_description node's id \u2014 when given, this export replaces that node's content and records a new version instead of creating a new node.",
            "title": "Update Node Id"
          },
          "world_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "World Name"
          }
        },
        "required": [
          "parts"
        ],
        "title": "SdfAssemblyExportRequest",
        "type": "object"
      },
      "SdfAssemblyExportResponse": {
        "properties": {
          "joint_names": {
            "items": {
              "type": "string"
            },
            "title": "Joint Names",
            "type": "array"
          },
          "joints": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/EmittedJoint"
            },
            "title": "Joints",
            "type": "array"
          },
          "link_names": {
            "items": {
              "type": "string"
            },
            "title": "Link Names",
            "type": "array"
          },
          "mesh_files": {
            "items": {
              "$ref": "#/components/schemas/ExportFile"
            },
            "title": "Mesh Files",
            "type": "array"
          },
          "model_name": {
            "title": "Model Name",
            "type": "string"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "robot_description_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Robot Description Node Id"
          }
        },
        "required": [
          "output_file",
          "mesh_files",
          "model_name",
          "link_names",
          "joint_names"
        ],
        "title": "SdfAssemblyExportResponse",
        "type": "object"
      },
      "SdfExportRequest": {
        "properties": {
          "density_kg_m3": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Density Kg M3"
          },
          "link_name": {
            "default": "link",
            "title": "Link Name",
            "type": "string"
          },
          "material": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material"
          },
          "mesh_format": {
            "default": "stl",
            "enum": [
              "stl",
              "obj"
            ],
            "title": "Mesh Format",
            "type": "string"
          },
          "model_name": {
            "default": "model",
            "title": "Model Name",
            "type": "string"
          },
          "node_id": {
            "description": "Twin work-product node id (STEP file).",
            "minLength": 1,
            "title": "Node Id",
            "type": "string"
          },
          "static": {
            "default": false,
            "title": "Static",
            "type": "boolean"
          },
          "world_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "World Name"
          }
        },
        "required": [
          "node_id"
        ],
        "title": "SdfExportRequest",
        "type": "object"
      },
      "SdfExportResponse": {
        "properties": {
          "center_of_mass_m": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Center Of Mass M",
            "type": "object"
          },
          "density_kg_m3": {
            "title": "Density Kg M3",
            "type": "number"
          },
          "inertia_kgm2": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Inertia Kgm2",
            "type": "object"
          },
          "link_name": {
            "title": "Link Name",
            "type": "string"
          },
          "mass_kg": {
            "title": "Mass Kg",
            "type": "number"
          },
          "mesh_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "model_name": {
            "title": "Model Name",
            "type": "string"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          }
        },
        "required": [
          "output_file",
          "mesh_file",
          "model_name",
          "link_name",
          "density_kg_m3",
          "mass_kg",
          "center_of_mass_m",
          "inertia_kgm2"
        ],
        "title": "SdfExportResponse",
        "type": "object"
      },
      "SearchResponse": {
        "description": "Response from the knowledge search endpoint.",
        "properties": {
          "query": {
            "title": "Query",
            "type": "string"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeEntryResponse"
            },
            "title": "Results",
            "type": "array"
          },
          "totalFound": {
            "title": "Totalfound",
            "type": "integer"
          }
        },
        "required": [
          "results",
          "query",
          "totalFound"
        ],
        "title": "SearchResponse",
        "type": "object"
      },
      "SelectComponentRequest": {
        "properties": {
          "candidates": {
            "items": {
              "$ref": "#/components/schemas/Candidate"
            },
            "title": "Candidates",
            "type": "array"
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "purchaseUnit": {
            "title": "Purchaseunit",
            "type": "string"
          },
          "quantity": {
            "default": 1,
            "title": "Quantity",
            "type": "integer"
          },
          "rationale": {
            "title": "Rationale",
            "type": "string"
          },
          "requiredSpecs": {
            "additionalProperties": {
              "$ref": "#/components/schemas/RequiredSpec"
            },
            "title": "Requiredspecs",
            "type": "object"
          },
          "requirementIds": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirementids"
          },
          "selectedMpn": {
            "title": "Selectedmpn",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "candidates",
          "requiredSpecs",
          "selectedMpn",
          "category",
          "purchaseUnit",
          "title",
          "rationale"
        ],
        "title": "SelectComponentRequest",
        "type": "object"
      },
      "SelectConceptRequest": {
        "properties": {
          "optionIds": {
            "items": {
              "type": "string"
            },
            "title": "Optionids",
            "type": "array"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "rationale": {
            "title": "Rationale",
            "type": "string"
          },
          "requirementIds": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirementids"
          },
          "selectedOptionId": {
            "title": "Selectedoptionid",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "weights": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Weights",
            "type": "object"
          }
        },
        "required": [
          "optionIds",
          "selectedOptionId",
          "weights",
          "title",
          "rationale"
        ],
        "title": "SelectConceptRequest",
        "type": "object"
      },
      "SendMessageRequest": {
        "description": "Body for ``POST /api/v1/chat/threads/{thread_id}/messages``.",
        "properties": {
          "actor_id": {
            "description": "ID of the actor sending the message",
            "title": "Actor Id",
            "type": "string"
          },
          "actor_kind": {
            "description": "Actor type: user | agent | system",
            "title": "Actor Kind",
            "type": "string"
          },
          "content": {
            "description": "Message content",
            "minLength": 1,
            "title": "Content",
            "type": "string"
          },
          "graph_ref_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Digital-twin ref label",
            "title": "Graph Ref Label"
          },
          "graph_ref_node": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Digital-twin node reference",
            "title": "Graph Ref Node"
          },
          "graph_ref_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Digital-twin ref type",
            "title": "Graph Ref Type"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Override model for this turn",
            "title": "Model"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Override provider id for this turn",
            "title": "Provider"
          },
          "tools": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Enabled MCP tool ids for this turn (None = all available)",
            "title": "Tools"
          }
        },
        "required": [
          "content",
          "actor_id",
          "actor_kind"
        ],
        "title": "SendMessageRequest",
        "type": "object"
      },
      "SessionCreateRequest": {
        "description": "Open a new externally-recorded agent session.",
        "properties": {
          "agent_code": {
            "title": "Agent Code",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "task_type": {
            "title": "Task Type",
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "agent_code",
          "task_type"
        ],
        "title": "SessionCreateRequest",
        "type": "object"
      },
      "SessionEventCreateRequest": {
        "description": "Append one event to a session timeline.\n\n``type`` is the normalized capture vocabulary shared by every client\nadapter (MET-497): thought / action / decision / observation / error /\nresult.",
        "properties": {
          "data": {
            "additionalProperties": true,
            "title": "Data",
            "type": "object"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "type",
          "message"
        ],
        "title": "SessionEventCreateRequest",
        "type": "object"
      },
      "SessionEventCreatedResponse": {
        "description": "Ack for an appended event \u2014 carries the server-assigned sequence.",
        "properties": {
          "event_id": {
            "title": "Event Id",
            "type": "string"
          },
          "seq": {
            "title": "Seq",
            "type": "integer"
          }
        },
        "required": [
          "event_id",
          "seq"
        ],
        "title": "SessionEventCreatedResponse",
        "type": "object"
      },
      "SessionEventResponse": {
        "description": "A single event within a session timeline.",
        "properties": {
          "agent_code": {
            "title": "Agent Code",
            "type": "string"
          },
          "data": {
            "additionalProperties": true,
            "title": "Data",
            "type": "object"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "timestamp": {
            "title": "Timestamp",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "id",
          "timestamp",
          "type",
          "agent_code",
          "message"
        ],
        "title": "SessionEventResponse",
        "type": "object"
      },
      "SessionJoint": {
        "properties": {
          "anchor": {
            "items": {
              "type": "number"
            },
            "title": "Anchor",
            "type": "array"
          },
          "axis": {
            "items": {
              "type": "number"
            },
            "title": "Axis",
            "type": "array"
          },
          "base": {
            "title": "Base",
            "type": "string"
          },
          "follower": {
            "title": "Follower",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "type": {
            "enum": [
              "fixed",
              "slider",
              "revolute",
              "cylindrical",
              "ball"
            ],
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "name",
          "type",
          "base",
          "follower",
          "axis",
          "anchor"
        ],
        "title": "SessionJoint",
        "type": "object"
      },
      "SessionJointsResponse": {
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/SessionJoint"
            },
            "title": "Joints",
            "type": "array"
          }
        },
        "required": [
          "joints"
        ],
        "title": "SessionJointsResponse",
        "type": "object"
      },
      "SessionListResponse": {
        "description": "List of sessions.",
        "properties": {
          "sessions": {
            "items": {
              "$ref": "#/components/schemas/SessionResponse"
            },
            "title": "Sessions",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          },
          "unscoped_count": {
            "default": 0,
            "title": "Unscoped Count",
            "type": "integer"
          }
        },
        "required": [
          "sessions",
          "total"
        ],
        "title": "SessionListResponse",
        "type": "object"
      },
      "SessionObject": {
        "properties": {
          "kind": {
            "title": "Kind",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "obj_id": {
            "title": "Obj Id",
            "type": "string"
          },
          "order": {
            "title": "Order",
            "type": "integer"
          }
        },
        "required": [
          "obj_id",
          "kind",
          "name",
          "order"
        ],
        "title": "SessionObject",
        "type": "object"
      },
      "SessionResponse": {
        "description": "Dashboard-friendly representation of an agent session.",
        "properties": {
          "agent_code": {
            "title": "Agent Code",
            "type": "string"
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/SessionEventResponse"
            },
            "title": "Events",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Id"
          },
          "run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Run Id"
          },
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "started_at": {
            "title": "Started At",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "task_type": {
            "title": "Task Type",
            "type": "string"
          }
        },
        "required": [
          "id",
          "agent_code",
          "task_type",
          "status",
          "started_at"
        ],
        "title": "SessionResponse",
        "type": "object"
      },
      "SessionSummary": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "object_count": {
            "title": "Object Count",
            "type": "integer"
          },
          "objects": {
            "items": {
              "$ref": "#/components/schemas/SessionObject"
            },
            "title": "Objects",
            "type": "array"
          },
          "session_id": {
            "title": "Session Id",
            "type": "string"
          }
        },
        "required": [
          "session_id",
          "name",
          "object_count",
          "objects"
        ],
        "title": "SessionSummary",
        "type": "object"
      },
      "SessionUpdateRequest": {
        "description": "Close out a session (status + optional summary).",
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          }
        },
        "required": [
          "status"
        ],
        "title": "SessionUpdateRequest",
        "type": "object"
      },
      "SetCredentialRequest": {
        "properties": {
          "api_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Raw API key (method=api_key).",
            "title": "Api Key"
          },
          "base_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional base_url override.",
            "title": "Base Url"
          },
          "method": {
            "default": "api_key",
            "description": "'api_key' or 'oauth'.",
            "title": "Method",
            "type": "string"
          },
          "provider": {
            "description": "Registry provider id (e.g. openai, openai-codex).",
            "title": "Provider",
            "type": "string"
          },
          "tokens": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "OAuth token blob in auth.json shape (method=oauth).",
            "title": "Tokens"
          }
        },
        "required": [
          "provider"
        ],
        "title": "SetCredentialRequest",
        "type": "object"
      },
      "SetSelectionRequest": {
        "properties": {
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional model id.",
            "title": "Model"
          },
          "provider": {
            "description": "Registry provider id to make active.",
            "title": "Provider",
            "type": "string"
          }
        },
        "required": [
          "provider"
        ],
        "title": "SetSelectionRequest",
        "type": "object"
      },
      "SimulationResultListResponse": {
        "properties": {
          "results": {
            "items": {
              "$ref": "#/components/schemas/SimulationResultResponse"
            },
            "title": "Results",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "results",
          "total"
        ],
        "title": "SimulationResultListResponse",
        "type": "object"
      },
      "SimulationResultResponse": {
        "description": "One FEA result, in the dashboard's camelCase shape (FORGE-279).",
        "properties": {
          "analysedGeometry": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysedgeometry"
          },
          "analysisType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysistype"
          },
          "createdAt": {
            "title": "Createdat",
            "type": "string"
          },
          "fieldQuantities": {
            "items": {
              "type": "string"
            },
            "title": "Fieldquantities",
            "type": "array"
          },
          "fieldRanges": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fieldranges"
          },
          "fieldSizeBytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fieldsizebytes"
          },
          "fixtures": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fixtures"
          },
          "hasField": {
            "default": false,
            "title": "Hasfield",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "loadCase": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loadcase"
          },
          "loadCaseSpec": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loadcasespec"
          },
          "loads": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Loads"
          },
          "maxDisplacementMm": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxdisplacementmm"
          },
          "maxTemperatureC": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxtemperaturec"
          },
          "maxVonMisesMpa": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxvonmisesmpa"
          },
          "meshConvergence": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Meshconvergence"
          },
          "meshStats": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Meshstats"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "projectId": {
            "title": "Projectid",
            "type": "string"
          },
          "updatedAt": {
            "title": "Updatedat",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "projectId",
          "createdAt",
          "updatedAt"
        ],
        "title": "SimulationResultResponse",
        "type": "object"
      },
      "SlotView": {
        "description": "A deliverable slot: one item the phase writes (FORGE-524).",
        "properties": {
          "derived": {
            "default": false,
            "title": "Derived",
            "type": "boolean"
          },
          "itemKey": {
            "title": "Itemkey",
            "type": "string"
          },
          "itemType": {
            "title": "Itemtype",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "itemType",
          "name",
          "itemKey"
        ],
        "title": "SlotView",
        "type": "object"
      },
      "SourceDeleteResponse": {
        "description": "Envelope for ``DELETE /knowledge/sources/{path}``.",
        "properties": {
          "deletedChunks": {
            "title": "Deletedchunks",
            "type": "integer"
          },
          "sourcePath": {
            "title": "Sourcepath",
            "type": "string"
          }
        },
        "required": [
          "sourcePath",
          "deletedChunks"
        ],
        "title": "SourceDeleteResponse",
        "type": "object"
      },
      "SourceDetailResponse": {
        "description": "Per-source detail \u2014 adds an empty ``chunks`` list for parity with the MCP resource.",
        "properties": {
          "chunks": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Chunks",
            "type": "array"
          },
          "fragmentCount": {
            "title": "Fragmentcount",
            "type": "integer"
          },
          "indexedAt": {
            "format": "date-time",
            "title": "Indexedat",
            "type": "string"
          },
          "knowledgeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Knowledgetype"
          },
          "metadata": {
            "additionalProperties": true,
            "title": "Metadata",
            "type": "object"
          },
          "sourcePath": {
            "title": "Sourcepath",
            "type": "string"
          }
        },
        "required": [
          "sourcePath",
          "fragmentCount",
          "indexedAt"
        ],
        "title": "SourceDetailResponse",
        "type": "object"
      },
      "SourceListResponse": {
        "description": "Envelope for ``GET /knowledge/sources``.",
        "properties": {
          "sources": {
            "items": {
              "$ref": "#/components/schemas/SourceSummaryResponse"
            },
            "title": "Sources",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "sources",
          "total"
        ],
        "title": "SourceListResponse",
        "type": "object"
      },
      "SourceSummaryResponse": {
        "description": "One row from ``GET /knowledge/sources`` \u2014 mirrors ``SourceSummary`` (MET-411).",
        "properties": {
          "fragmentCount": {
            "title": "Fragmentcount",
            "type": "integer"
          },
          "indexedAt": {
            "format": "date-time",
            "title": "Indexedat",
            "type": "string"
          },
          "knowledgeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Knowledgetype"
          },
          "metadata": {
            "additionalProperties": true,
            "title": "Metadata",
            "type": "object"
          },
          "sourcePath": {
            "title": "Sourcepath",
            "type": "string"
          }
        },
        "required": [
          "sourcePath",
          "fragmentCount",
          "indexedAt"
        ],
        "title": "SourceSummaryResponse",
        "type": "object"
      },
      "StartDesignLoopRequest": {
        "properties": {
          "deflectionLimitMm": {
            "title": "Deflectionlimitmm",
            "type": "number"
          },
          "loadN": {
            "title": "Loadn",
            "type": "number"
          },
          "material": {
            "default": "aluminum_6061",
            "title": "Material",
            "type": "string"
          },
          "maxIterations": {
            "default": 60,
            "title": "Maxiterations",
            "type": "integer"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "requirementIds": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirementids"
          },
          "sfLimit": {
            "default": 2.0,
            "title": "Sflimit",
            "type": "number"
          },
          "wallMaxMm": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Wallmaxmm"
          },
          "wallMinMm": {
            "default": 0.5,
            "title": "Wallminmm",
            "type": "number"
          },
          "workProductId": {
            "title": "Workproductid",
            "type": "string"
          }
        },
        "required": [
          "workProductId",
          "loadN",
          "deflectionLimitMm"
        ],
        "title": "StartDesignLoopRequest",
        "type": "object"
      },
      "SubmitRequest": {
        "properties": {
          "artifacts": {
            "items": {
              "type": "string"
            },
            "title": "Artifacts",
            "type": "array"
          },
          "client": {
            "default": "",
            "title": "Client",
            "type": "string"
          },
          "summary": {
            "title": "Summary",
            "type": "string"
          }
        },
        "required": [
          "summary"
        ],
        "title": "SubmitRequest",
        "type": "object"
      },
      "SynthesizeRequest": {
        "properties": {
          "delta": {
            "$ref": "#/components/schemas/DeltaTransform"
          },
          "group_name": {
            "minLength": 1,
            "title": "Group Name",
            "type": "string"
          },
          "obj_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Obj Id"
          },
          "property_path": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Property Path"
          },
          "session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          }
        },
        "required": [
          "group_name",
          "delta"
        ],
        "title": "SynthesizeRequest",
        "type": "object"
      },
      "SynthesizeResponse": {
        "properties": {
          "binding_error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Binding Error"
          },
          "bound": {
            "default": false,
            "title": "Bound",
            "type": "boolean"
          },
          "conflict_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conflict Reason"
          },
          "constraint": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConstraintSuggestion"
              },
              {
                "type": "null"
              }
            ]
          },
          "expression": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expression"
          },
          "status": {
            "enum": [
              "ok",
              "conflict",
              "noop"
            ],
            "title": "Status",
            "type": "string"
          },
          "suggestion": {
            "title": "Suggestion",
            "type": "string"
          }
        },
        "required": [
          "status",
          "suggestion"
        ],
        "title": "SynthesizeResponse",
        "type": "object"
      },
      "TargetMaturity": {
        "enum": [
          "concept",
          "sim_validated",
          "physically_validated",
          "released"
        ],
        "title": "TargetMaturity",
        "type": "string"
      },
      "TechnicalDrawingDimension": {
        "description": "One toleranced dimension on a technical_drawing (FORGE-293).",
        "properties": {
          "feature": {
            "title": "Feature",
            "type": "string"
          },
          "nominal_mm": {
            "title": "Nominal Mm",
            "type": "number"
          },
          "tolerance_minus_mm": {
            "default": 0.0,
            "title": "Tolerance Minus Mm",
            "type": "number"
          },
          "tolerance_plus_mm": {
            "default": 0.0,
            "title": "Tolerance Plus Mm",
            "type": "number"
          }
        },
        "required": [
          "feature",
          "nominal_mm"
        ],
        "title": "TechnicalDrawingDimension",
        "type": "object"
      },
      "TechnicalDrawingGdtCallout": {
        "description": "One GD&T callout (ASME Y14.5 style) on a technical_drawing (FORGE-293).",
        "properties": {
          "datum_refs": {
            "items": {
              "type": "string"
            },
            "title": "Datum Refs",
            "type": "array"
          },
          "feature": {
            "title": "Feature",
            "type": "string"
          },
          "symbol": {
            "title": "Symbol",
            "type": "string"
          },
          "tolerance_value_mm": {
            "title": "Tolerance Value Mm",
            "type": "number"
          }
        },
        "required": [
          "feature",
          "symbol",
          "tolerance_value_mm"
        ],
        "title": "TechnicalDrawingGdtCallout",
        "type": "object"
      },
      "TechnicalDrawingListResponse": {
        "description": "A part's real recorded technical drawings, oldest first (FORGE-293).",
        "properties": {
          "drawings": {
            "items": {
              "$ref": "#/components/schemas/TechnicalDrawingSummary"
            },
            "title": "Drawings",
            "type": "array"
          }
        },
        "required": [
          "drawings"
        ],
        "title": "TechnicalDrawingListResponse",
        "type": "object"
      },
      "TechnicalDrawingSummary": {
        "description": "A real recorded technical_drawing work product, listed for a part.",
        "properties": {
          "approved": {
            "title": "Approved",
            "type": "boolean"
          },
          "approved_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approved At"
          },
          "approved_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approved By"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "dimensions": {
            "items": {
              "$ref": "#/components/schemas/TechnicalDrawingDimension"
            },
            "title": "Dimensions",
            "type": "array"
          },
          "gdt_callouts": {
            "items": {
              "$ref": "#/components/schemas/TechnicalDrawingGdtCallout"
            },
            "title": "Gdt Callouts",
            "type": "array"
          },
          "inspection_requirements": {
            "items": {
              "type": "string"
            },
            "title": "Inspection Requirements",
            "type": "array"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "part_name": {
            "title": "Part Name",
            "type": "string"
          },
          "surface_finishes": {
            "items": {
              "$ref": "#/components/schemas/TechnicalDrawingSurfaceFinish"
            },
            "title": "Surface Finishes",
            "type": "array"
          }
        },
        "required": [
          "node_id",
          "created_at",
          "name",
          "part_name",
          "dimensions",
          "gdt_callouts",
          "surface_finishes",
          "inspection_requirements",
          "approved"
        ],
        "title": "TechnicalDrawingSummary",
        "type": "object"
      },
      "TechnicalDrawingSurfaceFinish": {
        "description": "One surface-finish requirement on a technical_drawing (FORGE-293).",
        "properties": {
          "feature": {
            "title": "Feature",
            "type": "string"
          },
          "ra_um": {
            "title": "Ra Um",
            "type": "number"
          }
        },
        "required": [
          "feature",
          "ra_um"
        ],
        "title": "TechnicalDrawingSurfaceFinish",
        "type": "object"
      },
      "TestPlanEntry": {
        "properties": {
          "acceptance_value": {
            "title": "Acceptance Value",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "requirement_id": {
            "title": "Requirement Id",
            "type": "string"
          },
          "step": {
            "title": "Step",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "requirement_id",
          "step",
          "acceptance_value"
        ],
        "title": "TestPlanEntry",
        "type": "object"
      },
      "TestPlanListEntry": {
        "properties": {
          "acceptance_value": {
            "title": "Acceptance Value",
            "type": "string"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "requirement_id": {
            "title": "Requirement Id",
            "type": "string"
          },
          "step": {
            "title": "Step",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "requirement_id",
          "step",
          "acceptance_value",
          "created_at"
        ],
        "title": "TestPlanListEntry",
        "type": "object"
      },
      "TestPlanListResponse": {
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/TestPlanListEntry"
            },
            "title": "Entries",
            "type": "array"
          }
        },
        "required": [
          "entries"
        ],
        "title": "TestPlanListResponse",
        "type": "object"
      },
      "ThreadListResponse": {
        "description": "Paginated list of thread summaries.",
        "properties": {
          "page": {
            "title": "Page",
            "type": "integer"
          },
          "per_page": {
            "title": "Per Page",
            "type": "integer"
          },
          "threads": {
            "items": {
              "$ref": "#/components/schemas/ThreadSummaryResponse"
            },
            "title": "Threads",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "threads",
          "total",
          "page",
          "per_page"
        ],
        "title": "ThreadListResponse",
        "type": "object"
      },
      "ThreadResponse": {
        "description": "Full thread with its messages.",
        "properties": {
          "archived": {
            "title": "Archived",
            "type": "boolean"
          },
          "channel_id": {
            "title": "Channel Id",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "last_message_at": {
            "format": "date-time",
            "title": "Last Message At",
            "type": "string"
          },
          "messages": {
            "items": {
              "$ref": "#/components/schemas/MessageResponse"
            },
            "title": "Messages",
            "type": "array"
          },
          "scope_entity_id": {
            "title": "Scope Entity Id",
            "type": "string"
          },
          "scope_kind": {
            "title": "Scope Kind",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "channel_id",
          "scope_kind",
          "scope_entity_id",
          "title",
          "archived",
          "created_at",
          "last_message_at"
        ],
        "title": "ThreadResponse",
        "type": "object"
      },
      "ThreadSummaryResponse": {
        "description": "Thread without messages -- used in list views.",
        "properties": {
          "archived": {
            "title": "Archived",
            "type": "boolean"
          },
          "channel_id": {
            "title": "Channel Id",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "last_message_at": {
            "format": "date-time",
            "title": "Last Message At",
            "type": "string"
          },
          "message_count": {
            "default": 0,
            "title": "Message Count",
            "type": "integer"
          },
          "scope_entity_id": {
            "title": "Scope Entity Id",
            "type": "string"
          },
          "scope_kind": {
            "title": "Scope Kind",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "channel_id",
          "scope_kind",
          "scope_entity_id",
          "title",
          "archived",
          "created_at",
          "last_message_at"
        ],
        "title": "ThreadSummaryResponse",
        "type": "object"
      },
      "ToolInfo": {
        "properties": {
          "capability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capability"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "server": {
            "title": "Server",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "server"
        ],
        "title": "ToolInfo",
        "type": "object"
      },
      "TraceabilityCoverage": {
        "description": "Percentages (0-100), spec section 33. `None` when the denominator is\nzero -- an empty set has no meaningful coverage ratio, not 0% or 100%.",
        "properties": {
          "critical_requirements_to_evidence": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Critical Requirements To Evidence"
          },
          "needs_to_requirements": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Needs To Requirements"
          },
          "requirements_to_architecture": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirements To Architecture"
          },
          "requirements_to_verification": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requirements To Verification"
          },
          "verification_to_evidence": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verification To Evidence"
          }
        },
        "title": "TraceabilityCoverage",
        "type": "object"
      },
      "TwinNodeListResponse": {
        "description": "Paginated list of twin nodes.",
        "properties": {
          "nodes": {
            "items": {
              "$ref": "#/components/schemas/TwinNodeResponse"
            },
            "title": "Nodes",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "nodes",
          "total"
        ],
        "title": "TwinNodeListResponse",
        "type": "object"
      },
      "TwinNodeResponse": {
        "description": "Single node in the Digital Twin graph, shaped for the dashboard.",
        "properties": {
          "assembly": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Assembly"
          },
          "assemblyParts": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Assemblyparts"
          },
          "dependsOn": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/RecordPinResponse"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dependson"
          },
          "domain": {
            "title": "Domain",
            "type": "string"
          },
          "geometryParameters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Geometryparameters"
          },
          "hasScript": {
            "default": false,
            "title": "Hasscript",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "meshStats": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Meshstats"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "poses": {
            "anyOf": [
              {
                "additionalProperties": {
                  "additionalProperties": {
                    "type": "number"
                  },
                  "type": "object"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Poses"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "properties": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                }
              ]
            },
            "title": "Properties",
            "type": "object"
          },
          "staleness": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RecordStalenessResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "technicalDrawing": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Technicaldrawing"
          },
          "type": {
            "title": "Type",
            "type": "string"
          },
          "updatedAt": {
            "title": "Updatedat",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "domain",
          "status",
          "properties",
          "updatedAt"
        ],
        "title": "TwinNodeResponse",
        "type": "object"
      },
      "TwinNodeScriptResponse": {
        "description": "The current generation script text for a CAD_MODEL node (MET-630).",
        "properties": {
          "git_commit_sha": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Git Commit Sha"
          },
          "git_path": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Git Path"
          },
          "node_id": {
            "title": "Node Id",
            "type": "string"
          },
          "script_node_id": {
            "title": "Script Node Id",
            "type": "string"
          },
          "script_source": {
            "title": "Script Source",
            "type": "string"
          }
        },
        "required": [
          "node_id",
          "script_node_id",
          "script_source"
        ],
        "title": "TwinNodeScriptResponse",
        "type": "object"
      },
      "TwinRelationshipListResponse": {
        "description": "List of edges for the Digital Twin graph.",
        "properties": {
          "relationships": {
            "items": {
              "$ref": "#/components/schemas/TwinRelationshipResponse"
            },
            "title": "Relationships",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "relationships",
          "total"
        ],
        "title": "TwinRelationshipListResponse",
        "type": "object"
      },
      "TwinRelationshipResponse": {
        "description": "A single directed edge in the Digital Twin graph.",
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "sourceId": {
            "title": "Sourceid",
            "type": "string"
          },
          "targetId": {
            "title": "Targetid",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "id",
          "sourceId",
          "targetId",
          "type",
          "label"
        ],
        "title": "TwinRelationshipResponse",
        "type": "object"
      },
      "UpdateAssemblyJointsRequest": {
        "description": "Body for ``PATCH /nodes/{node_id}/assembly-joints`` -- whole-list replace.",
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/AssemblyJoint"
            },
            "title": "Joints",
            "type": "array"
          }
        },
        "required": [
          "joints"
        ],
        "title": "UpdateAssemblyJointsRequest",
        "type": "object"
      },
      "UpdateAssemblyJointsResponse": {
        "properties": {
          "assembly": {
            "additionalProperties": true,
            "title": "Assembly",
            "type": "object"
          },
          "nodeId": {
            "title": "Nodeid",
            "type": "string"
          }
        },
        "required": [
          "nodeId",
          "assembly"
        ],
        "title": "UpdateAssemblyJointsResponse",
        "type": "object"
      },
      "UpdateProjectRequest": {
        "description": "Body for ``PATCH /v1/projects/{id}``. Only supplied fields change.",
        "properties": {
          "description": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "name": {
            "anyOf": [
              {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          }
        },
        "title": "UpdateProjectRequest",
        "type": "object"
      },
      "UpdateThreadScopeRequest": {
        "description": "Body for ``PATCH /api/v1/chat/threads/{id}/scope`` (MET-580).\n\nRescopes an EXISTING thread in place, preserving its conversation \u2014 unlike\n``CreateThreadRequest``, which always starts a fresh thread.",
        "properties": {
          "scope_entity_id": {
            "description": "ID of the scoped entity",
            "title": "Scope Entity Id",
            "type": "string"
          },
          "scope_kind": {
            "description": "Scope type (session, approval, project, ...)",
            "title": "Scope Kind",
            "type": "string"
          }
        },
        "required": [
          "scope_kind",
          "scope_entity_id"
        ],
        "title": "UpdateThreadScopeRequest",
        "type": "object"
      },
      "UrdfAssemblyExportRequest": {
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/JointSpec"
            },
            "title": "Joints",
            "type": "array"
          },
          "mesh_angular_tolerance": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Max angle (radians) between adjacent facet normals. Omit for OCCT's default.",
            "title": "Mesh Angular Tolerance"
          },
          "mesh_format": {
            "default": "stl",
            "enum": [
              "stl",
              "obj"
            ],
            "title": "Mesh Format",
            "type": "string"
          },
          "mesh_tolerance": {
            "anyOf": [
              {
                "exclusiveMinimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Max linear deviation (mm) between the tessellated mesh and the true CAD surface, applied to every part \u2014 smaller means more triangles on curves/fillets and less visible faceting. Omit to keep OCCT's default.",
            "title": "Mesh Tolerance"
          },
          "mesh_uri_prefix": {
            "default": "",
            "title": "Mesh Uri Prefix",
            "type": "string"
          },
          "parts": {
            "items": {
              "$ref": "#/components/schemas/PartRef"
            },
            "minItems": 1,
            "title": "Parts",
            "type": "array"
          },
          "persist": {
            "default": true,
            "description": "Commit this export as a robot_description Twin work product (default on). Set false to keep the pre-MET-740 throwaway-only behavior.",
            "title": "Persist",
            "type": "boolean"
          },
          "persist_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Work-product display name (default: '<robot_name> robot description').",
            "title": "Persist Name"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to link the persisted work product to.",
            "title": "Project Id"
          },
          "robot_name": {
            "default": "robot",
            "title": "Robot Name",
            "type": "string"
          },
          "update_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "An existing robot_description node's id \u2014 when given, this export replaces that node's content and records a new version instead of creating a new node.",
            "title": "Update Node Id"
          },
          "xacro": {
            "default": false,
            "title": "Xacro",
            "type": "boolean"
          }
        },
        "required": [
          "parts"
        ],
        "title": "UrdfAssemblyExportRequest",
        "type": "object"
      },
      "UrdfAssemblyExportResponse": {
        "properties": {
          "joint_names": {
            "items": {
              "type": "string"
            },
            "title": "Joint Names",
            "type": "array"
          },
          "joints": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/EmittedJoint"
            },
            "title": "Joints",
            "type": "array"
          },
          "link_names": {
            "items": {
              "type": "string"
            },
            "title": "Link Names",
            "type": "array"
          },
          "mesh_files": {
            "items": {
              "$ref": "#/components/schemas/ExportFile"
            },
            "title": "Mesh Files",
            "type": "array"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "robot_description_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Robot Description Node Id"
          },
          "robot_name": {
            "title": "Robot Name",
            "type": "string"
          }
        },
        "required": [
          "output_file",
          "mesh_files",
          "robot_name",
          "link_names",
          "joint_names"
        ],
        "title": "UrdfAssemblyExportResponse",
        "type": "object"
      },
      "UrdfExportRequest": {
        "properties": {
          "density_kg_m3": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Density Kg M3"
          },
          "link_name": {
            "default": "base_link",
            "title": "Link Name",
            "type": "string"
          },
          "material": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material"
          },
          "mesh_format": {
            "default": "stl",
            "enum": [
              "stl",
              "obj"
            ],
            "title": "Mesh Format",
            "type": "string"
          },
          "mesh_uri_prefix": {
            "default": "",
            "title": "Mesh Uri Prefix",
            "type": "string"
          },
          "node_id": {
            "description": "Twin work-product node id (STEP file).",
            "minLength": 1,
            "title": "Node Id",
            "type": "string"
          },
          "xacro": {
            "default": false,
            "title": "Xacro",
            "type": "boolean"
          }
        },
        "required": [
          "node_id"
        ],
        "title": "UrdfExportRequest",
        "type": "object"
      },
      "UrdfExportResponse": {
        "properties": {
          "center_of_mass_m": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Center Of Mass M",
            "type": "object"
          },
          "density_kg_m3": {
            "title": "Density Kg M3",
            "type": "number"
          },
          "inertia_kgm2": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Inertia Kgm2",
            "type": "object"
          },
          "link_name": {
            "title": "Link Name",
            "type": "string"
          },
          "mass_kg": {
            "title": "Mass Kg",
            "type": "number"
          },
          "mesh_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          }
        },
        "required": [
          "output_file",
          "mesh_file",
          "link_name",
          "density_kg_m3",
          "mass_kg",
          "center_of_mass_m",
          "inertia_kgm2"
        ],
        "title": "UrdfExportResponse",
        "type": "object"
      },
      "UsdAssemblyExportRequest": {
        "properties": {
          "joints": {
            "items": {
              "$ref": "#/components/schemas/JointSpec"
            },
            "title": "Joints",
            "type": "array"
          },
          "parts": {
            "items": {
              "$ref": "#/components/schemas/PartRef"
            },
            "minItems": 1,
            "title": "Parts",
            "type": "array"
          },
          "persist": {
            "default": true,
            "description": "Commit this export as a robot_description Twin work product (default on). Set false to keep the pre-MET-740 throwaway-only behavior.",
            "title": "Persist",
            "type": "boolean"
          },
          "persist_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Work-product display name (default: '<robot_name> robot description').",
            "title": "Persist Name"
          },
          "project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Project to link the persisted work product to.",
            "title": "Project Id"
          },
          "robot_name": {
            "default": "robot",
            "title": "Robot Name",
            "type": "string"
          },
          "update_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "An existing robot_description node's id \u2014 when given, this export replaces that node's content and records a new version instead of creating a new node.",
            "title": "Update Node Id"
          }
        },
        "required": [
          "parts"
        ],
        "title": "UsdAssemblyExportRequest",
        "type": "object"
      },
      "UsdAssemblyExportResponse": {
        "properties": {
          "joint_names": {
            "items": {
              "type": "string"
            },
            "title": "Joint Names",
            "type": "array"
          },
          "joints": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/EmittedJoint"
            },
            "title": "Joints",
            "type": "array"
          },
          "link_names": {
            "items": {
              "type": "string"
            },
            "title": "Link Names",
            "type": "array"
          },
          "mesh_files": {
            "items": {
              "$ref": "#/components/schemas/ExportFile"
            },
            "title": "Mesh Files",
            "type": "array"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "robot_description_node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Robot Description Node Id"
          },
          "robot_name": {
            "title": "Robot Name",
            "type": "string"
          }
        },
        "required": [
          "output_file",
          "mesh_files",
          "robot_name",
          "link_names",
          "joint_names"
        ],
        "title": "UsdAssemblyExportResponse",
        "type": "object"
      },
      "UsdExportRequest": {
        "properties": {
          "density_kg_m3": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Density Kg M3"
          },
          "material": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material"
          },
          "node_id": {
            "description": "Twin work-product node id (STEP file).",
            "minLength": 1,
            "title": "Node Id",
            "type": "string"
          },
          "prim_name": {
            "default": "model",
            "title": "Prim Name",
            "type": "string"
          }
        },
        "required": [
          "node_id"
        ],
        "title": "UsdExportRequest",
        "type": "object"
      },
      "UsdExportResponse": {
        "properties": {
          "center_of_mass_m": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Center Of Mass M",
            "type": "object"
          },
          "density_kg_m3": {
            "title": "Density Kg M3",
            "type": "number"
          },
          "inertia_kgm2": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Inertia Kgm2",
            "type": "object"
          },
          "mass_kg": {
            "title": "Mass Kg",
            "type": "number"
          },
          "mesh_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "output_file": {
            "$ref": "#/components/schemas/ExportFile"
          },
          "prim_name": {
            "title": "Prim Name",
            "type": "string"
          },
          "triangle_count": {
            "title": "Triangle Count",
            "type": "integer"
          }
        },
        "required": [
          "output_file",
          "mesh_file",
          "prim_name",
          "triangle_count",
          "density_kg_m3",
          "mass_kg",
          "center_of_mass_m",
          "inertia_kgm2"
        ],
        "title": "UsdExportResponse",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      },
      "ValidationView": {
        "properties": {
          "valid": {
            "title": "Valid",
            "type": "boolean"
          },
          "violations": {
            "items": {
              "type": "string"
            },
            "title": "Violations",
            "type": "array"
          }
        },
        "required": [
          "valid"
        ],
        "title": "ValidationView",
        "type": "object"
      },
      "WorkProductRevision": {
        "description": "A single snapshot in a work product's revision history.",
        "properties": {
          "change_description": {
            "title": "Change Description",
            "type": "string"
          },
          "content_hash": {
            "title": "Content Hash",
            "type": "string"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "metadata_snapshot": {
            "additionalProperties": true,
            "title": "Metadata Snapshot",
            "type": "object"
          },
          "revision": {
            "title": "Revision",
            "type": "integer"
          }
        },
        "required": [
          "revision",
          "created_at",
          "content_hash",
          "change_description",
          "metadata_snapshot"
        ],
        "title": "WorkProductRevision",
        "type": "object"
      },
      "WorkProductVersionHistory": {
        "description": "Full version history for a work product.",
        "properties": {
          "revisions": {
            "items": {
              "$ref": "#/components/schemas/WorkProductRevision"
            },
            "title": "Revisions",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          },
          "work_product_id": {
            "title": "Work Product Id",
            "type": "string"
          }
        },
        "required": [
          "work_product_id",
          "revisions",
          "total"
        ],
        "title": "WorkProductVersionHistory",
        "type": "object"
      }
    }
  },
  "info": {
    "description": "HTTP/WebSocket front door for the MetaForge platform",
    "title": "MetaForge Gateway",
    "version": "0.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/health": {
      "get": {
        "description": "Return the aggregated health of the gateway and its dependencies.",
        "operationId": "health_check_health_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthResponse"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "Health Check",
        "tags": [
          "health"
        ]
      }
    },
    "/v1/approvals": {
      "get": {
        "description": "Every approval, normalized. ``status=decided`` and ``all`` are the audit views.",
        "operationId": "list_approvals_v1_approvals_get",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "default": "pending",
              "enum": [
                "pending",
                "decided",
                "all"
              ],
              "title": "Status",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "in": "query",
            "name": "kind",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "gate",
                    "flow_proposal",
                    "flow_version",
                    "flow_patch",
                    "tool_call",
                    "human_authority",
                    "design_change",
                    "design_loop",
                    "sketch",
                    "drawing"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Kind"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Approvals",
        "tags": [
          "approvals"
        ]
      }
    },
    "/v1/approvals/{approval_id}": {
      "get": {
        "operationId": "get_approval_v1_approvals__approval_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "approval_id",
            "required": true,
            "schema": {
              "title": "Approval Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Approval",
        "tags": [
          "approvals"
        ]
      }
    },
    "/v1/approvals/{approval_id}/decision": {
      "post": {
        "description": "Decide an approval of any kind.\n\nThe deciding human is the authenticated principal for every kind. A\n``reviewer`` or ``approved_by`` in the body is ignored and logged.",
        "operationId": "decide_approval_v1_approvals__approval_id__decision_post",
        "parameters": [
          {
            "in": "path",
            "name": "approval_id",
            "required": true,
            "schema": {
              "title": "Approval Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DecisionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Decide Approval",
        "tags": [
          "approvals"
        ]
      }
    },
    "/v1/approvals/{approval_id}/inline-decision": {
      "post": {
        "description": "Record a gate decision a person gave in the MCP client's chat (FORGE-582).\n\nGates only: a held tool call's inline answer has its own route\n(``/v1/tool-approvals/{id}/resolve``). The decision goes through the same\n``service.decide`` as a dashboard click, so a gate that is not ready\nstill cannot be approved, and retry and rework caps still apply.",
        "operationId": "decide_inline_v1_approvals__approval_id__inline_decision_post",
        "parameters": [
          {
            "in": "path",
            "name": "approval_id",
            "required": true,
            "schema": {
              "title": "Approval Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InlineDecisionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Decide Inline",
        "tags": [
          "approvals"
        ]
      }
    },
    "/v1/assistant/proposals": {
      "get": {
        "description": "List pending design-change proposals, optionally filtered by session/project.",
        "operationId": "list_proposals_v1_assistant_proposals_get",
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Session Id"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProposalListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Proposals",
        "tags": [
          "assistant"
        ]
      },
      "post": {
        "description": "Create a design-change proposal directly from a human (MET-630).\n\nSame underlying ``ApprovalWorkflow.propose_change`` an agent's\n``twin.propose_change`` MCP call uses \u2014 a human (e.g. via a dashboard\nparameter panel) can submit one just as well, and it goes through the\nidentical review/apply pipeline (``decide`` \u2192 apply executor).",
        "operationId": "create_proposal_v1_assistant_proposals_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProposalRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DesignChangeProposal"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Proposal",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/assistant/proposals/{change_id}": {
      "get": {
        "description": "Return a single design-change proposal.",
        "operationId": "get_proposal_v1_assistant_proposals__change_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "change_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Change Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DesignChangeProposal"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Proposal",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/assistant/proposals/{change_id}/decide": {
      "post": {
        "description": "Approve or reject a pending design-change proposal.\n\nOn approval, run the proposal's diff via the apply executor (if wired) so the\nchange is actually applied to the twin (HITL: propose \u2192 approve \u2192 apply).",
        "operationId": "decide_proposal_v1_assistant_proposals__change_id__decide_post",
        "parameters": [
          {
            "in": "path",
            "name": "change_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Change Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApprovalDecision"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DesignChangeProposal"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Decide Proposal",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/assistant/request": {
      "post": {
        "description": "Submit a request to an agent via the orchestrator.\n\nLooks up the workflow definition for ``body.action``, creates a\nWorkflowRun, and dispatches it through the Scheduler.",
        "operationId": "submit_request_v1_assistant_request_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssistantRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssistantResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Request",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/assistant/request/{run_id}": {
      "get": {
        "description": "Poll the status of a workflow run.",
        "operationId": "get_run_status_v1_assistant_request__run_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Run Status",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/assistant/sessions/{session_id}/events": {
      "get": {
        "description": "SSE endpoint \u2014 streams real-time events for *session_id*.",
        "operationId": "session_events_v1_assistant_sessions__session_id__events_get",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Session Events",
        "tags": [
          "assistant"
        ]
      }
    },
    "/v1/bom": {
      "get": {
        "description": "List BOM components, optionally scoped to a project and/or filtered\nby ``category`` (case-insensitive exact match against\n``BOMItem.specifications.category``, e.g. ``category=fastener`` for a\nfastener list -- FORGE-294, gap G-H2).\n\nEmpty (``{components: [], total: 0}``) when the project has no BOM \u2014 not a\n404, so the dashboard renders a clean empty state.",
        "operationId": "list_bom_v1_bom_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Category"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BomListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Bom",
        "tags": [
          "bom"
        ]
      }
    },
    "/v1/bom/hierarchical": {
      "get": {
        "description": "Derive the hierarchical BOM (EBOM) -- FORGE-267, gap G-C3 -- from\nevery \"product\"-kind HierarchyNode's CONTAINS tree in a project.\n\nEmpty (not an error) when the project has no product hierarchy yet\n(FORGE-260's tools haven't been used for it) -- matches the flat BOM's\nown convention.",
        "operationId": "list_hierarchical_bom_v1_bom_hierarchical_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HierarchicalBomResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Hierarchical Bom",
        "tags": [
          "bom"
        ]
      }
    },
    "/v1/bom/risk": {
      "get": {
        "operationId": "get_bom_risk_v1_bom_risk_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Bom Risk V1 Bom Risk Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Bom Risk",
        "tags": [
          "bom"
        ]
      }
    },
    "/v1/bringup": {
      "get": {
        "operationId": "list_bringup_checklists_v1_bringup_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BringupChecklistListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Bringup Checklists",
        "tags": [
          "bringup"
        ]
      },
      "post": {
        "operationId": "create_bringup_checklist_v1_bringup_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBringupChecklistRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateBringupChecklistResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Bringup Checklist",
        "tags": [
          "bringup"
        ]
      }
    },
    "/v1/cad-export/download/{export_id}/{filename}": {
      "get": {
        "operationId": "download_export_file_v1_cad_export_download__export_id___filename__get",
        "parameters": [
          {
            "in": "path",
            "name": "export_id",
            "required": true,
            "schema": {
              "title": "Export Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "filename",
            "required": true,
            "schema": {
              "title": "Filename",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Download Export File",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/ros2-launch": {
      "post": {
        "operationId": "generate_ros2_launch_v1_cad_export_ros2_launch_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Ros2LaunchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ros2LaunchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Generate Ros2 Launch",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/sdf": {
      "post": {
        "operationId": "export_sdf_v1_cad_export_sdf_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SdfExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SdfExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Sdf",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/sdf-assembly": {
      "post": {
        "operationId": "export_sdf_assembly_v1_cad_export_sdf_assembly_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SdfAssemblyExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SdfAssemblyExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Sdf Assembly",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/sessions/{session_id}": {
      "get": {
        "operationId": "get_session_summary_v1_cad_export_sessions__session_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionSummary"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Session Summary",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/sessions/{session_id}/joints": {
      "get": {
        "operationId": "get_session_joints_v1_cad_export_sessions__session_id__joints_get",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionJointsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Session Joints",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/urdf": {
      "post": {
        "operationId": "export_urdf_v1_cad_export_urdf_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrdfExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UrdfExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Urdf",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/urdf-assembly": {
      "post": {
        "operationId": "export_urdf_assembly_v1_cad_export_urdf_assembly_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrdfAssemblyExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UrdfAssemblyExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Urdf Assembly",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/usd": {
      "post": {
        "operationId": "export_usd_v1_cad_export_usd_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UsdExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UsdExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Usd",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad-export/usd-assembly": {
      "post": {
        "operationId": "export_usd_assembly_v1_cad_export_usd_assembly_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UsdAssemblyExportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UsdAssemblyExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Export Usd Assembly",
        "tags": [
          "cad-export"
        ]
      }
    },
    "/v1/cad/assembly": {
      "post": {
        "description": "Author + commit a multi-part assembly from a declarative spec.",
        "operationId": "create_assembly_v1_cad_assembly_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssemblyRequest-Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssemblyResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Assembly",
        "tags": [
          "cad"
        ]
      }
    },
    "/v1/cad/compile": {
      "post": {
        "description": "Compile a description into a spec and check it \u2014 but do NOT build (dry run).\n\nReturns the spec for review plus any geometric-feasibility warnings, so the\ncaller can tweak it (or save it and run ``/assembly``) before committing.",
        "operationId": "compile_assembly_v1_cad_compile_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompileResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Compile Assembly",
        "tags": [
          "cad"
        ]
      }
    },
    "/v1/cad/from-text": {
      "post": {
        "description": "Compile a plain-English description into a spec (LLM), then build it.\n\nThe LLM only produces the small declarative spec \u2014 the geometry itself is\nauthored deterministically by the same builder as ``/assembly``, so the\noutput is reproducible and the spec is returned for review.",
        "operationId": "create_assembly_from_text_v1_cad_from_text_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FromTextRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FromTextResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Assembly From Text",
        "tags": [
          "cad"
        ]
      }
    },
    "/v1/chat/channels": {
      "get": {
        "description": "Return all available chat channels.",
        "operationId": "list_channels_v1_chat_channels_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChannelListResponse"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "List Channels",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/threads": {
      "get": {
        "description": "List threads with optional filtering and pagination.",
        "operationId": "list_threads_v1_chat_threads_get",
        "parameters": [
          {
            "description": "Filter by channel ID",
            "in": "query",
            "name": "channel_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by channel ID",
              "title": "Channel Id"
            }
          },
          {
            "description": "Filter by scope kind",
            "in": "query",
            "name": "scope_kind",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by scope kind",
              "title": "Scope Kind"
            }
          },
          {
            "description": "Filter by scope entity ID",
            "in": "query",
            "name": "entity_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by scope entity ID",
              "title": "Entity Id"
            }
          },
          {
            "description": "Include archived threads",
            "in": "query",
            "name": "include_archived",
            "required": false,
            "schema": {
              "default": false,
              "description": "Include archived threads",
              "title": "Include Archived",
              "type": "boolean"
            }
          },
          {
            "description": "Page number (1-indexed)",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "description": "Page number (1-indexed)",
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "description": "Results per page",
            "in": "query",
            "name": "per_page",
            "required": false,
            "schema": {
              "default": 20,
              "description": "Results per page",
              "maximum": 100,
              "minimum": 1,
              "title": "Per Page",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ThreadListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Threads",
        "tags": [
          "chat"
        ]
      },
      "post": {
        "description": "Create a new thread, optionally with an initial message.",
        "operationId": "create_thread_v1_chat_threads_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateThreadRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ThreadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Thread",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/threads/{thread_id}": {
      "get": {
        "description": "Return a single thread with all its messages.",
        "operationId": "get_thread_v1_chat_threads__thread_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "thread_id",
            "required": true,
            "schema": {
              "title": "Thread Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ThreadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Thread",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/threads/{thread_id}/messages": {
      "post": {
        "description": "Append a message to an existing thread.\n\nAfter persisting the user message, the handler routes it to the\nappropriate domain agent (when an LLM is configured).  The agent's\nresponse is inserted into the thread automatically.",
        "operationId": "send_message_v1_chat_threads__thread_id__messages_post",
        "parameters": [
          {
            "in": "path",
            "name": "thread_id",
            "required": true,
            "schema": {
              "title": "Thread Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendMessageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Send Message",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/threads/{thread_id}/scope": {
      "patch": {
        "description": "Rescope an EXISTING thread in place (MET-580).\n\nUnlike ``POST /threads``, this preserves the conversation \u2014 the same\nthread continues, and its next turn's project brief (if scoped to a\nproject) reflects the new scope. The agent-callable ``chat.set_project_scope``\nnative tool goes through the same ``apply_thread_scope`` helper, so a human\nhitting this endpoint and the agent switching scope mid-turn behave\nidentically and both broadcast the same ``scope.changed`` SSE event.",
        "operationId": "update_thread_scope_v1_chat_threads__thread_id__scope_patch",
        "parameters": [
          {
            "in": "path",
            "name": "thread_id",
            "required": true,
            "schema": {
              "title": "Thread Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateThreadScopeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ThreadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Update Thread Scope",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/threads/{thread_id}/stream": {
      "get": {
        "description": "Stream real-time events for a chat thread via Server-Sent Events.\n\nThe client receives events as they occur:\n\n- ``message.created`` -- a new message was added\n- ``agent.typing``    -- an agent is processing\n- ``context.stats``   -- the turn's context-window snapshot: tokens used vs.\n  the model's window, broken down by system prompt / project brief / history /\n  tool schemas / message, with included-vs-available counts (harness turns)\n- ``agent.step``      -- one reasoning/tool-call step in the agent's trace\n- ``message.delta``   -- one token/chunk of the streaming answer\n- ``agent.done``      -- an agent finished\n- ``error``           -- an error occurred\n\nThe connection stays open until the client disconnects or the server\ncloses the stream.",
        "operationId": "stream_thread_events_v1_chat_threads__thread_id__stream_get",
        "parameters": [
          {
            "in": "path",
            "name": "thread_id",
            "required": true,
            "schema": {
              "title": "Thread Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Stream Thread Events",
        "tags": [
          "chat"
        ]
      }
    },
    "/v1/chat/tool_approvals": {
      "get": {
        "description": "Tool-call approvals: the ones awaiting a decision, or every one.\n\nOverdue holds are expired first, so nothing listed as pending is a call\nwhose waiter has already given up (FORGE-466). ``status=all`` is the audit\nview (FORGE-473): every entry whichever route answered it, each carrying\nits ``route``, outcome and approver.\n\n``project_id`` scopes the queue. Unscoped before, so a reviewer working\non one project saw every project's held writes in one list -- and a held\nwrite names a tool and a caller, not a product, so there was no way to\ntell from the row which one it belonged to. Approvals whose tool call\ncarried no project are counted rather than dropped: an approval that\nquietly disappears is the one nobody answers.",
        "operationId": "list_pending_approvals_v1_chat_tool_approvals_get",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "default": "pending",
              "enum": [
                "pending",
                "all"
              ],
              "title": "Status",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Pending Approvals",
        "tags": [
          "chat-tool-approvals"
        ]
      },
      "post": {
        "description": "Create a held approval and return it.\n\nThis exists because the approval store is process-level (an\n``InMemoryRunStore`` in *this* process), and the MCP sidecar is a\ndifferent process. Before FORGE-406 a sidecar could only hold calls in\nits own memory, where the dashboard \u2014 served from here \u2014 would never see\nthem. So the sidecar parks them here instead, and there is exactly one\nledger rather than one per process.\n\nA second store would have been the more obvious fix and the wrong one:\ntwo queues means a reviewer clearing one while the other fills, and no\npage that shows both.",
        "operationId": "hold_tool_call_v1_chat_tool_approvals_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HoldToolCallRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Hold Tool Call",
        "tags": [
          "chat-tool-approvals"
        ]
      }
    },
    "/v1/chat/tool_approvals/{run_id}": {
      "get": {
        "operationId": "get_approval_v1_chat_tool_approvals__run_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Approval",
        "tags": [
          "chat-tool-approvals"
        ]
      },
      "post": {
        "description": "Record the decision, attributed to whoever made this request.\n\nThe identity comes from the request, not the body (FORGE-393). A client\ncannot nominate the approver, which is the whole point: some tools write\nthe approver's name down as their result.",
        "operationId": "submit_tool_approval_v1_chat_tool_approvals__run_id__post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApprovalRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Tool Approval",
        "tags": [
          "chat-tool-approvals"
        ]
      }
    },
    "/v1/chat/tool_approvals/{run_id}/resolve": {
      "post": {
        "description": "The waiting side stopped waiting: close the hold so nobody answers it.\n\nIdempotent. A hold already ``timed_out`` or ``canceled`` comes back as it\nis with 200, so a retry after a lost response is harmless. A hold a human\nalready decided is 409: the waiter must read the decision back rather\nthan overwrite it, because an approval that landed in the last instant is\nstill an approval.",
        "operationId": "resolve_unanswered_hold_v1_chat_tool_approvals__run_id__resolve_post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveHoldRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Resolve Unanswered Hold",
        "tags": [
          "chat-tool-approvals"
        ]
      }
    },
    "/v1/client-tasks": {
      "get": {
        "description": "Tasks, open ones by default. ``status=all`` lists every state.",
        "operationId": "list_tasks_v1_client_tasks_get",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "open",
              "title": "Status"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "in": "query",
            "name": "run_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response List Tasks V1 Client Tasks Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Tasks",
        "tags": [
          "client-tasks"
        ]
      },
      "post": {
        "description": "Post a phase for the client. Idempotent on ``run:phase:attempt``.",
        "operationId": "open_task_v1_client_tasks_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OpenTaskRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Open Task V1 Client Tasks Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Open Task",
        "tags": [
          "client-tasks"
        ]
      }
    },
    "/v1/client-tasks/{task_id}": {
      "get": {
        "operationId": "get_task_v1_client_tasks__task_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "title": "Task Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Task V1 Client Tasks  Task Id  Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Task",
        "tags": [
          "client-tasks"
        ]
      }
    },
    "/v1/client-tasks/{task_id}/cancel": {
      "post": {
        "description": "Withdraw a task nobody will wait on any more (the worker's activity ended).",
        "operationId": "cancel_task_v1_client_tasks__task_id__cancel_post",
        "parameters": [
          {
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "title": "Task Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Cancel Task V1 Client Tasks  Task Id  Cancel Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Cancel Task",
        "tags": [
          "client-tasks"
        ]
      }
    },
    "/v1/client-tasks/{task_id}/claim": {
      "post": {
        "description": "Take a task and get its full brief.",
        "operationId": "claim_task_v1_client_tasks__task_id__claim_post",
        "parameters": [
          {
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "title": "Task Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClaimRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Claim Task V1 Client Tasks  Task Id  Claim Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Claim Task",
        "tags": [
          "client-tasks"
        ]
      }
    },
    "/v1/client-tasks/{task_id}/submit": {
      "post": {
        "description": "Hand the phase back. The run's gate then checks the twin as usual.",
        "operationId": "submit_task_v1_client_tasks__task_id__submit_post",
        "parameters": [
          {
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "title": "Task Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Submit Task V1 Client Tasks  Task Id  Submit Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Task",
        "tags": [
          "client-tasks"
        ]
      }
    },
    "/v1/compliance/{project_id}/checklist": {
      "get": {
        "description": "Generate a compliance checklist for the given project and markets.\n\nMarkets are provided as a comma-separated query parameter, e.g.\n``?markets=UKCA,CE,FCC``.",
        "operationId": "get_checklist_v1_compliance__project_id__checklist_get",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          },
          {
            "description": "Comma-separated regime codes",
            "in": "query",
            "name": "markets",
            "required": false,
            "schema": {
              "default": "UKCA,CE",
              "description": "Comma-separated regime codes",
              "title": "Markets",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChecklistResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Checklist",
        "tags": [
          "compliance"
        ]
      }
    },
    "/v1/compliance/{project_id}/coverage": {
      "get": {
        "description": "Get evidence coverage statistics for a project.",
        "operationId": "get_coverage_v1_compliance__project_id__coverage_get",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Coverage",
        "tags": [
          "compliance"
        ]
      }
    },
    "/v1/compliance/{project_id}/evidence": {
      "post": {
        "description": "Link a piece of evidence to a compliance checklist item.",
        "operationId": "link_evidence_v1_compliance__project_id__evidence_post",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinkEvidenceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvidenceResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Link Evidence",
        "tags": [
          "compliance"
        ]
      }
    },
    "/v1/compliance/{project_id}/evidence/{item_id}": {
      "get": {
        "description": "Retrieve all evidence records for a checklist item.",
        "operationId": "get_evidence_v1_compliance__project_id__evidence__item_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "item_id",
            "required": true,
            "schema": {
              "title": "Item Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/EvidenceResponse"
                  },
                  "title": "Response Get Evidence V1 Compliance  Project Id  Evidence  Item Id  Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Evidence",
        "tags": [
          "compliance"
        ]
      }
    },
    "/v1/component-selection/select": {
      "post": {
        "operationId": "select_component_v1_component_selection_select_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SelectComponentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Select Component V1 Component Selection Select Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Select Component",
        "tags": [
          "component-selection"
        ]
      }
    },
    "/v1/constraint/synthesize": {
      "post": {
        "description": "Turn a drag delta into a parametric constraint, and \u2014 when the dragged\ngroup maps to a live FreeCAD session object (``session_id`` + ``obj_id``) \u2014\n**bind it into the model** so Apply re-parameterizes and re-solves (MET-531).\n\nWithout a session/object it stays a suggestion-only stub (MET-519). Binding\nis best-effort: an adapter error leaves the suggestion intact with\n``bound=False`` and a ``binding_error``.",
        "operationId": "synthesize_constraint_v1_constraint_synthesize_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SynthesizeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SynthesizeResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Synthesize Constraint",
        "tags": [
          "constraint"
        ]
      }
    },
    "/v1/controls/repeatability-estimate": {
      "get": {
        "operationId": "get_repeatability_estimate_v1_controls_repeatability_estimate_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "requirement_mm",
            "required": false,
            "schema": {
              "default": 0.5,
              "title": "Requirement Mm",
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "end_effector_part",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Effector Part"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepeatabilityEstimateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Repeatability Estimate",
        "tags": [
          "controls"
        ]
      }
    },
    "/v1/convert": {
      "post": {
        "description": "Upload a STEP/IGES file and convert to GLB.\n\nReturns the conversion result with a URL to the GLB file and metadata.\nResults are cached by content hash \u2014 re-uploading the same file is instant.",
        "operationId": "upload_and_convert_v1_convert_post",
        "parameters": [
          {
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "default": "standard",
              "pattern": "^(preview|standard|fine)$",
              "title": "Quality",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_and_convert_v1_convert_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversionResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Upload And Convert",
        "tags": [
          "convert"
        ]
      }
    },
    "/v1/convert/{file_hash}": {
      "get": {
        "description": "Retrieve a cached conversion result by content hash.",
        "operationId": "get_conversion_v1_convert__file_hash__get",
        "parameters": [
          {
            "in": "path",
            "name": "file_hash",
            "required": true,
            "schema": {
              "title": "File Hash",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "default": "standard",
              "pattern": "^(preview|standard|fine)$",
              "title": "Quality",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversionResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Conversion",
        "tags": [
          "convert"
        ]
      }
    },
    "/v1/convert/{file_hash}/glb": {
      "get": {
        "description": "Download the converted GLB file.",
        "operationId": "get_glb_v1_convert__file_hash__glb_get",
        "parameters": [
          {
            "in": "path",
            "name": "file_hash",
            "required": true,
            "schema": {
              "title": "File Hash",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "default": "standard",
              "pattern": "^(preview|standard|fine)$",
              "title": "Quality",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Glb",
        "tags": [
          "convert"
        ]
      }
    },
    "/v1/convert/{file_hash}/metadata": {
      "get": {
        "description": "Retrieve conversion metadata (part tree, stats, materials).",
        "operationId": "get_metadata_v1_convert__file_hash__metadata_get",
        "parameters": [
          {
            "in": "path",
            "name": "file_hash",
            "required": true,
            "schema": {
              "title": "File Hash",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "default": "standard",
              "pattern": "^(preview|standard|fine)$",
              "title": "Quality",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Metadata V1 Convert  File Hash  Metadata Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Metadata",
        "tags": [
          "convert"
        ]
      }
    },
    "/v1/decisions": {
      "get": {
        "operationId": "list_related_decisions_v1_decisions_get",
        "parameters": [
          {
            "in": "query",
            "name": "related_to",
            "required": true,
            "schema": {
              "title": "Related To",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response List Related Decisions V1 Decisions Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Related Decisions",
        "tags": [
          "decisions"
        ]
      }
    },
    "/v1/design-flows": {
      "get": {
        "description": "Every launchable flow, as the gateway will actually run it.",
        "operationId": "list_design_flows_v1_design_flows_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DesignFlowListResponse"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "List Design Flows",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/intent": {
      "post": {
        "description": "Compile an intent into its structured model. Stores nothing, starts nothing.\n\nDeterministic: no model call, and no value the person did not state. Use\nit before proposing to see what was understood and what is still unknown.",
        "operationId": "compile_flow_intent_v1_design_flows_intent_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProposeFlowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntentModelView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Compile Flow Intent",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/propose": {
      "post": {
        "description": "Tailor a template to a project's intent, and hold it for a human.\n\nThe response carries an ``approvalId``, not a run. FORGE-398's rule is\nthat nothing starts before approval, and the way to make that true is for\nthe endpoint that generates a flow to have no ability to start one.\n\nIf the manufacturing route, target maturity or loads are missing, the\nanswer is ``200`` with ``status: \"needs_input\"`` and the questions to\nanswer -- no flow, no stored version, no held approval (FORGE-463). A\ngenerator that guesses those produces a flow that reads as tailored and\nis not.",
        "operationId": "propose_flow_v1_design_flows_propose_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProposeFlowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FlowNeedsInputView"
                }
              }
            },
            "description": "Inputs missing; nothing held"
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FlowProposalView"
                    },
                    {
                      "$ref": "#/components/schemas/FlowNeedsInputView"
                    }
                  ],
                  "title": "Response Propose Flow V1 Design Flows Propose Post"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Propose Flow",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/validate": {
      "post": {
        "description": "Check an edit without saving it.\n\nThe editor calls this as the canvas changes, so a person sees a rule break\nwhile they are looking at the thing that broke it -- rather than at save,\nby which point they have made five more changes and have to work out which\none the message is about.",
        "operationId": "validate_edited_flow_v1_design_flows_validate_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditFlowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Validate Edited Flow",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/versions": {
      "post": {
        "description": "Save an edit as a new version, held for approval.\n\nNever mutates an existing version. A run pins the version it started on,\nso a version changing underneath would make a completed run's provenance\na lie -- and an approval that can be edited afterwards is not an approval.",
        "operationId": "save_edited_flow_v1_design_flows_versions_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditFlowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FlowVersionView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Save Edited Flow",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/versions/{version_id}": {
      "get": {
        "operationId": "get_flow_version_v1_design_flows_versions__version_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "version_id",
            "required": true,
            "schema": {
              "title": "Version Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FlowVersionView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Flow Version",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/versions/{version_id}/capabilities": {
      "get": {
        "description": "The same assessment for a saved (tailored or edited) flow version.",
        "operationId": "version_capabilities_v1_design_flows_versions__version_id__capabilities_get",
        "parameters": [
          {
            "in": "path",
            "name": "version_id",
            "required": true,
            "schema": {
              "title": "Version Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "profile",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Profile"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CapabilityView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Version Capabilities",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/{flow_id}": {
      "get": {
        "description": "One flow, for the run detail view and the plan canvas.",
        "operationId": "get_design_flow_v1_design_flows__flow_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "flow_id",
            "required": true,
            "schema": {
              "title": "Flow Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DesignFlowView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Design Flow",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-flows/{flow_id}/capabilities": {
      "get": {
        "description": "Can this template be run with the tools that exist and answer right now?\n\n``profile`` narrows coverage to the tools a client connected with that\nMCP profile is served.",
        "operationId": "flow_capabilities_v1_design_flows__flow_id__capabilities_get",
        "parameters": [
          {
            "in": "path",
            "name": "flow_id",
            "required": true,
            "schema": {
              "title": "Flow Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "profile",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Profile"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CapabilityView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Flow Capabilities",
        "tags": [
          "design-flows"
        ]
      }
    },
    "/v1/design-loop/start": {
      "post": {
        "operationId": "start_design_loop_v1_design_loop_start_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StartDesignLoopRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Start Design Loop V1 Design Loop Start Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Start Design Loop",
        "tags": [
          "design-loop"
        ]
      }
    },
    "/v1/design-loop/{loop_id}": {
      "get": {
        "operationId": "get_design_loop_v1_design_loop__loop_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "loop_id",
            "required": true,
            "schema": {
              "title": "Loop Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Design Loop V1 Design Loop  Loop Id  Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Design Loop",
        "tags": [
          "design-loop"
        ]
      }
    },
    "/v1/design-loop/{loop_id}/approve": {
      "post": {
        "operationId": "approve_design_loop_v1_design_loop__loop_id__approve_post",
        "parameters": [
          {
            "in": "path",
            "name": "loop_id",
            "required": true,
            "schema": {
              "title": "Loop Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApproveDesignLoopRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Approve Design Loop V1 Design Loop  Loop Id  Approve Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Approve Design Loop",
        "tags": [
          "design-loop"
        ]
      }
    },
    "/v1/dfm/overhang-check": {
      "post": {
        "operationId": "run_overhang_check_v1_dfm_overhang_check_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OverhangCheckRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OverhangCheckResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Run Overhang Check",
        "tags": [
          "dfm"
        ]
      }
    },
    "/v1/evals": {
      "get": {
        "operationId": "get_evals_v1_evals_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Evals V1 Evals Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "Get Evals",
        "tags": [
          "evals"
        ]
      }
    },
    "/v1/features/generate": {
      "post": {
        "operationId": "generate_feature_v1_features_generate_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateFeatureRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Generate Feature V1 Features Generate Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Generate Feature",
        "tags": [
          "features"
        ]
      }
    },
    "/v1/features/{work_product_id}/diff": {
      "get": {
        "operationId": "get_feature_diff_v1_features__work_product_id__diff_get",
        "parameters": [
          {
            "in": "path",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FeatureDiffResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Feature Diff",
        "tags": [
          "features"
        ]
      }
    },
    "/v1/firmware/scaffold": {
      "post": {
        "operationId": "create_firmware_scaffold_v1_firmware_scaffold_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFirmwareScaffoldRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateFirmwareScaffoldResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Firmware Scaffold",
        "tags": [
          "firmware"
        ]
      }
    },
    "/v1/harness/credentials": {
      "post": {
        "description": "Store a provider credential so the runtime uses it (no restart).\n\n``api_key`` \u2192 the gateway auth store; ``oauth`` \u2192 the Codex ``auth.json`` the\ncodex adapter reads. Validates the provider against the registry.",
        "operationId": "set_credential_v1_harness_credentials_post",
        "parameters": [
          {
            "in": "header",
            "name": "x-metaforge-admin",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Metaforge-Admin"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetCredentialRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OkResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Set Credential",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/credentials/{provider}": {
      "delete": {
        "description": "Forget a provider's stored API key (and clear the selection if it pointed there).",
        "operationId": "delete_credential_v1_harness_credentials__provider__delete",
        "parameters": [
          {
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "title": "Provider",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-metaforge-admin",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Metaforge-Admin"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OkResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Delete Credential",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/models": {
      "get": {
        "description": "Models for a provider. OpenAI-compatible + configured \u2192 live-fetched; else empty.",
        "operationId": "list_models_v1_harness_models_get",
        "parameters": [
          {
            "description": "Provider id",
            "in": "query",
            "name": "provider",
            "required": true,
            "schema": {
              "description": "Provider id",
              "title": "Provider",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Models",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/providers": {
      "get": {
        "description": "List registered providers (configured ones first) + the active selection.",
        "operationId": "list_providers_v1_harness_providers_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProvidersResponse"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "List Providers",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/routing": {
      "get": {
        "description": "Which provider and model each role is routed to.\n\nA role absent from ``roles`` is served by the durable harness selection\n(``default_provider`` / ``default_model``).",
        "operationId": "get_routing_v1_harness_routing_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoutingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Routing",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/selection": {
      "put": {
        "description": "Set the durable active provider/model (overrides the METAFORGE_LLM_* env).",
        "operationId": "set_selection_v1_harness_selection_put",
        "parameters": [
          {
            "in": "header",
            "name": "x-metaforge-admin",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Metaforge-Admin"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetSelectionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OkResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Set Selection",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/harness/tools": {
      "get": {
        "description": "MCP tools/connectors reachable via the gateway's bridge (empty if none wired).",
        "operationId": "list_tools_v1_harness_tools_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ToolInfo"
                  },
                  "title": "Response List Tools V1 Harness Tools Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "List Tools",
        "tags": [
          "harness"
        ]
      }
    },
    "/v1/knowledge/documents": {
      "post": {
        "description": "Ingest a document (markdown / plain text) via the L1 ``KnowledgeService``.\n\nBacks the ``forge ingest <path>`` CLI (MET-336). Heading-aware\nchunking, dedup, and citation metadata are handled by the\nunderlying provider \u2014 the route is a thin pass-through.",
        "operationId": "ingest_document_v1_knowledge_documents_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IngestDocumentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestDocumentResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Ingest Document",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/knowledge/ingest": {
      "post": {
        "description": "Manually ingest a knowledge entry.\n\nRoutes through ``KnowledgeService`` when available so the chunk\npipeline, dedup, and citation-field round-trip apply consistently\nwith ``/documents`` and ``/search`` (MET-390).",
        "operationId": "ingest_knowledge_v1_knowledge_ingest_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IngestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Ingest Knowledge",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/knowledge/search": {
      "get": {
        "description": "Semantic search over indexed knowledge.\n\nRoutes through ``KnowledgeService`` when available so it shares\nthe same backend as ``/ingest`` and ``/documents`` (MET-390).\n\n``project_id`` (MET-670) mirrors the ``projectId`` filter already\non ``/sources`` and ``/ingest``: without it, ``KnowledgeService.search``\nfalls back to the ``default`` tenant, so a project-scoped ingest was\nnever searchable from a project-scoped UI \u2014 the search box silently\nreturned whatever unrelated content happened to live under\n``default`` instead of the active project's own sources.",
        "operationId": "search_knowledge_v1_knowledge_search_get",
        "parameters": [
          {
            "description": "Search query",
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "description": "Search query",
              "minLength": 1,
              "title": "Query",
              "type": "string"
            }
          },
          {
            "description": "Filter by knowledge type",
            "in": "query",
            "name": "knowledgeType",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/KnowledgeType"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by knowledge type",
              "title": "Knowledgetype"
            }
          },
          {
            "description": "Scope search to a project UUID",
            "in": "query",
            "name": "projectId",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Scope search to a project UUID",
              "title": "Projectid"
            }
          },
          {
            "description": "Max results",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 5,
              "description": "Max results",
              "maximum": 50,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Search Knowledge",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/knowledge/sources": {
      "get": {
        "description": "List ingested knowledge sources via ``KnowledgeService.list_sources()``.\n\nBacks the ``forge sources list`` CLI (MET-411). Mirrors the schema\nsurfaced by the ``metaforge://knowledge/sources`` MCP resource.",
        "operationId": "list_knowledge_sources_v1_knowledge_sources_get",
        "parameters": [
          {
            "description": "Filter by knowledge type",
            "in": "query",
            "name": "knowledgeType",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/KnowledgeType"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by knowledge type",
              "title": "Knowledgetype"
            }
          },
          {
            "description": "Filter by project UUID",
            "in": "query",
            "name": "projectId",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by project UUID",
              "title": "Projectid"
            }
          },
          {
            "description": "Max sources to return",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "description": "Max sources to return",
              "maximum": 1000,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "description": "Pagination offset",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "description": "Pagination offset",
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Knowledge Sources",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/knowledge/sources/{source_path}": {
      "delete": {
        "description": "Delete every chunk for a source via ``KnowledgeService.delete_by_source()``.\n\nBacks the ``forge sources delete`` CLI (MET-411). Returns the\nchunk count the backend removed; ``0`` when the source was already\nabsent \u2014 callers treat that as a no-op rather than an error.",
        "operationId": "delete_knowledge_source_v1_knowledge_sources__source_path__delete",
        "parameters": [
          {
            "in": "path",
            "name": "source_path",
            "required": true,
            "schema": {
              "title": "Source Path",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceDeleteResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Delete Knowledge Source",
        "tags": [
          "knowledge"
        ]
      },
      "get": {
        "description": "Per-source detail \u2014 looks up by exact ``source_path`` match.\n\nNo dedicated single-source accessor exists in the ``KnowledgeService``\ncontract, so we list and find \u2014 fine for CLI usage where the user\nhas already picked a known path. Returns 404 when the source isn't\nregistered.",
        "operationId": "get_knowledge_source_v1_knowledge_sources__source_path__get",
        "parameters": [
          {
            "in": "path",
            "name": "source_path",
            "required": true,
            "schema": {
              "title": "Source Path",
              "type": "string"
            }
          },
          {
            "description": "Filter by project UUID",
            "in": "query",
            "name": "projectId",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by project UUID",
              "title": "Projectid"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceDetailResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Knowledge Source",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/knowledge/{entry_id}": {
      "get": {
        "description": "Retrieve a single knowledge entry by ID.",
        "operationId": "get_knowledge_entry_v1_knowledge__entry_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "entry_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Entry Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeEntryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Knowledge Entry",
        "tags": [
          "knowledge"
        ]
      }
    },
    "/v1/manufacture/release": {
      "get": {
        "operationId": "release_for_manufacture_v1_manufacture_release_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          },
          {
            "description": "'3d_print' (-> STL) or 'cnc' (-> STEP)",
            "in": "query",
            "name": "process",
            "required": true,
            "schema": {
              "description": "'3d_print' (-> STL) or 'cnc' (-> STEP)",
              "title": "Process",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManufactureReleaseResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Release For Manufacture",
        "tags": [
          "manufacture"
        ]
      }
    },
    "/v1/memory/components/{name}": {
      "get": {
        "description": "Component usage / relationship knowledge for ``name`` (MET-471).\n\nWraps ``MemoryClient.get_component_context``: a typed convenience\nover the L1 knowledge base keyed off ``KnowledgeType.COMPONENT``.\nEmpty / whitespace ``name`` returns 422 \u2014 that's a client bug, not\na backend gap.",
        "operationId": "get_component_context_v1_memory_components__name__get",
        "parameters": [
          {
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "title": "Name",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 5,
              "maximum": 50,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "projectId",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "uuid",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Projectid"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemorySearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Component Context",
        "tags": [
          "memory"
        ]
      }
    },
    "/v1/memory/consolidate": {
      "post": {
        "description": "Trigger one consolidation pass synchronously.\n\nDefaults to ``on_demand`` mode (manual triage with the importance\nfloor relaxed). Pass ``mode=background`` to run the standard pass\nor ``mode=janitor`` to re-validate previously-stored insights\nwithout synthesizing new ones.",
        "operationId": "trigger_consolidation_v1_memory_consolidate_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConsolidationTriggerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConsolidationTriggerResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Trigger Consolidation",
        "tags": [
          "memory"
        ]
      }
    },
    "/v1/memory/insights": {
      "get": {
        "description": "List consolidated insights, newest first.\n\nExcludes ``STALE_WARN`` insights by default \u2014 agents should act on\nfresh lessons. Pass ``includeStale=true`` for an audit / review view\nthat includes faded insights. Optional ``theme`` narrows to one\nconsolidation theme.",
        "operationId": "list_insights_v1_memory_insights_get",
        "parameters": [
          {
            "in": "query",
            "name": "theme",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ConsolidationTheme"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Theme"
            }
          },
          {
            "in": "query",
            "name": "includeStale",
            "required": false,
            "schema": {
              "default": false,
              "title": "Includestale",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsightListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Insights",
        "tags": [
          "memory"
        ]
      }
    },
    "/v1/memory/retrieve": {
      "post": {
        "description": "Return experiences most similar to the supplied goal.\n\nBody shape matches ``MemoryRetrieveRequest``. The response carries\n``hits`` sorted by descending similarity, plus the echoed ``query``\nand ``total_found`` so callers can paginate without re-derivation.",
        "operationId": "retrieve_similar_experience_v1_memory_retrieve_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemoryRetrieveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryRetrieveResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Retrieve Similar Experience",
        "tags": [
          "memory"
        ]
      }
    },
    "/v1/memory/search": {
      "post": {
        "description": "Semantic search over design-decision knowledge (MET-471).\n\nWraps ``MemoryClient.search_design_rationale``: a typed convenience\nover the L1 knowledge base that asks \"why was X decided?\" and\nreturns ranked hits keyed off ``KnowledgeType.DESIGN_DECISION``.\nRequires the gateway to have wired a knowledge_service on\n``app.state.knowledge_service``; the 503 from ``_get_client``\ncovers the case where the service hasn't initialised.",
        "operationId": "search_design_rationale_v1_memory_search_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemorySearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemorySearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Search Design Rationale",
        "tags": [
          "memory"
        ]
      }
    },
    "/v1/projects": {
      "get": {
        "description": "List all hardware projects.",
        "operationId": "list_projects_v1_projects_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectListResponse"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "summary": "List Projects",
        "tags": [
          "projects"
        ]
      },
      "post": {
        "description": "Create a new hardware project (starts with no work products).",
        "operationId": "create_project_v1_projects_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Project",
        "tags": [
          "projects"
        ]
      }
    },
    "/v1/projects/{project_id}": {
      "delete": {
        "description": "Delete a project by ID.",
        "operationId": "delete_project_v1_projects__project_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Delete Project",
        "tags": [
          "projects"
        ]
      },
      "get": {
        "description": "Get a single project by ID.",
        "operationId": "get_project_v1_projects__project_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Project",
        "tags": [
          "projects"
        ]
      },
      "patch": {
        "description": "Rename, redescribe, or change the status of an existing project.",
        "operationId": "update_project_v1_projects__project_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Update Project",
        "tags": [
          "projects"
        ]
      }
    },
    "/v1/projects/{project_id}/work-products/{work_product_id}": {
      "delete": {
        "description": "Remove a work-product link from a project (MET-484).\n\nLets callers clean up duplicate/stale work-product references without\ndeleting the project. 404 if no matching link exists.",
        "operationId": "unlink_work_product_v1_projects__project_id__work_products__work_product_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Unlink Work Product",
        "tags": [
          "projects"
        ]
      }
    },
    "/v1/promotion": {
      "get": {
        "operationId": "list_promotions_v1_promotion_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PromotionHistoryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Promotions",
        "tags": [
          "promotion"
        ]
      }
    },
    "/v1/promotion/attempt": {
      "post": {
        "description": "Promote (or veto), attributed to whoever made this request.\n\nA dashboard click is a human act, so this route needs no separate\napproval hop the way the MCP path does \u2014 but the authority is still read\noff the request rather than the body (FORGE-393).",
        "operationId": "attempt_promotion_route_v1_promotion_attempt_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttemptPromotionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AttemptPromotionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Attempt Promotion Route",
        "tags": [
          "promotion"
        ]
      }
    },
    "/v1/releases": {
      "get": {
        "operationId": "list_releases_v1_releases_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleasePackageListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Releases",
        "tags": [
          "releases"
        ]
      },
      "post": {
        "operationId": "create_release_v1_releases_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReleaseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleasePackageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Release",
        "tags": [
          "releases"
        ]
      }
    },
    "/v1/requirements/constraints": {
      "post": {
        "description": "FORGE-259: create one structured constraint (metric/operator/limit/\nunit/target_node_type) from the dashboard's constraint editor. Live\npass/fail/no_data status for it then comes from the existing\nGET /v1/requirements/matrix, computed from real Claim/Evidence data --\nthis route only ever records the requirement's own declaration.",
        "operationId": "create_constraint_v1_requirements_constraints_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConstraintRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateConstraintResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Constraint",
        "tags": [
          "requirements"
        ]
      }
    },
    "/v1/requirements/coverage": {
      "get": {
        "description": "FORGE-297 (gap G-I1): the 5 traceability coverage percentages\n(needs->requirements, requirements->architecture, requirements->\nverification, verification->evidence, critical_requirements->evidence),\ncomputed live by ``TraceabilityAgent`` (FORGE-56/73) -- previously real,\ntested code with no gateway route exposing it at all.",
        "operationId": "get_requirement_coverage_v1_requirements_coverage_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TraceabilityCoverage"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Requirement Coverage",
        "tags": [
          "requirements"
        ]
      }
    },
    "/v1/requirements/matrix": {
      "get": {
        "description": "FORGE-318: requirements x claims x evidence, one row per real\nrequirement -- status (pass/uncertain/fail/no_data/stale) derived live\nfrom current claim + evidence staleness state, never cached.",
        "operationId": "get_requirement_matrix_v1_requirements_matrix_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RequirementMatrixResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Requirement Matrix",
        "tags": [
          "requirements"
        ]
      }
    },
    "/v1/requirements/quality": {
      "get": {
        "operationId": "get_requirement_quality_v1_requirements_quality_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "product_type",
            "required": false,
            "schema": {
              "default": "generic",
              "title": "Product Type",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RequirementSetQualityReport"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Requirement Quality",
        "tags": [
          "requirements"
        ]
      }
    },
    "/v1/requirements/{requirement_id}/fix": {
      "post": {
        "description": "Generate a proposed rewrite for one flawed requirement -- diagnoses\nwith the same deterministic linter the quality report already used,\nthen asks the Requirement Author agent for a corrected version linked\nback to the original via REFINES. Never writes anything itself; the\ncaller applies the resulting patch through the normal review path.",
        "operationId": "propose_requirement_fix_v1_requirements__requirement_id__fix_post",
        "parameters": [
          {
            "in": "path",
            "name": "requirement_id",
            "required": true,
            "schema": {
              "title": "Requirement Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FixRequirementResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Propose Requirement Fix",
        "tags": [
          "requirements"
        ]
      }
    },
    "/v1/robot/joint-loads": {
      "post": {
        "operationId": "compute_joint_loads_v1_robot_joint_loads_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JointLoadRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JointLoadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Compute Joint Loads",
        "tags": [
          "robot-loads"
        ]
      }
    },
    "/v1/runs": {
      "get": {
        "description": "Every run, or one project's.\n\nUnfiltered before: `/runs` showed every project's work in one list, and\nthe project a run belonged to was only inside its request blob. Passing\n``project_id`` scopes it; the response says how many runs were left out\nfor having no project, so they do not simply vanish.",
        "operationId": "list_runs_v1_runs_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Runs",
        "tags": [
          "runs"
        ]
      },
      "post": {
        "operationId": "create_run_v1_runs_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRunRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Run",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/usage/summary": {
      "get": {
        "description": "LLM tokens and cost across all runs for the trailing window (FORGE-476).",
        "operationId": "get_usage_summary_v1_runs_usage_summary_get",
        "parameters": [
          {
            "in": "query",
            "name": "window_hours",
            "required": false,
            "schema": {
              "default": 24.0,
              "title": "Window Hours",
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Usage Summary V1 Runs Usage Summary Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Usage Summary",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}": {
      "get": {
        "operationId": "get_run_v1_runs__run_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Run",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/approval": {
      "post": {
        "description": "Answer the gate this run is parked at.\n\nAsync so the store transition \u2014 which resolves the in-process executor's\ngate future via the coordinator \u2014 runs on the event-loop thread (future\nresolution is not thread-safe from FastAPI's sync worker pool).\n\nOn Temporal the decision is also *signalled* into the workflow, which is\nwhat actually resumes it (FORGE-401). The store transition stays, because\nthe run list, the SSE stream and the ledger all read from it.\n\nThe deciding human comes from the request, never the body (FORGE-393).",
        "operationId": "submit_approval_v1_runs__run_id__approval_post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApprovalRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Submit Approval",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/events": {
      "get": {
        "description": "SSE stream of a run's status transitions until it reaches a terminal state.",
        "operationId": "stream_run_events_v1_runs__run_id__events_get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Stream Run Events",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/flow-state": {
      "get": {
        "description": "Phase-by-phase state of a design-flow run.\n\nQueries the Temporal workflow. A workflow query is answered by a *worker*,\nso with none running there is nobody to answer -- which is reported as\n``live: false`` with a reason rather than as an empty flow, because an\nempty flow and a flow nobody can see render identically and mean opposite\nthings.",
        "operationId": "get_flow_state_v1_runs__run_id__flow_state_get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FlowRunState"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Flow State",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/gate-opened": {
      "post": {
        "description": "Record that a run's workflow has opened a gate (FORGE-489).\n\nCalled by the design-flow worker's announcer. The workflow is the\nauthority on whether a gate is open, so this first re-reads it\n(``_reconcile_run``). Only when the workflow cannot be asked does it fall\nback to the worker's word. Either way it moves the *record* to\n``awaiting_approval``, which is what lists the run on the Approvals page\nand publishes the change on its SSE stream. It never approves: a decision\nstill has to come through ``/approval``, and the workflow ignores one for\na gate that is not open.",
        "operationId": "gate_opened_v1_runs__run_id__gate_opened_post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GateOpenedRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Gate Opened",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/lifecycle": {
      "get": {
        "description": "The lifecycle view of one design run, with its completion verdict.",
        "operationId": "get_run_lifecycle_v1_runs__run_id__lifecycle_get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunLifecycleResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Run Lifecycle",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/patches": {
      "post": {
        "description": "Plan a change to a running flow and hold it for a person.\n\nNothing changes until somebody approves the approval this returns, and\nthen ``POST /v1/runs/{run_id}/patches/{version_id}/apply`` applies it at\nthe run's next gate. Only the phases the change touches re-run.",
        "operationId": "propose_run_patch_v1_runs__run_id__patches_post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProposePatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatchView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Propose Run Patch",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/runs/{run_id}/patches/{version_id}/apply": {
      "post": {
        "description": "Apply an approved patch. Refused unless approved and still current.",
        "operationId": "apply_run_patch_v1_runs__run_id__patches__version_id__apply_post",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "version_id",
            "required": true,
            "schema": {
              "title": "Version Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppliedPatchView"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Apply Run Patch",
        "tags": [
          "runs"
        ]
      }
    },
    "/v1/sessions": {
      "get": {
        "description": "List all agent sessions.\n\nMerges internal Temporal ``WorkflowRun``s with externally-recorded\nagent sessions (MET-493) so MCP/CLI-driven work shows up alongside\nautonomous runs. Most-recent-first.\n\n``project_id`` scopes to one project (MET-516). Internal Temporal runs\ncarry no project, so they're excluded when a project filter is set.",
        "operationId": "list_sessions_v1_sessions_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Sessions",
        "tags": [
          "sessions"
        ]
      },
      "post": {
        "description": "Open a new externally-recorded agent session.",
        "operationId": "create_session_v1_sessions_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Session",
        "tags": [
          "sessions"
        ]
      }
    },
    "/v1/sessions/{session_id}": {
      "get": {
        "description": "Get a single session by ID (store first, then workflow engine).",
        "operationId": "get_session_v1_sessions__session_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Session",
        "tags": [
          "sessions"
        ]
      },
      "patch": {
        "description": "Complete a session (set terminal status + optional summary).",
        "operationId": "update_session_v1_sessions__session_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Update Session",
        "tags": [
          "sessions"
        ]
      }
    },
    "/v1/sessions/{session_id}/events": {
      "post": {
        "description": "Append one event (thought / action / decision / \u2026) to a session.",
        "operationId": "append_session_event_v1_sessions__session_id__events_post",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionEventCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionEventCreatedResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Append Session Event",
        "tags": [
          "sessions"
        ]
      }
    },
    "/v1/simulation/load-cases": {
      "get": {
        "description": "List load cases, optionally scoped to a project.\n\nEmpty (not a 404) when the project has none yet, matching ``/v1/bom``.",
        "operationId": "list_load_cases_v1_simulation_load_cases_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoadCaseListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Load Cases",
        "tags": [
          "simulation"
        ]
      },
      "post": {
        "description": "Create a load case, via the same document-recorder path\n``twin.record_document(document_type='load_case')`` uses (see module\ndocstring) so a dashboard-authored and agent-authored case are\nindistinguishable on the twin.",
        "operationId": "create_load_case_v1_simulation_load_cases_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLoadCaseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoadCaseResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create Load Case",
        "tags": [
          "simulation"
        ]
      }
    },
    "/v1/simulation/named-faces": {
      "post": {
        "description": "Named-face geometry for an already-generated mesh (FORGE-277).\n\nBacks the dashboard's geometric boundary-condition face picker: given a\nmesh file path (from an earlier ``freecad.generate_mesh`` call, e.g.\nsurfaced in a forge chat turn), returns each named surface group's real\ncentroid/normal/area/bbox so the dashboard can render pickable face\npatches instead of a blind \"type the gmsh group name\" text field.",
        "operationId": "list_named_faces_v1_simulation_named_faces_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NamedFacesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NamedFacesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Named Faces",
        "tags": [
          "simulation"
        ]
      }
    },
    "/v1/simulation/results": {
      "get": {
        "description": "List FEA results, optionally scoped to a project (FORGE-279).\n\nEmpty (not a 404) when the project has none yet, matching\n``list_load_cases``. Creation is agent-driven only (see module\ndocstring) \u2014 there is no corresponding POST.",
        "operationId": "list_simulation_results_v1_simulation_results_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SimulationResultListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Simulation Results",
        "tags": [
          "simulation"
        ]
      }
    },
    "/v1/simulation/results/{result_id}/field": {
      "get": {
        "description": "Serve a simulation_result's 3D result field (FORGE-532).\n\n404 ``field not stored`` for a result recorded without one (every\nresult before FORGE-532, or one whose MinIO write failed); the\ndashboard treats that as \"show the numbers only\".",
        "operationId": "get_simulation_result_field_v1_simulation_results__result_id__field_get",
        "parameters": [
          {
            "in": "path",
            "name": "result_id",
            "required": true,
            "schema": {
              "title": "Result Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/vnd.metaforge.sim-field+json": {}
            },
            "description": "The result's gzipped metaforge.sim_field JSON payload (Content-Encoding: gzip)."
          },
          "404": {
            "description": "No such result, or the result has no stored field."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Simulation Result Field",
        "tags": [
          "simulation"
        ]
      }
    },
    "/v1/technical-drawings": {
      "get": {
        "operationId": "list_technical_drawings_v1_technical_drawings_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TechnicalDrawingListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Technical Drawings",
        "tags": [
          "technical-drawings"
        ]
      }
    },
    "/v1/testplans": {
      "get": {
        "operationId": "list_test_plan_v1_testplans_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TestPlanListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Test Plan",
        "tags": [
          "testplans"
        ]
      },
      "post": {
        "operationId": "generate_test_plan_v1_testplans_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateTestPlanRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GenerateTestPlanResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Generate Test Plan",
        "tags": [
          "testplans"
        ]
      }
    },
    "/v1/trade-study/options": {
      "get": {
        "operationId": "list_concept_options_v1_trade_study_options_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response List Concept Options V1 Trade Study Options Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Concept Options",
        "tags": [
          "trade-study"
        ]
      },
      "post": {
        "operationId": "add_concept_option_v1_trade_study_options_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddConceptOptionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Add Concept Option V1 Trade Study Options Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Add Concept Option",
        "tags": [
          "trade-study"
        ]
      }
    },
    "/v1/trade-study/select": {
      "post": {
        "operationId": "select_concept_v1_trade_study_select_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SelectConceptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Select Concept V1 Trade Study Select Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Select Concept",
        "tags": [
          "trade-study"
        ]
      }
    },
    "/v1/twin/baselines": {
      "get": {
        "description": "A project's baselines, newest first.",
        "operationId": "list_baselines_v1_twin_baselines_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BaselineListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Baselines",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/baselines/diff": {
      "get": {
        "description": "Per item: unchanged, changed (@x -> @y), added or removed between ``a`` and ``b``.",
        "operationId": "diff_baselines_route_v1_twin_baselines_diff_get",
        "parameters": [
          {
            "description": "Baseline id",
            "in": "query",
            "name": "a",
            "required": true,
            "schema": {
              "description": "Baseline id",
              "title": "A",
              "type": "string"
            }
          },
          {
            "description": "Baseline id, or 'current' for the project's current items",
            "in": "query",
            "name": "b",
            "required": true,
            "schema": {
              "description": "Baseline id, or 'current' for the project's current items",
              "title": "B",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BaselineDiffResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Diff Baselines Route",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/baselines/{baseline_id}": {
      "get": {
        "description": "One baseline with its item pins and constraint/entity members.",
        "operationId": "get_baseline_v1_twin_baselines__baseline_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "baseline_id",
            "required": true,
            "schema": {
              "title": "Baseline Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BaselineDetail"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Baseline",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/current-view": {
      "get": {
        "description": "The project's current items, records, counts and readiness (current items only).",
        "operationId": "get_current_view_v1_twin_current_view_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CurrentViewResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Current View",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/hierarchy": {
      "get": {
        "description": "List a project's hierarchy nodes, each with its parent link and its\nown rolled-up mass/cost.\n\nEmpty (not a 404) when the project has none yet, matching ``/v1/bom``.\nNote: computes one rollup per node (each its own subtree walk) -- fine\nat the scale a hand-built product hierarchy actually reaches, not\noptimized for a tree of thousands of nodes.",
        "operationId": "get_hierarchy_tree_v1_twin_hierarchy_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HierarchyTreeResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Hierarchy Tree",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/hierarchy/{node_id}/realize": {
      "post": {
        "description": "\"Replace placeholder with part\": attach or replace ``node_id``'s\nREALIZED_BY (a cad_model work product, e.g. from ``POST /v1/twin/import``)\nand/or INSTANCE_OF (a BOMItem) geometry -- the dashboard's own action\nreuses the SAME bound callable ``twin.realize_hierarchy_node`` uses.",
        "operationId": "realize_hierarchy_node_v1_twin_hierarchy__node_id__realize_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RealizeHierarchyNodeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RealizeHierarchyNodeResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Realize Hierarchy Node",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/import": {
      "post": {
        "description": "Upload a design file and register it as a work product in the Twin.\n\nAccepts STEP, IGES, KiCad (.kicad_sch, .kicad_pcb), and FreeCAD\n(.FCStd) files. Metadata is extracted automatically based on file type.",
        "operationId": "import_work_product_v1_twin_import_post",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_import_work_product_v1_twin_import_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportWorkProductResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Import Work Product",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/interference-check": {
      "get": {
        "description": "Real boolean-intersection clearance/interference check between two\nnamed parts' committed STEP geometry (FORGE-272, gap G-D4).\n\nDeliberately a pairwise check on two caller-named parts, not an\nall-pairs sweep across an entire assembly, and deliberately not an ISO\n286 tolerance-grade/fit classification -- see\n``api_gateway.twin.interference_check``'s module docstring for why\nboth are out of scope here.",
        "operationId": "check_interference_v1_twin_interference_check_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id_a",
            "required": true,
            "schema": {
              "title": "Work Product Id A",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "work_product_id_b",
            "required": true,
            "schema": {
              "title": "Work Product Id B",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterferenceCheckResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Check Interference",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/items": {
      "get": {
        "description": "Versioned definitions, each at its current head.",
        "operationId": "list_twin_items_v1_twin_items_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "description": "e.g. cad_model, constraint_set",
            "in": "query",
            "name": "item_type",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "e.g. cad_model, constraint_set",
              "title": "Item Type"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItemListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Twin Items",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/items/{key}/diff": {
      "get": {
        "description": "Geometry delta, parameter, requirement and field changes between two revisions.",
        "operationId": "get_item_diff_v1_twin_items__key__diff_get",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "title": "Key",
              "type": "string"
            }
          },
          {
            "description": "Older revision, e.g. 2 or @2",
            "in": "query",
            "name": "a",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Older revision, e.g. 2 or @2",
              "title": "A"
            }
          },
          {
            "description": "Newer revision; defaults to the current one",
            "in": "query",
            "name": "b",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Newer revision; defaults to the current one",
              "title": "B"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItemDiffResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Item Diff",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/items/{key}/prd": {
      "get": {
        "description": "One prd prose revision (``KEY`` or ``KEY@n``) with the current requirements.",
        "operationId": "get_item_prd_v1_twin_items__key__prd_get",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "title": "Key",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "description": "Read as this design-flow run: include its open drafts",
            "in": "query",
            "name": "run_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Read as this design-flow run: include its open drafts",
              "title": "Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DerivedPrdResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Item Prd",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/items/{key}/revisions": {
      "get": {
        "description": "Every revision of one item, oldest first. ``key`` may carry an ``@n`` suffix.",
        "operationId": "get_item_revisions_v1_twin_items__key__revisions_get",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "title": "Key",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "description": "Read as this design-flow run: include its open drafts",
            "in": "query",
            "name": "run_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Read as this design-flow run: include its open drafts",
              "title": "Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItemHistoryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Item Revisions",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/links": {
      "get": {
        "description": "List file links with live sync status, optionally scoped to a project.\n\nA link has no project of its own; scoping (MET-517) keeps only links whose\nlinked work product belongs to ``project_id``.",
        "operationId": "list_file_links_v1_twin_links_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/FileLinkResponse"
                  },
                  "title": "Response List File Links V1 Twin Links Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List File Links",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes": {
      "get": {
        "description": "List work-product nodes in the Digital Twin.\n\n``project_id`` scopes the view to a single project (MET-491). Omitted\nor empty returns every node (including unscoped legacy nodes) \u2014\npreserving the prior global behaviour. A specific ``project_id``\nreturns only that project's nodes; unscoped nodes are excluded.\n\nFORGE-525: a design-flow run's drafts are left out until its gate\napproves them (and for good if it never does); ``include_drafts=true``\nlists them too.",
        "operationId": "list_twin_nodes_v1_twin_nodes_get",
        "parameters": [
          {
            "in": "query",
            "name": "domain",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Domain"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          },
          {
            "in": "query",
            "name": "include_drafts",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Drafts",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TwinNodeListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Twin Nodes",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/boolean-cut": {
      "post": {
        "description": "Real CSG boolean-cut between two committed STEP work products (MET-612).\n\nA direct-commit endpoint, not the ``twin.propose_change``/apply HITL\npipeline \u2014 a human cutting their own open model is not meaningfully\ndifferent from clicking Save (same rationale as ``twin.record_document``,\nwhose apply executor doesn't fit this action either). Drives the\ncontainerized CadQuery adapter via the shared MCP bridge, then commits the\nresult through the geometry recorder with provenance edges to both inputs.",
        "operationId": "boolean_cut_nodes_v1_twin_nodes_boolean_cut_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BooleanCutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BooleanCutResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Boolean Cut Nodes",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}": {
      "delete": {
        "description": "Delete a work-product node, its project links, and its MinIO blob (MET-484).\n\nWithout ``cascade`` a delete that would orphan dependents returns 409.\nBest-effort on the blob (a storage failure doesn't block the delete).",
        "operationId": "delete_node_v1_twin_nodes__node_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          },
          {
            "description": "Also delete dependents that would orphan",
            "in": "query",
            "name": "cascade",
            "required": false,
            "schema": {
              "default": false,
              "description": "Also delete dependents that would orphan",
              "title": "Cascade",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Delete Node",
        "tags": [
          "twin"
        ]
      },
      "get": {
        "description": "Get a single work-product node by ID.",
        "operationId": "get_twin_node_v1_twin_nodes__node_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TwinNodeResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Twin Node",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/approve-sketch": {
      "post": {
        "description": "Human sign-off on a design_sketch work product (follow-up to MET-740/747).\n\nThe forge/agent side creates a sketch as unapproved (twin.commit_design_sketch);\nthis is the dashboard's side of the gate \u2014 a human explicitly approving it\nbefore the calling agent is expected to proceed to real CAD/build work.",
        "operationId": "approve_design_sketch_v1_twin_nodes__node_id__approve_sketch_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApproveSketchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApproveSketchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Approve Design Sketch",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/approve-technical-drawing": {
      "post": {
        "description": "Human sign-off on a technical_drawing work product (FORGE-293, gap G-H1).\n\nMirrors ``approve_design_sketch`` above -- a real work product, a real\napproval gate, not a dashboard-local checkbox.",
        "operationId": "approve_technical_drawing_v1_twin_nodes__node_id__approve_technical_drawing_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApproveTechnicalDrawingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApproveTechnicalDrawingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Approve Technical Drawing",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/assembly-joints": {
      "patch": {
        "description": "Add/edit/delete mates+joints on an already-committed assembly node (FORGE-271).\n\nWhole-list replace -- matches how the URDF/SDF/USD export panel's own\nmanual joint-list form already works (FORGE-245/MET-740). Persisted\ndirectly onto ``metadata.assembly.joints``: a joint is a logical\nannotation, not new geometry, so this deliberately skips the full\n``VersionService`` revision machinery ``/nodes/{id}/iterate`` uses for\nan actual re-export -- editing joints here never touches the underlying\ncommitted blob.\n\nUnlike the export panel, this does NOT require a live FreeCAD session or\nre-running an export -- it works on any already-committed node, any\ntime, which is the whole point (FORGE-245's own fix only got joints\npersisted onto the node at commit time; this is what makes them\neditable afterward).",
        "operationId": "update_assembly_joints_v1_twin_nodes__node_id__assembly_joints_patch",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssemblyJointsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateAssemblyJointsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Update Assembly Joints",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/diff": {
      "get": {
        "description": "Return a metadata diff between two revisions (1-indexed).",
        "operationId": "diff_versions_v1_twin_nodes__node_id__diff_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "v1",
            "required": true,
            "schema": {
              "title": "V1",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "v2",
            "required": true,
            "schema": {
              "title": "V2",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RevisionDiff"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Diff Versions",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/file": {
      "get": {
        "description": "Stream a work product's stored file for download / open / preview.\n\n``download=false`` (default) returns the blob inline with a preview\ncontent-type so the dashboard can render PDFs, images, text, and BOMs\nin place; ``download=true`` forces a ``Content-Disposition: attachment``.",
        "operationId": "download_node_file_v1_twin_nodes__node_id__file_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          },
          {
            "description": "Force attachment download vs inline preview",
            "in": "query",
            "name": "download",
            "required": false,
            "schema": {
              "default": false,
              "description": "Force attachment download vs inline preview",
              "title": "Download",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Download Node File",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/files/{filename}": {
      "get": {
        "description": "Stream one of a work product's NAMED blobs (MET-740 follow-up).\n\n``GET /nodes/{id}/file`` only ever serves the primary blob. A\n``robot_description`` node stores N additional mesh blobs (one per\nURDF link) under ``metadata[\"mesh_files\"]`` (link filename -> MinIO\nobject key) \u2014 this resolves any of THOSE by filename, or falls back to\nthe primary blob if ``filename`` matches it, so the dashboard's\nexisting URDF preview (which expects every mesh reachable at\n``{some_base_url}/{filename}``, exactly like a fresh export's\n``_cad_exports/{export_id}/`` directory) can point straight at a\npersisted node with zero re-export round trip.",
        "operationId": "download_node_named_file_v1_twin_nodes__node_id__files__filename__get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "filename",
            "required": true,
            "schema": {
              "title": "Filename",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Download Node Named File",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/geometry-diff": {
      "get": {
        "description": "Diff a work product's real geometry against its SUPERSEDES predecessor.\n\nUnlike ``/diff`` above (a metadata-revision diff on the SAME node --\n``/iterate`` never changes the underlying blob, so no two revisions of one\nnode ever have different geometry), this walks the real SUPERSEDES edge a\nre-committed, same-named CAD_MODEL gets (``api_gateway.twin.geometry_\nrecorder``) and compares the two NODES' actual STEP files.",
        "operationId": "diff_geometry_v1_twin_nodes__node_id__geometry_diff_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeometryDiffResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Diff Geometry",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/iterate": {
      "post": {
        "description": "Record a new revision and apply metadata updates to a work product.",
        "operationId": "iterate_work_product_v1_twin_nodes__node_id__iterate_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IterateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkProductRevision"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Iterate Work Product",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/link": {
      "delete": {
        "description": "Remove the file link for a work product.",
        "operationId": "delete_file_link_v1_twin_nodes__node_id__link_delete",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Delete File Link",
        "tags": [
          "twin"
        ]
      },
      "get": {
        "description": "Get the file link for a work product, with live sync status.",
        "operationId": "get_file_link_v1_twin_nodes__node_id__link_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FileLinkResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get File Link",
        "tags": [
          "twin"
        ]
      },
      "post": {
        "description": "Link a work product to an external source file.\n\nThe source file must exist on the gateway's filesystem. Once linked,\nyou can call ``POST /sync`` to re-import changes, or enable ``watch``\nfor automatic detection.",
        "operationId": "create_file_link_v1_twin_nodes__node_id__link_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FileLinkCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FileLinkResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Create File Link",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/model": {
      "get": {
        "description": "Convert a CAD work-product's STEP file to GLB and return the URL.\n\nReads the STEP file from the shared adapter workspace, converts it\nvia the OCCT converter, and returns the GLB URL + metadata.",
        "operationId": "get_node_model_v1_twin_nodes__node_id__model_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "default": "standard",
              "pattern": "^(preview|standard|fine)$",
              "title": "Quality",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Get Node Model V1 Twin Nodes  Node Id  Model Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Node Model",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/script": {
      "get": {
        "description": "The current git-versioned generation script for a CAD_MODEL node (MET-630).\n\nLets a dashboard parameter panel seed a regeneration proposal with the\nscript as it stands today, rather than the user retyping it from scratch.\n404 when the node has no linked script (imported geometry, or the git\nbackend isn't configured).",
        "operationId": "get_node_script_v1_twin_nodes__node_id__script_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TwinNodeScriptResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Node Script",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/sync": {
      "post": {
        "description": "Manually trigger a sync for a linked work product.\n\nRe-reads the source file, extracts metadata, and updates the Twin\nnode if the file has changed.",
        "operationId": "sync_file_link_v1_twin_nodes__node_id__sync_post",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Sync File Link V1 Twin Nodes  Node Id  Sync Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Sync File Link",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/nodes/{node_id}/versions": {
      "get": {
        "description": "Return the full revision history for a work product.",
        "operationId": "get_version_history_v1_twin_nodes__node_id__versions_get",
        "parameters": [
          {
            "in": "path",
            "name": "node_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Node Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkProductVersionHistory"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Version History",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/projects/{project_id}/item-migration/apply": {
      "post": {
        "description": "Apply a reviewed plan. Requires ``approve: true``; refused when the twin changed.",
        "operationId": "apply_item_migration_v1_twin_projects__project_id__item_migration_apply_post",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MigrationApplyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationApplyResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Apply Item Migration",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/projects/{project_id}/item-migration/plan": {
      "post": {
        "description": "Dry run: how the project's legacy nodes would become items. Writes nothing.",
        "operationId": "plan_item_migration_v1_twin_projects__project_id__item_migration_plan_post",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationPlanResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Plan Item Migration",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/projects/{project_id}/prd": {
      "get": {
        "description": "The project's prd, rendered from its current prose and requirements.",
        "operationId": "get_project_prd_v1_twin_projects__project_id__prd_get",
        "parameters": [
          {
            "in": "path",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          },
          {
            "description": "Read as this design-flow run: include its open drafts",
            "in": "query",
            "name": "run_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Read as this design-flow run: include its open drafts",
              "title": "Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DerivedPrdResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Project Prd",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/relationships": {
      "get": {
        "description": "List edges in the Digital Twin graph.\n\n``project_id`` scopes the view to a single project (MET-491), matching\n``list_twin_nodes``. Omitted or empty returns every edge (including\nunscoped legacy nodes) \u2014 preserving the prior global behaviour.",
        "operationId": "list_twin_relationships_v1_twin_relationships_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TwinRelationshipListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "List Twin Relationships",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/revision-index": {
      "get": {
        "description": "Node id -> ``KEY@n`` for every revision (and constraint-set constraint) of the project.",
        "operationId": "get_revision_index_v1_twin_revision_index_get",
        "parameters": [
          {
            "in": "query",
            "name": "project_id",
            "required": true,
            "schema": {
              "title": "Project Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RevisionIndexResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Revision Index",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/twin/runs/{run_id}/changes": {
      "get": {
        "description": "Revisions a design-flow run produced, and the baselines its gates recorded.",
        "operationId": "get_run_changes_v1_twin_runs__run_id__changes_get",
        "parameters": [
          {
            "in": "path",
            "name": "run_id",
            "required": true,
            "schema": {
              "title": "Run Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "project_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Project Id"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RunChangesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Run Changes",
        "tags": [
          "twin"
        ]
      }
    },
    "/v1/wiring/harness-estimate": {
      "get": {
        "operationId": "get_harness_estimate_v1_wiring_harness_estimate_get",
        "parameters": [
          {
            "in": "query",
            "name": "work_product_id",
            "required": true,
            "schema": {
              "title": "Work Product Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HarnessEstimateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Get Harness Estimate",
        "tags": [
          "wiring"
        ]
      }
    }
  }
}